retorna-typescript-sdk
v1.0.2
Published
Es un SDK diseñado para integrar de forma sencilla y segura los servicios B2B de Retorna dentro de aplicaciones Node.js y TypeScript. Permite a empresas realizar pagos, cobros, consultas de transacciones, conciliaciones, creación de órdenes y automatizaci
Readme
retorna-typescript-sdk
Es un SDK diseñado para integrar de forma sencilla y segura los servicios B2B de Retorna dentro de aplicaciones Node.js y TypeScript. Permite a empresas realizar pagos, cobros, consultas de transacciones, conciliaciones, creación de órdenes y automatización de flujos financieros mediante una interfaz unificada y fácil de usar.
Estructura del proyecto
src/index.ts: punto de entrada público del SDK.src/sdk: builder (RetornaTypeScriptSDKConfigBuilder) y cliente (RetornaClient).src/clients: clientes HTTP por dominio (accountypayout-order).src/core: utilitarios comunes (auth, http firmado, logging, config de entornos y retiros).src/models: DTOs y validadores específicos de payout.examples/full-flow.ts: ejemplo completo de autenticación, cotización y creación de órdenes.tests/unit: pruebas unitarias ejecutables conts-node.
Scripts útiles
npm run build: compila adist/.npm run typecheck: verifica tipos sin emitir código.npm test: ejecuta typecheck y todas las pruebas unitarias.npm run devonpm run examples:full: ejecuta el ejemplo completo conts-node(requiere variables de entornoRETORNA_CLIENT_ID,RETORNA_CLIENT_SECRET,RETORNA_PRIVATE_KEYy opcionalmenteRETORNA_ENV).
