docs(scope-auth): make authorization examples consistent and current

[hayes]

Use current scopeAuth configuration and a consistent article/context example throughout the authorization guide. Clarify allow/deny behavior, distinct permissions, structured scope cache keys, grants, and request isolation; remove stale option names and vague example terminology. Synchronize the README.

Validation: every displayed TypeScript block strict-typechecks with its documented setup. Current-source execution checks allowed and denied requests, cached checks, request isolation, and that denied resolvers do not run. All 108 Scope Auth package tests pass under Node 24. Final website build and rendered documentation links/anchors pass.

Separate post-publication editorial and correctness reviews are complete; material findings were addressed.

Preservation re-review against original base 7c0a5490: Restored eager/deferred asynchronous permission setup and withAuth().prismaField() with refined context and current Prisma configuration. Both additions strict-check and passed an independent re-review. All earlier authorization, caching, and scope-composition coverage is accounted for.

All useful omissions identified by the new review were fixed and independently re-reviewed. The final integrated production website build, executable documentation checks, and links/anchors across 77 rendered pages pass. Dependency-install fences use package-install throughout the changed website pages and READMEs.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
pothos	Ready	Preview	Sep 11, 2026 6:50am UTC

[changeset-bot]

⚠️ No Changeset found

Latest commit: 78ee9a7

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[pkg-pr-new]

Open in StackBlitz

@pothos/core

npm i https://pkg.pr.new/@pothos/core@1718

@pothos/plugin-add-graphql

npm i https://pkg.pr.new/@pothos/plugin-add-graphql@1718

@pothos/plugin-complexity

npm i https://pkg.pr.new/@pothos/plugin-complexity@1718

@pothos/plugin-dataloader

npm i https://pkg.pr.new/@pothos/plugin-dataloader@1718

@pothos/plugin-directives

npm i https://pkg.pr.new/@pothos/plugin-directives@1718

@pothos/plugin-drizzle

npm i https://pkg.pr.new/@pothos/plugin-drizzle@1718

@pothos/plugin-errors

npm i https://pkg.pr.new/@pothos/plugin-errors@1718

@pothos/plugin-example

npm i https://pkg.pr.new/@pothos/plugin-example@1718

@pothos/plugin-federation

npm i https://pkg.pr.new/@pothos/plugin-federation@1718

@pothos/plugin-grafast

npm i https://pkg.pr.new/@pothos/plugin-grafast@1718

@pothos/plugin-mocks

npm i https://pkg.pr.new/@pothos/plugin-mocks@1718

@pothos/plugin-prisma

npm i https://pkg.pr.new/@pothos/plugin-prisma@1718

@pothos/plugin-prisma-utils

npm i https://pkg.pr.new/@pothos/plugin-prisma-utils@1718

@pothos/plugin-relay

npm i https://pkg.pr.new/@pothos/plugin-relay@1718

@pothos/plugin-scope-auth

npm i https://pkg.pr.new/@pothos/plugin-scope-auth@1718

@pothos/plugin-simple-objects

npm i https://pkg.pr.new/@pothos/plugin-simple-objects@1718

@pothos/plugin-smart-subscriptions

npm i https://pkg.pr.new/@pothos/plugin-smart-subscriptions@1718

@pothos/plugin-sub-graph

npm i https://pkg.pr.new/@pothos/plugin-sub-graph@1718

@pothos/plugin-tracing

npm i https://pkg.pr.new/@pothos/plugin-tracing@1718

@pothos/plugin-validation

npm i https://pkg.pr.new/@pothos/plugin-validation@1718

@pothos/plugin-with-input

npm i https://pkg.pr.new/@pothos/plugin-with-input@1718

@pothos/plugin-zod

npm i https://pkg.pr.new/@pothos/plugin-zod@1718

@pothos/tracing-newrelic

npm i https://pkg.pr.new/@pothos/tracing-newrelic@1718

@pothos/tracing-opentelemetry

npm i https://pkg.pr.new/@pothos/tracing-opentelemetry@1718

@pothos/tracing-sentry

npm i https://pkg.pr.new/@pothos/tracing-sentry@1718

@pothos/tracing-xray

npm i https://pkg.pr.new/@pothos/tracing-xray@1718

commit: 77b6d1a

[vercel]

Deployment failed for project pothos with the following error:

Resource is limited - try again in 24 hours (more than 100, code: "api-deployments-free-per-day").

Learn More: https://vercel.com/michael-hayes-projects?upgradeToPro=build-rate-limit