refactor progress

packages/api/src/user/repositories/IUserAccountRepository.tsx

@@ -0,0 +1,56 @@
+/*
+ * Copyright (C) 2026 Fluxer Contributors
+ *
+ * This file is part of Fluxer.
+ *
+ * Fluxer is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Fluxer is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with Fluxer. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import type {GuildID, UserID} from '@fluxer/api/src/BrandedTypes';
+import type {UserRow} from '@fluxer/api/src/database/types/UserTypes';
+import type {User} from '@fluxer/api/src/models/User';
+
+export interface IUserAccountRepository {
+	create(data: UserRow): Promise<User>;
+	upsert(data: UserRow, oldData?: UserRow | null): Promise<User>;
+	patchUpsert(userId: UserID, patchData: Partial<UserRow>, oldData?: UserRow | null): Promise<User>;
+	findUnique(userId: UserID): Promise<User | null>;
+	findUniqueAssert(userId: UserID): Promise<User>;
+	findByUsernameDiscriminator(username: string, discriminator: number): Promise<User | null>;
+	findDiscriminatorsByUsername(username: string): Promise<Set<number>>;
+	findByEmail(email: string): Promise<User | null>;
+	findByPhone(phone: string): Promise<User | null>;
+	findByStripeSubscriptionId(stripeSubscriptionId: string): Promise<User | null>;
+	findByStripeCustomerId(stripeCustomerId: string): Promise<User | null>;
+	listUsers(userIds: Array<UserID>): Promise<Array<User>>;
+	listAllUsersPaginated(limit: number, lastUserId?: UserID): Promise<Array<User>>;
+
+	getUserGuildIds(userId: UserID): Promise<Array<GuildID>>;
+
+	addPendingDeletion(userId: UserID, pendingDeletionAt: Date, deletionReasonCode: number): Promise<void>;
+	removePendingDeletion(userId: UserID, pendingDeletionAt: Date): Promise<void>;
+	findUsersPendingDeletion(now: Date): Promise<Array<User>>;
+	findUsersPendingDeletionByDate(deletionDate: string): Promise<Array<{user_id: bigint; deletion_reason_code: number}>>;
+	isUserPendingDeletion(userId: UserID, deletionDate: string): Promise<boolean>;
+	scheduleDeletion(userId: UserID, pendingDeletionAt: Date, deletionReasonCode: number): Promise<void>;
+
+	deleteUserSecondaryIndices(userId: UserID): Promise<void>;
+	removeFromAllGuilds(userId: UserID): Promise<void>;
+
+	updateLastActiveAt(params: {userId: UserID; lastActiveAt: Date; lastActiveIp?: string}): Promise<void>;
+	updateSubscriptionStatus(
+		userId: UserID,
+		updates: {premiumWillCancel: boolean; computedPremiumUntil: Date | null},
+	): Promise<{finalVersion: number | null}>;
+}