simstudioai--sim/apps/sim/lib/api/contracts/tools/aws/dynamodb-query.ts

import { z } from 'zod'
import type {
  ContractBody,
  ContractBodyInput,
  ContractJsonResponse,
} from '@/lib/api/contracts/types'
import { defineRouteContract } from '@/lib/api/contracts/types'
import { validateAwsRegion } from '@/lib/core/security/input-validation'

const QuerySchema = z.object({
  region: z
    .string()
    .min(1, 'AWS region is required')
    .refine((v) => validateAwsRegion(v).isValid, {
      message: 'Invalid AWS region format (e.g., us-east-1, eu-west-2)',
    }),
  accessKeyId: z.string().min(1, 'AWS access key ID is required'),
  secretAccessKey: z.string().min(1, 'AWS secret access key is required'),
  tableName: z.string().min(1, 'Table name is required'),
  keyConditionExpression: z.string().min(1, 'Key condition expression is required'),
  filterExpression: z.string().optional(),
  expressionAttributeNames: z.record(z.string(), z.string()).optional(),
  expressionAttributeValues: z.record(z.string(), z.unknown()).optional(),
  indexName: z.string().optional(),
  limit: z.number().positive().optional(),
  exclusiveStartKey: z.record(z.string(), z.unknown()).optional(),
  scanIndexForward: z.boolean().optional(),
})

const QueryResponseSchema = z.object({
  message: z.string(),
  // untyped-response: DynamoDB Items are arbitrary user attribute-value records
  items: z.array(z.record(z.string(), z.unknown())),
  count: z.number(),
  // untyped-response: DynamoDB LastEvaluatedKey mirrors the table's primary key shape
  lastEvaluatedKey: z.record(z.string(), z.unknown()).optional(),
})

export const awsDynamodbQueryContract = defineRouteContract({
  method: 'POST',
  path: '/api/tools/dynamodb/query',
  body: QuerySchema,
  response: { mode: 'json', schema: QueryResponseSchema },
})
export type AwsDynamodbQueryRequest = ContractBodyInput<typeof awsDynamodbQueryContract>
export type AwsDynamodbQueryBody = ContractBody<typeof awsDynamodbQueryContract>
export type AwsDynamodbQueryResponse = ContractJsonResponse<typeof awsDynamodbQueryContract>