[PM-7289] implement generator libraries (#9549)

This is a copy of the files. The source in `@bitwarden/common` will be deleted once
all of the applications have been ported to the library.

libs/tools/generator/extensions/src/navigation/generator-navigation.service.abstraction.ts

@@ -0,0 +1,42 @@
+import { Observable } from "rxjs";
+
+import { UserId } from "@bitwarden/common/types/guid";
+import { PolicyEvaluator } from "@bitwarden/generator-core";
+
+import { GeneratorNavigation } from "./generator-navigation";
+import { GeneratorNavigationPolicy } from "./generator-navigation-policy";
+
+/** Loads and stores generator navigational data
+ */
+export abstract class GeneratorNavigationService {
+  /** An observable monitoring the options saved to disk.
+   *  The observable updates when the options are saved.
+   *   @param userId: Identifies the user making the request
+   */
+  options$: (userId: UserId) => Observable<GeneratorNavigation>;
+
+  /** Gets the default options. */
+  defaults$: (userId: UserId) => Observable<GeneratorNavigation>;
+
+  /** An observable monitoring the options used to enforce policy.
+   *  The observable updates when the policy changes.
+   *  @param userId: Identifies the user making the request
+   */
+  evaluator$: (
+    userId: UserId,
+  ) => Observable<PolicyEvaluator<GeneratorNavigationPolicy, GeneratorNavigation>>;
+
+  /** Enforces the policy on the given options
+   * @param userId: Identifies the user making the request
+   * @param options the options to enforce the policy on
+   * @returns a new instance of the options with the policy enforced
+   */
+  enforcePolicy: (userId: UserId, options: GeneratorNavigation) => Promise<GeneratorNavigation>;
+
+  /** Saves the navigation options to disk.
+   * @param userId: Identifies the user making the request
+   * @param options the options to save
+   * @returns a promise that resolves when the options are saved
+   */
+  saveOptions: (userId: UserId, options: GeneratorNavigation) => Promise<void>;
+}