feat(dashboard): add React foundation and overview

apps/dashboard/src/api/contracts.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+
+const activityItemSchema = z.object({
+  timestamp: z.number(),
+  type: z.enum(['sent', 'skipped', 'response', 'error', 'info', 'debug']),
+  message: z.string(),
+  recipient: z.string().optional(),
+  imageUrl: z.string().optional(),
+});
+
+export const botStatsSchema = z.object({
+  isRunning: z.boolean(),
+  dryRunMode: z.boolean(),
+  totalProcessed: z.number(),
+  totalMessagesSent: z.number(),
+  totalResponses: z.number(),
+  responseRate: z.number(),
+  messagesThisHour: z.number(),
+  maxMessagesPerHour: z.number(),
+  subreddits: z.array(z.object({ name: z.string(), type: z.enum(['image', 'chat']) })),
+  targetGenders: z.array(z.string()),
+  recentActivity: z.array(activityItemSchema),
+  invitationCooldown: z
+    .object({
+      until: z.number(),
+      reason: z.string(),
+      redditCode: z.string().nullable(),
+    })
+    .nullable(),
+});
+
+export const timersSchema = z.object({
+  nextMessageAvailableAt: z.number().nullable(),
+  hourlyResetAt: z.number(),
+  isHourlyLimitReached: z.boolean(),
+  messagesRemaining: z.number(),
+});
+
+export const controlResponseSchema = z.object({
+  success: z.literal(true),
+  running: z.boolean(),
+});
+
+export type BotStats = z.infer<typeof botStatsSchema>;
+export type Timers = z.infer<typeof timersSchema>;
+export type ControlResponse = z.infer<typeof controlResponseSchema>;