feat: support external $ref resolution in OpenAPI loader
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Aptitud para principiantes
- 52/100
- Tipo de issue
- Nueva funcionalidad
- Claridad
- Bastante claro
- Estado de actividad
- Tranquilo
- Stack tecnológico
- openapi, typescript
- Área
- api
Línea de trabajo
Comienza en src/lib/openapi.ts siguiendo el manejo de $ref externos y la conversión de V2→V3. Comprueba cómo se resuelven las referencias en relación con el archivo de especificación y verifica después que consumes/produces se conviertan en entradas de content-type y que se cubran las carencias de conversión indicadas. El trabajo estará terminado cuando las referencias externas ya no queden sin resolver en la documentación de API renderizada y se conserven los campos V2 especificados.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Problem
`src/lib/openapi.ts` only resolves internal `#/` JSON pointer references. External file references (e.g. `$ref: './common/errors.yaml'`) fail silently, resulting in unresolved `$ref` objects appearing in the rendered API docs.
The V2→V3 conversion is also incomplete:
- Ignores `consumes`/`produces` fields (assumes JSON for everything)
- Doesn't convert all security scheme types
- Missing request/response examples
Suggested Fix
- For external file refs, resolve relative to the spec file's directory
- For the V2 conversion, carry over `consumes`/`produces` as content type entries in V3 request/response objects
- Lenguaje dominante
- TypeScript
- Estrellas
- 2
- Forks
- 1
- Merge medio
- 12 min
- PR fusionados (30 d)
- 1
Preparar el entorno
- Incluye un Dockerfile o un archivo de Docker Compose
- Sin plantilla de pull request
- Sin guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de raystack/chronicle
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 78/100
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 84/100
-
Dificultad 4/5 3-5 días Aptitud para principiantes 65/100
-
Dificultad 4/5 3-5 días Aptitud para principiantes 48/100
Todos los issues de raystack/chronicle
Issues similares
-
A hung CI job runs for 6 hours before it is cancelledPosiblemente ocupada @Olanetsoft la tomó hoy. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
Olanetsoft/agent-lookout#110 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
thedotmack/claude-mem#4757 ·
Los mantenedores suelen responder en 1 día
-
🐛 bug 🗺️ MCP OAuth
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
LibreChat-AI/LibreChat#17077 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 75/100