[PM-6789] finish key rotation distribution and fix legacy user (#9498)

* finish key rotation distribution and fix legacy user

* add ticket to TODO

* PR feedback: docs and renaming

* fix webauthn tests

* add test for send service

* add await to test

libs/common/src/vault/abstractions/folder/folder.service.abstraction.ts

@@ -1,11 +1,16 @@
 import { Observable } from "rxjs";
 
+import { UserKeyRotationDataProvider } from "@bitwarden/auth/common";
+
 import { SymmetricCryptoKey } from "../../../platform/models/domain/symmetric-crypto-key";
+import { UserId } from "../../../types/guid";
+import { UserKey } from "../../../types/key";
 import { FolderData } from "../../models/data/folder.data";
 import { Folder } from "../../models/domain/folder";
+import { FolderWithIdRequest } from "../../models/request/folder-with-id.request";
 import { FolderView } from "../../models/view/folder.view";
 
-export abstract class FolderService {
+export abstract class FolderService implements UserKeyRotationDataProvider<FolderWithIdRequest> {
   folders$: Observable<Folder[]>;
   folderViews$: Observable<FolderView[]>;
 
@@ -22,6 +27,19 @@ export abstract class FolderService {
    */
   getAllDecryptedFromState: () => Promise<FolderView[]>;
   decryptFolders: (folders: Folder[]) => Promise<FolderView[]>;
+  /**
+   * Returns user folders re-encrypted with the new user key.
+   * @param originalUserKey the original user key
+   * @param newUserKey the new user key
+   * @param userId the user id
+   * @throws Error if new user key is null
+   * @returns a list of user folders that have been re-encrypted with the new user key
+   */
+  getRotatedData: (
+    originalUserKey: UserKey,
+    newUserKey: UserKey,
+    userId: UserId,
+  ) => Promise<FolderWithIdRequest[]>;
 }
 
 export abstract class InternalFolderService extends FolderService {