docs(registry): /publisher unauthenticated note — parity with /operator (closes #3546)#3569
Merged
EmmaLouise2018 merged 2 commits intoMay 1, 2026
Merged
Conversation
Contributor
|
Approved and ready to land — but #3563 and #3565 both touched |
Mechanical output of `npm run build:openapi` for the previous commit's description change. No semantic delta beyond the /publisher entry. Refs #3546.
93befdc to
a3d5487
Compare
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.
Closes #3546. Refs #3538 / #3542.
#3542 documented
/api/registry/operator's caller-tier response-shape rules (anonymous → public; AAO API → +members_only; profile owner → +private). Asymmetry surfaced during #3559 investigation:/api/registry/publisher(server/src/routes/registry-api.ts:5229) has no auth middleware and returns identical shape for every caller.Documenting the asymmetry rather than introducing one. AAO membership does NOT unlock more on
/publishertoday — telling the caller explicitly so the docs don't oversell membership value.What changed
server/src/routes/registry-api.ts:669—/publisherendpoint registration gains adescriptionblock noting "unauthenticated, identical shape for every caller. Compare to/operatorfor the auth-aware contrast."static/openapi/registry.yaml— mechanical regen vianpm run build:openapi(separate commit).Test plan
npx vitest run server/tests/unit/openapi-coverage.test.ts— 3/3 pass.npx tsc --noEmit -p server/tsconfig.json— clean.Out of scope
/publisherSHOULD become auth-aware (open product question — docs(registry): /publisher auth-aware response note (parity with /operator) #3546 explicitly defers).