@albertomarturelo/sii-core 0.3.0

package/dist/identity/identity.js

@@ -0,0 +1,93 @@
+import { ValidationError } from '../errors/index.js';
+import { Rut } from '../rut/index.js';
+// Distinct KeyValueStore key (ADR-007) — never shares a file with `auth`'s 'session'.
+const OPERATE_KEY = 'operate';
+export async function readOperateState(store) {
+    return store.read(OPERATE_KEY);
+}
+/** Initialise on login: operatingRut defaults to self, operable cached. */
+export async function initOperateState(store, input) {
+    const state = {
+        selfRut: input.selfRut,
+        accountType: input.accountType,
+        operatingRut: input.selfRut,
+        operable: input.operable,
+    };
+    await store.write(OPERATE_KEY, state);
+    return state;
+}
+export async function clearOperateState(store) {
+    await store.delete(OPERATE_KEY);
+}
+/** Validate + canonicalise an operate target against the cached operable set —
+ *  SELECTS, never mints (ADR-005). Throws `ValidationError` for an empresa account
+ *  (no operate capability) or a RUT outside the operable set. Shared by the
+ *  persistent `operate` command AND the per-call `--rut` override so both enforce the
+ *  same value-domain (CONVENTIONS: `--rut` is the operable set, not a separate concept). */
+export function resolveOperableTarget(state, target) {
+    if (state.accountType === 'empresa') {
+        throw new ValidationError('Una cuenta empresa no puede operar a nombre de otra.');
+    }
+    const parsed = Rut.parse(target);
+    if (!state.operable.some((e) => e.rut === parsed.canonical)) {
+        throw new ValidationError(`RUT ${parsed.formatted} no está en el conjunto operable. Revisa los RUT autorizados con \`sii operate --list\`.`);
+    }
+    return parsed.canonical;
+}
+/** Set the operating RUT, validated against the cached operable set. SELECTS,
+ *  never mints (ADR-005). Accepts any RUT format. */
+export async function setOperatingRut(store, target) {
+    const state = await readOperateState(store);
+    if (!state) {
+        throw new ValidationError('No hay sesión activa. Ejecuta `sii auth login` primero.');
+    }
+    const next = { ...state, operatingRut: resolveOperableTarget(state, target) };
+    await store.write(OPERATE_KEY, next);
+    return next;
+}
+/** Reset the operating RUT back to self. */
+export async function clearOperatingRut(store) {
+    const state = await readOperateState(store);
+    if (!state) {
+        throw new ValidationError('No hay sesión activa. Ejecuta `sii auth login` primero.');
+    }
+    const next = { ...state, operatingRut: state.selfRut };
+    await store.write(OPERATE_KEY, next);
+    return next;
+}
+export function operatingContext(state) {
+    const isSelf = state.operatingRut === state.selfRut;
+    const entry = state.operable.find((e) => e.rut === state.operatingRut);
+    return {
+        operatingRut: state.operatingRut,
+        selfRut: state.selfRut,
+        isSelf,
+        razonSocial: entry?.razonSocial ?? null,
+    };
+}
+/** Render the operating context as the shared `Operando como …` display line
+ *  (the CLI STDERR header / `operate` output and the MCP `sii://operating`
+ *  resource + `operate` tool used to carry verbatim copies of this). The razón
+ *  social only appears for a represented empresa — never for self (own-name PII
+ *  stays off the line). */
+export function describeOperating(ctx) {
+    if (ctx.isSelf)
+        return `Operando como tú mismo: ${Rut.parse(ctx.operatingRut).formatted}.`;
+    const name = ctx.razonSocial ? ` (${ctx.razonSocial})` : '';
+    return `Operando como ${Rut.parse(ctx.operatingRut).formatted}${name}.`;
+}
+/** Render one operable entry as a single display line (shared by CLI `operate --list`
+ *  and the MCP `operate list=true` tool, so the format stays in one place):
+ *  `<rut>[ <razón social>][ (tú mismo, operando ahora)]`. Razón social falls back to
+ *  the RUT when SII returned no name — omit it then so the RUT isn't repeated. */
+export function formatOperableEntry(entry, operatingRut) {
+    const marks = [
+        entry.isSelf ? 'tú mismo' : null,
+        entry.rut === operatingRut ? 'operando ahora' : null,
+    ]
+        .filter(Boolean)
+        .join(', ');
+    const name = entry.razonSocial && entry.razonSocial !== entry.rut ? ` ${entry.razonSocial}` : '';
+    return `${Rut.parse(entry.rut).formatted}${name}${marks ? ` (${marks})` : ''}`;
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity/identity.js.map

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

package/dist/identity/index.d.ts

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

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

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

package/dist/identity/index.js

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

package/dist/identity/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export { login, logout, authStatus, statusRefresh } from './tasks/auth.js';
+export type { AuthIdentity, AuthLoginResult, AuthLogoutResult, AuthStatusLocal, } from './tasks/auth.js';
+export { operate, operateSelf, operatingStatus, listOperable } from './tasks/operate.js';
+export type { OperateResult, OperableList } from './tasks/operate.js';
+export { describeOperating, formatOperableEntry } from './identity/index.js';
+export type { OperatingContext, OperableEntry } from './identity/index.js';
+export { rcvSummary, rcvList } from './tasks/rcv.js';
+export type { RcvResumen, RcvResumenRow, RcvDetalle, RcvDetalleDoc, RcvSide } from './tasks/rcv.js';
+export { f22Status, f22Overview, f22Observaciones, f22Historial } from './tasks/f22.js';
+export type { F22Estado, F22Declaraciones, F22Overview, F22Observaciones, F22Historial, F22Grupos, DeclaracionF22, CodigoF22, EventoF22, ObservacionF22, } from './tasks/f22.js';
+export { f29Formulario, f29Overview, f29Status, F29_GRUPO_LABELS } from './tasks/f29.js';
+export type { F29Formulario, F29Overview, F29OverviewArgs, MesF29, LineaF29, F29Grupo, F29Estado, F29Propuesta, CodigoF29, DeclaracionEstadoF29, } 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 type { BteMensual, BteBoleta, BteTotales, BteSide, BteEmitArgs, BteEmitResult, BteEmitida, BtePreview, BteRetiene, BteLineaEmision, } from './tasks/bte.js';
+export type { AuditEntry, AuditSink, Clock, CredentialLoginOptions, InteractiveLoginOptions, KeyValueStore, PortalDriver, PortalSession, Runtime, SecretStore, } from './seams/index.js';
+export { Rut } from './rut/index.js';
+export { formatMoney, formatRut } from './format/index.js';
+export { Periodo, Anio } from './periodo/index.js';
+export { HOSTS, LOGIN_HOST } from './config/index.js';
+export * from './errors/index.js';
+export * as testing from './adapters/fake/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,iBAAiB,CAAC;AAC3E,YAAY,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,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,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACpG,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,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACzF,YAAY,EACV,aAAa,EACb,WAAW,EACX,eAAe,EACf,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,SAAS,EACT,oBAAoB,GACrB,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;AAKxB,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"}

package/dist/index.js

@@ -0,0 +1,24 @@
+// Public API of @albertomarturelo/sii-core. Surfaces (CLI, MCP) import ONLY from here — the task
+// layer plus the seam interfaces + the runtime factory (ADR-003). Reaching into
+// a sub-module (auth/portal/identity internals) from a surface is forbidden.
+// --- tasks: the public operations ---
+// NOTE: `consoleLogin` (takes a Clave) is intentionally NOT here — it lives in the
+// CLI-only subpath `@albertomarturelo/sii-core/cli`, so the MCP server (which imports this barrel)
+// cannot wire a password-taking task (ADR-006).
+export { login, logout, authStatus, statusRefresh } from './tasks/auth.js';
+export { operate, operateSelf, operatingStatus, listOperable } from './tasks/operate.js';
+export { describeOperating, formatOperableEntry } from './identity/index.js';
+export { rcvSummary, rcvList } from './tasks/rcv.js';
+export { f22Status, f22Overview, f22Observaciones, f22Historial } from './tasks/f22.js';
+export { f29Formulario, f29Overview, f29Status, F29_GRUPO_LABELS } from './tasks/f29.js';
+export { dteAuthorized } from './tasks/dte.js';
+export { bteList, bteEmitPreview, bteEmit } from './tasks/bte.js';
+// --- shared primitives ---
+export { Rut } from './rut/index.js';
+export { formatMoney, formatRut } from './format/index.js';
+export { Periodo, Anio } from './periodo/index.js';
+export { HOSTS, LOGIN_HOST } from './config/index.js';
+export * from './errors/index.js';
+// --- testing helpers: in-memory fakes for surface / integration tests ---
+export * as testing from './adapters/fake/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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,iBAAiB,CAAC;AAO3E,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,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAaxF,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAazF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA8BlE,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/node.d.ts

@@ -0,0 +1,9 @@
+import type { Runtime } from './seams/index.js';
+export { FileAuditSink, FileKeyValueStore, SII_DIR, SystemClock } from './adapters/node/index.js';
+export { PlaywrightPortalDriver } from './adapters/node/portal.js';
+/** Composition root: the Node default adapters, any seam replaceable (ADR-016).
+ *  e.g. `createNodeRuntime({ audit: myAuditSink })` keeps the other three defaults.
+ *  The default portal is the Playwright driver — its `playwright` OPTIONAL peer is
+ *  loaded lazily on first use, so composing (or overriding `portal`) never needs it. */
+export declare function createNodeRuntime(overrides?: Partial<Runtime>): Runtime;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;;wFAGwF;AACxF,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,OAAO,CAAC,OAAO,CAAM,GAAG,OAAO,CAQ3E"}

package/dist/node.js

@@ -0,0 +1,22 @@
+// Composition subpath `@albertomarturelo/sii-core/node` (ADR-016): the Node default
+// adapters plus the composition root. Kept OFF the main barrel so importing the
+// library's tasks/primitives never evaluates node:* or playwright — a consumer
+// that injects its own seams (ADR-003) stays free of them entirely.
+import { FileAuditSink, FileKeyValueStore, SystemClock } from './adapters/node/index.js';
+import { PlaywrightPortalDriver } from './adapters/node/portal.js';
+export { FileAuditSink, FileKeyValueStore, SII_DIR, SystemClock } from './adapters/node/index.js';
+export { PlaywrightPortalDriver } from './adapters/node/portal.js';
+/** Composition root: the Node default adapters, any seam replaceable (ADR-016).
+ *  e.g. `createNodeRuntime({ audit: myAuditSink })` keeps the other three defaults.
+ *  The default portal is the Playwright driver — its `playwright` OPTIONAL peer is
+ *  loaded lazily on first use, so composing (or overriding `portal`) never needs it. */
+export function createNodeRuntime(overrides = {}) {
+    return {
+        clock: new SystemClock(),
+        audit: new FileAuditSink(),
+        store: new FileKeyValueStore(),
+        portal: new PlaywrightPortalDriver(),
+        ...overrides,
+    };
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,gFAAgF;AAChF,+EAA+E;AAC/E,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;;wFAGwF;AACxF,MAAM,UAAU,iBAAiB,CAAC,YAA8B,EAAE;IAChE,OAAO;QACL,KAAK,EAAE,IAAI,WAAW,EAAE;QACxB,KAAK,EAAE,IAAI,aAAa,EAAE;QAC1B,KAAK,EAAE,IAAI,iBAAiB,EAAE;QAC9B,MAAM,EAAE,IAAI,sBAAsB,EAAE;QACpC,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/dist/periodo/anio.d.ts

@@ -0,0 +1,15 @@
+/** A validated **año tributario** (tax year), canonical `YYYY`. Sibling of `Periodo`
+ *  (which is month-granularity, YYYYMM) for the annual surfaces. SII semantics: AT N
+ *  reports año comercial N−1's income (AT 2025 = rentas 2024). The value is passed to
+ *  SII's `periodo` field verbatim — no adjustment here. */
+export declare class Anio {
+    readonly value: number;
+    private constructor();
+    /** Parse + validate a 4-digit year (string or number). */
+    static parse(input: string | number): Anio;
+    static of(year: number): Anio;
+    static tryParse(input: string | number): Anio | null;
+    /** Canonical `YYYY` — what SII's F22 `periodo` field takes. */
+    get canonical(): string;
+}
+//# sourceMappingURL=anio.d.ts.map

package/dist/periodo/anio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anio.d.ts","sourceRoot":"","sources":["../../src/periodo/anio.ts"],"names":[],"mappings":"AAOA;;;2DAG2D;AAC3D,qBAAa,IAAI;IACK,QAAQ,CAAC,KAAK,EAAE,MAAM;IAA1C,OAAO;IAEP,0DAA0D;IAC1D,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQ1C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS7B,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI;IAQpD,+DAA+D;IAC/D,IAAI,SAAS,IAAI,MAAM,CAEtB;CACF"}

package/dist/periodo/anio.js

@@ -0,0 +1,42 @@
+import { ValidationError } from '../errors/index.js';
+// Tax years for the annual surfaces (F22 renta). SII's electronic renta era is
+// recent; bound loosely and let SII reject truly out-of-range years server-side.
+const MIN_YEAR = 2000;
+const MAX_YEAR = 2100;
+/** A validated **año tributario** (tax year), canonical `YYYY`. Sibling of `Periodo`
+ *  (which is month-granularity, YYYYMM) for the annual surfaces. SII semantics: AT N
+ *  reports año comercial N−1's income (AT 2025 = rentas 2024). The value is passed to
+ *  SII's `periodo` field verbatim — no adjustment here. */
+export class Anio {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    /** Parse + validate a 4-digit year (string or number). */
+    static parse(input) {
+        const s = String(input).trim();
+        if (!/^\d{4}$/.test(s)) {
+            throw new ValidationError(`Año tributario inválido: "${input}" (esperado YYYY).`);
+        }
+        return Anio.of(Number(s));
+    }
+    static of(year) {
+        if (!Number.isInteger(year) || year < MIN_YEAR || year > MAX_YEAR) {
+            throw new ValidationError(`Año tributario fuera de rango: ${year} (${MIN_YEAR}–${MAX_YEAR}).`);
+        }
+        return new Anio(year);
+    }
+    static tryParse(input) {
+        try {
+            return Anio.parse(input);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Canonical `YYYY` — what SII's F22 `periodo` field takes. */
+    get canonical() {
+        return String(this.value);
+    }
+}
+//# sourceMappingURL=anio.js.map

package/dist/periodo/anio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anio.js","sourceRoot":"","sources":["../../src/periodo/anio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,+EAA+E;AAC/E,iFAAiF;AACjF,MAAM,QAAQ,GAAG,IAAI,CAAC;AACtB,MAAM,QAAQ,GAAG,IAAI,CAAC;AAEtB;;;2DAG2D;AAC3D,MAAM,OAAO,IAAI;IACc;IAA7B,YAA6B,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAE9C,0DAA0D;IAC1D,MAAM,CAAC,KAAK,CAAC,KAAsB;QACjC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,eAAe,CAAC,6BAA6B,KAAK,oBAAoB,CAAC,CAAC;QACpF,CAAC;QACD,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,IAAY;QACpB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,QAAQ,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;YAClE,MAAM,IAAI,eAAe,CACvB,kCAAkC,IAAI,KAAK,QAAQ,IAAI,QAAQ,IAAI,CACpE,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,KAAsB;QACpC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,IAAI,SAAS;QACX,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/periodo/index.d.ts

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

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

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

package/dist/periodo/index.js

@@ -0,0 +1,3 @@
+export * from './periodo.js';
+export * from './anio.js';
+//# sourceMappingURL=index.js.map

package/dist/periodo/index.js.map

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

package/dist/periodo/periodo.d.ts

@@ -0,0 +1,19 @@
+/** A validated tax period at month granularity. Canonical machine form is `YYYYMM`
+ *  (what SII's portal payloads expect, e.g. RCV `ptributario`). In-house — mirrors
+ *  the `Rut` primitive's shape (parse / canonical / formatted). */
+export declare class Periodo {
+    readonly year: number;
+    readonly month: number;
+    private constructor();
+    /** Parse + validate. Accepts `YYYYMM`, and `YYYY-MM` / `YYYY/MM` / `YYYY.MM` with a
+     *  one- OR two-digit month (`2026-5` and `2026-05` both → May 2026). */
+    static parse(input: string): Periodo;
+    /** Build from numeric year + month, validating both. */
+    static of(year: number, month: number): Periodo;
+    static tryParse(input: string): Periodo | null;
+    /** Machine form SII expects: `YYYYMM` (e.g. `202606`). */
+    get canonical(): string;
+    /** Human form `YYYY-MM` (e.g. `2026-06`). */
+    get formatted(): string;
+}
+//# sourceMappingURL=periodo.d.ts.map

package/dist/periodo/periodo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"periodo.d.ts","sourceRoot":"","sources":["../../src/periodo/periodo.ts"],"names":[],"mappings":"AAOA;;mEAEmE;AACnE,qBAAa,OAAO;IAEhB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM;IAFxB,OAAO;IAKP;4EACwE;IACxE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAUpC,wDAAwD;IACxD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAY/C,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAQ9C,0DAA0D;IAC1D,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,6CAA6C;IAC7C,IAAI,SAAS,IAAI,MAAM,CAEtB;CACF"}

package/dist/periodo/periodo.js

@@ -0,0 +1,55 @@
+import { ValidationError } from '../errors/index.js';
+// SII's RCV launched Aug 2017; allow a generous margin and let SII reject truly
+// out-of-range periods server-side (verbatim). The bounds only catch typos locally.
+const MIN_YEAR = 2000;
+const MAX_YEAR = 2100;
+/** A validated tax period at month granularity. Canonical machine form is `YYYYMM`
+ *  (what SII's portal payloads expect, e.g. RCV `ptributario`). In-house — mirrors
+ *  the `Rut` primitive's shape (parse / canonical / formatted). */
+export class Periodo {
+    year;
+    month;
+    constructor(year, month) {
+        this.year = year;
+        this.month = month;
+    }
+    /** Parse + validate. Accepts `YYYYMM`, and `YYYY-MM` / `YYYY/MM` / `YYYY.MM` with a
+     *  one- OR two-digit month (`2026-5` and `2026-05` both → May 2026). */
+    static parse(input) {
+        const trimmed = input.trim();
+        const sep = /^(\d{4})[-/.](\d{1,2})$/.exec(trimmed);
+        if (sep)
+            return Periodo.of(Number(sep[1]), Number(sep[2]));
+        if (/^\d{6}$/.test(trimmed)) {
+            return Periodo.of(Number(trimmed.slice(0, 4)), Number(trimmed.slice(4)));
+        }
+        throw new ValidationError(`Período inválido: "${input}" (esperado YYYYMM o YYYY-MM).`);
+    }
+    /** Build from numeric year + month, validating both. */
+    static of(year, month) {
+        if (!Number.isInteger(month) || month < 1 || month > 12) {
+            throw new ValidationError(`Período con mes inválido: ${month} (esperado 1–12).`);
+        }
+        if (!Number.isInteger(year) || year < MIN_YEAR || year > MAX_YEAR) {
+            throw new ValidationError(`Período con año fuera de rango: ${year} (${MIN_YEAR}–${MAX_YEAR}).`);
+        }
+        return new Periodo(year, month);
+    }
+    static tryParse(input) {
+        try {
+            return Periodo.parse(input);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Machine form SII expects: `YYYYMM` (e.g. `202606`). */
+    get canonical() {
+        return `${String(this.year).padStart(4, '0')}${String(this.month).padStart(2, '0')}`;
+    }
+    /** Human form `YYYY-MM` (e.g. `2026-06`). */
+    get formatted() {
+        return `${String(this.year).padStart(4, '0')}-${String(this.month).padStart(2, '0')}`;
+    }
+}
+//# sourceMappingURL=periodo.js.map

package/dist/periodo/periodo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"periodo.js","sourceRoot":"","sources":["../../src/periodo/periodo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,gFAAgF;AAChF,oFAAoF;AACpF,MAAM,QAAQ,GAAG,IAAI,CAAC;AACtB,MAAM,QAAQ,GAAG,IAAI,CAAC;AAEtB;;mEAEmE;AACnE,MAAM,OAAO,OAAO;IAEP;IACA;IAFX,YACW,IAAY,EACZ,KAAa;QADb,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAQ;IACrB,CAAC;IAEJ;4EACwE;IACxE,MAAM,CAAC,KAAK,CAAC,KAAa;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,GAAG;YAAE,OAAO,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,IAAI,eAAe,CAAC,sBAAsB,KAAK,gCAAgC,CAAC,CAAC;IACzF,CAAC;IAED,wDAAwD;IACxD,MAAM,CAAC,EAAE,CAAC,IAAY,EAAE,KAAa;QACnC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;YACxD,MAAM,IAAI,eAAe,CAAC,6BAA6B,KAAK,mBAAmB,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,QAAQ,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;YAClE,MAAM,IAAI,eAAe,CACvB,mCAAmC,IAAI,KAAK,QAAQ,IAAI,QAAQ,IAAI,CACrE,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,KAAa;QAC3B,IAAI,CAAC;YACH,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,IAAI,SAAS;QACX,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACvF,CAAC;IAED,6CAA6C;IAC7C,IAAI,SAAS;QACX,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACxF,CAAC;CACF"}

package/dist/portal/bte-comunas.d.ts

@@ -0,0 +1,9 @@
+/** region index (1–16) → { comuna code → NAME } (SII internal codes, exactly as the form). */
+export declare const COMUNAS: Readonly<Record<number, Readonly<Record<number, string>>>>;
+/** A valid SII region index for BHE emission (1–16). */
+export declare function isRegion(cod: number): boolean;
+/** The comuna code belongs to the region (both must be the SII codes from GLB_comunas.js). */
+export declare function comunaInRegion(region: number, comuna: number): boolean;
+/** The comuna NAME the form sends as txt_comuna_destinatario, or null if the pair is unknown. */
+export declare function comunaName(region: number, comuna: number): string | null;
+//# sourceMappingURL=bte-comunas.d.ts.map

package/dist/portal/bte-comunas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bte-comunas.d.ts","sourceRoot":"","sources":["../../src/portal/bte-comunas.ts"],"names":[],"mappings":"AAOA,8FAA8F;AAC9F,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CA2X9E,CAAC;AAEF,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,iGAAiG;AACjG,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAExE"}