feat: initialize booster role bot with database and Discord integration

- Add drizzle configuration for SQLite database
- Create package.json with necessary dependencies and scripts
- Implement configuration loading for Discord bot
- Define permissions for roles
- Set up database schema for booster roles
- Create Discord client and commands for managing booster roles
- Handle guild member updates to manage roles based on boost status
- Implement boost eligibility checks and role management logic
- Add tests for boost eligibility and role guards
- Create service for managing booster roles with in-memory storage for testing
- Configure TypeScript settings for the project

src/services/boosterRoleService.ts

@@ -0,0 +1,124 @@
+import { assertBoostEligibility } from "../domain/boostEligibility";
+import {
+  assertRoleNameIsAvailable,
+  assertRolePositionIsSafe,
+  normalizeHexColor,
+  validateRoleName,
+  type ExistingRole
+} from "../domain/roleGuards";
+
+export type BoosterRoleRecord = {
+  guildId: string;
+  userId: string;
+  roleId: string;
+  name: string;
+  color: string | null;
+  createdAt: number;
+  updatedAt: number;
+};
+
+export type BoosterRoleStore = {
+  findByUser(guildId: string, userId: string): Promise<BoosterRoleRecord | null>;
+  create(record: BoosterRoleRecord): Promise<void>;
+  delete(guildId: string, userId: string): Promise<void>;
+};
+
+export type RoleRepository = {
+  listRoles(): Promise<ExistingRole[]>;
+  createRole(input: { name: string; color: string | null; permissions: string[]; position: number }): Promise<{ id: string }>;
+  updateRole(roleId: string, input: { name?: string; color?: string | null }): Promise<void>;
+  deleteRole(roleId: string): Promise<void>;
+};
+
+export type BoosterRoleServiceOptions = {
+  anchorPosition: number;
+  now?: () => number;
+};
+
+export class BoosterRoleService {
+  private readonly now: () => number;
+
+  constructor(
+    private readonly store: BoosterRoleStore,
+    private readonly roles: RoleRepository,
+    private readonly options: BoosterRoleServiceOptions
+  ) {
+    this.now = options.now ?? Date.now;
+  }
+
+  async claimRole(input: {
+    guildId: string;
+    userId: string;
+    name: string;
+    color: string | null;
+    verifiedBoostCount: number | null;
+  }): Promise<BoosterRoleRecord> {
+    const { guildId, userId, verifiedBoostCount } = input;
+    assertBoostEligibility({ verifiedBoostCount });
+
+    const existingRecord = await this.store.findByUser(guildId, userId);
+    if (existingRecord) {
+      throw new Error("User already has a booster role");
+    }
+
+    const name = validateRoleName(input.name);
+    const color = input.color ? normalizeHexColor(input.color) : null;
+    assertRoleNameIsAvailable(name, await this.roles.listRoles());
+
+    const position = this.options.anchorPosition - 1;
+    assertRolePositionIsSafe(position, this.options.anchorPosition);
+
+    const role = await this.roles.createRole({ name, color, permissions: [], position });
+    const timestamp = this.now();
+    const record = {
+      guildId,
+      userId,
+      roleId: role.id,
+      name,
+      color,
+      createdAt: timestamp,
+      updatedAt: timestamp
+    };
+
+    await this.store.create(record);
+    return record;
+  }
+
+  async renameRole(input: { guildId: string; userId: string; name: string }): Promise<void> {
+    const { guildId, userId } = input;
+    const record = await this.getUserRecord(guildId, userId);
+    const name = validateRoleName(input.name);
+    assertRoleNameIsAvailable(name, (await this.roles.listRoles()).filter((role) => role.id !== record.roleId));
+    await this.roles.updateRole(record.roleId, { name });
+  }
+
+  async recolorRole(input: { guildId: string; userId: string; color: string }): Promise<void> {
+    const { guildId, userId, color } = input;
+    const record = await this.getUserRecord(guildId, userId);
+    await this.roles.updateRole(record.roleId, { color: normalizeHexColor(color) });
+  }
+
+  async deleteRole(input: { guildId: string; userId: string }): Promise<void> {
+    const { guildId, userId } = input;
+    const record = await this.getUserRecord(guildId, userId);
+    await this.roles.deleteRole(record.roleId);
+    await this.store.delete(guildId, userId);
+  }
+
+  async removeRoleForLostBoost(input: { guildId: string; userId: string }): Promise<void> {
+    const { guildId, userId } = input;
+    const record = await this.store.findByUser(guildId, userId);
+    if (!record) return;
+
+    await this.roles.deleteRole(record.roleId);
+    await this.store.delete(guildId, userId);
+  }
+
+  private async getUserRecord(guildId: string, userId: string): Promise<BoosterRoleRecord> {
+    const record = await this.store.findByUser(guildId, userId);
+    if (!record) {
+      throw new Error("No booster role found for this user");
+    }
+    return record;
+  }
+}