@baruk/core 0.3.1 → 0.4.2

package/dist/communication/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../src/communication/webhook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,EAAE,UAAU,EAAsB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAuB,MAAM,aAAa,CAAC;AAajF;;;;;GAKG;AACH,MAAM,WAAW,GAAmC;IAClD,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;CACjB,CAAC;AASF;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAa,EAAE,MAAsB;IAC5E,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE;QAC3C,4EAA4E;QAC5E,qEAAqE;QACrE,6CAA6C;QAC7C,EAAE;QACF,2EAA2E;QAC3E,uEAAuE;QACvE,iEAAiE;QACjE,+DAA+D;QAC/D,IAAI,MAAM,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YAAE,OAAO;QAE3E,MAAM,QAAQ,GAAI,MAAuD,EAAE,KAAK,EAAE,QAAQ,CAAC;QAC3F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,OAAO;QAErC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5D,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM;gBAAE,SAAS;YAE/B,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,UAAU;gBACnB,WAAW,EAAE,CAAC,CAAC,EAAE;gBACjB,MAAM;gBACN,UAAU,EAAE,CAAC,CAAC,SAAS;oBACrB,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;oBACpD,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC5B,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;gBACpD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;aACpC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,aAAa,CACpB,IAAa,EACb,EAA2D;IAE3D,MAAM,OAAO,GAAI,IAA8B,EAAE,KAAK,CAAC;IACvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO;IAEpC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAE,KAA0B,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,OAAO,GAAI,KAAiC,EAAE,OAAO,CAAC;QAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAS;QAEtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAG,IAAI,CACpB,MAAmE,EAAE,KAAK,EAAE,QAAQ;gBACnF,EAAE,eAAe,CACpB,CAAC;YACF,kEAAkE;YAClE,wBAAwB;YACxB,EAAE;YACF,qEAAqE;YACrE,mEAAmE;YACnE,uEAAuE;YACvE,wEAAwE;YACxE,yCAAyC;YACzC,EAAE,CACA,MAAM,EACN,UAAU;gBACR,CAAC,CAAC;oBACE,QAAQ,EAAE,eAAe;oBACzB,kBAAkB,EAAE,UAAU;oBAC9B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACvD;gBACH,CAAC,CAAC,IAAI,CACT,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,IAAI,CAAC,CAAU;IACtB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,CAAC;IACD,6EAA6E;IAC7E,yEAAyE;IACzE,0EAA0E;IAC1E,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAChF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAa;IACnD,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,aAAa,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC;AAMD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAuB,EACvB,KAAoB;IAEpB,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC;IAC7D,CAAC;IACD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACrE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAyC,EACzC,mBAAuC;IAEvC,IAAI,CAAC,mBAAmB;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAEnD,MAAM,QAAQ,GAAG,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,mBAAmB,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAwB,EACxB,eAAmC,EACnC,SAA6B;IAE7B,IAAI,CAAC,SAAS,IAAI,CAAC,eAAe;QAAE,OAAO,KAAK,CAAC;IACjD,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,IAAI,KAAK,QAAQ,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEjD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC;SAC7C,MAAM,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;SAC5E,MAAM,CAAC,KAAK,CAAC,CAAC;IAEjB,OAAO,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,qBAAqB,CAAC,CAAS,EAAE,CAAS;IACjD,MAAM,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3D,MAAM,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3D,OAAO,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,OAAO,GAAG,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;AAChD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC;AAS7F;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAa,EAAE,MAAsB;IAC1E,MAAM,GAAG,GAAoB,EAAE,CAAC;IAEhC,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE;QAC3C,IAAI,MAAM,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YAAE,OAAO;QAE3E,MAAM,QAAQ,GACZ,MAGD,EAAE,KAAK,EAAE,QAAQ,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,OAAO;QAErC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAChD,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI;gBAAE,SAAS;YAC/B,qEAAqE;YACrE,sEAAsE;YACtE,uBAAuB;YACvB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YACvC,GAAG,CAAC,IAAI,CAAC;gBACP,OAAO,EAAE,UAAU;gBACnB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,UAAU,EAAE,CAAC,CAAC,SAAS;oBACrB,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;oBACpD,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAC7B,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/competence/repository.d.ts

@@ -0,0 +1,147 @@
+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;
+}
+/**
+ * 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.
+ *
+ * Hoje entende `{kind:'day_of_next_month', day:N}` e `{kind:'day_of_month', day:N}`.
+ * 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.
+ */
+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 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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"}

package/dist/competence/repository.js

@@ -0,0 +1,294 @@
+import { ConflictError, NotFoundError, ValidationError, uuidv7 } from '@baruk/shared';
+/**
+ * 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 const COMPETENCE_LABEL_RE = /^\d{4}-(0[1-9]|1[0-2])$/;
+function mapCompetence(row) {
+    return {
+        id: row.id,
+        tenantId: row.tenant_id,
+        clientId: row.client_id,
+        label: row.label,
+        status: row.status,
+        openedAt: row.opened_at.toISOString(),
+        closedAt: row.closed_at ? row.closed_at.toISOString() : null,
+        version: row.version,
+    };
+}
+/**
+ * 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 function assertCompetenceLabel(label) {
+    if (!COMPETENCE_LABEL_RE.test(label)) {
+        throw new ValidationError('competência deve estar no formato YYYY-MM, com mês entre 01 e 12');
+    }
+}
+/**
+ * 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 async function openCompetence(tx, input) {
+    assertCompetenceLabel(input.label);
+    const inserted = await tx `
+    INSERT INTO competence (id, tenant_id, client_id, label)
+    VALUES (
+      ${uuidv7()}, current_setting('app.current_tenant')::uuid,
+      ${input.clientId}, ${input.label}
+    )
+    ON CONFLICT DO NOTHING
+    RETURNING id, tenant_id, client_id, label, status, opened_at, closed_at, version
+  `;
+    if (inserted[0])
+        return { competence: mapCompetence(inserted[0]), created: true };
+    const existing = await tx `
+    SELECT id, tenant_id, client_id, label, status, opened_at, closed_at, version
+    FROM competence
+    WHERE client_id = ${input.clientId} AND label = ${input.label} AND deleted_at IS NULL
+  `;
+    if (!existing[0])
+        throw new ConflictError('não foi possível abrir a competência');
+    return { competence: mapCompetence(existing[0]), created: false };
+}
+export async function getCompetence(tx, id) {
+    const rows = await tx `
+    SELECT id, tenant_id, client_id, label, status, opened_at, closed_at, version
+    FROM competence WHERE id = ${id} AND deleted_at IS NULL
+  `;
+    if (!rows[0])
+        throw new NotFoundError('Competência não encontrada');
+    return mapCompetence(rows[0]);
+}
+export async function listCompetences(tx, filter = {}) {
+    const limit = Math.min(filter.limit ?? 50, 100);
+    const offset = filter.offset ?? 0;
+    const rows = await tx `
+    SELECT id, tenant_id, client_id, label, status, opened_at, closed_at, version,
+           count(*) OVER() AS total
+    FROM competence
+    WHERE deleted_at IS NULL
+      AND (${filter.clientId ?? null}::uuid IS NULL OR client_id = ${filter.clientId ?? null})
+      AND (${filter.status ?? null}::text IS NULL OR status = ${filter.status ?? null})
+    ORDER BY label DESC, created_at DESC
+    LIMIT ${limit} OFFSET ${offset}
+  `;
+    return {
+        total: rows[0] ? Number(rows[0].total) : 0,
+        items: rows.map(mapCompetence),
+    };
+}
+const CLOSEABLE = [
+    'open',
+    'in_progress',
+    'awaiting_client',
+    'review',
+    'reopened',
+];
+/**
+ * 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 async function closeCompetence(tx, input) {
+    const current = await getCompetence(tx, input.id);
+    if (current.status === 'closed')
+        throw new ConflictError('Competência já está fechada');
+    if (!CLOSEABLE.includes(current.status)) {
+        throw new ConflictError(`Competência em ${current.status} não pode ser fechada`);
+    }
+    if (!input.force) {
+        const pending = await tx `
+      SELECT count(*)::int AS n FROM recurring_instance
+      WHERE competence_id = ${input.id} AND deleted_at IS NULL
+        AND status NOT IN ('done', 'not_applicable', 'canceled')
+    `;
+        if ((pending[0]?.n ?? 0) > 0) {
+            throw new ConflictError(`Competência tem ${pending[0].n} item(ns) em aberto. Conclua ou marque como não aplicável antes de fechar.`);
+        }
+    }
+    const rows = await tx `
+    UPDATE competence
+       SET status = 'closed', closed_at = now(), closed_by = ${input.closedBy},
+           version = version + 1, updated_at = now()
+     WHERE id = ${input.id} AND deleted_at IS NULL
+    RETURNING id, tenant_id, client_id, label, status, opened_at, closed_at, version
+  `;
+    if (!rows[0])
+        throw new NotFoundError('Competência não encontrada');
+    return mapCompetence(rows[0]);
+}
+export async function reopenCompetence(tx, input) {
+    const rows = await tx `
+    UPDATE competence
+       SET status = 'reopened', closed_at = NULL, closed_by = NULL,
+           reopened_at = now(), reopened_by = ${input.reopenedBy},
+           version = version + 1, updated_at = now()
+     WHERE id = ${input.id} AND status = 'closed' AND deleted_at IS NULL
+    RETURNING id, tenant_id, client_id, label, status, opened_at, closed_at, version
+  `;
+    if (!rows[0])
+        throw new NotFoundError('Competência fechada não encontrada');
+    return mapCompetence(rows[0]);
+}
+function mapItemType(row) {
+    return {
+        id: row.id,
+        tenantId: row.tenant_id,
+        key: row.key,
+        label: row.label,
+        nature: row.nature,
+        sphere: row.sphere,
+        periodicity: row.periodicity,
+        dueRule: row.due_rule ?? {},
+        appliesToRegime: Array.isArray(row.applies_to_regime) ? row.applies_to_regime : [],
+        requiresDocument: row.requires_document,
+        active: row.active,
+    };
+}
+/**
+ * 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 async function listRecurringItemTypes(tx, filter = {}) {
+    const rows = await tx `
+    SELECT DISTINCT ON (key)
+           id, tenant_id, key, label, nature, sphere, periodicity,
+           due_rule, applies_to_regime, requires_document, active
+      FROM recurring_item_type
+     WHERE deleted_at IS NULL
+       AND (${filter.nature ?? null}::text IS NULL OR nature = ${filter.nature ?? null})
+       AND (${filter.activeOnly ?? true} = false OR active = true)
+     ORDER BY key, tenant_id NULLS LAST
+  `;
+    return rows.map(mapItemType);
+}
+export async function createRecurringItemType(tx, input) {
+    const rows = await tx `
+    INSERT INTO recurring_item_type
+      (id, tenant_id, key, label, nature, sphere, periodicity, due_rule,
+       applies_to_regime, requires_document)
+    VALUES (
+      ${uuidv7()}, current_setting('app.current_tenant')::uuid,
+      ${input.key}, ${input.label}, ${input.nature}, ${input.sphere ?? null},
+      ${input.periodicity ?? 'monthly'}, ${tx.json((input.dueRule ?? {}))},
+      ${tx.json((input.appliesToRegime ?? []))}, ${input.requiresDocument ?? false}
+    )
+    RETURNING id, tenant_id, key, label, nature, sphere, periodicity,
+              due_rule, applies_to_regime, requires_document, active
+  `;
+    return mapItemType(rows[0]);
+}
+function mapInstance(row) {
+    return {
+        id: row.id,
+        clientId: row.client_id,
+        competenceId: row.competence_id,
+        itemTypeId: row.item_type_id,
+        label: row.label,
+        nature: row.nature,
+        dueDate: row.due_date,
+        status: row.status,
+        responsibleUserId: row.responsible_user_id,
+        completedAt: row.completed_at ? row.completed_at.toISOString() : 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 async function generateInstancesForCompetence(tx, input) {
+    const competence = await getCompetence(tx, input.competenceId);
+    const types = await listRecurringItemTypes(tx, { activeOnly: true });
+    const applicable = types.filter((t) => t.appliesToRegime.length === 0 ||
+        (input.regime != null && t.appliesToRegime.includes(input.regime)));
+    const created = [];
+    for (const type of applicable) {
+        const dueDate = computeDueDate(competence.label, type.dueRule);
+        const rows = await tx `
+      INSERT INTO recurring_instance
+        (id, tenant_id, client_id, competence_id, item_type_id, label, nature, due_date)
+      VALUES (
+        ${uuidv7()}, current_setting('app.current_tenant')::uuid,
+        ${competence.clientId}, ${competence.id}, ${type.id},
+        ${type.label}, ${type.nature}, ${dueDate}
+      )
+      ON CONFLICT DO NOTHING
+      RETURNING id, client_id, competence_id, item_type_id, label, nature,
+                due_date, status, responsible_user_id, completed_at
+    `;
+        if (rows[0])
+            created.push(mapInstance(rows[0]));
+    }
+    return { created, skipped: applicable.length - created.length };
+}
+/**
+ * Aplica a regra de vencimento sobre a competência.
+ *
+ * Hoje entende `{kind:'day_of_next_month', day:N}` e `{kind:'day_of_month', day:N}`.
+ * 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.
+ */
+export function computeDueDate(competenceLabel, rule) {
+    const kind = typeof rule['kind'] === 'string' ? rule['kind'] : null;
+    const day = typeof rule['day'] === 'number' ? rule['day'] : null;
+    if (!kind || day == null || day < 1 || day > 28)
+        return null;
+    const [yearStr, monthStr] = competenceLabel.split('-');
+    let year = Number(yearStr);
+    let month = Number(monthStr);
+    if (kind === 'day_of_next_month') {
+        month += 1;
+        if (month > 12) {
+            month = 1;
+            year += 1;
+        }
+    }
+    else if (kind !== 'day_of_month') {
+        return null;
+    }
+    return `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`;
+}
+export async function listInstances(tx, filter = {}) {
+    const rows = await tx `
+    SELECT id, client_id, competence_id, item_type_id, label, nature,
+           due_date, status, responsible_user_id, completed_at
+      FROM recurring_instance
+     WHERE deleted_at IS NULL
+       AND (${filter.competenceId ?? null}::uuid IS NULL OR competence_id = ${filter.competenceId ?? null})
+       AND (${filter.clientId ?? null}::uuid IS NULL OR client_id = ${filter.clientId ?? null})
+       AND (${filter.status ?? null}::text IS NULL OR status = ${filter.status ?? null})
+     ORDER BY due_date NULLS LAST, label
+  `;
+    return rows.map(mapInstance);
+}
+export async function completeInstance(tx, input) {
+    const rows = await tx `
+    UPDATE recurring_instance
+       SET status = 'done', completed_at = now(), completed_by = ${input.completedBy},
+           version = version + 1, updated_at = now()
+     WHERE id = ${input.id} AND deleted_at IS NULL AND status <> 'done'
+    RETURNING id, client_id, competence_id, item_type_id, label, nature,
+              due_date, status, responsible_user_id, completed_at
+  `;
+    if (!rows[0])
+        throw new NotFoundError('Item não encontrado ou já concluído');
+    return mapInstance(rows[0]);
+}
+//# sourceMappingURL=repository.js.map

package/dist/competence/repository.js.map

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

package/dist/contacts/phone.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Telefone brasileiro em formato canônico.
+ *
+ * Existe UMA vez, e não uma por canal, porque WhatsApp e SMS discordariam no
+ * primeiro caso de borda — e discordar aqui significa uma mensagem chegar e a
+ * outra não, para o mesmo cliente, sem que nada no sistema explique por quê.
+ *
+ * O que este módulo NÃO faz: dizer se o número existe, se está ativo, ou se tem
+ * WhatsApp. Nada disso é derivável do formato. Ele responde uma pergunta só —
+ * "isto tem a FORMA de um número brasileiro discável?" — e a resposta negativa
+ * é confiável, enquanto a positiva é apenas necessária, nunca suficiente.
+ */
+/** Como o provider quer receber: `+55DDNNNNNNNNN`, sem separador. */
+export type E164 = string;
+export type PhoneKind = 'mobile' | 'landline';
+export type PhoneRejection = 
+/** Vazio ou só separadores. */
+'empty'
+/** Dígitos de menos ou de mais para qualquer formato brasileiro. */
+ | 'length'
+/** DDD que não existe no plano de numeração. */
+ | 'ddd'
+/** DDI presente e diferente de 55 — fora do escopo desta normalização. */
+ | 'foreign'
+/** Nono dígito ausente ou inicial inválida para celular. */
+ | 'not_dialable';
+export type PhoneParse = {
+    ok: true;
+    e164: E164;
+    kind: PhoneKind;
+    areaCode: string;
+    national: string;
+} | {
+    ok: false;
+    reason: PhoneRejection;
+};
+/**
+ * Normaliza um telefone digitado por gente.
+ *
+ * Aceita o que o operador realmente digita: `(62) 99999-8888`, `62999998888`,
+ * `+55 62 99999 8888`, `55 62 9999-8888`, com espaço, ponto, barra ou traço.
+ *
+ * A ambiguidade real é o `55`: ele é DDI (Brasil) e também DDD (Rio Grande do
+ * Sul). `5551999998888` tem 13 dígitos e é `+55 51 99999-8888`; `5599998888`
+ * tem 10 e é `(55) 9999-8888`, um fixo gaúcho. O tamanho resolve — e é por isso
+ * que a decisão é tomada pelo COMPRIMENTO antes de olhar o prefixo, nunca ao
+ * contrário.
+ */
+export declare function parseBrazilPhone(raw: string | null | undefined): PhoneParse;
+/**
+ * O número serve para WhatsApp/SMS?
+ *
+ * Só celular. Fixo é discável e válido — e é exatamente por isso que precisa de
+ * uma checagem própria: ele passa em `parseBrazilPhone`, o provider aceita a
+ * requisição, e a mensagem nunca chega. Um "erro" que não aparece em lugar
+ * nenhum, mês após mês.
+ */
+export declare function isMessagingCapable(parsed: PhoneParse): boolean;
+/** Conveniência para gravar em `client.phone_e164`. `null` quando não dá. */
+export declare function toE164OrNull(raw: string | null | undefined): E164 | null;
+/**
+ * Versão para log e tela: `+55 (62) 9****-**88`.
+ *
+ * A trilha precisa provar PARA ONDE foi, e um telefone inteiro em log é PII que
+ * vaza em screenshot, exportação e print de suporte. Os quatro caracteres
+ * visíveis bastam para o operador reconhecer o número que ele mesmo cadastrou,
+ * e não bastam para discar.
+ */
+export declare function maskPhone(e164: string): string;
+//# sourceMappingURL=phone.d.ts.map

package/dist/contacts/phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.d.ts","sourceRoot":"","sources":["../../src/contacts/phone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,qEAAqE;AACrE,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC;AAE1B,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9C,MAAM,MAAM,cAAc;AACxB,+BAA+B;AAC7B,OAAO;AACT,oEAAoE;GAClE,QAAQ;AACV,gDAAgD;GAC9C,KAAK;AACP,0EAA0E;GACxE,SAAS;AACX,4DAA4D;GAC1D,cAAc,CAAC;AAEnB,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC7E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC;AAiF1C;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,CAiD3E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE9D;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAGxE;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9C"}