easyfact-shared

Tipos TypeScript, Zod schemas y constantes SII compartidos entre todos los paquetes de EasyFact.

Contenido

| Módulo | Exporta | |---|---| | constants/dte-tipos | TipoDte enum, TIPOS_DTE, TipoDteInfo | | constants/ambientes | Ambiente enum, SII_ENDPOINTS, SII_RUT_RECEPTOR | | constants/medios-pago | FormaPago enum | | constants/codigos-referencia | CodRef enum, TipoDocRefExtra enum | | constants/codigos-impuesto | CodigoImpuesto enum, IMPUESTOS | | schemas/common | rutSchema, dvSchema, rutCompletoSchema, montoClpSchema, fechaSiiSchema, comunaCodigoSchema, validateRut() | | schemas/boleta | boletaInputSchema, BoletaInput, sub-schemas y tipos | | schemas/nota-credito | notaCreditoInputSchema, NotaCreditoInput, NcReferencia | | types/dte | DteEmitido interface |

Uso desde easyfact-core

Durante desarrollo, referenciar vía file::

// easyfact-core/package.json
{
  "dependencies": {
    "easyfact-shared": "file:../easyfact-shared"
  }
}

O usar npm link:

cd easyfact-shared && npm link
cd ../easyfact-core && npm link easyfact-shared

A futuro se publicará en un registry privado (GitHub Packages o similar).

Desarrollo

npm install
npm run build      # compila a dist/
npm run dev        # modo watch
npm run typecheck  # solo verificación de tipos, sin emitir

Versionado

Seguimos semver estricto:

• patch (0.1.x): fixes, constantes nuevas sin breaking change
• minor (0.x.0): nuevos schemas o tipos sin breaking change
• major (x.0.0): breaking changes en schemas o tipos existentes

Roadmap de schemas

| Versión | DTE | |---|---| | v0.1 | Boleta Electrónica (39), Nota de Crédito (61) | | v0.2 | Factura Electrónica (33), Nota de Débito (56) | | v0.3 | Boleta Exenta (41), Factura Exenta (34) | | v0.4 | Guía de Despacho (52), Factura de Compra (46) | | v1.0 | Exportación (110, 111, 112), schemas validados contra tests de certificación SII |