@albertomarturelo/sii-core 0.3.0

package/dist/portal/representacion.js

@@ -0,0 +1,153 @@
+// Representación — empresas the authenticated account can operate at SII.
+// Ported from the proven Python sii-cli (portal/representacion.py); the wire
+// contract is first-hand-observed, NOT a third-party library (ADR-004).
+//
+// SII lets ONE Clave Tributaria operate on multiple RUTs when the user is
+// representante legal / a delegated user of one or more empresas (ADR-005). The
+// RCV SPA's multi-RUT picker is fed by `getDcvEmpresasAutorizadas` — a JSON facade
+// on the www4.sii.cl SDI envelope. SESSION-KEYED: it returns the authorizations of
+// the session principal (empty `data` request); the result includes the account's
+// own RUT (flagged isSelf) and IS the source of valid operate targets (ADR-005).
+//
+// Observed at https://www4.sii.cl/consdcvinternetui/ on 2026-06-20, confirmed
+// 2026-06-26 (prod, persona-natural session): POST to EMPRESAS_URL (GET → 405);
+// body `{ metaData:{namespace,conversationId,transactionId,page:null}, data:{} }`;
+// conversationId = the `TOKEN` cookie on www4.sii.cl (empty value accepted). Rows
+// under `data[]` carry usrEmpRut/usrEmpDv/usrEmpRutDv, razonSocONombreEmp (came
+// null), usrPrivilegios. Error envelope: respEstado.codRespuesta != 0.
+import { HOSTS } from '../config/index.js';
+import { NotAuthenticatedError, RepresentacionError } from '../errors/index.js';
+import { Rut } from '../rut/index.js';
+const EMPRESAS_URL = `${HOSTS.portalApi}/consdcvinternetui/services/data/facadeService/getDcvEmpresasAutorizadas`;
+const EMPRESAS_NAMESPACE = 'cl.sii.sdi.lob.diii.consdcv.data.api.interfaces.FacadeService/getDcvEmpresasAutorizadas';
+// The SPA conversation token; seeds metaData.conversationId (empty value accepted).
+const CONVERSATION_COOKIE = 'TOKEN';
+// Same headers as the sibling RCV facades (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, */*',
+};
+// Alias-tolerant field lookup; the FIRST alias per field is the observed name
+// (2026-06-20). Extend with a citation when a new key surfaces.
+const FIELD_ALIASES = {
+    rutDigits: ['usrEmpRut', 'rutEmpresa', 'empRut'],
+    dv: ['usrEmpDv', 'dvEmpresa', 'empDv'],
+    rutDv: ['usrEmpRutDv', 'rutDvEmpresa'],
+    razonSocial: ['razonSocONombreEmp', 'razonSocial', 'nombreEmpresa'],
+    privilegios: ['usrPrivilegios', 'privilegios'],
+};
+const aliasGet = (row, field) => {
+    for (const key of FIELD_ALIASES[field]) {
+        const value = row[key];
+        if (value !== undefined && value !== null)
+            return value;
+    }
+    return undefined;
+};
+const asStr = (v) => (v === null || v === undefined ? null : String(v));
+function canonicalEmpresaRut(row) {
+    const digits = aliasGet(row, 'rutDigits');
+    const dv = aliasGet(row, 'dv');
+    if (digits !== undefined && dv !== undefined) {
+        try {
+            return Rut.parse(`${String(digits)}-${String(dv).trim()}`).canonical;
+        }
+        catch {
+            // fall through to the combined field
+        }
+    }
+    const combined = aliasGet(row, 'rutDv');
+    if (combined !== undefined) {
+        try {
+            return Rut.parse(String(combined)).canonical;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+function buildEmpresa(row, authCanonical) {
+    const rut = canonicalEmpresaRut(row);
+    return {
+        rut,
+        razonSocial: asStr(aliasGet(row, 'razonSocial')),
+        privilegios: asStr(aliasGet(row, 'privilegios')),
+        isSelf: rut !== null && rut === authCanonical,
+        raw: row,
+    };
+}
+function extractRows(body) {
+    for (const key of ['data', 'datos', 'empresas', 'items']) {
+        const block = body[key];
+        if (Array.isArray(block) && block.every((r) => typeof r === 'object' && r !== null)) {
+            return block;
+        }
+    }
+    return [];
+}
+/** The shared SDI error envelope: respEstado.codRespuesta != 0 ⇒ SII signaled an
+ *  error; return its message verbatim. */
+function siiRejected(body) {
+    const resp = body['respEstado'];
+    if (typeof resp !== 'object' || resp === null)
+        return null;
+    const r = resp;
+    const code = r['codRespuesta'];
+    if (code === 0 || code === '0' || code === undefined || code === null)
+        return null;
+    return (asStr(r['msgeRespuesta'] ?? r['codError']) ?? 'SII rechazó la consulta de empresas autorizadas.');
+}
+function parseResponse(raw, authCanonical) {
+    // Empty `data[]` is a legitimate "no representations" result, NOT an error. An
+    // SII error envelope or a non-object response raises (never silently empty,
+    // which would be indistinguishable from "no representations") — ADR-004.
+    if (typeof raw !== 'object' || raw === null) {
+        throw new RepresentacionError('Respuesta inesperada de SII (no es un objeto JSON).');
+    }
+    const body = raw;
+    const rejected = siiRejected(body);
+    if (rejected)
+        throw new RepresentacionError(rejected);
+    return {
+        rut: authCanonical,
+        empresas: extractRows(body).map((r) => buildEmpresa(r, authCanonical)),
+    };
+}
+/** 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 async function fetchEmpresasAutorizadas(session, authRutCanonical) {
+    const conversationId = (await session.cookie(`${HOSTS.portalApi}/`, CONVERSATION_COOKIE)) ?? '';
+    const request = {
+        method: 'POST',
+        headers: HEADERS,
+        body: {
+            metaData: {
+                namespace: EMPRESAS_NAMESPACE,
+                conversationId,
+                // Opaque per-request correlation id (Web Crypto global; no node: import).
+                transactionId: globalThis.crypto.randomUUID(),
+                page: null,
+            },
+            data: {},
+        },
+    };
+    let raw;
+    try {
+        raw = await session.requestJson(EMPRESAS_URL, request);
+    }
+    catch (e) {
+        // An expired/dead session (the seam detects the login wall) is an actionable
+        // NotAuthenticated — let it through. Any other non-JSON / network failure becomes
+        // a typed RepresentacionError (ADR-004), not a raw Playwright/SyntaxError.
+        if (e instanceof NotAuthenticatedError)
+            throw e;
+        throw new RepresentacionError('Respuesta inesperada de SII (no es JSON).');
+    }
+    return parseResponse(raw, authRutCanonical);
+}
+//# sourceMappingURL=representacion.js.map

package/dist/portal/representacion.js.map

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

package/dist/rut/index.d.ts

@@ -0,0 +1,2 @@
+export * from './rut.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/rut/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rut/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/rut/index.js

@@ -0,0 +1,2 @@
+export * from './rut.js';
+//# sourceMappingURL=index.js.map

package/dist/rut/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rut/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/rut/rut.d.ts

@@ -0,0 +1,16 @@
+/** A validated Chilean RUT. Canonical internal form is `<body>-<DV>`. */
+export declare class Rut {
+    readonly body: number;
+    readonly dv: string;
+    private constructor();
+    /** Parse + validate. Accepts dotted / spaced / hyphenated input. Throws on a bad DV. */
+    static parse(input: string): Rut;
+    static tryParse(input: string): Rut | null;
+    /** Machine-stable form: `<body>-<DV>` (e.g. `77777777-7`). */
+    get canonical(): string;
+    /** Human form with thousands separators (e.g. `77.777.777-7`). */
+    get formatted(): string;
+    equals(other: Rut): boolean;
+    toString(): string;
+}
+//# sourceMappingURL=rut.d.ts.map

package/dist/rut/rut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rut.d.ts","sourceRoot":"","sources":["../../src/rut/rut.ts"],"names":[],"mappings":"AAoBA,yEAAyE;AACzE,qBAAa,GAAG;IAEZ,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM;IAFrB,OAAO;IAKP,wFAAwF;IACxF,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG;IAkBhC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAQ1C,8DAA8D;IAC9D,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,kEAAkE;IAClE,IAAI,SAAS,IAAI,MAAM,CAGtB;IAED,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAI3B,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/rut/rut.js

@@ -0,0 +1,70 @@
+import { ValidationError } from '../errors/index.js';
+const WEIGHT_RESET = 7;
+/** Chilean Mod-11 check digit for a RUT body (sii-py ADR-010, in-house). */
+function computeDv(body) {
+    let sum = 0;
+    let multiplier = 2;
+    let n = body;
+    while (n > 0) {
+        sum += (n % 10) * multiplier;
+        n = Math.floor(n / 10);
+        multiplier = multiplier === WEIGHT_RESET ? 2 : multiplier + 1;
+    }
+    const r = 11 - (sum % 11);
+    if (r === 11)
+        return '0';
+    if (r === 10)
+        return 'K';
+    return String(r);
+}
+/** A validated Chilean RUT. Canonical internal form is `<body>-<DV>`. */
+export class Rut {
+    body;
+    dv;
+    constructor(body, dv) {
+        this.body = body;
+        this.dv = dv;
+    }
+    /** Parse + validate. Accepts dotted / spaced / hyphenated input. Throws on a bad DV. */
+    static parse(input) {
+        const cleaned = input.replace(/[.\s-]/g, '').toUpperCase();
+        if (cleaned.length < 2) {
+            throw new ValidationError(`RUT inválido: "${input}"`);
+        }
+        const dv = cleaned.slice(-1);
+        const bodyStr = cleaned.slice(0, -1);
+        if (!/^\d+$/.test(bodyStr) || !/^[0-9K]$/.test(dv)) {
+            throw new ValidationError(`RUT inválido: "${input}"`);
+        }
+        const body = Number(bodyStr);
+        const expected = computeDv(body);
+        if (expected !== dv) {
+            throw new ValidationError(`RUT con DV inválido: "${input}" (esperado -${expected})`);
+        }
+        return new Rut(body, dv);
+    }
+    static tryParse(input) {
+        try {
+            return Rut.parse(input);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Machine-stable form: `<body>-<DV>` (e.g. `77777777-7`). */
+    get canonical() {
+        return `${this.body}-${this.dv}`;
+    }
+    /** Human form with thousands separators (e.g. `77.777.777-7`). */
+    get formatted() {
+        const dotted = String(this.body).replace(/\B(?=(\d{3})+(?!\d))/g, '.');
+        return `${dotted}-${this.dv}`;
+    }
+    equals(other) {
+        return this.body === other.body && this.dv === other.dv;
+    }
+    toString() {
+        return this.canonical;
+    }
+}
+//# sourceMappingURL=rut.js.map

package/dist/rut/rut.js.map

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

package/dist/seams/index.d.ts

@@ -0,0 +1,126 @@
+export interface Clock {
+    now(): Date;
+    /** Pause for `ms` (the pacing primitive for multi-call fan-outs — rate-limit
+     *  convention, ADR-004). Fakes resolve instantly so tests don't wait. */
+    sleep(ms: number): Promise<void>;
+}
+/** One audit receipt line. The audit module stamps `ts` and drops secret keys. */
+export interface AuditEntry {
+    readonly action: string;
+    readonly result: string;
+    readonly rut?: string;
+    readonly rutAuth?: string;
+    readonly durationMs?: number;
+    readonly [extra: string]: unknown;
+}
+export interface AuditSink {
+    record(entry: AuditEntry): void;
+}
+/** Namespaced local JSON store. Modules use DISTINCT keys (ADR-007) so they never
+ *  write the same file: `auth` → 'session', `identity` → 'operate'. */
+export interface KeyValueStore {
+    read<T>(key: string): Promise<T | null>;
+    write<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+/** OS secure storage for the optional credential path (ADR-006 / ADR-008).
+ *  Declared now; no Node adapter until the keyring increment. */
+export interface SecretStore {
+    get(account: string): Promise<string | null>;
+    set(account: string, secret: string): Promise<void>;
+    delete(account: string): Promise<void>;
+}
+/** A logged-in browser context (cookies loaded). All portal reads go through
+ *  here, so the core never imports Playwright. */
+export interface JsonRequest {
+    readonly method?: 'GET' | 'POST';
+    readonly headers?: Record<string, string>;
+    /** JSON-serialisable request body (sent as the POST payload). */
+    readonly body?: unknown;
+}
+/** An AUTHENTICATED `x-www-form-urlencoded` request from the session (cookies ride
+ *  along). The primitive behind the legacy HTML form-POST write flows — BHE emission
+ *  (`loa.sii.cl` `TMBECN_*` CGIs, ADR-017) — which return HTML, not JSON. The
+ *  authenticated peer of `PublicRequest.form` (which is session-less). */
+export interface FormRequest {
+    readonly method?: 'GET' | 'POST';
+    readonly headers?: Record<string, string>;
+    readonly form?: Record<string, string>;
+}
+export interface PortalSession {
+    /** Navigate; returns the URL actually landed on (for URL-based auth detection). */
+    goto(url: string): Promise<string>;
+    /** Evaluate a JS expression in the page; returns its JSON-serialisable result. */
+    evaluate<T>(expression: string): Promise<T>;
+    /** Issue an authenticated JSON request from the session's browser context (the
+     *  session cookies are sent automatically). The primitive behind the SII SPA
+     *  JSON facades (the `www4.sii.cl` SDI endpoints — RCV, representación, …).
+     *  Resolves the parsed JSON body; rejects on a non-JSON response. */
+    requestJson(url: string, options?: JsonRequest): Promise<unknown>;
+    /** Issue an authenticated FORM POST (`x-www-form-urlencoded`) from the session and
+     *  return the decoded text body (charset-aware). The primitive behind the legacy
+     *  HTML write flows — BHE emission (ADR-017) — where the CGI returns HTML, not JSON.
+     *  Login-wall detection is URL-based (landing on `LOGIN_HOST`) → `SessionExpiredError`,
+     *  since an HTML body is EXPECTED here (unlike `requestJson`). */
+    requestForm(url: string, options?: FormRequest): Promise<PublicResponse>;
+    /** Value of a cookie visible to `url` (e.g. the SPA conversation `TOKEN`), or
+     *  null. Used to seed SDI request metadata. */
+    cookie(url: string, name: string): Promise<string | null>;
+    /** The cookies-only storage state to persist. */
+    storageState(): Promise<unknown>;
+    close(): Promise<void>;
+}
+/** An UNAUTHENTICATED public request (no session, no cookies). The basis for
+ *  login-free consultas — the DTE-authorized public CGI (ADR-014). */
+export interface PublicRequest {
+    readonly method?: 'GET' | 'POST';
+    readonly headers?: Record<string, string>;
+    /** `application/x-www-form-urlencoded` fields (the palena CGI takes form input). */
+    readonly form?: Record<string, string>;
+}
+export interface PublicResponse {
+    readonly status: number;
+    /** Decoded text body — the adapter decodes per the response's DECLARED charset
+     *  (the DTE report is `text/html; charset=ISO-8859-1`), so accents survive. */
+    readonly body: string;
+}
+export interface InteractiveLoginOptions {
+    /** Post-login destination passed to the login URL. */
+    readonly destination: string;
+    /** Give up if the user hasn't landed off LOGIN_HOST within this budget (ms). */
+    readonly timeoutMs: number;
+}
+export interface CredentialLoginOptions {
+    /** Full RUT to type into the login form (`<body>-<DV>`); the page JS splits it. */
+    readonly rut: string;
+    /** The Clave Tributaria — used ONCE to fill the form, never persisted (ADR-010). */
+    readonly clave: string;
+    /** Post-login destination passed to the login URL. */
+    readonly destination: string;
+    /** Give up if we haven't landed off LOGIN_HOST within this budget (ms). */
+    readonly timeoutMs: number;
+}
+export interface PortalDriver {
+    /** Open a HEADED browser at the login URL; resolve with a session once the user
+     *  lands off LOGIN_HOST. Rejects (LoginFailedError) on timeout / window close. */
+    interactiveLogin(options: InteractiveLoginOptions): Promise<PortalSession>;
+    /** HEADLESS console login (ADR-010): fill the real SII form with RUT + Clave and
+     *  submit, resolving a session once landed off LOGIN_HOST. The Clave is used here
+     *  and never stored (cookies-only result). CLI-only — never wired into MCP. */
+    credentialLogin(options: CredentialLoginOptions): Promise<PortalSession>;
+    /** Restore a (headless) session from persisted cookies for reads / liveness. */
+    restore(storageState: unknown): Promise<PortalSession>;
+    /** Issue an UNAUTHENTICATED request (no session, no cookies, no browser) to a
+     *  public SII endpoint and return the decoded text body. The basis for login-free
+     *  consultas (DTE authorized) — it neither mints nor uses a session (ADR-014). */
+    requestPublic(url: string, options?: PublicRequest): Promise<PublicResponse>;
+}
+/** The set of seams a task needs. The composition root (runtime.ts) builds it. */
+export interface Runtime {
+    readonly clock: Clock;
+    readonly audit: AuditSink;
+    readonly store: KeyValueStore;
+    readonly portal: PortalDriver;
+    readonly secrets?: SecretStore;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/seams/index.d.ts.map

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

package/dist/seams/index.js

@@ -0,0 +1,6 @@
+// Injectable seams (ADR-003): the external / non-deterministic dependencies the
+// core reaches through interfaces. Node defaults live in adapters/node; in-memory
+// fakes for tests live in adapters/fake. The core never imports Playwright, fs,
+// or a keyring directly — only these interfaces.
+export {};
+//# sourceMappingURL=index.js.map

package/dist/seams/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/seams/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kFAAkF;AAClF,gFAAgF;AAChF,iDAAiD"}

package/dist/tasks/auth.d.ts

@@ -0,0 +1,16 @@
+import type { AuthIdentity, AuthLoginResult, AuthLogoutResult, AuthStatusLocal } from '../auth/index.js';
+import type { Runtime } from '../seams/index.js';
+export declare function login(runtime: Runtime): Promise<AuthLoginResult>;
+/** CLI-only (ADR-010): RUT + Clave from the console → headless login → cookies
+ *  only. The Clave is used once and never stored. NEVER expose over MCP. */
+export declare function consoleLogin(runtime: Runtime, credentials: {
+    rut: string;
+    clave: string;
+}): Promise<AuthLoginResult>;
+export declare function logout(runtime: Runtime): Promise<AuthLogoutResult>;
+/** Pure local read (no portal call). */
+export declare function authStatus(runtime: Runtime): Promise<AuthStatusLocal>;
+/** Curated identity readback from the portal (needs a live session). */
+export declare function statusRefresh(runtime: Runtime): Promise<AuthIdentity>;
+export type { AuthIdentity, AuthLoginResult, AuthLogoutResult, AuthStatusLocal };
+//# sourceMappingURL=auth.d.ts.map

package/dist/tasks/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/tasks/auth.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,wBAAgB,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAEhE;AAED;4EAC4E;AAC5E,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,eAAe,CAAC,CAE1B;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAElE;AAED,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAErE;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAErE;AAED,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC"}

package/dist/tasks/auth.js

@@ -0,0 +1,22 @@
+// Public auth API the surfaces call. Uniform: every operation takes a Runtime.
+import * as auth from '../auth/index.js';
+export function login(runtime) {
+    return auth.login(runtime);
+}
+/** CLI-only (ADR-010): RUT + Clave from the console → headless login → cookies
+ *  only. The Clave is used once and never stored. NEVER expose over MCP. */
+export function consoleLogin(runtime, credentials) {
+    return auth.consoleLogin(runtime, credentials);
+}
+export function logout(runtime) {
+    return auth.logout(runtime);
+}
+/** Pure local read (no portal call). */
+export function authStatus(runtime) {
+    return auth.localStatus(runtime.store);
+}
+/** Curated identity readback from the portal (needs a live session). */
+export function statusRefresh(runtime) {
+    return auth.statusRefresh(runtime);
+}
+//# sourceMappingURL=auth.js.map

package/dist/tasks/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/tasks/auth.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAC;AASzC,MAAM,UAAU,KAAK,CAAC,OAAgB;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;4EAC4E;AAC5E,MAAM,UAAU,YAAY,CAC1B,OAAgB,EAChB,WAA2C;IAE3C,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,OAAgB;IACrC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/tasks/bte.d.ts

@@ -0,0 +1,52 @@
+import type { BteMensual, BteSide } from '../portal/bte.js';
+import type { BteEmitida, BtePreview, BteRetiene } from '../portal/bte-emit.js';
+import type { Runtime } from '../seams/index.js';
+export type { BteBoleta, BteMensual, BteSide, BteTotales } from '../portal/bte.js';
+export type { BteEmitida, BtePreview, BteRetiene, BteLineaEmision } from '../portal/bte-emit.js';
+/** One month's boletas de honorarios for the session principal (ADR-005), emitidas or recibidas.
+ *  An empty month is a clean 0-boleta result, not an error. */
+export declare function bteList(runtime: Runtime, args: {
+    periodo: string;
+    side: BteSide;
+}): Promise<BteMensual>;
+/** The args a surface passes to emit/preview. Strings/numbers from the CLI/MCP; validated
+ *  locally here BEFORE any session. The emisor fields (domicilio/comuna/actividad) are read
+ *  from the live form — the caller supplies only the receptor + líneas + fecha + who-withholds. */
+export interface BteEmitArgs {
+    readonly receptor: string;
+    readonly receptorNombre: string;
+    readonly receptorDomicilio: string;
+    readonly region: number;
+    readonly comuna: number;
+    readonly lineas: readonly {
+        readonly glosa: string;
+        readonly monto: number;
+    }[];
+    /** Boleta date; defaults to today. Must be within ±3 months (SII rule). */
+    readonly fecha?: {
+        readonly dia: number;
+        readonly mes: number;
+        readonly anio: number;
+    };
+    readonly retiene: BteRetiene;
+    readonly mostrarDetalle?: boolean;
+    /** Optional: also email the issued PDF to this address (emit only). */
+    readonly enviarA?: string;
+    /** Copy the emisor on the email (default true). */
+    readonly copiaEmisor?: boolean;
+}
+/** Result of an emission: the issued boleta + whether the optional email was sent. */
+export interface BteEmitResult extends BteEmitida {
+    readonly enviado?: boolean;
+}
+/** PREVIEW an emission (ADR-017): run the SII flow to the confirmation step and return the
+ *  server-computed retención/líquido WITHOUT issuing. Session-keyed (rejects a representing
+ *  pointer). Never issues; safe to call freely. */
+export declare function bteEmitPreview(runtime: Runtime, args: BteEmitArgs): Promise<BtePreview>;
+/** ISSUE a boleta de honorarios (ADR-017) — a legally-binding act. Runs the full SII flow and
+ *  returns the folio (código de barras) + PDF URL. Session-keyed. NEVER retries. The caller
+ *  (CLI `--confirm`, MCP `confirmar`) is responsible for the explicit confirmation; this task
+ *  assumes the confirmation was given. Optional email send. The audit receipt carries the folio
+ *  but NEVER the receptor / monto / glosa (PII / business data). */
+export declare function bteEmit(runtime: Runtime, args: BteEmitArgs): Promise<BteEmitResult>;
+//# sourceMappingURL=bte.d.ts.map

package/dist/tasks/bte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bte.d.ts","sourceRoot":"","sources":["../../src/tasks/bte.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAO5D,OAAO,KAAK,EAEV,UAAU,EAEV,UAAU,EACV,UAAU,EACX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAc,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE7D,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnF,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAuBjG;+DAC+D;AAC/D,wBAAsB,OAAO,CAC3B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACvC,OAAO,CAAC,UAAU,CAAC,CAuBrB;AAID;;mGAEmG;AACnG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/E,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvF,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,uEAAuE;IACvE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,sFAAsF;AACtF,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAiED;;mDAEmD;AACnD,wBAAsB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAoB7F;AAED;;;;oEAIoE;AACpE,wBAAsB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CA2BzF"}