fix(bot): harden webhook processing and purchase defaults

packages/ports/src/index.ts

@@ -6,6 +6,12 @@ export {
   type ReminderTarget,
   type ReminderType
 } from './reminders'
+export type {
+  ClaimProcessedBotMessageInput,
+  ClaimProcessedBotMessageResult,
+  ProcessedBotMessageRepository,
+  ReleaseProcessedBotMessageInput
+} from './processed-bot-messages'
 export {
   HOUSEHOLD_TOPIC_ROLES,
   type HouseholdConfigurationRepository,

packages/ports/src/processed-bot-messages.ts

@@ -0,0 +1,21 @@
+export interface ClaimProcessedBotMessageInput {
+  householdId: string
+  source: string
+  sourceMessageKey: string
+  payloadHash?: string | null
+}
+
+export interface ClaimProcessedBotMessageResult {
+  claimed: boolean
+}
+
+export interface ReleaseProcessedBotMessageInput {
+  householdId: string
+  source: string
+  sourceMessageKey: string
+}
+
+export interface ProcessedBotMessageRepository {
+  claimMessage(input: ClaimProcessedBotMessageInput): Promise<ClaimProcessedBotMessageResult>
+  releaseMessage(input: ReleaseProcessedBotMessageInput): Promise<void>
+}