Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@aws-amplify/graphql-relational-transformer

aws-amplify304.9kApache-2.03.1.11TypeScript support: included

Amplify GraphQL relational modeling transformers

graphql, cloudformation, aws, amplify, transformer

readme

changelog

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

3.1.11 (2025-06-09)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.1.10 (2025-04-17)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.1.9 (2025-04-09)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.1.8 (2025-03-06)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.1.7 (2025-02-26)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.1.6 (2025-02-07)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.1.5 (2025-01-30)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.1.4 (2025-01-16)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.1.3 (2024-12-23)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.1.2 (2024-12-17)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.1.1 (2024-11-14)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.1.0 (2024-11-08)

Features

  • add imported DDB tables for gen 2 migration in experimental state (#2992) (0c415b3)

3.0.7 (2024-10-28)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.0.6 (2024-10-17)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.0.5 (2024-10-10)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.0.4 (2024-10-01)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.0.3 (2024-09-16)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.0.2 (2024-09-06)

Bug Fixes

  • don't print deprecation warning when pattern is not used (#2816) (4c5fc2a)

3.0.1 (2024-08-28)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

3.0.0 (2024-08-20)

Bug Fixes

  • change gen 1 patterns to warning message instead of error (#2768) (97b1f36)

  • feat!: bump version for v2 transformer packages (7dac35c)

BREAKING CHANGES

  • distinguish from LTS version

2.5.11 (2024-08-12)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.5.10 (2024-07-25)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.5.9 (2024-07-15)

Bug Fixes

  • add nonScalarFields and arrayFields to schemas with mapped names (#2689) (4feb898), closes #2581
  • add translation behavior to disable gen 1 patterns (#2670) (38d1a71)

2.5.8 (2024-07-02)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.5.7 (2024-07-01)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.5.6 (2024-06-25)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.5.5 (2024-06-06)

Bug Fixes

  • fix selection sets for SQL models with optional dependencies (#2587) (f6b68d9)

2.5.4 (2024-06-04)

Bug Fixes

  • redact relational field in mutation & subscription based on model auth rules (#2536) (f72f40e)

2.5.3 (2024-05-15)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.5.2 (2024-05-10)

Bug Fixes

  • fix reference-style relationship validation (#2533) (7b3cf0e)

2.5.1 (2024-05-01)

Bug Fixes

  • graphql-relational-transformer: nullability enforcement for references relational fields (#2510) (d540097)

2.5.0 (2024-04-26)

Bug Fixes

  • add non-scalar and array fields to SQL relations (#2501) (511f020)
  • auto generated id when timestamps: null (#2470) (936a4f9)
  • ddb references hasOne returns record if multiple exist (#2497) (c105138)
  • graphql-relational-transformer: ddb references relationships with composite sortkeys (#2425) (0c45218)
  • hasMany belongsTo dynamodb references composite primary key (#2471) (6f49747)
  • propagate operation in references-style ddb resolver (#2447) (460cf21)
  • relational bidirectionality validation and improved error messages (#2482) (568fbc3)

Features

  • graphql-relational-transformer: DDB references relational directives support (tagged-release.0) (#2370) (bdaaabf)

2.4.4 (2024-04-16)

Bug Fixes

  • api: protect sql relational fields when using owner rule (#2463) (53cabe2)

2.4.3 (2024-04-11)

Bug Fixes

  • propagate mutation context to relational fields (#2416) (fd7f6fb)

2.4.2 (2024-03-28)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.4.1 (2024-03-13)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.4.0 (2024-02-28)

Features

2.3.6 (2024-02-05)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.3.5 (2024-01-30)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.3.4 (2024-01-22)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.3.3 (2023-12-21)

Bug Fixes

  • Fix manyToMany relationships with Amplify managed table strategies (#2151) (2dccaa6)

2.3.2 (2023-12-18)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.3.1 (2023-12-14)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.3.0 (2023-12-06)

Features

2.2.3 (2023-11-22)

Bug Fixes

  • Allow custom SQL statements without model declarations (#2087) (ea5b26c)

2.2.2 (2023-11-18)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.2.1 (2023-11-16)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.2.0 (2023-11-15)

Bug Fixes

  • Change 'rds' to 'sql' in public-facing symbols (#2069) (ff374dd)

Features

2.1.8 (2023-11-02)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.1.7 (2023-10-12)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.1.6 (2023-10-05)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.1.5 (2023-10-02)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.1.4 (2023-09-20)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.1.3 (2023-09-07)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.1.2 (2023-08-30)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.1.1 (2023-08-28)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

2.1.0 (2023-08-09)

Features

  • bump major version of transformer packages (2458c84)

1.2.9 (2023-07-21)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

1.2.8 (2023-07-17)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

1.2.7 (2023-07-07)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

1.2.6 (2023-07-07)

Bug Fixes

1.2.5 (2023-07-07)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

1.2.4 (2023-06-29)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

1.2.3 (2023-06-20)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

1.2.2 (2023-06-05)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

1.2.1 (2023-05-23)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

1.2.0 (2023-05-17)

Bug Fixes

  • auth: ownerfield as pk in relational models (#1389) (20a38bd)

Features

  • datastore-filters: add filters for DataStore _deleted property (9812083)

1.1.3 (2023-04-25)

Bug Fixes

  • auth: ownerfield as pk in relational models (#1389) (9b636f7)

1.1.2 (2023-03-30)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

1.1.1 (2023-03-15)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

1.1.0 (2023-03-01)

Bug Fixes

Features

  • migrate auth, maps-to, relational, default value transformer to CDK v2 (#875) (5c714a9)

1.1.0-beta.6 (2023-02-21)

Bug Fixes

Features

  • migrate auth, maps-to, relational, default value transformer to CDK v2 (#875) (5c714a9)

1.1.0-beta.5 (2023-02-15)

Bug Fixes

Features

  • migrate auth, maps-to, relational, default value transformer to CDK v2 (#875) (5c714a9)

1.1.0-beta.4 (2023-02-03)

Bug Fixes

Features

  • migrate auth, maps-to, relational, default value transformer to CDK v2 (#875) (5c714a9)

1.1.0-beta.3 (2022-12-27)

Bug Fixes

Features

  • migrate auth, maps-to, relational, default value transformer to CDK v2 (#875) (5c714a9)

1.1.0-beta.2 (2022-12-12)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

1.1.0-beta.1 (2022-11-30)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

1.1.0-beta.0 (2022-11-18)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

1.1.0-cdkv2.3 (2022-11-15)

Bug Fixes

Features

  • migrate auth, maps-to, relational, default value transformer to CDK v2 (#875) (5c714a9)

1.1.0-cdkv2.2 (2022-11-03)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

1.1.0-cdkv2.1 (2022-10-24)

Bug Fixes

1.1.0-cdkv2.0 (2022-10-24)

Features

  • migrate auth, maps-to, relational, default value transformer to CDK v2 (#875) (5c714a9)

0.12.11 (2023-02-27)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.12.10 (2023-02-10)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.12.9 (2023-01-26)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.12.8 (2023-01-12)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.12.7 (2023-01-12)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.12.6 (2022-12-13)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.12.5 (2022-12-03)

Bug Fixes

  • relation-transformer: relation field nullability in object and input type (43b7ae3)
  • remove default false (c48a885)
  • revert the change for belongsTo in hasMany (05bb29c)

0.12.4 (2022-11-08)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.12.3 (2022-11-04)

Bug Fixes

  • graphql: protect relational fields when fields rules are restrictive (4d3ad19)

0.12.2 (2022-10-26)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.12.1 (2022-10-24)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.12.0 (2022-10-04)

Bug Fixes

  • relation-transformer: belongsTo resolves to correct connected fields (c0d92c7)

Features

0.11.9 (2022-09-20)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.11.8 (2022-09-14)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.11.7 (2022-08-23)

Reverts

  • Revert "Undo change to directive merge that broke tests" (#756) (3da2ce6), closes #756

0.11.6 (2022-08-18)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.11.5 (2022-08-16)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.11.4 (2022-08-04)

Bug Fixes

  • graphql: revert subscriptions server-side filtering (20cffc0)

0.11.3 (2022-07-26)

Bug Fixes

  • graphql: incorrect filter expression on model transformer (#697) (a6fc3be)

0.11.2 (2022-07-20)

Bug Fixes

  • use PK name in many to many link object (a7a8692)

0.11.1 (2022-07-14)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.11.0 (2022-07-01)

Features

  • graphql: add runtime filtering support for subscriptions (#551) (0a24bb0)

0.10.1 (2022-06-23)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.10.0 (2022-06-13)

Features

  • add error when using an owner field as a sort key field (#517) (201032d)

0.9.4 (2022-06-10)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.9.3 (2022-06-07)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.9.2 (2022-05-31)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.9.1 (2022-05-02)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.9.0 (2022-04-29)

Features

  • use sub:username identity claim by default when persisting behind a feature flag (#10196) (947aae6)

0.8.1 (2022-04-27)

8.0.3 (2022-04-25)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.8.0 (2022-04-18)

Bug Fixes

  • graphql-model-transformer: fix create mutation when index field is null (#10073) (1e9d140)
  • graphql-model-transformer: fix enum filter input when queries are set to null (#10044) (53bef2e)

Features

  • add handling of colon-delimited identity claims to query (#10189) (d7983f4)

Reverts

  • Revert "feat: add handling of colon-delimited identity claims to query (#10189)" (#10213) (9f13064), closes #10189 #10213

0.7.11 (2022-04-07)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.7.10 (2022-03-23)

Bug Fixes

  • graphql: avoid static datastructures in gql transform (#10006) (cd73fdd)
  • graphql: include sort key(s) in many to many directive relation model (#9580) (93ebf35)

0.7.9 (2022-03-17)

Bug Fixes

  • amplify-category-auth: expand @auth directive to explicit set of allowed operations (#9859) (e44ed18)

0.7.8 (2022-03-07)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.7.7 (2022-02-25)

7.6.22 (2022-02-24)

Bug Fixes

  • graphql-auth-transformer: fix relational map key schema lookup when using LSI (#9722) (1794cda)
  • graphql-auth-transformer: update resolver should allow if update operation is set (#9808) (44a9bea)
  • graphql: hasMany on model with (queries: null) generate correct scalar filter type (#9742) (d75546c)
  • include default values in index arg validation (#9759) (e135e42)

0.7.6 (2022-02-15)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.7.5 (2022-02-10)

7.6.19 (2022-02-08)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.7.1 (2022-02-03)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.7.0 (2022-01-31)

7.6.14 (2022-01-28)

Features

  • [@maps](https://github.com/maps)To directive to enable renaming models while retaining data (#9340) (aedf45d)

0.6.20 (2022-01-27)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.6.19 (2022-01-23)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.6.18 (2022-01-20)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.6.17 (2022-01-20)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.6.16 (2022-01-13)

Bug Fixes

  • clean up missing and unused GraphQL v2 dependencies (#9486) (a6ca44e)
  • graphql: modify fields match logic for hasOne directive when using auth directive (#9459) (a924892)
  • use StackMapping for V2 resolvers (#9238) (d354e78)

0.6.15 (2022-01-10)

7.6.7 (2022-01-10)

Bug Fixes

  • graphql: correct typo filterExpression on v2 resolvers (#9412) (71bf468)

0.6.13 (2021-12-21)

7.6.5 (2021-12-20)

Bug Fixes

0.6.12 (2021-12-17)

Bug Fixes

0.6.11 (2021-12-03)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.6.10 (2021-12-01)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.6.9 (2021-11-29)

7.5.4 (2021-11-28)

Bug Fixes

0.6.8 (2021-11-26)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.6.7 (2021-11-23)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.6.6 (2021-11-21)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.6.5 (2021-11-20)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.6.4 (2021-11-19)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.6.3 (2021-11-19)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.6.2 (2021-11-17)

Bug Fixes

  • graphql-relational-transformer: fixes belongs to relation field name (#8865) (068b03b)
  • reintroduce connection stack in transformer v2 (#8757) (81ffeeb)

0.6.1 (2021-11-15)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.4.0 (2021-11-11)

Bug Fixes

  • @auth fix relational auth, authv2 e2e with utils and fixes (#8450) (aa320cd)
  • add @manytomany join table auth (#8460) (424bbda)
  • allow duplicate auth rules when creating the join type (#8680) (1a0636d)
  • graphql-model-transformer: override resource logical id to fix v1 to v2 transformer migration (#8597) (e3a2afb)
  • graphql-relational-schema-transformer: has-many transformer update filter/condition inputs (#8565) (9f5570b)
  • graphql-relational-transformer: fix belongs to e2e test (#8738) (233ed56)
  • graphql-relational-transformer: fix has many without fields (#8700) (cc21d4d)
  • graphql-relational-transformer: fixed has one and belongs to relationship (#8679) (8a390fb)
  • reuse foreign key field in [@belongs](https://github.com/belongs)To transformer (#8557) (39fbe6f)
  • use output when looking up relational related type index (#8657) (1f5dd5c)

Features

  • add admin roles which have admin control over a graphql api (#8601) (4d50df0)
  • generate list types as non-null (#8166) (93786c1)

0.3.1 (2021-10-10)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.3.0 (2021-09-27)

Features

0.2.1 (2021-09-14)

Note: Version bump only for package @aws-amplify/graphql-relational-transformer

0.2.0 (2021-09-02)

Features