@baruk/core 0.3.0 → 0.4.2

package/dist/cjs/collection/policy.js.map

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

package/dist/cjs/collection/repository.js

@@ -0,0 +1,260 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCollectionPolicy = getCollectionPolicy;
+exports.upsertCollectionPolicy = upsertCollectionPolicy;
+exports.scheduleAction = scheduleAction;
+exports.getAction = getAction;
+exports.listActions = listActions;
+exports.handledStepKeys = handledStepKeys;
+exports.markSent = markSent;
+exports.markFailed = markFailed;
+exports.markEscalated = markEscalated;
+exports.cancelPendingActions = cancelPendingActions;
+exports.collectionMetrics = collectionMetrics;
+exports.clientTimeline = clientTimeline;
+const shared_1 = require("@baruk/shared");
+const policy_js_1 = require("./policy.js");
+const iso = (d) => (d ? d.toISOString().slice(0, 10) : null);
+function mapAction(r) {
+    return {
+        id: r.id,
+        receivableId: r.receivable_id,
+        clientId: r.client_id,
+        clientName: r.client_name,
+        stepKey: r.step_key,
+        channel: r.channel,
+        template: r.template,
+        status: r.status,
+        scheduledFor: iso(r.scheduled_for),
+        attempts: r.attempts,
+        lastError: r.last_error,
+        sentAt: r.sent_at?.toISOString() ?? null,
+        closedAt: r.closed_at?.toISOString() ?? null,
+        closedReason: r.closed_reason,
+        recipientRef: r.recipient_ref,
+        amountAtSend: r.amount_at_send === null ? null : Number(r.amount_at_send),
+        createdAt: r.created_at.toISOString(),
+    };
+}
+const SELECT_ACTION = `
+  SELECT d.id, d.receivable_id, r.client_id, c.display_name AS client_name, d.step_key,
+         d.channel, d.template, d.status, d.scheduled_for, d.attempts, d.last_error,
+         d.sent_at, d.closed_at, d.closed_reason, d.recipient_ref, d.amount_at_send, d.created_at
+    FROM dunning_event d
+    LEFT JOIN receivable r ON r.id = d.receivable_id
+    LEFT JOIN client c ON c.id = r.client_id AND c.deleted_at IS NULL`;
+// ── Política ────────────────────────────────────────────────────────────────
+/** Política ativa do tenant; cai no padrão do produto quando não há nenhuma. */
+async function getCollectionPolicy(tx) {
+    const rows = await tx `
+    SELECT id, name, steps, active FROM dunning_rule
+     WHERE active AND is_default
+     ORDER BY created_at LIMIT 1
+  `;
+    const row = rows[0];
+    if (!row)
+        return policy_js_1.DEFAULT_POLICY;
+    const steps = (0, policy_js_1.parsePolicySteps)(row.steps);
+    // Política cadastrada mas ilegível não pode virar "sem cobrança nenhuma"
+    // silenciosamente: melhor cair no padrão e deixar a régua rodando.
+    if (steps.length === 0)
+        return { ...policy_js_1.DEFAULT_POLICY, id: row.id, name: row.name };
+    return { id: row.id, name: row.name, steps, active: row.active };
+}
+async function upsertCollectionPolicy(tx, input) {
+    const steps = (0, policy_js_1.parsePolicySteps)(input.steps);
+    const existing = await tx `
+    SELECT id FROM dunning_rule WHERE is_default LIMIT 1
+  `;
+    if (existing[0]) {
+        await tx `
+      UPDATE dunning_rule
+         SET name = ${input.name}, steps = ${tx.json(steps)},
+             active = ${input.active ?? true}, updated_at = now()
+       WHERE id = ${existing[0].id}
+    `;
+    }
+    else {
+        await tx `
+      INSERT INTO dunning_rule (id, tenant_id, name, steps, active, is_default)
+      VALUES (${(0, shared_1.uuidv7)()},
+              (NULLIF(current_setting('app.current_tenant', true), ''))::uuid,
+              ${input.name}, ${tx.json(steps)}, ${input.active ?? true}, true)
+    `;
+    }
+    return getCollectionPolicy(tx);
+}
+// ── Ações ───────────────────────────────────────────────────────────────────
+/**
+ * Agenda uma etapa. Idempotente pelo índice único parcial
+ * `(tenant, receivable, step_key)` — o `ON CONFLICT DO NOTHING` é o que
+ * transforma job repetido, retry, restart de worker e webhook duplicado em
+ * uma única ação lógica.
+ */
+async function scheduleAction(tx, input) {
+    const rows = await tx `
+    INSERT INTO dunning_event (id, tenant_id, receivable_id, step_key, channel, template,
+                               status, scheduled_for)
+    VALUES (${(0, shared_1.uuidv7)()},
+            (NULLIF(current_setting('app.current_tenant', true), ''))::uuid,
+            ${input.receivableId}, ${input.stepKey}, ${input.channel}, ${input.template},
+            'scheduled', ${input.scheduledFor})
+    ON CONFLICT (tenant_id, receivable_id, step_key) WHERE receivable_id IS NOT NULL
+    DO NOTHING
+    RETURNING id
+  `;
+    if (!rows[0])
+        return null;
+    return getAction(tx, rows[0].id);
+}
+async function getAction(tx, id) {
+    const rows = await tx `${tx.unsafe(SELECT_ACTION)} WHERE d.id = ${id}`;
+    const row = rows[0];
+    if (!row)
+        throw new Error('Ação de cobrança não encontrada');
+    return mapAction(row);
+}
+async function listActions(tx, filter = {}) {
+    const limit = Math.min(Math.max(filter.limit ?? 100, 1), 500);
+    const rows = await tx `
+    ${tx.unsafe(SELECT_ACTION)}
+     WHERE d.receivable_id IS NOT NULL
+       ${filter.status ? tx `AND d.status = ${filter.status}` : tx ``}
+       ${filter.receivableId ? tx `AND d.receivable_id = ${filter.receivableId}` : tx ``}
+       ${filter.clientId ? tx `AND r.client_id = ${filter.clientId}` : tx ``}
+       ${filter.dueOnly
+        ? tx `AND d.status = 'scheduled' AND d.scheduled_for <= ${filter.dueUntil ?? tx `CURRENT_DATE`}`
+        : tx ``}
+     ORDER BY d.scheduled_for NULLS LAST, d.created_at
+     LIMIT ${limit}
+  `;
+    return rows.map(mapAction);
+}
+/** Etapas já registradas para um recebível — alimenta a idempotência da régua. */
+async function handledStepKeys(tx, receivableId) {
+    const rows = await tx `
+    SELECT step_key FROM dunning_event WHERE receivable_id = ${receivableId}
+  `;
+    return new Set(rows.map((r) => r.step_key));
+}
+/**
+ * Assenta o envio.
+ *
+ * O identificador do provider vai para `provider_ref` (migration 0038). Antes
+ * ele era espremido em `template` sob COALESCE: como `scheduleAction` sempre
+ * grava o template, o id do provider era descartado em silêncio — e, se o
+ * template estivesse nulo, ocupava o lugar do nome e corrompia o relatório.
+ *
+ * Nunca deu problema porque o adapter de e-mail não devolve identificador.
+ * WhatsApp e SMS devolvem sempre, e o webhook de entrega chega trazendo APENAS
+ * esse id: sem coluna própria e indexada, todo status de entrega se perderia.
+ */
+async function markSent(tx, id, input) {
+    await tx `
+    UPDATE dunning_event
+       SET status = 'sent', sent_at = now(), attempts = attempts + 1,
+           recipient_ref = ${input.recipientRef}, amount_at_send = ${input.amount},
+           last_error = NULL, closed_at = now(),
+           provider_ref = COALESCE(${input.providerRef ?? null}, provider_ref),
+           idempotency_key = COALESCE(${input.idempotencyKey ?? null}, idempotency_key)
+     WHERE id = ${id}
+  `;
+}
+async function markFailed(tx, id, input) {
+    await tx `
+    UPDATE dunning_event
+       SET status = ${input.permanent ? 'failed' : 'scheduled'},
+           attempts = attempts + 1,
+           last_error = ${input.error.slice(0, 300)},
+           closed_at = ${input.permanent ? tx `now()` : null},
+           closed_reason = ${input.permanent ? 'permanent_failure' : null}
+     WHERE id = ${id}
+  `;
+}
+async function markEscalated(tx, id, reason = 'escalated') {
+    await tx `
+    UPDATE dunning_event
+       SET status = 'escalated', closed_at = now(), closed_reason = ${reason}
+     WHERE id = ${id}
+  `;
+}
+/**
+ * Cancela ações ainda não enviadas de um recebível.
+ *
+ * Só toca `scheduled`: o que já saiu é histórico e não se apaga. Retorna quantas
+ * foram canceladas para o job poder relatar honestamente o que aconteceu.
+ */
+async function cancelPendingActions(tx, receivableId, reason) {
+    const rows = await tx `
+    UPDATE dunning_event
+       SET status = 'canceled', closed_at = now(), closed_reason = ${reason}
+     WHERE receivable_id = ${receivableId} AND status = 'scheduled'
+    RETURNING id
+  `;
+    return rows.length;
+}
+async function collectionMetrics(tx) {
+    const [m] = await tx `
+    SELECT
+      count(*) FILTER (WHERE status = 'scheduled')::int AS scheduled,
+      count(*) FILTER (WHERE status = 'sent')::int AS sent,
+      count(*) FILTER (WHERE status = 'failed')::int AS failed,
+      count(*) FILTER (WHERE status = 'canceled')::int AS canceled,
+      count(*) FILTER (WHERE status = 'canceled' AND closed_reason = 'paid')::int AS stopped_by_payment,
+      count(*) FILTER (WHERE status = 'escalated')::int AS escalated,
+      count(*) FILTER (WHERE closed_reason = 'no_contact_data')::int AS no_contact_data,
+      count(*) FILTER (WHERE status = 'scheduled' AND scheduled_for <= CURRENT_DATE)::int AS due_today
+      FROM dunning_event WHERE receivable_id IS NOT NULL
+  `;
+    const [p] = await tx `
+    SELECT COALESCE(sum(r.amount), 0) AS amount
+      FROM receivable r
+     WHERE r.status = 'paid'
+       AND EXISTS (SELECT 1 FROM dunning_event d
+                    WHERE d.receivable_id = r.id AND d.status = 'sent')
+  `;
+    return {
+        scheduled: m.scheduled,
+        sent: m.sent,
+        failed: m.failed,
+        canceled: m.canceled,
+        stoppedByPayment: m.stopped_by_payment,
+        escalated: m.escalated,
+        noContactData: m.no_contact_data,
+        dueToday: m.due_today,
+        amountPaidAfterCollection: Number(p.amount),
+    };
+}
+async function clientTimeline(tx, clientId, limit = 100) {
+    const rows = await tx `
+    SELECT created_at AS at, 'receivable_created' AS kind,
+           COALESCE(competence, 'avulso') AS detail, amount, id AS receivable_id
+      FROM receivable WHERE client_id = ${clientId} AND deleted_at IS NULL
+    UNION ALL
+    SELECT p.paid_at, 'payment', p.method, p.amount, p.receivable_id
+      FROM payment p JOIN receivable r ON r.id = p.receivable_id
+     WHERE r.client_id = ${clientId} AND p.status = 'confirmed'
+    UNION ALL
+    SELECT d.sent_at, 'collection_sent', d.step_key || ' · ' || d.channel, d.amount_at_send, d.receivable_id
+      FROM dunning_event d JOIN receivable r ON r.id = d.receivable_id
+     WHERE r.client_id = ${clientId} AND d.status = 'sent' AND d.sent_at IS NOT NULL
+    UNION ALL
+    SELECT d.closed_at, 'collection_canceled', d.step_key || ' · ' || COALESCE(d.closed_reason, '-'), NULL, d.receivable_id
+      FROM dunning_event d JOIN receivable r ON r.id = d.receivable_id
+     WHERE r.client_id = ${clientId} AND d.status = 'canceled' AND d.closed_at IS NOT NULL
+    UNION ALL
+    SELECT d.closed_at, 'collection_escalated', d.step_key, NULL, d.receivable_id
+      FROM dunning_event d JOIN receivable r ON r.id = d.receivable_id
+     WHERE r.client_id = ${clientId} AND d.status = 'escalated' AND d.closed_at IS NOT NULL
+    ORDER BY at DESC
+    LIMIT ${limit}
+  `;
+    return rows.map((r) => ({
+        at: r.at.toISOString(),
+        kind: r.kind,
+        detail: r.detail,
+        amount: r.amount === null ? null : Number(r.amount),
+        receivableId: r.receivable_id,
+    }));
+}
+//# sourceMappingURL=repository.js.map

package/dist/cjs/collection/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/collection/repository.ts"],"names":[],"mappings":";;AA2GA,kDAaC;AAED,wDAwBC;AAUD,wCAuBC;AAED,8BAKC;AAoBD,kCAoBC;AAGD,0CAKC;AAcD,4BAoBC;AAED,gCAcC;AAED,sCAUC;AAQD,oDAYC;AAqBD,8CA4CC;AAgBD,wCA2CC;AAxbD,0CAAuC;AAGvC,2CAAsF;AAqEtF,MAAM,GAAG,GAAG,CAAC,CAAc,EAAiB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAEzF,SAAS,SAAS,CAAC,CAAY;IAC7B,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,YAAY,EAAE,CAAC,CAAC,aAAa;QAC7B,QAAQ,EAAE,CAAC,CAAC,SAAS;QACrB,UAAU,EAAE,CAAC,CAAC,WAAW;QACzB,OAAO,EAAE,CAAC,CAAC,QAAQ;QACnB,OAAO,EAAE,CAAC,CAAC,OAA+B;QAC1C,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC;QAClC,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI;QACxC,QAAQ,EAAE,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,IAAI;QAC5C,YAAY,EAAE,CAAC,CAAC,aAAa;QAC7B,YAAY,EAAE,CAAC,CAAC,aAAa;QAC7B,YAAY,EAAE,CAAC,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC;QACzE,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,aAAa,GAAG;;;;;;sEAMgD,CAAC;AAEvE,+EAA+E;AAE/E,gFAAgF;AACzE,KAAK,UAAU,mBAAmB,CAAC,EAAM;IAC9C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAiE;;;;GAIrF,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,GAAG;QAAE,OAAO,0BAAc,CAAC;IAChC,MAAM,KAAK,GAAG,IAAA,4BAAgB,EAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1C,yEAAyE;IACzE,mEAAmE;IACnE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,GAAG,0BAAc,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;IACjF,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;AACnE,CAAC;AAEM,KAAK,UAAU,sBAAsB,CAC1C,EAAM,EACN,KAAyD;IAEzD,MAAM,KAAK,GAAG,IAAA,4BAAgB,EAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAkB;;GAE1C,CAAC;IACF,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,MAAM,EAAE,CAAA;;sBAEU,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC,IAAI,CAAC,KAAc,CAAC;wBAC5C,KAAK,CAAC,MAAM,IAAI,IAAI;oBACxB,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;KAC7B,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,CAAA;;gBAEI,IAAA,eAAM,GAAE;;gBAER,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,CAAC,KAAc,CAAC,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI;KAC1E,CAAC;IACJ,CAAC;IACD,OAAO,mBAAmB,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,+EAA+E;AAE/E;;;;;GAKG;AACI,KAAK,UAAU,cAAc,CAClC,EAAM,EACN,KAMC;IAED,MAAM,IAAI,GAAG,MAAM,EAAE,CAAkB;;;cAG3B,IAAA,eAAM,GAAE;;cAER,KAAK,CAAC,YAAY,KAAK,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,QAAQ;2BAC5D,KAAK,CAAC,YAAY;;;;GAI1C,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACnC,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,EAAM,EAAE,EAAU;IAChD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAa,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,iBAAiB,EAAE,EAAE,CAAC;IACnF,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC7D,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAoBM,KAAK,UAAU,WAAW,CAC/B,EAAM,EACN,SAAuB,EAAE;IAEzB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,MAAM,EAAE,CAAa;MAC9B,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC;;SAErB,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA,kBAAkB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA,EAAE;SAC1D,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA,yBAAyB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA,EAAE;SAC7E,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAA,qBAAqB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA,EAAE;SAEjE,MAAM,CAAC,OAAO;QACZ,CAAC,CAAC,EAAE,CAAA,qDAAqD,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAA,cAAc,EAAE;QAC9F,CAAC,CAAC,EAAE,CAAA,EACR;;aAEM,KAAK;GACf,CAAC;IACF,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC;AAED,kFAAkF;AAC3E,KAAK,UAAU,eAAe,CAAC,EAAM,EAAE,YAAoB;IAChE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAwB;+DACgB,YAAY;GACxE,CAAC;IACF,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,QAAQ,CAC5B,EAAM,EACN,EAAU,EACV,KAMC;IAED,MAAM,EAAE,CAAA;;;6BAGmB,KAAK,CAAC,YAAY,sBAAsB,KAAK,CAAC,MAAM;;qCAE5C,KAAK,CAAC,WAAW,IAAI,IAAI;wCACtB,KAAK,CAAC,cAAc,IAAI,IAAI;kBAClD,EAAE;GACjB,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,UAAU,CAC9B,EAAM,EACN,EAAU,EACV,KAA4C;IAE5C,MAAM,EAAE,CAAA;;sBAEY,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW;;0BAEpC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;yBAC1B,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAA,OAAO,CAAC,CAAC,CAAC,IAAI;6BAC9B,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI;kBACvD,EAAE;GACjB,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,aAAa,CACjC,EAAM,EACN,EAAU,EACV,SAAgC,WAAW;IAE3C,MAAM,EAAE,CAAA;;sEAE4D,MAAM;kBAC1D,EAAE;GACjB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,oBAAoB,CACxC,EAAM,EACN,YAAoB,EACpB,MAA6B;IAE7B,MAAM,IAAI,GAAG,MAAM,EAAE,CAAkB;;qEAE4B,MAAM;6BAC9C,YAAY;;GAEtC,CAAC;IACF,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC;AAqBM,KAAK,UAAU,iBAAiB,CAAC,EAAM;IAC5C,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAWnB;;;;;;;;;;;GAWA,CAAC;IAEF,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAsB;;;;;;GAMzC,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,CAAE,CAAC,SAAS;QACvB,IAAI,EAAE,CAAE,CAAC,IAAI;QACb,MAAM,EAAE,CAAE,CAAC,MAAM;QACjB,QAAQ,EAAE,CAAE,CAAC,QAAQ;QACrB,gBAAgB,EAAE,CAAE,CAAC,kBAAkB;QACvC,SAAS,EAAE,CAAE,CAAC,SAAS;QACvB,aAAa,EAAE,CAAE,CAAC,eAAe;QACjC,QAAQ,EAAE,CAAE,CAAC,SAAS;QACtB,yBAAyB,EAAE,MAAM,CAAC,CAAE,CAAC,MAAM,CAAC;KAC7C,CAAC;AACJ,CAAC;AAgBM,KAAK,UAAU,cAAc,CAClC,EAAM,EACN,QAAgB,EAChB,KAAK,GAAG,GAAG;IAEX,MAAM,IAAI,GAAG,MAAM,EAAE,CAQpB;;;0CAGuC,QAAQ;;;;2BAIvB,QAAQ;;;;2BAIR,QAAQ;;;;2BAIR,QAAQ;;;;2BAIR,QAAQ;;YAEvB,KAAK;GACd,CAAC;IACF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE;QACtB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QACnD,YAAY,EAAE,CAAC,CAAC,aAAa;KAC9B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/cjs/collection/subject.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Quem é o ASSUNTO de uma cobrança — e se existe um.
+ *
+ * ## O falso positivo que este módulo existe para matar
+ *
+ * O preflight de envio avulso respondia `eligible: true` medindo seis portas —
+ * identidade, credencial, destinatário, telefone, consentimento, template — e
+ * nenhuma delas pergunta **sobre o quê** a mensagem falaria. Um cliente sem
+ * recebível nenhum passava nas seis, e a rota de envio recusava logo depois por
+ * falta de valor e vencimento.
+ *
+ * Um preflight que aprova o que a execução recusa é pior que não ter preflight:
+ * ele desloca a descoberta do defeito para o momento do disparo, que é
+ * exatamente onde ninguém quer descobrir nada.
+ *
+ * ## Por que aqui, e não no handler
+ *
+ * "Este recebível está devido na etapa D+3 hoje?" é regra da RÉGUA. Ela já vive
+ * em `policy.ts` (`dueSteps`, `scheduledDateFor`) e em `engine.ts`
+ * (`isCollectible`), e é usada pelo ciclo automático. Reimplementar a mesma
+ * conta dentro de uma rota criaria a segunda derivação de sempre — as duas
+ * concordariam no dia da escrita e divergiriam na primeira mudança da régua,
+ * com o avulso mandando o que o ciclo não mandaria.
+ *
+ * Este módulo não decide política nova: ele **lê** a política vigente e responde
+ * quem ela alcança, sem escrever nada.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCollectibleSubject = isCollectibleSubject;
+exports.findEligibleSubjects = findEligibleSubjects;
+exports.resolveSubjectForStep = resolveSubjectForStep;
+const ar_repository_js_1 = require("../billing/ar-repository.js");
+const policy_js_1 = require("./policy.js");
+const repository_js_1 = require("./repository.js");
+/**
+ * Um recebível ainda merece cobrança?
+ *
+ * Cópia deliberada da regra de `engine.ts`, que era privada. Exportar de lá e
+ * importar aqui criaria ciclo (`engine` já importa deste módulo o suficiente);
+ * a duplicação é de UMA função pequena e está coberta pelo teste de
+ * equivalência em `collection-subject.test.ts`, que exercita as duas contra os
+ * mesmos casos.
+ */
+function isCollectibleSubject(r) {
+    if (r.status === 'paid' || r.status === 'canceled')
+        return false;
+    if (r.status === 'renegotiated' || r.status === 'written_off')
+        return false;
+    // Saldo zero sem status `paid` é quem já pagou e o status não foi reavaliado.
+    // Cobrar aqui é o pior erro operacional deste motor.
+    if (r.outstandingAmount <= 0)
+        return false;
+    if (!r.dueDate)
+        return false;
+    return true;
+}
+/**
+ * Os recebíveis do cliente que a etapa alcança HOJE.
+ *
+ * Vazio quer dizer "não há sobre o que cobrar nesta etapa", e é um desfecho
+ * legítimo — não um erro. Cabe a quem chama transformar isso em recusa.
+ *
+ * A ordem é a mesma da régua (vencimento mais antigo primeiro), para que o
+ * avulso e o ciclo escolham o mesmo quando houver mais de um.
+ */
+async function findEligibleSubjects(tx, q) {
+    const policy = q.policy ?? (await (0, repository_js_1.getCollectionPolicy)(tx));
+    /*
+     * Nenhuma checagem própria de política ou de etapa aqui.
+     *
+     * A primeira versão tinha duas — "a régua está ativa" e "a etapa existe e
+     * está ativa" — e o teste de mutação derrubou as duas: removê-las não quebrava
+     * caso nenhum, porque `dueSteps` já decide exatamente isso. Guard que nenhum
+     * teste consegue distinguir não é guard: é uma segunda codificação da mesma
+     * regra, esperando para divergir da primeira.
+     *
+     * O que sobra deste módulo é o que ele de fato acrescenta: recortar por
+     * cliente, aplicar `isCollectibleSubject` e perguntar à régua. `dueSteps`
+     * continua sendo a única autoridade sobre quando uma etapa vence.
+     */
+    const { items } = await (0, ar_repository_js_1.listReceivables)(tx, { clientId: q.clientId, limit: 200 });
+    const elegiveis = [];
+    for (const r of items) {
+        if (!isCollectibleSubject(r))
+            continue;
+        const handled = await (0, repository_js_1.handledStepKeys)(tx, r.id);
+        const due = (0, policy_js_1.dueSteps)(policy, r.dueDate, q.today, handled);
+        if (due.some((d) => d.step.key === q.stepKey))
+            elegiveis.push(r);
+    }
+    return elegiveis;
+}
+/**
+ * O assunto que o envio avulso usaria, ou `null`.
+ *
+ * Quando há mais de um, o mais antigo — mesma preferência da régua. Escolher o
+ * mais recente faria a dívida velha envelhecer sem cobrança.
+ */
+async function resolveSubjectForStep(tx, q) {
+    const todos = await findEligibleSubjects(tx, q);
+    return todos[0] ?? null;
+}
+//# sourceMappingURL=subject.js.map

package/dist/cjs/collection/subject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject.js","sourceRoot":"","sources":["../../../src/collection/subject.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;AAgBH,oDAQC;AAoBD,oDA8BC;AAQD,sDAMC;AArFD,kEAA0F;AAC1F,2CAA8D;AAC9D,mDAAuE;AAEvE;;;;;;;;GAQG;AACH,SAAgB,oBAAoB,CAAC,CAAwB;IAC3D,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACjE,IAAI,CAAC,CAAC,MAAM,KAAK,cAAc,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa;QAAE,OAAO,KAAK,CAAC;IAC5E,8EAA8E;IAC9E,qDAAqD;IACrD,IAAI,CAAC,CAAC,iBAAiB,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,CAAC,CAAC,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC;AAWD;;;;;;;;GAQG;AACI,KAAK,UAAU,oBAAoB,CACxC,EAAM,EACN,CAAuB;IAEvB,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,IAAA,mCAAmB,EAAC,EAAE,CAAC,CAAC,CAAC;IAE3D;;;;;;;;;;;;OAYG;IAEH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAA,kCAAe,EAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAElF,MAAM,SAAS,GAA4B,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAAE,SAAS;QACvC,MAAM,OAAO,GAAG,MAAM,IAAA,+BAAe,EAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,IAAA,oBAAQ,EAAC,MAAM,EAAE,CAAC,CAAC,OAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3D,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,qBAAqB,CACzC,EAAM,EACN,CAAuB;IAEvB,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC1B,CAAC"}

package/dist/cjs/collection/template-catalog.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * Catálogo de templates da COBRANÇA — do produto, não do motor.
+ *
+ * O motor sabe resolver template (escopo, versão, aprovação); ele não conhece
+ * nenhum. Os textos e os nomes registrados no provider vivem aqui, ao lado da
+ * régua que os usa.
+ *
+ * O corpo dos e-mails continua vindo de `copy.ts`/`email-layout.ts`: este
+ * catálogo declara QUAL template vale para cada etapa e canal, e as variáveis
+ * que ele consome. Duplicar o texto aqui criaria duas fontes para a mesma
+ * mensagem, e a segunda ficaria para trás na primeira correção.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCollectionTemplateStore = createCollectionTemplateStore;
+const communication_bridge_js_1 = require("./communication-bridge.js");
+const LOCALE = 'pt-BR';
+/**
+ * Variáveis da cobrança, na ordem em que os templates de WhatsApp as declaram.
+ *
+ * A ordem é contrato com o template aprovado no provider: `{{1}}` é o nome,
+ * `{{2}}` o valor, `{{3}}` o vencimento. Trocar a ordem aqui sem re-aprovar o
+ * template lá manda o valor no lugar do nome — e a Meta aceita, porque para ela
+ * são três strings.
+ */
+const COLLECTION_VARS = ['clientName', 'amount', 'dueDate'];
+/**
+ * Sufixo do nome REGISTRADO NO PROVIDER.
+ *
+ * Muda **somente** quando um template novo é submetido e aprovado do lado da
+ * Meta. Mexer aqui sem submeter faz o despacho pedir um nome que não existe — e
+ * a Meta responde `132001`, que fala de "translation" e manda quem investiga
+ * procurar no lugar errado.
+ */
+const PROVIDER_TEMPLATE_SUFFIX = 'v1';
+/**
+ * Revisão INTERNA do catálogo de WhatsApp. **Nunca chega ao provider.**
+ *
+ * Entra na chave de idempotência (`buildIdempotencyKey` recebe
+ * `templateVersion`), e é o único jeito legítimo de dizer "esta é outra
+ * tentativa lógica" sem tocar no template aprovado.
+ *
+ * ## Por que os dois existem separados
+ *
+ * Eram dois literais `'v1'` — um em `version`, outro dentro da interpolação de
+ * `providerTemplateName` —, independentes de fato e idênticos na aparência. A
+ * primeira pessoa que precisasse de uma chave nova bumparia o que estivesse
+ * mais à mão, e havia 50% de chance de o despacho passar a pedir
+ * `billing_dunning_dplus3_v2` à Meta, que não tem esse template.
+ *
+ * `v2` aqui porque a revisão `v1` foi consumida: em 2026-09-01 a primeira
+ * tentativa real assentou a chave como `failed_permanent`, e o motor recusa
+ * repetição sobre chave assentada — corretamente. O template aprovado continua
+ * sendo `billing_dunning_dplus3_v1`.
+ *
+ * E-mail e SMS **não** bumpam: os dois têm despacho real em produção, e mudar a
+ * versão deles reabriria chaves já assentadas de 89 avisos que já saíram.
+ */
+const WHATSAPP_CATALOG_REVISION = 'v2';
+/**
+ * E-mail: sempre disponível, porque o corpo é montado pelo produto.
+ *
+ * `approved` aqui não significa "aprovado por um provider" — e-mail não tem
+ * registro prévio. Significa "utilizável", que é o que o motor precisa saber.
+ */
+function emailTemplate(eventType) {
+    return {
+        tenantId: null,
+        product: communication_bridge_js_1.SC_PRODUCT,
+        brand: null,
+        channel: 'email',
+        eventType,
+        locale: LOCALE,
+        version: 'v1',
+        status: 'approved',
+        variables: [...COLLECTION_VARS],
+    };
+}
+/**
+ * WhatsApp: só existe se o escritório tiver registrado o template no provider.
+ *
+ * O nome segue o evento (`billing.dunning.dplus3` → `billing_dunning_dplus3_v1`)
+ * porque é a única convenção que não exige uma segunda tabela de-para que
+ * alguém precisaria manter sincronizada com o painel da Meta.
+ *
+ * **Não é declarado aprovado por padrão.** Um template que este código afirma
+ * existir e que ninguém registrou vira recusa do provider a cada etapa da régua
+ * — e a recusa chega como falha de entrega, sugerindo problema no cliente.
+ */
+function whatsappTemplate(eventType, approved) {
+    return {
+        tenantId: null,
+        product: communication_bridge_js_1.SC_PRODUCT,
+        brand: null,
+        channel: 'whatsapp',
+        eventType,
+        locale: LOCALE,
+        // Revisão interna — some antes da fronteira do provider.
+        version: WHATSAPP_CATALOG_REVISION,
+        status: approved ? 'approved' : 'pending_approval',
+        // Nome no provider — o sufixo é o do TEMPLATE APROVADO, não o da revisão.
+        providerTemplateName: `${eventType.replace(/\./g, '_')}_${PROVIDER_TEMPLATE_SUFFIX}`,
+        variables: [...COLLECTION_VARS],
+    };
+}
+function smsTemplate(eventType, approved) {
+    return {
+        tenantId: null,
+        product: communication_bridge_js_1.SC_PRODUCT,
+        brand: null,
+        channel: 'sms',
+        eventType,
+        locale: LOCALE,
+        version: 'v1',
+        status: approved ? 'approved' : 'pending_approval',
+        variables: [...COLLECTION_VARS],
+        // Curto de propósito: cada segmento é cobrado, e o link é o que faz o
+        // cliente agir. Sem link, a mensagem só informa.
+        body: '{{clientName}}, consta {{amount}} com vencimento {{dueDate}}.',
+    };
+}
+/**
+ * Quais eventos o escritório tem registrados em cada canal.
+ *
+ * Vem de `tenant.settings.channels.<canal>.approvedEvents`. Ausente = nenhum, e
+ * o e-mail segue funcionando: ligar um canal novo nunca pode desligar o que já
+ * funcionava.
+ */
+// `tenant` não tem RLS — é a tabela raiz, define a fronteira em vez de ser
+// protegida por ela. Toda leitura dela exige a amarra explícita na GUC da
+// sessão; sem isso, o `tenantId` do parâmetro é a única coisa que separa um
+// escritório do outro, e um parâmetro não é uma fronteira.
+async function approvedEvents(tx, tenantId, channel) {
+    const rows = await tx `
+    SELECT settings FROM tenant
+     WHERE id = ${tenantId}
+       AND id = NULLIF(current_setting('app.current_tenant', true), '')::uuid
+     LIMIT 1
+  `;
+    const channels = (rows[0]?.settings?.channels ?? {});
+    const list = channels[channel]?.approvedEvents;
+    return new Set(Array.isArray(list) ? list.filter((v) => typeof v === 'string') : []);
+}
+function createCollectionTemplateStore(tx) {
+    return {
+        async candidates(ctx, channel, eventType, locale) {
+            if (ctx.product !== communication_bridge_js_1.SC_PRODUCT || locale !== LOCALE)
+                return [];
+            if (channel === 'email')
+                return [emailTemplate(eventType)];
+            if (channel === 'whatsapp') {
+                const approved = await approvedEvents(tx, ctx.tenantId, 'whatsapp');
+                return [whatsappTemplate(eventType, approved.has(eventType))];
+            }
+            if (channel === 'sms') {
+                const approved = await approvedEvents(tx, ctx.tenantId, 'sms');
+                return [smsTemplate(eventType, approved.has(eventType))];
+            }
+            // `notification` é evento interno e não passa pelo motor: a régua o
+            // resolve antes, escalando para a fila humana sem mensagem ao cliente.
+            return [];
+        },
+    };
+}
+//# sourceMappingURL=template-catalog.js.map

package/dist/cjs/collection/template-catalog.js.map

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

package/dist/cjs/collection/template.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TEMPLATES = exports.TEMPLATE_VARIABLES = void 0;
+exports.resolveTemplate = resolveTemplate;
+exports.renderTemplate = renderTemplate;
+exports.TEMPLATE_VARIABLES = [
+    'clientName',
+    'officeName',
+    'dueDate',
+    'outstandingAmount',
+    'reference',
+];
+/**
+ * Textos padrão por tom.
+ *
+ * Nenhum deles ameaça, cita medida judicial, negativação ou consequência legal.
+ * Cobrança automatizada que produz esse tipo de texto sem revisão humana é risco
+ * jurídico e de relacionamento — a etapa mais dura da régua padrão escala para
+ * uma pessoa em vez de escrever por conta própria.
+ */
+const DEFAULT_TEMPLATES = {
+    'collection.reminder': {
+        subject: 'Lembrete: vencimento em {{dueDate}}',
+        body: 'Olá, {{clientName}}.\n\n' +
+            'Passando para lembrar que o valor de {{outstandingAmount}} vence em {{dueDate}}.\n' +
+            'Referência: {{reference}}.\n\n' +
+            'Se já tiver pago, desconsidere esta mensagem.\n\n{{officeName}}',
+    },
+    'collection.due': {
+        subject: 'Vence hoje: {{outstandingAmount}}',
+        body: 'Olá, {{clientName}}.\n\n' +
+            'O valor de {{outstandingAmount}} vence hoje ({{dueDate}}).\n' +
+            'Referência: {{reference}}.\n\n' +
+            'Se já tiver pago, desconsidere esta mensagem.\n\n{{officeName}}',
+    },
+    'collection.overdue_soft': {
+        subject: 'Pendência em aberto — {{reference}}',
+        body: 'Olá, {{clientName}}.\n\n' +
+            'Consta em aberto o valor de {{outstandingAmount}}, com vencimento em {{dueDate}}.\n' +
+            'Se o pagamento já foi feito, por favor nos avise para darmos baixa.\n\n' +
+            'Qualquer dúvida, estamos à disposição.\n\n{{officeName}}',
+    },
+    'collection.overdue': {
+        subject: 'Pendência em aberto desde {{dueDate}}',
+        body: 'Olá, {{clientName}}.\n\n' +
+            'O valor de {{outstandingAmount}}, vencido em {{dueDate}}, segue em aberto.\n' +
+            'Referência: {{reference}}.\n\n' +
+            'Pedimos que entre em contato para regularizarmos ou combinarmos a melhor forma.\n\n' +
+            '{{officeName}}',
+    },
+    // Interno: nunca vai ao cliente. Ver a nota em `policy.ts`.
+    'collection.escalate': {
+        subject: 'Cobrança escalada para atendimento humano — {{clientName}}',
+        body: 'A régua automática chegou ao fim para {{clientName}} ({{reference}}), com ' +
+            '{{outstandingAmount}} em aberto desde {{dueDate}}. A partir daqui a condução é humana.',
+    },
+};
+exports.DEFAULT_TEMPLATES = DEFAULT_TEMPLATES;
+const TONE_FALLBACK = {
+    reminder: 'collection.reminder',
+    due_notice: 'collection.due',
+    friendly_collection: 'collection.overdue_soft',
+    overdue_collection: 'collection.overdue',
+    human_escalation: 'collection.escalate',
+};
+/** Resolve o template; cai no padrão do tom quando o tenant não tem o seu. */
+function resolveTemplate(templateKey, tone, overrides) {
+    return (overrides?.[templateKey] ??
+        DEFAULT_TEMPLATES[templateKey] ??
+        DEFAULT_TEMPLATES[TONE_FALLBACK[tone]]);
+}
+/** Substitui `{{var}}` pelas variáveis da allowlist. O resto fica literal. */
+function renderTemplate(text, vars) {
+    return text.replace(/\{\{\s*([a-zA-Z]+)\s*\}\}/g, (whole, name) => exports.TEMPLATE_VARIABLES.includes(name)
+        ? String(vars[name] ?? '')
+        : whole);
+}
+//# sourceMappingURL=template.js.map

package/dist/cjs/collection/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/collection/template.ts"],"names":[],"mappings":";;;AA6FA,0CAUC;AAGD,wCAMC;AA5FY,QAAA,kBAAkB,GAAoC;IACjE,YAAY;IACZ,YAAY;IACZ,SAAS;IACT,mBAAmB;IACnB,WAAW;CACZ,CAAC;AAOF;;;;;;;GAOG;AACH,MAAM,iBAAiB,GAAuC;IAC5D,qBAAqB,EAAE;QACrB,OAAO,EAAE,qCAAqC;QAC9C,IAAI,EACF,0BAA0B;YAC1B,oFAAoF;YACpF,gCAAgC;YAChC,iEAAiE;KACpE;IACD,gBAAgB,EAAE;QAChB,OAAO,EAAE,mCAAmC;QAC5C,IAAI,EACF,0BAA0B;YAC1B,8DAA8D;YAC9D,gCAAgC;YAChC,iEAAiE;KACpE;IACD,yBAAyB,EAAE;QACzB,OAAO,EAAE,qCAAqC;QAC9C,IAAI,EACF,0BAA0B;YAC1B,qFAAqF;YACrF,yEAAyE;YACzE,0DAA0D;KAC7D;IACD,oBAAoB,EAAE;QACpB,OAAO,EAAE,uCAAuC;QAChD,IAAI,EACF,0BAA0B;YAC1B,8EAA8E;YAC9E,gCAAgC;YAChC,qFAAqF;YACrF,gBAAgB;KACnB;IACD,4DAA4D;IAC5D,qBAAqB,EAAE;QACrB,OAAO,EAAE,4DAA4D;QACrE,IAAI,EACF,4EAA4E;YAC5E,wFAAwF;KAC3F;CACF,CAAC;AAgCO,8CAAiB;AA9B1B,MAAM,aAAa,GAA6B;IAC9C,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE,gBAAgB;IAC5B,mBAAmB,EAAE,yBAAyB;IAC9C,kBAAkB,EAAE,oBAAoB;IACxC,gBAAgB,EAAE,qBAAqB;CACxC,CAAC;AAEF,8EAA8E;AAC9E,SAAgB,eAAe,CAC7B,WAAmB,EACnB,IAAc,EACd,SAA8C;IAE9C,OAAO,CACL,SAAS,EAAE,CAAC,WAAW,CAAC;QACxB,iBAAiB,CAAC,WAAW,CAAC;QAC9B,iBAAiB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAE,CACxC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,SAAgB,cAAc,CAAC,IAAY,EAAE,IAAkB;IAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE,CACvE,0BAAwC,CAAC,QAAQ,CAAC,IAAI,CAAC;QACtD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAA0B,CAAC,IAAI,EAAE,CAAC;QAChD,CAAC,CAAC,KAAK,CACV,CAAC;AACJ,CAAC"}