Generador de código TSX desde archivos WSDL
npm install @karibulab/wsdl2tsxGenerador de código TypeScript/TSX desde archivos WSDL para crear componentes tipados que generan XML SOAP.
``bash`
npm install -g @karibulab/wsdl2tsx
O usar directamente con npx:
`bash`
npx @karibulab/wsdl2tsx
`bash`
wsdl2tsx
Ejemplos:
`bash`Generar todas las operaciones
wsdl2tsx http://ejemplo.com/servicio?wsdl ./output
`bash`Generar solo una operación específica
wsdl2tsx http://ejemplo.com/servicio?wsdl ./output --operation=ConsultaCodigoPlan
`bash`Con flag corto
wsdl2tsx http://ejemplo.com/servicio?wsdl ./output -o ConsultaCodigoPlan
- : URL o ruta local al archivo WSDL
- : Directorio donde se generarán los archivos TSX--operation=
- o -o (opcional): Especifica el nombre de la operación a generar. Si no se especifica, se generan todas las operaciones con input definido. El nombre debe coincidir exactamente con el nombre de la operación en el WSDL (no es case-sensitive).
- ✅ Genera componentes TypeScript/TSX tipados desde WSDL
- ✅ Soporta múltiples operaciones: Genera un archivo TSX por cada operación del WSDL
- ✅ Filtrado por operación: Permite generar solo una operación específica con --operation o -oelementFormDefault
- ✅ Respeta para manejo correcto de namespaces@karibulab/wsdl2tsx-runtime
- ✅ Genera interfaces TypeScript para todos los tipos complejos
- ✅ Soporta múltiples schemas y namespaces
- ✅ Maneja imports y referencias entre schemas
- ✅ Omite automáticamente operaciones sin input (notificaciones, solo-output)
- ✅ Genera código compatible con el runtime
El CLI genera un archivo TSX por cada operación definida en el WSDL. Por ejemplo:
`tsx
import { soap, ns } from "@karibulab/wsdl2tsx-runtime";
export interface ConsultaCodigoPlanProps {
codigoPlanList: CodigoPlanList;
}
export function ConsultaCodigoPlan(props: ConsultaCodigoPlanProps) {
return (
{/ XML generado automáticamente /}
);
}
`
- Node.js 18 o superior
- @karibulab/wsdl2tsx-runtime (se instala automáticamente como dependencia)
`bashClonar el repositorio
git clone https://github.com/KaribuLab/wsdl2tsx.git
cd wsdl2tsx
$3
- Operaciones sin input: Las operaciones que no tienen un nodo
input definido (como notificaciones o operaciones solo-output) se omiten automáticamente con una advertencia.
- Múltiples operaciones: Por defecto, el CLI procesa todas las operaciones válidas y genera un archivo por cada una.
- Filtrado: Usa --operation o -o` para generar solo una operación específica, útil cuando trabajas con WSDL grandes.ISC
https://github.com/KaribuLab/wsdl2tsx