@albertomarturelo/sii-core 0.3.0

package/dist/portal/f22/shared.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import type { Rut } from '../../rut/index.js';
+import type { PortalSession } from '../../seams/index.js';
+export declare const F22_BASE: string;
+declare const Envelope: z.ZodObject<{
+    metaData: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        errors: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    errorMsg: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+    respCod: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+    data: z.ZodUnknown;
+}, z.core.$loose>;
+export type Envelope = z.infer<typeof Envelope>;
+export declare const aliasGet: (row: Record<string, unknown>, aliases: readonly string[]) => unknown;
+export declare const asStr: (v: unknown) => string | null;
+/** Like `asStr` but trims and maps blank → null. For wire fields SII space-pads or leaves
+ *  empty (`referencia`, `fechaCitacion`, `unidadSii`) — a blank string is "absent", not data. */
+export declare const trimToNull: (v: unknown) => string | null;
+/** Parse a código `valor`. SII serves montos in **es-CL format** — `.` = thousands, `,` =
+ *  decimals (confirmed live 2026-06-29; synthetic examples here: `"9.999"` = 9999,
+ *  `"12.345.678"` = 12345678). A bare `Number()` would misparse `"9.999"` as 9.999 (off by
+ *  1000×) and `"12.345.678"` as NaN (two dots). So strip the thousands dots and turn the
+ *  decimal comma into a dot before parsing. Plain integers (`"177"`, `-150000`) pass through. */
+export declare const asNumber: (v: unknown) => number | null;
+export declare const isObj: (v: unknown) => v is Record<string, unknown>;
+export declare function postSdi(session: PortalSession, url: string, namespace: string, data: Record<string, unknown>): Promise<Envelope>;
+export declare const rutDigits: (rut: Rut) => {
+    rut: string;
+    dv: string;
+};
+export {};
+//# sourceMappingURL=shared.d.ts.map

package/dist/portal/f22/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/portal/f22/shared.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEvE,eAAO,MAAM,QAAQ,QAAuE,CAAC;AAc7F,QAAA,MAAM,QAAQ;;;;;;;iBASJ,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,SAAS,MAAM,EAAE,KAAG,OAMnF,CAAC;AACF,eAAO,MAAM,KAAK,GAAI,GAAG,OAAO,KAAG,MAAM,GAAG,IACM,CAAC;AACnD;iGACiG;AACjG,eAAO,MAAM,UAAU,GAAI,GAAG,OAAO,KAAG,MAAM,GAAG,IAKhD,CAAC;AACF;;;;iGAIiG;AACjG,eAAO,MAAM,QAAQ,GAAI,GAAG,OAAO,KAAG,MAAM,GAAG,IAK9C,CAAC;AACF,eAAO,MAAM,KAAK,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CACzB,CAAC;AAiBtC,wBAAsB,OAAO,CAC3B,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,QAAQ,CAAC,CA6BnB;AAED,eAAO,MAAM,SAAS,GAAI,KAAK,GAAG,KAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAG5D,CAAC"}

package/dist/portal/f22/shared.js

@@ -0,0 +1,130 @@
+// F22 — Declaración Anual de Renta (estado / readback, read-only). Shared wire plumbing
+// for the per-view facades (declaraciones / grid / observaciones / historial). Ported from
+// the proven Python sii-cli (portal/f22.py); wire contract first-hand-observed there
+// (spike #67, live-captured 2026-06-27, prod), NOT a third-party library (ADR-004).
+// Full contract: docs/sii-contract/f22.md.
+//
+// The F22-status portal is the Angular SPA at `https://www4.sii.cl/consultaestadof22ui/`
+// — a DIFFERENT app from RCV's `consdcvinternetui` (own Referer), same SDI envelope.
+//
+// SESSION-KEYED (ADR-005): F22 authorizes by the session principal — confirmed live
+// 2026-06-27 that a persona's `--rut <empresa>` returns a CLEAN NEGATIVE, not the
+// empresa's F22. The body RUT does not redirect it; the empresa's F22 needs the
+// empresa's own session (logout→login). The task therefore defaults to self.
+//
+// PII: F22 exposes NO `raw` (unlike RCV) — the non-curated F22 data (decl
+// `nombres`/`calle`/`comuna`/`cta`/`bco` and the header códigos) is pure identity/bank
+// PII, not tax detail, so it never reaches a surface/LLM/audit. Error envelope is
+// `metaData.errors` (a list of {id, descripcion}) — NOT RCV's `respEstado.codRespuesta`.
+import { z } from 'zod';
+import { HOSTS } from '../../config/index.js';
+import { F22Error, NotAuthenticatedError } from '../../errors/index.js';
+export const F22_BASE = `${HOSTS.portalApi}/consultaestadof22ui/services/data/facadeService`;
+const CONVERSATION_COOKIE = 'TOKEN';
+// Per-surface headers — Referer is the F22-status SPA root (differs from RCV/F29).
+const HEADERS = {
+    'Content-Type': 'application/json',
+    Origin: HOSTS.portalApi,
+    Referer: `${HOSTS.portalApi}/consultaestadof22ui/`,
+    Accept: 'application/json, text/plain, */*',
+};
+// --- Wire envelope (zod-at-the-boundary, ADR-011) --------------------------------
+// F22's error channel is `metaData.errors` (NOT RCV's respEstado). Keep `errors` and
+// `data` opaque (shapes differ per endpoint) and extract tolerantly below.
+const Envelope = z
+    .object({
+    metaData: z.object({ errors: z.unknown().nullish() }).loose().nullish(),
+    // situacionObservacion ALSO signals errors via a top-level `errorMsg`/`respCod`
+    // (observed 2026-06-29); buscaDeclVgte/f22Compacto leave them absent. Keep both.
+    errorMsg: z.unknown().nullish(),
+    respCod: z.unknown().nullish(),
+    data: z.unknown(),
+})
+    .loose();
+export const aliasGet = (row, aliases) => {
+    for (const key of aliases) {
+        const v = row[key];
+        if (v !== undefined && v !== null)
+            return v;
+    }
+    return undefined;
+};
+export const asStr = (v) => v === null || v === undefined ? null : String(v);
+/** Like `asStr` but trims and maps blank → null. For wire fields SII space-pads or leaves
+ *  empty (`referencia`, `fechaCitacion`, `unidadSii`) — a blank string is "absent", not data. */
+export const trimToNull = (v) => {
+    const s = asStr(v);
+    if (s === null)
+        return null;
+    const t = s.trim();
+    return t === '' ? null : t;
+};
+/** Parse a código `valor`. SII serves montos in **es-CL format** — `.` = thousands, `,` =
+ *  decimals (confirmed live 2026-06-29; synthetic examples here: `"9.999"` = 9999,
+ *  `"12.345.678"` = 12345678). A bare `Number()` would misparse `"9.999"` as 9.999 (off by
+ *  1000×) and `"12.345.678"` as NaN (two dots). So strip the thousands dots and turn the
+ *  decimal comma into a dot before parsing. Plain integers (`"177"`, `-150000`) pass through. */
+export 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().replace(/\./g, '').replace(/,/g, '.'));
+    return Number.isFinite(n) ? n : null;
+};
+export const isObj = (v) => typeof v === 'object' && v !== 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. */
+function f22Error(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;
+}
+export async function postSdi(session, url, namespace, data) {
+    const conversationId = (await session.cookie(`${HOSTS.portalApi}/`, CONVERSATION_COOKIE)) ?? '';
+    const request = {
+        method: 'POST',
+        headers: HEADERS,
+        // F22 metaData omits `page` (observed); opaque per-request id via Web Crypto.
+        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.
+        if (e instanceof NotAuthenticatedError)
+            throw e;
+        throw new F22Error('Respuesta inesperada de SII (no es JSON).');
+    }
+    const parsed = Envelope.safeParse(raw);
+    if (!parsed.success)
+        throw new F22Error('Respuesta inesperada de SII (no es un objeto JSON del F22).');
+    const err = f22Error(parsed.data.metaData?.errors);
+    if (err)
+        throw new F22Error(err);
+    // situacionObservacion surfaces a business error via the top-level `errorMsg`
+    // (observed 2026-06-29); pass it verbatim (ADR-004).
+    const msg = asStr(parsed.data.errorMsg);
+    if (msg !== null && msg.trim() !== '')
+        throw new F22Error(msg);
+    return parsed.data;
+}
+export const rutDigits = (rut) => ({
+    rut: String(rut.body),
+    dv: rut.dv,
+});
+//# sourceMappingURL=shared.js.map

package/dist/portal/f22/shared.js.map

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

package/dist/portal/f22-codigos.d.ts

@@ -0,0 +1,28 @@
+/** One curated código of an F22 grid: the code, its parsed value (sign preserved), and the
+ *  official form label SII serves inline. This is the JSON-serializable unit the surfaces
+ *  render — pure data, no formatting. */
+export interface CodigoF22 {
+    readonly codigo: string;
+    readonly valor: number | null;
+    readonly glosa: string | null;
+}
+/** The full grid's non-PII códigos organized into the lines a contador reads (#27), each
+ *  sign-preserving. Identity/bank PII is already dropped upstream; these groups ORGANIZE the
+ *  rest, with `otros` catching any non-PII código not (yet) mapped — so nothing tax-relevant
+ *  is hidden. The union of the SIX equals the flat grid. */
+export interface F22Grupos {
+    readonly ingresos: readonly CodigoF22[];
+    readonly deducciones: readonly CodigoF22[];
+    readonly creditos: readonly CodigoF22[];
+    readonly calculo: readonly CodigoF22[];
+    readonly resultado: readonly CodigoF22[];
+    readonly otros: readonly CodigoF22[];
+}
+/** Is this código identity/bank PII (must be dropped from every grid)? */
+export declare function isHeaderCodigo(codigo: string): boolean;
+/** Organize the (already PII-dropped) grid into the lines a contador reads:
+ *  ingresos / deducciones / retenciones·PPM·créditos / cálculo / resultado, with `otros`
+ *  catching any non-PII código not yet mapped — so nothing tax-relevant is hidden. Order
+ *  within a group preserves the wire order; the union of the SIX equals the input. */
+export declare function groupCodigos(codigos: readonly CodigoF22[]): F22Grupos;
+//# sourceMappingURL=f22-codigos.d.ts.map

package/dist/portal/f22-codigos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"f22-codigos.d.ts","sourceRoot":"","sources":["../../src/portal/f22-codigos.ts"],"names":[],"mappings":"AAWA;;yCAEyC;AACzC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;4DAG4D;AAC5D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,SAAS,SAAS,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;IAGxC,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CACtC;AAoCD,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtD;AAqED;;;sFAGsF;AACtF,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAgBrE"}

package/dist/portal/f22-codigos.js

@@ -0,0 +1,141 @@
+// F22 código taxonomy — the DOMAIN knowledge of the Declaración Anual de Renta form,
+// separated from the wire facade (`f22.ts`). These two change for different reasons: the
+// facade changes when SII moves an endpoint or alters the envelope; this file changes when
+// we observe a new código and classify it. Everything here is derived from first-hand
+// observation of real declarations (cited inline) — no third-party legend (ADR-004).
+//
+// Two responsibilities:
+//   1. The PII denylist (`HEADER_CODIGOS`) — which códigos are identity/bank, hence dropped.
+//   2. The contador grouping (`groupCodigos`) — how the remaining tax códigos organize into
+//      the lines a person reads (ingresos / deducciones / retenciones·PPM·créditos / resultado).
+// HEADER / PII códigos — DROPPED from every curated grid (F22 has no `raw`, so these never
+// surface anywhere). Authoritative basis: `codigosFormato.codigosCabecera` (the form skeleton,
+// live 2026-06-29) lists the 12 header códigos 1/2/3/5/6/7/8/9/13/14/55/903 (apellidos/RUT/
+// nombres/calle/folio/comuna/giro/región?/email + 9,903). To those we add the date/moneda
+// metadata (15,53,315,8811) and the bank/identity códigos that live in the BODY, not the
+// cabecera: 301/306/780 (banco/cuenta/tipo), 9306 (código de banco), 9920 (dirección origen),
+// and 8809 (the RUT again as a bare integer — caught leaking via test MF3). Small + bounded +
+// authoritative, so the denylist stays comprehensive (we never allowlist tax códigos — that
+// hides real income; see CONVENTIONS).
+const HEADER_CODIGOS = new Set([
+    '1',
+    '2',
+    '3',
+    '5',
+    '6',
+    '7',
+    '8',
+    '9',
+    '13',
+    '14',
+    '15',
+    '53',
+    '55',
+    '315',
+    '903',
+    '8809',
+    '8811',
+    '301',
+    '306',
+    '780',
+    '9306',
+    '9920',
+]);
+/** Is this código identity/bank PII (must be dropped from every grid)? */
+export function isHeaderCodigo(codigo) {
+    return HEADER_CODIGOS.has(codigo);
+}
+// Semantic código → group map for the `--full` grid (#27). The grid already dropped PII; these
+// groups ORGANIZE the remaining (non-PII) tax códigos — anything not mapped falls through to
+// `otros` (VISIBLE, never hidden), so the readback stays COMPLETE. Derived from glosas observed
+// LIVE across AT 2023–2026 (own account, 2026-06-29); extend it (move a código from `otros` into
+// a group) with an `// observed …` citation as new códigos appear (ADR-004).
+const INGRESOS_CODIGOS = new Set([
+    '110', // Rentas percibidas art 42 Nº2 (honorarios)
+    '155', // Rentas de capitales mobiliarios (art 20 Nº2)
+    '161', // Rta Art 42 Nº1
+    '170', // BASE IMPONIBLE ANUAL DE IUSC o IGC
+    '461', // Honorarios Anuales Con Retención
+    '467', // Total Honorarios
+    '545', // Honorarios Anuales Sin Retención
+    '547', // Total Ingresos Brutos
+    '618', // Total Rentas y Retenciones
+    '645', // CPT positivo final
+    '646', // CPT negativo final (par de 645 — surfaced via `otros` live 2026-06-29, AT 2026)
+    '1098', // Sueldos, pensiones y otras rentas
+    '1813', // enajenación/rescate art 107 (recuadro)
+    '1814',
+    '1816',
+    '1829',
+    '1830',
+    '1867', // Rentas de capitales mobiliarios (recuadro)
+]);
+const DEDUCCIONES_CODIGOS = new Set([
+    '169', // Pérdida en operaciones de capitales mobiliarios
+    '494', // Gastos presuntos 30% sobre el código 547
+    '900', // Cargo por cotizaciones previsionales
+]);
+// "Retenciones · PPM · Créditos" — retenciones de honorarios, pagos provisionales y créditos.
+const CREDITOS_CODIGOS = new Set([
+    '36', // PPM / Pagos provisionales
+    '119', // Remanente de crédito por reliquidación del IUSC
+    '162', // Crédito al IGC o IUSC
+    '198', // Retenciones por rentas declaradas en código 110
+    '492', // Impuesto Retenido de Honorarios Con Retención
+    '611', // Retenciones Recuadro Nº1
+    '619', // Impuesto Retenido del Total Rentas y Retenciones
+    '757', // Remanente código 119 y código 116
+    '849', // Pago Provisional (art 84) / Rebaja Crédito AFP
+    '1905', // PPM de segunda categoría art 84 letra b)
+]);
+// Intermediate IGC/IUSC computation steps — NOT final outcomes. Split out of `resultado`
+// (#28 review): a "SUB TOTAL" / "según tabla" / "débito fiscal" is a calc step, not a result.
+// Surfaced in its own `calculo` group (never hidden — they're real tax códigos).
+const CALCULO_CODIGOS = new Set([
+    '157', // IGC o IUSC, según tabla
+    '158', // SUB TOTAL
+    '304', // IGC o IUSC, débito fiscal / tasa adicional
+]);
+const RESULTADO_CODIGOS = new Set([
+    '31', // IGC o IUSC, tasa adicional
+    '39', // Reajuste art.72
+    '85', // Saldo a Favor
+    '86', // Saldo Puesto a Disposición de los Socios
+    '87', // Monto devolución solicitada
+    '90', // Impuesto Adeudado
+    '91', // TOTAL A PAGAR (90+39)
+    '92', // Reajustes Declaración Fuera de Plazo
+    '93', // Intereses y Multas Declaración Fuera de Plazo
+    '94', // TOTAL A PAGAR (91+92+93)
+    '98', // (codigosPie — total/giro)
+    '305', // RESULTADO LIQUIDACIÓN ANUAL
+    '795', // (codigosPie — total/giro)
+]);
+/** Organize the (already PII-dropped) grid into the lines a contador reads:
+ *  ingresos / deducciones / retenciones·PPM·créditos / cálculo / resultado, with `otros`
+ *  catching any non-PII código not yet mapped — so nothing tax-relevant is hidden. Order
+ *  within a group preserves the wire order; the union of the SIX equals the input. */
+export function groupCodigos(codigos) {
+    const ingresos = [];
+    const deducciones = [];
+    const creditos = [];
+    const calculo = [];
+    const resultado = [];
+    const otros = [];
+    for (const c of codigos) {
+        if (INGRESOS_CODIGOS.has(c.codigo))
+            ingresos.push(c);
+        else if (DEDUCCIONES_CODIGOS.has(c.codigo))
+            deducciones.push(c);
+        else if (CREDITOS_CODIGOS.has(c.codigo))
+            creditos.push(c);
+        else if (CALCULO_CODIGOS.has(c.codigo))
+            calculo.push(c);
+        else if (RESULTADO_CODIGOS.has(c.codigo))
+            resultado.push(c);
+        else
+            otros.push(c); // non-PII, unmapped — still surfaced
+    }
+    return { ingresos, deducciones, creditos, calculo, resultado, otros };
+}
+//# sourceMappingURL=f22-codigos.js.map

package/dist/portal/f22-codigos.js.map

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

package/dist/portal/f29-codigos.d.ts

@@ -0,0 +1,15 @@
+export type F29Grupo = 'debitos' | 'creditos' | 'retenciones' | 'otros' | 'totales';
+export interface CodigoF29Meta {
+    readonly glosa: string;
+    /** Sign in the form: '+' suma, '-' resta, '=' total/subtotal, '' header/sin signo. */
+    readonly signo: '+' | '-' | '=' | '';
+    readonly grupo: F29Grupo;
+}
+/** Human labels for each group (the contador reading order). */
+export declare const F29_GRUPO_LABELS: Record<F29Grupo, string>;
+export declare const F29_CODIGOS: Record<string, CodigoF29Meta>;
+/** Glosa for a código, or null when unobserved (then label it by its number). */
+export declare function glosaF29(codigo: string): string | null;
+/** Group for a código; an unobserved código → 'otros' (surfaced, never hidden). */
+export declare function grupoF29(codigo: string): F29Grupo;
+//# sourceMappingURL=f29-codigos.d.ts.map

package/dist/portal/f29-codigos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"f29-codigos.d.ts","sourceRoot":"","sources":["../../src/portal/f29-codigos.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;CAC1B;AAED,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAMrD,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAgjBrD,CAAC;AAEF,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEtD;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAEjD"}