Implement WHMCS Addon Dashboard with API for stats and integrate billing provider logic

packages/contracts/src/whmcs.ts

@@ -268,3 +268,22 @@ export type WhmcsEventsAckRequest = z.infer<typeof whmcsEventsAckRequestSchema>;
 export type WhmcsEventsAckResponse = z.infer<typeof whmcsEventsAckResponseSchema>;
 export type WhmcsUsageResponse = z.infer<typeof whmcsUsageResponseSchema>;
 export type WhmcsUsageAdjustmentRequest = z.infer<typeof whmcsUsageAdjustmentRequestSchema>;
+
+export const whmcsDashboardStatsResponseSchema = z.object({
+  integrationId: z.string(),
+  billingProvider: z.enum(['internal', 'whmcs', 'stripe']),
+  moduleVersion: z.string(),
+  linkedClients: z.number().int(),
+  linkedServices: z.number().int(),
+  suspendedServices: z.number().int(),
+  terminatedServices: z.number().int(),
+  pendingEvents: z.number().int(),
+  deadLetterEvents: z.number().int(),
+  openReconciliationIssues: z.number().int(),
+  exportedUsagePeriods: z.number().int(),
+  eventsCursor: z.string().uuid().nullable(),
+  lastEventSyncAt: z.string().datetime().nullable(),
+  lastReconciliationAt: z.string().datetime().nullable(),
+});
+
+export type WhmcsDashboardStatsResponse = z.infer<typeof whmcsDashboardStatsResponseSchema>;