From 7a6b21c8a7adb2f3131f0b7b57a105fc9ac11328 Mon Sep 17 00:00:00 2001 From: Mariana Caetano Pereira <67270558+Mariana-Caetano@users.noreply.github.com> Date: Tue, 22 Oct 2024 15:47:19 -0300 Subject: [PATCH 1/3] add first content for LOC review --- ...ring-extending-the-faststore-api-schema.md | 54 +++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/localization/issues-during-extending-the-faststore-api-schema.md diff --git a/docs/localization/issues-during-extending-the-faststore-api-schema.md b/docs/localization/issues-during-extending-the-faststore-api-schema.md new file mode 100644 index 0000000000..7e2c1141a9 --- /dev/null +++ b/docs/localization/issues-during-extending-the-faststore-api-schema.md @@ -0,0 +1,54 @@ +--- +title: 'Issues during extending the FastStore API schema' +slug: "issues-during-extending-the-faststore-api-schema" +excerpt: "Updating EANs in VTEX can lead to catalog sync issues affecting inventory." +tags: + - faststore + - api +--- + +**Keywords:** FastStore | API extension + +Although the FastStore API provides a GraphQL schema for ecommerce, you can extend the FastStore API schema to access other or more specific information from your store. During this implementation, you encounter issues such as not having the GraphQL changes you performed aren’t visible during development or in the store production. + +Below are different troubleshooting checks and instructions you can use to solve API extension issues: + +- [GraphQL changes not visible during development](#graphql-changes-not-visible-during-development) +- [Deploy preview/production GraphQL schema different from development](#deploy-previewproduction-graphql-schema-different-from-development) +- [Type generation errors and warnings](#type-generation-errors-and-warnings) + - [Error details](#error-details) +- [GraphQL changes not visible in production/deploy preview](#graphql-changes-not-visible-in-productiondeploy-preview) + +## GraphQL changes not visible during development + +If your GraphQL changes aren't visible during development, the changes you have made since you started the development server (`yarn dev`) are probably not optimized. + +To trigger the optimization, run `yarn generate` (recommended) or `yarn run faststore generate-graphql`. Alternatively, you can stop and restart the development server using `yarn dev`. + + > ℹ️ This optimization can also be performed while the development server is running. + +## Deploy preview/production GraphQL schema different from development + +If you notice differences between the GraphQL schema in your deploy preview or production environment and your development setup, it may be because the schema has not been optimized since the development server's initiation. The build process optimizes the schema before deployment to accurately reflect the schema declared in the store's code. + +To fix the issue, refer to the [GraphQL changes not visible during development](#graphql-changes-not-visible-during-development) topic. + +## Type generation errors and warnings + +Some errors can occur during GraphQL optimizations and type generation. Here's how to troubleshoot them: + +| **Error message** | **Possible cause** | **Solution** | +| ----------------- | ------------------ | ------------ | +| `error Failed to run 'yarn generate:schema'. Please check your setup.` | Malformed files in your GraphQL Schema Extensions definitions. | Check the graphql files inside the `src/graphql/(vtex or thirdParty)/typeDefs` folders for syntax or definition errors. | +| `error GraphQL was not optimized and TS files were not updated. Changes in the GraphQL layer did not take effect` | Malformed files or GraphQL types within your GraphQL layer, including errors in GraphQL Schema Extensions, declared queries, and fragments. | Check the graphql files inside the `src/graphql/(vtex or thirdParty)/typeDefs` folders and component (`.ts`, `tsx`) files declaring queries and fragments in your project for syntax or definition errors. | +| `warn: Failed to format generated files. 'yarn format:generated' thrown errors` | An issue occurred during the formatting process for the generated GraphQL optimization and types files. | This is a warning, not an error. Your GraphQL layer will still function correctly. If you want to investigate and resolve the formatting issue, follow these steps:
  1. 1. Retry formatting: Run the `yarn format:generated` command again.
  2. 2. Check formatting configuration: Ensure the formatting rules are correct and compatible with the generated files.
  3. 3. Inspect error logs: Look for specific error messages that might provide more clues about the issue.
| + +### Error details + +To access more detailed error information, use the `--debug` flag when manually running the `yarn generate` command to see detailed errors on why the generation has failed. + +## GraphQL changes not visible in production/deploy preview + +During the build step, the GraphQL optimization and type files are always generated fresh, reflecting the most recent changes in the code. + +If your changes are not visible in production, this means you must not have committed them to the branch you're currently working on. If you see different GraphQL schema, queries, or data during development, refer to the [GraphQL changes not visible during development](#graphql-changes-not-visible-during-development) topic. From 1c5d28228425d5c3f763db34effa1479bff30dae Mon Sep 17 00:00:00 2001 From: Mariana Caetano Pereira <67270558+Mariana-Caetano@users.noreply.github.com> Date: Wed, 13 Nov 2024 08:26:55 -0300 Subject: [PATCH 2/3] Fix 'excerpt' --- .../issues-during-extending-the-faststore-api-schema.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/localization/issues-during-extending-the-faststore-api-schema.md b/docs/localization/issues-during-extending-the-faststore-api-schema.md index 7e2c1141a9..b02938208a 100644 --- a/docs/localization/issues-during-extending-the-faststore-api-schema.md +++ b/docs/localization/issues-during-extending-the-faststore-api-schema.md @@ -1,7 +1,7 @@ --- title: 'Issues during extending the FastStore API schema' slug: "issues-during-extending-the-faststore-api-schema" -excerpt: "Updating EANs in VTEX can lead to catalog sync issues affecting inventory." +excerpt: "Development and deployment challenges may arise while extending FastStore API schema with GraphQL." tags: - faststore - api From ccdfd3d9b1bd98fa430f9d88d940d3d124eb38d9 Mon Sep 17 00:00:00 2001 From: Mariana Caetano Pereira <67270558+Mariana-Caetano@users.noreply.github.com> Date: Wed, 13 Nov 2024 08:39:52 -0300 Subject: [PATCH 3/3] Moved doc file to 'troubleshooting/development' folder --- .../issues-during-extending-the-faststore-api-schema.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/{localization => troubleshooting/development}/issues-during-extending-the-faststore-api-schema.md (100%) diff --git a/docs/localization/issues-during-extending-the-faststore-api-schema.md b/docs/troubleshooting/development/issues-during-extending-the-faststore-api-schema.md similarity index 100% rename from docs/localization/issues-during-extending-the-faststore-api-schema.md rename to docs/troubleshooting/development/issues-during-extending-the-faststore-api-schema.md