From 16c9e525fc8b69b65275d340ad47db4d95c5a2fd Mon Sep 17 00:00:00 2001 From: Hui Zhao Date: Mon, 17 Jun 2024 20:29:55 -0700 Subject: [PATCH 1/6] chore: add serverComponentsExternalPackages callout for Next.js --- .../server-side-rendering/index.mdx | 24 +++++++++++++++++++ .../server-side-rendering/nextjs/index.mdx | 24 +++++++++++++++++++ 2 files changed, 48 insertions(+) diff --git a/src/pages/[platform]/build-a-backend/server-side-rendering/index.mdx b/src/pages/[platform]/build-a-backend/server-side-rendering/index.mdx index f364aa2aef0..14a6dfb3266 100644 --- a/src/pages/[platform]/build-a-backend/server-side-rendering/index.mdx +++ b/src/pages/[platform]/build-a-backend/server-side-rendering/index.mdx @@ -230,6 +230,30 @@ For the **GraphQL API** category, review [Connect to data from Server-side Runti + + +**NOTE:** If you used the Amplify server-side APIs in server action and encounter the error running `next build`: + +> ./node_modules/@aws-amplify/core/node_modules/@aws-crypto/sha256-js/build/module/index.js + 12 modules + +> Cannot get final name for export 'fromUtf8' of ./node_modules/@smithy/util-utf8/dist-es/index.js + +You can add the following to your `next.config.js`: + +```ts title="next.config.js" +/** @type {import('next').NextConfig} */ +const nextConfig = { + // highlight-start + experimental: { + serverComponentsExternalPackages: ['@aws-crypto'], + }, + // highlight-end +}; +``` + +See Next.js documentation on [`serverComponentsExternalPackages`](https://nextjs.org/docs/app/api-reference/next-config-js/serverComponentsExternalPackages) fro more details. + + ### With Next.js App Router #### Dynamic rendering in React server component diff --git a/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx b/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx index 55b56b3c3f5..912b04523fb 100644 --- a/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx +++ b/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx @@ -232,6 +232,30 @@ For the **GraphQL API** category, review [Connect to GraphQL API from server-sid + + +**NOTE:** If you used the Amplify server-side APIs in server action and encounter the error running `next build`: + +> ./node_modules/@aws-amplify/core/node_modules/@aws-crypto/sha256-js/build/module/index.js + 12 modules + +> Cannot get final name for export 'fromUtf8' of ./node_modules/@smithy/util-utf8/dist-es/index.js + +You can add the following to your `next.config.js`: + +```ts title="next.config.js" +/** @type {import('next').NextConfig} */ +const nextConfig = { + // highlight-start + experimental: { + serverComponentsExternalPackages: ['@aws-crypto'], + }, + // highlight-end +}; +``` + +See Next.js documentation on [`serverComponentsExternalPackages`](https://nextjs.org/docs/app/api-reference/next-config-js/serverComponentsExternalPackages) fro more details. + + ### With Next.js App Router #### In React Server Component From 1ab931030ee00e757da1aaaf9343a65d08488932 Mon Sep 17 00:00:00 2001 From: Hui Zhao <10602282+HuiSF@users.noreply.github.com> Date: Tue, 18 Jun 2024 11:34:51 -0700 Subject: [PATCH 2/6] Apply suggestions from code review Co-authored-by: Jim Blanchard --- .../build-a-backend/server-side-rendering/index.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/pages/[platform]/build-a-backend/server-side-rendering/index.mdx b/src/pages/[platform]/build-a-backend/server-side-rendering/index.mdx index 14a6dfb3266..0e8a0e78ea5 100644 --- a/src/pages/[platform]/build-a-backend/server-side-rendering/index.mdx +++ b/src/pages/[platform]/build-a-backend/server-side-rendering/index.mdx @@ -232,7 +232,7 @@ For the **GraphQL API** category, review [Connect to data from Server-side Runti -**NOTE:** If you used the Amplify server-side APIs in server action and encounter the error running `next build`: +**NOTE:** If you use the Amplify server-side APIs in a server action and encounter the following error running `next build`: > ./node_modules/@aws-amplify/core/node_modules/@aws-crypto/sha256-js/build/module/index.js + 12 modules @@ -251,7 +251,7 @@ const nextConfig = { }; ``` -See Next.js documentation on [`serverComponentsExternalPackages`](https://nextjs.org/docs/app/api-reference/next-config-js/serverComponentsExternalPackages) fro more details. +See Next.js documentation on [`serverComponentsExternalPackages`](https://nextjs.org/docs/app/api-reference/next-config-js/serverComponentsExternalPackages) for more details. ### With Next.js App Router From 2b2d5ce0d3c4284377e26cbb17e342ee393aff60 Mon Sep 17 00:00:00 2001 From: Hui Zhao <10602282+HuiSF@users.noreply.github.com> Date: Tue, 18 Jun 2024 11:35:24 -0700 Subject: [PATCH 3/6] Apply suggestions from code review --- .../build-a-backend/server-side-rendering/nextjs/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx b/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx index 912b04523fb..c9ea0d8c4fc 100644 --- a/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx +++ b/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx @@ -253,7 +253,7 @@ const nextConfig = { }; ``` -See Next.js documentation on [`serverComponentsExternalPackages`](https://nextjs.org/docs/app/api-reference/next-config-js/serverComponentsExternalPackages) fro more details. +See Next.js documentation on [`serverComponentsExternalPackages`](https://nextjs.org/docs/app/api-reference/next-config-js/serverComponentsExternalPackages) for more details. ### With Next.js App Router From 601c6d6a63967b80e48effc6faa06d3f5f7b35cc Mon Sep 17 00:00:00 2001 From: Hui Zhao <10602282+HuiSF@users.noreply.github.com> Date: Wed, 19 Jun 2024 15:49:29 -0700 Subject: [PATCH 4/6] Update src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx Co-authored-by: Jim Blanchard --- .../build-a-backend/server-side-rendering/nextjs/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx b/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx index c9ea0d8c4fc..0c6dad3d562 100644 --- a/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx +++ b/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx @@ -234,7 +234,7 @@ For the **GraphQL API** category, review [Connect to GraphQL API from server-sid -**NOTE:** If you used the Amplify server-side APIs in server action and encounter the error running `next build`: +**NOTE:** If you use the Amplify server-side APIs in a server action and encounter the following error running `next build`: > ./node_modules/@aws-amplify/core/node_modules/@aws-crypto/sha256-js/build/module/index.js + 12 modules From 4758fd861854d4b77ac90535e0d9ab160f43e48f Mon Sep 17 00:00:00 2001 From: Hui Zhao <10602282+HuiSF@users.noreply.github.com> Date: Wed, 19 Jun 2024 16:05:16 -0700 Subject: [PATCH 5/6] Update src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx Co-authored-by: josef --- .../build-a-backend/server-side-rendering/nextjs/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx b/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx index 0c6dad3d562..7bf1590334a 100644 --- a/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx +++ b/src/pages/gen1/[platform]/build-a-backend/server-side-rendering/nextjs/index.mdx @@ -234,7 +234,7 @@ For the **GraphQL API** category, review [Connect to GraphQL API from server-sid -**NOTE:** If you use the Amplify server-side APIs in a server action and encounter the following error running `next build`: +**Note:** If you use the Amplify server-side APIs in a [server action](https://nextjs.org/docs/app/building-your-application/data-fetching/server-actions-and-mutations) and encounter the following error running `next build`: > ./node_modules/@aws-amplify/core/node_modules/@aws-crypto/sha256-js/build/module/index.js + 12 modules From dfa7b4fd70fa5f27a8abf1818461f0b0b3bf1639 Mon Sep 17 00:00:00 2001 From: Hui Zhao <10602282+HuiSF@users.noreply.github.com> Date: Wed, 19 Jun 2024 16:05:21 -0700 Subject: [PATCH 6/6] Update src/pages/[platform]/build-a-backend/server-side-rendering/index.mdx Co-authored-by: josef --- .../[platform]/build-a-backend/server-side-rendering/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/[platform]/build-a-backend/server-side-rendering/index.mdx b/src/pages/[platform]/build-a-backend/server-side-rendering/index.mdx index 0e8a0e78ea5..b9cd7d07acc 100644 --- a/src/pages/[platform]/build-a-backend/server-side-rendering/index.mdx +++ b/src/pages/[platform]/build-a-backend/server-side-rendering/index.mdx @@ -232,7 +232,7 @@ For the **GraphQL API** category, review [Connect to data from Server-side Runti -**NOTE:** If you use the Amplify server-side APIs in a server action and encounter the following error running `next build`: +**Note:** If you use the Amplify server-side APIs in a [server action](https://nextjs.org/docs/app/building-your-application/data-fetching/server-actions-and-mutations) and encounter the following error running `next build`: > ./node_modules/@aws-amplify/core/node_modules/@aws-crypto/sha256-js/build/module/index.js + 12 modules