tailprint 0.0.0-stage → 1.0.0

package/dist/server.js

@@ -0,0 +1,206 @@
+import Fastify from 'fastify';
+import swagger from '@fastify/swagger';
+import scalarFastifyApiReference from '@scalar/fastify-api-reference';
+import fastifyRawBody from 'fastify-raw-body';
+import { serializerCompiler, validatorCompiler, jsonSchemaTransform, hasZodFastifySchemaValidationErrors, } from 'fastify-type-provider-zod';
+import { env } from './config/env.js';
+import { renderRoutes } from './routes/render.js';
+import { webhookRoutes } from './routes/webhooks.js';
+import { templateRoutes } from './routes/templates.js';
+import { dashboardRoutes } from './routes/dashboard.js';
+import { scrapeRoutes } from './routes/scrape.js';
+import { mcpRoutes } from './routes/mcp.js';
+import { usageRoutes } from './routes/usage.js';
+import { browserService, RenderTimeoutError } from './services/browser.js';
+import { redisService } from './services/redis.js';
+export async function buildApp() {
+    const fastify = Fastify({
+        logger: env.NODE_ENV !== 'test' ? {
+            level: env.NODE_ENV === 'production' ? 'info' : 'debug',
+        } : false,
+    });
+    // 1. Zod type provider integration
+    fastify.setValidatorCompiler(validatorCompiler);
+    fastify.setSerializerCompiler(serializerCompiler);
+    // 2. Raw body plugin (for Stripe signature validation)
+    await fastify.register(fastifyRawBody, {
+        field: 'rawBody',
+        global: false,
+        encoding: 'utf8',
+        runFirst: true,
+    });
+    // 3. Swagger OpenAPI 3.1 specification
+    await fastify.register(swagger, {
+        openapi: {
+            openapi: '3.1.0',
+            info: {
+                title: 'Tailprint API',
+                version: '1.0.0',
+                description: 'Tailprint is the high-performance Tailwind-Native Render & PDF Engine + AI Web Scraper (https://tailprint.com).\n\n' +
+                    'Convert HTML styled with Tailwind CSS into pixel-perfect PDF documents and Open Graph preview images. Scrape any public URL into token-efficient Markdown for LLMs with 90%+ context savings.\n\n' +
+                    '### Authentication\n' +
+                    'All requests to `/v1/...` require an API key passed in the Authorization header:\n' +
+                    '```http\n' +
+                    'Authorization: Bearer sec_live_...\n' +
+                    '```\n' +
+                    'To obtain an API key or manage your plan, visit [tailprint.com/#pricing](https://tailprint.com/#pricing) or access your [Customer Dashboard](https://tailprint.com/dashboard).\n\n' +
+                    '---\n\n' +
+                    '### 🤖 Model Context Protocol (MCP) Reference\n' +
+                    'Tailprint provides a production-grade, 100% compliant Model Context Protocol server exposing **13 Native Tools** across local stdio and remote Server-Sent Events (SSE):\n\n' +
+                    '| MCP Tool | Category | Returns | Purpose |\n' +
+                    '|---|---|---|---|\n' +
+                    '| `render_pdf` | Documents | PDF Link + Base64 | Renders Tailwind HTML or public URL into vector PDF with headers/footers & encryption. |\n' +
+                    '| `render_image` | Open Graph | Inline PNG + CDN Link | Renders Open Graph social preview cards from Tailwind CSS. |\n' +
+                    '| `render_chart` | Data Visuals | Inline PNG + CDN Link | High-DPI bar, line, radar, doughnut, and pie charts with Chart.js. |\n' +
+                    '| `generate_qr` | Utilities | Inline PNG + CDN Link | Mathematically verified scan-ready QR codes and barcodes. |\n' +
+                    '| `render_device_mockup` | Marketing | Inline PNG + CDN Link | Wraps any URL into a MacBook Pro + floating iPhone 16 studio mockup canvas. |\n' +
+                    '| `stamp_pdf` | Security | PDF Link + Base64 | Stamps diagonal watermarks (CONFIDENTIAL, DRAFT, FORTROLIGT) across all PDF pages. |\n' +
+                    '| `compare_snapshots` | QA / Testing | Inline PNG + CDN Link | 3-panel visual regression diff heatmap highlighting layout shifts with neon-pink overlay. |\n' +
+                    '| `render_carousel` | Social Media | LinkedIn PDF + PNG Cover | Multi-slide 1080x1350 px portrait carousels for LinkedIn and Instagram. |\n' +
+                    '| `generate_einvoice` | Compliance / EU | Hybrid PDF + Factur-X XML | Generates EU-compliant hybrid e-invoices (Factur-X / ZUGFeRD / EN 16931) with embedded CII XML. |\n' +
+                    '| `scrape_markdown` | AI Ingestion | Clean Markdown | Scrapes any web URL, stripping cookie walls and ads with 90%+ token savings. |\n' +
+                    '| `render_template` | Automation | PDF / PNG + CDN Link | Directly renders 8 pre-built Tailwind templates with data substitution. |\n' +
+                    '| `list_templates` | Automation | JSON Catalog | Lists all available templates in the Tailprint catalog. |\n' +
+                    '| `get_template_source` | Automation | HTML Source | Retrieves full template source code for LLM inspection and customization. |\n\n' +
+                    '#### Connecting Claude Desktop\n' +
+                    'Add this configuration to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n' +
+                    '```json\n' +
+                    '{\n' +
+                    '  "mcpServers": {\n' +
+                    '    "tailprint": {\n' +
+                    '      "command": "npx",\n' +
+                    '      "args": ["-y", "tailprint"],\n' +
+                    '      "env": {\n' +
+                    '        "TAILPRINT_API_KEY": "sec_live_your_key_here"\n' +
+                    '      }\n' +
+                    '    }\n' +
+                    '  }\n' +
+                    '}\n' +
+                    '```\n\n' +
+                    '#### Remote SSE Endpoint\n' +
+                    'Connect remote AI runtimes directly to `GET https://tailprint.com/v1/mcp/sse?api_key=sec_live_...`.',
+                contact: {
+                    name: 'Tailprint Support',
+                    url: 'https://tailprint.com',
+                    email: 'support@tailprint.com',
+                },
+            },
+            servers: [
+                {
+                    url: 'https://tailprint.com',
+                    description: 'Production Server (HTTPS)',
+                },
+                {
+                    url: 'https://api.tailprint.com',
+                    description: 'Production API Subdomain (HTTPS)',
+                },
+                {
+                    url: `http://${env.HOST === '0.0.0.0' ? 'localhost' : env.HOST}:${env.PORT}`,
+                    description: 'Local Development Server',
+                },
+            ],
+            components: {
+                securitySchemes: {
+                    bearerAuth: {
+                        type: 'http',
+                        scheme: 'bearer',
+                        bearerFormat: 'API Key',
+                        description: 'Provide your API key in the format: Bearer sec_live_...',
+                    },
+                },
+            },
+        },
+        transform: jsonSchemaTransform,
+    });
+    // 4. Scalar interactive documentation on /docs with dark mode
+    await fastify.register(scalarFastifyApiReference, {
+        routePrefix: '/docs',
+        configuration: {
+            theme: 'purple',
+            darkMode: true,
+            metaData: {
+                title: 'Tailprint API Reference',
+                description: 'Official API documentation and interactive test console for Tailprint (https://tailprint.com)',
+            },
+        },
+    });
+    // Health check endpoint
+    fastify.get('/health', {
+        schema: {
+            tags: ['System'],
+            summary: 'Service Health Check',
+            description: 'Returns health status and connected subsystems status.',
+        },
+    }, async () => {
+        return {
+            status: 'ok',
+            timestamp: new Date().toISOString(),
+            redisFallback: redisService.isMemoryFallback,
+            uptime: process.uptime(),
+        };
+    });
+    // 5. Register application routes
+    await fastify.register(templateRoutes);
+    await fastify.register(dashboardRoutes);
+    await fastify.register(renderRoutes);
+    await fastify.register(scrapeRoutes);
+    await fastify.register(mcpRoutes);
+    await fastify.register(usageRoutes);
+    await fastify.register(webhookRoutes);
+    // 6. Centralized Error Handler
+    fastify.setErrorHandler((error, request, reply) => {
+        request.log.error({ err: error }, 'Request processing error');
+        // Handle Strict Playwright Timeout
+        if (error instanceof RenderTimeoutError || error?.name === 'RenderTimeoutError') {
+            return reply.code(504).send({
+                statusCode: 504,
+                error: 'Gateway Timeout',
+                message: error?.message || `Render processing exceeded strict timeout limit of ${env.RENDER_TIMEOUT_MS}ms`,
+            });
+        }
+        // Handle Zod Validation Errors
+        if (hasZodFastifySchemaValidationErrors(error)) {
+            return reply.code(400).send({
+                statusCode: 400,
+                error: 'Bad Request',
+                message: 'Validation failed for request input',
+                details: error.validation,
+            });
+        }
+        // Pass through explicit Fastify HTTP error status
+        const statusCode = error?.statusCode && error.statusCode >= 400 && error.statusCode < 600
+            ? error.statusCode
+            : 500;
+        return reply.code(statusCode).send({
+            statusCode,
+            error: error?.name || 'Internal Server Error',
+            message: error?.message || 'An unexpected error occurred during rendering',
+        });
+    });
+    // Graceful browser shutdown
+    fastify.addHook('onClose', async () => {
+        await browserService.close();
+    });
+    return fastify;
+}
+// Start server if executed directly
+if (process.env.NODE_ENV !== 'test') {
+    const start = async () => {
+        try {
+            const app = await buildApp();
+            // Pre-warm Chromium pool in the background
+            browserService.init().catch((err) => {
+                app.log.warn({ err }, 'Failed to pre-warm Chromium browser during boot');
+            });
+            await app.listen({ port: env.PORT, host: env.HOST });
+            app.log.info(`🚀 Tailprint running on http://${env.HOST}:${env.PORT}`);
+            app.log.info(`📖 Scalar API Documentation available at http://${env.HOST}:${env.PORT}/docs`);
+        }
+        catch (err) {
+            console.error('Fatal startup error:', err);
+            process.exit(1);
+        }
+    };
+    start();
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/services/browser.d.ts

@@ -0,0 +1,21 @@
+import type { RenderPdfRequest, RenderImageRequest } from '../schemas/render.js';
+export declare class RenderTimeoutError extends Error {
+    constructor(message?: string);
+}
+export declare class BrowserService {
+    private static instance;
+    private browser;
+    private limit;
+    private isInitializing;
+    private constructor();
+    static getInstance(): BrowserService;
+    init(): Promise<void>;
+    close(): Promise<void>;
+    private isPrivateOrBlockedUrl;
+    private setupSsrfProtection;
+    private prepareHtmlWithTailwind;
+    private executeWithTimeout;
+    renderPdf(params: RenderPdfRequest): Promise<Buffer>;
+    renderImage(params: RenderImageRequest): Promise<Buffer>;
+}
+export declare const browserService: BrowserService;

package/dist/services/browser.js

@@ -0,0 +1,299 @@
+import { chromium } from 'playwright';
+import pLimit from 'p-limit';
+import { encryptPDF } from 'cryptpdf';
+import { env } from '../config/env.js';
+export class RenderTimeoutError extends Error {
+    constructor(message = `Rendering exceeded timeout of ${env.RENDER_TIMEOUT_MS}ms`) {
+        super(message);
+        this.name = 'RenderTimeoutError';
+    }
+}
+export class BrowserService {
+    static instance = null;
+    browser = null;
+    limit = pLimit(env.CONCURRENCY_LIMIT);
+    isInitializing = false;
+    constructor() { }
+    static getInstance() {
+        if (!BrowserService.instance) {
+            BrowserService.instance = new BrowserService();
+        }
+        return BrowserService.instance;
+    }
+    async init() {
+        if (this.browser)
+            return;
+        if (this.isInitializing) {
+            while (this.isInitializing) {
+                await new Promise((r) => setTimeout(r, 50));
+            }
+            return;
+        }
+        this.isInitializing = true;
+        try {
+            this.browser = await chromium.launch({
+                headless: true,
+                args: [
+                    '--no-sandbox',
+                    '--disable-setuid-sandbox',
+                    '--disable-dev-shm-usage',
+                    '--disable-gpu',
+                    '--no-first-run',
+                    '--no-zygote',
+                ],
+            });
+        }
+        finally {
+            this.isInitializing = false;
+        }
+    }
+    async close() {
+        if (this.browser) {
+            await this.browser.close();
+            this.browser = null;
+        }
+    }
+    isPrivateOrBlockedUrl(rawUrl) {
+        try {
+            const parsed = new URL(rawUrl);
+            // Only allow http, https, data, and blob schemes
+            if (!['http:', 'https:', 'data:', 'blob:'].includes(parsed.protocol)) {
+                return true;
+            }
+            if (parsed.protocol === 'data:' || parsed.protocol === 'blob:') {
+                return false;
+            }
+            const hostname = parsed.hostname.toLowerCase();
+            // Check localhost and local hostnames
+            if (hostname === 'localhost' ||
+                hostname.endsWith('.localhost') ||
+                hostname.endsWith('.local') ||
+                hostname.endsWith('.internal')) {
+                return true;
+            }
+            // Check IPv4 private and link-local ranges
+            // 127.0.0.0/8, 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 169.254.0.0/16, 0.0.0.0/8
+            const ipv4Match = hostname.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
+            if (ipv4Match) {
+                const [, aStr, bStr] = ipv4Match;
+                const a = parseInt(aStr, 10);
+                const b = parseInt(bStr, 10);
+                if (a === 127)
+                    return true; // Loopback
+                if (a === 10)
+                    return true; // Class A private
+                if (a === 172 && b >= 16 && b <= 31)
+                    return true; // Class B private
+                if (a === 192 && b === 168)
+                    return true; // Class C private
+                if (a === 169 && b === 254)
+                    return true; // Link-local / Cloud metadata (169.254.169.254)
+                if (a === 0)
+                    return true; // 0.0.0.0/8
+            }
+            // Check IPv6 loopback / unique local
+            if (hostname === '::1' ||
+                hostname.startsWith('fe80:') ||
+                hostname.startsWith('fc00:') ||
+                hostname.startsWith('fd00:')) {
+                return true;
+            }
+            return false;
+        }
+        catch {
+            return true;
+        }
+    }
+    setupSsrfProtection(page) {
+        page.route('**/*', async (route) => {
+            const request = route.request();
+            const url = request.url();
+            if (this.isPrivateOrBlockedUrl(url)) {
+                await route.abort('blockedbyclient');
+                return;
+            }
+            await route.continue();
+        });
+    }
+    prepareHtmlWithTailwind(rawHtml) {
+        const hasTailwind = rawHtml.includes('cdn.tailwindcss.com') ||
+            rawHtml.includes('@tailwindcss');
+        const tailwindScriptTag = `<script src="${env.TAILWIND_CDN_URL}"></script>`;
+        // If it's a complete HTML document
+        if (/<html[\s>]/i.test(rawHtml)) {
+            if (hasTailwind) {
+                return rawHtml;
+            }
+            if (/<head[\s>]/i.test(rawHtml)) {
+                return rawHtml.replace(/<head[\s>]/i, (match) => `${match}\n  ${tailwindScriptTag}`);
+            }
+            return rawHtml.replace(/<html[\s>]/i, (match) => `${match}\n<head>${tailwindScriptTag}</head>`);
+        }
+        // Fragment: wrap with standard HTML5 boilerplate and Tailwind
+        return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  ${tailwindScriptTag}
+</head>
+<body class="bg-white text-gray-900 antialiased">
+  ${rawHtml}
+</body>
+</html>`;
+    }
+    async executeWithTimeout(task, viewport = { width: 1200, height: 630 }) {
+        await this.init();
+        if (!this.browser) {
+            throw new Error('Browser is not initialized');
+        }
+        return this.limit(async () => {
+            let context = null;
+            let page = null;
+            let timeoutHandle = null;
+            const timeoutPromise = new Promise((_, reject) => {
+                timeoutHandle = setTimeout(() => {
+                    reject(new RenderTimeoutError(`Operation exceeded limit of ${env.RENDER_TIMEOUT_MS}ms`));
+                }, env.RENDER_TIMEOUT_MS);
+            });
+            const workPromise = (async () => {
+                try {
+                    context = await this.browser.newContext({
+                        viewport,
+                        deviceScaleFactor: 2,
+                    });
+                    page = await context.newPage();
+                    page.setDefaultTimeout(env.RENDER_TIMEOUT_MS);
+                    page.setDefaultNavigationTimeout(env.RENDER_TIMEOUT_MS);
+                    this.setupSsrfProtection(page);
+                    return await task(context, page);
+                }
+                finally {
+                    if (page) {
+                        await page.close().catch(() => { });
+                    }
+                    if (context) {
+                        await context.close().catch(() => { });
+                    }
+                }
+            })();
+            try {
+                return await Promise.race([workPromise, timeoutPromise]);
+            }
+            catch (err) {
+                if (err.name === 'TimeoutError' || err.message?.includes('Timeout')) {
+                    throw new RenderTimeoutError();
+                }
+                throw err;
+            }
+            finally {
+                if (timeoutHandle) {
+                    clearTimeout(timeoutHandle);
+                }
+            }
+        });
+    }
+    async renderPdf(params) {
+        return this.executeWithTimeout(async (_context, page) => {
+            if (params.url) {
+                await page.goto(params.url, {
+                    waitUntil: 'load',
+                    timeout: env.RENDER_TIMEOUT_MS,
+                });
+            }
+            else if (params.html) {
+                const fullHtml = this.prepareHtmlWithTailwind(params.html);
+                await page.setContent(fullHtml, {
+                    waitUntil: 'load',
+                    timeout: env.RENDER_TIMEOUT_MS,
+                });
+            }
+            else {
+                throw new Error('Either "html" or "url" must be provided');
+            }
+            // Wait for Tailwind JIT runtime and fonts
+            await Promise.all([
+                page.waitForLoadState('networkidle', { timeout: 2500 }).catch(() => { }),
+                page.evaluate(() => document.fonts?.ready).catch(() => { }),
+            ]);
+            // Dynamic selector wait if requested
+            if (params.wait_for) {
+                await page.waitForSelector(params.wait_for, { timeout: 5000 });
+            }
+            // Delay in ms before rendering (e.g. for animations/charts to settle)
+            if (params.delay_ms && params.delay_ms > 0) {
+                const cappedDelay = Math.min(params.delay_ms, 5000);
+                await new Promise((r) => setTimeout(r, cappedDelay));
+            }
+            const hasHeaderFooter = Boolean(params.display_header_footer || params.header_html || params.footer_html);
+            // Sensible default margins when headers or footers are present to avoid overlapping content
+            const defaultMargins = hasHeaderFooter
+                ? { top: '15mm', bottom: '15mm', left: '10mm', right: '10mm' }
+                : undefined;
+            const margin = params.margin
+                ? {
+                    top: params.margin.top,
+                    bottom: params.margin.bottom,
+                    left: params.margin.left,
+                    right: params.margin.right,
+                }
+                : defaultMargins;
+            let pdfBuffer = await page.pdf({
+                format: params.format,
+                landscape: params.landscape,
+                printBackground: params.print_background,
+                displayHeaderFooter: hasHeaderFooter,
+                headerTemplate: params.header_html || '<span></span>',
+                footerTemplate: params.footer_html || '<span></span>',
+                margin,
+            });
+            // Optional AES-256 PDF encryption with user and optional owner password
+            if (params.password) {
+                const encrypted = await encryptPDF(new Uint8Array(pdfBuffer), params.password, params.owner_password || params.password);
+                pdfBuffer = Buffer.from(encrypted);
+            }
+            return pdfBuffer;
+        }, { width: 1200, height: 800 });
+    }
+    async renderImage(params) {
+        return this.executeWithTimeout(async (_context, page) => {
+            if (params.url) {
+                await page.goto(params.url, {
+                    waitUntil: 'load',
+                    timeout: env.RENDER_TIMEOUT_MS,
+                });
+            }
+            else if (params.html) {
+                const fullHtml = this.prepareHtmlWithTailwind(params.html);
+                await page.setContent(fullHtml, {
+                    waitUntil: 'load',
+                    timeout: env.RENDER_TIMEOUT_MS,
+                });
+            }
+            else {
+                throw new Error('Either "html" or "url" must be provided');
+            }
+            // Wait for Tailwind JIT runtime and fonts
+            await Promise.all([
+                page.waitForLoadState('networkidle', { timeout: 2500 }).catch(() => { }),
+                page.evaluate(() => document.fonts?.ready).catch(() => { }),
+            ]);
+            // Dynamic selector wait if requested
+            if (params.wait_for) {
+                await page.waitForSelector(params.wait_for, { timeout: 5000 });
+            }
+            // Delay in ms before capturing (e.g. for animations/charts to settle)
+            if (params.delay_ms && params.delay_ms > 0) {
+                const cappedDelay = Math.min(params.delay_ms, 5000);
+                await new Promise((r) => setTimeout(r, cappedDelay));
+            }
+            const imageBuffer = await page.screenshot({
+                type: params.type,
+                fullPage: false,
+            });
+            return imageBuffer;
+        }, { width: params.width || 1200, height: params.height || 630 });
+    }
+}
+export const browserService = BrowserService.getInstance();
+//# sourceMappingURL=browser.js.map

package/dist/services/browser.js.map

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

package/dist/services/carousel.d.ts

@@ -0,0 +1,43 @@
+import { type StoredFileMetadata } from './storage.js';
+export interface CarouselSlide {
+    headline: string;
+    content: string | string[];
+    tag?: string;
+    takeaway?: string;
+    slideNumber?: number;
+}
+export interface CarouselOptions {
+    title?: string;
+    subtitle?: string;
+    author?: {
+        name: string;
+        handle?: string;
+        role?: string;
+        avatarUrl?: string;
+    };
+    theme?: 'dark' | 'light' | 'emerald' | 'gradient';
+    slides?: CarouselSlide[];
+    markdown?: string;
+}
+export interface RenderCarouselResult {
+    pdfBuffer: Buffer;
+    previewImageBuffer: Buffer;
+    slideCount: number;
+    pdfStored?: StoredFileMetadata;
+    previewStored?: StoredFileMetadata;
+}
+export declare class CarouselService {
+    private static instance;
+    private constructor();
+    static getInstance(): CarouselService;
+    /**
+     * Parses simple markdown divided by "---" into carousel slides.
+     */
+    parseMarkdownToSlides(markdown: string): CarouselSlide[];
+    /**
+     * Generates a multi-page 1080x1350 px carousel PDF (LinkedIn standard)
+     * and a high-resolution PNG preview of the cover slide.
+     */
+    renderCarousel(options: CarouselOptions): Promise<RenderCarouselResult>;
+}
+export declare const carouselService: CarouselService;