Scalari Personalizați (Custom Scalars): DateTime, JSON și BigInt în GraphQL în GraphQL

Tipurile scalare de bază GraphQL (`Int`, `Float`, `String`, `Boolean`, `ID`) sunt adesea insuficiente pentru date reale complexe. Scalarii personalizați permit definirea unor tipuri precum `DateTime` (format ISO-8601), `JSON` (obiect arbitrar fără schemă) sau `BigInt` (numere mari de 64 de biți), incluzând validare strictă prin metodele `serialize`, `parseValue` și `parseLiteral` (parsare AST).

Validare și Serializare Tipizată la Nivel de Câmp

Garantează respingerea cererilor cu date calendaristice malformate înainte de a ajunge în funcțiile de rezolvare (resolvers).

import { GraphQLScalarType, Kind } from 'graphql';

export const DateTimeScalar = new GraphQLScalarType({
  name: 'DateTime',
  description: 'Reprezentare dată/oră în format ISO-8601',
  serialize(value: any) {
    return value instanceof Date ? value.toISOString() : null;
  },
  parseValue(value: any) {
    return new Date(value);
  },
  parseLiteral(ast) {
    if (ast.kind === Kind.STRING) {
      return new Date(ast.value);
    }
    return null;
  }
});

Utilizarea corectă a acestei funcționalități în arhitectura GraphQL garantează o comunicare optimă între client și server, elimină supra-încărcarea rețelei și asigură scalabilitatea sistemelor moderne.