@hed-hog/core 0.0.329 → 0.0.330

package/src/pdf/pdf.controller.ts

@@ -0,0 +1,86 @@
+import { Public, Role } from '@hed-hog/api';
+import { Controller, Get, Inject, Query, Res, forwardRef } from '@nestjs/common';
+import { Response } from 'express';
+
+import { GeneratePdfDTO } from './dto/generate-pdf.dto';
+import { PdfService } from './pdf.service';
+
+@Role()
+@Controller('core/pdf')
+export class PdfController {
+  constructor(
+    @Inject(forwardRef(() => PdfService))
+    private readonly pdfService: PdfService,
+  ) {}
+
+  /**
+   * GET /core/pdf/example
+   *
+   * Generates a sample hcode Institutional PDF using the Design System
+   * template with the currently configured area color.
+   * Publicly accessible — no auth required.
+   */
+  @Public()
+  @Get('example')
+  async example(@Query() query: GeneratePdfDTO, @Res() res: Response) {
+    const area = query.area ?? 'consulting';
+    const disposition = query.disposition ?? 'inline';
+
+    const buffer = await this.pdfService.generatePdfFromTemplate(
+      'hcode-institutional',
+      {
+        area,
+        title: 'Inteligência aplicada.',
+        subtitle:
+          'De diagnóstico a aplicação: consultoria, formação e pesquisa em IA para empresas que querem liderar.',
+        description:
+          'Combinamos diagnóstico estratégico, formação corporativa e pesquisa aplicada para transformar ' +
+          'a inteligência artificial em resultado mensurável para o seu negócio.',
+        features: [
+          {
+            icon: 'discovery',
+            title: 'Discovery & Diagnóstico',
+            description:
+              'Mapeamento de maturidade, gaps e oportunidades de IA na sua operação atual.',
+          },
+          {
+            icon: 'strategy',
+            title: 'Estratégia & Roadmap',
+            description:
+              'Plano de adoção com priorização por impacto, viabilidade e alinhamento cultural.',
+          },
+          {
+            icon: 'governance',
+            title: 'Governança & Ética',
+            description:
+              'Frameworks de uso responsável, políticas internas e compliance regulatório.',
+          },
+        ],
+        tableHeaders: ['Fase', 'Entregável', 'Duração', 'Responsável'],
+        tableRows: [
+          ['01 · Discovery', 'Diagnóstico de maturidade IA', '2 semanas', 'hcode'],
+          ['02 · Estratégia', 'Roadmap de adoção e priorização', '3 semanas', 'hcode + Cliente'],
+          ['03 · Piloto', 'Implantação de caso de uso prioritário', '6 semanas', 'hcode + TI'],
+          ['04 · Scale', 'Expansão e gestão de mudança', 'ongoing', 'Cliente (suporte hcode)'],
+        ],
+        metadata: [
+          { label: 'Área', value: area.charAt(0).toUpperCase() + area.slice(1) },
+          { label: 'Versão', value: '1.0' },
+          { label: 'Data', value: new Date().toLocaleDateString('pt-BR') },
+          { label: 'Design System', value: 'DS v1.0' },
+        ],
+        signatories: [
+          { label: 'Responsável pelo Projeto' },
+          { label: 'Aprovado por' },
+        ],
+      },
+    );
+
+    res.set({
+      'Content-Type': 'application/pdf',
+      'Content-Disposition': `${disposition}; filename="hcode-${area}-example.pdf"`,
+      'Content-Length': buffer.length,
+    });
+    res.end(buffer);
+  }
+}

package/src/pdf/pdf.module.ts

@@ -0,0 +1,17 @@
+import { forwardRef, Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+
+import { SettingModule } from '../setting/setting.module';
+import { PdfController } from './pdf.controller';
+import { PdfService } from './pdf.service';
+
+@Module({
+  imports: [
+    ConfigModule,
+    forwardRef(() => SettingModule),
+  ],
+  providers: [PdfService],
+  exports: [PdfService],
+  controllers: [PdfController],
+})
+export class PdfModule {}

package/src/pdf/pdf.service.ts

@@ -0,0 +1,229 @@
+import { Inject, Injectable, InternalServerErrorException, Logger, forwardRef } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+
+import { SettingService } from '../setting/setting.service';
+import { PdfAreaType, PdfThemeConfig } from './interfaces/pdf-theme-config.interface';
+import { hcodeInstitutionalTemplate } from './templates/hcode-institutional.template';
+import { AreaDefaults, HCODE_DEFAULTS } from './themes/hcode.theme';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Types
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface PdfGenerateOptions {
+  format?: 'A4' | 'A3' | 'Letter';
+  margin?: { top?: string; right?: string; bottom?: string; left?: string };
+  printBackground?: boolean;
+  landscape?: boolean;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Service
+// ─────────────────────────────────────────────────────────────────────────────
+
+@Injectable()
+export class PdfService {
+  private readonly logger = new Logger(PdfService.name);
+
+  constructor(
+    @Inject(forwardRef(() => SettingService))
+    private readonly settingService: SettingService,
+    private readonly configService: ConfigService,
+  ) {}
+
+  // ── Theme config ─────────────────────────────────────────────────────────
+
+  /**
+   * Resolves the active PdfThemeConfig for the given area.
+   * Reads admin-configured overrides from SettingService and falls back to
+   * the hard-coded Design System v1.0 defaults.
+   */
+  async loadThemeConfig(area: PdfAreaType = 'consulting'): Promise<PdfThemeConfig> {
+    const defaults: AreaDefaults = HCODE_DEFAULTS[area];
+
+    try {
+      const values = await this.settingService.getSettingValues([
+        'pdf-company-name',
+        'pdf-logo',
+        `pdf-${area}-color`,
+        'theme-primary-light', // system-wide brand color
+        'image-url',           // system logo
+        'system-name',         // system display name fallback
+      ]);
+
+      // Color priority:
+      //   1. pdf-${area}-color if admin explicitly changed it from the DS default
+      //   2. theme-primary-light (global brand color configured in Settings)
+      //   3. DS hard-coded default for the area
+      const areaSpecificColor = values[`pdf-${area}-color`] as string;
+      const primaryColor: string =
+        (areaSpecificColor && areaSpecificColor !== defaults.primary)
+          ? areaSpecificColor
+          : (values['theme-primary-light'] as string) || defaults.primary;
+
+      const areaDefault =
+        primaryColor === defaults.primary
+          ? defaults
+          : { ...defaults, primary: primaryColor };
+
+      // Use pdf-logo if set, otherwise fall back to the system image-url setting.
+      // Relative paths (e.g. /logo.svg) are resolved to absolute so Playwright can fetch them.
+      const rawLogoUrl: string =
+        (values['pdf-logo'] as string) ||
+        (values['image-url'] as string) ||
+        '';
+      const logoOverride = rawLogoUrl ? this.resolveUrl(rawLogoUrl) : '';
+
+      return {
+        area,
+        companyName:
+          (values['pdf-company-name'] as string) ||
+          (values['system-name'] as string) ||
+          'hcode',
+        logoOverride,
+        primaryColor: areaDefault.primary,
+        darkColor: areaDefault.dark,
+        lightColor: areaDefault.light,
+      };
+    } catch {
+      this.logger.warn(
+        `Could not load PDF settings from SettingService – using Design System defaults for area "${area}".`,
+      );
+      return {
+        area,
+        companyName: 'hcode',
+        logoOverride: '',
+        primaryColor: defaults.primary,
+        darkColor: defaults.dark,
+        lightColor: defaults.light,
+      };
+    }
+  }
+
+  /**
+   * Resolves a potentially relative URL (e.g. /logo.svg) to an absolute URL
+   * using the API base URL derived from environment variables.
+   */
+  private resolveUrl(url: string): string {
+    if (!url) return '';
+    if (
+      url.startsWith('data:') ||
+      url.startsWith('http://') ||
+      url.startsWith('https://')
+    ) {
+      return url;
+    }
+    const port = this.configService.get<string | number>('PORT') ?? 3100;
+    const baseUrl =
+      this.configService.get<string>('API_URL') ??
+      `http://localhost:${port}`;
+    return (
+      baseUrl.replace(/\/$/, '') +
+      (url.startsWith('/') ? url : '/' + url)
+    );
+  }
+
+  // ── HTML → PDF ────────────────────────────────────────────────────────────
+
+  /**
+   * Renders an HTML string to a PDF buffer using Playwright/Chromium.
+   *
+   * Uses dynamic `import()` via `new Function` to remain compatible with
+   * CommonJS bundle output (same pattern as operations.service.ts).
+   */
+  async generatePdfFromHtml(html: string, options: PdfGenerateOptions = {}): Promise<Buffer> {
+    const executablePath = this.configService.get<string>('CHROMIUM_EXECUTABLE_PATH');
+    const noSandbox = this.configService.get<string>('CHROMIUM_NO_SANDBOX') === 'true';
+
+    const launchArgs = noSandbox
+      ? ['--no-sandbox', '--disable-setuid-sandbox', '--disable-dev-shm-usage']
+      : [];
+
+    let browser: any = null;
+
+    try {
+      const importPlaywright = new Function(
+        'moduleName',
+        'return import(moduleName);',
+      ) as (moduleName: string) => Promise<any>;
+
+      const playwright = await importPlaywright('playwright');
+
+      browser = await playwright.chromium.launch({
+        headless: true,
+        ...(executablePath ? { executablePath } : {}),
+        args: launchArgs,
+      });
+
+      const page = await browser.newPage();
+
+      // A4 viewport for proper page layout
+      await page.setViewportSize({ width: 794, height: 1123 });
+      await page.setContent(html, { waitUntil: 'networkidle' });
+
+      const pdfBuffer = await page.pdf({
+        format: options.format ?? 'A4',
+        printBackground: options.printBackground ?? true,
+        landscape: options.landscape ?? false,
+        margin: options.margin ?? { top: '0', right: '0', bottom: '0', left: '0' },
+      });
+
+      return Buffer.from(pdfBuffer);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      const errorStack = error instanceof Error ? (error.stack ?? errorMessage) : String(error);
+
+      const missingRuntime =
+        /Cannot find package ['"]playwright['"]|Cannot find module ['"]playwright['"]|Executable doesn't exist|browserType\.launch|Failed to launch|Please run the following command/i.test(
+          errorMessage,
+        );
+
+      this.logger.error(`PDF generation failed. ${errorMessage}`, errorStack);
+
+      if (missingRuntime) {
+        throw new InternalServerErrorException(
+          'Playwright runtime is not available. Run `npx playwright install chromium` in apps/api.',
+        );
+      }
+
+      throw new InternalServerErrorException(`PDF generation failed: ${errorMessage}`);
+    } finally {
+      if (browser) {
+        try {
+          await browser.close();
+        } catch {
+          // Ignore close errors
+        }
+      }
+    }
+  }
+
+  // ── Template engine ───────────────────────────────────────────────────────
+
+  /**
+   * Generates a PDF from a named template and structured data.
+   * The theme is resolved automatically from `data.area` via SettingService.
+   */
+  async generatePdfFromTemplate(
+    templateName: string,
+    data: Record<string, any>,
+    options?: PdfGenerateOptions,
+  ): Promise<Buffer> {
+    const area = (data.area as PdfAreaType) ?? 'consulting';
+    const themeConfig = await this.loadThemeConfig(area);
+
+    let html: string;
+
+    switch (templateName) {
+      case 'hcode-institutional':
+        html = hcodeInstitutionalTemplate(data as any, themeConfig);
+        break;
+      default:
+        throw new InternalServerErrorException(
+          `Unknown PDF template: "${templateName}". Available: hcode-institutional`,
+        );
+    }
+
+    return this.generatePdfFromHtml(html, options);
+  }
+}

package/src/pdf/templates/hcode-institutional.template.ts

@@ -0,0 +1,122 @@
+import {
+    coverPage,
+    CoverPageData,
+    dataTable,
+    FeatureCardData,
+    featureCards,
+    metadataBlock,
+    pageAccentBar,
+    pageHeader,
+    pageShell,
+    pdfFooter,
+    purposeBlock,
+    sectionHeader,
+    signatureArea,
+} from '../components';
+import { PdfThemeConfig } from '../interfaces/pdf-theme-config.interface';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Data contract
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface HcodeInstitutionalData {
+  area?: 'consulting' | 'training' | 'research';
+  title: string;
+  subtitle?: string;
+  /** Long-form description rendered as purpose block (primary-color background) */
+  description?: string;
+  features?: FeatureCardData[];
+  tableHeaders?: string[];
+  tableRows?: string[][];
+  metadata?: Array<{ label: string; value: string }>;
+  signatories?: Array<{ label: string; name?: string }>;
+  /** Override the bottom meta line on the cover (default: "HCODE · CNPJ 24.700.731/0001-08") */
+  coverMeta?: string;
+  /** Override the page title shown in the repeating header */
+  pageTitle?: string;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Template
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * hcode Institutional template — Design System v1.0
+ *
+ * Structure:
+ *   Page 1 — Full-bleed cover (break-after)
+ *   Page 2+ — accent bar + header + content sections
+ *
+ * All sections are optional; only present when the corresponding data
+ * field is provided and non-empty.
+ */
+export function hcodeInstitutionalTemplate(
+  data: HcodeInstitutionalData,
+  config: PdfThemeConfig,
+): string {
+  const coverData: CoverPageData = {
+    title: data.title,
+    subtitle: data.subtitle,
+    bottomMeta: data.coverMeta,
+  };
+
+  const pageTitle = data.pageTitle ?? `${config.area.toUpperCase()} · ${data.title}`;
+
+  // ── Content sections ──────────────────────────────────────────────────────
+  const sections: string[] = [];
+
+  // Purpose block (description)
+  if (data.description) {
+    sections.push(
+      purposeBlock(
+        'SOBRE O PROJETO',
+        config.companyName.toUpperCase(),
+        data.description,
+      ),
+    );
+  }
+
+  // Feature cards
+  if (data.features && data.features.length > 0) {
+    sections.push(sectionHeader('DIFERENCIAIS', 'O que entregamos'));
+    sections.push(featureCards(data.features));
+  }
+
+  // Data table
+  if (
+    data.tableHeaders &&
+    data.tableHeaders.length > 0 &&
+    data.tableRows &&
+    data.tableRows.length > 0
+  ) {
+    sections.push(sectionHeader('EXECUÇÃO', 'Plano de trabalho'));
+    sections.push(dataTable(data.tableHeaders, data.tableRows));
+  }
+
+  // Metadata block
+  if (data.metadata && data.metadata.length > 0) {
+    sections.push(metadataBlock(data.metadata));
+  }
+
+  // Signature area
+  if (data.signatories && data.signatories.length > 0) {
+    sections.push(sectionHeader('ACEITE', 'Assinaturas'));
+    sections.push(signatureArea(data.signatories));
+  }
+
+  // ── Assembly ──────────────────────────────────────────────────────────────
+  const body = [
+    // Page 1: cover
+    coverPage(config, coverData),
+
+    // Page 2+: content
+    pageAccentBar(),
+    pageHeader(config, pageTitle),
+    `<div class="page-content">${sections.join('\n')}</div>`,
+
+    // Fixed footer (appears on every page including cover)
+    pdfFooter(config.companyName),
+  ].join('\n');
+
+  return pageShell('', body, config);
+}