Tipar resultados de queries de Sanity

[rolivencia]

Descripción

Existen consultas hacia Sanity hechas en los archivos story.service.ts, storylist.service.ts, content.service.ts y author.service.ts dentro del árbol de directorios de /api, los cuales pertenecen al "backend" de la aplicación.

Se requiere tipar los resultados de estas consultas para fortalecer la cobertura de tipado que posee el proyecto mediante la incorporación de Sanity TypeGen para la tarea. Deben evaluarse las consultas escritas en los archivos *.service.ts y *.query.ts y proceder al tipado de las mismas.

Criterios de aceptación

• Los resultados de las consultas hechas mediante el método client.fetch() en story.service.ts, storylist.service.ts, content.service.ts y author.service.ts deben ser tipados.
• Todas las consultas en GROQ definidas en los archivos /api/**/*.service.ts deben pasar a estar definidas en los archivos /api/**/*.query.ts correspondientes.
• Adicionalmente debe chequearse la nomenclatura de las funciones visitadas como parte de este issue, aprovechando la oportunidad para brindar mayor coherencia a los nombres de las funciones definidas en los services.

Tareas

• Agregar Sanity TypeGen para generación automática de tipos para queries. El primer sub-issue de esta lista que sea resuelto debe abordar la tarea de agregar la infraestructura necesaria para ejecutar Sanity TypeGen. (abordado en Agregar tipado en función fetchByAuthorSlug #832)
• Agregar tipado para fetches en /api/story/story.service.ts
  • Agregar tipado en función fetchByAuthorSlug #832
  • Agregar tipado en función fetchBySlug (ex-fetchForRead) #835
• Agregar tipado para fetches en /api/author/author.service.ts
  • Agregar tipado en función AuthorService -> getBySlug #833
• Agregar tipado para fetches en /api/content.service.ts
  • Agregar tipado en función fetchLandingPageContent #834
• Agregar tipado para fetches en /api/storylist.service.ts
  • Agregar tipado en función fetchPreview #836
  • Agregar tipado en función fetchStorylist #837
• Documentar el procedimiento de generar una query de GROQ con resultado tipado #866
• Agregar Github action que dispare un error en caso de que Sanity TypeGen encuentre diferencias con los tipos definidos.

Recursos

• Curso en Sanity Learn sobre tipado de queries en GROQ: https://www.sanity.io/learn/course/typescripted-content/generating-type-for-groq-query-results.

[Addin]

Asignado el issue a @luz-ojeda.

[rolivencia]

Agregado el recurso sugerido por @franciscohanna92. cc @luz-ojeda.

[luz-ojeda]

Lo tomo