programmatic generate client config starter

.eslintrc.json

@@ -16,9 +16,11 @@
     "sourceType": "module",
     "project": ["tsconfig.eslint.json"]
   },
-  "plugins": ["@typescript-eslint", "unicorn", "jsdoc"],
+  "plugins": ["@typescript-eslint", "unicorn", "jsdoc", "import"],
   "rules": {
     "@typescript-eslint/switch-exhaustiveness-check": "error",
+    "no-duplicate-imports": "error",
+    "import/no-extraneous-dependencies": "error",
     "unicorn/filename-case": [
       "error",
       {

package.json

@@ -48,6 +48,7 @@
     "eslint": "^8.38.0",
     "eslint-config-prettier": "^8.8.0",
     "eslint-config-xo-typescript": "^0.57.0",
+    "eslint-plugin-import": "^2.27.5",
     "eslint-plugin-jsdoc": "^43.0.6",
     "eslint-plugin-unicorn": "^46.0.0",
     "execa": "^7.1.1",

packages/backend-engine/API.md

@@ -4,6 +4,8 @@
 
 ```ts
 
+import { AwsCredentialIdentityProvider } from '@aws-sdk/types';
+import { BackendIdentifier } from '@aws-amplify/plugin-types';
 import { CfnElement } from 'aws-cdk-lib';
 import { Construct } from 'constructs';
 import { ConstructCache } from '@aws-amplify/plugin-types';
@@ -13,29 +15,18 @@ import { Stack } from 'aws-cdk-lib';
 
 // @public
 export class AmplifyStack extends Stack {
-    constructor(scope: Construct, id: string, props: AmplifyStackProps);
     allocateLogicalId(element: CfnElement): string;
-    readonly projectEnvironmentIdentifier: ProjectEnvironmentIdentifier;
 }
 
 // @public
-export type AmplifyStackProps = {
-    readonly projectEnvironmentIdentifier: ProjectEnvironmentIdentifier;
-};
+export const generateClientConfig: (credentialProvider: AwsCredentialIdentityProvider, backendIdentifier: BackendIdentifier) => Promise<void>;
 
 // @public
 export class NestedStackResolver implements StackResolver {
     constructor(rootStack: Stack);
     getStackFor(resourceGroupName: string): Stack;
 }
 
-// @public
-export class ProjectEnvironmentIdentifier {
-    constructor(projectName: string, environmentName: string);
-    toOutputStackSSMParameterName(): string;
-    toStackName(): string;
-}
-
 // @public
 export class SingletonConstructCache implements ConstructCache {
     constructor(stackResolver: StackResolver);
@@ -45,6 +36,7 @@ export class SingletonConstructCache implements ConstructCache {
 // @public
 export class StackMetadataOutputStorageStrategy implements OutputStorageStrategy {
     constructor(stack: Stack);
+    flush(): void;
     storeOutput(constructPackage: string, constructVersion: string, data: Record<string, string>): void;
 }
 

packages/backend-engine/package.json

@@ -7,12 +7,19 @@
   "scripts": {
     "api:update": "api-extractor run --local"
   },
+  "dependencies": {
+    "zod": "^3.21.4"
+  },
   "devDependencies": {
     "@aws-amplify/plugin-types": "^0.1.0",
+    "@aws-sdk/credential-providers": "^3.352.0",
+    "@aws-sdk/types": "^3.347.0",
     "aws-cdk-lib": "^2.72.0",
     "constructs": "^10.0.0"
   },
   "peerDependencies": {
+    "@aws-sdk/client-cloudformation": "^3.352.0",
+    "@aws-sdk/client-ssm": "^3.352.0",
     "aws-cdk-lib": "^2.72.0",
     "constructs": "^10.0.0"
   },

packages/backend-engine/src/amplify_stack.test.ts

@@ -3,17 +3,11 @@ import { App, NestedStack } from 'aws-cdk-lib';
 import { AmplifyStack } from './amplify_stack.js';
 import { Template } from 'aws-cdk-lib/assertions';
 import assert from 'node:assert';
-import { ProjectEnvironmentIdentifier } from './project_environment_identifier.js';
 
 describe('AmplifyStack', () => {
   it('renames nested stack logical IDs to non-redundant value', () => {
     const app = new App();
-    const rootStack = new AmplifyStack(app, 'test-id', {
-      projectEnvironmentIdentifier: new ProjectEnvironmentIdentifier(
-        'testProjName',
-        'testEnvName'
-      ),
-    });
+    const rootStack = new AmplifyStack(app, 'test-id');
     new NestedStack(rootStack, 'testName');
 
     const rootStackTemplate = Template.fromStack(rootStack);
@@ -25,15 +19,4 @@ describe('AmplifyStack', () => {
     assert.ok(actualStackLogicalId.startsWith('testName'));
     assert.ok(!actualStackLogicalId.includes('NestedStack'));
   });
-
-  it('names the stack based on the project and environment name', () => {
-    const app = new App();
-    const stack = new AmplifyStack(app, 'test-id', {
-      projectEnvironmentIdentifier: new ProjectEnvironmentIdentifier(
-        'testProjName',
-        'testEnvName'
-      ),
-    });
-    assert.equal(stack.stackName, 'testProjName-testEnvName');
-  });
 });

packages/backend-engine/src/amplify_stack.ts

@@ -1,32 +1,9 @@
 import { CfnElement, Stack } from 'aws-cdk-lib';
-import { Construct } from 'constructs';
-import { ProjectEnvironmentIdentifier } from './project_environment_identifier.js';
-
-/**
- * Properties to initialize an AmplifyStack
- */
-export type AmplifyStackProps = {
-  readonly projectEnvironmentIdentifier: ProjectEnvironmentIdentifier;
-};
 
 /**
  * Amplify-specific Stack implementation to handle cross-cutting concerns for all Amplify stacks
  */
 export class AmplifyStack extends Stack {
-  /**
-   * Identifier for the project environment this stack exists in
-   */
-  readonly projectEnvironmentIdentifier: ProjectEnvironmentIdentifier;
-
-  /**
-   * Initializes the stack with a name that is unique to the provided Amplify environment
-   */
-  constructor(scope: Construct, id: string, props: AmplifyStackProps) {
-    super(scope, id, {
-      stackName: props.projectEnvironmentIdentifier.toStackName(),
-    });
-    this.projectEnvironmentIdentifier = props.projectEnvironmentIdentifier;
-  }
   /**
    * Overrides Stack.allocateLogicalId to prevent redundant nested stack logical IDs
    */

packages/backend-engine/src/backend-output/amplify_stack_metadata_key.ts

@@ -0,0 +1 @@
+export const amplifyStackMetadataKey = 'AWS::Amplify::Output';

packages/backend-engine/src/backend-output/backend_output_schemas.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+
+/**
+ * Schema for a single block of output written by a construct
+ */
+export const backendOutputEntrySchema = z.object({
+  constructVersion: z.string(),
+  stackOutputs: z.array(z.string()),
+});
+
+/**
+ * Inferred type from outputEntrySchema
+ */
+export type BackendOutputEntry = z.infer<typeof backendOutputEntrySchema>;
+
+/**
+ * Schema for the record of all output written by all constructs
+ * The keys of the record are the package names of the constructs
+ */
+export const backendOutputSchema = z.record(backendOutputEntrySchema);
+
+/**
+ * Inferred type from backendOutputSchema
+ */
+export type BackendOutput = z.infer<typeof backendOutputSchema>;