feat(bot): add guided private prompts

packages/ports/src/index.ts

@@ -35,3 +35,9 @@ export type {
   SettlementSnapshotLineRecord,
   SettlementSnapshotRecord
 } from './finance'
+export {
+  TELEGRAM_PENDING_ACTION_TYPES,
+  type TelegramPendingActionRecord,
+  type TelegramPendingActionRepository,
+  type TelegramPendingActionType
+} from './telegram-pending-actions'

packages/ports/src/telegram-pending-actions.ts

@@ -0,0 +1,20 @@
+export const TELEGRAM_PENDING_ACTION_TYPES = ['anonymous_feedback'] as const
+
+export type TelegramPendingActionType = (typeof TELEGRAM_PENDING_ACTION_TYPES)[number]
+
+export interface TelegramPendingActionRecord {
+  telegramUserId: string
+  telegramChatId: string
+  action: TelegramPendingActionType
+  payload: Record<string, unknown>
+  expiresAt: Date | null
+}
+
+export interface TelegramPendingActionRepository {
+  upsertPendingAction(input: TelegramPendingActionRecord): Promise<TelegramPendingActionRecord>
+  getPendingAction(
+    telegramChatId: string,
+    telegramUserId: string
+  ): Promise<TelegramPendingActionRecord | null>
+  clearPendingAction(telegramChatId: string, telegramUserId: string): Promise<void>
+}