@baruk/core 0.4.2 → 0.5.0

package/dist/competence/business-days.js

@@ -0,0 +1,145 @@
+/**
+ * Calendário de dias úteis brasileiro.
+ *
+ * Fica no Core, e não numa vertical, pela mesma razão que `client.document_number`
+ * fica: CPF/CNPJ e feriado nacional são do PAÍS, não do segmento. Um produto
+ * odontológico ou industrial que opere no Brasil precisa igualmente saber que
+ * 12 de outubro não é dia útil. O que é do segmento — quais obrigações existem e
+ * quando vencem — mora em `@baruk/contabil`.
+ *
+ * Escopo deliberado: feriados NACIONAIS. Feriado estadual e municipal deslocam
+ * prazos reais (o ISS de São Paulo não vence no aniversário da cidade), mas
+ * dependem do município de cada cliente e não têm fonte única. Tratá-los aqui
+ * daria a impressão de cobertura que o dado não sustenta — o escritório ajusta a
+ * data na instância quando isso acontecer.
+ */
+/** Domingo = 0 … sábado = 6. */
+function weekday(iso) {
+    return new Date(`${iso}T12:00:00Z`).getUTCDay();
+}
+function toIso(y, m, d) {
+    return `${y}-${String(m).padStart(2, '0')}-${String(d).padStart(2, '0')}`;
+}
+function addDays(iso, delta) {
+    const d = new Date(`${iso}T12:00:00Z`);
+    d.setUTCDate(d.getUTCDate() + delta);
+    return d.toISOString().slice(0, 10);
+}
+/** Último dia do mês (trata ano bissexto). */
+export function lastDayOfMonth(year, month) {
+    return new Date(Date.UTC(year, month, 0)).getUTCDate();
+}
+/**
+ * Domingo de Páscoa pelo algoritmo de Meeus/Jones/Butcher (calendário gregoriano).
+ * Carnaval, Sexta-Feira Santa e Corpus Christi derivam dele.
+ */
+export function easterSunday(year) {
+    const a = year % 19;
+    const b = Math.floor(year / 100);
+    const c = year % 100;
+    const d = Math.floor(b / 4);
+    const e = b % 4;
+    const f = Math.floor((b + 8) / 25);
+    const g = Math.floor((b - f + 1) / 3);
+    const h = (19 * a + b - d - g + 15) % 30;
+    const i = Math.floor(c / 4);
+    const k = c % 4;
+    const l = (32 + 2 * e + 2 * i - h - k) % 7;
+    const m = Math.floor((a + 11 * h + 22 * l) / 451);
+    const month = Math.floor((h + l - 7 * m + 114) / 31);
+    const day = ((h + l - 7 * m + 114) % 31) + 1;
+    return toIso(year, month, day);
+}
+/**
+ * Feriados nacionais de um ano, em ISO.
+ *
+ * Inclui Carnaval (segunda e terça) e Corpus Christi, que não são feriados civis
+ * nacionais mas são feriados BANCÁRIOS — e prazo de recolhimento se mede em dia
+ * bancário, não em dia civil. Quarta-feira de Cinzas é meio expediente e conta
+ * como dia útil.
+ *
+ * 20 de novembro (Consciência Negra) entrou como feriado nacional pela Lei
+ * 14.759/2023, valendo a partir de 2024.
+ */
+export function nationalHolidays(year) {
+    const easter = easterSunday(year);
+    const fixed = [
+        toIso(year, 1, 1), // Confraternização Universal
+        toIso(year, 4, 21), // Tiradentes
+        toIso(year, 5, 1), // Dia do Trabalho
+        toIso(year, 9, 7), // Independência
+        toIso(year, 10, 12), // Nossa Senhora Aparecida
+        toIso(year, 11, 2), // Finados
+        toIso(year, 11, 15), // Proclamação da República
+        toIso(year, 12, 25), // Natal
+    ];
+    if (year >= 2024)
+        fixed.push(toIso(year, 11, 20)); // Consciência Negra
+    const movable = [
+        addDays(easter, -48), // Carnaval (segunda)
+        addDays(easter, -47), // Carnaval (terça)
+        addDays(easter, -2), // Sexta-Feira Santa
+        addDays(easter, 60), // Corpus Christi
+    ];
+    return [...fixed, ...movable].sort();
+}
+const holidayCache = new Map();
+function holidaySet(year) {
+    let s = holidayCache.get(year);
+    if (!s) {
+        s = new Set(nationalHolidays(year));
+        holidayCache.set(year, s);
+    }
+    return s;
+}
+/** Dia útil = não é sábado, domingo nem feriado nacional/bancário. */
+export function isBusinessDay(iso) {
+    const wd = weekday(iso);
+    if (wd === 0 || wd === 6)
+        return false;
+    return !holidaySet(Number(iso.slice(0, 4))).has(iso);
+}
+/**
+ * Move a data para um dia útil.
+ *
+ * `previous` é o padrão do vencimento fiscal brasileiro: quando o prazo cai em
+ * dia sem expediente bancário, ANTECIPA-SE. Postergar seria o erro caro — o
+ * contribuinte pagaria com multa por confiar no sistema.
+ */
+export function adjustToBusinessDay(iso, direction = 'previous') {
+    if (direction === 'none')
+        return iso;
+    const step = direction === 'previous' ? -1 : 1;
+    let cur = iso;
+    // 15 passos cobrem o maior bloco possível (fim de semana + emendas).
+    for (let i = 0; i < 15; i++) {
+        if (isBusinessDay(cur))
+            return cur;
+        cur = addDays(cur, step);
+    }
+    return cur;
+}
+/** Último dia útil do mês. */
+export function lastBusinessDayOfMonth(year, month) {
+    return adjustToBusinessDay(toIso(year, month, lastDayOfMonth(year, month)), 'previous');
+}
+/** N-ésimo dia útil do mês (1 = primeiro). Devolve `null` se o mês não tiver tantos. */
+export function nthBusinessDayOfMonth(year, month, n) {
+    const last = lastDayOfMonth(year, month);
+    let count = 0;
+    for (let d = 1; d <= last; d++) {
+        const iso = toIso(year, month, d);
+        if (isBusinessDay(iso)) {
+            count += 1;
+            if (count === n)
+                return iso;
+        }
+    }
+    return null;
+}
+/** Soma meses a um par (ano, mês) 1-based, normalizando a virada de ano. */
+export function shiftMonth(year, month, months) {
+    const zero = year * 12 + (month - 1) + months;
+    return [Math.floor(zero / 12), (zero % 12) + 1];
+}
+//# sourceMappingURL=business-days.js.map

package/dist/competence/business-days.js.map

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

package/dist/competence/catalog-validation.d.ts

@@ -0,0 +1,86 @@
+import type { Tx } from '../db/client.js';
+/**
+ * Conferência humana do catálogo fiscal — por escritório.
+ *
+ * ## O problema que isto resolve
+ *
+ * O catálogo foi semeado tecnicamente e nunca foi confrontado com os serviços
+ * que o escritório de fato presta. Um catálogo semeado que ninguém conferiu é
+ * pior que catálogo nenhum: o escritório passa a confiar numa lista, e descobre
+ * o erro no dia do vencimento.
+ *
+ * O estado padrão é `pending_validation`, e esse é o ponto inteiro. Enquanto
+ * ninguém conferiu, o produto tem de DIZER que ninguém conferiu, em vez de
+ * deixar o seed passar por verdade operacional.
+ *
+ * ## Por que tabela própria, e não coluna em `recurring_item_type`
+ *
+ * As linhas de sistema do catálogo (`tenant_id IS NULL`) são COMPARTILHADAS
+ * entre todos os escritórios. Uma coluna `validation_status` nelas faria um
+ * escritório carimbar a validação do outro — exatamente a classe de vazamento
+ * que a Fase 4 fechou em `role`. O estado de conferência é por tenant, então
+ * mora numa tabela por tenant.
+ *
+ * ## `depends_on_locality`
+ *
+ * Três itens do catálogo são de esfera estadual ou municipal, e o prazo deles
+ * varia por UF e por município. Este campo não é um prazo: é a **ausência**
+ * de prazo, declarada. Inventar uma data seria pior que não ter nenhuma,
+ * porque o alerta dispararia no dia errado e alguém confiaria nele.
+ */
+export type CatalogValidationStatus = 
+/** Conferido por uma pessoa contra os serviços prestados. */
+'validated'
+/** Padrão: veio do seed e ninguém olhou ainda. */
+ | 'pending_validation'
+/** O escritório não atende esta obrigação — não deve aparecer na geração. */
+ | 'not_applicable'
+/** Desligada deliberadamente, com motivo. */
+ | 'disabled';
+export interface CatalogValidationRecord {
+    itemTypeId: string;
+    status: CatalogValidationStatus;
+    dependsOnLocality: boolean;
+    note: string | null;
+    validatedBy: string | null;
+    validatedAt: string | null;
+}
+export declare function listCatalogValidations(tx: Tx): Promise<CatalogValidationRecord[]>;
+/**
+ * Grava a decisão do escritório sobre um item.
+ *
+ * `validated_at` só é preenchido quando o status é `validated` — o CHECK da
+ * tabela recusa a combinação inversa, então a data não pode mentir sobre ter
+ * havido conferência.
+ */
+export declare function setCatalogValidation(tx: Tx, input: {
+    itemTypeId: string;
+    status: CatalogValidationStatus;
+    note?: string | null;
+    dependsOnLocality?: boolean;
+    actorId?: string | null;
+}): Promise<CatalogValidationRecord>;
+/**
+ * Semeia o estado inicial da conferência para o escritório.
+ *
+ * Idempotente e conservador: só cria as linhas que faltam, e **nunca** rebaixa
+ * um item já conferido. Rodar de novo depois de uma conferência não a apaga.
+ *
+ * Itens de esfera estadual ou municipal nascem marcados como dependentes de
+ * localidade, porque é isso que eles são.
+ */
+export declare function seedCatalogValidation(tx: Tx): Promise<{
+    created: number;
+}>;
+export interface CatalogValidationSummary {
+    total: number;
+    validated: number;
+    pending: number;
+    notApplicable: number;
+    disabled: number;
+    dependsOnLocality: number;
+    /** O gate que o go-live consulta: nada pendente e ao menos um item conferido. */
+    humanValidationComplete: boolean;
+}
+export declare function catalogValidationSummary(tx: Tx): Promise<CatalogValidationSummary>;
+//# sourceMappingURL=catalog-validation.d.ts.map

package/dist/competence/catalog-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-validation.d.ts","sourceRoot":"","sources":["../../src/competence/catalog-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,MAAM,MAAM,uBAAuB;AACjC,6DAA6D;AAC3D,WAAW;AACb,kDAAkD;GAChD,oBAAoB;AACtB,6EAA6E;GAC3E,gBAAgB;AAClB,6CAA6C;GAC3C,UAAU,CAAC;AAEf,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,uBAAuB,CAAC;IAChC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAoBD,wBAAsB,sBAAsB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAMvF;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,EAAE,EACN,KAAK,EAAE;IACL,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,uBAAuB,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,GACA,OAAO,CAAC,uBAAuB,CAAC,CAsBlC;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBhF;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAED,wBAAsB,wBAAwB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA+BxF"}

package/dist/competence/catalog-validation.js

@@ -0,0 +1,168 @@
+import { uuidv7 } from '@baruk/shared';
+const map = (r) => ({
+    itemTypeId: r.item_type_id,
+    status: r.status,
+    dependsOnLocality: r.depends_on_locality,
+    note: r.note,
+    validatedBy: r.validated_by,
+    validatedAt: r.validated_at?.toISOString() ?? null,
+});
+export async function listCatalogValidations(tx) {
+    const rows = await tx `
+    SELECT item_type_id, status, depends_on_locality, note, validated_by, validated_at
+      FROM recurring_item_type_validation
+  `;
+    return rows.map(map);
+}
+/**
+ * Grava a decisão do escritório sobre um item.
+ *
+ * `validated_at` só é preenchido quando o status é `validated` — o CHECK da
+ * tabela recusa a combinação inversa, então a data não pode mentir sobre ter
+ * havido conferência.
+ */
+export async function setCatalogValidation(tx, input) {
+    const validado = input.status === 'validated';
+    const rows = await tx `
+    INSERT INTO recurring_item_type_validation
+      (id, tenant_id, item_type_id, status, depends_on_locality, note, validated_by, validated_at)
+    VALUES (
+      ${uuidv7()}, current_setting('app.current_tenant')::uuid, ${input.itemTypeId},
+      ${input.status}, ${input.dependsOnLocality ?? false}, ${input.note ?? null},
+      ${validado ? (input.actorId ?? null) : null},
+      ${validado ? new Date() : null}
+    )
+    ON CONFLICT (tenant_id, item_type_id) DO UPDATE SET
+      status = EXCLUDED.status,
+      depends_on_locality = EXCLUDED.depends_on_locality,
+      note = EXCLUDED.note,
+      validated_by = EXCLUDED.validated_by,
+      validated_at = EXCLUDED.validated_at,
+      updated_at = now()
+    RETURNING item_type_id, status, depends_on_locality, note, validated_by, validated_at
+  `;
+    if (validado)
+        await adotarRegras(tx, input.itemTypeId, input.actorId ?? null);
+    return map(rows[0]);
+}
+/**
+ * Semeia o estado inicial da conferência para o escritório.
+ *
+ * Idempotente e conservador: só cria as linhas que faltam, e **nunca** rebaixa
+ * um item já conferido. Rodar de novo depois de uma conferência não a apaga.
+ *
+ * Itens de esfera estadual ou municipal nascem marcados como dependentes de
+ * localidade, porque é isso que eles são.
+ */
+export async function seedCatalogValidation(tx) {
+    const rows = await tx `
+    WITH visiveis AS (
+      SELECT DISTINCT ON (key) id, sphere
+        FROM recurring_item_type
+       WHERE deleted_at IS NULL AND active = true
+       ORDER BY key, tenant_id NULLS LAST
+    ),
+    inseridos AS (
+      INSERT INTO recurring_item_type_validation
+        (id, tenant_id, item_type_id, status, depends_on_locality)
+      SELECT gen_random_uuid(), current_setting('app.current_tenant')::uuid, v.id,
+             'pending_validation', (v.sphere IN ('estadual', 'municipal'))
+        FROM visiveis v
+      ON CONFLICT (tenant_id, item_type_id) DO NOTHING
+      RETURNING 1
+    )
+    SELECT count(*)::int AS n FROM inseridos
+  `;
+    return { created: rows[0]?.n ?? 0 };
+}
+export async function catalogValidationSummary(tx) {
+    const [r] = await tx `
+    SELECT count(*)::int AS total,
+           count(*) FILTER (WHERE status = 'validated')::int        AS validated,
+           count(*) FILTER (WHERE status = 'pending_validation')::int AS pending,
+           count(*) FILTER (WHERE status = 'not_applicable')::int   AS not_applicable,
+           count(*) FILTER (WHERE status = 'disabled')::int         AS disabled,
+           count(*) FILTER (WHERE depends_on_locality)::int         AS locality
+      FROM recurring_item_type_validation
+  `;
+    const total = r?.total ?? 0;
+    const validated = r?.validated ?? 0;
+    const pending = r?.pending ?? 0;
+    return {
+        total,
+        validated,
+        pending,
+        notApplicable: r?.not_applicable ?? 0,
+        disabled: r?.disabled ?? 0,
+        dependsOnLocality: r?.locality ?? 0,
+        humanValidationComplete: total > 0 && pending === 0 && validated > 0,
+    };
+}
+/**
+ * Conferir o item faz o escritório ADOTAR a regra.
+ *
+ * ## O impasse que isto resolve
+ *
+ * Uma regra do catálogo nacional nasce `pending_validation`, e um escritório
+ * não pode validá-la: a correção nacional dela é outra autoridade, e a policy
+ * recusa a escrita de qualquer forma. Sem mais nada, o catálogo travava —
+ * nenhum escritório conseguiria usar item nenhum, para sempre.
+ *
+ * A saída não é afrouxar a regra nacional. É reconhecer o que o operador de
+ * fato faz quando marca "conferida": ele está dizendo **"este prazo é o que eu
+ * pratico"**, e assumindo isso. Então o ato cria uma regra DO ESCRITÓRIO, cópia
+ * da nacional, validada por ele.
+ *
+ * O que se ganha:
+ *
+ * - a regra nacional continua pendente, e continua sendo a nacional;
+ * - o escritório opera sob a própria responsabilidade, com autor e data;
+ * - quando a regra nacional for validada e mudar, dá para comparar as duas —
+ *   a adoção fica visível em vez de virar edição silenciosa do catálogo.
+ *
+ * Regra do próprio escritório que ainda estava pendente é simplesmente
+ * validada: ali não há nada a adotar, é dele desde o início.
+ */
+async function adotarRegras(tx, itemTypeId, actorId) {
+    // 1 · As que já são do escritório: conferir é o mesmo ato.
+    await tx `
+    UPDATE fiscal_rule
+       SET status = 'validated', validated_by = ${actorId}, validated_at = now(), updated_at = now()
+     WHERE item_type_id = ${itemTypeId}
+       AND tenant_id IS NOT NULL
+       AND deleted_at IS NULL
+       AND status = 'pending_validation'
+       AND due_rule IS NOT NULL
+  `;
+    // 2 · As nacionais pendentes viram adoção — uma por jurisdição, e só onde o
+    //     escritório ainda não tem regra própria vigente.
+    await tx `
+    INSERT INTO fiscal_rule (
+      id, tenant_id, item_type_id, jurisdiction_scope, jurisdiction_uf, jurisdiction_city_ibge,
+      version, valid_from, status, conditions, due_rule, source_reference, note,
+      validated_by, validated_at
+    )
+    SELECT gen_random_uuid(), current_setting('app.current_tenant')::uuid, g.item_type_id,
+           g.jurisdiction_scope, g.jurisdiction_uf, g.jurisdiction_city_ibge,
+           1, g.valid_from, 'validated', g.conditions, g.due_rule, g.source_reference,
+           'Adotada pelo escritório ao conferir o catálogo. A regra nacional segue pendente.',
+           ${actorId}, now()
+      FROM fiscal_rule g
+     WHERE g.item_type_id = ${itemTypeId}
+       AND g.tenant_id IS NULL
+       AND g.deleted_at IS NULL
+       AND g.status = 'pending_validation'
+       AND g.due_rule IS NOT NULL
+       AND NOT EXISTS (
+         SELECT 1 FROM fiscal_rule p
+          WHERE p.item_type_id = g.item_type_id
+            AND p.tenant_id = current_setting('app.current_tenant')::uuid
+            AND p.jurisdiction_scope = g.jurisdiction_scope
+            AND coalesce(p.jurisdiction_uf, '-') = coalesce(g.jurisdiction_uf, '-')
+            AND coalesce(p.jurisdiction_city_ibge, '-') = coalesce(g.jurisdiction_city_ibge, '-')
+            AND p.valid_until IS NULL
+            AND p.deleted_at IS NULL
+       )
+  `;
+}
+//# sourceMappingURL=catalog-validation.js.map

package/dist/competence/catalog-validation.js.map

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

package/dist/competence/obligation-preview.d.ts

@@ -0,0 +1,103 @@
+import type { Tx } from '../db/client.js';
+import { type ApplicabilityOutcome } from '../fiscal/applicability.js';
+/**
+ * Prévia das obrigações antes de gerar.
+ *
+ * ## Por que um passo a mais
+ *
+ * `generateInstancesForCompetence` escreve direto. Isso é aceitável quando o
+ * catálogo é o de sempre e o operador conhece a carteira; deixa de ser quando o
+ * catálogo veio de um seed que ninguém conferiu e a carteira acabou de ser
+ * importada. Nesse cenário, gerar é criar prazo legal para trezentos clientes
+ * com base numa lista que nunca foi lida.
+ *
+ * A prévia devolve, por item, o que seria criado, o que já existe e **o que foi
+ * descartado, com o motivo**. O motivo é a parte que importa: uma obrigação que
+ * some da lista sem explicação é indistinguível de um defeito.
+ *
+ * ## O que faz um item ser descartado
+ *
+ * - `regime` — o item não se aplica ao regime do cliente;
+ * - `nao_conferido` — o catálogo ainda está `pending_validation` para este item;
+ * - `nao_aplicavel` / `desativado` — o escritório disse que não atende;
+ * - `sem_localidade` — o item depende de UF ou município e o cliente não tem
+ *   nenhum dos dois cadastrados. Este é o caso em que gerar seria pior que não
+ *   gerar: sem localidade não há como saber o prazo, e uma data inventada
+ *   dispararia o alerta no dia errado;
+ * - `sem_vencimento` — a regra de vencimento não é interpretável.
+ */
+export type ObligationSkipReason = 'regime' | 'nao_conferido' | 'nao_aplicavel' | 'desativado' | 'sem_localidade' | 'sem_vencimento'
+/**
+ * O motor nacional recusou, e o desfecho dele diz por quê.
+ *
+ * Distinto dos anteriores, que são checagens locais do escritório: este vem
+ * da avaliação de jurisdição, vigência e condições declarativas, e carrega o
+ * motivo em texto — a prévia repassa a explicação em vez de traduzi-la para
+ * um rótulo genérico que perderia o que o operador precisa fazer.
+ */
+ | 'motor_nacional';
+export interface PreviewItem {
+    itemTypeId: string;
+    /** Desfecho do motor nacional, quando ele foi consultado. */
+    applicability?: ApplicabilityOutcome;
+    /** Explicação do motor, para a tela. */
+    applicabilityReason?: string;
+    /** Atributos do perfil que faltaram — o que o escritório precisa preencher. */
+    missingAttributes?: string[];
+    /** Versão exata da regra usada; entra na instância gerada. */
+    fiscalRuleId?: string;
+    fiscalRuleVersion?: number;
+    key: string;
+    label: string;
+    nature: 'obligation' | 'task';
+    sphere: string | null;
+    dueDate: string | null;
+    /** `existing` = já foi gerada antes; gerar de novo não a duplica. */
+    outcome: 'create' | 'existing' | 'skip';
+    skipReason?: ObligationSkipReason;
+}
+export interface ObligationPreview {
+    competenceId: string;
+    competenceLabel: string;
+    clientId: string;
+    regime: string | null;
+    locality: {
+        municipality: string | null;
+        stateUf: string | null;
+    };
+    items: PreviewItem[];
+    counts: {
+        create: number;
+        existing: number;
+        skip: number;
+    };
+    /** Falso quando algo do catálogo ainda não foi conferido por uma pessoa. */
+    catalogFullyValidated: boolean;
+}
+export declare function previewInstancesForCompetence(tx: Tx, input: {
+    competenceId: string;
+    regime?: string | null;
+}): Promise<ObligationPreview>;
+export declare class PreviewMismatch extends Error {
+    constructor(message: string);
+}
+/**
+ * Gera exatamente o que a prévia mostrou.
+ *
+ * `approvedItemTypeIds` é a lista que o operador aprovou na tela. A geração
+ * recusa qualquer id que não esteja marcado como `create` na prévia recalculada
+ * — se o mundo mudou entre a conferência e a aprovação, o certo é falhar e
+ * pedir nova conferência, não gerar algo que ninguém viu.
+ *
+ * A idempotência continua vindo do índice único `(tenant, cliente, competência,
+ * tipo)` com `ON CONFLICT DO NOTHING`: aprovar duas vezes cria uma vez.
+ */
+export declare function generateFromPreview(tx: Tx, input: {
+    competenceId: string;
+    regime?: string | null;
+    approvedItemTypeIds: string[];
+}): Promise<{
+    created: number;
+    alreadyExisted: number;
+}>;
+//# sourceMappingURL=obligation-preview.d.ts.map

package/dist/competence/obligation-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obligation-preview.d.ts","sourceRoot":"","sources":["../../src/competence/obligation-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAG1C,OAAO,EAAuB,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAG5F;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,eAAe,GACf,eAAe,GACf,YAAY,GACZ,gBAAgB,GAChB,gBAAgB;AAClB;;;;;;;GAOG;GACD,gBAAgB,CAAC;AAErB,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,wCAAwC;IACxC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC;IAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,qEAAqE;IACrE,OAAO,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IACxC,UAAU,CAAC,EAAE,oBAAoB,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE;QAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAClE,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,4EAA4E;IAC5E,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED,wBAAsB,6BAA6B,CACjD,EAAE,EAAE,EAAE,EACN,KAAK,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACtD,OAAO,CAAC,iBAAiB,CAAC,CA0I5B;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,EAAE,EACN,KAAK,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,mBAAmB,EAAE,MAAM,EAAE,CAAA;CAAE,GACrF,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CA6CtD"}