@hed-hog/core 0.0.399 → 0.0.400

package/dist/utils/date-range-query.dto.js

@@ -0,0 +1,63 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DateRangeQueryDTO = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * `?from=yyyy-MM-dd&to=yyyy-MM-dd` — o par padrão de recorte por período de
+ * toda listagem nova. Endpoint que já tem nome próprio (`dateFrom`/`dateTo` da
+ * fila, `createdAtFrom`/`createdAtTo` do mail-sent, `date_from`/`date_to` do
+ * sac) mantém o nome dele: só o que nasce daqui em diante usa `from`/`to`.
+ *
+ * Composto, e não herdado de `PaginationDTO`, porque quase todo adotante é o
+ * **segundo** argumento `@Query()` do controller, ao lado do `@Pagination()` —
+ * que descarta tudo que não é paginação. Carregar `page`/`pageSize` junto
+ * duplicaria campo que o DTO de filtro não é dono. Onde o DTO de filtro já
+ * estende `PaginationDTO`, o jeito de juntar os dois é o `IntersectionType`:
+ *
+ * ```ts
+ * export class ListContractsDto extends IntersectionType(
+ *   PaginationDTO,
+ *   DateRangeQueryDTO,
+ * ) {}
+ * ```
+ *
+ * Quem traduz este par para o `where` do banco é o `resolveDateRange` /
+ * `dateRangeWhere` (`./date-range`).
+ */
+/**
+ * O admin manda `?from=` quando o usuário **limpa** o campo. O `@IsOptional()`
+ * só pula `null`/`undefined`, então sem isto o campo limpo viraria 400 — uma
+ * regressão de tela causada por um parâmetro que nem deveria existir. O
+ * `@Transform` roda no `plainToInstance` do `ValidationPipe`, antes do
+ * `validate`, então a string vazia nunca chega ao validador.
+ */
+const blankToUndefined = ({ value }) => {
+    const raw = typeof value === 'string' ? value.trim() : value;
+    return raw === '' || raw === null ? undefined : raw;
+};
+class DateRangeQueryDTO {
+}
+exports.DateRangeQueryDTO = DateRangeQueryDTO;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(blankToUndefined),
+    (0, class_validator_1.IsDateString)({}, { message: 'from must be a date in the yyyy-MM-dd format' }),
+    __metadata("design:type", String)
+], DateRangeQueryDTO.prototype, "from", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(blankToUndefined),
+    (0, class_validator_1.IsDateString)({}, { message: 'to must be a date in the yyyy-MM-dd format' }),
+    __metadata("design:type", String)
+], DateRangeQueryDTO.prototype, "to", void 0);
+//# sourceMappingURL=date-range-query.dto.js.map

package/dist/utils/date-range-query.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-range-query.dto.js","sourceRoot":"","sources":["../../src/utils/date-range-query.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAA8C;AAC9C,qDAA2D;AAE3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;GAMG;AACH,MAAM,gBAAgB,GAAG,CAAC,EAAE,KAAK,EAAsB,EAAE,EAAE;IACzD,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAE7D,OAAO,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;AACtD,CAAC,CAAC;AAEF,MAAa,iBAAiB;CAgB7B;AAhBD,8CAgBC;AAXC;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,6BAAS,EAAC,gBAAgB,CAAC;IAC3B,IAAA,8BAAY,EAAC,EAAE,EAAE,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;;+CAChE;AAUd;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,6BAAS,EAAC,gBAAgB,CAAC;IAC3B,IAAA,8BAAY,EAAC,EAAE,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;;6CAChE"}

package/dist/utils/date-range.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Tradução única de `?from=yyyy-MM-dd&to=yyyy-MM-dd` para limites comparáveis
+ * no banco.
+ *
+ * A janela é **meio-aberta** — `[from 00:00, to+1d 00:00)` — e nunca inclusiva.
+ * `lte new Date('2026-08-31')` compara contra o *instante* `T00:00:00Z` e
+ * derruba o dia 31 inteiro; `lte 23:59:59.999` perde o último milissegundo e
+ * mente sobre o modelo de dados. A forma meio-aberta é a única que vale igual
+ * para coluna `@db.Date` e para coluna `@db.Timestamptz(6)`, sem flag nenhum.
+ *
+ * Diferenças de propósito para o `resolveRangeWindow` do operations
+ * (`libraries/operations/src/services/shared/operations-activity-window.helper.ts`),
+ * que serve relatório e não listagem:
+ *
+ * - sem `from` e sem `to` devolve `null` (= sem recorte), e não o dia de hoje:
+ *   listagem sem filtro tem de devolver tudo;
+ * - **não limita o fim em agora**: reunião de amanhã, contrato que vence em
+ *   2027 e assinatura com período à frente são justamente o que essas telas
+ *   procuram;
+ * - aceita janela aberta de um lado só.
+ *
+ * Os dois hão de convergir, mas depois: aquele alimenta o e-mail do relatório
+ * diário e depende do clamp.
+ */
+export interface DateRangeBounds {
+    gte?: Date;
+    lt?: Date;
+}
+export interface DateRange {
+    /** Início inclusivo, no fuso pedido. Ausente quando só veio `to`. */
+    gte?: Date;
+    /** Fim EXCLUSIVO (`to` + 1 dia), no fuso pedido. Ausente quando só veio `from`. */
+    lt?: Date;
+    /**
+     * As mesmas bordas em UTC puro — o que uma coluna `@db.Date` entende.
+     *
+     * O Prisma manda o parâmetro como `DATE` e o trunca pela leitura **UTC** do
+     * `Date`. Uma borda deslocada para fuso a leste derruba um dia inteiro sem
+     * erro nenhum: meia-noite de 01/09 em `Asia/Tokyo` é `2026-08-31T15:00Z`,
+     * que trunca para `2026-08-31`. Coluna de data pura não tem fuso, então
+     * converter fuso nela é sempre errado.
+     */
+    dateOnly: DateRangeBounds;
+    /** `yyyy-MM-dd` normalizado, já desinvertido. */
+    fromIso?: string;
+    /** `to + 1 dia`, para o `< $n::date` do SQL cru. */
+    toExclusiveIso?: string;
+}
+export interface DateRangeOptions {
+    /**
+     * Fuso IANA das bordas civis; o padrão é UTC, que é o fuso dos pods da API.
+     * Só afeta coluna com hora — veja `dateOnly`.
+     */
+    timezone?: string;
+}
+/**
+ * Soma dias de **calendário**. Somar 86400000 ms a um instante zonado erra o
+ * dia em toda virada de horário de verão.
+ */
+export declare function addIsoDays(isoDate: string, days: number): string;
+/**
+ * Resolve o par `from`/`to` da query.
+ *
+ * Devolve `null` quando nenhuma das pontas é data utilizável — o que cobre de
+ * uma vez "o cliente não filtrou", "o cliente limpou o campo e mandou
+ * `?from=`" e "o cliente mandou `31/08/2026`". Filtro ilegível vira "sem
+ * filtro", não 500: o `ValidationPipe` barra o que dá para barrar na borda, e
+ * aqui dentro a listagem não pode cair.
+ *
+ * Intervalo invertido é desinvertido: arrastar o calendário de trás para
+ * frente não deve devolver lista vazia.
+ */
+export declare function resolveDateRange(from?: string | null, to?: string | null, options?: DateRangeOptions): DateRange | null;
+export interface DateRangeWhereOptions extends DateRangeOptions {
+    /**
+     * `true` para coluna `@db.Date`. Usa as bordas UTC puras, que são as únicas
+     * que o `DATE` do Postgres trunca para o dia certo.
+     */
+    dateOnly?: boolean;
+}
+/**
+ * Fragmento pronto para espalhar dentro de um `where` do Prisma:
+ *
+ * ```ts
+ * const where = {
+ *   deleted_at: null,
+ *   ...dateRangeWhere('created_at', filters?.from, filters?.to),
+ * };
+ * ```
+ *
+ * Devolve `{}` quando não há recorte, então espalhar é sempre seguro e não
+ * existe o caminho "montei um `created_at: {}` vazio". As chaves ausentes são
+ * omitidas de verdade, não postas como `undefined`.
+ */
+export declare function dateRangeWhere(field: string, from?: string | null, to?: string | null, options?: DateRangeWhereOptions): Record<string, DateRangeBounds>;
+//# sourceMappingURL=date-range.d.ts.map

package/dist/utils/date-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-range.d.ts","sourceRoot":"","sources":["../../src/utils/date-range.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,EAAE,CAAC,EAAE,IAAI,CAAC;CACX;AAED,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,mFAAmF;IACnF,EAAE,CAAC,EAAE,IAAI,CAAC;IACV;;;;;;;;OAQG;IACH,QAAQ,EAAE,eAAe,CAAC;IAC1B,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAyCD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhE;AAuDD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EACpB,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,GAAE,gBAAqB,GAC7B,SAAS,GAAG,IAAI,CAwBlB;AAED,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EACpB,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAajC"}

package/dist/utils/date-range.js

@@ -0,0 +1,172 @@
+"use strict";
+/**
+ * Tradução única de `?from=yyyy-MM-dd&to=yyyy-MM-dd` para limites comparáveis
+ * no banco.
+ *
+ * A janela é **meio-aberta** — `[from 00:00, to+1d 00:00)` — e nunca inclusiva.
+ * `lte new Date('2026-08-31')` compara contra o *instante* `T00:00:00Z` e
+ * derruba o dia 31 inteiro; `lte 23:59:59.999` perde o último milissegundo e
+ * mente sobre o modelo de dados. A forma meio-aberta é a única que vale igual
+ * para coluna `@db.Date` e para coluna `@db.Timestamptz(6)`, sem flag nenhum.
+ *
+ * Diferenças de propósito para o `resolveRangeWindow` do operations
+ * (`libraries/operations/src/services/shared/operations-activity-window.helper.ts`),
+ * que serve relatório e não listagem:
+ *
+ * - sem `from` e sem `to` devolve `null` (= sem recorte), e não o dia de hoje:
+ *   listagem sem filtro tem de devolver tudo;
+ * - **não limita o fim em agora**: reunião de amanhã, contrato que vence em
+ *   2027 e assinatura com período à frente são justamente o que essas telas
+ *   procuram;
+ * - aceita janela aberta de um lado só.
+ *
+ * Os dois hão de convergir, mas depois: aquele alimenta o e-mail do relatório
+ * diário e depende do clamp.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addIsoDays = addIsoDays;
+exports.resolveDateRange = resolveDateRange;
+exports.dateRangeWhere = dateRangeWhere;
+/** Tolera ISO completo: só o prefixo `yyyy-MM-dd` interessa. */
+const ISO_DATE_PREFIX = /^(\d{4})-(\d{2})-(\d{2})/;
+function normalizeTimezone(timezone) {
+    const candidate = String(timezone !== null && timezone !== void 0 ? timezone : '').trim();
+    if (!candidate)
+        return 'UTC';
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone: candidate });
+        return candidate;
+    }
+    catch (_a) {
+        // Fuso inventado não pode derrubar uma listagem: cai no fuso dos pods.
+        return 'UTC';
+    }
+}
+function toIsoDate(value) {
+    const match = ISO_DATE_PREFIX.exec(String(value !== null && value !== void 0 ? value : '').trim());
+    if (!match)
+        return null;
+    const [, yearText, monthText, dayText] = match;
+    const year = Number(yearText);
+    const month = Number(monthText);
+    const day = Number(dayText);
+    // `2026-02-31` casa com o regex e o `Date.UTC` o aceita virando 03/03.
+    // Só a volta denuncia.
+    const probe = new Date(Date.UTC(year, month - 1, day));
+    if (probe.getUTCFullYear() !== year ||
+        probe.getUTCMonth() !== month - 1 ||
+        probe.getUTCDate() !== day) {
+        return null;
+    }
+    return `${yearText}-${monthText}-${dayText}`;
+}
+/**
+ * Soma dias de **calendário**. Somar 86400000 ms a um instante zonado erra o
+ * dia em toda virada de horário de verão.
+ */
+function addIsoDays(isoDate, days) {
+    const [year, month, day] = isoDate.split('-').map(Number);
+    return new Date(Date.UTC(year, month - 1, day + days))
+        .toISOString()
+        .slice(0, 10);
+}
+function utcMidnight(isoDate) {
+    return new Date(`${isoDate}T00:00:00.000Z`);
+}
+/**
+ * Deslocamento do fuso, em ms, no instante informado. Formatar a data no fuso
+ * e reinterpretar as partes como UTC devolve o offset vigente — inclusive em
+ * fuso com horário de verão.
+ */
+function timezoneOffsetMs(at, timezone) {
+    const parts = new Intl.DateTimeFormat('en-US', {
+        timeZone: timezone,
+        hour12: false,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+    }).formatToParts(at);
+    const part = (type) => { var _a, _b; return Number((_b = (_a = parts.find((item) => item.type === type)) === null || _a === void 0 ? void 0 : _a.value) !== null && _b !== void 0 ? _b : 0); };
+    const asUtc = Date.UTC(part('year'), part('month') - 1, part('day'), 
+    // Algumas engines devolvem "24" para a meia-noite em hour12:false.
+    part('hour') % 24, part('minute'), part('second'));
+    return asUtc - at.getTime();
+}
+/** Meia-noite civil de `isoDate` naquele fuso, como instante UTC. */
+function zonedMidnight(isoDate, timezone) {
+    if (timezone === 'UTC')
+        return utcMidnight(isoDate);
+    const naive = Date.parse(`${isoDate}T00:00:00.000Z`);
+    // Duas passadas: a primeira usa o offset do palpite, a segunda o do instante
+    // já corrigido — é o que resolve a virada de horário de verão.
+    let utc = naive;
+    for (let pass = 0; pass < 2; pass += 1) {
+        utc = naive - timezoneOffsetMs(new Date(utc), timezone);
+    }
+    return new Date(utc);
+}
+/**
+ * Resolve o par `from`/`to` da query.
+ *
+ * Devolve `null` quando nenhuma das pontas é data utilizável — o que cobre de
+ * uma vez "o cliente não filtrou", "o cliente limpou o campo e mandou
+ * `?from=`" e "o cliente mandou `31/08/2026`". Filtro ilegível vira "sem
+ * filtro", não 500: o `ValidationPipe` barra o que dá para barrar na borda, e
+ * aqui dentro a listagem não pode cair.
+ *
+ * Intervalo invertido é desinvertido: arrastar o calendário de trás para
+ * frente não deve devolver lista vazia.
+ */
+function resolveDateRange(from, to, options = {}) {
+    const timezone = normalizeTimezone(options.timezone);
+    let fromIso = toIsoDate(from);
+    let toIso = toIsoDate(to);
+    if (!fromIso && !toIso)
+        return null;
+    if (fromIso && toIso && toIso < fromIso) {
+        [fromIso, toIso] = [toIso, fromIso];
+    }
+    const toExclusiveIso = toIso ? addIsoDays(toIso, 1) : undefined;
+    return {
+        gte: fromIso ? zonedMidnight(fromIso, timezone) : undefined,
+        lt: toExclusiveIso ? zonedMidnight(toExclusiveIso, timezone) : undefined,
+        dateOnly: {
+            gte: fromIso ? utcMidnight(fromIso) : undefined,
+            lt: toExclusiveIso ? utcMidnight(toExclusiveIso) : undefined,
+        },
+        fromIso: fromIso !== null && fromIso !== void 0 ? fromIso : undefined,
+        toExclusiveIso,
+    };
+}
+/**
+ * Fragmento pronto para espalhar dentro de um `where` do Prisma:
+ *
+ * ```ts
+ * const where = {
+ *   deleted_at: null,
+ *   ...dateRangeWhere('created_at', filters?.from, filters?.to),
+ * };
+ * ```
+ *
+ * Devolve `{}` quando não há recorte, então espalhar é sempre seguro e não
+ * existe o caminho "montei um `created_at: {}` vazio". As chaves ausentes são
+ * omitidas de verdade, não postas como `undefined`.
+ */
+function dateRangeWhere(field, from, to, options = {}) {
+    const range = resolveDateRange(from, to, options);
+    if (!range)
+        return {};
+    const source = options.dateOnly
+        ? range.dateOnly
+        : { gte: range.gte, lt: range.lt };
+    const bounds = {};
+    if (source.gte)
+        bounds.gte = source.gte;
+    if (source.lt)
+        bounds.lt = source.lt;
+    return Object.keys(bounds).length > 0 ? { [field]: bounds } : {};
+}
+//# sourceMappingURL=date-range.js.map

package/dist/utils/date-range.js.map

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

package/dist/webhook-integration/webhook-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webhook-utils.d.ts","sourceRoot":"","sources":["../../src/webhook-integration/webhook-utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,gBAAgB,wDAE/B;AAED,wBAAgB,gBAAgB,WAE/B;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,UAEtC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,OAuB3E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,OAoB9C;AAqBD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,SAAK,GACX,OAAO,CAiCT;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,OAejD"}
+{"version":3,"file":"webhook-utils.d.ts","sourceRoot":"","sources":["../../src/webhook-integration/webhook-utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,gBAAgB,wDAE/B;AAED,wBAAgB,gBAAgB,WAE/B;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,UAEtC;AA4BD,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,OAuB3E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,OAoB9C;AAqBD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,SAAK,GACX,OAAO,CAiCT;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,OAejD"}

package/dist/webhook-integration/webhook-utils.js

@@ -51,6 +51,30 @@ function createPlainToken() {
 function hashToken(token) {
     return (0, crypto_1.createHash)('sha256').update(token).digest('hex');
 }
+/**
+ * Handlebars puro não compara valores: `{{#if}}` só testa se algo é vazio. Sem
+ * isto um template não consegue reagir ao conteúdo do payload — o caso que
+ * motivou os helpers foi o webhook do Alertmanager, onde `status` chega como
+ * "firing" ou "resolved" e a mensagem precisa ser diferente em cada caso (mandar
+ * o texto de alerta quando o problema acabou é pior do que não mandar nada).
+ *
+ * Registrados uma vez, no import do módulo: `Handlebars.registerHelper` é global
+ * e chamá-lo a cada render só repetiria trabalho.
+ */
+const HELPERS = {
+    // `{{#if (eq status "firing")}}`. A comparação é frouxa de propósito: o payload
+    // vem de JSON externo, onde 200 e "200" são a mesma coisa para quem escreve o
+    // template.
+    eq: (a, b) => String(a) === String(b),
+    ne: (a, b) => String(a) !== String(b),
+    gt: (a, b) => Number(a) > Number(b),
+    lt: (a, b) => Number(a) < Number(b),
+    upper: (value) => String(value !== null && value !== void 0 ? value : '').toUpperCase(),
+    lower: (value) => String(value !== null && value !== void 0 ? value : '').toLowerCase(),
+};
+for (const [name, fn] of Object.entries(HELPERS)) {
+    Handlebars.registerHelper(name, fn);
+}
 function renderTemplate(source, context) {
     if (source === undefined || source === null) {
         return source;

package/dist/webhook-integration/webhook-utils.js.map

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

package/dist/whatsapp-sender/whatsapp-recipients.d.ts

@@ -0,0 +1,49 @@
+import { WhatsappTargetType } from './whatsapp-sender.service';
+/**
+ * Destino de um aviso interno por WhatsApp: celular ou grupo.
+ *
+ * Mora no core, e nao na library que avisa, porque ja sao duas a ler a mesma
+ * lista digitada a mao — o SAC, para o grupo do atendimento, e o commerce, para
+ * os grupos de venda. Reconhecedor de JID de grupo duplicado e como as duas
+ * divergem: uma passa a aceitar o id sem sufixo e a outra nao, e o destino some
+ * em silencio no modulo que ficou para tras.
+ */
+export type WhatsappRecipient = {
+    to: string;
+    targetType: WhatsappTargetType;
+};
+/**
+ * Id de grupo do WhatsApp (`...@g.us`), ou null quando o item nao e grupo.
+ *
+ * Grupo tem duas formas: a atual, so digitos (`120363...@g.us`), e a antiga,
+ * derivada de quem criou o grupo (`5511999998888-1564082267@g.us`). As duas
+ * saem do painel da Evolution ja com o sufixo.
+ *
+ * Sem sufixo tambem vale: um id colado do painel tem 18 digitos, e acima do teto
+ * do E.164 (15) nao existe telefone — a alternativa seria o descarte silencioso
+ * por "longo demais", que e o modo de falha que este canal combate. O corte em
+ * 20 digitos deixa de fora a colagem de dois telefones grudados, que nao e
+ * destino nenhum.
+ */
+export declare function toWhatsappGroupJid(value: string): string | null;
+/**
+ * Destinos de WhatsApp de uma lista digitada a mao: celulares e grupos.
+ *
+ * Nao da para reusar um `split` de e-mail: `WhatsappSenderService.normalizeTarget`
+ * apenas remove os nao-digitos e **nao acrescenta DDI**. Um `(11) 99999-8888`
+ * digitado no admin viraria `11999998888`, um numero que o provedor aceita e
+ * entrega em outro lugar — falha silenciosa, que e exatamente o que este canal
+ * existe para evitar. Por isso o DDI 55 e completado aqui quando o que sobrou
+ * tem cara de numero nacional (DDD + 8 ou 9 digitos).
+ *
+ * A separacao e so por virgula, ponto-e-virgula e quebra de linha — nao por
+ * espaco. Espaco faz parte da mascara de um telefone (`+55 (11) 3333-4444`), e
+ * quebrar ali produziria os fragmentos `+55`, `(11)` e `3333-4444`, todos
+ * descartados: a lista inteira sumiria em silencio.
+ *
+ * Menos de 10 digitos nao e telefone com DDD, e mais de 15 nao e telefone nenhum
+ * (o teto do E.164) — normalmente sao dois numeros que alguem separou so com
+ * espaco. Descartar e melhor que enviar para um numero inventado.
+ */
+export declare function parseWhatsappRecipients(raw: string | null | undefined): WhatsappRecipient[];
+//# sourceMappingURL=whatsapp-recipients.d.ts.map

package/dist/whatsapp-sender/whatsapp-recipients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-recipients.d.ts","sourceRoot":"","sources":["../../src/whatsapp-sender/whatsapp-recipients.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,kBAAkB,CAAC;CAChC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK/D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,iBAAiB,EAAE,CAyBrB"}

package/dist/whatsapp-sender/whatsapp-recipients.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toWhatsappGroupJid = toWhatsappGroupJid;
+exports.parseWhatsappRecipients = parseWhatsappRecipients;
+/**
+ * Id de grupo do WhatsApp (`...@g.us`), ou null quando o item nao e grupo.
+ *
+ * Grupo tem duas formas: a atual, so digitos (`120363...@g.us`), e a antiga,
+ * derivada de quem criou o grupo (`5511999998888-1564082267@g.us`). As duas
+ * saem do painel da Evolution ja com o sufixo.
+ *
+ * Sem sufixo tambem vale: um id colado do painel tem 18 digitos, e acima do teto
+ * do E.164 (15) nao existe telefone — a alternativa seria o descarte silencioso
+ * por "longo demais", que e o modo de falha que este canal combate. O corte em
+ * 20 digitos deixa de fora a colagem de dois telefones grudados, que nao e
+ * destino nenhum.
+ */
+function toWhatsappGroupJid(value) {
+    const match = /^(\d{5,}(?:-\d{5,})?)@g\.us$/i.exec(value);
+    if (match)
+        return `${match[1]}@g.us`;
+    return /^\d{16,20}$/.test(value) ? `${value}@g.us` : null;
+}
+/**
+ * Destinos de WhatsApp de uma lista digitada a mao: celulares e grupos.
+ *
+ * Nao da para reusar um `split` de e-mail: `WhatsappSenderService.normalizeTarget`
+ * apenas remove os nao-digitos e **nao acrescenta DDI**. Um `(11) 99999-8888`
+ * digitado no admin viraria `11999998888`, um numero que o provedor aceita e
+ * entrega em outro lugar — falha silenciosa, que e exatamente o que este canal
+ * existe para evitar. Por isso o DDI 55 e completado aqui quando o que sobrou
+ * tem cara de numero nacional (DDD + 8 ou 9 digitos).
+ *
+ * A separacao e so por virgula, ponto-e-virgula e quebra de linha — nao por
+ * espaco. Espaco faz parte da mascara de um telefone (`+55 (11) 3333-4444`), e
+ * quebrar ali produziria os fragmentos `+55`, `(11)` e `3333-4444`, todos
+ * descartados: a lista inteira sumiria em silencio.
+ *
+ * Menos de 10 digitos nao e telefone com DDD, e mais de 15 nao e telefone nenhum
+ * (o teto do E.164) — normalmente sao dois numeros que alguem separou so com
+ * espaco. Descartar e melhor que enviar para um numero inventado.
+ */
+function parseWhatsappRecipients(raw) {
+    if (!raw)
+        return [];
+    // Map, e nao Set: o mesmo destino escrito de duas formas continua contando uma
+    // vez so, e o tipo precisa vir junto do valor.
+    const seen = new Map();
+    for (const item of raw.split(/[,;\n]+/)) {
+        const value = item.trim();
+        if (!value)
+            continue;
+        const group = toWhatsappGroupJid(value);
+        if (group) {
+            seen.set(group, { to: group, targetType: 'group' });
+            continue;
+        }
+        const digits = value.replace(/\D+/g, '');
+        if (digits.length < 10 || digits.length > 15)
+            continue;
+        const phone = digits.length <= 11 ? `55${digits}` : digits;
+        seen.set(phone, { to: phone, targetType: 'phone' });
+    }
+    return [...seen.values()];
+}
+//# sourceMappingURL=whatsapp-recipients.js.map

package/dist/whatsapp-sender/whatsapp-recipients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-recipients.js","sourceRoot":"","sources":["../../src/whatsapp-sender/whatsapp-recipients.ts"],"names":[],"mappings":";;AA6BA,gDAKC;AAqBD,0DA2BC;AAlED;;;;;;;;;;;;GAYG;AACH,SAAgB,kBAAkB,CAAC,KAAa;IAC9C,MAAM,KAAK,GAAG,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,KAAK;QAAE,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;IAErC,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,uBAAuB,CACrC,GAA8B;IAE9B,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IAEpB,+EAA+E;IAC/E,+CAA+C;IAC/C,MAAM,IAAI,GAAG,IAAI,GAAG,EAA6B,CAAC;IAElD,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAExC,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;YACpD,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE;YAAE,SAAS;QACvD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QAC3D,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAC5B,CAAC"}

package/dist/whatsapp-sender/whatsapp-sender.service.d.ts

@@ -1,4 +1,5 @@
 import { PrismaService } from '@hed-hog/api-prisma';
+import { BadRequestException } from '@nestjs/common';
 export type WhatsappTargetType = 'phone' | 'group';
 export type WhatsappMedia = {
     /** Bare base64 (sem prefixo data:) ou data URL — ambos aceitos. */
@@ -23,6 +24,16 @@ export type WhatsappSendInput = {
         params?: string[];
     };
 };
+/**
+ * Erro de envio classificado: `retryable` diz se tentar de novo pode dar
+ * resultado diferente. Um HTTP 4xx da Graph API (id inexistente, sem
+ * permissão, token ruim) não muda em cinco minutos; um 5xx ou falha de rede
+ * pode ser uma instabilidade passageira do provedor.
+ */
+export declare class WhatsappSendError extends BadRequestException {
+    readonly retryable: boolean;
+    constructor(message: string, retryable: boolean);
+}
 /**
  * Envio de WhatsApp usando um perfil de integração escolhido pelo usuário.
  *
@@ -37,6 +48,20 @@ export declare class WhatsappSenderService {
     send(input: WhatsappSendInput): Promise<void>;
     /** Diz se há perfil utilizável, para o chamador decidir por um fallback sem tentar o envio. */
     isConfigured(profileSlug?: string): Promise<boolean>;
+    /**
+     * Identidade do perfil que o `send` usaria, sem o `config`.
+     *
+     * Quem envia pelo provider oficial precisa dizer por qual número a mensagem
+     * sai, e cada módulo guarda esse id no próprio cadastro. Para achar o cadastro
+     * certo é preciso saber qual perfil foi resolvido — inclusive quando o slug
+     * veio vazio e a escolha coube a este serviço. O `config` fica de fora de
+     * propósito: é onde moram `access_token` e `app_secret`.
+     */
+    describeProfile(profileSlug?: string): Promise<{
+        id: number;
+        slug: string;
+        providerSlug: string;
+    }>;
     /**
      * Normaliza o destino: número vira só dígitos, id de grupo passa intacto
      * (grupos do WhatsApp têm sufixo `@g.us`, que seria destruído por um strip).

package/dist/whatsapp-sender/whatsapp-sender.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"whatsapp-sender.service.d.ts","sourceRoot":"","sources":["../../src/whatsapp-sender/whatsapp-sender.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAapD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG;IAC1B,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACnE,CAAC;AAQF;;;;;;GAMG;AACH,qBACa,qBAAqB;IAK9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;gBAI9C,MAAM,EAAE,aAAa;IAGlC,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAenD,+FAA+F;IACzF,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB1D;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,kBAA4B,GAAG,MAAM;YAsBnE,cAAc;IAyC5B,OAAO,CAAC,mBAAmB;YAUb,iBAAiB;YAmDjB,gBAAgB;CAoF/B"}
+{"version":3,"file":"whatsapp-sender.service.d.ts","sourceRoot":"","sources":["../../src/whatsapp-sender/whatsapp-sender.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,mBAAmB,EAMpB,MAAM,gBAAgB,CAAC;AAKxB,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG;IAC1B,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACnE,CAAC;AASF;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,mBAAmB;aAGtC,SAAS,EAAE,OAAO;gBADlC,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,OAAO;CAIrC;AAED;;;;;;GAMG;AACH,qBACa,qBAAqB;IAK9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;gBAI9C,MAAM,EAAE,aAAa;IAGlC,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAenD,+FAA+F;IACzF,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB1D;;;;;;;;OAQG;IACG,eAAe,CACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAK9D;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,kBAA4B,GAAG,MAAM;YAsBnE,cAAc;IA0C5B,OAAO,CAAC,mBAAmB;YAUb,iBAAiB;YAmDjB,gBAAgB;CAwG/B"}