@aws-cdk/aws-servicecatalogappregistry-alpha 2.44.0-alpha.0 → 2.45.0-alpha.0

package/.jsii

@@ -8,7 +8,7 @@
     "url": "https://aws.amazon.com"
   },
   "dependencies": {
-    "aws-cdk-lib": "^2.44.0",
+    "aws-cdk-lib": "^2.45.0",
     "constructs": "^10.0.0"
   },
   "dependencyClosure": {
@@ -730,6 +730,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_connectcampaigns": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.ConnectCampaigns"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.connectcampaigns"
+            },
+            "python": {
+              "module": "aws_cdk.aws_connectcampaigns"
+            }
+          }
+        },
         "aws-cdk-lib.aws_controltower": {
           "targets": {
             "dotnet": {
@@ -1510,6 +1523,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_iotfleetwise": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.IoTFleetWise"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.iotfleetwise"
+            },
+            "python": {
+              "module": "aws_cdk.aws_iotfleetwise"
+            }
+          }
+        },
         "aws-cdk-lib.aws_iotsitewise": {
           "targets": {
             "dotnet": {
@@ -2303,6 +2329,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_rolesanywhere": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.RolesAnywhere"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.rolesanywhere"
+            },
+            "python": {
+              "module": "aws_cdk.aws_rolesanywhere"
+            }
+          }
+        },
         "aws-cdk-lib.aws_route53": {
           "targets": {
             "dotnet": {
@@ -3085,7 +3124,7 @@
   },
   "name": "@aws-cdk/aws-servicecatalogappregistry-alpha",
   "readme": {
-    "markdown": "# AWS ServiceCatalogAppRegistry Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\n[AWS Service Catalog App Registry](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/appregistry.html)\nenables organizations to create and manage repositores of applications and associated resources.\n\n## Table Of Contents\n\n- [Application](#application)\n- [Attribute-Group](#attribute-group)\n- [Associations](#associations)\n  - [Associating application with an attribute group](#attribute-group-association)\n  - [Associating application with a stack](#resource-association)\n- [Sharing](#sharing)\n  - [Sharing an application](#sharing-an-application)\n  - [Sharing an attribute group](#sharing-an-attribute-group)\n\nThe `@aws-cdk/aws-servicecatalogappregistry` package contains resources that enable users to automate governance and management of their AWS resources at scale.\n\n```ts nofixture\nimport * as appreg from '@aws-cdk/aws-servicecatalogappregistry-alpha';\n```\n\n## Application\n\nAn AppRegistry application enables you to define your applications and associated resources.\nThe application name must be unique at the account level, but is mutable.\n\n```ts\nconst application = new appreg.Application(this, 'MyFirstApplication', {\n  applicationName: 'MyFirstApplicationName',\n  description: 'description for my application', // the description is optional\n});\n```\n\nAn application that has been created outside of the stack can be imported into your CDK app.\nApplications can be imported by their ARN via the `Application.fromApplicationArn()` API:\n\n```ts\nconst importedApplication = appreg.Application.fromApplicationArn(\n  this,\n  'MyImportedApplication',\n  'arn:aws:servicecatalog:us-east-1:012345678910:/applications/0aqmvxvgmry0ecc4mjhwypun6i',\n);\n```\n\n## Attribute Group\n\nAn AppRegistry attribute group acts as a container for user-defined attributes for an application.\nMetadata is attached in a machine-readble format to integrate with automated workflows and tools.\n\n```ts\nconst attributeGroup = new appreg.AttributeGroup(this, 'MyFirstAttributeGroup', {\n  attributeGroupName: 'MyFirstAttributeGroupName',\n  description: 'description for my attribute group', // the description is optional,\n  attributes: {\n    project: 'foo',\n    team: ['member1', 'member2', 'member3'],\n    public: false,\n    stages: {\n      alpha: 'complete',\n      beta: 'incomplete',\n      release: 'not started'\n    }\n  }\n});\n```\n\nAn attribute group that has been created outside of the stack can be imported into your CDK app.\nAttribute groups can be imported by their ARN via the `AttributeGroup.fromAttributeGroupArn()` API:\n\n```ts\nconst importedAttributeGroup = appreg.AttributeGroup.fromAttributeGroupArn(\n  this,\n  'MyImportedAttrGroup',\n  'arn:aws:servicecatalog:us-east-1:012345678910:/attribute-groups/0aqmvxvgmry0ecc4mjhwypun6i',\n);\n```\n\n## Associations\n\nYou can associate your appregistry application with attribute groups and resources.\nResources are CloudFormation stacks that you can associate with an application to group relevant\nstacks together to enable metadata rich insights into your applications and resources.\nA Cloudformation stack can only be associated with one appregistry application.\nIf a stack is associated with multiple applications in your app or is already associated with one,\nCDK will fail at deploy time.\n\n### Associating application with an attribute group\n\nYou can associate an attribute group with an application with the `associateAttributeGroup()` API:\n\n```ts\ndeclare const application: appreg.Application;\ndeclare const attributeGroup: appreg.AttributeGroup;\napplication.associateAttributeGroup(attributeGroup);\n```\n\n### Associating application with a Stack\n\nYou can associate a stack with an application with the `associateStack()` API:\n\n```ts\nconst app = new App();\nconst myStack = new Stack(app, 'MyStack');\n\ndeclare const application: appreg.Application;\napplication.associateStack(myStack);\n```\n\n## Sharing\n\nYou can share your AppRegistry applications and attribute groups with AWS Organizations, Organizational Units (OUs), AWS accounts within an organization, as well as IAM roles and users. AppRegistry requires that AWS Organizations is enabled in an account before deploying a share of an application or attribute group.\n\n### Sharing an application\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const application: appreg.Application;\ndeclare const myRole: iam.IRole;\ndeclare const myUser: iam.IUser;\napplication.shareApplication({\n  accounts: ['123456789012'],\n  organizationArns: ['arn:aws:organizations::123456789012:organization/o-my-org-id'],\n  roles: [myRole],\n  users: [myUser],\n});\n```\n\nE.g., sharing an application with multiple accounts and allowing the accounts to associate resources to the application.\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const application: appreg.Application;\napplication.shareApplication({\n  accounts: ['123456789012', '234567890123'],\n  sharePermission: appreg.SharePermission.ALLOW_ACCESS,\n});\n```\n\n### Sharing an attribute group\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const attributeGroup: appreg.AttributeGroup;\ndeclare const myRole: iam.IRole;\ndeclare const myUser: iam.IUser;\nattributeGroup.shareAttributeGroup({\n  accounts: ['123456789012'],\n  organizationArns: ['arn:aws:organizations::123456789012:organization/o-my-org-id'],\n  roles: [myRole],\n  users: [myUser],\n});\n```\n\nE.g., sharing an application with multiple accounts and allowing the accounts to associate applications to the attribute group.\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const attributeGroup: appreg.AttributeGroup;\nattributeGroup.shareAttributeGroup({\n  accounts: ['123456789012', '234567890123'],\n  sharePermission: appreg.SharePermission.ALLOW_ACCESS,\n});\n```\n"
+    "markdown": "# AWS ServiceCatalogAppRegistry Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\n[AWS Service Catalog App Registry](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/appregistry.html)\nenables organizations to create and manage repositores of applications and associated resources.\n\n## Table Of Contents\n\n- [Application](#application)\n- [Application-Associator](#application-associator)\n- [Attribute-Group](#attribute-group)\n- [Associations](#associations)\n  - [Associating application with an attribute group](#attribute-group-association)\n  - [Associating application with a stack](#resource-association)\n- [Sharing](#sharing)\n  - [Sharing an application](#sharing-an-application)\n  - [Sharing an attribute group](#sharing-an-attribute-group)\n\nThe `@aws-cdk/aws-servicecatalogappregistry` package contains resources that enable users to automate governance and management of their AWS resources at scale.\n\n```ts nofixture\nimport * as appreg from '@aws-cdk/aws-servicecatalogappregistry-alpha';\n```\n\n## Application\n\nAn AppRegistry application enables you to define your applications and associated resources.\nThe application name must be unique at the account level and it's immutable.\n\n```ts\nconst application = new appreg.Application(this, 'MyFirstApplication', {\n  applicationName: 'MyFirstApplicationName',\n  description: 'description for my application', // the description is optional\n});\n```\n\nAn application that has been created outside of the stack can be imported into your CDK app.\nApplications can be imported by their ARN via the `Application.fromApplicationArn()` API:\n\n```ts\nconst importedApplication = appreg.Application.fromApplicationArn(\n  this,\n  'MyImportedApplication',\n  'arn:aws:servicecatalog:us-east-1:012345678910:/applications/0aqmvxvgmry0ecc4mjhwypun6i',\n);\n```\n\n## Application-Associator\n\nIf you want to create an Application named `MyAssociatedApplication` in account `123456789012` and region `us-east-1`\nand want to associate all stacks in the `App` scope to `MyAssociatedApplication`, then use as shown in the example below:\n\n```ts\nconst app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n    applicationName: 'MyAssociatedApplication',\n    description: 'Testing associated application',\n    stackProps: {\n        stackName: 'MyAssociatedApplicationStack',\n        env: {account: '123456789012', region: 'us-east-1'},\n    },\n});\n```\n\nIf you want to re-use an existing Application with ARN: `arn:aws:servicecatalog:us-east-1:123456789012:/applications/applicationId`\nand want to associate all stacks in the `App` scope to your imported application, then use as shown in the example below:\n\n```ts\nconst app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n    applicationArnValue: 'arn:aws:servicecatalog:us-east-1:123456789012:/applications/applicationId',\n    stackProps: {\n        stackName: 'MyAssociatedApplicationStack',\n    },\n});\n```\n\nIf you are using CDK Pipelines to deploy your application, the application stacks will be inside Stages, and\nApplicationAssociator will not be able to find them. Call `associateStage` on each Stage object before adding it to the\nPipeline, as shown in the example below:\n\n```ts\nimport * as cdk from \"aws-cdk-lib\";\nimport * as codepipeline from \"aws-cdk-lib/pipelines\";\nimport * as codecommit from \"aws-cdk-lib/aws-codecommit\";\ndeclare const repo: codecommit.Repository;\ndeclare const pipeline: codepipeline.CodePipeline;\ndeclare const beta: cdk.Stage;\nclass ApplicationPipelineStack extends cdk.Stack {\n  constructor(scope: cdk.App, id: string, props: ApplicationPipelineStackProps) {\n    super(scope, id, props);\n\n   //associate the stage to application associator.\n   props.application.associateStage(beta);\n   pipeline.addStage(beta);\n  }\n};\n\ninterface ApplicationPipelineStackProps extends cdk.StackProps {\n  application: appreg.ApplicationAssociator;\n};\n\nconst app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n    applicationName: 'MyPipelineAssociatedApplication',\n    description: 'Testing pipeline associated app',\n    stackProps: {\n        stackName: 'MyPipelineAssociatedApplicationStack',\n        env: {account: '123456789012', region: 'us-east-1'},\n    },\n});\n\nconst cdkPipeline = new ApplicationPipelineStack(app, 'CDKApplicationPipelineStack', {\n    application: associatedApp,\n    env: {account: '123456789012', region: 'us-east-1'},\n});\n```\n\n## Attribute Group\n\nAn AppRegistry attribute group acts as a container for user-defined attributes for an application.\nMetadata is attached in a machine-readble format to integrate with automated workflows and tools.\n\n```ts\nconst attributeGroup = new appreg.AttributeGroup(this, 'MyFirstAttributeGroup', {\n  attributeGroupName: 'MyFirstAttributeGroupName',\n  description: 'description for my attribute group', // the description is optional,\n  attributes: {\n    project: 'foo',\n    team: ['member1', 'member2', 'member3'],\n    public: false,\n    stages: {\n      alpha: 'complete',\n      beta: 'incomplete',\n      release: 'not started'\n    }\n  }\n});\n```\n\nAn attribute group that has been created outside of the stack can be imported into your CDK app.\nAttribute groups can be imported by their ARN via the `AttributeGroup.fromAttributeGroupArn()` API:\n\n```ts\nconst importedAttributeGroup = appreg.AttributeGroup.fromAttributeGroupArn(\n  this,\n  'MyImportedAttrGroup',\n  'arn:aws:servicecatalog:us-east-1:012345678910:/attribute-groups/0aqmvxvgmry0ecc4mjhwypun6i',\n);\n```\n\n## Associations\n\nYou can associate your appregistry application with attribute groups and resources.\nResources are CloudFormation stacks that you can associate with an application to group relevant\nstacks together to enable metadata rich insights into your applications and resources.\nA Cloudformation stack can only be associated with one appregistry application.\nIf a stack is associated with multiple applications in your app or is already associated with one,\nCDK will fail at deploy time.\n\n### Associating application with an attribute group\n\nYou can associate an attribute group with an application with the `associateAttributeGroup()` API:\n\n```ts\ndeclare const application: appreg.Application;\ndeclare const attributeGroup: appreg.AttributeGroup;\napplication.associateAttributeGroup(attributeGroup);\n```\n\n### Associating application with a Stack\n\nYou can associate a stack with an application with the `associateStack()` API:\n\n```ts\nconst app = new App();\nconst myStack = new Stack(app, 'MyStack');\n\ndeclare const application: appreg.Application;\napplication.associateStack(myStack);\n```\n\n## Sharing\n\nYou can share your AppRegistry applications and attribute groups with AWS Organizations, Organizational Units (OUs), AWS accounts within an organization, as well as IAM roles and users. AppRegistry requires that AWS Organizations is enabled in an account before deploying a share of an application or attribute group.\n\n### Sharing an application\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const application: appreg.Application;\ndeclare const myRole: iam.IRole;\ndeclare const myUser: iam.IUser;\napplication.shareApplication({\n  accounts: ['123456789012'],\n  organizationArns: ['arn:aws:organizations::123456789012:organization/o-my-org-id'],\n  roles: [myRole],\n  users: [myUser],\n});\n```\n\nE.g., sharing an application with multiple accounts and allowing the accounts to associate resources to the application.\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const application: appreg.Application;\napplication.shareApplication({\n  accounts: ['123456789012', '234567890123'],\n  sharePermission: appreg.SharePermission.ALLOW_ACCESS,\n});\n```\n\n### Sharing an attribute group\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const attributeGroup: appreg.AttributeGroup;\ndeclare const myRole: iam.IRole;\ndeclare const myUser: iam.IUser;\nattributeGroup.shareAttributeGroup({\n  accounts: ['123456789012'],\n  organizationArns: ['arn:aws:organizations::123456789012:organization/o-my-org-id'],\n  roles: [myRole],\n  users: [myUser],\n});\n```\n\nE.g., sharing an application with multiple accounts and allowing the accounts to associate applications to the attribute group.\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const attributeGroup: appreg.AttributeGroup;\nattributeGroup.shareAttributeGroup({\n  accounts: ['123456789012', '234567890123'],\n  sharePermission: appreg.SharePermission.ALLOW_ACCESS,\n});\n```\n"
   },
   "repository": {
     "directory": "packages/individual-packages/aws-servicecatalogappregistry",
@@ -3143,7 +3182,7 @@
         },
         "locationInModule": {
           "filename": "lib/application.ts",
-          "line": 181
+          "line": 259
         },
         "parameters": [
           {
@@ -3172,7 +3211,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/application.ts",
-        "line": 147
+        "line": 223
       },
       "methods": [
         {
@@ -3182,7 +3221,7 @@
           },
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 155
+            "line": 231
           },
           "name": "fromApplicationArn",
           "parameters": [
@@ -3221,6 +3260,48 @@
           },
           "static": true
         },
+        {
+          "docs": {
+            "remarks": "NOTE: This method won't automatically register stacks under pipeline stages,\nand requires association of each pipeline stage by calling this method with stage Construct.",
+            "stability": "experimental",
+            "summary": "Associate all stacks present in construct's aspect with application."
+          },
+          "locationInModule": {
+            "filename": "lib/application.ts",
+            "line": 180
+          },
+          "name": "associateAllStacksInScope",
+          "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            }
+          ]
+        },
+        {
+          "docs": {
+            "remarks": "If the stack is already associated, it will ignore duplicate request.\nA stack can only be associated with one application.",
+            "stability": "experimental",
+            "summary": "Associate stack with the application in the stack passed as parameter."
+          },
+          "locationInModule": {
+            "filename": "lib/application.ts",
+            "line": 140
+          },
+          "name": "associateApplicationWithStack",
+          "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication",
+          "parameters": [
+            {
+              "name": "stack",
+              "type": {
+                "fqn": "aws-cdk-lib.Stack"
+              }
+            }
+          ]
+        },
         {
           "docs": {
             "stability": "experimental",
@@ -3228,7 +3309,7 @@
           },
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 77
+            "line": 104
           },
           "name": "associateAttributeGroup",
           "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication",
@@ -3243,13 +3324,14 @@
         },
         {
           "docs": {
+            "deprecated": "Use `associateApplicationWithStack` instead.",
             "remarks": "A stack can only be associated with one application.",
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "Associate a stack with the application If the resource is already associated, it will ignore duplicate request."
           },
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 93
+            "line": 122
           },
           "name": "associateStack",
           "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication",
@@ -3269,7 +3351,7 @@
           },
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 196
+            "line": 275
           },
           "name": "generateUniqueHash",
           "parameters": [
@@ -3295,7 +3377,7 @@
           },
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 111
+            "line": 161
           },
           "name": "shareApplication",
           "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication",
@@ -3322,7 +3404,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 177
+            "line": 254
           },
           "name": "applicationArn",
           "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication",
@@ -3338,17 +3420,243 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 178
+            "line": 255
           },
           "name": "applicationId",
           "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication",
           "type": {
             "primitive": "string"
           }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The name of the application."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/application.ts",
+            "line": 256
+          },
+          "name": "applicationName",
+          "optional": true,
+          "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication",
+          "type": {
+            "primitive": "string"
+          }
         }
       ],
       "symbolId": "lib/application:Application"
     },
+    "@aws-cdk/aws-servicecatalogappregistry-alpha.ApplicationAssociator": {
+      "assembly": "@aws-cdk/aws-servicecatalogappregistry-alpha",
+      "base": "constructs.Construct",
+      "docs": {
+        "remarks": "The application name must be unique at the account level and it's immutable.\nThis construct will automatically associate all stacks in the given scope, however\nin case of a `Pipeline` stack, stage underneath the pipeline will not automatically be associated and\nneeds to be associated separately.\n\nIf cross account stack is detected, then this construct will automatically share the application to consumer accounts.\nCross account feature will only work for non environment agnostic stacks.",
+        "stability": "experimental",
+        "summary": "An AppRegistry construct to automatically create an application with the given name and description.",
+        "example": "const app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n    applicationName: 'MyAssociatedApplication',\n    description: 'Testing associated application',\n    stackProps: {\n        stackName: 'MyAssociatedApplicationStack',\n        env: {account: '123456789012', region: 'us-east-1'},\n    },\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.ApplicationAssociator",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "lib/application-associator.ts",
+          "line": 56
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "aws-cdk-lib.App"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.ApplicationAssociatorProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "lib/application-associator.ts",
+        "line": 49
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Associate this application with the given stage."
+          },
+          "locationInModule": {
+            "filename": "lib/application-associator.ts",
+            "line": 79
+          },
+          "name": "associateStage",
+          "parameters": [
+            {
+              "name": "stage",
+              "type": {
+                "fqn": "aws-cdk-lib.Stage"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.Stage"
+            }
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Validates if a stage is already associated to the application."
+          },
+          "locationInModule": {
+            "filename": "lib/application-associator.ts",
+            "line": 89
+          },
+          "name": "isStageAssociated",
+          "parameters": [
+            {
+              "name": "stage",
+              "type": {
+                "fqn": "aws-cdk-lib.Stage"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "boolean"
+            }
+          }
+        }
+      ],
+      "name": "ApplicationAssociator",
+      "properties": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Get the AppRegistry application."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/application-associator.ts",
+            "line": 97
+          },
+          "name": "appRegistryApplication",
+          "type": {
+            "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication"
+          }
+        }
+      ],
+      "symbolId": "lib/application-associator:ApplicationAssociator"
+    },
+    "@aws-cdk/aws-servicecatalogappregistry-alpha.ApplicationAssociatorProps": {
+      "assembly": "@aws-cdk/aws-servicecatalogappregistry-alpha",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Properties for a Service Catalog AppRegistry AutoApplication.",
+        "example": "const app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n    applicationName: 'MyAssociatedApplication',\n    description: 'Testing associated application',\n    stackProps: {\n        stackName: 'MyAssociatedApplicationStack',\n        env: {account: '123456789012', region: 'us-east-1'},\n    },\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.ApplicationAssociatorProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/application-associator.ts",
+        "line": 9
+      },
+      "name": "ApplicationAssociatorProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Stack properties."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/application-associator.ts",
+            "line": 35
+          },
+          "name": "stackProps",
+          "type": {
+            "fqn": "aws-cdk-lib.StackProps"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- No application arn.",
+            "stability": "experimental",
+            "summary": "Enforces a particular application arn."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/application-associator.ts",
+            "line": 22
+          },
+          "name": "applicationArnValue",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- No name.",
+            "stability": "experimental",
+            "summary": "Enforces a particular physical application name."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/application-associator.ts",
+            "line": 15
+          },
+          "name": "applicationName",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- No description.",
+            "stability": "experimental",
+            "summary": "Application description."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/application-associator.ts",
+            "line": 29
+          },
+          "name": "description",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "lib/application-associator:ApplicationAssociatorProps"
+    },
     "@aws-cdk/aws-servicecatalogappregistry-alpha.ApplicationProps": {
       "assembly": "@aws-cdk/aws-servicecatalogappregistry-alpha",
       "datatype": true,
@@ -3364,7 +3672,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/application.ts",
-        "line": 54
+        "line": 80
       },
       "name": "ApplicationProps",
       "properties": [
@@ -3377,7 +3685,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 58
+            "line": 84
           },
           "name": "applicationName",
           "type": {
@@ -3394,7 +3702,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 64
+            "line": 90
           },
           "name": "description",
           "optional": true,
@@ -3675,18 +3983,65 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/application.ts",
-        "line": 16
+        "line": 18
       },
       "methods": [
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "NOTE: This method won't automatically register stacks under pipeline stages,\nand requires association of each pipeline stage by calling this method with stage Construct.",
+            "stability": "experimental",
+            "summary": "Associate this application with all stacks under the construct node."
+          },
+          "locationInModule": {
+            "filename": "lib/application.ts",
+            "line": 73
+          },
+          "name": "associateAllStacksInScope",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "cdk Construct."
+              },
+              "name": "construct",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            }
+          ]
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Associate a Cloudformation statck with the application in the given stack."
+          },
+          "locationInModule": {
+            "filename": "lib/application.ts",
+            "line": 57
+          },
+          "name": "associateApplicationWithStack",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "a CFN stack."
+              },
+              "name": "stack",
+              "type": {
+                "fqn": "aws-cdk-lib.Stack"
+              }
+            }
+          ]
+        },
         {
           "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "Associate thisapplication with an attribute group."
+            "summary": "Associate this application with an attribute group."
           },
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 34
+            "line": 42
           },
           "name": "associateAttributeGroup",
           "parameters": [
@@ -3704,12 +4059,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental",
+            "deprecated": "Use `associateApplicationWithStack` instead.",
+            "stability": "deprecated",
             "summary": "Associate this application with a CloudFormation stack."
           },
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 41
+            "line": 50
           },
           "name": "associateStack",
           "parameters": [
@@ -3732,7 +4088,7 @@
           },
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 48
+            "line": 64
           },
           "name": "shareApplication",
           "parameters": [
@@ -3762,7 +4118,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 21
+            "line": 23
           },
           "name": "applicationArn",
           "type": {
@@ -3781,12 +4137,32 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 27
+            "line": 29
           },
           "name": "applicationId",
           "type": {
             "primitive": "string"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "custom": {
+              "attribute": "true"
+            },
+            "stability": "experimental",
+            "summary": "The name of the application."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/application.ts",
+            "line": 35
+          },
+          "name": "applicationName",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
         }
       ],
       "symbolId": "lib/application:IApplication"
@@ -4051,6 +4427,6 @@
       "symbolId": "lib/common:SharePermission"
     }
   },
-  "version": "2.44.0-alpha.0",
+  "version": "2.45.0-alpha.0",
   "fingerprint": "**********"
 }

package/.warnings.jsii.js

@@ -10,6 +10,10 @@ function _aws_cdk_aws_servicecatalogappregistry_alpha_AttributeGroupProps(p) {
 }
 function _aws_cdk_aws_servicecatalogappregistry_alpha_AttributeGroup(p) {
 }
+function _aws_cdk_aws_servicecatalogappregistry_alpha_ApplicationAssociatorProps(p) {
+}
+function _aws_cdk_aws_servicecatalogappregistry_alpha_ApplicationAssociator(p) {
+}
 function _aws_cdk_aws_servicecatalogappregistry_alpha_SharePermission(p) {
 }
 function _aws_cdk_aws_servicecatalogappregistry_alpha_ShareOptions(p) {
@@ -62,4 +66,4 @@ class DeprecationError extends Error {
         });
     }
 }
-module.exports = { print, getPropertyDescriptor, DeprecationError, _aws_cdk_aws_servicecatalogappregistry_alpha_IApplication, _aws_cdk_aws_servicecatalogappregistry_alpha_ApplicationProps, _aws_cdk_aws_servicecatalogappregistry_alpha_Application, _aws_cdk_aws_servicecatalogappregistry_alpha_IAttributeGroup, _aws_cdk_aws_servicecatalogappregistry_alpha_AttributeGroupProps, _aws_cdk_aws_servicecatalogappregistry_alpha_AttributeGroup, _aws_cdk_aws_servicecatalogappregistry_alpha_SharePermission, _aws_cdk_aws_servicecatalogappregistry_alpha_ShareOptions };
+module.exports = { print, getPropertyDescriptor, DeprecationError, _aws_cdk_aws_servicecatalogappregistry_alpha_IApplication, _aws_cdk_aws_servicecatalogappregistry_alpha_ApplicationProps, _aws_cdk_aws_servicecatalogappregistry_alpha_Application, _aws_cdk_aws_servicecatalogappregistry_alpha_IAttributeGroup, _aws_cdk_aws_servicecatalogappregistry_alpha_AttributeGroupProps, _aws_cdk_aws_servicecatalogappregistry_alpha_AttributeGroup, _aws_cdk_aws_servicecatalogappregistry_alpha_ApplicationAssociatorProps, _aws_cdk_aws_servicecatalogappregistry_alpha_ApplicationAssociator, _aws_cdk_aws_servicecatalogappregistry_alpha_SharePermission, _aws_cdk_aws_servicecatalogappregistry_alpha_ShareOptions };