10.5.0 (2025-10-30)
10.4.2 (2025-10-23)
10.4.1 (2025-10-14)
- deps: Update dependency @googleapis/iam to v33 (#2146) (bbee39e)
- deps: Update dependency @googleapis/iam to v34 (#2159) (0006ae2)
- deps: Update dependency dotenv to v17 (#2150) (5b2c7c5)
- deps: Update dependency gcp-metadata to v8 (#2158) (7e547d4)
- Disable linkinator until 429 issue is fixed. (#2138) (2f54532)
- Link to customCredentialSupplierOktaWorkload (#2149) (3cdef01)
10.4.0 (2025-09-30)
10.3.1 (2025-09-26)
10.3.0 (2025-08-25)
10.2.1 (2025-08-01)
- Pin nock and typescript dependencies to fix window.crypto.subtle.verify signature argument type (#2106) (afc3bc8)
10.2.0 (2025-07-18)
10.1.0 (2025-06-12)
fetch-Compatible API (#1939) (c63f608)- Normalize
GoogleAuth<T>fromJSONClienttoAuthClient(#1940) (440de51)
10.0.0 (2025-06-11)
RequestRevamp (#1938)- Remove
Transporter(#1937) - remove additionalOptions from AuthClients (#1689)
- Remove
options.ts(#1920) - Remove
messages.ts(#1919) - Support Node 18+ (#1879)
- Support Node 18, 20, and 22 (#1928)
- remove DEFAULT_UNIVERSE from BaseExternalClient (#1690)
- Move Base AuthClient Types to authclient.ts (#1774)
RequestRevamp (#1938) (f23e807)- Add debug logging support (#1903) (13ca1dc)
- Support Node 18, 20, and 22 (#1928) (5b60a95)
- Support Node 18+ (#1879) (3d24045)
- Circular Dependencies Issue (#1936) (aea893c)
- deps: Update dependency @google-cloud/language to v7 (#1947) (70e9183)
- deps: Update dependency @googleapis/iam to v27 (#1962) (629da74)
- deps: Update dependency @googleapis/iam to v28 (#2027) (ebb2bc0)
- deps: Update dependency puppeteer to v24 (#1933) (474453d)
- Process undefined values before creating URLSearchParams (#2029) (c0181c5)
- Move Base AuthClient Types to authclient.ts (#1774) (b0c3a43)
- Remove
messages.ts(#1919) (654753d) - Remove
options.ts(#1920) (51316e8) - Remove
Transporter(#1937) (dbcc44b) - Remove additionalOptions from AuthClients (#1689) (2f780a8)
- Remove DEFAULT_UNIVERSE from BaseExternalClient (#1690) (4f1dc04)
9.15.1 (2025-01-24)
9.15.0 (2024-11-01)
9.14.2 (2024-10-09)
9.14.1 (2024-08-30)
9.14.0 (2024-08-19)
- Add
AnyAuthClienttype (#1843) (3ae120d) - Extend API Key Support (#1835) (5fc3bcc)
- Group Concurrent
getClientRequests (#1848) (243ce28)
9.13.0 (2024-07-29)
9.12.0 (2024-07-26)
- deps: Update dependency @googleapis/iam to v19 (#1823) (b070ffb)
- deps: Update dependency @googleapis/iam to v20 (#1832) (e31a831)
9.11.0 (2024-06-01)
9.10.0 (2024-05-10)
- deps: Update dependency @googleapis/iam to v16 (#1803) (40406a0)
- deps: Update dependency @googleapis/iam to v17 (#1808) (4d67f07)
- deps: Update dependency @googleapis/iam to v18 (#1809) (b2b9676)
9.9.0 (2024-04-18)
9.8.0 (2024-04-12)
- deps: Update dependency open to v10 (#1782) (16e5cae)
- deps: Update dependency opn to v6 (#1775) (fc8dfe9)
9.7.0 (2024-03-12)
- deps: Update dependency @googleapis/iam to v15 (#1772) (f45f975)
- Making aws request signer get a new session token each time security credentials are requested. (#1765) (6a6e496)
9.6.3 (2024-02-06)
9.6.2 (2024-02-02)
9.6.1 (2024-02-01)
9.6.0 (2024-01-29)
- Open More Endpoints for Customization (#1721) (effbf87)
- Use self-signed JWTs when non-default Universe Domains (#1722) (7e9876e)
9.5.0 (2024-01-25)
9.4.2 (2024-01-04)
- deps: Update dependency @googleapis/iam to v13 (#1710) (7ae4aae)
- Expand credentials type (#1719) (846c8e9)
9.4.1 (2023-12-01)
9.4.0 (2023-11-30)
9.3.0 (2023-11-29)
- Add impersonated signer (#1694) (cb78a1b)
- Retrieve
universe_domainfor Compute clients (#1692) (a735ec5)
9.2.0 (2023-10-26)
- deps: Update dependency @googleapis/iam to v12 (#1671) (4f94ffe)
- DOS security risks (#1668) (b25d4f5)
- Increase max asset size (#1682) (edb9401)
- Remove broken source maps (#1669) (56cb3ad)
9.1.0 (2023-10-02)
- Byoid metrics (#1595) (fe09d6b)
- Expose
gcp-metadata(#1655) (d76140f) - Expose Compute's Service Account Email (#1656) (ef29297)
- Extend
universe_domainsupport (#1633) (4ee02da) - Support Instantiating OAuth2Client with Credentials (#1652) (4339d64)
- deps: Update dependency @google-cloud/storage to v7 (#1629) (8075b6f)
- deps: Update dependency @googleapis/iam to v11 (#1622) (03c0ac9)
- deps: Update dependency google-auth-library to v9 (#1618) (1873fef)
- deps: Update dependency puppeteer to v21 (#1627) (dd04fbd)
- Workforce Audience Pattern (#1654) (77eeaed)
9.0.0 (2023-07-20)
- deps: upgrade node-gtoken to 7.0.0 (#1590)
- make transporter attribute type more generic (#1406)
- migrate to Node 14 (#1582)
- remove arrify and fast-text-encoding (#1583)
8.9.0 (2023-06-29)
- Adds universe_domain field to base external client (#1548) (7412d7c)
- Utilize
gcp-metadata's GCP Residency Check (#1513) (43377ac)
- deps: Update dependency @googleapis/iam to v8 (#1581) (7373b75)
- deps: Update dependency puppeteer to v20 (#1550) (3563c16)
- IdTokenClient expiry_date check (#1555) (efcdef1)
- KeepAlive sample (#1561) (e3ab824)
- Make universeDomain private (#1552) (73b63d5)
- Remove auth lib version from x-goog-api-client header (#1558) (ce6013c)
8.8.0 (2023-04-25)
- Add External Account Authorized User client type (#1530) (06d4ef3)
- Document External Account Authorized User Credentials (#1540) (c6138be)
- deps: Update
gcp-metadatato v5.2.0 (#1502) (2562d11) - deps: Update dependency @googleapis/iam to v4 (#1482) (00d6135)
- deps: Update dependency @googleapis/iam to v5 (#1526) (a1f9835)
- deps: Update dependency @googleapis/iam to v6 (#1536) (86a4de8)
- deps: Update dependency @googleapis/iam to v7 (#1538) (fdb67dc)
- Do not call metadata server if security creds and region are retrievable through environment vars (#1493) (d4de941)
- Removing 3pi config URL validation (#1517) (a278d19)
- Removing aws url validation (#1531) (f4d9335)
8.7.0 (2022-11-08)
- deps: Update dependency puppeteer to v19 (#1476) (86b258d)
- Validate url domain for aws metadata urls (#1484) (6dc4e58)
8.6.0 (2022-10-06)
8.5.2 (2022-09-22)
- deps: Update dependency puppeteer to v17 (#1452) (b317b59)
- deps: Update dependency puppeteer to v18 (#1471) (9a2a918)
8.5.1 (2022-08-31)
8.5.0 (2022-08-31)
- add hashes to requirements.txt (#1544) (#1449) (54afa8e)
- remove
projectIdcheck forsignBlobcalls (6c04661)
8.4.0 (2022-08-23)
8.3.0 (2022-08-19)
8.2.0 (2022-08-11)
8.1.1 (2022-07-08)
8.1.0 (2022-06-30)
8.0.3 (2022-06-17)
8.0.2 (2022-04-27)
8.0.1 (2022-04-22)
- deps: update dependency gaxios to v5 (#1398) (cbd7d4f)
- deps: update dependency google-auth-library to v8 (#1399) (9a8be63)
8.0.0 (2022-04-20)
- Set Node v12 to minimum supported version & Upgrade TypeScript (#1392)
- remove deprecated DeprecatedGetClientOptions (#1393)
7.14.1 (2022-03-09)
7.14.0 (2022-02-22)
7.13.0 (2022-02-17)
7.12.0 (2022-02-09)
7.11.0 (2021-12-15)
7.10.4 (2021-12-13)
7.10.3 (2021-11-29)
7.10.2 (2021-11-03)
7.10.1 (2021-10-14)
- security: explicitly update keypair dependency (94401a6)
7.10.0 (2021-09-28)
7.9.2 (2021-09-16)
7.9.1 (2021-09-02)
7.9.0 (2021-09-02)
7.8.0 (2021-08-30)
7.7.0 (2021-08-27)
7.6.2 (2021-08-17)
7.6.1 (2021-08-13)
7.6.0 (2021-08-10)
7.5.0 (2021-08-04)
7.4.1 (2021-07-29)
7.4.0 (2021-07-29)
7.3.0 (2021-07-02)
7.2.0 (2021-06-30)
7.1.2 (2021-06-10)
7.1.1 (2021-06-02)
7.1.0 (2021-05-21)
- add
gcf-owl-bot[bot]toignoreAuthors(#1174) (f377adc) - add detection for Cloud Run (#1177) (4512363)
7.0.4 (2021-04-06)
7.0.3 (2021-03-23)
7.0.2 (2021-02-10)
7.0.1 (2021-02-09)
7.0.0 (2021-02-08)
- integrates external_accounts with
GoogleAuthand ADC (#1052) - workload identity federation support (#1131)
- adds service account impersonation to
ExternalAccountClient(#1041) (997f124) - adds text/json credential_source support to IdentityPoolClients (#1059) (997f124)
- defines
ExternalAccountClientused to instantiate external account clients (#1050) (997f124) - defines
IdentityPoolClientused for K8s and Azure workloads (#1042) (997f124) - defines ExternalAccountClient abstract class for external_account credentials (#1030) (997f124)
- get AWS region from environment variable (#1067) (997f124)
- implements AWS signature version 4 for signing requests (#1047) (997f124)
- implements the OAuth token exchange spec based on rfc8693 (#1026) (997f124)
- integrates external_accounts with
GoogleAuthand ADC (#1052) (997f124) - workload identity federation support (#1131) (997f124)
- deps: update dependency puppeteer to v6 (#1129) (5240fb0)
- deps: update dependency puppeteer to v7 (#1134) (02d0d73)
6.1.6 (2021-01-27)
6.1.5 (2021-01-22)
6.1.4 (2020-12-22)
6.1.3 (2020-10-22)
6.1.2 (2020-10-19)
6.1.1 (2020-10-06)
6.1.0 (2020-09-22)
6.0.8 (2020-08-13)
6.0.7 (2020-08-11)
6.0.6 (2020-07-30)
6.0.5 (2020-07-13)
6.0.4 (2020-07-09)
6.0.3 (2020-07-06)
6.0.2 (2020-06-16)
- deps: update dependency puppeteer to v4 (#976) (9ddfb9b)
- tsc: audience property is not mandatory on verifyIdToken (#972) (17a7e24)
- types: add locale property to idtoken (#974) (ebf9bed), closes #973
6.0.1 (2020-05-21)
- deps: update dependency google-auth-library to v6 (#930) (81fdabe)
- apache license URL (#468) (#936) (53831cf)
- deps: update dependency puppeteer to v3 (#944) (4d6fba0)
- fixing tsc error caused by @types/node update (#965) (b94edb0)
- gcp-metadata now warns rather than throwing (#956) (89e16c2)
6.0.0 (2020-03-26)
- [email protected] introduced some breaking changes in generated code.
- require node 10 in engines field (#926)
- remove deprecated methods (#906)
- do not warn for SDK creds (#905) (9536840)
- use iamcredentials API to sign blobs (#908) (7b8e4c5)
- deps: update dependency gaxios to v3 (#917) (1f4bf61)
- deps: update dependency gcp-metadata to v4 (#918) (d337131)
- types: add additional fields to TokenInfo (#907) (5b48eb8)
5.10.1 (2020-02-25)
5.10.0 (2020-02-20)
5.9.2 (2020-01-28)
5.9.1 (2020-01-16)
5.9.0 (2020-01-14)
- add methods for fetching and using id tokens (#867) (8036f1a)
- export LoginTicket and TokenPayload (#870) (539ea5e)
5.8.0 (2020-01-06)
5.7.0 (2019-12-10)
5.6.1 (2019-12-05)
- deps: pin TypeScript below 3.7.0 (#845) (a9c6e92)
- docs: improve types and docs for generateCodeVerifierAsync (#840) (04dae9c)
5.6.0 (2019-12-02)
- populate x-goog-user-project for requestAsync (#837) (5a068fb)
- set x-goog-user-project header, with quota_project from default credentials (#829) (3240d16)
- deps: update dependency puppeteer to v2 (#821) (2c04117)
- docs: add jsdoc-region-tag plugin (#826) (558677f)
- expand on x-goog-user-project to handle auth.getClient() (#831) (3646b7f)
- use quota_project_id field instead of quota_project (#832) (8933966)
5.5.1 (2019-10-22)
- deps: update gaxios dependency (#817) (6730698)
- don't append x-goog-api-client multiple times (#820) (a46b271)
5.5.0 (2019-10-14)
5.4.1 (2019-10-10)
5.4.0 (2019-10-08)
5.3.0 (2019-09-27)
5.2.2 (2019-09-17)
5.2.1 (2019-09-06)
- deps: nock@next has types that work with our libraries (#783) (a253709)
- docs: fix variable name in README.md (#782) (d8c70b9)
5.2.0 (2019-08-09)
5.1.2 (2019-08-05)
5.1.1 (2019-07-29)
5.1.0 (2019-07-24)
5.0.0 (2019-07-23)
- getOptions() no longer accepts GoogleAuthOptions (#749)
4.2.6 (2019-07-23)
4.2.5 (2019-06-26)
4.2.4 (2019-06-25)
4.2.3 (2019-06-24)
4.2.2 (2019-06-18)
4.2.1 (2019-06-14)
4.2.0 (2019-06-05)
4.1.0 (2019-05-29)
4.0.0 (2019-05-08)
- deps: update dependency arrify to v2 (#684) (1757ee2)
- deps: update dependency gaxios to v2 (#681) (770ad2f)
- deps: update dependency gcp-metadata to v2 (#701) (be20528)
- deps: update dependency gtoken to v3 (#702) (2c538e5)
- re-throw original exception and preserve message in compute client (#668) (dffd1cc)
- surface original stack trace and message with errors (#651) (8fb65eb)
- throw on missing refresh token in all cases (#670) (0a02946)
- throw when adc cannot acquire a projectId (#658) (ba48164)
- deps: update dependency semver to v6 (#655) (ec56c88)
- upgrade engines field to >=8.10.0 (#686)
03-22-2019 15:38 PDT
- fix: getCredential(): load credentials with getClient() (#648)
- chore: publish to npm using wombat (#645)
03-18-2019 08:32 PDT
- fix: Avoid loading fast-text-encoding if not in browser environment (#627)
- fix(deps): update dependency gcp-metadata to v1 (#632)
- docs: update links in contrib guide (#630)
- build: use per-repo publish token (#641)
- build: Add docuploader credentials to node publish jobs (#639)
- build: use node10 to run samples-test, system-test etc (#638)
- build: update release configuration
- chore(deps): update dependency @types/lru-cache to v5 (#635)
- chore(deps): update dependency mocha to v6
- chore: fix lint (#631)
- build: use linkinator for docs test (#628)
- chore(deps): update dependency @types/tmp to ^0.0.34 (#629)
- build: create docs test npm scripts (#625)
- build: test using @grpc/grpc-js in CI (#624)
02-08-2019 08:29 PST
- fix: use key file when fetching project id (#618)
- fix: Throw error if there is no refresh token despite the necessity of refreshing (#605)
- feat: allow passing constructor options to getClient (#611)
- docs: update contributing path in README (#621)
- chore: move CONTRIBUTING.md to root (#619)
- docs: add lint/fix example to contributing guide (#615)
- docs: use the People API for samples (#609)
- chore(deps): update dependency typescript to ~3.3.0 (#612)
- chore(deps): update dependency eslint-config-prettier to v4 (#604)
- build: ignore googleapis.com in doc link check (#602)
- chore(deps): update dependency karma to v4 (#603)
01-16-2019 21:04 PST
- fix(deps): upgrade to the latest gaxios (#596)
01-16-2019 10:00 PST
Welcome to 3.0 π This release has it all. New features, bug fixes, breaking changes, performance improvements - something for everyone! The biggest addition to this release is support for the browser via Webpack.
This release has breaking changes. This release has a few breaking changes. These changes are unlikely to affect most clients.
The 2.0 version of this library used the axios library for making HTTP requests. In the 3.0 release, this has been replaced by a mostly API compatible library gaxios. The new request library natively supports proxies, and comes with a smaller dependency chain. While this is mostly an implementation detail, the request method was directly exposed via the GoogleAuth.request and OAuth2Client.request methods. The gaxios library aims to provide an API compatible implementation of axios, but that can never be 100% promised. If you run into bugs or differences that cause issues - please do let us know.
The OAuth2Client.generateCodeVerifier method has been replaced by the OAuth2Client.generateCodeVerifierAsync method. It has changed from a synchronous method to an asynchronous method to support async browser crypto APIs required for Webpack support.
The OAuth2Client.verifySignedJwtWithCerts method has been replaced by the OAuth2Client.verifySignedJwtWithCertsAsync method. It has changed from a synchronous method to an asynchronous method to support async browser crypto APIs required for Webpack support.
- feat: make it webpackable (#371)
- fix: accept lowercase env vars (#578)
- refactor(deps): use
gaxiosfor HTTP requests instead ofaxios(#593) - fix: some browser fixes (#590)
- chore(deps): update dependency ts-loader to v5 (#588)
- chore(deps): update dependency karma to v3 (#587)
- build: check broken links in generated docs (#579)
- chore(deps): drop unused dep on typedoc (#583)
- build: add browser test running on Kokoro (#584)
- test: improve samples and add tests (#576)
12-16-2018 10:48 PST
- fix(deps): update dependency lru-cache to v5 (#541)
- chore(deps): update dependency @types/sinon to v7 (#568)
- refactor: use execa for install tests, run eslint on samples (#559)
- chore(build): inject yoshi automation key (#566)
- chore: update nyc and eslint configs (#565)
- chore: fix publish.sh permission +x (#563)
- fix(build): fix Kokoro release script (#562)
- build: add Kokoro configs for autorelease (#561)
- chore: always nyc report before calling codecov (#557)
- chore: nyc ignore build/test by default (#556)
- chore(build): update the prettier and renovate config (#552)
- chore: update license file (#551)
- fix(build): fix system key decryption (#547)
- chore(deps): update dependency typescript to ~3.2.0 (#546)
- chore(deps): unpin sinon (#544)
- refactor: drop non-required modules (#542)
- chore: add synth.metadata (#537)
- fix: Pin @types/sinon to last compatible version (#538)
- chore(deps): update dependency gts to ^0.9.0 (#531)
- chore: update eslintignore config (#530)
- chore: drop contributors from multiple places (#528)
- chore: use latest npm on Windows (#527)
- chore: update CircleCI config (#523)
- chore: include build in eslintignore (#516)
- fix: verifyIdToken will never return null (#488)
- Update the url to application default credentials (#470)
- Update omitted parameter 'hd' (#467)
- chore(deps): update dependency nock to v10 (#501)
- chore(deps): update dependency sinon to v7 (#502)
- chore(deps): update dependency typescript to v3.1.3 (#503)
- chore(deps): update dependency gh-pages to v2 (#499)
- chore(deps): update dependency typedoc to ^0.13.0 (#497)
- docs: Remove code format from Application Default Credentials (#483)
- docs: replace google/ with googleapis/ in URIs (#472)
- Fix typo in readme (#469)
- Update samples and docs for 2.0 (#459)
- chore: update issue templates (#509)
- chore: remove old issue template (#507)
- build: run tests on node11 (#506)
- chore(build): drop hard rejection and update gts in the kitchen test (#504)
- chores(build): do not collect sponge.xml from windows builds (#500)
- chores(build): run codecov on continuous builds (#495)
- chore: update new issue template (#494)
- build: fix codecov uploading on Kokoro (#490)
- test: move kitchen sink tests to system-test (#489)
- Update kokoro config (#482)
- fix: export additional typescript types (#479)
- Don't publish sourcemaps (#478)
- test: remove appveyor config (#477)
- Enable prefer-const in the eslint config (#473)
- Enable no-var in eslint (#471)
- Update CI config (#468)
- Retry npm install in CI (#465)
- Update Kokoro config (#462)
Well hello 2.0 π This release has multiple breaking changes. It also has a lot of bug fixes.
These versions of node.js are no longer supported.
The getRequestMetadata method has been deprecated on the IAM, OAuth2, JWT, and JWTAccess classes. The getRequestHeaders method should be used instead. The methods have a subtle difference: the getRequestMetadata method returns an object with a headers property, which contains the authorization header. The getRequestHeaders method simply returns the headers.
const client = await auth.getClient();
const res = await client.getRequestMetadata();
const headers = res.headers;const client = await auth.getClient();
const headers = await client.getRequestHeaders();The createScopedRequired method has been deprecated on multiple classes. The createScopedRequired and createScoped methods on the JWT class were largely in place to help inform clients when scopes were required in an application default credential scenario. Instead of checking if scopes are required after creating the client, instead scopes should just be passed either into the GoogleAuth.getClient method, or directly into the JWT constructor.
auth.getApplicationDefault(function(err, authClient) {
if (err) {
return callback(err);
}
if (authClient.createScopedRequired && authClient.createScopedRequired()) {
authClient = authClient.createScoped([
'https://www.googleapis.com/auth/cloud-platform'
]);
}
callback(null, authClient);
});const client = await auth.getClient({
scopes: ['https://www.googleapis.com/auth/cloud-platform']
});Note: refreshAccessToken is no longer deprecated.
getAccessToken, getRequestMetadata, and request methods will all refresh the token if needed automatically.
You should not need to invoke refreshAccessToken directly except in certain edge-cases.
- Set private_key_id in JWT access token header like other google auth libraries. (#450)
- fix: support HTTPS proxies (#405)
- fix: export missing interfaces (#437)
- fix: Use new auth URIs (#434)
- docs: Fix broken link (#423)
- fix: surface file read streams (#413)
- fix: prevent unhandled rejections by avoid .catch (#404)
- fix: use gcp-metadata for compute credentials (#409)
- Add Code of Conduct
- fix: Warn when using user credentials from the Cloud SDK (#399)
- fix: use
Buffer.frominstead ofnew Buffer(#400) - fix: Fix link format in README.md (#385)
- chore: deprecate getRequestMetadata (#414)
- fix: deprecate the
createScopedRequiredmethods (#410) - fix: drop support for node.js 4.x and 9.x (#417)
- fix: deprecate the
refreshAccessTokenmethods (#411) - fix: deprecate the
getDefaultProjectIdmethod (#402) - fix: drop support for node.js 4 (#401)
- Run synth to make build tools consistent (#455)
- Add a package.json for samples and cleanup README (#454)
- chore(deps): update dependency typedoc to ^0.12.0 (#453)
- chore: move examples => samples + synth (#448)
- chore(deps): update dependency nyc to v13 (#452)
- chore(deps): update dependency pify to v4 (#447)
- chore(deps): update dependency assert-rejects to v1 (#446)
- chore: ignore package-lock.json (#445)
- chore: update renovate config (#442)
- chore(deps): lock file maintenance (#443)
- chore: remove greenkeeper badge (#440)
- test: throw on deprecation
- chore: add intelli-espower-loader for running tests (#430)
- chore(deps): update dependency typescript to v3 (#432)
- chore(deps): lock file maintenance (#431)
- test: use strictEqual in tests (#425)
- chore(deps): lock file maintenance (#428)
- chore: Configure Renovate (#424)
- chore: Update gts to the latest version π (#422)
- chore: update gcp-metadata for isAvailable fix (#420)
- refactor: use assert.reject in the tests (#415)
- refactor: cleanup types for certificates (#412)
- test: run tests with hard-rejection (#397)
- cleanup: straighten nested try-catch (#394)
- test: getDefaultProjectId should prefer config (#388)
- chore(package): Update gts to the latest version π (#387)
- chore(package): update sinon to version 6.0.0 (#386)
The 1.x release includes a variety of bug fixes, new features, and breaking changes. Please take care, and see the release notes for a list of breaking changes, and the upgrade guide.