@albertomarturelo/sii-core 0.3.0

package/dist/portal/f29.js

@@ -0,0 +1,244 @@
+// F29 — Declaración Mensual de IVA (read-only). Typed facade over `PortalSession.requestJson`.
+// Ported from the proven Python sii-cli (portal/f29.py + docs/sii-contract/f29.md); the wire
+// contract is first-hand-observed there (live capture 2026-06-12, prod), NOT a third-party
+// library (ADR-004). Full contract: docs/sii-contract/f29.md.
+//
+// The F29 portal is the Angular SPA at `https://www4.sii.cl/propuestaf29ui/` — its own app
+// (own Referer), same SDI envelope family as RCV/F22. Two read facades:
+//   1. getDeclaracionConCondicionesYTipoPropuesta — SII's pre-filled F29 PROPUESTA (borrador)
+//      for a (RUT, período): data:{tipopropuesta, estado, listCodPropuestos[], listCodAdministrativos[], …}.
+//   2. getDeclaracionConEstados — the PRESENTED F29 records: data:[{estadoDeclaracionId, estado,
+//      folio, declFechaCreacion, …}] (empty [] = nothing filed for the período).
+//
+// SESSION-KEYED (ADR-005): F29 authorizes by the session principal — confirmed live (Python,
+// 2026-06-26) that setting the body RUT to a represented empresa returns
+// `Consulta RUT[…] no esta autorizado`. The task therefore reads ONLY self and rejects a
+// representing operate pointer up front (tasks/f29.ts); the empresa's F29 needs the empresa's
+// own session (logout→login). The facade itself just posts the RUT it is handed.
+//
+// PII: the propuesta response carries identity PII in a SEPARATE array (`listCodBase`:
+// nombre/RUT/dirección/comuna) and the PP29 calc `traza` EMBEDS the RUT — those are DROPPED
+// (never read). F29 curates ONLY the tax códigos (listCodPropuestos + listCodAdministrativos)
+// and the estado metadata, and exposes NO `raw` (like F22), so identity PII never reaches a
+// surface/LLM. The tax códigos live in their own arrays, cleanly segregated from `listCodBase`,
+// so (unlike F22) no per-código denylist is needed. The estado `monto` (the declaración's total
+// a pagar) IS surfaced as `total` — it is the user's own monthly figure and the point of the
+// overview; it never reaches the audit log (which records only action/result/period). Error
+// channel is `metaData.errors` (a list of {id, descripcion}) — like F22, NOT RCV's `respEstado`.
+import { z } from 'zod';
+import { HOSTS } from '../config/index.js';
+import { F29Error, NotAuthenticatedError } from '../errors/index.js';
+const F29_BASE = `${HOSTS.portalApi}/propuestaf29ui/services/data/facadeAdapterService`;
+const PROPUESTA_URL = `${F29_BASE}/getDeclaracionConCondicionesYTipoPropuesta`;
+const ESTADO_URL = `${F29_BASE}/getDeclaracionConEstados`;
+const PROPUESTA_NAMESPACE = 'cl.sii.sdi.lob.iva.propuestaf29.data.api.interfaces.FacadeAdapterService/getDeclaracionConCondicionesYTipoPropuesta';
+const ESTADO_NAMESPACE = 'cl.sii.sdi.lob.iva.propuestaf29.data.api.interfaces.FacadeAdapterService/getDeclaracionConEstados';
+// Internal F29 form id (the form número is 29; SII's internal id is "2"). The propuesta sends it
+// as `formCodigo`, the estado as `formId` — SII's own naming inconsistency, observed (f29.md).
+const FORM_CODIGO = '2';
+const CONVERSATION_COOKIE = 'TOKEN';
+// Per-surface headers — Referer is the F29 propuesta SPA root (differs from RCV/F22).
+const HEADERS = {
+    'Content-Type': 'application/json',
+    Origin: HOSTS.portalApi,
+    Referer: `${HOSTS.portalApi}/propuestaf29ui/`,
+    Accept: 'application/json, text/plain, */*',
+};
+// --- Wire envelope (zod-at-the-boundary, ADR-011) --------------------------------
+// F29's error channel is `metaData.errors` (like F22, NOT RCV's respEstado). Keep `errors` and
+// `data` opaque (propuesta `data` is an object, estado `data` is an array) and extract below.
+const Envelope = z
+    .object({
+    metaData: z.object({ errors: z.unknown().nullish() }).loose().nullish(),
+    data: z.unknown(),
+})
+    .loose();
+// Alias-tolerant lookups (observed name first; extend with a citation when SII serves a new key).
+const CODIGO_ALIASES = {
+    codigo: ['codigo', 'cod'],
+    valor: ['valor', 'monto'],
+};
+const ESTADO_ALIASES = {
+    estadoId: ['estadoDeclaracionId', 'estadoId'],
+    estado: ['estado', 'glosaEstado', 'descripcionEstado'],
+    folio: ['folio', 'folioDeclaracion'],
+    fecha: ['declFechaCreacion', 'fechaCreacion', 'fecha'],
+    total: ['monto', 'total', 'montoTotal'],
+    enNegocio: ['enNegocio'],
+    codigo: ['codigo', 'cod'],
+};
+const aliasGet = (row, aliases) => {
+    for (const key of aliases) {
+        const v = row[key];
+        if (v !== undefined && v !== null)
+            return v;
+    }
+    return undefined;
+};
+const asStr = (v) => (v === null || v === undefined ? null : String(v));
+const isObj = (v) => typeof v === 'object' && v !== null;
+/** Parse an F29 `valor`. SII's propuesta serves numbers WITHOUT thousands separators and with a
+ *  `.` decimal point (e.g. monto `"2709150"` → 2709150; PPM tasa código 115 `"0.125"` → 0.125),
+ *  so a plain `Number()` is correct here — unlike F22, whose grid is es-CL-formatted. Floats are
+ *  preserved (an int-only coercion would silently drop a rate like 0.125 to null). */
+const asNumber = (v) => {
+    if (v === null || v === undefined || v === '')
+        return null;
+    if (typeof v === 'number')
+        return Number.isFinite(v) ? v : null;
+    const n = Number(String(v).trim());
+    return Number.isFinite(n) ? n : null;
+};
+/** `enNegocio` arrives as a bool or "S"/"N"/1/0 (exact form unconfirmed). Tolerant. */
+function coerceBool(v) {
+    if (v === null || v === undefined)
+        return null;
+    if (typeof v === 'boolean')
+        return v;
+    const s = String(v).trim().toUpperCase();
+    if (['S', 'SI', 'TRUE', '1'].includes(s))
+        return true;
+    if (['N', 'NO', 'FALSE', '0'].includes(s))
+        return false;
+    return null;
+}
+/** `metaData.errors`: a list/dict of `{descripcion}`, or a string. Non-empty ⇒ SII signaled a
+ *  business error → its `descripcion` verbatim (ADR-004), else null. (Mirrors F22's channel.) */
+function f29Error(errors) {
+    if (errors === null || errors === undefined)
+        return null;
+    if (Array.isArray(errors)) {
+        const descs = errors
+            .map((e) => (isObj(e) ? asStr(e['descripcion']) : null))
+            .filter((d) => d !== null);
+        return descs.length ? descs.join('; ') : null;
+    }
+    if (isObj(errors))
+        return asStr(errors['descripcion']);
+    const s = asStr(errors);
+    return s && s !== '' ? s : null;
+}
+/** Split a `Periodo` into the `{mes, anno}` pair the F29 facades expect (both strings; `mes`
+ *  zero-padded). The combined `YYYYMM` form is NOT used by these endpoints (observed). */
+const mesAnno = (periodo) => ({
+    mes: String(periodo.month).padStart(2, '0'),
+    anno: String(periodo.year),
+});
+async function postSdi(session, url, namespace, data) {
+    const conversationId = (await session.cookie(`${HOSTS.portalApi}/`, CONVERSATION_COOKIE)) ?? '';
+    const request = {
+        method: 'POST',
+        headers: HEADERS,
+        body: {
+            metaData: { namespace, conversationId, transactionId: globalThis.crypto.randomUUID() },
+            data,
+        },
+    };
+    let raw;
+    try {
+        raw = await session.requestJson(url, request);
+    }
+    catch (e) {
+        // An expired/dead session (the seam raises it) is actionable — let it through so the user is
+        // told to re-login, not a misleading "no es JSON".
+        if (e instanceof NotAuthenticatedError)
+            throw e;
+        throw new F29Error('Respuesta inesperada de SII (no es JSON).');
+    }
+    const parsed = Envelope.safeParse(raw);
+    if (!parsed.success)
+        throw new F29Error('Respuesta inesperada de SII (no es un objeto JSON del F29).');
+    const err = f29Error(parsed.data.metaData?.errors);
+    if (err)
+        throw new F29Error(err);
+    return parsed.data;
+}
+/** Project a código array (`[{codigo, valor}]`) into curated rows, dropping entries without a
+ *  código. Used for BOTH listCodPropuestos and listCodAdministrativos (same row shape). */
+function parseCodigos(arr) {
+    if (!Array.isArray(arr))
+        return [];
+    const out = [];
+    for (const r of arr) {
+        if (!isObj(r))
+            continue;
+        const codigo = asStr(aliasGet(r, CODIGO_ALIASES.codigo));
+        if (codigo === null)
+            continue;
+        out.push({ codigo, valor: asNumber(aliasGet(r, CODIGO_ALIASES.valor)) });
+    }
+    return out;
+}
+/** getDeclaracionConCondicionesYTipoPropuesta — the IVA propuesta (pre-filled F29 draft). A
+ *  `data:null` envelope (no errors) is a legitimate "sin propuesta", NOT an error. Curates the
+ *  tax códigos only; identity PII (`listCodBase`) and the PP29 `traza` are never read. */
+export async function fetchF29Propuesta(session, params) {
+    const { rut, periodo } = params;
+    const env = await postSdi(session, PROPUESTA_URL, PROPUESTA_NAMESPACE, {
+        rutContribuyente: String(rut.body),
+        dv: rut.dv,
+        formCodigo: FORM_CODIGO,
+        ...mesAnno(periodo),
+    });
+    const base = {
+        rut: rut.canonical,
+        periodo: periodo.formatted,
+    };
+    const data = env.data;
+    if (!isObj(data)) {
+        // data:null ⇒ no propuesta for the período (clean negative).
+        return {
+            ...base,
+            tienePropuesta: false,
+            tipoPropuesta: null,
+            estado: null,
+            descripcionEstado: null,
+            codigos: [],
+            codigosAdministrativos: [],
+        };
+    }
+    const codigos = parseCodigos(data['listCodPropuestos']);
+    return {
+        ...base,
+        // `data` can be a non-null object with NO meaningful proposal (empty list, or all-zero
+        // placeholder códigos) for a período SII has nothing for. Treat that as "sin propuesta"
+        // (observed: such months render empty groups) — `tienePropuesta` is true only when there is
+        // at least one proposed código with a non-zero value.
+        tienePropuesta: codigos.some((c) => c.valor !== null && c.valor !== 0),
+        tipoPropuesta: asNumber(data['tipopropuesta']),
+        estado: asNumber(data['estado']),
+        descripcionEstado: asStr(data['descripcionEstado']),
+        codigos,
+        codigosAdministrativos: parseCodigos(data['listCodAdministrativos']),
+    };
+}
+/** getDeclaracionConEstados — the presented/saved F29 records for the período. Empty `data:[]`
+ *  is a legitimate "nada presentado", NOT an error. The estado uses `formId`/`rut` (vs the
+ *  propuesta's `formCodigo`/`rutContribuyente`) — SII's own naming inconsistency (observed).
+ *  `monto` is intentionally dropped (financial PII). */
+export async function fetchF29Estado(session, params) {
+    const { rut, periodo } = params;
+    const env = await postSdi(session, ESTADO_URL, ESTADO_NAMESPACE, {
+        rut: String(rut.body),
+        dv: rut.dv,
+        formId: FORM_CODIGO,
+        ...mesAnno(periodo),
+    });
+    const rows = Array.isArray(env.data) ? env.data : [];
+    const declaraciones = rows.filter(isObj).map((r) => ({
+        estadoId: asNumber(aliasGet(r, ESTADO_ALIASES.estadoId)),
+        estado: asStr(aliasGet(r, ESTADO_ALIASES.estado)),
+        folio: asNumber(aliasGet(r, ESTADO_ALIASES.folio)),
+        fecha: asStr(aliasGet(r, ESTADO_ALIASES.fecha)),
+        total: asNumber(aliasGet(r, ESTADO_ALIASES.total)),
+        enNegocio: coerceBool(aliasGet(r, ESTADO_ALIASES.enNegocio)),
+        codigo: asNumber(aliasGet(r, ESTADO_ALIASES.codigo)),
+    }));
+    return {
+        rut: rut.canonical,
+        periodo: periodo.formatted,
+        tieneDeclaracion: declaraciones.length > 0,
+        declaraciones,
+    };
+}
+//# sourceMappingURL=f29.js.map

package/dist/portal/f29.js.map

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

package/dist/portal/rcv.d.ts

@@ -0,0 +1,62 @@
+import { Rut } from '../rut/index.js';
+import type { Periodo } from '../periodo/index.js';
+import type { PortalSession } from '../seams/index.js';
+export type RcvSide = 'COMPRA' | 'VENTA';
+export interface RcvResumenRow {
+    /** SII DTE type code (e.g. "33" factura, "34" exenta, "39" boleta). */
+    readonly codigoTipoDoc: string | null;
+    readonly descripcion: string | null;
+    readonly totalDocumentos: number | null;
+    readonly montoExento: number | null;
+    readonly montoNeto: number | null;
+    readonly montoIva: number | null;
+    readonly montoTotal: number | null;
+}
+export interface RcvResumen {
+    /** Operating RUT these aggregates belong to (canonical). */
+    readonly rut: string;
+    readonly periodo: string;
+    readonly side: RcvSide;
+    readonly rows: readonly RcvResumenRow[];
+    /** Envelope-level `totDocRes` (total document count), or null. */
+    readonly totalDocumentos: number | null;
+}
+/** Curated subset of the ~50-field detalle row. Tax-special fields (activo fijo,
+ *  IVA uso común, Ley 18211, etc.) live in `raw` (ADR-004 curated+raw). */
+export interface RcvDetalleDoc {
+    readonly folio: number | null;
+    readonly rutEmisor: string | null;
+    readonly razonSocial: string | null;
+    readonly fechaEmision: string | null;
+    readonly fechaRecepcion: string | null;
+    readonly montoExento: number | null;
+    readonly montoNeto: number | null;
+    readonly montoIva: number | null;
+    readonly montoTotal: number | null;
+    readonly eventoReceptor: string | null;
+    readonly eventoReceptorLeyenda: string | null;
+    readonly raw: Record<string, unknown>;
+}
+export interface RcvDetalle {
+    readonly rut: string;
+    readonly periodo: string;
+    readonly side: RcvSide;
+    readonly codigoTipoDoc: string;
+    readonly docs: readonly RcvDetalleDoc[];
+}
+/** getResumen: per-DTE-type aggregates for one (RUT, period, side). `session` must be
+ *  an already-logged-in PortalSession (acquired via `withSession`). */
+export declare function fetchRcvResumen(session: PortalSession, params: {
+    rut: Rut;
+    periodo: Periodo;
+    side: RcvSide;
+}): Promise<RcvResumen>;
+/** getDetalle{Compra,Venta}: individual DTE rows for one (RUT, period, side, DTE type).
+ *  `codigoTipoDoc` comes from a prior `fetchRcvResumen` for the same period. */
+export declare function fetchRcvDetalle(session: PortalSession, params: {
+    rut: Rut;
+    periodo: Periodo;
+    side: RcvSide;
+    codigoTipoDoc: string;
+}): Promise<RcvDetalle>;
+//# sourceMappingURL=rcv.d.ts.map

package/dist/portal/rcv.d.ts.map

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

package/dist/portal/rcv.js

@@ -0,0 +1,252 @@
+// RCV — Registro de Compras y Ventas. Typed facade over `PortalSession.requestJson`.
+// Ported from the proven Python sii-cli (portal/rcv.py); the wire contract is
+// first-hand-observed there, NOT a third-party library (ADR-004).
+//
+// The RCV portal is an Angular SPA at `https://www4.sii.cl/consdcvinternetui/`
+// fronting a JSON-over-HTTP SDI API. Endpoints in play here:
+//   - getResumen — per-DTE-type aggregates (counts + montos). No captcha.
+//   - getDetalleCompra / getDetalleVenta — individual DTE rows.
+// Endpoints/namespaces cited from cURL captured 2026-06-07 (issue #7 spike report)
+// + Angular bundle inspection 2026-06-07 (`app.full.min.js?2026428195.js`).
+//
+// SESSION reaches any RUT the account legally represents via the body's
+// `rutEmisor`/`dvEmisor` — RCV is BODY-RUT (ADR-005), so `operate`/`--rut` selects it.
+//
+// Wire parsing is zod-at-the-boundary (ADR-011) for the envelope (error detection +
+// the `data[]` array), then ALIAS-TOLERANT per-row projection into a curated shape
+// (observed name first; extend with a citation when a new alias appears) + `raw`
+// carrying the full row for tax-special fields (ADR-004 curated+raw).
+import { z } from 'zod';
+import { HOSTS } from '../config/index.js';
+import { NotAuthenticatedError, RcvError } from '../errors/index.js';
+import { Rut } from '../rut/index.js';
+const RESUMEN_URL = `${HOSTS.portalApi}/consdcvinternetui/services/data/facadeService/getResumen`;
+const RESUMEN_NAMESPACE = 'cl.sii.sdi.lob.diii.consdcv.data.api.interfaces.FacadeService/getResumen';
+const DETALLE_URL = {
+    COMPRA: `${HOSTS.portalApi}/consdcvinternetui/services/data/facadeService/getDetalleCompra`,
+    VENTA: `${HOSTS.portalApi}/consdcvinternetui/services/data/facadeService/getDetalleVenta`,
+};
+const DETALLE_NAMESPACE = {
+    COMPRA: 'cl.sii.sdi.lob.diii.consdcv.data.api.interfaces.FacadeService/getDetalleCompra',
+    VENTA: 'cl.sii.sdi.lob.diii.consdcv.data.api.interfaces.FacadeService/getDetalleVenta',
+};
+// The SPA's `recaptchaService.pedirToken` (bundle inspection 2026-06-07) is a no-op
+// that returns this literal sentinel; the bundle never loads Google's reCAPTCHA SDK.
+// Smoke-test before relying on it in case SII tightens the contract.
+const RECAPTCHA_TOKEN = 't-o-k-e-n-web';
+// Per-side action map (bundle `Constantes`: ACCION_DETALLE_CMPR/VTA).
+const RECAPTCHA_ACTION = { COMPRA: 'RCV_DETC', VENTA: 'RCV_DETV' };
+// The SPA conversation token; seeds metaData.conversationId (empty value accepted).
+const CONVERSATION_COOKIE = 'TOKEN';
+// Same headers as the sibling representación facade (observed): Origin = SPA host,
+// Referer = SPA root.
+const HEADERS = {
+    'Content-Type': 'application/json',
+    Origin: HOSTS.portalApi,
+    Referer: `${HOSTS.portalApi}/consdcvinternetui/`,
+    Accept: 'application/json, text/plain, */*',
+};
+// --- Wire envelope (zod-at-the-boundary, ADR-011) --------------------------------
+// Validate the SDI envelope: the shared `respEstado` error block + the `data[]` rows.
+// `.loose()` keeps unobserved fields so curated projection + `raw` see the full row.
+const Row = z.record(z.string(), z.unknown());
+const Envelope = z
+    .object({
+    respEstado: z
+        .object({
+        codRespuesta: z.union([z.number(), z.string()]).nullish(),
+        msgeRespuesta: z.string().nullish(),
+        codError: z.string().nullish(),
+    })
+        .loose()
+        .nullish(),
+    data: z.array(Row).nullish(),
+    datos: z.array(Row).nullish(),
+    totDocRes: z.union([z.number(), z.string()]).nullish(),
+})
+    .loose();
+// --- Alias-tolerant field lookup (observed name first; cite new aliases) ---------
+// Resumen: SII uses `rsmn*` (resumen) + `dcv*` (type metadata) prefixes — observed
+// issue #9 smoke 2026-06-07 (empresa VENTA 2026-05).
+const RESUMEN_ALIASES = {
+    codigoTipoDoc: ['rsmnTipoDocInteger', 'codTipoDoc', 'codigoTipoDoc', 'tipoDoc'],
+    descripcion: ['dcvNombreTipoDoc', 'descTipoDoc', 'glosaTipoDoc', 'descripcion'],
+    totalDocumentos: ['rsmnTotDoc', 'totDoctos', 'totalDoctos', 'totalDocumentos'],
+    montoExento: ['rsmnMntExe', 'mntExento', 'montoExento'],
+    montoNeto: ['rsmnMntNeto', 'mntNeto', 'montoNeto'],
+    montoIva: ['rsmnMntIVA', 'mntIVA', 'montoIVA', 'mntIva'],
+    montoTotal: ['rsmnMntTotal', 'mntTotal', 'montoTotal'],
+};
+// Detalle: SII uses the `det*` prefix — observed issue #12 capture 2026-06-07
+// (empresa COMPRA 2026-06 codTipoDoc 34).
+const DETALLE_ALIASES = {
+    folio: ['detNroDoc', 'nroDoc', 'folio'],
+    rutDigits: ['detRutDoc', 'rutDoc', 'rutEmisor'],
+    dv: ['detDvDoc', 'dvDoc', 'dvEmisor'],
+    razonSocial: ['detRznSoc', 'rznSoc', 'razonSocial'],
+    fechaEmision: ['detFchDoc', 'fchDoc', 'fechaEmision'],
+    fechaRecepcion: ['detFecRecepcion', 'fecRecepcion', 'fechaRecepcion'],
+    montoExento: ['detMntExe', 'mntExe', 'montoExento'],
+    montoNeto: ['detMntNeto', 'mntNeto', 'montoNeto'],
+    montoIva: ['detMntIVA', 'mntIVA', 'montoIVA'],
+    montoTotal: ['detMntTotal', 'mntTotal', 'montoTotal'],
+    eventoReceptor: ['detEventoReceptor', 'eventoReceptor'],
+    eventoReceptorLeyenda: ['detEventoReceptorLeyenda', 'eventoReceptorLeyenda'],
+};
+const aliasGet = (row, aliases) => {
+    for (const key of aliases) {
+        const v = row[key];
+        if (v !== undefined && v !== null)
+            return v;
+    }
+    return undefined;
+};
+const asStr = (v) => (v === null || v === undefined ? null : String(v));
+const asInt = (v) => {
+    if (v === null || v === undefined || v === '')
+        return null;
+    const n = Number(v);
+    return Number.isFinite(n) ? Math.trunc(n) : null;
+};
+// RCV `respEstado.codRespuesta` semantics, observed live 2026-06-28:
+//   0 = OK; 3 = consulta VÁLIDA pero SIN MOVIMIENTOS for that (RUT, período, lado) —
+//   `data` comes empty, message comes null (NOT an error). Any OTHER non-zero code is
+//   a real rejection. (Confirmed: a persona's self VENTA and a represented empresa's
+//   COMPRA both returned code 3 with no rows, while the empresa's VENTA returned 0 + a
+//   row — so code 3 is "empty", not "denied", and `--rut` DOES reach the empresa.)
+const RCV_OK = new Set([0, '0', 3, '3']);
+/** SDI error envelope. Returns SII's message verbatim (ADR-004) for a real rejection,
+ *  else null (OK or the "sin movimientos" code 3 → handled as an empty result). */
+function siiRejected(resp) {
+    if (!resp)
+        return null;
+    const code = resp.codRespuesta;
+    if (code === undefined || code === null || RCV_OK.has(code))
+        return null;
+    return asStr(resp.msgeRespuesta ?? resp.codError) ?? 'SII rechazó la consulta del RCV.';
+}
+/** Normalise SII's `DD/MM/YYYY[ HH:MM:SS]` to ISO; unrecognised input is returned
+ *  unchanged so the raw value still surfaces. */
+function normalizeDmy(value) {
+    if (value === null || value === undefined)
+        return null;
+    const s = String(value).trim();
+    if (!s)
+        return null;
+    const [datePart, timePart] = s.split(' ', 2);
+    const parts = (datePart ?? '').split('/');
+    if (parts.length !== 3 || !parts.every((p) => /^\d+$/.test(p)))
+        return s;
+    const [dd, mm, yyyy] = parts;
+    const iso = `${yyyy.padStart(4, '0')}-${mm.padStart(2, '0')}-${dd.padStart(2, '0')}`;
+    return timePart ? `${iso} ${timePart.trim()}` : iso;
+}
+function canonicalRutFrom(digits, dv) {
+    if (digits === undefined || digits === null || dv === undefined || dv === null)
+        return null;
+    return Rut.tryParse(`${String(digits)}-${String(dv).trim()}`)?.canonical ?? null;
+}
+function metaData(namespace, conversationId) {
+    return {
+        namespace,
+        conversationId,
+        // Opaque per-request correlation id (Web Crypto global; no node: import).
+        transactionId: globalThis.crypto.randomUUID(),
+        page: null,
+    };
+}
+/** Parse the SDI envelope or throw `RcvError` (non-JSON / error envelope). Empty
+ *  `data[]` is a legitimate "no documents" result, never an error. */
+function parseEnvelope(raw) {
+    const parsed = Envelope.safeParse(raw);
+    if (!parsed.success) {
+        throw new RcvError('Respuesta inesperada de SII (no es un objeto JSON del RCV).');
+    }
+    const rejected = siiRejected(parsed.data.respEstado);
+    if (rejected)
+        throw new RcvError(rejected);
+    return parsed.data;
+}
+const rowsOf = (env) => env.data ?? env.datos ?? [];
+async function postSdi(session, url, namespace, data) {
+    const conversationId = (await session.cookie(`${HOSTS.portalApi}/`, CONVERSATION_COOKIE)) ?? '';
+    const request = {
+        method: 'POST',
+        headers: HEADERS,
+        body: { metaData: metaData(namespace, conversationId), data },
+    };
+    try {
+        return await session.requestJson(url, request);
+    }
+    catch (e) {
+        // An expired/dead session is an ACTIONABLE NotAuthenticated (the seam detects the
+        // login wall) — let it through verbatim so the user is told to re-login, not a
+        // misleading "no es JSON". Any other non-JSON / network failure becomes a typed
+        // RcvError (ADR-004), never a raw Playwright error.
+        if (e instanceof NotAuthenticatedError)
+            throw e;
+        throw new RcvError('Respuesta inesperada de SII (no es JSON).');
+    }
+}
+/** getResumen: per-DTE-type aggregates for one (RUT, period, side). `session` must be
+ *  an already-logged-in PortalSession (acquired via `withSession`). */
+export async function fetchRcvResumen(session, params) {
+    const { rut, periodo, side } = params;
+    const raw = await postSdi(session, RESUMEN_URL, RESUMEN_NAMESPACE, {
+        rutEmisor: String(rut.body),
+        dvEmisor: rut.dv,
+        ptributario: periodo.canonical,
+        estadoContab: 'REGISTRO',
+        operacion: side,
+        busquedaInicial: true,
+    });
+    const env = parseEnvelope(raw);
+    const rows = rowsOf(env).map((r) => ({
+        codigoTipoDoc: asStr(aliasGet(r, RESUMEN_ALIASES.codigoTipoDoc)),
+        descripcion: asStr(aliasGet(r, RESUMEN_ALIASES.descripcion)),
+        totalDocumentos: asInt(aliasGet(r, RESUMEN_ALIASES.totalDocumentos)),
+        montoExento: asInt(aliasGet(r, RESUMEN_ALIASES.montoExento)),
+        montoNeto: asInt(aliasGet(r, RESUMEN_ALIASES.montoNeto)),
+        montoIva: asInt(aliasGet(r, RESUMEN_ALIASES.montoIva)),
+        montoTotal: asInt(aliasGet(r, RESUMEN_ALIASES.montoTotal)),
+    }));
+    return {
+        rut: rut.canonical,
+        periodo: periodo.formatted,
+        side,
+        rows,
+        totalDocumentos: asInt(env.totDocRes),
+    };
+}
+/** getDetalle{Compra,Venta}: individual DTE rows for one (RUT, period, side, DTE type).
+ *  `codigoTipoDoc` comes from a prior `fetchRcvResumen` for the same period. */
+export async function fetchRcvDetalle(session, params) {
+    const { rut, periodo, side, codigoTipoDoc } = params;
+    const raw = await postSdi(session, DETALLE_URL[side], DETALLE_NAMESPACE[side], {
+        rutEmisor: String(rut.body),
+        dvEmisor: rut.dv,
+        ptributario: periodo.canonical,
+        estadoContab: 'REGISTRO',
+        operacion: side,
+        codTipoDoc: codigoTipoDoc,
+        accionRecaptcha: RECAPTCHA_ACTION[side],
+        tokenRecaptcha: RECAPTCHA_TOKEN,
+    });
+    const env = parseEnvelope(raw);
+    const docs = rowsOf(env).map((r) => ({
+        folio: asInt(aliasGet(r, DETALLE_ALIASES.folio)),
+        rutEmisor: canonicalRutFrom(aliasGet(r, DETALLE_ALIASES.rutDigits), aliasGet(r, DETALLE_ALIASES.dv)),
+        razonSocial: asStr(aliasGet(r, DETALLE_ALIASES.razonSocial)),
+        fechaEmision: normalizeDmy(aliasGet(r, DETALLE_ALIASES.fechaEmision)),
+        fechaRecepcion: normalizeDmy(aliasGet(r, DETALLE_ALIASES.fechaRecepcion)),
+        montoExento: asInt(aliasGet(r, DETALLE_ALIASES.montoExento)),
+        montoNeto: asInt(aliasGet(r, DETALLE_ALIASES.montoNeto)),
+        montoIva: asInt(aliasGet(r, DETALLE_ALIASES.montoIva)),
+        montoTotal: asInt(aliasGet(r, DETALLE_ALIASES.montoTotal)),
+        eventoReceptor: asStr(aliasGet(r, DETALLE_ALIASES.eventoReceptor)),
+        eventoReceptorLeyenda: asStr(aliasGet(r, DETALLE_ALIASES.eventoReceptorLeyenda)),
+        raw: r,
+    }));
+    return { rut: rut.canonical, periodo: periodo.formatted, side, codigoTipoDoc, docs };
+}
+//# sourceMappingURL=rcv.js.map

package/dist/portal/rcv.js.map

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

package/dist/portal/representacion.d.ts

@@ -0,0 +1,24 @@
+import type { PortalSession } from '../seams/index.js';
+export interface EmpresaAutorizada {
+    /** Canonical RUT (`<digits>-<DV>`), or null when the row's RUT didn't parse. */
+    readonly rut: string | null;
+    /** Razón social / company name — may be null (came null in the observed call). PII. */
+    readonly razonSocial: string | null;
+    readonly privilegios: string | null;
+    /** True for the row that is the account's OWN RUT (the endpoint includes it). */
+    readonly isSelf: boolean;
+    /** Full SII row for fields not curated (privilege / deauth metadata). */
+    readonly raw: Record<string, unknown>;
+}
+export interface EmpresasAutorizadas {
+    /** The authenticated account whose authorizations these are (canonical / null). */
+    readonly rut: string | null;
+    /** Empty = the account operates only its own RUT. */
+    readonly empresas: readonly EmpresaAutorizada[];
+}
+/** Fetch the operable set for the live session (empresas the account can operate).
+ *  SESSION-KEYED — no operating-RUT arg (ADR-005). `session` must be an
+ *  already-logged-in PortalSession. Throws `RepresentacionError` on an SII error
+ *  envelope / non-JSON response (message verbatim, ADR-004). */
+export declare function fetchEmpresasAutorizadas(session: PortalSession, authRutCanonical: string | null): Promise<EmpresasAutorizadas>;
+//# sourceMappingURL=representacion.d.ts.map

package/dist/portal/representacion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"representacion.d.ts","sourceRoot":"","sources":["../../src/portal/representacion.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAgBpE,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uFAAuF;IACvF,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC,mFAAmF;IACnF,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACjD;AAgGD;;;gEAGgE;AAChE,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CA2B9B"}