@aws-amplify/graphql-transformer-interfaces 3.12.1 → 3.12.2-gen1-schema-logicalid-fix-v2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/API.md +1 -0
  2. package/CHANGELOG.md +6 -0
  3. package/lib/transformer-context/transform-parameters.d.ts +1 -0
  4. package/lib/transformer-context/transform-parameters.d.ts.map +1 -1
  5. package/package.json +2 -2
  6. package/src/transformer-context/transform-parameters.ts +17 -0
  7. package/tsconfig.tsbuildinfo +1 -1
package/API.md CHANGED
@@ -926,6 +926,7 @@ export type TransformParameters = {
926
926
  respectPrimaryKeyAttributesOnConnectionField: boolean;
927
927
  enableSearchNodeToNodeEncryption: boolean;
928
928
  enableGen2Migration?: boolean;
929
+ preserveGraphQLSchemaLogicalId?: boolean;
929
930
  };
930
931
 
931
932
  // @public (undocumented)
package/CHANGELOG.md CHANGED
@@ -3,6 +3,12 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ ## [3.12.2-gen1-schema-logicalid-fix-v2.0](https://github.com/aws-amplify/amplify-category-api/compare/@aws-amplify/graphql-transformer-interfaces@3.12.1...@aws-amplify/graphql-transformer-interfaces@3.12.2-gen1-schema-logicalid-fix-v2.0) (2026-09-23)
7
+
8
+ ### Bug Fixes
9
+
10
+ - **graphql:** preserve GraphQLSchema logical id on Gen1 v1->v2 migration ([f079c63](https://github.com/aws-amplify/amplify-category-api/commit/f079c6359ba5e04d6bf814c3621c9333cd24e16c))
11
+
6
12
  ## [3.12.1](https://github.com/aws-amplify/amplify-category-api/compare/@aws-amplify/graphql-transformer-interfaces@3.12.0...@aws-amplify/graphql-transformer-interfaces@3.12.1) (2025-09-25)
7
13
 
8
14
  **Note:** Version bump only for package @aws-amplify/graphql-transformer-interfaces
package/lib/transformer-context/transform-parameters.d.ts CHANGED
@@ -15,5 +15,6 @@ export type TransformParameters = {
15
15
  respectPrimaryKeyAttributesOnConnectionField: boolean;
16
16
  enableSearchNodeToNodeEncryption: boolean;
17
17
  enableGen2Migration?: boolean;
18
+ preserveGraphQLSchemaLogicalId?: boolean;
18
19
  };
19
20
  //# sourceMappingURL=transform-parameters.d.ts.map
package/lib/transformer-context/transform-parameters.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"transform-parameters.d.ts","sourceRoot":"","sources":["../../src/transformer-context/transform-parameters.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,mBAAmB,GAAG;IAEhC,2BAA2B,EAAE,OAAO,CAAC;IAGrC,sCAAsC,EAAE,OAAO,CAAC;IAChD,uBAAuB,EAAE,OAAO,CAAC;IACjC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oCAAoC,EAAE,OAAO,CAAC;IAC9C,yBAAyB,EAAE,OAAO,CAAC;IACnC,iBAAiB,EAAE,OAAO,CAAC;IAG3B,qCAAqC,EAAE,OAAO,CAAC;IAC/C,oCAAoC,EAAE,OAAO,CAAC;IAC9C,wBAAwB,EAAE,OAAO,CAAC;IAClC,+BAA+B,EAAE,OAAO,CAAC;IAGzC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,yBAAyB,EAAE,OAAO,CAAC;IAGnC,4CAA4C,EAAE,OAAO,CAAC;IAGtD,gCAAgC,EAAE,OAAO,CAAC;IAG1C,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC"}
1
+ {"version":3,"file":"transform-parameters.d.ts","sourceRoot":"","sources":["../../src/transformer-context/transform-parameters.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,mBAAmB,GAAG;IAEhC,2BAA2B,EAAE,OAAO,CAAC;IAGrC,sCAAsC,EAAE,OAAO,CAAC;IAChD,uBAAuB,EAAE,OAAO,CAAC;IACjC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oCAAoC,EAAE,OAAO,CAAC;IAC9C,yBAAyB,EAAE,OAAO,CAAC;IACnC,iBAAiB,EAAE,OAAO,CAAC;IAG3B,qCAAqC,EAAE,OAAO,CAAC;IAC/C,oCAAoC,EAAE,OAAO,CAAC;IAC9C,wBAAwB,EAAE,OAAO,CAAC;IAClC,+BAA+B,EAAE,OAAO,CAAC;IAGzC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,yBAAyB,EAAE,OAAO,CAAC;IAGnC,4CAA4C,EAAE,OAAO,CAAC;IAGtD,gCAAgC,EAAE,OAAO,CAAC;IAG1C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAiB9B,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aws-amplify/graphql-transformer-interfaces",
3
- "version": "3.12.1",
3
+ "version": "3.12.2-gen1-schema-logicalid-fix-v2.0",
4
4
  "description": "Amplify GraphQL transformer interface definitions",
5
5
  "repository": {
6
6
  "type": "git",
@@ -60,5 +60,5 @@
60
60
  "/__tests__/"
61
61
  ]
62
62
  },
63
- "gitHead": "362e4948c1da14da92635fc4beea1463b0b5b9b9"
63
+ "gitHead": "8bd58a1063a83006d4d46830be19d598e44d212f"
64
64
  }
package/src/transformer-context/transform-parameters.ts CHANGED
@@ -34,4 +34,21 @@ export type TransformParameters = {
34
34
 
35
35
  // Migration
36
36
  enableGen2Migration?: boolean;
37
+
38
+ /**
39
+ * When migrating a Gen1 API from GraphQL Transformer v1 to v2, preserve the schema resource's
40
+ * CloudFormation logical ID as the v1 value (`GraphQLSchema`) instead of the v2 CDK-generated
41
+ * `GraphQLAPITransformerSchema<hash>`.
42
+ *
43
+ * The AppSync schema physical ID is deterministic (`<apiId>GraphQLSchema`, one schema per API).
44
+ * A v1->v2 logical-ID rename therefore makes CloudFormation attempt a create-before-delete in
45
+ * which the new and old resources resolve to the same physical ID, failing with
46
+ * `<apiId>GraphQLSchema already exists in stack`. Pinning the logical ID keeps the migration an
47
+ * in-place update. This MUST only be set for the v1->v2 migration of an API whose deployed
48
+ * template still carries the schema at logical ID `GraphQLSchema`; setting it for a born-v2 API
49
+ * would itself rename the logical ID and trigger the same collision.
50
+ *
51
+ * @default false
52
+ */
53
+ preserveGraphQLSchemaLogicalId?: boolean;
37
54
  };