@albertomarturelo/sii-core 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -4,6 +4,78 @@ All notable changes to `@albertomarturelo/sii-core` are documented here. The for
 loosely based on [Keep a Changelog](https://keepachangelog.com/); the package is
 pre-1.0, so MINOR bumps may carry breaking changes (pin or use `~` downstream).
 
+## 0.8.0 — 2026-09-09
+
+### Added
+
+- **The Portal MIPYME DTE surface — borradores, preview and emitted documents (#90, #91,
+  ADR-023).** SII's own FREE facturación portal (`Portal001` CGIs), reached with the Clave
+  alone. New tasks: `dteEmpresas`, `dteBorradorList`, `dteBorradorSave`,
+  `dteBorradorDelete`, `dtePreviewPdf`, `dteEmitidos`, `dtePdf`, plus `TIPOS_DTE` and
+  `MAX_ITEMS`. DTE **33** and **34** wired; more types arrive as a `--tipo` parameter, not
+  as new verbs (ADR-024).
+- **BORRADORES ONLY — emission is deliberately out of scope (ADR-023).** Signing on this
+  portal is SERVER-SIDE (`mipeGenXMLFirma.cgi`, no certificado digital required), so a
+  Clave alone would be enough to issue a legally binding factura. `mipeGenXMLFirma.cgi` is
+  never called from this codebase, and a test asserts its absence from the compiled output.
+  Everything needed to *prepare* a document is automated; the one irreversible click stays
+  with a human in SII's own UI, one navigation away from any borrador this writes.
+- **A third authorization mode: EMPRESA-KEYED (ADR-023).** Besides body-RUT (RCV) and
+  session-keyed (F22/F29/BTE), the MIPYME portal keeps its OWN authorized-empresa list
+  (`mipeSelEmpresa.cgi` — the empresas that registered this user as *usuario autorizado*),
+  which is neither the operate pointer's operable set nor the session principal. `empresa`
+  is validated against that LIVE list and re-selected before every operation, since the
+  choice scopes the form, the borrador CRUD and the listing. An unknown RUT fails with the
+  available list.
+- **Single-empresa accounts resolve instead of failing (#95).** Such an account gets no
+  chooser at all — SII answers a JS launcher — so the empresa is read off the form's DTE
+  header box and nothing is POSTed. `parseChooser` returns a `launcher` / `chooser` /
+  `sinAutorizacion` shape rather than assuming a `<select>`.
+- **SII's own validator judges the document, in-page, before anything is POSTed
+  (ADR-023).** The factura form ships `validaFacEx()`; it is run via `evaluate` with
+  `window.alert` captured, and its Spanish refusals surface VERBATIM (ADR-004). It produces
+  exactly the refusals the server would bounce, so an invalid document never costs a round
+  trip — posting past it was observed to redirect back to the form with the same alert.
+- **A draft is a write, but not a destructive one (ADR-023).** `dteBorradorSave` is
+  reversible and legally inert, so it carries no double-entry confirm and no
+  `destructiveHint` — that ceremony (ADR-017) is for the irreversible step. The DELETE is
+  gated instead.
+- **The preview PDF and the emitted document follow the ADR-022 descriptor contract.**
+  `mipePreView.cgi` (stamped "VISTA PREVIA · DOCUMENTO NO VALIDO", no folio) and
+  `mipeDisplayPDF.cgi?DHDR_CODIGO=` are fetched with `requestBinary`, written through
+  `FileSink`, and the task returns `{path, archivo, bytes, …}` — never the bytes. The local
+  filename is composed here: SII's `Content-Disposition` carries only the RUT.
+- **`PortalSession.requestForm`** now backs the borrador CRUD (`mipeGrabaBorrador` /
+  `mipeEliminaBorrador`, `ES_BORR=TRUE`); the borradores listing is a bare JSON array on
+  www4 with no SDI envelope, and the emitted listing is ISO-8859-1 HTML whose rows are
+  MALFORMED — SII never closes the receptor cell — so it is parsed by anchor + `<td` split,
+  never with a strict parser.
+- **PII posture.** Curated rows, **NO `raw`** anywhere on this surface (a row is counterparty
+  identity, ADR-004). The audit records the empresa RUT, the borrador id or folio and row
+  counts — never the counterparty, the amounts or free text.
+
+### Fixed
+
+- **`parseEmitidas` no longer drops blank cells before mapping the row by index (#92).** A
+  `PRV` (vista previa) document has no folio, so its folio cell comes back blank; filtering
+  it slid every later column one place left — fecha into folio
+  (`Number('2026-09-08')` ⇒ `NaN` ⇒ `null` once serialised), monto into fecha, estado into
+  monto — producing a plausible row with the values under the wrong names and raising
+  nothing. Cells now map positionally, a blank one reads as `null`, and a row whose cell
+  count is not EXACTLY the observed seven raises "scraper roto" (exact rather than a
+  minimum: a blank cell *before* the receptor RUT shifts the row just as badly). `cellText`
+  folds `&nbsp;` into whitespace so a spacer-only cell is a blank cell. Shipped unreleased,
+  so no published version carried the mislabelling.
+
+### Changed
+
+- **Surfaces are named by SII artifact (ADR-024).** The MIPYME work landed under a
+  `factura` verb and was folded into `dte` before release: a factura is DTE 33, and the
+  artifact already had a verb. `portal/factura.ts` → `portal/dte-mipyme.ts`,
+  `tasks/factura.ts` → `tasks/dte.ts`. Nothing published ever exposed `factura`, so this
+  breaks no consumer. `ROADMAP.md` § "Where a new surface goes" is now the placement table
+  a new verb is checked against.
+
 ## 0.7.0 — 2026-08-31
 
 ### Breaking

package/dist/config/config.d.ts

@@ -15,6 +15,16 @@ export declare const HOSTS: {
      *  the SDI-JSON facade. The `.sii.cl` session cookie SSO-carries here (observed
      *  2026-06-30). Session-keyed (`rut_arrastre` = the principal). (#20 / ADR-004) */
     readonly bheCgi: "https://loa.sii.cl/cgi_IMT";
+    /** MIPYME — the SII's FREE facturación electrónica portal (`Portal001` CGIs). The
+     *  factura form (`mipeGenFacEx.cgi`), the borrador CRUD (`mipeGrabaBorrador.cgi` /
+     *  `mipeEliminaBorrador.cgi`), the preview (`mipeDisplayPreView.cgi`) and the empresa
+     *  chooser (`mipeSelEmpresa.cgi`) all live here. The `.sii.cl` session cookie
+     *  SSO-carries (observed 2026-09-08). EMPRESA-KEYED: the working empresa is chosen by
+     *  POSTing `mipeSelEmpresa.cgi`, not by the operate pointer. (#89 / ADR-023) */
+    readonly mipeCgi: "https://www1.sii.cl/cgi-bin/Portal001";
+    /** Static assets of the same MIPYME portal (`PreViewFrame.html`, the JS). Separate from
+     *  `mipeCgi` because it is NOT under `/cgi-bin`. (#89 / ADR-023) */
+    readonly mipeStatic: "https://www1.sii.cl/Portal001";
     /** SISPAD — peticiones administrativas. A GWT-RPC app: `text/x-gwt-rpc` POST to
      *  `/sispadinternet/peticion` returns a `//OK[…]` object graph; reached via
      *  `PortalSession.requestText` (a cold authenticated POST), NOT the SDI-JSON facade.

package/dist/config/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,KAAK;IAChB,2FAA2F;;IAE3F,+FAA+F;;IAE/F,8FAA8F;;IAE9F,gGAAgG;;;IAGhG,+DAA+D;;IAE/D;;;uFAGmF;;IAEnF;;;;0BAIsB;;IAEtB;6FACyF;;;CAGjF,CAAC;AAEX,+EAA+E;AAC/E,eAAO,MAAM,UAAU,iBAAiB,CAAC;AAEzC,yCAAyC;AACzC,eAAO,MAAM,SAAS,QAAqC,CAAC;AAE5D,oFAAoF;AACpF,eAAO,MAAM,UAAU,QAAsC,CAAC;AAE9D,MAAM,WAAW,QAAQ;IACvB,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,eAAO,MAAM,gBAAgB,EAAE,QAG9B,CAAC;AAEF,yFAAyF;AACzF,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,KAAK;IAChB,2FAA2F;;IAE3F,+FAA+F;;IAE/F,8FAA8F;;IAE9F,gGAAgG;;;IAGhG,+DAA+D;;IAE/D;;;uFAGmF;;IAEnF;;;;;oFAKgF;;IAEhF;wEACoE;;IAEpE;;;;0BAIsB;;IAEtB;6FACyF;;;CAGjF,CAAC;AAEX,+EAA+E;AAC/E,eAAO,MAAM,UAAU,iBAAiB,CAAC;AAEzC,yCAAyC;AACzC,eAAO,MAAM,SAAS,QAAqC,CAAC;AAE5D,oFAAoF;AACpF,eAAO,MAAM,UAAU,QAAsC,CAAC;AAE9D,MAAM,WAAW,QAAQ;IACvB,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,eAAO,MAAM,gBAAgB,EAAE,QAG9B,CAAC;AAEF,yFAAyF;AACzF,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/config/config.js

@@ -18,6 +18,16 @@ export const HOSTS = {
      *  the SDI-JSON facade. The `.sii.cl` session cookie SSO-carries here (observed
      *  2026-06-30). Session-keyed (`rut_arrastre` = the principal). (#20 / ADR-004) */
     bheCgi: 'https://loa.sii.cl/cgi_IMT',
+    /** MIPYME — the SII's FREE facturación electrónica portal (`Portal001` CGIs). The
+     *  factura form (`mipeGenFacEx.cgi`), the borrador CRUD (`mipeGrabaBorrador.cgi` /
+     *  `mipeEliminaBorrador.cgi`), the preview (`mipeDisplayPreView.cgi`) and the empresa
+     *  chooser (`mipeSelEmpresa.cgi`) all live here. The `.sii.cl` session cookie
+     *  SSO-carries (observed 2026-09-08). EMPRESA-KEYED: the working empresa is chosen by
+     *  POSTing `mipeSelEmpresa.cgi`, not by the operate pointer. (#89 / ADR-023) */
+    mipeCgi: 'https://www1.sii.cl/cgi-bin/Portal001',
+    /** Static assets of the same MIPYME portal (`PreViewFrame.html`, the JS). Separate from
+     *  `mipeCgi` because it is NOT under `/cgi-bin`. (#89 / ADR-023) */
+    mipeStatic: 'https://www1.sii.cl/Portal001',
     /** SISPAD — peticiones administrativas. A GWT-RPC app: `text/x-gwt-rpc` POST to
      *  `/sispadinternet/peticion` returns a `//OK[…]` object graph; reached via
      *  `PortalSession.requestText` (a cold authenticated POST), NOT the SDI-JSON facade.

package/dist/config/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,gFAAgF;AAChF,6DAA6D;AAE7D,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,2FAA2F;IAC3F,KAAK,EAAE,sBAAsB;IAC7B,+FAA+F;IAC/F,SAAS,EAAE,mDAAmD;IAC9D,8FAA8F;IAC9F,UAAU,EAAE,6BAA6B;IACzC,gGAAgG;IAChG,KAAK,EAAE,6CAA6C;IACpD,MAAM,EAAE,oBAAoB;IAC5B,+DAA+D;IAC/D,SAAS,EAAE,qBAAqB;IAChC;;;uFAGmF;IACnF,MAAM,EAAE,4BAA4B;IACpC;;;;0BAIsB;IACtB,MAAM,EAAE,oCAAoC;IAC5C;6FACyF;IACzF,KAAK,EAAE,uBAAuB;IAC9B,UAAU,EAAE,sDAAsD;CAC1D,CAAC;AAEX,+EAA+E;AAC/E,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,CAAC;AAEzC,yCAAyC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;AAE5D,oFAAoF;AACpF,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;AAS9D,MAAM,CAAC,MAAM,gBAAgB,GAAa;IACxC,YAAY,EAAE,CAAC;IACf,iBAAiB,EAAE,EAAE;CACtB,CAAC;AAEF,yFAAyF;AACzF,MAAM,UAAU,QAAQ,CAAC,WAAmB;IAC1C,OAAO,GAAG,SAAS,IAAI,WAAW,EAAE,CAAC;AACvC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,gFAAgF;AAChF,6DAA6D;AAE7D,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,2FAA2F;IAC3F,KAAK,EAAE,sBAAsB;IAC7B,+FAA+F;IAC/F,SAAS,EAAE,mDAAmD;IAC9D,8FAA8F;IAC9F,UAAU,EAAE,6BAA6B;IACzC,gGAAgG;IAChG,KAAK,EAAE,6CAA6C;IACpD,MAAM,EAAE,oBAAoB;IAC5B,+DAA+D;IAC/D,SAAS,EAAE,qBAAqB;IAChC;;;uFAGmF;IACnF,MAAM,EAAE,4BAA4B;IACpC;;;;;oFAKgF;IAChF,OAAO,EAAE,uCAAuC;IAChD;wEACoE;IACpE,UAAU,EAAE,+BAA+B;IAC3C;;;;0BAIsB;IACtB,MAAM,EAAE,oCAAoC;IAC5C;6FACyF;IACzF,KAAK,EAAE,uBAAuB;IAC9B,UAAU,EAAE,sDAAsD;CAC1D,CAAC;AAEX,+EAA+E;AAC/E,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,CAAC;AAEzC,yCAAyC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;AAE5D,oFAAoF;AACpF,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;AAS9D,MAAM,CAAC,MAAM,gBAAgB,GAAa;IACxC,YAAY,EAAE,CAAC;IACf,iBAAiB,EAAE,EAAE;CACtB,CAAC;AAEF,yFAAyF;AACzF,MAAM,UAAU,QAAQ,CAAC,WAAmB;IAC1C,OAAO,GAAG,SAAS,IAAI,WAAW,EAAE,CAAC;AACvC,CAAC"}

package/dist/errors/errors.d.ts

@@ -58,7 +58,11 @@ export declare class PeticionesError extends SiiError {
  *  the network/CGI failed, a non-200 came back, or the portal HTML changed shape
  *  ("scraper roto"). A RUT that is simply not a DTE emisor is NOT this error: it is a
  *  clean negative result (`autorizado: false` + SII's verbatim message). Fail loud,
- *  never retry (ADR-004 / ADR-014). */
+ *  never retry (ADR-004 / ADR-014).
+ *  Also the MIPYME portal surface (ADR-023 / ADR-024): SII rejected a borrador operation, its
+ *  own client-side validator refused the document (surfaced VERBATIM), or the portal form
+ *  changed shape. Empresa-keyed. Never retried after a SII error; a `LOGIN_HOST` bounce is
+ *  `SessionExpiredError`, not this. */
 export declare class DteError extends SiiError {
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"AAIA,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED,mEAAmE;AACnE,qBAAa,qBAAsB,SAAQ,QAAQ;CAAG;AAEtD;;iEAEiE;AACjE,qBAAa,mBAAoB,SAAQ,qBAAqB;CAAG;AAEjE;+BAC+B;AAC/B,qBAAa,gBAAiB,SAAQ,QAAQ;CAAG;AAEjD,mFAAmF;AACnF,qBAAa,cAAe,SAAQ,QAAQ;CAAG;AAE/C,oFAAoF;AACpF,qBAAa,uBAAwB,SAAQ,QAAQ;CAAG;AAExD,mFAAmF;AACnF,qBAAa,eAAgB,SAAQ,QAAQ;CAAG;AAEhD;8EAC8E;AAC9E,qBAAa,mBAAoB,SAAQ,QAAQ;CAAG;AAEpD;uFACuF;AACvF,qBAAa,QAAS,SAAQ,QAAQ;CAAG;AAEzC;8EAC8E;AAC9E,qBAAa,QAAS,SAAQ,QAAQ;CAAG;AAEzC;;;wFAGwF;AACxF,qBAAa,QAAS,SAAQ,QAAQ;CAAG;AAEzC;;;eAGe;AACf,qBAAa,QAAS,SAAQ,QAAQ;CAAG;AAEzC;;;;;gFAKgF;AAChF,qBAAa,eAAgB,SAAQ,QAAQ;CAAG;AAEhD;;;;uCAIuC;AACvC,qBAAa,QAAS,SAAQ,QAAQ;CAAG"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"AAIA,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED,mEAAmE;AACnE,qBAAa,qBAAsB,SAAQ,QAAQ;CAAG;AAEtD;;iEAEiE;AACjE,qBAAa,mBAAoB,SAAQ,qBAAqB;CAAG;AAEjE;+BAC+B;AAC/B,qBAAa,gBAAiB,SAAQ,QAAQ;CAAG;AAEjD,mFAAmF;AACnF,qBAAa,cAAe,SAAQ,QAAQ;CAAG;AAE/C,oFAAoF;AACpF,qBAAa,uBAAwB,SAAQ,QAAQ;CAAG;AAExD,mFAAmF;AACnF,qBAAa,eAAgB,SAAQ,QAAQ;CAAG;AAEhD;8EAC8E;AAC9E,qBAAa,mBAAoB,SAAQ,QAAQ;CAAG;AAEpD;uFACuF;AACvF,qBAAa,QAAS,SAAQ,QAAQ;CAAG;AAEzC;8EAC8E;AAC9E,qBAAa,QAAS,SAAQ,QAAQ;CAAG;AAEzC;;;wFAGwF;AACxF,qBAAa,QAAS,SAAQ,QAAQ;CAAG;AAEzC;;;eAGe;AACf,qBAAa,QAAS,SAAQ,QAAQ;CAAG;AAEzC;;;;;gFAKgF;AAChF,qBAAa,eAAgB,SAAQ,QAAQ;CAAG;AAEhD;;;;;;;;uCAQuC;AACvC,qBAAa,QAAS,SAAQ,QAAQ;CAAG"}

package/dist/errors/errors.js

@@ -64,7 +64,11 @@ export class PeticionesError extends SiiError {
  *  the network/CGI failed, a non-200 came back, or the portal HTML changed shape
  *  ("scraper roto"). A RUT that is simply not a DTE emisor is NOT this error: it is a
  *  clean negative result (`autorizado: false` + SII's verbatim message). Fail loud,
- *  never retry (ADR-004 / ADR-014). */
+ *  never retry (ADR-004 / ADR-014).
+ *  Also the MIPYME portal surface (ADR-023 / ADR-024): SII rejected a borrador operation, its
+ *  own client-side validator refused the document (surfaced VERBATIM), or the portal form
+ *  changed shape. Empresa-keyed. Never retried after a SII error; a `LOGIN_HOST` bounce is
+ *  `SessionExpiredError`, not this. */
 export class DteError extends SiiError {
 }
 //# sourceMappingURL=errors.js.map

package/dist/errors/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,2EAA2E;AAC3E,kEAAkE;AAElE,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;CAAG;AAEtD;;iEAEiE;AACjE,MAAM,OAAO,mBAAoB,SAAQ,qBAAqB;CAAG;AAEjE;+BAC+B;AAC/B,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;CAAG;AAEjD,mFAAmF;AACnF,MAAM,OAAO,cAAe,SAAQ,QAAQ;CAAG;AAE/C,oFAAoF;AACpF,MAAM,OAAO,uBAAwB,SAAQ,QAAQ;CAAG;AAExD,mFAAmF;AACnF,MAAM,OAAO,eAAgB,SAAQ,QAAQ;CAAG;AAEhD;8EAC8E;AAC9E,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;CAAG;AAEpD;uFACuF;AACvF,MAAM,OAAO,QAAS,SAAQ,QAAQ;CAAG;AAEzC;8EAC8E;AAC9E,MAAM,OAAO,QAAS,SAAQ,QAAQ;CAAG;AAEzC;;;wFAGwF;AACxF,MAAM,OAAO,QAAS,SAAQ,QAAQ;CAAG;AAEzC;;;eAGe;AACf,MAAM,OAAO,QAAS,SAAQ,QAAQ;CAAG;AAEzC;;;;;gFAKgF;AAChF,MAAM,OAAO,eAAgB,SAAQ,QAAQ;CAAG;AAEhD;;;;uCAIuC;AACvC,MAAM,OAAO,QAAS,SAAQ,QAAQ;CAAG"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,2EAA2E;AAC3E,kEAAkE;AAElE,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;CAAG;AAEtD;;iEAEiE;AACjE,MAAM,OAAO,mBAAoB,SAAQ,qBAAqB;CAAG;AAEjE;+BAC+B;AAC/B,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;CAAG;AAEjD,mFAAmF;AACnF,MAAM,OAAO,cAAe,SAAQ,QAAQ;CAAG;AAE/C,oFAAoF;AACpF,MAAM,OAAO,uBAAwB,SAAQ,QAAQ;CAAG;AAExD,mFAAmF;AACnF,MAAM,OAAO,eAAgB,SAAQ,QAAQ;CAAG;AAEhD;8EAC8E;AAC9E,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;CAAG;AAEpD;uFACuF;AACvF,MAAM,OAAO,QAAS,SAAQ,QAAQ;CAAG;AAEzC;8EAC8E;AAC9E,MAAM,OAAO,QAAS,SAAQ,QAAQ;CAAG;AAEzC;;;wFAGwF;AACxF,MAAM,OAAO,QAAS,SAAQ,QAAQ;CAAG;AAEzC;;;eAGe;AACf,MAAM,OAAO,QAAS,SAAQ,QAAQ;CAAG;AAEzC;;;;;gFAKgF;AAChF,MAAM,OAAO,eAAgB,SAAQ,QAAQ;CAAG;AAEhD;;;;;;;;uCAQuC;AACvC,MAAM,OAAO,QAAS,SAAQ,QAAQ;CAAG"}

package/dist/index.d.ts

@@ -10,9 +10,9 @@ export { f22Status, f22Overview, f22Observaciones, f22Historial } from './tasks/
 export type { F22Estado, F22Declaraciones, F22Overview, F22Observaciones, F22Historial, F22Grupos, DeclaracionF22, CodigoF22, EventoF22, ObservacionF22, } from './tasks/f22.js';
 export { f29Formulario, f29Overview, f29Pdf, f29Status, F29_GRUPO_LABELS, F29_PDF_TIPOS, F29_PDF_TIPO_ARGS, } from './tasks/f29.js';
 export type { F29Formulario, F29Overview, F29OverviewArgs, MesF29, LineaF29, F29Grupo, F29Estado, F29Propuesta, CodigoF29, DeclaracionEstadoF29, DocumentoF29, F29PdfArgs, F29PdfResult, F29PdfTipo, F29PdfTipoArg, } from './tasks/f29.js';
-export { dteAuthorized } from './tasks/dte.js';
-export type { DteAutorizados, DteAutorizado } from './tasks/dte.js';
 export { bteList, bteEmitPreview, bteEmit } from './tasks/bte.js';
+export { dteAuthorized, dteEmpresas, dteBorradorList, dteBorradorSave, dteBorradorDelete, dtePreviewPdf, dteEmitidos, dtePdf, TIPOS_DTE, MAX_ITEMS, } from './tasks/dte.js';
+export type { DteAutorizados, DteAutorizado, DteBorradorArgs, DteBorradorRow, DteBorradorSaved, DteEmpresa, DteItem, DtePreviewDoc, DteEmitido, DteEmitidoDoc, DteEmitidosFiltro, EstadoEmitido, DteSelectAviso, DteTotales, FormaPago, TipoDte, } from './tasks/dte.js';
 export type { BteMensual, BteBoleta, BteTotales, BteSide, BteEmitArgs, BteEmitResult, BteEmitida, BtePreview, BteRetiene, BteLineaEmision, } from './tasks/bte.js';
 export { peticionesList } from './tasks/peticiones.js';
 export type { PeticionesResult, Peticion, EstadoPeticion } from './tasks/peticiones.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACnF,YAAY,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACzF,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EACV,UAAU,EACV,aAAa,EACb,UAAU,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,OAAO,GACR,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACxF,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,cAAc,EACd,SAAS,EACT,SAAS,EACT,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,EACb,WAAW,EACX,MAAM,EACN,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,aAAa,EACb,WAAW,EACX,eAAe,EACf,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,SAAS,EACT,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,OAAO,EACP,WAAW,EACX,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAKxF,YAAY,EACV,UAAU,EACV,SAAS,EACT,KAAK,EACL,sBAAsB,EACtB,uBAAuB,EACvB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,OAAO,EACP,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtD,cAAc,mBAAmB,CAAC;AAGlC,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -11,8 +11,8 @@ export { describeOperating, formatOperableEntry } from './identity/index.js';
 export { rcvSummary, rcvList, rcvListAll } from './tasks/rcv.js';
 export { f22Status, f22Overview, f22Observaciones, f22Historial } from './tasks/f22.js';
 export { f29Formulario, f29Overview, f29Pdf, f29Status, F29_GRUPO_LABELS, F29_PDF_TIPOS, F29_PDF_TIPO_ARGS, } from './tasks/f29.js';
-export { dteAuthorized } from './tasks/dte.js';
 export { bteList, bteEmitPreview, bteEmit } from './tasks/bte.js';
+export { dteAuthorized, dteEmpresas, dteBorradorList, dteBorradorSave, dteBorradorDelete, dtePreviewPdf, dteEmitidos, dtePdf, TIPOS_DTE, MAX_ITEMS, } from './tasks/dte.js';
 export { peticionesList } from './tasks/peticiones.js';
 // --- shared primitives ---
 export { Rut } from './rut/index.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,gFAAgF;AAChF,6EAA6E;AAE7E,uCAAuC;AACvC,mFAAmF;AACnF,mGAAmG;AACnG,gDAAgD;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAQnF,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEzF,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAUjE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAaxF,OAAO,EACL,aAAa,EACb,WAAW,EACX,MAAM,EACN,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAkBxB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAalE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAmBvD,4BAA4B;AAC5B,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtD,cAAc,mBAAmB,CAAC;AAElC,2EAA2E;AAC3E,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,gFAAgF;AAChF,6EAA6E;AAE7E,uCAAuC;AACvC,mFAAmF;AACnF,mGAAmG;AACnG,gDAAgD;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAQnF,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEzF,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAUjE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAaxF,OAAO,EACL,aAAa,EACb,WAAW,EACX,MAAM,EACN,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAkBxB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EACL,aAAa,EACb,WAAW,EACX,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,MAAM,EACN,SAAS,EACT,SAAS,GACV,MAAM,gBAAgB,CAAC;AA+BxB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAmBvD,4BAA4B;AAC5B,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtD,cAAc,mBAAmB,CAAC;AAElC,2EAA2E;AAC3E,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC"}

package/dist/portal/dte-mipyme.d.ts

@@ -0,0 +1,228 @@
+import { Rut } from '../rut/index.js';
+import type { PortalSession } from '../seams/index.js';
+/** The DTE types the MIPYME portal exposes as their own `mipeLaunchPage` OPCION (observed
+ *  2026-09-08 on sii.cl/servicios_online/1039-1183.html). Only 33/34 are wired here — the
+ *  others need their own live capture before their extra fields can be trusted. */
+export declare const TIPOS_DTE: {
+    readonly 33: "Factura electrónica";
+    readonly 34: "Factura no afecta o exenta electrónica";
+};
+export type TipoDte = keyof typeof TIPOS_DTE;
+export declare const isTipoDte: (n: number) => n is TipoDte;
+/** SII's `EFXP_FMA_PAGO` codes (observed in the form's `<select>`). */
+export declare const FORMA_PAGO: {
+    readonly contado: "1";
+    readonly credito: "2";
+    readonly sin_costo: "3";
+};
+export type FormaPago = keyof typeof FORMA_PAGO;
+/** The grid's hard ceiling — the form's own `cantTotCol` (observed). */
+export declare const MAX_ITEMS = 10;
+/** An empresa the authenticated user may invoice for, as offered by `mipeSelEmpresa.cgi`. */
+export interface DteEmpresa {
+    readonly rut: string;
+    readonly nombre: string;
+}
+export interface DteReceptor {
+    readonly rut: string;
+    readonly dv: string;
+    readonly razonSocial: string;
+    readonly direccion: string;
+    readonly comuna: string;
+    readonly ciudad: string;
+    readonly giro: string;
+    readonly contacto?: string;
+}
+export interface DteItem {
+    readonly nombre: string;
+    readonly descripcion?: string;
+    readonly cantidad: number;
+    readonly unidad?: string;
+    readonly precioUnitario: number;
+    readonly descuentoPct?: number;
+}
+/** Everything the caller supplies. The EMISOR block (razón social, giro, domicilio, acteco,
+ *  sucursal) is read from the live form — except `ciudadEmisor`, which SII leaves BLANK yet
+ *  its own validation demands, so the caller must provide it (observed 2026-09-08). */
+export interface DteBorradorInput {
+    readonly empresa: string;
+    readonly tipoDte: TipoDte;
+    readonly fechaEmision: string;
+    readonly ciudadEmisor: string;
+    readonly receptor: DteReceptor;
+    readonly items: readonly DteItem[];
+    readonly formaPago: FormaPago;
+    /** Set to UPDATE an existing borrador in place; omit to create a new one. */
+    readonly borradorId?: string;
+}
+/** Server-side totals, computed by the form's own JS (so the arithmetic is SII's, not ours). */
+export interface DteTotales {
+    readonly neto: number;
+    readonly iva: number;
+    readonly total: number;
+}
+/** SII's `ESTADO` filter values on the emitted listing (observed in the form's <select>). */
+export declare const ESTADO_EMITIDO: {
+    readonly emitido: "EMI";
+    readonly preview: "PRV";
+};
+export type EstadoEmitido = keyof typeof ESTADO_EMITIDO;
+/** Filters the emitted listing accepts, all optional (observed as query params). */
+export interface DteEmitidosFiltro {
+    readonly tipoDoc?: number;
+    readonly estado?: EstadoEmitido;
+    readonly folio?: number;
+    readonly receptor?: string;
+    readonly desde?: string;
+    readonly hasta?: string;
+    readonly pagina?: number;
+}
+/** One emitted DTE — CURATED, no `raw` (the row is receptor identity, ADR-004). */
+export interface DteEmitido {
+    /** `DHDR_CODIGO` — SII's internal id and the key the PDF is fetched by. */
+    readonly codigo: string;
+    readonly receptorRut: string | null;
+    readonly receptorNombre: string | null;
+    readonly tipoDteDesc: string | null;
+    readonly folio: number | null;
+    readonly fecha: string | null;
+    readonly monto: number | null;
+    readonly estado: string | null;
+}
+/** One row of the borradores list — CURATED. */
+export interface DteBorradorRow {
+    readonly id: string;
+    readonly tipoDte: number;
+    readonly tipoDteDesc: string;
+    readonly fecha: string | null;
+    readonly receptorRut: string | null;
+    readonly receptorNombre: string | null;
+    readonly emisorNombre: string | null;
+    readonly iva: number | null;
+    readonly total: number | null;
+}
+/** What `mipeSelEmpresa.cgi` answers. THREE shapes observed, decided by how many empresas list
+ *  the account as "usuario autorizado":
+ *   * `chooser`         — two or more: the `RUT_EMP` select (observed 2026-09-08).
+ *   * `sinAutorizacion` — none: the same select with an EMPTY `<optgroup>` (observed 2026-09-09
+ *                         on an empresa account that is not itself a usuario autorizado).
+ *   * `launcher`        — exactly one: NO chooser at all — a 593-byte JS shim titled
+ *                         "Facturacion Electronica - Launcher" whose `start_pop()` jumps straight
+ *                         to the destination. The session is ALREADY scoped to that empresa, so
+ *                         there is nothing to POST (observed 2026-09-09, #95, for BOTH wired DTE
+ *                         types: `OPCION=33` and `OPCION=34` answer the identical shim). */
+export type ChooserShape = {
+    readonly kind: 'chooser';
+    readonly empresas: DteEmpresa[];
+} | {
+    readonly kind: 'sinAutorizacion';
+} | {
+    readonly kind: 'launcher';
+};
+/** Classify the chooser response. Read the `<option value="RUT">NOMBRE RUT` rows when there is
+ *  a select: SII closes neither the `<option>` nor quotes the label, so match up to the next
+ *  `<` or newline (observed). A page that is none of the three shapes is "scraper roto". */
+export declare function parseChooser(html: string): ChooserShape;
+/** Read the message out of SII's server-side rejection page: a 200 "Redireccionando" document
+ *  whose script is `alert('…')` followed by `window.history.go(-1)` (observed 2026-09-08).
+ *  Returns the alert text with its escaped newlines turned into separators, or null. */
+export declare function serverAlert(html: string): string | null;
+export declare function latin1FormBody(fields: Iterable<readonly [string, string]>): string;
+/** The `name`s of the `VIEW` form inside `PreViewFrame.html` — the EXACT field set the iframe
+ *  posts to the PDF CGI, in order (observed 2026-09-08: 239 inputs, matching the browser's own
+ *  request byte-for-byte in count). Read from SII's frame at runtime so an upstream edit is
+ *  followed rather than drifting against a hardcoded list. */
+export declare function frameFields(html: string): {
+    name: string;
+    value: string;
+}[];
+/** `content-type` says PDF AND the body starts with the `%PDF` magic. Status is never a
+ *  success signal here — SII answers 200 for its own error page (ADR-022). */
+export declare function isPdfBytes(bytes: Uint8Array, contentType: string | null): boolean;
+/** Also relay SII's generic failure page ("Error al contribuyente"), which carries a support
+ *  code rather than a validation message — it is a SII-side refusal, not our bad input. */
+export declare function contribuyenteError(bytes: Uint8Array, contentType: string | null): string | null;
+/** A receptor field SII renders as a <select> where the requested value matched no option.
+ *  SII's own selection was KEPT (assigning a non-matching value blanks the select — observed
+ *  2026-09-08), and `opciones` lists what it actually offers so a caller can choose a real one. */
+export interface DteSelectAviso {
+    readonly campo: string;
+    readonly solicitado: string;
+    readonly usado: string;
+    readonly opciones: readonly string[];
+}
+/** A filled, SII-validated form: the exact body to POST plus the totals SII computed. */
+export interface DteFilled {
+    readonly fields: Record<string, string>;
+    readonly totales: DteTotales;
+    /** Non-fatal: <select> fields where SII's own option was kept. Surfaced to the user. */
+    readonly avisos: readonly DteSelectAviso[];
+}
+/** The empresas the authenticated user may invoice for. This is the MIPYME "usuario
+ *  autorizado" list — its own value domain, NOT the operate pointer's operable set. On a
+ *  single-empresa account (no chooser) it is the one empresa the portal scoped the session to. */
+export declare function fetchEmpresas(session: PortalSession, tipoDte: TipoDte, sleep?: () => Promise<void>): Promise<DteEmpresa[]>;
+/** Resolve `rut` against the live authorized list and select it. Returns the matched empresa so
+ *  callers can echo SII's own razón social. An unknown RUT fails with the list (ADR-005 style). */
+export declare function resolveAndSelectEmpresa(session: PortalSession, rut: Rut, tipoDte: TipoDte, sleep?: () => Promise<void>): Promise<DteEmpresa>;
+/** Load the factura form for `empresa` (a fresh one, or an existing borrador) and fill it with
+ *  `input`, letting SII's own client-side validator pass judgement. Returns the POST-ready body
+ *  + SII's computed totals, which every downstream CGI (graba / elimina / preview) consumes. */
+export declare function fillFactura(session: PortalSession, empresa: DteEmpresa, input: DteBorradorInput): Promise<DteFilled>;
+/** Serialize an EXISTING borrador's form without changing it — the body `mipeEliminaBorrador`
+ *  needs (the CGI takes the whole form back, keyed by `EHDR_CODIGO`). Totals come from the
+ *  form as SII rendered it. */
+export declare function loadBorrador(session: PortalSession, empresa: DteEmpresa, tipoDte: TipoDte, borradorId: string): Promise<DteFilled>;
+/** Persist the filled form as a borrador (create, or update when `EHDR_CODIGO` is set).
+ *  `ES_BORR=TRUE` is what tells the CGI this is a draft, not a document to sign (observed). */
+export declare function grabaBorrador(session: PortalSession, filled: DteFilled): Promise<void>;
+/** Delete a borrador. SII takes the WHOLE form back, keyed by `EHDR_CODIGO` (observed). */
+export declare function eliminaBorrador(session: PortalSession, filled: DteFilled): Promise<void>;
+/** Repair SII's DOUBLE-ENCODED text. `listaBorrador` declares `charset=ISO-8859-1` but serves
+ *  UTF-8 bytes of an ALREADY-mojibaked string: "Á" arrives as `C3 83 C2 81`, i.e. UTF-8 of
+ *  ("Ã", U+0081) — so a correct UTF-8 decode still yields "Fundación" / "Ñuñoa" (observed
+ *  2026-09-08). Undo the extra layer by re-encoding the decoded string as Latin-1 and decoding
+ *  it as UTF-8 again. Applied ONLY when the string carries the tell-tale `Ã`/`Â` + continuation
+ *  pair AND the round trip decodes cleanly, so legitimately-accented text is left untouched.
+ *  This only fixes what we DISPLAY — nothing sent to SII is altered. */
+export declare function repairMojibake(v: string): string;
+/** The borradores of the CURRENTLY SELECTED empresa. A plain JSON array (no SDI `respEstado`
+ *  envelope — observed), served ISO-8859-1; the seam decodes it. Rows carry ~250 mostly-null
+ *  form columns; only the listing columns are curated (no `raw` — the row is receptor +
+ *  emisor identity, i.e. PII, ADR-004). */
+export declare function fetchBorradores(session: PortalSession): Promise<DteBorradorRow[]>;
+/** Parse the emitted-documents table. The markup is MALFORMED — SII leaves the receptor cell
+ *  unclosed (`<td>64000001-5 <td>NOMBRE</td>`, observed 2026-09-08) — so rows are split on the
+ *  `mipeGesDocEmi.cgi?...CODIGO=` anchor and cells on `<td`, never with a strict parser.
+ *
+ *  Cells map POSITIONALLY and a blank one is NEVER dropped. A `PRV` (vista previa) document has
+ *  no folio; dropping that cell before indexing slid every later column one place left — fecha
+ *  into folio, monto into fecha, estado into monto — producing a plausible row with the values
+ *  under the wrong names and no error at all (#92). A row that does not carry the known cells is
+ *  a changed portal, so it raises instead of realigning silently. */
+export declare function parseEmitidas(html: string): DteEmitido[];
+/** The DTEs already emitted by the selected empresa. Read-only: this touches nothing and
+ *  cannot issue a document (ADR-023). Every filter is optional; SII takes them as query
+ *  params and answers ISO-8859-1 HTML (observed 2026-09-08). */
+export declare function fetchEmitidas(session: PortalSession, filtro?: DteEmitidosFiltro): Promise<DteEmitido[]>;
+/** The PDF of an ALREADY EMITTED document, by its listing `codigo` (`DHDR_CODIGO`). A plain
+ *  authenticated GET — far simpler than the borrador preview, which needs the review page and
+ *  the iframe's own form. Success is decided by `content-type` + `%PDF` magic, NEVER by HTTP
+ *  status: SII answers 200 for its error page and for the login-wall bounce too (ADR-022). */
+export declare function fetchEmitidaPdf(session: PortalSession, codigo: string): Promise<Uint8Array>;
+/** Fetch the PREVIEW PDF of a filled (unsigned) document — the "Validar y visualizar" path.
+ *
+ *  TWO hops, both first-hand-observed 2026-09-08:
+ *    1. POST the VIEW_EFXP body to `mipeDisplayPreView.cgi` → the review page, whose
+ *       `PreViewDTE` form carries the document as ~245 HIDDEN inputs.
+ *    2. POST that `PreViewDTE` body to `mipePreView.cgi` → `application/pdf`.
+ *
+ *  Hop 2 is the PDF the portal embeds in its `framePdf` iframe: the document stamped
+ *  "VISTA PREVIA / DOCUMENTO NO VALIDO", folio NOT assigned. Reaching the review page is NOT
+ *  signing it — its `Firmar` button posts to `mipeGenXMLFirma.cgi`, which this module never
+ *  calls (ADR-023).
+ *
+ *  Success is decided by `content-type` + the `%PDF` magic, NEVER by HTTP status — SII answers
+ *  200 for its own error page and for the login-wall bounce too (the ADR-022 rule). */
+export declare function fetchPreviewPdf(session: PortalSession, filled: DteFilled, sleep?: () => Promise<void>): Promise<Uint8Array>;
+//# sourceMappingURL=dte-mipyme.d.ts.map

package/dist/portal/dte-mipyme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dte-mipyme.d.ts","sourceRoot":"","sources":["../../src/portal/dte-mipyme.ts"],"names":[],"mappings":"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"}