simstudioai--sim/apps/sim/lib/api/contracts/v1/logs.ts

import { z } from 'zod'
import { booleanQueryFlagSchema } from '@/lib/api/contracts/primitives'
import { defineRouteContract } from '@/lib/api/contracts/types'

export const v1LogParamsSchema = z.object({
  id: z.string().min(1),
})

export const v1ExecutionParamsSchema = z.object({
  executionId: z.string().min(1),
})

export const v1ListLogsQuerySchema = z.object({
  workspaceId: z.string().min(1),
  workflowIds: z.string().optional(),
  folderIds: z.string().optional(),
  triggers: z.string().optional(),
  level: z.enum(['info', 'error']).optional(),
  startDate: z.string().optional(),
  endDate: z.string().optional(),
  executionId: z.string().optional(),
  minDurationMs: z.coerce.number().optional(),
  maxDurationMs: z.coerce.number().optional(),
  minCost: z.coerce.number().optional(),
  maxCost: z.coerce.number().optional(),
  model: z.string().optional(),
  details: z.enum(['basic', 'full']).optional().default('basic'),
  includeTraceSpans: booleanQueryFlagSchema.optional().default(false),
  includeFinalOutput: booleanQueryFlagSchema.optional().default(false),
  // Clamp rather than reject: this limit was previously unbounded, so a hard
  // .max() would 400 existing consumers passing a larger value. Page size is
  // still capped to bound response size and materialization reads.
  limit: z.coerce
    .number()
    .optional()
    .default(100)
    .transform((v) => Math.min(Math.max(1, Math.trunc(v)), 1000)),
  cursor: z.string().optional(),
  order: z.enum(['desc', 'asc']).optional().default('desc'),
})

const v1ApiResponseWithLimitsSchema = z
  .object({
    limits: z.unknown().optional(),
  })
  .passthrough()

export type V1ListLogsQuery = z.output<typeof v1ListLogsQuerySchema>
export type V1LogParams = z.output<typeof v1LogParamsSchema>
export type V1ExecutionParams = z.output<typeof v1ExecutionParamsSchema>

export const v1ListLogsContract = defineRouteContract({
  method: 'GET',
  path: '/api/v1/logs',
  query: v1ListLogsQuerySchema,
  response: {
    mode: 'json',
    schema: v1ApiResponseWithLimitsSchema,
  },
})

export const v1GetLogContract = defineRouteContract({
  method: 'GET',
  path: '/api/v1/logs/[id]',
  params: v1LogParamsSchema,
  response: {
    mode: 'json',
    schema: v1ApiResponseWithLimitsSchema,
  },
})

export const v1GetExecutionContract = defineRouteContract({
  method: 'GET',
  path: '/api/v1/logs/executions/[executionId]',
  params: v1ExecutionParamsSchema,
  response: {
    mode: 'json',
    schema: v1ApiResponseWithLimitsSchema,
  },
})