@baruk/core 0.3.1 → 0.5.0

package/dist/competence/obligation-preview.js

@@ -0,0 +1,184 @@
+import { computeDueDate, getCompetence, listRecurringItemTypes } from './repository.js';
+import { listCatalogValidations } from './catalog-validation.js';
+import { decideApplicability } from '../fiscal/applicability.js';
+import { loadClientJurisdiction, loadFiscalProfile, resolveRule } from '../fiscal/repository.js';
+export async function previewInstancesForCompetence(tx, input) {
+    const competence = await getCompetence(tx, input.competenceId);
+    const types = await listRecurringItemTypes(tx, { activeOnly: true });
+    const validations = new Map((await listCatalogValidations(tx)).map((v) => [v.itemTypeId, v]));
+    const [cliente] = await tx `
+    SELECT municipality, state_uf FROM client WHERE id = ${competence.clientId}
+  `;
+    const municipality = cliente?.municipality ?? null;
+    const stateUf = cliente?.state_uf ?? null;
+    // Perfil e jurisdição são lidos UMA vez, fora do laço. Dentro dele seriam
+    // duas consultas por item do catálogo — dezessete hoje, e o catálogo cresce.
+    const jurisdiction = await loadClientJurisdiction(tx, competence.clientId);
+    const profile = await loadFiscalProfile(tx, competence.clientId);
+    // A competência é o que decide a vigência, e não "hoje": reprocessar um mês
+    // antigo precisa usar a regra que valia NAQUELE mês.
+    const referenceDate = `${competence.label}-01`;
+    const existentes = new Set((await tx `
+        SELECT item_type_id FROM recurring_instance
+         WHERE competence_id = ${competence.id} AND deleted_at IS NULL
+      `).map((r) => r.item_type_id));
+    const items = [];
+    let pendenteDeConferencia = false;
+    for (const type of types) {
+        const base = {
+            itemTypeId: type.id,
+            key: type.key,
+            label: type.label,
+            nature: type.nature,
+            sphere: type.sphere,
+        };
+        const skip = (skipReason) => ({
+            ...base,
+            dueDate: null,
+            outcome: 'skip',
+            skipReason,
+        });
+        const aplicaAoRegime = type.appliesToRegime.length === 0 ||
+            (input.regime != null && type.appliesToRegime.includes(input.regime));
+        if (!aplicaAoRegime) {
+            items.push(skip('regime'));
+            continue;
+        }
+        const v = validations.get(type.id);
+        if (v?.status === 'not_applicable') {
+            items.push(skip('nao_aplicavel'));
+            continue;
+        }
+        if (v?.status === 'disabled') {
+            items.push(skip('desativado'));
+            continue;
+        }
+        if (!v || v.status === 'pending_validation') {
+            pendenteDeConferencia = true;
+            items.push(skip('nao_conferido'));
+            continue;
+        }
+        if (v.dependsOnLocality && !stateUf && !municipality) {
+            items.push(skip('sem_localidade'));
+            continue;
+        }
+        // ── O motor nacional ────────────────────────────────────────────────
+        //
+        // Consultado DEPOIS das checagens locais e antes de computar a data. A
+        // ordem importa: se o catálogo do escritório já disse "não atendemos",
+        // perguntar ao motor sobre jurisdição seria trabalho para descartar.
+        //
+        // Quando existe regra, é ela que manda — inclusive no vencimento. A
+        // `due_rule` do tipo de item passa a ser o que sempre foi de fato: o
+        // padrão de quem ainda não tem regra cadastrada para a sua jurisdição.
+        const decisao = decideApplicability({
+            rule: await resolveRule(tx, {
+                itemTypeId: type.id,
+                jurisdiction,
+                referenceDate,
+            }),
+            profile,
+            clientJurisdiction: jurisdiction,
+            referenceDate,
+        });
+        if (decisao.outcome !== 'APPLICABLE') {
+            items.push({
+                ...skip('motor_nacional'),
+                applicability: decisao.outcome,
+                applicabilityReason: decisao.reason,
+                ...(decisao.evidence.missingAttributes.length > 0
+                    ? { missingAttributes: decisao.evidence.missingAttributes }
+                    : {}),
+                ...(decisao.evidence.ruleId ? { fiscalRuleId: decisao.evidence.ruleId } : {}),
+            });
+            continue;
+        }
+        const regra = decisao.evidence;
+        const dueDate = computeDueDate(competence.label, type.dueRule);
+        if (dueDate === null) {
+            items.push(skip('sem_vencimento'));
+            continue;
+        }
+        items.push({
+            ...base,
+            dueDate,
+            outcome: existentes.has(type.id) ? 'existing' : 'create',
+            applicability: 'APPLICABLE',
+            applicabilityReason: decisao.reason,
+            ...(regra.ruleId ? { fiscalRuleId: regra.ruleId } : {}),
+            ...(regra.ruleVersion !== null ? { fiscalRuleVersion: regra.ruleVersion } : {}),
+        });
+    }
+    return {
+        competenceId: competence.id,
+        competenceLabel: competence.label,
+        clientId: competence.clientId,
+        regime: input.regime ?? null,
+        locality: { municipality, stateUf },
+        items,
+        counts: {
+            create: items.filter((i) => i.outcome === 'create').length,
+            existing: items.filter((i) => i.outcome === 'existing').length,
+            skip: items.filter((i) => i.outcome === 'skip').length,
+        },
+        catalogFullyValidated: !pendenteDeConferencia,
+    };
+}
+export class PreviewMismatch extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PreviewMismatch';
+    }
+}
+/**
+ * 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 async function generateFromPreview(tx, input) {
+    const preview = await previewInstancesForCompetence(tx, {
+        competenceId: input.competenceId,
+        regime: input.regime,
+    });
+    const criaveis = new Map(preview.items.filter((i) => i.outcome === 'create').map((i) => [i.itemTypeId, i]));
+    const jaExistiam = new Set(preview.items.filter((i) => i.outcome === 'existing').map((i) => i.itemTypeId));
+    let alreadyExisted = 0;
+    const aCriar = [];
+    for (const id of input.approvedItemTypeIds) {
+        if (jaExistiam.has(id)) {
+            alreadyExisted++;
+            continue;
+        }
+        const item = criaveis.get(id);
+        if (!item) {
+            throw new PreviewMismatch(`O item ${id} não está entre os que podem ser gerados nesta competência. Refaça a conferência.`);
+        }
+        aCriar.push(item);
+    }
+    let created = 0;
+    for (const item of aCriar) {
+        const rows = await tx `
+      INSERT INTO recurring_instance
+        (id, tenant_id, client_id, competence_id, item_type_id, label, nature, due_date)
+      VALUES (
+        gen_random_uuid(), current_setting('app.current_tenant')::uuid,
+        ${preview.clientId}, ${preview.competenceId}, ${item.itemTypeId},
+        ${item.label}, ${item.nature}, ${item.dueDate}
+      )
+      ON CONFLICT DO NOTHING
+      RETURNING id
+    `;
+        if (rows[0])
+            created++;
+        else
+            alreadyExisted++;
+    }
+    return { created, alreadyExisted };
+}
+//# sourceMappingURL=obligation-preview.js.map

package/dist/competence/obligation-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obligation-preview.js","sourceRoot":"","sources":["../../src/competence/obligation-preview.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAA6B,MAAM,4BAA4B,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AA+EjG,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,EAAM,EACN,KAAuD;IAEvD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,sBAAsB,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9F,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE,CAA4D;2DAC7B,UAAU,CAAC,QAAQ;GAC3E,CAAC;IACF,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,IAAI,CAAC;IACnD,MAAM,OAAO,GAAG,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC;IAE1C,0EAA0E;IAC1E,6EAA6E;IAC7E,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAAC,EAAE,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,EAAE,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACjE,4EAA4E;IAC5E,qDAAqD;IACrD,MAAM,aAAa,GAAG,GAAG,UAAU,CAAC,KAAK,KAAK,CAAC;IAE/C,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,CACE,MAAM,EAAE,CAA4B;;iCAET,UAAU,CAAC,EAAE;OACvC,CACF,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAC7B,CAAC;IAEF,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,IAAI,qBAAqB,GAAG,KAAK,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG;YACX,UAAU,EAAE,IAAI,CAAC,EAAE;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;QACF,MAAM,IAAI,GAAG,CAAC,UAAgC,EAAe,EAAE,CAAC,CAAC;YAC/D,GAAG,IAAI;YACP,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,MAAM;YACf,UAAU;SACX,CAAC,CAAC;QAEH,MAAM,cAAc,GAClB,IAAI,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC;YACjC,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACxE,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,EAAE,MAAM,KAAK,gBAAgB,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;YAClC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,EAAE,MAAM,KAAK,UAAU,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;YAC/B,SAAS;QACX,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,oBAAoB,EAAE,CAAC;YAC5C,qBAAqB,GAAG,IAAI,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;YAClC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,CAAC,iBAAiB,IAAI,CAAC,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;YACrD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;YACnC,SAAS;QACX,CAAC;QAED,uEAAuE;QACvE,EAAE;QACF,uEAAuE;QACvE,uEAAuE;QACvE,qEAAqE;QACrE,EAAE;QACF,oEAAoE;QACpE,qEAAqE;QACrE,uEAAuE;QACvE,MAAM,OAAO,GAAG,mBAAmB,CAAC;YAClC,IAAI,EAAE,MAAM,WAAW,CAAC,EAAE,EAAE;gBAC1B,UAAU,EAAE,IAAI,CAAC,EAAE;gBACnB,YAAY;gBACZ,aAAa;aACd,CAAC;YACF,OAAO;YACP,kBAAkB,EAAE,YAAY;YAChC,aAAa;SACd,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,IAAI,CAAC,gBAAgB,CAAC;gBACzB,aAAa,EAAE,OAAO,CAAC,OAAO;gBAC9B,mBAAmB,EAAE,OAAO,CAAC,MAAM;gBACnC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC;oBAC/C,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,EAAE;oBAC3D,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9E,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC/B,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;YACnC,SAAS;QACX,CAAC;QAED,KAAK,CAAC,IAAI,CAAC;YACT,GAAG,IAAI;YACP,OAAO;YACP,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ;YACxD,aAAa,EAAE,YAAY;YAC3B,mBAAmB,EAAE,OAAO,CAAC,MAAM;YACnC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChF,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,YAAY,EAAE,UAAU,CAAC,EAAE;QAC3B,eAAe,EAAE,UAAU,CAAC,KAAK;QACjC,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;QAC5B,QAAQ,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE;QACnC,KAAK;QACL,MAAM,EAAE;YACN,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,MAAM;YAC1D,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,MAAM;YAC9D,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,MAAM;SACvD;QACD,qBAAqB,EAAE,CAAC,qBAAqB;KAC9C,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,EAAM,EACN,KAAsF;IAEtF,MAAM,OAAO,GAAG,MAAM,6BAA6B,CAAC,EAAE,EAAE;QACtD,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAClF,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAC/E,CAAC;IAEF,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,mBAAmB,EAAE,CAAC;QAC3C,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACvB,cAAc,EAAE,CAAC;YACjB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,eAAe,CACvB,UAAU,EAAE,mFAAmF,CAChG,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,MAAM,EAAE,CAAkB;;;;;UAKjC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,YAAY,KAAK,IAAI,CAAC,UAAU;UAC7D,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO;;;;KAIhD,CAAC;QACF,IAAI,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;;YAClB,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;AACrC,CAAC"}

package/dist/competence/repository.d.ts

@@ -0,0 +1,285 @@
+import type { Tx } from '../db/client.js';
+/**
+ * Competência e itens recorrentes (ADR 0008).
+ *
+ * Tenant-scoped por RLS: nenhum método filtra `tenant_id`, exatamente como os
+ * demais repositórios do core. O `tenant_id` chega por `current_setting`.
+ */
+export declare const COMPETENCE_LABEL_RE: RegExp;
+export type CompetenceStatus = 'open' | 'in_progress' | 'awaiting_client' | 'review' | 'closed' | 'reopened';
+export interface CompetenceRecord {
+    id: string;
+    tenantId: string;
+    clientId: string;
+    label: string;
+    status: CompetenceStatus;
+    openedAt: string;
+    closedAt: string | null;
+    version: number;
+}
+/**
+ * Valida o rótulo antes de chegar ao banco. O CHECK da migration é a garantia
+ * final, mas devolver 422 é melhor que devolver 500 com erro de constraint.
+ *
+ * Repare que o regex daqui é mais estrito que o do schema: rejeita `2026-13`.
+ * Nunca relaxe um sem relaxar o outro — a divergência é deliberada e sempre no
+ * sentido seguro (aplicação mais rígida que banco).
+ */
+export declare function assertCompetenceLabel(label: string): void;
+/**
+ * Abre a competência, ou devolve a existente. Idempotente por desenho: chamar
+ * duas vezes para o mesmo (cliente, mês) devolve a mesma linha, e é o índice
+ * único que garante isso sob concorrência — não o `SELECT` prévio.
+ */
+export declare function openCompetence(tx: Tx, input: {
+    clientId: string;
+    label: string;
+}): Promise<{
+    competence: CompetenceRecord;
+    created: boolean;
+}>;
+export declare function getCompetence(tx: Tx, id: string): Promise<CompetenceRecord>;
+export declare function listCompetences(tx: Tx, filter?: {
+    clientId?: string;
+    status?: CompetenceStatus;
+    limit?: number;
+    offset?: number;
+}): Promise<{
+    items: CompetenceRecord[];
+    total: number;
+}>;
+/**
+ * Fechar é evento, não flag: exige que não reste pendência obrigatória aberta.
+ * A checagem é feita aqui, e não por trigger, porque a regra é de negócio e
+ * precisa produzir uma mensagem que o usuário entenda.
+ */
+export declare function closeCompetence(tx: Tx, input: {
+    id: string;
+    closedBy: string;
+    force?: boolean;
+}): Promise<CompetenceRecord>;
+export declare function reopenCompetence(tx: Tx, input: {
+    id: string;
+    reopenedBy: string;
+}): Promise<CompetenceRecord>;
+export type ItemNature = 'obligation' | 'task';
+export type RecurrencePeriodicity = 'monthly' | 'quarterly' | 'yearly' | 'eventual';
+export interface RecurringItemTypeRecord {
+    id: string;
+    tenantId: string | null;
+    key: string;
+    label: string;
+    nature: ItemNature;
+    sphere: string | null;
+    periodicity: RecurrencePeriodicity;
+    dueRule: Record<string, unknown>;
+    appliesToRegime: string[];
+    requiresDocument: boolean;
+    active: boolean;
+    /** Observação para quem confere. Vem do catálogo da vertical. */
+    note: string | null;
+    /** Agrupamento do catálogo (folha, fiscal, contábil…). */
+    category: string | null;
+}
+/**
+ * Lista o catálogo efetivo: override do tenant vence o template do sistema
+ * quando as duas linhas têm a mesma `key`. O `DISTINCT ON` com `ORDER BY
+ * tenant_id NULLS LAST` é o que implementa essa precedência em uma passada.
+ */
+export declare function listRecurringItemTypes(tx: Tx, filter?: {
+    nature?: ItemNature;
+    activeOnly?: boolean;
+}): Promise<RecurringItemTypeRecord[]>;
+export declare function createRecurringItemType(tx: Tx, input: {
+    key: string;
+    label: string;
+    nature: ItemNature;
+    sphere?: string | null;
+    periodicity?: RecurrencePeriodicity;
+    dueRule?: Record<string, unknown>;
+    appliesToRegime?: string[];
+    requiresDocument?: boolean;
+}): Promise<RecurringItemTypeRecord>;
+export interface RecurringInstanceRecord {
+    id: string;
+    clientId: string;
+    competenceId: string;
+    itemTypeId: string;
+    label: string;
+    nature: ItemNature;
+    dueDate: string | null;
+    status: string;
+    responsibleUserId: string | null;
+    completedAt: string | null;
+}
+/**
+ * Gera as instâncias de uma competência a partir do catálogo.
+ *
+ * **Idempotente pelo schema, não pelo código.** O `ON CONFLICT DO NOTHING` bate
+ * no índice único `(tenant, client, competence, item_type)`; rodar N vezes
+ * produz exatamente uma instância por tipo. É o que hoje falta e permite lançar
+ * a mesma DAS de julho três vezes.
+ *
+ * Devolve quantas foram criadas de fato — o operador precisa distinguir "gerei
+ * 8" de "já estava tudo lá".
+ */
+export declare function generateInstancesForCompetence(tx: Tx, input: {
+    competenceId: string;
+    regime?: string | null;
+}): Promise<{
+    created: RecurringInstanceRecord[];
+    skipped: number;
+}>;
+/**
+ * Aplica a regra de vencimento sobre a competência.
+ *
+ * Regra desconhecida devolve `null` em vez de chutar uma data — um vencimento
+ * inventado é pior que vencimento ausente, porque o alerta dispararia no dia
+ * errado e o usuário confiaria nele.
+ *
+ * ## Formas aceitas
+ *
+ * | `kind`                    | Campos            | Significado                                          |
+ * |---------------------------|-------------------|------------------------------------------------------|
+ * | `day_of_month`            | `day` 1–28        | Dia N da própria competência                         |
+ * | `day_of_next_month`       | `day` 1–28        | Dia N do mês seguinte                                |
+ * | `day_after_months`        | `day` 1–28, `months` | Dia N, M meses depois (generaliza os dois acima)  |
+ * | `last_business_day_after` | `months`          | Último dia útil do mês M meses depois                |
+ * | `nth_business_day_after`  | `nth`, `months`   | N-ésimo dia útil do mês M meses depois               |
+ * | `fixed_annual`            | `month`, `day`    | Data fixa do ano SEGUINTE ao da competência          |
+ * | `last_business_day_annual`| `month`           | Último dia útil de um mês do ano seguinte            |
+ *
+ * `adjust` move o resultado para um dia útil: `'previous'` (antecipa — é o padrão
+ * do recolhimento fiscal brasileiro), `'next'`, ou `'none'`.
+ *
+ * **`adjust` ausente significa `'none'`, deliberadamente.** As duas formas
+ * originais (`day_of_month`, `day_of_next_month`) foram criadas sem noção de dia
+ * útil e há regras gravadas em produção que dependem do resultado exato. Ligar o
+ * ajuste por padrão mudaria silenciosamente o vencimento de instâncias que já
+ * existem. Quem quer o comportamento fiscal pede por ele — e o catálogo de
+ * `@baruk/contabil` pede.
+ */
+export declare function computeDueDate(competenceLabel: string, rule: Record<string, unknown>): string | null;
+export declare function listInstances(tx: Tx, filter?: {
+    competenceId?: string;
+    clientId?: string;
+    status?: string;
+}): Promise<RecurringInstanceRecord[]>;
+export interface BulkOpenResult {
+    clientsProcessed: number;
+    competencesOpened: number;
+    competencesExisting: number;
+    itemsCreated: number;
+    itemsSkipped: number;
+    /** Clientes que falharam, com o motivo — a falha de um não derruba os outros. */
+    failures: {
+        clientId: string;
+        reason: string;
+    }[];
+}
+/**
+ * Abre a competência do mês para a carteira inteira e gera os itens.
+ *
+ * É a ação que abre o mês de um escritório. Sem ela, "abrir competência" é uma
+ * operação por cliente — o que funciona na demonstração com três clientes e é
+ * impraticável com trezentos: ninguém vai clicar trezentas vezes todo dia 1º.
+ *
+ * Idempotente nas duas camadas: `openCompetence` faz `ON CONFLICT DO NOTHING`, e
+ * a geração é protegida pelo índice único `(tenant, client, competence, tipo)`.
+ * Rodar duas vezes no mesmo mês não duplica nada.
+ *
+ * O regime de cada cliente é resolvido por `resolveRegime` — injetado, porque
+ * quem sabe ler regime tributário é a vertical, e o Core não a conhece.
+ *
+ * Falha de um cliente não aborta o lote. Abortar deixaria o escritório com o mês
+ * meio aberto e sem saber onde parou; aqui ele vê o que passou e o que não.
+ */
+export declare function bulkOpenCompetence(tx: Tx, input: {
+    label: string;
+    /** Ausente = todos os clientes ativos do tenant. */
+    clientIds?: string[];
+    resolveRegime?: (clientId: string) => Promise<string | null>;
+}): Promise<BulkOpenResult>;
+/**
+ * A visão operacional do escritório: o que vence, de quem, e com quem está.
+ *
+ * `listInstances` responde "o que tem nesta competência" — serve à ficha de UM
+ * cliente. Não serve à pergunta que abre o dia de um escritório com 300 clientes:
+ * *o que vence esta semana?* Essa atravessa clientes e competências, e precisa do
+ * nome do cliente junto, senão a tela mostra uma lista de rótulos sem dono.
+ *
+ * Tenant-scoped por RLS como todo o resto. O JOIN com `client` é interno ao
+ * tenant por construção (FK composta), e `deleted_at IS NULL` no cliente evita
+ * que a carteira higienizada reapareça aqui.
+ */
+export interface OfficeObligationRow extends RecurringInstanceRecord {
+    clientName: string;
+    competenceLabel: string;
+    sphere: string | null;
+    category: string | null;
+    requiresDocument: boolean;
+    responsibleName: string | null;
+}
+export declare function listOfficeObligations(tx: Tx, filter?: {
+    dueFrom?: string | null;
+    dueTo?: string | null;
+    status?: string | null;
+    nature?: ItemNature | null;
+    clientId?: string | null;
+    responsibleUserId?: string | null;
+    /** `true` = só o que ainda não foi concluído. */
+    openOnly?: boolean;
+    limit?: number;
+    offset?: number;
+}): Promise<{
+    items: OfficeObligationRow[];
+    total: number;
+}>;
+/**
+ * Define o responsável por um item.
+ *
+ * Existe porque não existia: a rota de compliance legada gravava
+ * `responsibleUserId = auth.userId` sem aceitar o campo, então a obrigação era
+ * sempre de quem a criou. Um escritório distribui trabalho; sem isto, "de quem é
+ * esta DAS?" não tem resposta no produto.
+ *
+ * `null` desatribui — deixar sem dono é um estado legítimo, e sem essa
+ * distinção um campo esvaziado na tela seria indistinguível de "não mexi nele".
+ */
+export declare function assignInstance(tx: Tx, input: {
+    id: string;
+    responsibleUserId: string | null;
+}): Promise<RecurringInstanceRecord>;
+/**
+ * Reabre um item concluído.
+ *
+ * Marcar como entregue é a ação mais fácil de errar na tela — uma linha ao lado
+ * da outra, um clique. Sem reabrir, o erro vira permanente e o operador aprende
+ * a não confiar no botão.
+ */
+export declare function reopenInstance(tx: Tx, id: string): Promise<RecurringInstanceRecord>;
+/**
+ * Fecha a obrigação quando TODOS os documentos que ela pedia foram validados.
+ *
+ * Este é o elo que faltava no ciclo. `document_request.recurring_instance_id`
+ * existe no schema desde a 0026 e nunca era preenchido, então validar um
+ * documento não dizia nada à obrigação que o pediu: o operador entregava a
+ * DAS, validava a nota fiscal, e ainda precisava lembrar de marcar a obrigação
+ * à mão — numa lista onde esquecer é o resultado provável.
+ *
+ * **Todos**, não "algum". Uma obrigação pode pedir três documentos; concluir no
+ * primeiro validado marcaria como entregue algo que ainda falta. Pedido
+ * `canceled` não conta como pendência — foi retirado de propósito.
+ *
+ * Devolve a instância quando concluiu, `null` quando ainda há pendência. `null`
+ * é resposta normal, não erro.
+ */
+export declare function completeInstanceIfDocumentsSettled(tx: Tx, input: {
+    instanceId: string;
+    completedBy: string;
+}): Promise<RecurringInstanceRecord | null>;
+export declare function completeInstance(tx: Tx, input: {
+    id: string;
+    completedBy: string;
+}): Promise<RecurringInstanceRecord>;
+//# sourceMappingURL=repository.d.ts.map

package/dist/competence/repository.d.ts.map

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