Ps/introduce single user state (#7053)

* Specify state provider for currently active user

* Split active and single user States

UserStateProvider is still the mechanism to build each State object.
The SingleUserState is basically a repeat of GlobalState, but with
additional scoping.

* Fixup global state cache

* fix fakers to new interface

* Make userId available in single user state

* Split providers by dependency requirements

This allows usage of the single state provider in contexts that would
otherwise form circular dependencies.

* Offer convenience wrapper classes for common use

* Import for docs

* Bind wrapped methods

libs/common/src/platform/state/state.provider.ts

@@ -0,0 +1,21 @@
+import { UserId } from "../../types/guid";
+
+import { GlobalState } from "./global-state";
+// eslint-disable-next-line @typescript-eslint/no-unused-vars -- used in docs
+import { GlobalStateProvider } from "./global-state.provider";
+import { KeyDefinition } from "./key-definition";
+import { ActiveUserState, SingleUserState } from "./user-state";
+// eslint-disable-next-line @typescript-eslint/no-unused-vars -- used in docs
+import { ActiveUserStateProvider, SingleUserStateProvider } from "./user-state.provider";
+
+/** Convenience wrapper class for {@link ActiveUserStateProvider}, {@link SingleUserStateProvider},
+ * and {@link GlobalStateProvider}.
+ */
+export abstract class StateProvider {
+  /** @see{@link ActiveUserStateProvider.get} */
+  getActive: <T>(keyDefinition: KeyDefinition<T>) => ActiveUserState<T>;
+  /** @see{@link SingleUserStateProvider.get} */
+  getUser: <T>(userId: UserId, keyDefinition: KeyDefinition<T>) => SingleUserState<T>;
+  /** @see{@link GlobalStateProvider.get} */
+  getGlobal: <T>(keyDefinition: KeyDefinition<T>) => GlobalState<T>;
+}