@dojocoding/hacienda-mcp 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,75 @@
+# @dojocoding/hacienda-mcp
+
+## 0.4.0
+
+- Declare Node.js 22+ and public package metadata; verify installed TypeScript consumers and ship corrected upgrade documentation.
+- Report the package manifest version in CLI/MCP metadata instead of a hardcoded version.
+
+### Minor Changes
+
+- eaf7cff: Validate XML offline against the vendored Hacienda v4.4 schemas before submission.
+  Fix discount totals, reconcile summaries with detail, serialize sequence resets
+  and increments, and enforce concurrent API rate limits. Return nonzero CLI exit
+  codes for rejected submissions. MCP invoice creation requires the actual system
+  provider ID and validates generated documents; its JSON schema resource now
+  reflects the tool input schema.
+- 4e89886: Harden cancellation, submission deadlines, response/XML limits, certificate
+  readiness, secret-safe diagnostics and retry semantics. Fix standalone MCP ESM
+  startup and validate inputs before sequence allocation. Update security-sensitive
+  dependencies and add hostile-input, cryptographic, local HTTP lifecycle,
+  multiprocess sequence and installed-package regression suites.
+
+  Submission timeout now covers POST and polling; POST/PATCH are not automatically
+  retried. HTTP requests default to a 30-second deadline and reject redirects.
+  See docs/security-hardening.md for input caps and remaining trust boundaries.
+
+### Patch Changes
+
+- Updated dependencies [eaf7cff]
+- Updated dependencies [4e89886]
+  - @dojocoding/hacienda-sdk@0.4.0
+  - @dojocoding/hacienda-shared@0.4.0
+
+## 0.3.0
+
+### Minor Changes (BREAKING — pre-1.0)
+
+- `create_invoice` and `draft_invoice` tools and the `factura-schema` resource now speak the v4.4 contract (`proveedorSistemas`, `codigoActividadEmisor`, required emisor `ubicacion`, single `medioPago` code emitted inside `ResumenFactura`, `codigoTarifaIVA`, `codigoDescuento`, ID types 05/06). `unidadMedida` is validated against the official catalog and location fields enforce the v4.4 bounds.
+
+### Patch Changes
+
+- Updated dependencies
+  - @dojocoding/hacienda-sdk@0.3.0
+  - @dojocoding/hacienda-shared@0.3.0
+
+## 0.2.0
+
+### Minor Changes
+
+- Rename npm scope from `@hacienda-cr` to `@dojocoding` for DojoCoding ecosystem branding. All packages now published under the `@dojocoding` org. No API changes.
+
+### Patch Changes
+
+- Updated dependencies
+  - @dojocoding/hacienda-shared@0.2.0
+  - @dojocoding/hacienda-sdk@0.2.0
+
+## 0.1.0
+
+### Minor Changes
+
+- Initial public release of hacienda-cr — TypeScript SDK, CLI, and MCP Server for Costa Rica electronic invoicing (Hacienda API v4.4).
+
+  **@dojocoding/hacienda-shared** — Shared types, Zod schemas, and constants for all 7 document types, tax codes, and identification types.
+
+  **@dojocoding/hacienda-sdk** — Core SDK with OAuth2 authentication, 50-digit clave generation/parsing, XML builder, XAdES-EPES digital signing, API client with submission/polling, and document builders for all 7 electronic document types.
+
+  **@dojocoding/hacienda-cli** — `hacienda` CLI binary for login, invoice drafting, validation, signing, submission, status checking, and document listing.
+
+  **@dojocoding/hacienda-mcp** — MCP Server exposing invoice creation, status checking, document retrieval, taxpayer lookup, and reference data as AI-accessible tools and resources.
+
+### Patch Changes
+
+- Updated dependencies
+  - @dojocoding/hacienda-shared@0.1.0
+  - @dojocoding/hacienda-sdk@0.1.0

package/README.md

@@ -75,9 +75,10 @@ Create a Factura Electronica (electronic invoice). Accepts emisor, receptor, and
 
 - `emisor` -- Issuer information (name, ID, email)
 - `receptor` -- Receiver information (name, optional ID, optional email)
-- `codigoActividad` -- CABYS activity code (6 digits)
+- `codigoActividadEmisor` -- Issuer economic activity code (6 digits)
+- `proveedorSistemas` -- Actual invoicing-system provider ID (required; no issuer fallback)
 - `condicionVenta` -- Sale condition code (default: `"01"` = cash)
-- `medioPago` -- Payment methods array (default: `["01"]` = cash)
+- `medioPago` -- Payment method code (default: `"01"` = cash; emitted inside ResumenFactura per v4.4)
 - `lineItems` -- Array of line items with CABYS code, quantity, unit, description, price, and optional tax/discount
 - `plazoCredito` -- Credit term in days (optional)
 
@@ -132,7 +133,7 @@ Generate a draft invoice template with sensible defaults. Returns JSON that can
 - `receptorIdTipo` -- Receiver ID type (optional)
 - `receptorIdNumero` -- Receiver ID number (optional)
 - `receptorEmail` -- Receiver email (optional)
-- `codigoActividad` -- Activity code (default: `"620100"`)
+- `codigoActividadEmisor` -- Activity code (default: `"620100"`)
 - `description` -- Default line item description (default: `"Servicio profesional"`)
 - `amount` -- Default line item amount (default: `0`)
 - `includeIva` -- Include 13% IVA (default: `true`)
@@ -148,4 +149,8 @@ Generate a draft invoice template with sensible defaults. Returns JSON that can
 
 ## Full Documentation
 
-See the [root README](../../README.md) for comprehensive documentation with examples.
+See the [root README](https://github.com/DojoCodingLabs/hacienda-cr#readme) for comprehensive documentation with examples.
+
+## Migrating to 0.4.0
+
+Read the [migration guide](https://github.com/DojoCodingLabs/hacienda-cr/blob/main/packages/sdk/MIGRATION-v4.4.md) before upgrading.