@elevasis/core 0.1.0

package/src/business/pdf/server/__tests__/pdfmake-test.ts

@@ -0,0 +1,219 @@
+/**
+ * pdfmake PDF Generation Test
+ *
+ * Tests that pdfmake can generate PDFs in this environment.
+ * This is a verification test before full migration from @react-pdf/renderer.
+ *
+ * Run with: npx tsx packages/core/src/pdf/server/__tests__/pdfmake-test.ts
+ */
+import { writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+import type { PDFDocument } from '../../types'
+import { PdfMakeService } from '../pdfmake-service'
+
+// Mock storage service for testing (matches real StorageService interface)
+const mockStorageService = {
+  async upload(params: { organizationId: string; bucket: string; path: string; file: Buffer; contentType: string; upsert?: boolean }) {
+    const size = params.file.byteLength
+    console.log(`[mock-storage] Would upload ${size} bytes to ${params.organizationId}/${params.bucket}/${params.path}`)
+    return {
+      path: params.path,
+      fullPath: `${params.organizationId}/${params.path}`,
+      size
+    }
+  },
+  async createSignedUrl(params: { organizationId: string; bucket: string; path: string; expiresIn: number }) {
+    console.log(`[mock-storage] Creating signed URL for ${params.bucket}/${params.path} (expires in ${params.expiresIn}s)`)
+    return {
+      signedUrl: `https://mock.storage/${params.bucket}/${params.organizationId}/${params.path}?token=mock`,
+      path: params.path,
+      expiresAt: new Date(Date.now() + params.expiresIn * 1000)
+    }
+  }
+}
+
+// Sample document matching the PDFDocument schema
+const sampleDocument: PDFDocument = {
+  metadata: {
+    title: 'pdfmake Test Document',
+    author: 'Elevasis Platform'
+  },
+  pages: [
+    // Page 1: Cover page
+    {
+      sections: [
+        { type: 'text', content: 'ELEVASIS', variant: 'coverVertical' },
+        { type: 'text', content: 'Automation Solutions Proposal', variant: 'coverScope' },
+        { type: 'text', content: 'Le Development LLC', variant: 'coverSolutions' }
+      ],
+      footer: false,
+      cover: {
+        bottomLeft: [
+          { type: 'text', content: 'Prepared for', variant: 'caption' },
+          { type: 'text', content: 'Alexander Le', variant: 'body' }
+        ],
+        bottomRight: [
+          { type: 'text', content: 'January 2026', variant: 'caption' }
+        ]
+      }
+    },
+    // Page 2: Executive summary with metrics
+    {
+      sections: [
+        { type: 'text', content: 'Executive Summary', variant: 'title' },
+        { type: 'text', content: 'This proposal outlines automation solutions designed to streamline your operations and reduce manual workload.', variant: 'body' },
+        {
+          type: 'card',
+          title: 'Key Metrics',
+          variant: 'accent',
+          content: [
+            { type: 'metric', value: '$51,506', label: 'Projected Annual Savings' },
+            { type: 'metric', value: '16.1 hrs', label: 'Hours Reclaimed Weekly' }
+          ]
+        }
+      ],
+      header: { title: 'Executive Summary' },
+      footer: true
+    },
+    // Page 3: Bottlenecks analysis
+    {
+      sections: [
+        { type: 'text', content: 'Current Bottlenecks', variant: 'title' },
+        {
+          type: 'list',
+          items: [
+            { text: 'Manual client reporting - 15 hrs/week', highlight: true },
+            { text: 'Invoice generation and follow-up - 8 hrs/week', highlight: true },
+            'Email campaign management',
+            'Data entry across platforms'
+          ]
+        },
+        {
+          type: 'table',
+          headers: ['Bottleneck', 'Hours/Week', 'Annual Cost'],
+          rows: [
+            ['Client Reporting', '15', '$50,700'],
+            ['Invoice Management', '8', '$22,880'],
+            ['Total', '23', '$73,580']
+          ]
+        }
+      ],
+      header: { title: 'Analysis' },
+      footer: true
+    },
+    // Page 4: Solutions with cards
+    {
+      sections: [
+        { type: 'text', content: 'Proposed Solutions', variant: 'title' },
+        {
+          type: 'card',
+          title: 'Solution 1: Automated Reporting',
+          content: [
+            { type: 'text', content: 'Automated data aggregation from multiple sources into unified client reports.', variant: 'body' },
+            { type: 'list', items: ['Real-time data sync', 'Custom templates', 'Scheduled delivery'] }
+          ]
+        },
+        {
+          type: 'card',
+          title: 'Solution 2: Invoice Automation',
+          content: [
+            { type: 'text', content: 'End-to-end invoice generation with automatic follow-ups and payment tracking.', variant: 'body' },
+            { type: 'list', items: ['Auto-generation', 'Payment reminders', 'Cash flow analytics'], ordered: true }
+          ]
+        }
+      ],
+      header: { title: 'Solutions' },
+      footer: true
+    }
+  ]
+}
+
+async function runTest() {
+  console.log('========================================')
+  console.log('pdfmake PDF Generation Test')
+  console.log('========================================')
+  console.log('')
+
+  try {
+    // Test 1: Create service
+    console.log('[TEST 1] Creating PdfMakeService...')
+    const service = new PdfMakeService(mockStorageService)
+    console.log('[TEST 1] ✅ Service created successfully')
+    console.log('')
+
+    // Test 2: Render to buffer (no storage upload)
+    console.log('[TEST 2] Rendering sample document to buffer...')
+    console.log(`         Document: ${sampleDocument.pages.length} pages`)
+    console.log(`         Title: ${sampleDocument.metadata?.title}`)
+
+    const startTime = Date.now()
+    const buffer = await service.renderToBuffer({
+      organizationId: 'test-org',
+      document: sampleDocument
+    })
+    const elapsed = Date.now() - startTime
+
+    console.log(`[TEST 2] ✅ PDF rendered successfully`)
+    console.log(`         Buffer size: ${buffer.byteLength} bytes`)
+    console.log(`         Time: ${elapsed}ms`)
+    console.log('')
+
+    // Test 3: Verify it's a valid PDF (starts with %PDF-)
+    console.log('[TEST 3] Validating PDF format...')
+    const header = buffer.subarray(0, 5).toString('utf-8')
+    if (header === '%PDF-') {
+      console.log(`[TEST 3] ✅ Valid PDF header detected: ${header}`)
+    } else {
+      throw new Error(`Invalid PDF header: ${header}`)
+    }
+    console.log('')
+
+    // Test 4: Write to file for manual inspection
+    const outputPath = join(process.cwd(), 'pdfmake-test-output.pdf')
+    console.log('[TEST 4] Writing PDF to file for inspection...')
+    writeFileSync(outputPath, buffer)
+    console.log(`[TEST 4] ✅ PDF written to: ${outputPath}`)
+    console.log('')
+
+    // Test 5: Test full render with mock storage
+    console.log('[TEST 5] Testing full render with storage upload...')
+    const result = await service.render({
+      organizationId: 'test-org',
+      document: sampleDocument,
+      storage: {
+        bucket: 'test-bucket',
+        path: 'proposals/test/output.pdf'
+      }
+    })
+    console.log(`[TEST 5] ✅ Full render completed`)
+    console.log(`         Success: ${result.success}`)
+    console.log(`         Size: ${result.size} bytes`)
+    console.log(`         URL: ${result.pdfUrl}`)
+    console.log('')
+
+    console.log('========================================')
+    console.log('✅ ALL TESTS PASSED')
+    console.log('========================================')
+    console.log('')
+    console.log('pdfmake is working correctly in this environment.')
+    console.log(`Check the output PDF at: ${outputPath}`)
+    console.log('')
+
+  } catch (error) {
+    console.error('')
+    console.error('========================================')
+    console.error('❌ TEST FAILED')
+    console.error('========================================')
+    console.error('')
+    console.error('Error:', error instanceof Error ? error.message : String(error))
+    if (error instanceof Error && error.stack) {
+      console.error('')
+      console.error('Stack trace:')
+      console.error(error.stack)
+    }
+    process.exit(1)
+  }
+}
+
+// Run the test
+runTest()

package/src/business/pdf/server/index.ts

@@ -0,0 +1,21 @@
+/**
+ * PDF Server Module
+ *
+ * Server-side PDF generation using pdfmake.
+ *
+ * For browser PDF generation, use `@repo/core/pdf/browser` instead.
+ *
+ * @example
+ * // Server-side PDF generation (Node.js only)
+ * import { PdfMakeService } from '@repo/core/pdf/server/pdfmake-service'
+ *
+ * // Themes (browser-safe, also available from @repo/core/pdf)
+ * import { defaultTheme } from '@repo/core/pdf/server'
+ */
+
+// Re-export themes (browser-safe, from shared location)
+export * from './themes'
+
+// NOTE: PdfMakeService is NOT re-exported here because it has Node.js-only imports
+// (createRequire from 'module', stream) that cause build errors in browser environments.
+// Import directly: import { PdfMakeService } from '@repo/core/pdf/server/pdfmake-service'

package/src/business/pdf/server/pdfmake-service.ts

@@ -0,0 +1,237 @@
+/**
+ * PDF Service (pdfmake) - Server
+ *
+ * Server-side PDF rendering using pdfmake.
+ * Converts PDFDocument schema to pdfmake format and uploads to storage.
+ *
+ * Key differences from React-PDF:
+ * - No React reconciler dependency (avoids React 19 async scheduling issues)
+ * - Declarative JSON-based document definition
+ * - Pure JavaScript, no JSX needed
+ *
+ * Uses shared conversion logic from ../shared/convert.ts for consistency
+ * with the browser service.
+ *
+ * @see https://pdfmake.github.io/docs/
+ */
+import { createRequire } from 'module'
+import type { Readable } from 'stream'
+import type { TDocumentDefinitions } from 'pdfmake/interfaces'
+
+// Server-side pdfmake exports PdfPrinter class directly (CommonJS module)
+const require = createRequire(import.meta.url)
+const PdfPrinter = require('pdfmake') as new (fonts: Record<string, FontDef>) => PdfPrinterInstance
+
+// Import Roboto fonts from pdfmake's vfs_fonts (base64 encoded)
+const vfsFonts = require('pdfmake/build/vfs_fonts') as Record<string, string>
+
+import { defaultTheme } from '../themes'
+import type { PDFTheme } from '../themes'
+import type { PDFDocument } from '../types'
+import { convertDocument } from '../shared/convert'
+
+// ============================================================================
+// Server-side pdfmake types (not in @types/pdfmake which is browser-focused)
+// ============================================================================
+
+interface FontDef {
+  normal: string | Buffer
+  bold: string | Buffer
+  italics: string | Buffer
+  bolditalics: string | Buffer
+}
+
+interface PdfPrinterInstance {
+  createPdfKitDocument(docDefinition: TDocumentDefinitions): Readable & { end(): void }
+}
+
+// ============================================================================
+// Font Configuration
+// ============================================================================
+
+// Convert base64 font data from vfs_fonts to Buffers for server-side use
+// This gives us Roboto fonts consistent with browser rendering
+const fonts: Record<string, FontDef> = {
+  Roboto: {
+    normal: Buffer.from(vfsFonts['Roboto-Regular.ttf'], 'base64'),
+    bold: Buffer.from(vfsFonts['Roboto-Medium.ttf'], 'base64'),
+    italics: Buffer.from(vfsFonts['Roboto-Italic.ttf'], 'base64'),
+    bolditalics: Buffer.from(vfsFonts['Roboto-MediumItalic.ttf'], 'base64')
+  },
+  // Keep standard PDF fonts as fallbacks
+  Helvetica: {
+    normal: 'Helvetica',
+    bold: 'Helvetica-Bold',
+    italics: 'Helvetica-Oblique',
+    bolditalics: 'Helvetica-BoldOblique'
+  },
+  Courier: {
+    normal: 'Courier',
+    bold: 'Courier-Bold',
+    italics: 'Courier-Oblique',
+    bolditalics: 'Courier-BoldOblique'
+  },
+  Times: {
+    normal: 'Times-Roman',
+    bold: 'Times-Bold',
+    italics: 'Times-Italic',
+    bolditalics: 'Times-BoldItalic'
+  }
+}
+
+// Create printer instance with font configuration
+const printer = new PdfPrinter(fonts)
+
+// ============================================================================
+// Stream to Buffer Helper
+// ============================================================================
+
+/**
+ * Converts a readable stream to a Buffer
+ */
+function streamToBuffer(stream: Readable): Promise<Buffer> {
+  return new Promise((resolve, reject) => {
+    const chunks: Buffer[] = []
+    stream.on('data', (chunk: Buffer) => chunks.push(chunk))
+    stream.on('end', () => resolve(Buffer.concat(chunks)))
+    stream.on('error', reject)
+  })
+}
+
+// ============================================================================
+// Storage Service Interface
+// ============================================================================
+
+/**
+ * Storage service interface for PDF uploads
+ * Compatible with apps/api/src/storage/service.ts (StorageService)
+ */
+export interface IStorageService {
+  upload(params: {
+    organizationId: string
+    bucket: string
+    path: string
+    file: Buffer | Blob
+    contentType: string
+    upsert?: boolean
+  }): Promise<{ path: string; fullPath: string; size: number }>
+
+  createSignedUrl(params: {
+    organizationId: string
+    bucket: string
+    path: string
+    expiresIn: number
+  }): Promise<{ signedUrl: string; path: string; expiresAt: Date }>
+}
+
+// ============================================================================
+// Service Types
+// ============================================================================
+
+/**
+ * Parameters for PDF rendering
+ */
+export interface PdfMakeRenderParams {
+  organizationId: string
+  document: PDFDocument
+  theme?: Partial<PDFTheme>
+  storage: {
+    bucket: string
+    path: string
+  }
+}
+
+/**
+ * Result of PDF rendering
+ */
+export interface PdfMakeRenderResult {
+  success: boolean
+  pdfUrl: string
+  size: number
+}
+
+// ============================================================================
+// PDF Service Class
+// ============================================================================
+
+/**
+ * PdfMakeService
+ *
+ * Service class for rendering PDF documents using pdfmake and uploading to storage.
+ * Uses constructor injection for the storage service dependency.
+ */
+export class PdfMakeService {
+  constructor(private storageService: IStorageService) {}
+
+  /**
+   * Renders a PDF document and uploads to storage
+   *
+   * @param params - Render parameters including document, theme, and storage config
+   * @returns Result with success status, PDF URL, and file size
+   */
+  async render(params: PdfMakeRenderParams): Promise<PdfMakeRenderResult> {
+    const { document, theme: themeOverride, storage } = params
+
+    // Merge theme with defaults
+    const theme: PDFTheme = themeOverride
+      ? { ...defaultTheme, ...themeOverride }
+      : defaultTheme
+
+    // Convert to pdfmake document definition
+    const docDefinition = convertDocument(document, theme)
+
+    // Create PDF and get buffer using server-side API
+    const pdfDoc = printer.createPdfKitDocument(docDefinition)
+    // Must call end() BEFORE awaiting the stream - this signals the PDF is complete
+    pdfDoc.end()
+    const buffer = await streamToBuffer(pdfDoc)
+
+    // Upload to storage
+    await this.storageService.upload({
+      organizationId: params.organizationId,
+      bucket: storage.bucket,
+      path: storage.path,
+      file: buffer,
+      contentType: 'application/pdf',
+      upsert: true // Allow overwriting existing files
+    })
+
+    // Create signed URL for accessing the PDF (24 hour expiry)
+    const urlResult = await this.storageService.createSignedUrl({
+      organizationId: params.organizationId,
+      bucket: storage.bucket,
+      path: storage.path,
+      expiresIn: 86400 // 24 hours
+    })
+
+    return {
+      success: true,
+      pdfUrl: urlResult.signedUrl,
+      size: buffer.byteLength,
+    }
+  }
+
+  /**
+   * Renders a PDF document to a buffer (for testing without storage)
+   *
+   * @param params - Render parameters including document and theme
+   * @returns Buffer containing the PDF
+   */
+  async renderToBuffer(params: Omit<PdfMakeRenderParams, 'storage'>): Promise<Buffer> {
+    const { document, theme: themeOverride } = params
+
+    // Merge theme with defaults
+    const theme: PDFTheme = themeOverride
+      ? { ...defaultTheme, ...themeOverride }
+      : defaultTheme
+
+    // Convert to pdfmake document definition
+    const docDefinition = convertDocument(document, theme)
+
+    // Create PDF and get buffer using server-side API
+    const pdfDoc = printer.createPdfKitDocument(docDefinition)
+    // Must call end() BEFORE awaiting the stream - this signals the PDF is complete
+    pdfDoc.end()
+    return streamToBuffer(pdfDoc)
+  }
+}

package/src/business/pdf/server/themes/default.ts

@@ -0,0 +1,8 @@
+/**
+ * Default PDF Theme
+ *
+ * Re-exports from shared themes for backwards compatibility.
+ * New code should import from '@repo/core/pdf' directly.
+ */
+
+export { defaultTheme } from '../../themes'

package/src/business/pdf/server/themes/index.ts

@@ -0,0 +1,9 @@
+/**
+ * PDF Themes
+ *
+ * Theme configuration for PDF document generation.
+ * Re-exports theme types and the default theme.
+ */
+
+export * from './types'
+export { defaultTheme } from './default'

package/src/business/pdf/server/themes/types.ts

@@ -0,0 +1,8 @@
+/**
+ * PDF Theme Types
+ *
+ * Re-exports from shared themes for backwards compatibility.
+ * New code should import from '@repo/core/pdf' directly.
+ */
+
+export type { PDFTheme } from '../../themes'