@hed-hog/core 0.0.400 → 0.0.401

package/dist/pdf/document/pdf-document.renderer.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeHtml = escapeHtml;
+exports.renderBlock = renderBlock;
+exports.renderDocumentHtml = renderDocumentHtml;
+const pdf_document_css_1 = require("./pdf-document.css");
+/**
+ * Único ponto por onde texto entra no HTML. Nome de aluno, título de curso e
+ * rótulo de tarefa são dados de usuário indo para um Chromium headless.
+ */
+function escapeHtml(value) {
+    if (value === null || value === undefined)
+        return '';
+    return String(value)
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+const formatGeneratedAt = (date, locale) => new Intl.DateTimeFormat(locale, {
+    day: '2-digit',
+    month: 'long',
+    year: 'numeric',
+    hour: '2-digit',
+    minute: '2-digit',
+}).format(date);
+const toCell = (value) => {
+    if (value === null || value === undefined)
+        return { text: '—', tone: 'muted' };
+    if (typeof value === 'object')
+        return value;
+    return { text: String(value) };
+};
+const alignClass = (column) => column.align === 'right'
+    ? ' class="align-right"'
+    : column.align === 'center'
+        ? ' class="align-center"'
+        : '';
+function renderCards(items, columns, variant) {
+    const cards = items
+        .map((item) => `<div class="card"><div class="card-label">${escapeHtml(item.label)}</div>` +
+        `<div class="card-value">${escapeHtml(item.value)}</div>` +
+        (item.hint ? `<div class="card-hint">${escapeHtml(item.hint)}</div>` : '') +
+        '</div>')
+        .join('');
+    return `<div class="cards cards-${columns} cards-${variant}">${cards}</div>`;
+}
+function renderTable(block) {
+    const { columns, rows, numbered = false, numberHeader = '#', zebra = true, compact = false, emptyText = 'Nenhum registro no recorte selecionado.', truncatedNote, } = block;
+    if (rows.length === 0) {
+        return `<div class="table-empty">${escapeHtml(emptyText)}</div>`;
+    }
+    const head = (numbered ? `<th class="idx">${escapeHtml(numberHeader)}</th>` : '') +
+        columns
+            .map((column) => `<th${alignClass(column)}${column.width ? ` style="width:${escapeHtml(column.width)}"` : ''}>` +
+            `${escapeHtml(column.header)}</th>`)
+            .join('');
+    // `push` + `join` em vez de concatenar em laço: uma conta grande gera milhares
+    // de linhas, e a string intermediária de cada passo é o que faz o render
+    // arrastar.
+    const body = [];
+    rows.forEach((row, index) => {
+        const cells = [];
+        if (numbered)
+            cells.push(`<td class="idx">${index + 1}</td>`);
+        columns.forEach((column, columnIndex) => {
+            const cell = toCell(row[columnIndex]);
+            const tone = cell.tone && cell.tone !== 'default' ? ` tone-${cell.tone}` : '';
+            const align = column.align === 'right' ? ' align-right' : column.align === 'center' ? ' align-center' : '';
+            cells.push(`<td class="${(tone + align).trim()}">${escapeHtml(cell.text)}` +
+                (cell.sub ? `<div class="cell-sub">${escapeHtml(cell.sub)}</div>` : '') +
+                '</td>');
+        });
+        body.push(`<tr>${cells.join('')}</tr>`);
+    });
+    const table = `<table class="doc-table${zebra ? ' zebra' : ''}${compact ? ' compact' : ''}">` +
+        `<thead><tr>${head}</tr></thead><tbody>${body.join('')}</tbody></table>`;
+    return truncatedNote ? `${table}<div class="note">${escapeHtml(truncatedNote)}</div>` : table;
+}
+function renderBlock(block) {
+    var _a, _b;
+    switch (block.kind) {
+        case 'section':
+            return (`<h2>${escapeHtml(block.title)}` +
+                (block.hint ? `<span class="section-hint">${escapeHtml(block.hint)}</span>` : '') +
+                '</h2>');
+        case 'cards':
+            return renderCards(block.items, (_a = block.columns) !== null && _a !== void 0 ? _a : 4, (_b = block.variant) !== null && _b !== void 0 ? _b : 'metric');
+        case 'table':
+            return renderTable(block);
+        case 'chart':
+            return ('<div class="chart">' +
+                (block.title ? `<div class="chart-title">${escapeHtml(block.title)}</div>` : '') +
+                block.svg +
+                (block.caption ? `<div class="chart-caption">${escapeHtml(block.caption)}</div>` : '') +
+                '</div>');
+        case 'chartGrid':
+            return ('<div class="chart-grid">' +
+                block.items
+                    .map((item) => '<div class="chart">' +
+                    (item.title ? `<div class="chart-title">${escapeHtml(item.title)}</div>` : '') +
+                    item.svg +
+                    (item.caption ? `<div class="chart-caption">${escapeHtml(item.caption)}</div>` : '') +
+                    '</div>')
+                    .join('') +
+                '</div>');
+        case 'note':
+            return `<div class="note${block.tone === 'accent' ? ' note-accent' : ''}">${escapeHtml(block.text)}</div>`;
+        case 'legend':
+            return `<div class="legend">${block.lines.map((l) => `<p>${escapeHtml(l)}</p>`).join('')}</div>`;
+        case 'pageBreak':
+            return '<div class="page-break"></div>';
+        default:
+            return '';
+    }
+}
+function renderDocumentHtml(input, theme) {
+    var _a, _b, _c, _d;
+    const locale = (_a = input.locale) !== null && _a !== void 0 ? _a : 'pt-BR';
+    const generatedAt = (_b = input.generatedAt) !== null && _b !== void 0 ? _b : new Date();
+    const logo = input.logoDataUri || theme.logoUrl;
+    const meta = ((_c = input.meta) !== null && _c !== void 0 ? _c : [])
+        .map((item) => `<div>${escapeHtml(item.label)}: <span class="meta-value">${escapeHtml(item.value)}</span></div>`)
+        .join('');
+    const body = input.blocks.map((block) => renderBlock(block)).join('\n');
+    return `<!DOCTYPE html>
+<html lang="${escapeHtml(locale)}">
+  <head>
+    <meta charset="utf-8" />
+    <title>${escapeHtml(input.title)}</title>
+    <style>${(0, pdf_document_css_1.buildDocumentCss)(theme, (_d = input.landscape) !== null && _d !== void 0 ? _d : false)}</style>
+  </head>
+  <body>
+    <header>
+      <div class="brand">
+        <img src="${escapeHtml(logo)}" alt="${escapeHtml(theme.companyName)}" />
+        <div class="brand-text">
+          ${input.eyebrow ? `<div class="eyebrow">${escapeHtml(input.eyebrow)}</div>` : ''}
+          <h1>${escapeHtml(input.title)}</h1>
+          ${input.subtitle ? `<div class="company-name">${escapeHtml(input.subtitle)}</div>` : ''}
+        </div>
+      </div>
+      <div class="meta-block">
+        <div>Gerado em: <span class="meta-value">${escapeHtml(formatGeneratedAt(generatedAt, locale))}</span></div>
+        ${meta}
+      </div>
+    </header>
+    ${body}
+  </body>
+</html>`;
+}
+//# sourceMappingURL=pdf-document.renderer.js.map

package/dist/pdf/document/pdf-document.renderer.js.map

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

package/dist/pdf/document/pdf-document.service.d.ts

@@ -0,0 +1,27 @@
+import { BrandAssetService } from '../../setting/brand-asset.service';
+import { SettingService } from '../../setting/setting.service';
+import { PdfService } from '../pdf.service';
+import { PdfDocumentTheme, PdfDocumentThemeOverrides } from './pdf-document.theme';
+import { PdfDocumentInput } from './pdf-document.types';
+/**
+ * Gera o documento PDF padrão do sistema: letterhead com logo, cards, tabelas,
+ * gráficos, barra de destaque no topo de toda página e paginação "X / N".
+ *
+ * Quem chama entrega blocos de dados ({@link PdfDocumentInput}); o HTML e o
+ * Chromium são responsabilidade daqui.
+ */
+export declare class PdfDocumentService {
+    private readonly pdf;
+    private readonly settingService;
+    private readonly brandAsset;
+    constructor(pdf: PdfService, settingService: SettingService, brandAsset: BrandAssetService);
+    loadTheme(overrides?: PdfDocumentThemeOverrides): Promise<PdfDocumentTheme>;
+    /** HTML puro, sem Chromium — serve aos testes e a quem quiser inspecionar. */
+    buildHtml(input: PdfDocumentInput, theme?: PdfDocumentTheme): Promise<string>;
+    render(input: PdfDocumentInput, options?: {
+        theme?: PdfDocumentTheme;
+        label?: string;
+        timeoutMs?: number;
+    }): Promise<Buffer>;
+}
+//# sourceMappingURL=pdf-document.service.d.ts.map

package/dist/pdf/document/pdf-document.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-document.service.d.ts","sourceRoot":"","sources":["../../../src/pdf/document/pdf-document.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAO5C,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EAE1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;;GAMG;AACH,qBACa,kBAAkB;IAG3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAEpB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAJV,GAAG,EAAE,UAAU,EAEf,cAAc,EAAE,cAAc,EAE9B,UAAU,EAAE,iBAAiB;IAGhD,SAAS,CAAC,SAAS,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI3E,8EAA8E;IACxE,SAAS,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7E,MAAM,CACV,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,gBAAgB,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAC7E,OAAO,CAAC,MAAM,CAAC;CA4BnB"}

package/dist/pdf/document/pdf-document.service.js

@@ -0,0 +1,81 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PdfDocumentService = void 0;
+const common_1 = require("@nestjs/common");
+const brand_asset_service_1 = require("../../setting/brand-asset.service");
+const setting_service_1 = require("../../setting/setting.service");
+const pdf_service_1 = require("../pdf.service");
+const pdf_document_chrome_1 = require("./pdf-document.chrome");
+const pdf_document_renderer_1 = require("./pdf-document.renderer");
+const pdf_document_theme_1 = require("./pdf-document.theme");
+/**
+ * Gera o documento PDF padrão do sistema: letterhead com logo, cards, tabelas,
+ * gráficos, barra de destaque no topo de toda página e paginação "X / N".
+ *
+ * Quem chama entrega blocos de dados ({@link PdfDocumentInput}); o HTML e o
+ * Chromium são responsabilidade daqui.
+ */
+let PdfDocumentService = class PdfDocumentService {
+    constructor(pdf, settingService, brandAsset) {
+        this.pdf = pdf;
+        this.settingService = settingService;
+        this.brandAsset = brandAsset;
+    }
+    loadTheme(overrides) {
+        return (0, pdf_document_theme_1.resolveDocumentTheme)(this.settingService, this.brandAsset, overrides);
+    }
+    /** HTML puro, sem Chromium — serve aos testes e a quem quiser inspecionar. */
+    async buildHtml(input, theme) {
+        return (0, pdf_document_renderer_1.renderDocumentHtml)(input, theme !== null && theme !== void 0 ? theme : (await this.loadTheme()));
+    }
+    async render(input, options = {}) {
+        var _a, _b, _c, _d, _e, _f;
+        const theme = (_a = options.theme) !== null && _a !== void 0 ? _a : (await this.loadTheme());
+        const html = (0, pdf_document_renderer_1.renderDocumentHtml)(input, theme);
+        const generatedAt = (_b = input.generatedAt) !== null && _b !== void 0 ? _b : new Date();
+        const footerLeft = [
+            (_c = input.footerLeft) !== null && _c !== void 0 ? _c : 'Documento Confidencial',
+            `Gerado em ${new Intl.DateTimeFormat((_d = input.locale) !== null && _d !== void 0 ? _d : 'pt-BR').format(generatedAt)}`,
+            theme.companyName,
+        ]
+            .filter(Boolean)
+            .join(' · ');
+        return this.pdf.generatePdfFromHtml(html, {
+            format: 'A4',
+            landscape: (_e = input.landscape) !== null && _e !== void 0 ? _e : false,
+            printBackground: true,
+            margin: pdf_document_chrome_1.PDF_DOCUMENT_MARGIN,
+            displayHeaderFooter: true,
+            headerTemplate: (0, pdf_document_chrome_1.buildAccentHeaderTemplate)(theme),
+            footerTemplate: (0, pdf_document_chrome_1.buildFooterTemplate)(theme, footerLeft),
+            // O logo já vem embutido como data URI e não há fonte web: esperar por
+            // rede ociosa só adicionaria o timeout do `networkidle` ao render.
+            waitUntil: 'load',
+            timeoutMs: (_f = options.timeoutMs) !== null && _f !== void 0 ? _f : 60000,
+            label: options.label,
+        });
+    }
+};
+exports.PdfDocumentService = PdfDocumentService;
+exports.PdfDocumentService = PdfDocumentService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)((0, common_1.forwardRef)(() => pdf_service_1.PdfService))),
+    __param(1, (0, common_1.Inject)((0, common_1.forwardRef)(() => setting_service_1.SettingService))),
+    __param(2, (0, common_1.Inject)((0, common_1.forwardRef)(() => brand_asset_service_1.BrandAssetService))),
+    __metadata("design:paramtypes", [pdf_service_1.PdfService,
+        setting_service_1.SettingService,
+        brand_asset_service_1.BrandAssetService])
+], PdfDocumentService);
+//# sourceMappingURL=pdf-document.service.js.map

package/dist/pdf/document/pdf-document.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-document.service.js","sourceRoot":"","sources":["../../../src/pdf/document/pdf-document.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAgE;AAEhE,2EAAsE;AACtE,mEAA+D;AAC/D,gDAA4C;AAC5C,+DAI+B;AAC/B,mEAA6D;AAC7D,6DAI8B;AAG9B;;;;;;GAMG;AAEI,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B,YAEmB,GAAe,EAEf,cAA8B,EAE9B,UAA6B;QAJ7B,QAAG,GAAH,GAAG,CAAY;QAEf,mBAAc,GAAd,cAAc,CAAgB;QAE9B,eAAU,GAAV,UAAU,CAAmB;IAC7C,CAAC;IAEJ,SAAS,CAAC,SAAqC;QAC7C,OAAO,IAAA,yCAAoB,EAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAC/E,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,SAAS,CAAC,KAAuB,EAAE,KAAwB;QAC/D,OAAO,IAAA,0CAAkB,EAAC,KAAK,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,MAAM,CACV,KAAuB,EACvB,UAA4E,EAAE;;QAE9E,MAAM,KAAK,GAAG,MAAA,OAAO,CAAC,KAAK,mCAAI,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,IAAA,0CAAkB,EAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAE9C,MAAM,WAAW,GAAG,MAAA,KAAK,CAAC,WAAW,mCAAI,IAAI,IAAI,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG;YACjB,MAAA,KAAK,CAAC,UAAU,mCAAI,wBAAwB;YAC5C,aAAa,IAAI,IAAI,CAAC,cAAc,CAAC,MAAA,KAAK,CAAC,MAAM,mCAAI,OAAO,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE;YACnF,KAAK,CAAC,WAAW;SAClB;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,KAAK,CAAC,CAAC;QAEf,OAAO,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,EAAE;YACxC,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,MAAA,KAAK,CAAC,SAAS,mCAAI,KAAK;YACnC,eAAe,EAAE,IAAI;YACrB,MAAM,EAAE,yCAAmB;YAC3B,mBAAmB,EAAE,IAAI;YACzB,cAAc,EAAE,IAAA,+CAAyB,EAAC,KAAK,CAAC;YAChD,cAAc,EAAE,IAAA,yCAAmB,EAAC,KAAK,EAAE,UAAU,CAAC;YACtD,uEAAuE;YACvE,mEAAmE;YACnE,SAAS,EAAE,MAAM;YACjB,SAAS,EAAE,MAAA,OAAO,CAAC,SAAS,mCAAI,KAAM;YACtC,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAlDY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,eAAM,EAAC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,wBAAU,CAAC,CAAC,CAAA;IAEpC,WAAA,IAAA,eAAM,EAAC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,gCAAc,CAAC,CAAC,CAAA;IAExC,WAAA,IAAA,eAAM,EAAC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,uCAAiB,CAAC,CAAC,CAAA;qCAHtB,wBAAU;QAEC,gCAAc;QAElB,uCAAiB;GAPrC,kBAAkB,CAkD9B"}

package/dist/pdf/document/pdf-document.theme.d.ts

@@ -0,0 +1,41 @@
+import { BrandAssetService } from '../../setting/brand-asset.service';
+import { SettingService } from '../../setting/setting.service';
+/**
+ * Tokens do documento padrão. São as mesmas settings que a proposta comercial
+ * do CRM lê, para que os dois PDFs saiam com a mesma identidade sem um copiar
+ * as cores do outro na mão.
+ */
+export interface PdfDocumentTheme {
+    primary: string;
+    /** Fundo suave dos cards e do cabeçalho da tabela. */
+    mutedBg: string;
+    /** Texto secundário: rótulos, legendas, rodapé. */
+    mutedFg: string;
+    /** Texto principal. */
+    ink: string;
+    /** Bordas. */
+    line: string;
+    companyName: string;
+    /** Data URI ou URL absoluta do logo do sistema. */
+    logoUrl: string;
+    fontFamily: string;
+    /** Cores categóricas dos gráficos, com a primária na frente. */
+    chartPalette: string[];
+}
+/**
+ * Nenhuma fonte web: o container da API só tem `ttf-freefont`, e um `<link>`
+ * para o Google Fonts com `waitUntil: 'networkidle'` vira espera até o timeout
+ * quando o pod não tem saída para a internet.
+ */
+export declare const PDF_DOCUMENT_FONT = "Arial, Helvetica, sans-serif";
+export interface PdfDocumentThemeOverrides {
+    companyName?: string;
+    primary?: string;
+}
+/**
+ * Lê as settings de marca. Qualquer falha cai nos valores de fábrica — um
+ * relatório sem cor certa ainda é um relatório; um relatório que não sai não é.
+ */
+export declare function resolveDocumentTheme(settingService: SettingService, brandAsset: BrandAssetService, overrides?: PdfDocumentThemeOverrides): Promise<PdfDocumentTheme>;
+export declare function inlineWordmark(primary: string): string;
+//# sourceMappingURL=pdf-document.theme.d.ts.map

package/dist/pdf/document/pdf-document.theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-document.theme.d.ts","sourceRoot":"","sources":["../../../src/pdf/document/pdf-document.theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAWD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,iCAAiC,CAAC;AAoBhE,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,iBAAiB,EAC7B,SAAS,GAAE,yBAA8B,GACxC,OAAO,CAAC,gBAAgB,CAAC,CA8B3B;AA8BD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYtD"}

package/dist/pdf/document/pdf-document.theme.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PDF_DOCUMENT_FONT = void 0;
+exports.resolveDocumentTheme = resolveDocumentTheme;
+exports.inlineWordmark = inlineWordmark;
+const FALLBACK = {
+    primary: '#ff760c',
+    mutedBg: '#f4f4f5',
+    mutedFg: '#71717a',
+    ink: '#18181b',
+    line: '#e4e4e7',
+    companyName: 'HedHog',
+};
+/**
+ * Nenhuma fonte web: o container da API só tem `ttf-freefont`, e um `<link>`
+ * para o Google Fonts com `waitUntil: 'networkidle'` vira espera até o timeout
+ * quando o pod não tem saída para a internet.
+ */
+exports.PDF_DOCUMENT_FONT = 'Arial, Helvetica, sans-serif';
+/** Paleta print-safe: sem amarelo puro nem cinza claro, que somem no papel. */
+const CATEGORICAL = [
+    '#2563eb',
+    '#16a34a',
+    '#9333ea',
+    '#dc2626',
+    '#0891b2',
+    '#b45309',
+    '#4f46e5',
+    '#475569',
+];
+const text = (value) => {
+    if (typeof value !== 'string')
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+};
+/**
+ * Lê as settings de marca. Qualquer falha cai nos valores de fábrica — um
+ * relatório sem cor certa ainda é um relatório; um relatório que não sai não é.
+ */
+async function resolveDocumentTheme(settingService, brandAsset, overrides = {}) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    let values = {};
+    try {
+        values = await settingService.getSettingValues([
+            'theme-primary-light',
+            'theme-muted-light',
+            'theme-muted-foreground-light',
+            'theme-secondary-foreground-light',
+            'system-name',
+            'image-url',
+            'icon-url',
+        ]);
+    }
+    catch (_h) {
+        values = {};
+    }
+    const primary = (_b = (_a = overrides.primary) !== null && _a !== void 0 ? _a : text(values['theme-primary-light'])) !== null && _b !== void 0 ? _b : FALLBACK.primary;
+    return {
+        primary,
+        mutedBg: (_c = text(values['theme-muted-light'])) !== null && _c !== void 0 ? _c : FALLBACK.mutedBg,
+        mutedFg: (_d = text(values['theme-muted-foreground-light'])) !== null && _d !== void 0 ? _d : FALLBACK.mutedFg,
+        ink: (_e = text(values['theme-secondary-foreground-light'])) !== null && _e !== void 0 ? _e : FALLBACK.ink,
+        line: FALLBACK.line,
+        companyName: (_g = (_f = overrides.companyName) !== null && _f !== void 0 ? _f : text(values['system-name'])) !== null && _g !== void 0 ? _g : FALLBACK.companyName,
+        logoUrl: await resolveSystemLogo(brandAsset, values, primary),
+        fontFamily: exports.PDF_DOCUMENT_FONT,
+        chartPalette: [primary, ...CATEGORICAL],
+    };
+}
+/**
+ * O Chromium renderiza sem sessão e, dentro do cluster, pode não ter rota para
+ * o host público — por isso a imagem é baixada e embutida como data URI, com a
+ * URL absoluta como segundo recurso e um wordmark inline como último.
+ */
+async function resolveSystemLogo(brandAsset, values, primary) {
+    var _a;
+    const configured = (_a = text(values['image-url'])) !== null && _a !== void 0 ? _a : text(values['icon-url']);
+    if (configured) {
+        try {
+            const absolute = await brandAsset.resolveAssetUrl(configured);
+            if (absolute) {
+                const dataUri = await brandAsset.fetchAsDataUri(absolute);
+                if (dataUri)
+                    return dataUri;
+                return absolute;
+            }
+        }
+        catch (_b) {
+            // Cai no wordmark abaixo.
+        }
+    }
+    return inlineWordmark(primary);
+}
+function inlineWordmark(primary) {
+    const svg = encodeURIComponent([
+        '<svg xmlns="http://www.w3.org/2000/svg" width="240" height="72" viewBox="0 0 240 72">',
+        '<rect width="240" height="72" rx="18" fill="#0f172a"/>',
+        `<circle cx="38" cy="36" r="18" fill="${primary}"/>`,
+        '<text x="72" y="43" fill="#ffffff" font-size="26" font-family="Arial, sans-serif" font-weight="700">HedHog</text>',
+        '</svg>',
+    ].join(''));
+    return `data:image/svg+xml;charset=UTF-8,${svg}`;
+}
+//# sourceMappingURL=pdf-document.theme.js.map

package/dist/pdf/document/pdf-document.theme.js.map

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

package/dist/pdf/document/pdf-document.types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Modelo de um documento PDF padrão: o chamador descreve **dados**, nunca HTML.
+ *
+ * É o que sustenta a regra de escape do renderer — se um serviço pudesse passar
+ * markup, o nome de um aluno com `<` viraria tag dentro de um Chromium headless.
+ * A única exceção é o SVG dos gráficos, que carrega o tipo {@link SafeSvg} e só
+ * pode ser produzido pelos desenhistas do próprio kit.
+ */
+/** SVG montado pelos helpers de gráfico do kit — a única string injetada sem escape. */
+export type SafeSvg = string & {
+    readonly __safeSvg: unique symbol;
+};
+/**
+ * Marca um SVG como seguro. Só os desenhistas de `./charts` devem chamar isto:
+ * quem passar conteúdo de usuário aqui reabre a porta que o modelo de blocos fecha.
+ */
+export declare const asSafeSvg: (svg: string) => SafeSvg;
+export interface PdfDocumentMeta {
+    label: string;
+    value: string;
+}
+export interface PdfDocumentCard {
+    label: string;
+    value: string;
+    /** Linha pequena abaixo do valor, para a unidade ou a ressalva. */
+    hint?: string;
+}
+export interface PdfDocumentTableColumn {
+    header: string;
+    align?: 'left' | 'center' | 'right';
+    /**
+     * Largura CSS (ex.: '18%'). Sem ela o Chromium reparte pelo conteúdo e a
+     * tabela muda de forma a cada página.
+     */
+    width?: string;
+}
+export interface PdfDocumentTableCell {
+    text: string;
+    /** Segunda linha menor: o e-mail sob o nome, o "Em risco" sob o status. */
+    sub?: string;
+    tone?: 'default' | 'muted' | 'bold' | 'accent' | 'warn';
+}
+export type PdfDocumentRow = Array<string | number | null | undefined | PdfDocumentTableCell>;
+export type PdfDocumentBlock = {
+    kind: 'section';
+    title: string;
+    hint?: string;
+} | {
+    kind: 'cards';
+    items: PdfDocumentCard[];
+    /** Padrão: 4. */
+    columns?: 2 | 3 | 4 | 5;
+    /** 'metric' destaca o valor (indicador); 'filter' é o carimbo do recorte. */
+    variant?: 'metric' | 'filter';
+} | {
+    kind: 'table';
+    columns: PdfDocumentTableColumn[];
+    rows: PdfDocumentRow[];
+    /** Coluna "#" à esquerda, 1..N contínua entre páginas. */
+    numbered?: boolean;
+    numberHeader?: string;
+    zebra?: boolean;
+    /** Fonte menor, para tabela com muitas colunas. */
+    compact?: boolean;
+    emptyText?: string;
+    /** Aviso de corte quando a origem truncou as linhas. */
+    truncatedNote?: string;
+} | {
+    kind: 'chart';
+    title?: string;
+    svg: SafeSvg;
+    caption?: string;
+} | {
+    kind: 'chartGrid';
+    items: Array<{
+        title?: string;
+        svg: SafeSvg;
+        caption?: string;
+    }>;
+} | {
+    kind: 'note';
+    text: string;
+    tone?: 'muted' | 'accent';
+} | {
+    kind: 'legend';
+    lines: string[];
+} | {
+    kind: 'pageBreak';
+};
+export interface PdfDocumentInput {
+    /** O `h1` do letterhead. */
+    title: string;
+    /** Sobretítulo laranja, em caixa alta (ex.: "Relatório de Alunos"). */
+    eyebrow?: string;
+    /** Linha cinza abaixo do título — normalmente o nome da empresa. */
+    subtitle?: string;
+    /** Bloco alinhado à direita do letterhead. */
+    meta?: PdfDocumentMeta[];
+    blocks: PdfDocumentBlock[];
+    /** Data URI do logo; sem ele o kit usa o logo do sistema. */
+    logoDataUri?: string | null;
+    generatedAt?: Date;
+    locale?: string;
+    landscape?: boolean;
+    /** Padrão: 'Documento Confidencial'. */
+    footerLeft?: string;
+}
+//# sourceMappingURL=pdf-document.types.d.ts.map

package/dist/pdf/document/pdf-document.types.d.ts.map

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

package/dist/pdf/document/pdf-document.types.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Modelo de um documento PDF padrão: o chamador descreve **dados**, nunca HTML.
+ *
+ * É o que sustenta a regra de escape do renderer — se um serviço pudesse passar
+ * markup, o nome de um aluno com `<` viraria tag dentro de um Chromium headless.
+ * A única exceção é o SVG dos gráficos, que carrega o tipo {@link SafeSvg} e só
+ * pode ser produzido pelos desenhistas do próprio kit.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asSafeSvg = void 0;
+/**
+ * Marca um SVG como seguro. Só os desenhistas de `./charts` devem chamar isto:
+ * quem passar conteúdo de usuário aqui reabre a porta que o modelo de blocos fecha.
+ */
+const asSafeSvg = (svg) => svg;
+exports.asSafeSvg = asSafeSvg;
+//# sourceMappingURL=pdf-document.types.js.map

package/dist/pdf/document/pdf-document.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-document.types.js","sourceRoot":"","sources":["../../../src/pdf/document/pdf-document.types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAKH;;;GAGG;AACI,MAAM,SAAS,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,GAAc,CAAC;AAArD,QAAA,SAAS,aAA4C"}

package/dist/pdf/pdf.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pdf.module.d.ts","sourceRoot":"","sources":["../../src/pdf/pdf.module.ts"],"names":[],"mappings":"AAOA,qBASa,SAAS;CAAG"}
+{"version":3,"file":"pdf.module.d.ts","sourceRoot":"","sources":["../../src/pdf/pdf.module.ts"],"names":[],"mappings":"AAQA,qBASa,SAAS;CAAG"}

package/dist/pdf/pdf.module.js

@@ -10,6 +10,7 @@ exports.PdfModule = void 0;
 const common_1 = require("@nestjs/common");
 const config_1 = require("@nestjs/config");
 const setting_module_1 = require("../setting/setting.module");
+const pdf_document_service_1 = require("./document/pdf-document.service");
 const pdf_controller_1 = require("./pdf.controller");
 const pdf_service_1 = require("./pdf.service");
 let PdfModule = class PdfModule {
@@ -21,8 +22,8 @@ exports.PdfModule = PdfModule = __decorate([
             config_1.ConfigModule,
             (0, common_1.forwardRef)(() => setting_module_1.SettingModule),
         ],
-        providers: [pdf_service_1.PdfService],
-        exports: [pdf_service_1.PdfService],
+        providers: [pdf_service_1.PdfService, pdf_document_service_1.PdfDocumentService],
+        exports: [pdf_service_1.PdfService, pdf_document_service_1.PdfDocumentService],
         controllers: [pdf_controller_1.PdfController],
     })
 ], PdfModule);

package/dist/pdf/pdf.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"pdf.module.js","sourceRoot":"","sources":["../../src/pdf/pdf.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAoD;AACpD,2CAA8C;AAE9C,8DAA0D;AAC1D,qDAAiD;AACjD,+CAA2C;AAWpC,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,8BAAS;oBAAT,SAAS;IATrB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,qBAAY;YACZ,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,8BAAa,CAAC;SAChC;QACD,SAAS,EAAE,CAAC,wBAAU,CAAC;QACvB,OAAO,EAAE,CAAC,wBAAU,CAAC;QACrB,WAAW,EAAE,CAAC,8BAAa,CAAC;KAC7B,CAAC;GACW,SAAS,CAAG"}
+{"version":3,"file":"pdf.module.js","sourceRoot":"","sources":["../../src/pdf/pdf.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAoD;AACpD,2CAA8C;AAE9C,8DAA0D;AAC1D,0EAAqE;AACrE,qDAAiD;AACjD,+CAA2C;AAWpC,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,8BAAS;oBAAT,SAAS;IATrB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,qBAAY;YACZ,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,8BAAa,CAAC;SAChC;QACD,SAAS,EAAE,CAAC,wBAAU,EAAE,yCAAkB,CAAC;QAC3C,OAAO,EAAE,CAAC,wBAAU,EAAE,yCAAkB,CAAC;QACzC,WAAW,EAAE,CAAC,8BAAa,CAAC;KAC7B,CAAC;GACW,SAAS,CAAG"}