Identity, tenancy, proxy generation and OpenAPI guides - #38
Merged
Merged
Conversation
…de pages Move the CLI walkthrough from the overview into a setup guide built on the Library sample, add a React usage tour with commands, live and paged queries, and arguments, and a reference for generated classes and hook signatures. The overview keeps compatibility and limits for users and drops the test-evidence sentence, which the capability reference tracks. Drafted with AI assistance.
…cal users Turn the identity index into a tour, and add pages for how /.cratis/me is served and cached, React integration and refresh with @cratis/arc.react, identity across services, and simulating signed-in users locally with the Microsoft identity header handler. Note that tenancy rules also apply to the development discovery routes. Drafted with AI assistance.
… docs Add sections on reading claims per authentication source, deciding from your own data with provide() and denied(), the status and result of each authorization failure, and testing authorization with CommandScenario. Drop the test-evidence sentence, which the capability reference already tracks. Drafted with AI assistance.
Rewrite the tenancy overview as a tour of selection, membership, and storage isolation with best practices and security considerations. Add a storage isolation page that maps the resolved tenant to MongoDB databases, Drizzle connections, and Chronicle namespaces, including the Default namespace fallback and reactor commands, and a checklist for verifying the boundary. Drafted with AI assistance.
… and v0.22 Open the configuration page with the problem it solves, show which entry points read appsettings.json and environment variables, list the builder methods integrations add, explain that CORS belongs in front of Arc, and map the pre-v0.22 flat option names to the grouped ArcOptions paths. Add the Development, Tenancy:Required, and Tenancy:MembershipClaim keys the binder already accepts. Drafted with AI assistance.
Open with the consumers the document serves, show a real Tasks sample excerpt, and explain which parts need generated metadata. Add a page on how concepts, dates, enums, optional, nullable, and defaulted fields, derived types, and result types appear, including that enums list their wire values and not member names. Drafted with AI assistance.
Explain why to ask a running application what it serves, what the anonymous endpoints expose, and how introspection relates to OpenAPI and proxies. Correct the enumeration and nullable schema description, and the documentationSummary value and meaning when generated metadata supplies JSDoc summaries. Drafted with AI assistance.
Drafted with AI assistance.
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
1 participant
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.
Changed
@cratis/arc.reacthooks, deployment topologies, and a local-development principal.ArcOptionspaths.Fixed
anyOfwith oneconstper value) and that operation summaries come from JSDoc when generated artifact metadata is used.