feat(bot): add household admin approval flow

packages/ports/src/household-config.ts

@@ -33,6 +33,13 @@ export interface HouseholdPendingMemberRecord {
   languageCode: string | null
 }
 
+export interface HouseholdMemberRecord {
+  householdId: string
+  telegramUserId: string
+  displayName: string
+  isAdmin: boolean
+}
+
 export interface RegisterTelegramHouseholdChatInput {
   householdName: string
   telegramChatId: string
@@ -86,4 +93,20 @@ export interface HouseholdConfigurationRepository {
   findPendingHouseholdMemberByTelegramUserId(
     telegramUserId: string
   ): Promise<HouseholdPendingMemberRecord | null>
+  ensureHouseholdMember(input: {
+    householdId: string
+    telegramUserId: string
+    displayName: string
+    isAdmin?: boolean
+  }): Promise<HouseholdMemberRecord>
+  getHouseholdMember(
+    householdId: string,
+    telegramUserId: string
+  ): Promise<HouseholdMemberRecord | null>
+  listPendingHouseholdMembers(householdId: string): Promise<readonly HouseholdPendingMemberRecord[]>
+  approvePendingHouseholdMember(input: {
+    householdId: string
+    telegramUserId: string
+    isAdmin?: boolean
+  }): Promise<HouseholdMemberRecord | null>
 }

packages/ports/src/index.ts

@@ -9,6 +9,7 @@ export {
   HOUSEHOLD_TOPIC_ROLES,
   type HouseholdConfigurationRepository,
   type HouseholdJoinTokenRecord,
+  type HouseholdMemberRecord,
   type HouseholdPendingMemberRecord,
   type HouseholdTelegramChatRecord,
   type HouseholdTopicBindingRecord,