@baruk/core 0.4.2 → 0.6.0

package/dist/cjs/db/provision-e2e-identity.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Provisiona a identidade de automação E2E de um escritório.
+ *
+ * ## Por que é um script, e não uma rota
+ *
+ * Criar a identidade que valida o produto é ato de PROVISIONAMENTO, não de
+ * operação. Expor isso como rota daria a alguém dentro do produto o poder de
+ * fabricar uma conta de automação — e o valor de uma identidade de privilégio
+ * mínimo desaparece se qualquer administrador puder criar outra.
+ *
+ * ## O que ele garante
+ *
+ * - `user_type = 'service'` — reconhecível como não-humana em toda consulta;
+ * - papel `e2e_automation` e nada além: cinco permissões, tenant único;
+ * - idempotente: rodar de novo não duplica nem escala privilégio;
+ * - a senha vem do ambiente e **nunca** é impressa, ecoada ou gravada em log.
+ *
+ * ## Uso
+ *
+ *   OFFICE_MIGRATION_DATABASE_URL=… \
+ *   E2E_IDENTITY_EMAIL=… E2E_IDENTITY_PASSWORD=… \
+ *   pnpm --filter @baruk/core provision:e2e --tenant sc
+ *
+ * Revogar é o caminho inverso e existe na interface: Administração → Usuários →
+ * situação "revogado". Rotacionar é rodar de novo com `--rotate` e uma senha
+ * nova.
+ */
+const client_js_1 = require("./client.js");
+const context_js_1 = require("./context.js");
+const provisioning_js_1 = require("../tenancy/provisioning.js");
+const catalog_js_1 = require("../rbac/catalog.js");
+const service_js_1 = require("../auth/service.js");
+const ROLE = 'e2e_automation';
+function arg(nome, padrao) {
+    const i = process.argv.indexOf(`--${nome}`);
+    return i >= 0 ? (process.argv[i + 1] ?? padrao) : padrao;
+}
+async function main() {
+    const url = process.env.OFFICE_MIGRATION_DATABASE_URL ?? process.env.DATABASE_URL;
+    const email = process.env.E2E_IDENTITY_EMAIL;
+    const senha = process.env.E2E_IDENTITY_PASSWORD;
+    const tenantCode = arg('tenant', 'sc');
+    const rotate = process.argv.includes('--rotate');
+    if (!url)
+        throw new Error('OFFICE_MIGRATION_DATABASE_URL ausente.');
+    if (!email)
+        throw new Error('E2E_IDENTITY_EMAIL ausente.');
+    if (!senha || senha.length < 24) {
+        throw new Error('E2E_IDENTITY_PASSWORD ausente ou curta demais (mínimo 24 caracteres).');
+    }
+    const db = (0, client_js_1.createDb)(url, { role: 'owner', max: 2 });
+    try {
+        const [tenant] = await db `
+      SELECT id FROM tenant WHERE code = ${tenantCode} AND deleted_at IS NULL
+    `;
+        if (!tenant)
+            throw new Error(`Organização "${tenantCode}" não encontrada.`);
+        // `user_type: 'service'` é o que separa esta conta de uma pessoa. O tipo já
+        // existe no domínio e na constraint do banco desde a identidade do Core —
+        // não é campo inventado para este caso.
+        const user = await (0, service_js_1.upsertUserWithPassword)(db, {
+            email,
+            fullName: 'Automação de teste (E2E)',
+            password: senha,
+            userType: 'service',
+            overwritePassword: rotate,
+        });
+        await (0, provisioning_js_1.ensureMembership)(db, tenant.id, user.id);
+        await (0, provisioning_js_1.assignSystemRole)(db, tenant.id, user.id, ROLE);
+        // Conferência de saída: o que foi concedido é exatamente o esperado.
+        const permissoes = await (0, context_js_1.withContext)(db, { tenantId: tenant.id, userId: user.id }, async (tx) => {
+            const rows = await tx `
+        SELECT p.key
+          FROM user_role ur
+          JOIN role r ON r.id = ur.role_id
+          JOIN role_permission rp ON rp.role_id = r.id
+          JOIN permission p ON p.id = rp.permission_id
+         WHERE ur.user_id = ${user.id} AND ur.deleted_at IS NULL
+         ORDER BY p.key
+      `;
+            return rows.map((r) => r.key);
+        });
+        // Nada de e-mail, id ou senha na saída: só o que se precisa conferir.
+        console.log(`✓ identidade E2E provisionada em "${tenantCode}"`);
+        console.log(`  tipo: service`);
+        console.log(`  papel: ${ROLE}`);
+        console.log(`  permissões (${permissoes.length}): ${permissoes.join(', ')}`);
+        console.log(`  senha definida nesta execução: ${user.passwordWasSet ? 'sim' : 'não (já existia)'}`);
+        // O número vem do catálogo, e não de um literal repetido aqui: duas cópias
+        // da mesma régua divergem, e a divergência aparece como um provisionamento
+        // que aborta sem motivo — ou, pior, que aceita uma permissão a mais.
+        const esperadas = catalog_js_1.SYSTEM_ROLES.find((r) => r.key === ROLE)?.permissions.length ?? 0;
+        if (permissoes.length !== esperadas) {
+            throw new Error(`Esperava ${esperadas} permissões e encontrei ${permissoes.length}. Abortando: uma identidade de automação com privilégio a mais não deve ficar de pé.`);
+        }
+    }
+    finally {
+        await db.end({ timeout: 5 });
+    }
+}
+/**
+ * Erro de driver de banco costuma trazer a connection string inteira dentro da
+ * mensagem. Quem redige tem de ser a ferramenta: confiar em quem chama é
+ * confiar que ninguém vai esquecer o filtro uma vez.
+ */
+function semSegredo(err) {
+    const bruto = err instanceof Error ? err.message : String(err);
+    return bruto.replace(/postgres(?:ql)?:\/\/\S+/gi, '[connection string redigida]');
+}
+main().catch((err) => {
+    console.error('✗ provisionamento falhou:', semSegredo(err));
+    process.exit(1);
+});
+//# sourceMappingURL=provision-e2e-identity.js.map

package/dist/cjs/db/provision-e2e-identity.js.map

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

package/dist/cjs/fiscal/applicability.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decideApplicability = decideApplicability;
+exports.generates = generates;
+const conditions_js_1 = require("./conditions.js");
+const semRegra = (reason) => ({
+    outcome: 'RULE_NOT_CONFIGURED',
+    reason,
+    evidence: {
+        ruleId: null,
+        ruleVersion: null,
+        jurisdiction: null,
+        missingAttributes: [],
+        consideredAttributes: [],
+    },
+});
+/**
+ * A regra alcança este cliente geograficamente?
+ *
+ * Federal alcança todos. Estadual exige UF igual. Municipal exige UF **e**
+ * código IBGE iguais — nome de município não entra na comparação, porque
+ * "Goiania" e "Goiânia" são o mesmo lugar e strings diferentes.
+ *
+ * Cliente sem a informação não é "fora": é desconhecido, e vira
+ * `INSUFFICIENT_DATA` em vez de sumir da lista.
+ */
+function jurisdictionMatch(rule, client) {
+    if (rule.scope === 'federal')
+        return 'match';
+    if (client.uf === null)
+        return 'unknown';
+    if (client.uf !== rule.uf)
+        return 'no_match';
+    if (rule.scope === 'state')
+        return 'match';
+    if (client.cityIbge === null)
+        return 'unknown';
+    return client.cityIbge === rule.cityIbge ? 'match' : 'no_match';
+}
+/** A competência cai dentro da vigência? Compara datas ISO, sem fuso. */
+function withinValidity(rule, referenceDate) {
+    if (referenceDate < rule.validFrom)
+        return false;
+    return rule.validUntil === null || referenceDate <= rule.validUntil;
+}
+function decideApplicability(input) {
+    const { rule, profile, clientJurisdiction, referenceDate } = input;
+    if (!rule) {
+        return semRegra('Não há regra cadastrada para esta obrigação nesta jurisdição.');
+    }
+    const jurisdiction = rule.jurisdiction;
+    const base = { ruleId: rule.id, ruleVersion: rule.version, jurisdiction };
+    // ── 1 · Estado da regra, antes de qualquer coisa do cliente ─────────────
+    if (rule.status === 'disabled') {
+        return {
+            outcome: 'RULE_DISABLED',
+            reason: 'A regra está desligada.',
+            evidence: { ...base, missingAttributes: [], consideredAttributes: [] },
+        };
+    }
+    if (rule.status === 'not_configured') {
+        return {
+            outcome: 'RULE_NOT_CONFIGURED',
+            reason: 'A regra existe como marcador, mas ninguém configurou jurisdição ou vencimento — não há data a aplicar.',
+            evidence: { ...base, missingAttributes: [], consideredAttributes: [] },
+        };
+    }
+    // ── 2 · Vigência ────────────────────────────────────────────────────────
+    if (!withinValidity(rule, referenceDate)) {
+        const futura = referenceDate < rule.validFrom;
+        return {
+            outcome: futura ? 'RULE_NOT_CONFIGURED' : 'RULE_EXPIRED',
+            reason: futura
+                ? `A regra só passa a valer em ${rule.validFrom}; para esta competência não há regra vigente.`
+                : `A regra deixou de valer em ${rule.validUntil}.`,
+            evidence: { ...base, missingAttributes: [], consideredAttributes: [] },
+        };
+    }
+    if (rule.status === 'expired') {
+        return {
+            outcome: 'RULE_EXPIRED',
+            reason: 'A regra está marcada como vencida.',
+            evidence: { ...base, missingAttributes: [], consideredAttributes: [] },
+        };
+    }
+    // ── 3 · Jurisdição ──────────────────────────────────────────────────────
+    const geo = jurisdictionMatch(jurisdiction, clientJurisdiction);
+    if (geo === 'no_match') {
+        return {
+            outcome: 'NOT_APPLICABLE',
+            reason: jurisdiction.scope === 'state'
+                ? `Regra de ${jurisdiction.uf}; o cliente está em ${clientJurisdiction.uf}.`
+                : 'A regra é de outro município.',
+            evidence: { ...base, missingAttributes: [], consideredAttributes: [] },
+        };
+    }
+    if (geo === 'unknown') {
+        const falta = jurisdiction.scope === 'state' ? 'UF' : 'código IBGE do município';
+        return {
+            outcome: 'INSUFFICIENT_DATA',
+            reason: `Falta ${falta} no cadastro do cliente para saber se esta regra o alcança.`,
+            evidence: {
+                ...base,
+                missingAttributes: [jurisdiction.scope === 'state' ? 'state_uf' : 'municipality_ibge_code'],
+                consideredAttributes: [],
+            },
+        };
+    }
+    // ── 4 · Condições declarativas ──────────────────────────────────────────
+    let condition;
+    try {
+        condition = (0, conditions_js_1.parseCondition)(rule.conditions);
+    }
+    catch (err) {
+        // Regra malformada é defeito do catálogo, não decisão sobre o cliente.
+        // Nunca vira "não se aplica": isso esconderia a obrigação.
+        return {
+            outcome: 'RULE_NOT_CONFIGURED',
+            reason: `A condição desta regra está malformada: ${err instanceof Error ? err.message : 'inválida'}.`,
+            evidence: { ...base, missingAttributes: [], consideredAttributes: [] },
+        };
+    }
+    const considerados = [...(0, conditions_js_1.referencedAttributes)(condition)].sort();
+    const faltando = (0, conditions_js_1.missingAttributes)(condition, profile);
+    const veredito = (0, conditions_js_1.evaluate)(condition, profile);
+    if (veredito === 'unknown') {
+        return {
+            outcome: 'INSUFFICIENT_DATA',
+            reason: faltando.length === 1
+                ? `Falta informar "${faltando[0]}" no perfil do cliente.`
+                : `Faltam informações no perfil do cliente: ${faltando.join(', ')}.`,
+            evidence: { ...base, missingAttributes: faltando, consideredAttributes: considerados },
+        };
+    }
+    if (veredito === false) {
+        return {
+            outcome: 'NOT_APPLICABLE',
+            reason: 'O perfil do cliente não atende às condições desta regra.',
+            evidence: { ...base, missingAttributes: [], consideredAttributes: considerados },
+        };
+    }
+    // ── 5 · Conferência humana, por último ──────────────────────────────────
+    //
+    // Fica depois da aplicabilidade de propósito: dizer "pendente de conferência"
+    // sobre uma regra que nem se aplica a este cliente mandaria o escritório
+    // conferir o que não usaria.
+    if (rule.status === 'pending_validation') {
+        return {
+            outcome: 'RULE_PENDING_VALIDATION',
+            reason: 'A regra se aplica, mas ainda não foi conferida por uma pessoa.',
+            evidence: { ...base, missingAttributes: [], consideredAttributes: considerados },
+        };
+    }
+    return {
+        outcome: 'APPLICABLE',
+        reason: 'A regra está vigente, conferida, e o perfil do cliente a atende.',
+        evidence: { ...base, missingAttributes: [], consideredAttributes: considerados },
+    };
+}
+/** Só `APPLICABLE` gera. Todo o resto é espera, ausência ou decisão contrária. */
+function generates(decision) {
+    return decision.outcome === 'APPLICABLE';
+}
+//# sourceMappingURL=applicability.js.map

package/dist/cjs/fiscal/applicability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applicability.js","sourceRoot":"","sources":["../../../src/fiscal/applicability.ts"],"names":[],"mappings":";;AAmIA,kDA8HC;AAGD,8BAEC;AAtQD,mDAOyB;AAwEzB,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAyB,EAAE,CAAC,CAAC;IAC3D,OAAO,EAAE,qBAAqB;IAC9B,MAAM;IACN,QAAQ,EAAE;QACR,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE,IAAI;QAClB,iBAAiB,EAAE,EAAE;QACrB,oBAAoB,EAAE,EAAE;KACzB;CACF,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,SAAS,iBAAiB,CACxB,IAAqB,EACrB,MAA0B;IAE1B,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC7C,IAAI,MAAM,CAAC,EAAE,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE;QAAE,OAAO,UAAU,CAAC;IAC7C,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAC3C,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC/C,OAAO,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;AAClE,CAAC;AAED,yEAAyE;AACzE,SAAS,cAAc,CAAC,IAAmB,EAAE,aAAqB;IAChE,IAAI,aAAa,GAAG,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACjD,OAAO,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,aAAa,IAAI,IAAI,CAAC,UAAU,CAAC;AACtE,CAAC;AAcD,SAAgB,mBAAmB,CAAC,KAAyB;IAC3D,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IAEnE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,QAAQ,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACvC,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;IAE1E,2EAA2E;IAC3E,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO;YACL,OAAO,EAAE,eAAe;YACxB,MAAM,EAAE,yBAAyB;YACjC,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,oBAAoB,EAAE,EAAE,EAAE;SACvE,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;QACrC,OAAO;YACL,OAAO,EAAE,qBAAqB;YAC9B,MAAM,EACJ,wGAAwG;YAC1G,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,oBAAoB,EAAE,EAAE,EAAE;SACvE,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;QAC9C,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,cAAc;YACxD,MAAM,EAAE,MAAM;gBACZ,CAAC,CAAC,+BAA+B,IAAI,CAAC,SAAS,+CAA+C;gBAC9F,CAAC,CAAC,8BAA8B,IAAI,CAAC,UAAU,GAAG;YACpD,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,oBAAoB,EAAE,EAAE,EAAE;SACvE,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO;YACL,OAAO,EAAE,cAAc;YACvB,MAAM,EAAE,oCAAoC;YAC5C,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,oBAAoB,EAAE,EAAE,EAAE;SACvE,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,MAAM,GAAG,GAAG,iBAAiB,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;IAChE,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,gBAAgB;YACzB,MAAM,EACJ,YAAY,CAAC,KAAK,KAAK,OAAO;gBAC5B,CAAC,CAAC,YAAY,YAAY,CAAC,EAAE,uBAAuB,kBAAkB,CAAC,EAAE,GAAG;gBAC5E,CAAC,CAAC,+BAA+B;YACrC,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,oBAAoB,EAAE,EAAE,EAAE;SACvE,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,0BAA0B,CAAC;QACjF,OAAO;YACL,OAAO,EAAE,mBAAmB;YAC5B,MAAM,EAAE,SAAS,KAAK,6DAA6D;YACnF,QAAQ,EAAE;gBACR,GAAG,IAAI;gBACP,iBAAiB,EAAE,CAAC,YAAY,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,wBAAwB,CAAC;gBAC3F,oBAAoB,EAAE,EAAE;aACzB;SACF,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,IAAI,SAAoB,CAAC;IACzB,IAAI,CAAC;QACH,SAAS,GAAG,IAAA,8BAAc,EAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,uEAAuE;QACvE,2DAA2D;QAC3D,OAAO;YACL,OAAO,EAAE,qBAAqB;YAC9B,MAAM,EAAE,2CAA2C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,GAAG;YACrG,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,oBAAoB,EAAE,EAAE,EAAE;SACvE,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,GAAG,IAAA,oCAAoB,EAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAA,iCAAiB,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,IAAA,wBAAQ,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAE9C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,mBAAmB;YAC5B,MAAM,EACJ,QAAQ,CAAC,MAAM,KAAK,CAAC;gBACnB,CAAC,CAAC,mBAAmB,QAAQ,CAAC,CAAC,CAAC,yBAAyB;gBACzD,CAAC,CAAC,4CAA4C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACxE,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,YAAY,EAAE;SACvF,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,gBAAgB;YACzB,MAAM,EAAE,0DAA0D;YAClE,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,oBAAoB,EAAE,YAAY,EAAE;SACjF,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,EAAE;IACF,8EAA8E;IAC9E,yEAAyE;IACzE,6BAA6B;IAC7B,IAAI,IAAI,CAAC,MAAM,KAAK,oBAAoB,EAAE,CAAC;QACzC,OAAO;YACL,OAAO,EAAE,yBAAyB;YAClC,MAAM,EAAE,gEAAgE;YACxE,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,oBAAoB,EAAE,YAAY,EAAE;SACjF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,kEAAkE;QAC1E,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,oBAAoB,EAAE,YAAY,EAAE;KACjF,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,SAAgB,SAAS,CAAC,QAA+B;IACvD,OAAO,QAAQ,CAAC,OAAO,KAAK,YAAY,CAAC;AAC3C,CAAC"}

package/dist/cjs/fiscal/collection/authorization.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthorizationConflictError = void 0;
+exports.grantRunAuthorization = grantRunAuthorization;
+exports.consumeRunAuthorization = consumeRunAuthorization;
+exports.revokeRunAuthorization = revokeRunAuthorization;
+exports.listRunAuthorizations = listRunAuthorizations;
+const shared_1 = require("@baruk/shared");
+const competence_js_1 = require("./competence.js");
+class AuthorizationConflictError extends Error {
+    detail;
+    constructor(detail) {
+        super(`autorização recusada: ${detail}`);
+        this.detail = detail;
+        this.name = 'AuthorizationConflictError';
+    }
+}
+exports.AuthorizationConflictError = AuthorizationConflictError;
+const DEFAULT_VALIDITY_HOURS = 48;
+const MAX_VALIDITY_HOURS = 168; // sete dias
+/**
+ * Emite a autorização.
+ *
+ * Recusa por CONFLITO quando já existe uma viva para o mesmo par
+ * (cliente, fonte, ambiente, competência) — não por capricho de unicidade, mas
+ * porque duas autorizações vivas somam duas execuções, e o produto teria
+ * prometido uma.
+ *
+ * A unicidade é do índice parcial da 0060; o `SELECT` prévio existe só para
+ * devolver um erro legível em vez de uma violação de constraint.
+ */
+async function grantRunAuthorization(tx, input) {
+    const competence = (0, competence_js_1.competenceOf)(input.competenceYear, input.competenceMonth);
+    const periodStart = input.periodStart ?? competence.periodStart;
+    const periodEnd = input.periodEnd ?? competence.periodEnd;
+    (0, competence_js_1.validateWindow)(competence, periodStart, periodEnd);
+    const hours = input.validForHours ?? DEFAULT_VALIDITY_HOURS;
+    if (!Number.isInteger(hours) || hours < 1 || hours > MAX_VALIDITY_HOURS) {
+        throw new AuthorizationConflictError(`validade deve estar entre 1 e ${MAX_VALIDITY_HOURS} horas`);
+    }
+    const live = await tx `
+    SELECT id FROM fiscal_run_authorization
+     WHERE client_id = ${input.clientId}
+       AND source = ${input.source}
+       AND environment = ${input.environment}
+       AND competence_year = ${competence.year}
+       AND competence_month = ${competence.month}
+       AND consumed_at IS NULL AND revoked_at IS NULL
+     LIMIT 1
+  `;
+    if (live[0]) {
+        throw new AuthorizationConflictError('já existe uma autorização viva para este cliente, fonte, ambiente e competência');
+    }
+    const rows = await tx `
+    INSERT INTO fiscal_run_authorization (
+      id, tenant_id, client_id, document_type, environment, source, credential_kind,
+      operation, competence_year, competence_month, period_start, period_end,
+      max_runs, runs_consumed, authorized_by, responsible_name, expires_at,
+      first_contact, trigger_kind, credential_fingerprint
+    ) VALUES (
+      ${(0, shared_1.uuidv7)()}, current_setting('app.current_tenant')::uuid, ${input.clientId},
+      ${input.documentType}, ${input.environment}, ${input.source},
+      ${input.credentialKind ?? 'certificate_a1'},
+      'READ_ONLY', ${competence.year}, ${competence.month}, ${periodStart}, ${periodEnd},
+      1, 0, ${input.authorizedBy}, ${input.responsibleName ?? null},
+      now() + (${hours}::int * interval '1 hour'),
+      ${input.firstContact ?? false}, ${input.triggerKind ?? 'manual'},
+      ${input.credentialFingerprint ?? null}
+    )
+    RETURNING ${tx.unsafe(AUTHORIZATION_COLUMNS)}
+  `;
+    return mapAuthorization(rows[0]);
+}
+/**
+ * Consome a autorização — e é AQUI que a unicidade da execução acontece.
+ *
+ * Um `SELECT` seguido de `UPDATE` deixaria a janela em que dois processos leem
+ * "viva" e ambos executam. O `WHERE consumed_at IS NULL` dentro do próprio
+ * `UPDATE` fecha essa janela no banco: o segundo afeta zero linhas e recebe
+ * `null`, que é o sinal de "não execute".
+ *
+ * Devolve `null` — e não lança — para todo desfecho de recusa. Quem chama é o
+ * orquestrador no meio de uma carteira, e uma exceção aqui derrubaria o lote por
+ * causa de um portão fechado, que é estado normal.
+ */
+async function consumeRunAuthorization(tx, input) {
+    const rows = await tx `
+    UPDATE fiscal_run_authorization SET
+      runs_consumed = runs_consumed + 1,
+      consumed_at = now(),
+      consumed_by_run_id = ${input.runId},
+      updated_at = now()
+    WHERE id = ${input.authorizationId}
+      AND consumed_at IS NULL
+      AND revoked_at IS NULL
+      AND expires_at > now()
+      AND runs_consumed < max_runs
+    RETURNING ${tx.unsafe(AUTHORIZATION_COLUMNS)}
+  `;
+    return rows[0] ? mapAuthorization(rows[0]) : null;
+}
+/**
+ * Cancela antes da execução.
+ *
+ * O mecanismo de abortar (C1.34) não precisa de tabela nova: revogar a
+ * autorização é o cancelamento, porque sem ela não há execução real. Revogar uma
+ * já consumida é permitido e não desfaz nada — só registra a decisão, para o
+ * caso em que alguém descobre depois que não deveria ter autorizado.
+ */
+async function revokeRunAuthorization(tx, input) {
+    const rows = await tx `
+    UPDATE fiscal_run_authorization SET
+      revoked_at = now(), revoked_by = ${input.revokedBy},
+      revoke_reason = ${input.reason}, updated_at = now()
+    WHERE id = ${input.authorizationId} AND revoked_at IS NULL
+    RETURNING id
+  `;
+    return rows.count > 0;
+}
+/** As autorizações de um cliente, mais recentes primeiro. Sem segredo por construção. */
+async function listRunAuthorizations(tx, clientId) {
+    const rows = await tx `
+    SELECT ${tx.unsafe(AUTHORIZATION_COLUMNS)}
+      FROM fiscal_run_authorization
+     WHERE client_id = ${clientId}
+     ORDER BY authorized_at DESC
+     LIMIT 50
+  `;
+    return rows.map(mapAuthorization);
+}
+const AUTHORIZATION_COLUMNS = `
+  id, client_id, document_type, environment, source, credential_kind, operation,
+  competence_year, competence_month, period_start, period_end, max_runs, runs_consumed,
+  authorized_by, authorized_at, responsible_name, expires_at, consumed_at,
+  revoked_at, revoke_reason, first_contact, trigger_kind, credential_fingerprint
+`;
+function mapAuthorization(r) {
+    return {
+        id: r.id,
+        clientId: r.client_id,
+        documentType: r.document_type,
+        environment: r.environment,
+        source: r.source,
+        credentialKind: r.credential_kind,
+        operation: 'READ_ONLY',
+        competence: {
+            year: r.competence_year,
+            month: r.competence_month,
+            label: `${r.competence_year}-${String(r.competence_month).padStart(2, '0')}`,
+            periodStart: isoDate(r.period_start),
+            periodEnd: isoDate(r.period_end),
+        },
+        maxRuns: r.max_runs,
+        runsConsumed: r.runs_consumed,
+        authorizedBy: r.authorized_by,
+        authorizedAt: r.authorized_at.toISOString(),
+        responsibleName: r.responsible_name,
+        firstContact: r.first_contact ?? false,
+        triggerKind: r.trigger_kind ?? 'manual',
+        credentialFingerprint: r.credential_fingerprint ?? null,
+        expiresAt: r.expires_at.toISOString(),
+        consumedAt: r.consumed_at?.toISOString() ?? null,
+        revokedAt: r.revoked_at?.toISOString() ?? null,
+        revokeReason: r.revoke_reason,
+        state: stateOf(r),
+    };
+}
+/**
+ * A ordem das perguntas importa: revogada vence consumida, que vence vencida.
+ *
+ * Uma autorização consumida e depois revogada deve aparecer como revogada — é a
+ * decisão mais recente, e é a que alguém precisa ver ao investigar.
+ */
+function stateOf(r) {
+    if (r.revoked_at)
+        return 'revoked';
+    if (r.consumed_at)
+        return 'consumed';
+    if (r.expires_at.getTime() <= Date.now())
+        return 'expired';
+    return 'live';
+}
+function isoDate(d) {
+    return d.toISOString().slice(0, 10);
+}
+//# sourceMappingURL=authorization.js.map

package/dist/cjs/fiscal/collection/authorization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorization.js","sourceRoot":"","sources":["../../../../src/fiscal/collection/authorization.ts"],"names":[],"mappings":";;;AAwIA,sDAmDC;AAcD,0DAkBC;AAUD,wDAYC;AAGD,sDAYC;AAhQD,0CAAuC;AAOvC,mDAAsF;AAwEtF,MAAa,0BAA2B,SAAQ,KAAK;IAC9B;IAArB,YAAqB,MAAc;QACjC,KAAK,CAAC,yBAAyB,MAAM,EAAE,CAAC,CAAC;QADtB,WAAM,GAAN,MAAM,CAAQ;QAEjC,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AALD,gEAKC;AAsCD,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAClC,MAAM,kBAAkB,GAAG,GAAG,CAAC,CAAC,YAAY;AAE5C;;;;;;;;;;GAUG;AACI,KAAK,UAAU,qBAAqB,CACzC,EAAM,EACN,KAAiC;IAEjC,MAAM,UAAU,GAAG,IAAA,4BAAY,EAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IAC7E,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,UAAU,CAAC,WAAW,CAAC;IAChE,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,UAAU,CAAC,SAAS,CAAC;IAC1D,IAAA,8BAAc,EAAC,UAAU,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAEnD,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,IAAI,sBAAsB,CAAC;IAC5D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,kBAAkB,EAAE,CAAC;QACxE,MAAM,IAAI,0BAA0B,CAClC,iCAAiC,kBAAkB,QAAQ,CAC5D,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,EAAE,CAAkB;;yBAEhB,KAAK,CAAC,QAAQ;sBACjB,KAAK,CAAC,MAAM;2BACP,KAAK,CAAC,WAAW;+BACb,UAAU,CAAC,IAAI;gCACd,UAAU,CAAC,KAAK;;;GAG7C,CAAC;IACF,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACZ,MAAM,IAAI,0BAA0B,CAClC,iFAAiF,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,EAAE,CAAoB;;;;;;;QAOnC,IAAA,eAAM,GAAE,kDAAkD,KAAK,CAAC,QAAQ;QACxE,KAAK,CAAC,YAAY,KAAK,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,MAAM;QACzD,KAAK,CAAC,cAAc,IAAI,gBAAgB;qBAC3B,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,KAAK,KAAK,WAAW,KAAK,SAAS;cACzE,KAAK,CAAC,YAAY,KAAK,KAAK,CAAC,eAAe,IAAI,IAAI;iBACjD,KAAK;QACd,KAAK,CAAC,YAAY,IAAI,KAAK,KAAK,KAAK,CAAC,WAAW,IAAI,QAAQ;QAC7D,KAAK,CAAC,qBAAqB,IAAI,IAAI;;gBAE3B,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC;GAC7C,CAAC;IACF,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,uBAAuB,CAC3C,EAAM,EACN,KAAiD;IAEjD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAoB;;;;6BAId,KAAK,CAAC,KAAK;;iBAEvB,KAAK,CAAC,eAAe;;;;;gBAKtB,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC;GAC7C,CAAC;IACF,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,sBAAsB,CAC1C,EAAM,EACN,KAAqE;IAErE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAA;;yCAEkB,KAAK,CAAC,SAAS;wBAChC,KAAK,CAAC,MAAM;iBACnB,KAAK,CAAC,eAAe;;GAEnC,CAAC;IACF,OAAO,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;AACxB,CAAC;AAED,yFAAyF;AAClF,KAAK,UAAU,qBAAqB,CACzC,EAAM,EACN,QAAgB;IAEhB,MAAM,IAAI,GAAG,MAAM,EAAE,CAAoB;aAC9B,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC;;yBAEpB,QAAQ;;;GAG9B,CAAC;IACF,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,qBAAqB,GAAG;;;;;CAK7B,CAAC;AA4BF,SAAS,gBAAgB,CAAC,CAAmB;IAC3C,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,QAAQ,EAAE,CAAC,CAAC,SAAS;QACrB,YAAY,EAAE,CAAC,CAAC,aAAmC;QACnD,WAAW,EAAE,CAAC,CAAC,WAAgC;QAC/C,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,cAAc,EAAE,CAAC,CAAC,eAAuC;QACzD,SAAS,EAAE,WAAW;QACtB,UAAU,EAAE;YACV,IAAI,EAAE,CAAC,CAAC,eAAe;YACvB,KAAK,EAAE,CAAC,CAAC,gBAAgB;YACzB,KAAK,EAAE,GAAG,CAAC,CAAC,eAAe,IAAI,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;YAC5E,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;YACpC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;SACjC;QACD,OAAO,EAAE,CAAC,CAAC,QAAQ;QACnB,YAAY,EAAE,CAAC,CAAC,aAAa;QAC7B,YAAY,EAAE,CAAC,CAAC,aAAa;QAC7B,YAAY,EAAE,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE;QAC3C,eAAe,EAAE,CAAC,CAAC,gBAAgB;QACnC,YAAY,EAAE,CAAC,CAAC,aAAa,IAAI,KAAK;QACtC,WAAW,EAAG,CAAC,CAAC,YAAuC,IAAI,QAAQ;QACnE,qBAAqB,EAAE,CAAC,CAAC,sBAAsB,IAAI,IAAI;QACvD,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE;QACrC,UAAU,EAAE,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,IAAI;QAChD,SAAS,EAAE,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI,IAAI;QAC9C,YAAY,EAAE,CAAC,CAAC,aAAa;QAC7B,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;KAClB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,OAAO,CAAC,CAAmB;IAClC,IAAI,CAAC,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IACnC,IAAI,CAAC,CAAC,WAAW;QAAE,OAAO,UAAU,CAAC;IACrC,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,SAAS,CAAC;IAC3D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,OAAO,CAAC,CAAO;IACtB,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/cjs/fiscal/collection/competence.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * A janela da coleta — dita por extenso, nunca deduzida.
+ *
+ * ## O relato que originou este módulo
+ *
+ * A equipe do escritório chama de "dar baixa nas notas" o trabalho de, na virada
+ * do mês, entrar nos portais e recolher os documentos do período. Ao descrever
+ * esse trabalho, o relato humano trouxe exemplos de datas que não fechavam entre
+ * si — o que é absolutamente normal em conversa, e absolutamente perigoso como
+ * fonte de regra.
+ *
+ * A tentação é transformar "mês anterior" em constante. O erro que isso produz é
+ * silencioso: uma coleta rodada em 01/11 sobre uma janela que ninguém confirmou
+ * traz documentos de um período que não é o que a pessoa tinha em mente, e a
+ * ausência do que faltava só aparece no fechamento.
+ *
+ * Aqui a competência é um par ano/mês, e o período é um par de DATAS derivado
+ * dele. A sugestão padrão existe — mês calendário anterior —, mas ela é uma
+ * SUGESTÃO exibida, não um valor implícito: a tela mostra "serão consultados
+ * documentos de DD/MM/AAAA a DD/MM/AAAA" antes de qualquer execução, e as duas
+ * datas são gravadas na autorização.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_COMPETENCE_POLICY = exports.InvalidCompetenceError = void 0;
+exports.competenceOf = competenceOf;
+exports.suggestCompetenceFor = suggestCompetenceFor;
+exports.validateWindow = validateWindow;
+class InvalidCompetenceError extends Error {
+    detail;
+    constructor(detail) {
+        super(`competência inválida: ${detail}`);
+        this.detail = detail;
+        this.name = 'InvalidCompetenceError';
+    }
+}
+exports.InvalidCompetenceError = InvalidCompetenceError;
+/** A política padrão desta fase, nomeada para poder ser citada e mudada. */
+exports.DEFAULT_COMPETENCE_POLICY = 'PREVIOUS_CALENDAR_MONTH';
+/**
+ * A competência de um par ano/mês.
+ *
+ * O último dia sai do calendário: `Date.UTC(ano, mês, 0)` — com o mês em base 1
+ * — devolve o último dia daquele mês. Fevereiro bissexto sai de graça, que é o
+ * ponto de não escrever `30`.
+ */
+function competenceOf(year, month) {
+    if (!Number.isInteger(year) || year < 2000 || year > 2100) {
+        throw new InvalidCompetenceError('ano fora de 2000–2100');
+    }
+    if (!Number.isInteger(month) || month < 1 || month > 12) {
+        throw new InvalidCompetenceError('mês fora de 1–12');
+    }
+    const mm = String(month).padStart(2, '0');
+    const lastDay = new Date(Date.UTC(year, month, 0)).getUTCDate();
+    return {
+        year,
+        month,
+        label: `${year}-${mm}`,
+        periodStart: `${year}-${mm}-01`,
+        periodEnd: `${year}-${mm}-${String(lastDay).padStart(2, '0')}`,
+    };
+}
+/**
+ * A SUGESTÃO padrão para uma execução feita em `reference`: o mês calendário
+ * anterior.
+ *
+ * Chama-se `suggest` e não `default` de propósito. Uma função chamada
+ * `defaultCompetence()` acaba sendo usada como valor efetivo por quem não leu;
+ * `suggestCompetenceFor()` obriga quem chama a decidir o que fazer com a
+ * sugestão — que é exibi-la ao lado das duas datas.
+ */
+function suggestCompetenceFor(reference) {
+    const year = reference.getUTCFullYear();
+    const month = reference.getUTCMonth() + 1; // base 1
+    return month === 1 ? competenceOf(year - 1, 12) : competenceOf(year, month - 1);
+}
+/**
+ * Confere uma janela informada à mão contra a competência declarada.
+ *
+ * Permitir janela manual e conferi-la não são opostos: o operador pode querer um
+ * recorte menor dentro do mês — o que é legítimo —, mas uma janela que atravessa
+ * a competência declarada significa que um dos dois campos está errado, e gravar
+ * os dois deixaria a autorização dizendo duas coisas.
+ */
+function validateWindow(competence, periodStart, periodEnd) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(periodStart) || !/^\d{4}-\d{2}-\d{2}$/.test(periodEnd)) {
+        throw new InvalidCompetenceError('datas devem estar em YYYY-MM-DD');
+    }
+    if (periodEnd < periodStart) {
+        throw new InvalidCompetenceError('data final anterior à inicial');
+    }
+    if (periodStart < competence.periodStart || periodEnd > competence.periodEnd) {
+        throw new InvalidCompetenceError(`janela ${periodStart}..${periodEnd} sai da competência ${competence.label}`);
+    }
+}
+//# sourceMappingURL=competence.js.map

package/dist/cjs/fiscal/collection/competence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"competence.js","sourceRoot":"","sources":["../../../../src/fiscal/collection/competence.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AA8BH,oCAgBC;AAWD,oDAIC;AAUD,wCAgBC;AA1ED,MAAa,sBAAuB,SAAQ,KAAK;IAC1B;IAArB,YAAqB,MAAc;QACjC,KAAK,CAAC,yBAAyB,MAAM,EAAE,CAAC,CAAC;QADtB,WAAM,GAAN,MAAM,CAAQ;QAEjC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AALD,wDAKC;AAED,4EAA4E;AAC/D,QAAA,yBAAyB,GAAG,yBAAkC,CAAC;AAE5E;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,IAAY,EAAE,KAAa;IACtD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QAC1D,MAAM,IAAI,sBAAsB,CAAC,uBAAuB,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACxD,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;IAChE,OAAO;QACL,IAAI;QACJ,KAAK;QACL,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,EAAE;QACtB,WAAW,EAAE,GAAG,IAAI,IAAI,EAAE,KAAK;QAC/B,SAAS,EAAE,GAAG,IAAI,IAAI,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;KAC/D,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,oBAAoB,CAAC,SAAe;IAClD,MAAM,IAAI,GAAG,SAAS,CAAC,cAAc,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS;IACpD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,cAAc,CAC5B,UAA4B,EAC5B,WAAmB,EACnB,SAAiB;IAEjB,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,sBAAsB,CAAC,iCAAiC,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,SAAS,GAAG,WAAW,EAAE,CAAC;QAC5B,MAAM,IAAI,sBAAsB,CAAC,+BAA+B,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,WAAW,GAAG,UAAU,CAAC,WAAW,IAAI,SAAS,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;QAC7E,MAAM,IAAI,sBAAsB,CAC9B,UAAU,WAAW,KAAK,SAAS,uBAAuB,UAAU,CAAC,KAAK,EAAE,CAC7E,CAAC;IACJ,CAAC;AACH,CAAC"}