aboutsummaryrefslogtreecommitdiff
path: root/api/src/modules/tickets/tickets.schema.ts
blob: 43d94cfe96e96d9c1892c30bd84e30d05cddad32 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
/**
 * tickets.schema.ts
 *
 * Schemas Zod para validação de entrada e saída do módulo de tickets.
 * Usados tanto pelo Fastify (validação automática de requests)
 * quanto pelo TypeScript (inferência de tipos).
 */

import { z } from 'zod';
import { TICKET_PRIORITIES, TICKET_STATUSES } from '@/db/schema.js';

// ─── Criação de Ticket ────────────────────────────────────────────────────────

export const createTicketBodySchema = z.object({
  title: z
    .string({ required_error: 'Título é obrigatório' })
    .min(5, 'Título deve ter no mínimo 5 caracteres')
    .max(150, 'Título deve ter no máximo 150 caracteres')
    .trim(),

  description: z
    .string({ required_error: 'Descrição é obrigatória' })
    .min(10, 'Descrição deve ter no mínimo 10 caracteres')
    .trim(),

  priority: z.enum(TICKET_PRIORITIES).default('medium'),

  categoryId: z.number().int().positive().optional(),

  // Em uma implementação real, o creatorId viria do token JWT.
  // Por ora, aceita no body para facilitar o desenvolvimento iterativo.
  creatorId: z
    .number({ required_error: 'creatorId é obrigatório' })
    .int()
    .positive(),
});

export type CreateTicketBody = z.infer<typeof createTicketBodySchema>;

// ─── Listagem de Tickets (filtros + paginação) ────────────────────────────────

export const listTicketsQuerySchema = z.object({
  status:     z.enum(TICKET_STATUSES).optional(),
  priority:   z.enum(TICKET_PRIORITIES).optional(),
  assigneeId: z.coerce.number().int().positive().optional(),
  creatorId:  z.coerce.number().int().positive().optional(),
  categoryId: z.coerce.number().int().positive().optional(),

  // Paginação
  page:  z.coerce.number().int().min(1).default(1),
  limit: z.coerce.number().int().min(1).max(100).default(20),
});

export type ListTicketsQuery = z.infer<typeof listTicketsQuerySchema>;

// ─── Parâmetros de rota ───────────────────────────────────────────────────────

export const ticketParamsSchema = z.object({
  id: z.coerce.number().int().positive(),
});

export type TicketParams = z.infer<typeof ticketParamsSchema>;

// ─── Shape de resposta ────────────────────────────────────────────────────────

export const ticketResponseSchema = z.object({
  id:          z.number(),
  title:       z.string(),
  description: z.string(),
  status:      z.enum(TICKET_STATUSES),
  priority:    z.enum(TICKET_PRIORITIES),
  creatorId:   z.number(),
  assigneeId:  z.number().nullable(),
  categoryId:  z.number().nullable(),
  dueAt:       z.string().nullable(),
  resolvedAt:  z.string().nullable(),
  createdAt:   z.string(),
  updatedAt:   z.string(),
});

export const listTicketsResponseSchema = z.object({
  data:  z.array(ticketResponseSchema),
  meta: z.object({
    page:       z.number(),
    limit:      z.number(),
    total:      z.number(),
    totalPages: z.number(),
  }),
});