fix(tables): give the fold cron route a response contract

Author: TheodoreSpeaks

apps/sim/app/api/cron/fold-table-row-changes/route.ts

@@ -1,5 +1,10 @@
 import { createLogger } from '@sim/logger'
 import { type NextRequest, NextResponse } from 'next/server'
+import {
+  type FoldTableRowChangesResponse,
+  foldTableRowChangesContract,
+} from '@/lib/api/contracts/tables'
+import { parseRequest } from '@/lib/api/server/validation'
 import { verifyCronAuth } from '@/lib/auth/internal'
 import { withRouteHandler } from '@/lib/core/utils/with-route-handler'
 import { foldPendingTableRowChanges } from '@/lib/table/row-changes'
@@ -20,7 +25,11 @@ export const GET = withRouteHandler(async (request: NextRequest) => {
   const authError = verifyCronAuth(request, 'Table row-change fold')
   if (authError) return authError
 
+  const parsed = await parseRequest(foldTableRowChangesContract, request, {})
+  if (!parsed.success) return parsed.response
+
   const result = await foldPendingTableRowChanges(FOLD_SWEEP_BUDGET_MS)
   logger.info('Table row-change fold sweep completed', { ...result })
-  return NextResponse.json({ success: true, ...result })
+  const body: FoldTableRowChangesResponse = { success: true, ...result }
+  return NextResponse.json(body)
 })

apps/sim/lib/api/contracts/tables.ts

@@ -2326,3 +2326,18 @@ export const bulkDeleteTablesContract = defineRouteContract({
     ),
   },
 })
+
+const foldTableRowChangesResponseSchema = z.object({
+  success: z.literal(true),
+  folded: z.number().int().min(0),
+  skipped: z.number().int().min(0),
+  budgetExhausted: z.boolean(),
+})
+
+export type FoldTableRowChangesResponse = z.output<typeof foldTableRowChangesResponseSchema>
+
+export const foldTableRowChangesContract = defineRouteContract({
+  method: 'GET',
+  path: '/api/cron/fold-table-row-changes',
+  response: { mode: 'json', schema: foldTableRowChangesResponseSchema },
+})