@pwrdrvr/microapps-cdk 0.2.4 → 0.2.8

package/.jsii

@@ -2883,7 +2883,7 @@
   },
   "description": "MicroApps framework, by PwrDrvr LLC, delivered as an AWS CDK construct that provides the DynamoDB, Router service, Deploy service, API Gateway, and CloudFront distribution.",
   "docs": {
-    "stability": "stable"
+    "stability": "experimental"
   },
   "homepage": "https://github.com/pwrdrvr/microapps-core",
   "jsiiVersion": "1.52.1 (build 5ccc8f6)",
@@ -2903,7 +2903,7 @@
   },
   "name": "@pwrdrvr/microapps-cdk",
   "readme": {
-    "markdown": "![Build/Deploy CI](https://github.com/pwrdrvr/microapps-core/actions/workflows/ci.yml/badge.svg) ![Main Build](https://github.com/pwrdrvr/microapps-core/actions/workflows/main-build.yml/badge.svg) ![Release](https://github.com/pwrdrvr/microapps-core/actions/workflows/release.yml/badge.svg)\n\n# Overview\n\nThe MicroApps project....\n\n# Project Layout\n\n- [packages/cdk]() - CDK Stacks\n  - MicroAppsS3\n    - Creates S3 buckets\n  - MicroAppsRepos\n    - Creates the ECR repos for components to be published into;\n      - Deployer\n      - Router\n  - MicroAppsSvcs\n    - Create DynamoDB table\n    - Create Deployer Lambda function\n    - Create Router Lambda function\n    - Create APIGateway HTTP API\n  - MicroAppsCF\n    - Creates Cloudfront distribution\n  - MicroAppsR53\n    - Creates domain names to point to the edge (Cloudfront) and origin (API Gateway)\n- [packages/microapps-deployer]()\n  - Lambda service invoked by `microapps-publish` to record new app/version in the DynamoDB table, create API Gateway integrations, copy S3 assets from staging to prod bucket, etc.\n- [packages/microapps-publish]()\n  - Node executable that updates versions in config files, deploys static assets to the S3 staging bucket, optionally compiles and deploys a new Lambda function version, and invokes `microapps-deployer`\n  - Permissions required:\n    - Lambda invoke\n    - S3 publish to the staging bucket\n    - ECR write\n    - Lambda version publish\n- [packages/microapps-router]()\n  - Lambda function that determines which version of an app to point a user to on a particular invocation\n\n# Useful Commands\n\n- `npm run build` compiles TypeSript to JavaScript\n- `npm run lint` checks TypeScript for compliance with Lint rules\n- `cdk list` list the stack names\n- `cdk deploy` deploy this stack to your default AWS account/region\n- `cdk diff` compare deployed stack with current state\n- `cdk synth` emits the synthesized CloudFormation template\n\n# Running CDK\n\nAlways run CDK from the root of the git repo, which is the directory containing `cdk.json`.\n\n## Set AWS Profile\n\n`export AWS_PROFILE=pwrdrvr`\n\n## Set NVM Version\n\n`nvm use`\n\n# Deployer Service\n\nCopies static assets from staging to deployed directory, creates record of application / version in DynamoDB Table.\n\n# Notes on Selection of Docker Image Lambdas\n\nThe Router and Deployer services are very small (0.5 MB) after tree shaking, minification, and uglification performed by `rollup`. The router has the tightest performance requirement and performed just as well as a docker image vs a zip file. However, docker image start up is up to 2x longer vs the zip file for the router; this should not be a problem for any live system with continuous usage and for demos the router can be initialized or pre-provisioned beforehand. The development benefits of docker images for Lambda outweigh the small init time impact on cold starts.\n\n# Notes on Performance\n\n## Router\n\nFor best demo performance (and real user performance), the memory for the Router Lambda should be set to 1024 MB as this gives the fastest cold start at the lowest cost. The cost per warm request is actually lower at 1024 MB than at 128 MB, so 1024 MB is just the ideal size.\n\nFor supremely optimum demo performance the Router Lambda should be deployed as a .zip file as that saves about 50% of the cold start time, or about 200 ms, but once it's the cold start has happened they are equally as fast as each other.\n\n- Lambda Memory (which linearly scales CPU) Speeds\n  - Docker Image Lambda\n    - Note: All times captured with Rollup ~400 KB Docker Layer\n    - 128 MB\n      - Duration Warm: 118 ms\n      - Duration Cold: 763 ms\n      - Init Duration: 518 ms\n      - Billed Duration Warm: 119 ms\n      - Billed Duration Init: 1,282 ms\n      - Warm Cost: 0.025 millicents\n      - Init Cost: 0.26 millicents\n    - 256 MB\n      - Duration Warm: 30 ms\n      - Duration Cold: 363 ms\n      - Init Duration: 488 ms\n      - Billed Duration Warm: 30 ms\n      - Billed Duration Init: 853 ms\n      - Warm Cost: 0.013 millicents\n      - Init Cost: 0.36 millicents\n    - 512 MB\n      - Duration Warm: 10 ms\n      - Duration Cold: 176 ms\n      - Init Duration: 572 ms\n      - Billed Duration Warm: 10 ms\n      - Billed Duration Init: 749 ms\n      - Warm Cost: 0.0083 millicents\n      - Init Cost: 0.62 millicents\n    - 1024 MB\n      - Duration Warm: 9 ms\n      - Duration Cold: 84.5 ms\n      - Init Duration: 497 ms\n      - Billed Duration Warm: 9 ms\n      - Billed Duration Init: 585 ms\n      - Warm Cost: 0.015 millicents\n      - Init Cost: 0.97 millicents\n      - _Init performance scales linearly up to and including 1024 MB_\n    - 1769 MB\n      - This is the point at which a Lambda has 100% of 1 CPU\n      - https://docs.aws.amazon.com/lambda/latest/dg/configuration-memory.html\n      - Duration Warm: 8.31 ms\n      - Duration Cold: 73 ms\n      - Init Duration: 514 ms\n      - Billed Duration Warm: 10 ms\n      - Billed Duration Cold: 587 ms\n      - Warm Cost: 0.029 millicents\n      - Init Cost: 1.7 millicents\n    - 2048 MB\n      - Duration Warm: 10 ms\n      - Duration Cold: 67 ms\n      - Init Duration: 497 ms\n      - Billed Duration Warm: 11 ms\n      - Billed Duration Init: 566 ms\n      - Warm Cost: 0.037 millicents\n      - Init Cost: 1.89 millicents\n  - Zip File Lambda\n    - 128 MB\n      - Duration Warm: 110 ms\n      - Duration Cold: 761 ms\n      - Init Duration: 210 ms\n      - Billed Duration Warm: 120 ms\n      - Billed Duration Init: 762 ms\n      - Warm Cost: 0.025 millicents\n      - Init Cost: 0.16 millicents\n    - 512 MB\n      - Duration Warm: 10 ms\n      - Duration Cold: 179 ms\n      - Init Duration: 201 ms\n      - Billed Duration Warm: 12 ms\n      - Billed Duration Init: 185 ms\n      - Warm Cost: 0.01 millicents\n      - Init Cost: 0.15 millicents\n    - 1024 MB\n      - Duration Warm: 10 ms\n      - Duration Cold: 85 ms\n      - Init Duration: 185 ms\n      - Billed Duration Warm: 12 ms\n      - Billed Duration Init: 85 ms\n      - Warm Cost: 0.02 millicents\n      - Init Cost: 0.14 millicents\n"
+    "markdown": "![Build/Deploy CI](https://github.com/pwrdrvr/microapps-core/actions/workflows/ci.yml/badge.svg) ![Main Build](https://github.com/pwrdrvr/microapps-core/actions/workflows/main-build.yml/badge.svg) ![Release](https://github.com/pwrdrvr/microapps-core/actions/workflows/release.yml/badge.svg)\n\n# Overview\n\nThe MicroApps project enables rapidly deploying many web apps to AWS on a single shared host name, fronted by a CloudFront Distribution, serving static assets from an S3 Bucket, and routing application requests via API Gateway. MicroApps is delivered as a CDK Construct for deployment, although alternative deployment methods can be used if desired and implemented.\n\nMicroApps allows many versions of an application to be deployed either as ephemeral deploys (e.g. for pull request builds) or as semi-permanent deploys. The `microapps-router` Lambda function handled routing requests to apps to the current version targeted for a particular application start request using rules as complex as one is interested in implementing (e.g. A/B testing integration, canary releases, per-user rules for logged in users, per-group, per-deparment, and default rules).\n\nUsers start applications via a URL such as `[/{prefix}]/{appname}/`, which hits the `microapps-router` that looks up the version of the application to be run, then renders a transparent `iframe` with a link to that version. The URL seen by the user in the browser (and available for bookmarking) has no version in it, so subsequent launches (e.g. the next day or just in another tab) will lookup the version again. All relative URL API requests (e.g. `some/api/path`) will go to the corresponding API version that matches the version of the loaded static files, eliminating issues of incompatibility between static files and API deployments.\n\nFor development / testing purposes only, each version of an applicaton can be accessed directly via a URL of the pattern `[/{prefix}]/{appname}/{semver}/`. These \"versioned\" URLs are not intended to be advertised to end users as they would cause a user to be stuck on a particular version of the app if the URL was bookmarked. Note that the system does not limit access to particular versions of an application, as of 2022-01-26, but that can be added as a feature.\n\n# Table of Contents <!-- omit in toc -->\n\n- [Overview](#overview)\n- [Video Preview of the Deploying CDK Construct](#video-preview-of-the-deploying-cdk-construct)\n- [Installation / CDK Constructs](#installation--cdk-constructs)\n- [Tutorial - Bootstrapping a Deploy](#tutorial---bootstrapping-a-deploy)\n- [Why MicroApps](#why-microapps)\n- [Limitations / Future Development](#limitations--future-development)\n- [Related Projects / Components](#related-projects--components)\n- [Architecure Diagram](#architecure-diagram)\n- [Project Layout](#project-layout)\n- [Creating a MicroApp Using Zip Lambda Functions](#creating-a-microapp-using-zip-lambda-functions)\n- [Creating a MicroApp Using Docker Lambda Functions](#creating-a-microapp-using-docker-lambda-functions)\n  - [Next.js Apps](#nextjs-apps)\n    - [Modify package.json](#modify-packagejson)\n    - [Install Dependencies](#install-dependencies)\n    - [Dockerfile](#dockerfile)\n    - [next.config.js](#nextconfigjs)\n    - [deploy.json](#deployjson)\n    - [serverless.yaml](#serverlessyaml)\n\n# Video Preview of the Deploying CDK Construct\n\n![Video Preview of Deploying](https://raw.githubusercontent.com/pwrdrvr/microapps-core/main/assets/videos/microapps-core-demo-deploy.gif)\n\n# Installation / CDK Constructs\n\n- `npm i --save-dev @pwrdrvr/microapps-cdk`\n- Add `MicroApps` construct to your stack\n- The `MicroApps` construct does a \"turn-key\" deployment complete with the Release app\n- [Construct Hub](https://constructs.dev/packages/@pwrdrvr/microapps-cdk/)\n  - CDK API docs\n  - Python, DotNet, Java, JS/TS installation instructions\n\n# Tutorial - Bootstrapping a Deploy\n\n- `git clone https://github.com/pwrdrvr/microapps-core.git`\n  - Note: the repo is only being for the example CDK Stack, it is not necessary to clone the repo when used in a custom CDK Stack\n- `cd microapps-core`\n- `npm i -g aws-cdk`\n  - Install AWS CDK v2 CLI\n- `asp [my-sso-profile-name]`\n  - Using the `aws` plugin from `oh-my-zsh` for AWS SSO\n  - Of course, there are other methods of setting env vars\n- `aws sso login`\n  - Establish an AWS SSO session\n- `cdk-sso-sync`\n  - Using `npm i -g cdk-sso-sync`\n  - Sets AWS SSO credentials in a way that CDK can use them\n  - Not necessary if not using AWS SSO\n- `export AWS_REGION=us-east-2`\n  - Region needs to be set for the Lambda invoke - This can be done other ways in `~/.aws/config` as well\n- `./deploy.sh`\n  - Deploys the CDK Stack\n  - Essentially runs two commands along with extraction of outputs:\n    - `npx cdk deploy --context @pwrdrvr/microapps:stackName=microapps-demo-deploy --context @pwrdrvr/microapps:deployReleaseApp=true microapps-basic`\n    - `npx microapps-publish publish -a release -n ${RELEASE_APP_PACKAGE_VERSION} -d ${DEPLOYER_LAMBDA_NAME} -l ${RELEASE_APP_LAMBDA_NAME} -s node_modules/@pwrdrvr/microapps-app-release-cdk/lib/.static_files/release/${RELEASE_APP_PACKAGE_VERSION}/ --overwrite --noCache`\n  - URL will be printed as last output\n\n# Why MicroApps\n\nMicroApps are like micro services, but for Web UIs. A MicroApp allows a single functional site to be developed by many independent teams within an organization. Teams must coordinate deployments and agree upon one implementation technology and framework when building a monolithic, or even a monorepo, web application.\n\nTeams using MicroApps can deploy independently of each other with coordination being required only at points of intentional integration (e.g. adding a feature to pass context from one MicroApp to another or coordination of a major feature release to users) and sharing UI styles, if desired (it is possible to build styles that look the same across many different UI frameworks).\n\nMicroApps also allow each team to use a UI framework and backend language that is most appropriate for their solving their business problem. Not every app has to use React or Next.js or even Node on the backend, but instead they can use whatever framework they want and Java, Go, C#, Python, etc. for UI API calls.\n\nFor internal sites, or logged-in-customer sites, different tools or products can be hosted in entirely independent MicroApps. A menuing system / toolbar application can be created as a MicroApp and that menu app can open the apps in the system within a transparent iframe. For externally facing sites, such as for an e-commerce site, it is possible to have a MicroApp serving `/product/...`, another serving `/search/...`, another serving `/`, etc.\n\n# Limitations / Future Development\n\n- `iframes`\n  - Yeah, yeah: `iframes` are not framesets and most of the hate about iframes is probably better directed at framesets\n  - The iframe serves a purpose but it stinks that it is there, primarily because it will cause issues with search bot indexing (SEO)\n  - There are other options available to implement that have their own drabacks:\n    - Using the `microapps-router` to proxy the \"app start\" request to a particular version of an app that then renders all of it's API resource requests to versioned URLs\n      - Works only with frameworks that support hashing filenams for each deploy to unique names\n      - This page would need to be marked as non-cachable\n      - This may work well with Next.js which wants to know the explicit path that it will be running at (it writes that path into all resource and API requests)\n      - Possible issue: the app would need to work ok being displayed at `[/{prefix}]/{appname}` when it may think that it's being displayed at `[/{prefix}]/{appname}/{semver}`\n      - Disadvantage: requires some level of UI framework features (e.g. writing the absolute resource paths) to work correctly - may not work as easily for all UI frameworks\n    - HTML5 added features to allow setting the relative path of all subsequent requests to be different than that displayed in the address bar\n      - Gotta see if this works in modern browsers\n    - Option to ditch the multiple-versions feature\n      - Works only with frameworks that support hashing filenams for each deploy to unique names\n      - Allows usage of the deploy and routing tooling without advantages and disadvantages of multiple-versions support\n- AWS Only\n  - For the time being this has only been implemented for AWS technologies and APIs\n  - It is possible that Azure and GCP have sufficient support to enable porting the framework\n  - CDK would have to be replaced as well (unless it's made available for Azure and GCP in the near future)\n- `microapps-publish` only supports Lambda function apps\n  - There is no technical reason for the apps to only run as Lambda functions\n  - Web apps could just as easily run on EC2, Kubernetes, EKS, ECS, etc\n  - Anything that API Gateway can route to can work for serving a MicroApp\n  - The publish tool needs to provide additional options for setting up the API Gateway route to the app\n- Authentication\n  - Authentication requires rolling your own API Gateway and CloudFront deployment at the moment\n  - The \"turn key\" CDK Construct should provide options to show an example of how authentication can be integrated\n- Release Rules\n  - Currently only a Default rule is supported\n  - Need to evaluate if a generic implementation can be made, possibly allowing plugins or webhooks to support arbitrary rules\n  - If not possible to make it perfectly generic, consider providing a more complete reference implementation of examples\n\n# Related Projects / Components\n\n- Release App\n  - The Release app is an initial, rudimentary, release control console for setting the default version of an application\n  - Built with Next.js\n  - [pwrdrvr/microapps-app-release](https://github.com/pwrdrvr/microapps-app-release)\n- Next.js Demo App\n  - The Next.js Tutorial application deployed as a MicroApp\n  - [pwrdrvr/serverless-nextjs-demo](https://github.com/pwrdrvr/serverless-nextjs-demo)\n- Serverless Next.js Router\n  - [pwrdrvr/serverless-nextjs-router](https://github.com/pwrdrvr/serverless-nextjs-router)\n  - Complementary to [@sls-next/serverless-component](https://github.com/serverless-nextjs/serverless-next.js)\n  - Allows Next.js apps to run as Lambda @ Origin for speed and cost improvements vs Lambda@Edge\n  - Essentially the router translates CloudFront Lambda events to API Gateway Lambda events and vice versa for responses\n  - The `serverless-nextjs` project allows Next.js apps to run as Lambda functions without Express, but there was a design change to make the Lambda functions run at Edge (note: need to recheck if this changed after early 2021)\n    - Lambda@Edge is _at least_ 3x more expensive than Lambda at the origin:\n      - In US East 1, the price per GB-Second is $0.00005001 for Lambda@Edge vs $0.0000166667 for Lambda at the origin\n    - Additionally, any DB or services calls from Lambda@Edge back to the origin will pay that 3x higher per GB-Second cost for any time spent waiting to send the request and get a response. Example:\n      - Lambda@Edge\n        - 0.250s Round Trip Time (RTT) for EU-zone edge request to hit US-East 1 Origin\n        - 0.200s DB lookup time\n        - 0.050s CPU usage to process the DB response\n        - 0.500s total billed time @ $0.00005001 @ 128 MB\n        - $0.000003125625 total charge\n      - Lambda at Origin\n        - RTT does not apply (it's effectively 1-2 ms to hit a DB in the same region)\n        - 0.200s DB lookup time\n        - 0.050s CPU usage to process the DB response\n        - 0.250s total billed time @ $0.0000166667 @ 128 MB\n        - Half the billed time of running on Lambda@Edge\n        - 1/6th the cost of running on Lambda@Edge:\n          - $0.000000520834375 total charge (assuming no CPU time to process the response)\n          - $0.000003125625 / $0.000000520834375 = 6x more expensive in Lambda@Edge\n\n# Architecure Diagram\n\n![Architecure Diagram](https://raw.githubusercontent.com/pwrdrvr/microapps-core/main/assets/images/architecture-diagram.png)\n\n# Project Layout\n\n- [packages/cdk](https://github.com/pwrdrvr/microapps-core/tree/main/packages/cdk)\n  - Example CDK Stack\n  - Deploys MicroApps CDK stack for the GitHub Workflows\n  - Can be used as an example of how to use the MicroApps CDK Construct\n- [packages/demo-app](https://github.com/pwrdrvr/microapps-core/tree/main/packages/demo-app)\n  - Example app with static resources and a Lambda function\n  - Does not use any Web UI framework at all\n- [packages/microapps-cdk](https://github.com/pwrdrvr/microapps-core/tree/main/packages/microapps-cdk)\n  - MicroApps\n    - \"Turn key\" CDK Construct that creates all assets needed for a working MicroApps deployment\n  - MicroAppsAPIGwy\n    - Create APIGateway HTTP API\n    - Creates domain names to point to the edge (Cloudfront) and origin (API Gateway)\n  - MicroAppsCF\n    - Creates Cloudfront distribution\n  - MicroAppsS3\n    - Creates S3 buckets\n  - MicroAppsSvcs\n    - Create DynamoDB table\n    - Create Deployer Lambda function\n    - Create Router Lambda function\n- [packages/microapps-datalib](https://github.com/pwrdrvr/microapps-core/tree/main/packages/microapps-datalib)\n  - Installed from `npm`:\n    - `npm i -g @pwrdrvr/microapps-datalib`\n  - APIs for access to the DynamoDB Table used by `microapps-publish`, `microapps-deployer`, and `@pwrdrvr/microapps-app-release-cdk`\n- [packages/microapps-deployer](https://github.com/pwrdrvr/microapps-core/tree/main/packages/microapps-deployer)\n  - Lambda service invoked by `microapps-publish` to record new app/version in the DynamoDB table, create API Gateway integrations, copy S3 assets from staging to prod bucket, etc.\n  - Returns a temporary S3 token with restricted access to the staging S3 bucket for upload of the static files for one app/semver\n- [packages/microapps-publish](https://github.com/pwrdrvr/microapps-core/tree/main/packages/microapps-publish)\n  - Installed from `npm`:\n    - `npm i -g @pwrdrvr/microapps-publish`\n  - Node executable that updates versions in config files, deploys static assets to the S3 staging bucket, optionally compiles and deploys a new Lambda function version, and invokes `microapps-deployer`\n  - AWS IAM permissions required:\n    - `lambda:InvokeFunction`\n- [packages/microapps-router](https://github.com/pwrdrvr/microapps-core/tree/main/packages/microapps-router)\n  - Lambda function that determines which version of an app to point a user to on a particular invocation\n\n# Creating a MicroApp Using Zip Lambda Functions\n\n[TBC]\n\n# Creating a MicroApp Using Docker Lambda Functions\n\nNote: semi-deprecated as of 2022-01-27. Zip Lambda functions are better supported.\n\n## Next.js Apps\n\nCreate a Next.js app then follow the steps in this section to set it up for publishing to AWS Lambda @ Origin as a MicroApp. To publish new versions of the app use `npx microapps-publish --new-version x.y.z` when logged in to the target AWS account.\n\n### Modify package.json\n\nReplace the version with `0.0.0` so it can be modified by the `microapps-publish` tool.\n\n### Install Dependencies\n\n```\nnpm i --save-dev @sls-next/serverless-component@1.19.0 @pwrdrvr/serverless-nextjs-router @pwrdrvr/microapps-publish\n```\n\n### Dockerfile\n\nAdd this file to the root of the app.\n\n```Dockerfile\nFROM node:15-slim as base\n\nWORKDIR /app\n\n# Download the sharp libs once to save time\n# Do this before copying anything else in\nRUN mkdir -p image-lambda-npms && \\\n  cd image-lambda-npms && npm i sharp && \\\n  rm -rf node_modules/sharp/vendor/*/include/\n\n# Copy in the build output from `npx serverless`\nCOPY .serverless_nextjs .\nCOPY config.json .\n\n# Move the sharp libs into place\nRUN rm -rf image-lambda/node_modules/ && \\\n  mv image-lambda-npms/node_modules image-labmda/ && \\\n  rm -rf image-lambda-npms\n\nFROM public.ecr.aws/lambda/nodejs:14 AS final\n\n# Copy in the munged code\nCOPY --from=base /app .\n\nCMD [ \"./index.handler\" ]\n```\n\n### next.config.js\n\nAdd this file to the root of the app.\n\nReplace `appname` with your URL path-compatible application name.\n\n```js\nconst appRoot = '/appname/0.0.0';\n\n// eslint-disable-next-line no-undef\nmodule.exports = {\n  target: 'serverless',\n  webpack: (config, _options) => {\n    return config;\n  },\n  basePath: appRoot,\n  publicRuntimeConfig: {\n    // Will be available on both server and client\n    staticFolder: appRoot,\n  },\n};\n```\n\n### deploy.json\n\nAdd this file to the root of the app.\n\nReplace `appname` with your URL path-compatible application name.\n\n```json\n{\n  \"AppName\": \"appname\",\n  \"SemVer\": \"0.0.0\",\n  \"DefaultFile\": \"\",\n  \"StaticAssetsPath\": \"./.serverless_nextjs/assets/appname/0.0.0/\",\n  \"LambdaARN\": \"arn:aws:lambda:us-east-1:123456789012:function:appname:v0_0_0\",\n  \"AWSAccountID\": \"123456789012\",\n  \"AWSRegion\": \"us-east-2\",\n  \"ServerlessNextRouterPath\": \"./node_modules/@pwrdrvr/serverless-nextjs-router/dist/index.js\"\n}\n```\n\n### serverless.yaml\n\nAdd this file to the root of the app.\n\n```yaml\nnextApp:\n  component: './node_modules/@sls-next/serverless-component'\n  inputs:\n    deploy: false\n    uploadStaticAssetsFromBuild: false\n```\n"
   },
   "repository": {
     "type": "git",
@@ -2935,26 +2935,27 @@
       "assembly": "@pwrdrvr/microapps-cdk",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "experimental",
+        "summary": "Options for `AddRoutes`."
       },
       "fqn": "@pwrdrvr/microapps-cdk.AddRoutesOptions",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/MicroAppsCF.ts",
-        "line": 118
+        "line": 143
       },
       "name": "AddRoutesOptions",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "API Gateway CloudFront Origin for API calls."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 122
+            "line": 147
           },
           "name": "apiGwyOrigin",
           "type": {
@@ -2964,13 +2965,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Origin Request policy for API Gateway Origin."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 137
+            "line": 162
           },
           "name": "apigwyOriginRequestPolicy",
           "type": {
@@ -2980,13 +2981,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "S3 Bucket CloudFront Origin for static assets."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 127
+            "line": 152
           },
           "name": "bucketAppsOrigin",
           "type": {
@@ -2996,13 +2997,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "CloudFront Distribution to add the Behaviors (Routes) to."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 132
+            "line": 157
           },
           "name": "distro",
           "type": {
@@ -3014,13 +3015,13 @@
           "docs": {
             "default": "true",
             "remarks": "When false API routes with a period in the path will get routed to S3.\n\nWhen true API routes that contain /api/ in the path will get routed to API Gateway\neven if they have a period in the path.",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Create an extra Behavior (Route) for /api/ that allows API routes to have a period in them."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 157
+            "line": 182
           },
           "name": "createAPIPathRoute",
           "optional": true,
@@ -3032,13 +3033,13 @@
           "abstract": true,
           "docs": {
             "example": "dev/",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Path prefix on the root of the CloudFront distribution."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 144
+            "line": 169
           },
           "name": "rootPathPrefix",
           "optional": true,
@@ -3053,25 +3054,29 @@
       "assembly": "@pwrdrvr/microapps-cdk",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "experimental",
+        "summary": "Options for the `CreateAPIOriginPolicy`."
       },
       "fqn": "@pwrdrvr/microapps-cdk.CreateAPIOriginPolicyOptions",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/MicroAppsCF.ts",
-        "line": 106
+        "line": 115
       },
       "name": "CreateAPIOriginPolicyOptions",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "- resource names auto assigned",
+            "example": "microapps",
+            "stability": "experimental",
+            "summary": "Optional asset name root."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 107
+            "line": 122
           },
           "name": "assetNameRoot",
           "optional": true,
@@ -3082,12 +3087,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "none",
+            "example": "-dev-pr-12",
+            "stability": "experimental",
+            "summary": "Optional asset name suffix."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 108
+            "line": 130
           },
           "name": "assetNameSuffix",
           "optional": true,
@@ -3098,13 +3106,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Edge domain name used by CloudFront - If set a custom OriginRequestPolicy will be created that prevents the Host header from being passed to the origin."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 115
+            "line": 137
           },
           "name": "domainNameEdge",
           "optional": true,
@@ -3118,25 +3126,27 @@
     "@pwrdrvr/microapps-cdk.IMicroApps": {
       "assembly": "@pwrdrvr/microapps-cdk",
       "docs": {
-        "stability": "stable"
+        "stability": "experimental",
+        "summary": "Represents a MicroApps."
       },
       "fqn": "@pwrdrvr/microapps-cdk.IMicroApps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/MicroApps.ts",
-        "line": 172
+        "line": 195
       },
       "name": "IMicroApps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "experimental",
+            "summary": "{@inheritdoc IMicroAppsAPIGwy}."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 176
+            "line": 206
           },
           "name": "apigwy",
           "type": {
@@ -3146,12 +3156,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "experimental",
+            "summary": "{@inheritdoc IMicroAppsCF}."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 173
+            "line": 197
           },
           "name": "cf",
           "type": {
@@ -3161,12 +3172,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "experimental",
+            "summary": "{@inheritdoc IMicroAppsS3}."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 174
+            "line": 200
           },
           "name": "s3",
           "type": {
@@ -3176,12 +3188,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "experimental",
+            "summary": "{@inheritdoc IMicroAppsSvcs}."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 175
+            "line": 203
           },
           "name": "svcs",
           "type": {
@@ -3194,26 +3207,27 @@
     "@pwrdrvr/microapps-cdk.IMicroAppsAPIGwy": {
       "assembly": "@pwrdrvr/microapps-cdk",
       "docs": {
-        "stability": "stable"
+        "stability": "experimental",
+        "summary": "Represents a MicroApps API Gateway."
       },
       "fqn": "@pwrdrvr/microapps-cdk.IMicroAppsAPIGwy",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/MicroAppsAPIGwy.ts",
-        "line": 75
+        "line": 81
       },
       "name": "IMicroAppsAPIGwy",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "API Gateway."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsAPIGwy.ts",
-            "line": 84
+            "line": 90
           },
           "name": "httpApi",
           "type": {
@@ -3223,13 +3237,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Domain Name applied to API Gateway origin."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsAPIGwy.ts",
-            "line": 79
+            "line": 85
           },
           "name": "dnAppsOrigin",
           "optional": true,
@@ -3243,25 +3257,26 @@
     "@pwrdrvr/microapps-cdk.IMicroAppsCF": {
       "assembly": "@pwrdrvr/microapps-cdk",
       "docs": {
-        "stability": "stable"
+        "stability": "experimental",
+        "summary": "Represents a MicroApps CloudFront."
       },
       "fqn": "@pwrdrvr/microapps-cdk.IMicroAppsCF",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/MicroAppsCF.ts",
-        "line": 14
+        "line": 17
       },
       "name": "IMicroAppsCF",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "experimental"
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 15
+            "line": 18
           },
           "name": "cloudFrontDistro",
           "type": {
@@ -3274,26 +3289,27 @@
     "@pwrdrvr/microapps-cdk.IMicroAppsS3": {
       "assembly": "@pwrdrvr/microapps-cdk",
       "docs": {
-        "stability": "stable"
+        "stability": "experimental",
+        "summary": "Represents a MicroApps S3."
       },
       "fqn": "@pwrdrvr/microapps-cdk.IMicroAppsS3",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/MicroAppsS3.ts",
-        "line": 7
+        "line": 10
       },
       "name": "IMicroAppsS3",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "S3 bucket for deployed applications."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 11
+            "line": 14
           },
           "name": "bucketApps",
           "type": {
@@ -3303,13 +3319,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "CloudFront Origin Access Identity for the deployed applications bucket."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 16
+            "line": 19
           },
           "name": "bucketAppsOAI",
           "type": {
@@ -3319,13 +3335,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "CloudFront Origin for the deployed applications bucket."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 21
+            "line": 24
           },
           "name": "bucketAppsOrigin",
           "type": {
@@ -3335,13 +3351,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "S3 bucket for staged applications (prior to deploy)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 26
+            "line": 29
           },
           "name": "bucketAppsStaging",
           "type": {
@@ -3351,13 +3367,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "S3 bucket for CloudFront logs."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 31
+            "line": 34
           },
           "name": "bucketLogs",
           "type": {
@@ -3370,26 +3386,27 @@
     "@pwrdrvr/microapps-cdk.IMicroAppsSvcs": {
       "assembly": "@pwrdrvr/microapps-cdk",
       "docs": {
-        "stability": "stable"
+        "stability": "experimental",
+        "summary": "Represents a MicroApps Services."
       },
       "fqn": "@pwrdrvr/microapps-cdk.IMicroAppsSvcs",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/MicroAppsSvcs.ts",
-        "line": 113
+        "line": 193
       },
       "name": "IMicroAppsSvcs",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Lambda function for the Deployer."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 122
+            "line": 202
           },
           "name": "deployerFunc",
           "type": {
@@ -3399,13 +3416,29 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
+            "summary": "Lambda function for the Router."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/MicroAppsSvcs.ts",
+            "line": 207
+          },
+          "name": "routerFunc",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_lambda.IFunction"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
             "summary": "DynamoDB table used by Router, Deployer, and Release console app."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 117
+            "line": 197
           },
           "name": "table",
           "type": {
@@ -3419,19 +3452,19 @@
       "assembly": "@pwrdrvr/microapps-cdk",
       "base": "constructs.Construct",
       "docs": {
-        "stability": "stable",
-        "summary": "Application deployment and runtime environment."
+        "remarks": "Use this construct to create a working entire stack.\n\nDo not use this construct when adding MicroApps to an existing\nCloudFront, API Gateway, S3 Bucket, etc. or where access\nto all features of the AWS Resources are needed (e.g. to\nadd additional Behaviors to the CloudFront distribution, set authorizors\non API Gateway, etc.).",
+        "see": "{@link https://github.com/pwrdrvr/microapps-core/blob/main/packages/cdk/lib/MicroApps.ts | example usage in a CDK Stack }",
+        "stability": "experimental",
+        "summary": "Create a new MicroApps \"turnkey\" construct for simple deployments and for initial evaulation of the MicroApps framework."
       },
       "fqn": "@pwrdrvr/microapps-cdk.MicroApps",
       "initializer": {
         "docs": {
-          "remarks": "This is the \"Easy Button\" construct to get started as quickly as possible.",
-          "stability": "stable",
-          "summary": "MicroApps - Create entire stack of CloudFront, S3, API Gateway, and Lambda Functions."
+          "stability": "experimental"
         },
         "locationInModule": {
           "filename": "src/MicroApps.ts",
-          "line": 211
+          "line": 244
         },
         "parameters": [
           {
@@ -3461,18 +3494,19 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/MicroApps.ts",
-        "line": 182
+        "line": 223
       },
       "name": "MicroApps",
       "properties": [
         {
           "docs": {
-            "stability": "stable"
+            "stability": "experimental",
+            "summary": "{@inheritdoc IMicroAppsAPIGwy}."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 194
+            "line": 235
           },
           "name": "apigwy",
           "overrides": "@pwrdrvr/microapps-cdk.IMicroApps",
@@ -3482,12 +3516,13 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "experimental",
+            "summary": "{@inheritdoc IMicroAppsCF}."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 184
+            "line": 225
           },
           "name": "cf",
           "overrides": "@pwrdrvr/microapps-cdk.IMicroApps",
@@ -3497,12 +3532,13 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "experimental",
+            "summary": "{@inheritdoc IMicroAppsS3}."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 189
+            "line": 230
           },
           "name": "s3",
           "overrides": "@pwrdrvr/microapps-cdk.IMicroApps",
@@ -3512,12 +3548,13 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "experimental",
+            "summary": "{@inheritdoc IMicroAppsSvcs}."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 199
+            "line": 240
           },
           "name": "svcs",
           "overrides": "@pwrdrvr/microapps-cdk.IMicroApps",
@@ -3532,17 +3569,17 @@
       "assembly": "@pwrdrvr/microapps-cdk",
       "base": "constructs.Construct",
       "docs": {
-        "stability": "stable"
+        "stability": "experimental",
+        "summary": "Create a new MicroApps API Gateway HTTP API endpoint."
       },
       "fqn": "@pwrdrvr/microapps-cdk.MicroAppsAPIGwy",
       "initializer": {
         "docs": {
-          "stability": "stable",
-          "summary": "MicroApps - Create just API Gateway."
+          "stability": "experimental"
         },
         "locationInModule": {
           "filename": "src/MicroAppsAPIGwy.ts",
-          "line": 104
+          "line": 107
         },
         "parameters": [
           {
@@ -3572,19 +3609,19 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/MicroAppsAPIGwy.ts",
-        "line": 87
+        "line": 96
       },
       "name": "MicroAppsAPIGwy",
       "properties": [
         {
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "API Gateway."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsAPIGwy.ts",
-            "line": 94
+            "line": 103
           },
           "name": "httpApi",
           "overrides": "@pwrdrvr/microapps-cdk.IMicroAppsAPIGwy",
@@ -3594,13 +3631,13 @@
         },
         {
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Domain Name applied to API Gateway origin."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsAPIGwy.ts",
-            "line": 89
+            "line": 98
           },
           "name": "dnAppsOrigin",
           "optional": true,
@@ -3616,13 +3653,14 @@
       "assembly": "@pwrdrvr/microapps-cdk",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "experimental",
+        "summary": "Properties to initialize an instance of `MicroAppsAPIGwy`."
       },
       "fqn": "@pwrdrvr/microapps-cdk.MicroAppsAPIGwyProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/MicroAppsAPIGwy.ts",
-        "line": 11
+        "line": 14
       },
       "name": "MicroAppsAPIGwyProps",
       "properties": [
@@ -3631,13 +3669,13 @@
           "docs": {
             "default": "- resource names auto assigned",
             "example": "microapps",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Optional asset name root."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsAPIGwy.ts",
-            "line": 43
+            "line": 46
           },
           "name": "assetNameRoot",
           "optional": true,
@@ -3650,13 +3688,13 @@
           "docs": {
             "default": "none",
             "example": "-dev-pr-12",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Optional asset name suffix."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsAPIGwy.ts",
-            "line": 51
+            "line": 54
           },
           "name": "assetNameSuffix",
           "optional": true,
@@ -3668,13 +3706,13 @@
           "abstract": true,
           "docs": {
             "default": "none",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Optional local region ACM certificate to use for API Gateway Note: required when using a custom domain."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsAPIGwy.ts",
-            "line": 59
+            "line": 62
           },
           "name": "certOrigin",
           "optional": true,
@@ -3687,13 +3725,13 @@
           "docs": {
             "default": "auto-assigned",
             "example": "apps.pwrdrvr.com",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "CloudFront edge domain name."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsAPIGwy.ts",
-            "line": 27
+            "line": 30
           },
           "name": "domainNameEdge",
           "optional": true,
@@ -3706,13 +3744,13 @@
           "docs": {
             "default": "auto-assigned",
             "example": "apps-origin.pwrdrvr.com",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "API Gateway origin domain name."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsAPIGwy.ts",
-            "line": 35
+            "line": 38
           },
           "name": "domainNameOrigin",
           "optional": true,
@@ -3723,13 +3761,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Route53 zone in which to create optional `domainNameEdge` record."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsAPIGwy.ts",
-            "line": 64
+            "line": 67
           },
           "name": "r53Zone",
           "optional": true,
@@ -3742,13 +3780,13 @@
           "docs": {
             "default": "- per resource default",
             "remarks": "Note: if set to DESTROY the S3 buckes will have `autoDeleteObjects` set to `true`",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "RemovalPolicy override for child resources."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsAPIGwy.ts",
-            "line": 19
+            "line": 22
           },
           "name": "removalPolicy",
           "optional": true,
@@ -3761,13 +3799,13 @@
           "docs": {
             "default": "none",
             "example": "dev/",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Path prefix on the root of the API Gateway Stage."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsAPIGwy.ts",
-            "line": 72
+            "line": 75
           },
           "name": "rootPathPrefix",
           "optional": true,
@@ -3782,17 +3820,17 @@
       "assembly": "@pwrdrvr/microapps-cdk",
       "base": "constructs.Construct",
       "docs": {
-        "stability": "stable"
+        "stability": "experimental",
+        "summary": "Create a new MicroApps CloudFront Distribution."
       },
       "fqn": "@pwrdrvr/microapps-cdk.MicroAppsCF",
       "initializer": {
         "docs": {
-          "stability": "stable",
-          "summary": "MicroApps - Create just CloudFront resources."
+          "stability": "experimental"
         },
         "locationInModule": {
           "filename": "src/MicroAppsCF.ts",
-          "line": 284
+          "line": 306
         },
         "parameters": [
           {
@@ -3821,17 +3859,17 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/MicroAppsCF.ts",
-        "line": 160
+        "line": 188
       },
       "methods": [
         {
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Add API Gateway and S3 routes to an existing CloudFront Distribution."
           },
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 214
+            "line": 242
           },
           "name": "addRoutes",
           "parameters": [
@@ -3853,12 +3891,12 @@
         {
           "docs": {
             "remarks": "If a custom domain name is NOT used for the origin then a policy\nwill be created.\n\nIf a custom domain name IS used for the origin then the ALL_VIEWER\npolicy will be returned.  This policy passes the Host header to the\norigin, which is fine when using a custom domain name on the origin.",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Create or get the origin request policy."
           },
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 174
+            "line": 202
           },
           "name": "createAPIOriginPolicy",
           "parameters": [
@@ -3887,12 +3925,12 @@
       "properties": [
         {
           "docs": {
-            "stability": "stable"
+            "stability": "experimental"
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 274
+            "line": 302
           },
           "name": "cloudFrontDistro",
           "overrides": "@pwrdrvr/microapps-cdk.IMicroAppsCF",
@@ -3907,26 +3945,27 @@
       "assembly": "@pwrdrvr/microapps-cdk",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "experimental",
+        "summary": "Properties to initialize an instance of `MicroAppsCF`."
       },
       "fqn": "@pwrdrvr/microapps-cdk.MicroAppsCFProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/MicroAppsCF.ts",
-        "line": 18
+        "line": 24
       },
       "name": "MicroAppsCFProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "S3 bucket origin for deployed applications."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 31
+            "line": 37
           },
           "name": "bucketAppsOrigin",
           "type": {
@@ -3936,13 +3975,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "API Gateway v2 HTTP API for apps."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 57
+            "line": 63
           },
           "name": "httpApi",
           "type": {
@@ -3954,13 +3993,13 @@
           "docs": {
             "default": "- resource names auto assigned",
             "example": "microapps",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Optional asset name root."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 65
+            "line": 71
           },
           "name": "assetNameRoot",
           "optional": true,
@@ -3973,13 +4012,13 @@
           "docs": {
             "default": "none",
             "example": "-dev-pr-12",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Optional asset name suffix."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 73
+            "line": 79
           },
           "name": "assetNameSuffix",
           "optional": true,
@@ -3990,13 +4029,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "S3 bucket for CloudFront logs."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 36
+            "line": 42
           },
           "name": "bucketLogs",
           "optional": true,
@@ -4007,13 +4046,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "ACM Certificate that covers `domainNameEdge` name."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 78
+            "line": 84
           },
           "name": "certEdge",
           "optional": true,
@@ -4026,13 +4065,13 @@
           "docs": {
             "default": "true",
             "remarks": "When false API routes with a period in the path will get routed to S3.\n\nWhen true API routes that contain /api/ in the path will get routed to API Gateway\neven if they have a period in the path.",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Create an extra Behavior (Route) for /api/ that allows API routes to have a period in them."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 103
+            "line": 109
           },
           "name": "createAPIPathRoute",
           "optional": true,
@@ -4045,13 +4084,13 @@
           "docs": {
             "default": "auto-assigned",
             "example": "apps.pwrdrvr.com",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "CloudFront Distribution domain name."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 44
+            "line": 50
           },
           "name": "domainNameEdge",
           "optional": true,
@@ -4064,13 +4103,13 @@
           "docs": {
             "default": "- retrieved from httpApi, if possible",
             "example": "apps.pwrdrvr.com",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "API Gateway custom origin domain name."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 52
+            "line": 58
           },
           "name": "domainNameOrigin",
           "optional": true,
@@ -4081,13 +4120,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Route53 zone in which to create optional `domainNameEdge` record."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 83
+            "line": 89
           },
           "name": "r53Zone",
           "optional": true,
@@ -4100,13 +4139,13 @@
           "docs": {
             "default": "- per resource default",
             "remarks": "Note: if set to DESTROY the S3 buckes will have `autoDeleteObjects` set to `true`",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "RemovalPolicy override for child resources."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 26
+            "line": 32
           },
           "name": "removalPolicy",
           "optional": true,
@@ -4118,13 +4157,13 @@
           "abstract": true,
           "docs": {
             "example": "dev/",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Path prefix on the root of the CloudFront distribution."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsCF.ts",
-            "line": 90
+            "line": 96
           },
           "name": "rootPathPrefix",
           "optional": true,
@@ -4139,14 +4178,14 @@
       "assembly": "@pwrdrvr/microapps-cdk",
       "datatype": true,
       "docs": {
-        "stability": "stable",
-        "summary": "Props for MicroApps."
+        "stability": "experimental",
+        "summary": "Properties to initialize an instance of `MicroApps`."
       },
       "fqn": "@pwrdrvr/microapps-cdk.MicroAppsProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/MicroApps.ts",
-        "line": 14
+        "line": 36
       },
       "name": "MicroAppsProps",
       "properties": [
@@ -4154,13 +4193,13 @@
           "abstract": true,
           "docs": {
             "default": "dev",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Passed to NODE_ENV of Router and Deployer Lambda functions."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 29
+            "line": 51
           },
           "name": "appEnv",
           "type": {
@@ -4172,13 +4211,13 @@
           "docs": {
             "default": "- resource names auto assigned",
             "example": "microapps",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Optional asset name root."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 37
+            "line": 59
           },
           "name": "assetNameRoot",
           "optional": true,
@@ -4191,13 +4230,13 @@
           "docs": {
             "default": "none",
             "example": "-dev-pr-12",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Optional asset name suffix."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 45
+            "line": 67
           },
           "name": "assetNameSuffix",
           "optional": true,
@@ -4208,13 +4247,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Certificate in US-East-1 for the CloudFront distribution."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 56
+            "line": 77
           },
           "name": "certEdge",
           "optional": true,
@@ -4225,13 +4264,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Certificate in deployed region for the API Gateway."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 62
+            "line": 82
           },
           "name": "certOrigin",
           "optional": true,
@@ -4244,13 +4283,13 @@
           "docs": {
             "default": "true",
             "remarks": "When false API routes with a period in the path will get routed to S3.\n\nWhen true API routes that contain /api/ in the path will get routed to API Gateway\neven if they have a period in the path.",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Create an extra Behavior (Route) for /api/ that allows API routes to have a period in them."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 169
+            "line": 189
           },
           "name": "createAPIPathRoute",
           "optional": true,
@@ -4263,13 +4302,13 @@
           "docs": {
             "default": "auto-assigned",
             "example": "apps.pwrdrvr.com",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Optional custom domain name for the CloudFront distribution."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 141
+            "line": 161
           },
           "name": "domainNameEdge",
           "optional": true,
@@ -4282,13 +4321,13 @@
           "docs": {
             "default": "auto-assigned",
             "example": "apps-origin.pwrdrvr.com",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Optional custom domain name for the API Gateway HTTPv2 API."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 149
+            "line": 169
           },
           "name": "domainNameOrigin",
           "optional": true,
@@ -4299,13 +4338,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Route53 zone in which to create optional `domainNameEdge` record."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 50
+            "line": 72
           },
           "name": "r53Zone",
           "optional": true,
@@ -4318,13 +4357,13 @@
           "docs": {
             "default": "- per resource default",
             "remarks": "Note: if set to DESTROY the S3 buckes will have `autoDeleteObjects` set to `true`",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "RemovalPolicy override for child resources."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 22
+            "line": 44
           },
           "name": "removalPolicy",
           "optional": true,
@@ -4336,13 +4375,13 @@
           "abstract": true,
           "docs": {
             "example": "dev/",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Path prefix on the root of the CloudFront distribution."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 156
+            "line": 176
           },
           "name": "rootPathPrefix",
           "optional": true,
@@ -4356,13 +4395,13 @@
             "example": "[ 'AROA1234567890123' ]",
             "remarks": "AROAs of the IAM Role to exclude from the DENY rules on the S3 Bucket Policy.\nThis allows sessions that assume the IAM Role to be excluded from the\nDENY rules on the S3 Bucket Policy.\n\nTypically any admin roles / users that need to view or manage the S3 Bucket\nwould be added to this list.\n\nRoles / users that are used directly, not assumed, can be added to `s3PolicyBypassRoleNames` instead.\n\nNote: This AROA must be specified to prevent this policy from locking\nout non-root sessions that have assumed the admin role.\n\nThe notPrincipals will only match the role name exactly and will not match\nany session that has assumed the role since notPrincipals does not allow\nwildcard matches and does not do wildcard matches implicitly either.\n\nThe AROA must be used because there are only 3 Principal variables available:\n  https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_variables.html#principaltable\n  aws:username, aws:userid, aws:PrincipalTag\n\nFor an assumed role, aws:username is blank, aws:userid is:\n  [unique id AKA AROA for Role]:[session name]\n\nTable of unique ID prefixes such as AROA:\n  https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-prefixes\n\nThe name of the role is simply not available for an assumed role and, if it was,\na complicated comparison would be requierd to prevent exclusion\nof applying the Deny Rule to roles from other accounts.\n\nTo get the AROA with the AWS CLI:\n   aws iam get-role --role-name ROLE-NAME\n   aws iam get-user -–user-name USER-NAME",
             "see": "s3StrictBucketPolicy",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Applies when using s3StrictBucketPolicy = true."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 133
+            "line": 153
           },
           "name": "s3PolicyBypassAROAs",
           "optional": true,
@@ -4381,13 +4420,13 @@
             "example": "['arn:aws:iam::1234567890123:role/AdminAccess', 'arn:aws:iam::1234567890123:user/MyAdminUser']",
             "remarks": "IAM Role or IAM User names to exclude from the DENY rules on the S3 Bucket Policy.\n\nRoles that are Assumed must instead have their AROA added to `s3PolicyBypassAROAs`.\n\nTypically any admin roles / users that need to view or manage the S3 Bucket\nwould be added to this list.",
             "see": "s3PolicyBypassAROAs",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Applies when using s3StrictBucketPolicy = true."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 90
+            "line": 110
           },
           "name": "s3PolicyBypassPrincipalARNs",
           "optional": true,
@@ -4405,13 +4444,13 @@
           "docs": {
             "default": "false",
             "remarks": "This setting should be used when applications are less than\nfully trusted.",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Use a strict S3 Bucket Policy that prevents applications from reading/writing/modifying/deleting files in the S3 Bucket outside of the path that is specific to their app/version."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroApps.ts",
-            "line": 74
+            "line": 94
           },
           "name": "s3StrictBucketPolicy",
           "optional": true,
@@ -4426,17 +4465,17 @@
       "assembly": "@pwrdrvr/microapps-cdk",
       "base": "constructs.Construct",
       "docs": {
-        "stability": "stable"
+        "stability": "experimental",
+        "summary": "Create a new MicroApps S3 Bucket."
       },
       "fqn": "@pwrdrvr/microapps-cdk.MicroAppsS3",
       "initializer": {
         "docs": {
-          "stability": "stable",
-          "summary": "MicroApps - Create just S3 resources."
+          "stability": "experimental"
         },
         "locationInModule": {
           "filename": "src/MicroAppsS3.ts",
-          "line": 114
+          "line": 117
         },
         "parameters": [
           {
@@ -4466,19 +4505,19 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/MicroAppsS3.ts",
-        "line": 82
+        "line": 91
       },
       "name": "MicroAppsS3",
       "properties": [
         {
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "S3 bucket for deployed applications."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 84
+            "line": 93
           },
           "name": "bucketApps",
           "overrides": "@pwrdrvr/microapps-cdk.IMicroAppsS3",
@@ -4488,13 +4527,13 @@
         },
         {
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "CloudFront Origin Access Identity for the deployed applications bucket."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 89
+            "line": 98
           },
           "name": "bucketAppsOAI",
           "overrides": "@pwrdrvr/microapps-cdk.IMicroAppsS3",
@@ -4504,13 +4543,13 @@
         },
         {
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "CloudFront Origin for the deployed applications bucket."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 94
+            "line": 103
           },
           "name": "bucketAppsOrigin",
           "overrides": "@pwrdrvr/microapps-cdk.IMicroAppsS3",
@@ -4520,13 +4559,13 @@
         },
         {
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "S3 bucket for staged applications (prior to deploy)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 99
+            "line": 108
           },
           "name": "bucketAppsStaging",
           "overrides": "@pwrdrvr/microapps-cdk.IMicroAppsS3",
@@ -4536,13 +4575,13 @@
         },
         {
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "S3 bucket for CloudFront logs."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 104
+            "line": 113
           },
           "name": "bucketLogs",
           "overrides": "@pwrdrvr/microapps-cdk.IMicroAppsS3",
@@ -4557,13 +4596,14 @@
       "assembly": "@pwrdrvr/microapps-cdk",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "experimental",
+        "summary": "Properties to initialize an instance of `MicroAppsS3`."
       },
       "fqn": "@pwrdrvr/microapps-cdk.MicroAppsS3Props",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/MicroAppsS3.ts",
-        "line": 34
+        "line": 40
       },
       "name": "MicroAppsS3Props",
       "properties": [
@@ -4572,13 +4612,13 @@
           "docs": {
             "default": "- resource names auto assigned",
             "example": "microapps",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Optional asset name root."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 71
+            "line": 77
           },
           "name": "assetNameRoot",
           "optional": true,
@@ -4591,13 +4631,13 @@
           "docs": {
             "default": "none",
             "example": "-dev-pr-12",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Optional asset name suffix."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 79
+            "line": 85
           },
           "name": "assetNameSuffix",
           "optional": true,
@@ -4609,13 +4649,13 @@
           "abstract": true,
           "docs": {
             "default": "auto-assigned",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "S3 deployed apps bucket name."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 49
+            "line": 55
           },
           "name": "bucketAppsName",
           "optional": true,
@@ -4627,13 +4667,13 @@
           "abstract": true,
           "docs": {
             "default": "auto-assigned",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "S3 staging apps bucket name."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 56
+            "line": 62
           },
           "name": "bucketAppsStagingName",
           "optional": true,
@@ -4645,13 +4685,13 @@
           "abstract": true,
           "docs": {
             "default": "auto-assigned",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "S3 logs bucket name."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 63
+            "line": 69
           },
           "name": "bucketLogsName",
           "optional": true,
@@ -4663,14 +4703,14 @@
           "abstract": true,
           "docs": {
             "default": "- per resource default",
-            "remarks": "Note: if set to DESTROY the S3 buckes will have `autoDeleteObjects` set to `true`",
-            "stability": "stable",
+            "remarks": "Note: if set to DESTROY the S3 buckets will have `autoDeleteObjects` set to `true`",
+            "stability": "experimental",
             "summary": "RemovalPolicy override for child resources."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsS3.ts",
-            "line": 42
+            "line": 48
           },
           "name": "removalPolicy",
           "optional": true,
@@ -4685,17 +4725,17 @@
       "assembly": "@pwrdrvr/microapps-cdk",
       "base": "constructs.Construct",
       "docs": {
-        "stability": "stable"
+        "stability": "experimental",
+        "summary": "Create a new MicroApps Services construct, including the Deployer and Router Lambda Functions, and the DynamoDB Table used by both."
       },
       "fqn": "@pwrdrvr/microapps-cdk.MicroAppsSvcs",
       "initializer": {
         "docs": {
-          "stability": "stable",
-          "summary": "MicroApps - Create Lambda resources, DynamoDB, and grant S3 privs."
+          "stability": "experimental"
         },
         "locationInModule": {
           "filename": "src/MicroAppsSvcs.ts",
-          "line": 142
+          "line": 230
         },
         "parameters": [
           {
@@ -4725,19 +4765,19 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/MicroAppsSvcs.ts",
-        "line": 125
+        "line": 214
       },
       "name": "MicroAppsSvcs",
       "properties": [
         {
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Lambda function for the Deployer."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 132
+            "line": 221
           },
           "name": "deployerFunc",
           "overrides": "@pwrdrvr/microapps-cdk.IMicroAppsSvcs",
@@ -4747,13 +4787,29 @@
         },
         {
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
+            "summary": "Lambda function for the Router."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/MicroAppsSvcs.ts",
+            "line": 226
+          },
+          "name": "routerFunc",
+          "overrides": "@pwrdrvr/microapps-cdk.IMicroAppsSvcs",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_lambda.IFunction"
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
             "summary": "DynamoDB table used by Router, Deployer, and Release console app."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 127
+            "line": 216
           },
           "name": "table",
           "overrides": "@pwrdrvr/microapps-cdk.IMicroAppsSvcs",
@@ -4768,25 +4824,27 @@
       "assembly": "@pwrdrvr/microapps-cdk",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "experimental",
+        "summary": "Properties to initialize an instance of `MicroAppsSvcs`."
       },
       "fqn": "@pwrdrvr/microapps-cdk.MicroAppsSvcsProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/MicroAppsSvcs.ts",
-        "line": 52
+        "line": 58
       },
       "name": "MicroAppsSvcsProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "experimental",
+            "summary": "Application environment, passed as `NODE_ENV` to the Router and Deployer Lambda functions."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 82
+            "line": 92
           },
           "name": "appEnv",
           "type": {
@@ -4796,13 +4854,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "S3 bucket for deployed applications."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 65
+            "line": 71
           },
           "name": "bucketApps",
           "type": {
@@ -4812,13 +4870,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "CloudFront Origin Access Identity for the deployed applications bucket."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 70
+            "line": 76
           },
           "name": "bucketAppsOAI",
           "type": {
@@ -4828,13 +4886,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "S3 bucket for staged applications (prior to deploy)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 75
+            "line": 81
           },
           "name": "bucketAppsStaging",
           "type": {
@@ -4844,13 +4902,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "API Gateway v2 HTTP for Router and app."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 80
+            "line": 86
           },
           "name": "httpApi",
           "type": {
@@ -4862,13 +4920,13 @@
           "docs": {
             "default": "- resource names auto assigned",
             "example": "microapps",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Optional asset name root."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 90
+            "line": 100
           },
           "name": "assetNameRoot",
           "optional": true,
@@ -4881,13 +4939,13 @@
           "docs": {
             "default": "none",
             "example": "-dev-pr-12",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Optional asset name suffix."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 98
+            "line": 108
           },
           "name": "assetNameSuffix",
           "optional": true,
@@ -4900,13 +4958,13 @@
           "docs": {
             "default": "- per resource default",
             "remarks": "Note: if set to DESTROY the S3 buckes will have `autoDeleteObjects` set to `true`",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "RemovalPolicy override for child resources."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 60
+            "line": 66
           },
           "name": "removalPolicy",
           "optional": true,
@@ -4919,13 +4977,13 @@
           "docs": {
             "default": "none",
             "example": "dev/",
-            "stability": "stable",
+            "stability": "experimental",
             "summary": "Path prefix on the root of the deployment."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 110
+            "line": 187
           },
           "name": "rootPathPrefix",
           "optional": true,
@@ -4936,12 +4994,16 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "example": "[ 'AROA1234567890123' ]",
+            "remarks": "AROAs of the IAM Role to exclude from the DENY rules on the S3 Bucket Policy.\nThis allows sessions that assume the IAM Role to be excluded from the\nDENY rules on the S3 Bucket Policy.\n\nTypically any admin roles / users that need to view or manage the S3 Bucket\nwould be added to this list.\n\nRoles / users that are used directly, not assumed, can be added to `s3PolicyBypassRoleNames` instead.\n\nNote: This AROA must be specified to prevent this policy from locking\nout non-root sessions that have assumed the admin role.\n\nThe notPrincipals will only match the role name exactly and will not match\nany session that has assumed the role since notPrincipals does not allow\nwildcard matches and does not do wildcard matches implicitly either.\n\nThe AROA must be used because there are only 3 Principal variables available:\n  https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_variables.html#principaltable\n  aws:username, aws:userid, aws:PrincipalTag\n\nFor an assumed role, aws:username is blank, aws:userid is:\n  [unique id AKA AROA for Role]:[session name]\n\nTable of unique ID prefixes such as AROA:\n  https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-prefixes\n\nThe name of the role is simply not available for an assumed role and, if it was,\na complicated comparison would be requierd to prevent exclusion\nof applying the Deny Rule to roles from other accounts.\n\nTo get the AROA with the AWS CLI:\n   aws iam get-role --role-name ROLE-NAME\n   aws iam get-user -–user-name USER-NAME",
+            "see": "s3StrictBucketPolicy",
+            "stability": "experimental",
+            "summary": "Applies when using s3StrictBucketPolicy = true."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 101
+            "line": 179
           },
           "name": "s3PolicyBypassAROAs",
           "optional": true,
@@ -4957,12 +5019,16 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "example": "['arn:aws:iam::1234567890123:role/AdminAccess', 'arn:aws:iam::1234567890123:user/MyAdminUser']",
+            "remarks": "IAM Role or IAM User names to exclude from the DENY rules on the S3 Bucket Policy.\n\nRoles that are Assumed must instead have their AROA added to `s3PolicyBypassAROAs`.\n\nTypically any admin roles / users that need to view or manage the S3 Bucket\nwould be added to this list.",
+            "see": "s3PolicyBypassAROAs",
+            "stability": "experimental",
+            "summary": "Applies when using s3StrictBucketPolicy = true."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 102
+            "line": 136
           },
           "name": "s3PolicyBypassPrincipalARNs",
           "optional": true,
@@ -4978,12 +5044,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "false",
+            "remarks": "This setting should be used when applications are less than\nfully trusted.",
+            "stability": "experimental",
+            "summary": "Use a strict S3 Bucket Policy that prevents applications from reading/writing/modifying/deleting files in the S3 Bucket outside of the path that is specific to their app/version."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/MicroAppsSvcs.ts",
-            "line": 100
+            "line": 120
           },
           "name": "s3StrictBucketPolicy",
           "optional": true,
@@ -4995,6 +5064,6 @@
       "symbolId": "src/MicroAppsSvcs:MicroAppsSvcsProps"
     }
   },
-  "version": "0.2.4",
-  "fingerprint": "Vr5IabYst3i9OzyE7LhghpuMdH/5r38pZpvwYuKXt/g="
+  "version": "0.2.8",
+  "fingerprint": "zBluZY8PSoQOUT7McQE1oxPPrMm+QbpLV/+gVVMsHoo="
 }