Repository navigation
docs: replace Pothos stop-migration rules with complete GQLoom paths (en, zh) - #433
Merged
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates both the English (
website/docs/migrations/from-pothos.md) and Chinese (website/zh/docs/migrations/from-pothos.md) Pothos → GQLoom migration guides to cover a complete migration with zero leftover Pothos modules:When to migrate, when to stop/何时迁移与何时停止section.silk(new GraphQLInterfaceType(...))forNode(preservingnode/nodesinterface return types without duplicate type errors), Zod silks forPageInfo,*Edge, and*Connectionmatchingbefore.graphqlnullability and global ID/cursor encoding.z.discriminatedUnion/z.union+Errorinterface silk) whenbefore.graphqlhas a union, orGraphQLErrorwithextensionswhen it does not, with explicit documentation of the SDL/response contract change and client adaptation when dropping error unions.weave()call per audience passing only that audience's resolvers and field-hiding resolvers (field.hiddenscoped to a singleweave()).subscription()operations + pubsub (createPubSub) with explicitpubSub.publish(...)calls in mutations, plus documentation of client/behavior adaptation when moving live queries or nested invalidations toSubscription..meta({ title })(and Zod v4 getter syntax / inner-z.lazy.meta({ title })for recursive filters) preserving original SDL type names so clients see no change.silk(new GraphQLInterfaceType(...))fix for interface-typed fields, inner.meta({ title })placement onz.lazy(...), single-queryinclude/withfallback for hot ORM paths, and expanded the final Pothos uninstall list.Verification
pnpm run check:lint(biome lint .) passes across 387 files.pnpm run check:typepasses across all workspace packages and website checks.NODE_OPTIONS="--max_old_space_size=8192" pnpm --filter website build(including VitePress Twoslash compilation of everyts twoslashsnippet in bothenandzhdocs) succeeds cleanly.validateSchema,printSchema) and GraphQL execution for Relay (Node,PageInfo,*Edge,*Connection), Errors unions, Sub-graphs, Smart Subscriptions (createPubSub), and Drizzle variants + recursive filter/order inputs.