From 2ced0b89c564da04c554eab7f85b928d06ff8b16 Mon Sep 17 00:00:00 2001 From: julianleonard123 Date: Mon, 8 Sep 2025 12:46:57 +0200 Subject: [PATCH] Add client state diagram to Materialize docs. --- pages/authzed/concepts/authzed-materialize.mdx | 6 ++++++ .../images/materialize-client-state-diagram.png | Bin 0 -> 37534 bytes 2 files changed, 6 insertions(+) create mode 100644 public/images/materialize-client-state-diagram.png diff --git a/pages/authzed/concepts/authzed-materialize.mdx b/pages/authzed/concepts/authzed-materialize.mdx index c5010ecf..7b95f609 100644 --- a/pages/authzed/concepts/authzed-materialize.mdx +++ b/pages/authzed/concepts/authzed-materialize.mdx @@ -587,6 +587,12 @@ When this error is returned, it indicates the client should restart [LookupPermi Every previously stored data should also be discarded. If the volume of data to ingest via [LookupPermissionSets] is large enough it takes many hours to consume, please get in touch with AuthZed support to tweak your instance accordingly. +### Managing Client State + +This diagram shows the various states your client application will need to transition through when calling the [LookupPermissionSets] and the [WatchPermissionSets] APIs. + +![authzed-materialize](/images/materialize-client-state-diagram.png) + [WatchPermissionSets]: https://buf.build/authzed/api/docs/v1.35.0:authzed.api.materialize.v0#authzed.api.materialize.v0.WatchPermissionSetsService.WatchPermissionSets [LookupPermissionSets]: https://buf.build/authzed/api/docs/v1.35.0:authzed.api.materialize.v0#authzed.api.materialize.v0.WatchPermissionSetsService.LookupPermissionSets [LookupResources]: https://buf.build/authzed/api/docs/v1.35.0:authzed.api.v1#authzed.api.v1.PermissionsService.LookupResources diff --git a/public/images/materialize-client-state-diagram.png b/public/images/materialize-client-state-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..62b2d7d08230fb4c87df34f9d88a1c6499702310 GIT binary patch literal 37534 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 S%7+1PWN=Od#|QSlm;VGJ$I|Tp literal 0 HcmV?d00001