tailprint 1.3.0__py3-none-any.whl

tailprint/__init__.py

@@ -0,0 +1,21 @@
+"""Official Tailprint Python Client SDK."""
+
+from .client import Tailprint
+from .errors import (
+    AuthenticationError,
+    RateLimitError,
+    TailprintError,
+    TimeoutError,
+    ValidationError,
+)
+
+__version__ = "1.3.0"
+__all__ = [
+    "Tailprint",
+    "TailprintError",
+    "AuthenticationError",
+    "RateLimitError",
+    "ValidationError",
+    "TimeoutError",
+    "__version__",
+]

tailprint/client.py

@@ -0,0 +1,475 @@
+"""Official Tailprint Python Client SDK.
+
+High-performance Tailwind HTML to Vector PDF, EU Factur-X / ZUGFeRD E-Invoicing,
+PDF Operations (Merge, Split, Stamp, Compress, Fill Forms) & Asynchronous Batch Engine.
+
+Documentation: https://tailprint.com/docs
+"""
+
+import base64
+import hashlib
+import hmac
+import json
+import os
+import time
+import urllib.error
+import urllib.request
+from typing import Any, Dict, List, Optional, Union
+
+from .errors import (
+    AuthenticationError,
+    RateLimitError,
+    TailprintError,
+    TimeoutError,
+    ValidationError,
+)
+
+PDFInput = Union[bytes, bytearray, str]
+
+
+class Tailprint:
+    """Tailprint API Client."""
+
+    def __init__(
+        self,
+        api_key: Optional[str] = None,
+        base_url: Optional[str] = None,
+        timeout: float = 30.0,
+    ) -> None:
+        """Initialize Tailprint client.
+
+        Args:
+            api_key: Tailprint API Key (e.g. 'sec_live_...'). Defaults to TAILPRINT_API_KEY env var.
+            base_url: Base API URL. Defaults to 'https://tailprint.com'.
+            timeout: Request timeout in seconds. Defaults to 30.0.
+        """
+        self.api_key = api_key or os.environ.get("TAILPRINT_API_KEY", "")
+        self.base_url = (base_url or os.environ.get("TAILPRINT_BASE_URL", "https://tailprint.com")).rstrip("/")
+        self.timeout = timeout
+
+    def _to_base64_data_uri(self, input_val: PDFInput) -> str:
+        """Helper to convert bytes or string to data URI / URL string."""
+        if isinstance(input_val, (bytes, bytearray)):
+            b64 = base64.b64encode(input_val).decode("utf-8")
+            return f"data:application/pdf;base64,{b64}"
+        if isinstance(input_val, str):
+            if input_val.startswith("http://") or input_val.startswith("https://") or input_val.startswith("data:"):
+                return input_val
+            # Assume raw base64 string
+            return f"data:application/pdf;base64,{input_val}"
+        raise ValueError("Invalid PDF input: must be bytes or string URL/Base64")
+
+    def _request(
+        self,
+        endpoint: str,
+        method: str = "POST",
+        payload: Optional[Dict[str, Any]] = None,
+        expect_binary: bool = False,
+    ) -> Union[bytes, Dict[str, Any]]:
+        """Executes an HTTP request to the Tailprint API."""
+        url = f"{self.base_url}{endpoint}"
+        headers = {
+            "User-Agent": "Tailprint-Python-SDK/1.3.0",
+        }
+
+        if self.api_key:
+            headers["Authorization"] = f"Bearer {self.api_key}"
+
+        data: Optional[bytes] = None
+        if payload is not None:
+            headers["Content-Type"] = "application/json"
+            data = json.dumps(payload).encode("utf-8")
+
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as response:
+                content_type = response.headers.get("Content-Type", "")
+                body = response.read()
+
+                if expect_binary or "application/pdf" in content_type:
+                    return body
+
+                if body:
+                    try:
+                        return json.loads(body.decode("utf-8"))
+                    except Exception:
+                        return body
+                return {}
+
+        except urllib.error.HTTPError as err:
+            err_body = err.read().decode("utf-8") if err.fp else ""
+            msg = err.reason
+            details = None
+
+            try:
+                parsed = json.loads(err_body)
+                msg = parsed.get("message", msg)
+                details = parsed.get("details")
+            except Exception:
+                if err_body:
+                    msg = err_body
+
+            if err.code == 401:
+                raise AuthenticationError(msg, err.code, details) from err
+            elif err.code == 429:
+                raise RateLimitError(msg, err.code, details) from err
+            elif err.code == 400:
+                raise ValidationError(msg, err.code, details) from err
+            elif err.code in (408, 504):
+                raise TimeoutError(msg, err.code, details) from err
+            else:
+                raise TailprintError(msg, err.code, details) from err
+
+        except urllib.error.URLError as err:
+            raise TailprintError(f"Connection failed: {err.reason}", 503) from err
+
+    # =========================================================================
+    # CORE PDF RENDERING
+    # =========================================================================
+
+    def render_pdf(
+        self,
+        html: Optional[str] = None,
+        url: Optional[str] = None,
+        format: str = "A4",
+        landscape: bool = False,
+        print_background: bool = True,
+        margin: Optional[Dict[str, str]] = None,
+        display_header_footer: Optional[bool] = None,
+        header_html: Optional[str] = None,
+        footer_html: Optional[str] = None,
+        smart_pagination: bool = True,
+        password: Optional[str] = None,
+        owner_password: Optional[str] = None,
+        wait_for: Optional[str] = None,
+        delay_ms: Optional[int] = None,
+        block_popups: bool = False,
+        no_store: bool = False,
+        store: bool = False,
+        expires_in: str = "24h",
+    ) -> Union[bytes, Dict[str, Any]]:
+        """Renders HTML (with Tailwind CSS classes) or a public URL to vector PDF.
+
+        Args:
+            html: HTML string with Tailwind CSS utility classes.
+            url: Direct web URL to capture as vector PDF.
+            format: Paper size ('A4', 'Letter', 'Legal').
+            landscape: Landscape orientation if True.
+            margin: Dict with 'top', 'bottom', 'left', 'right' (e.g. {'top': '10mm'}).
+            store: If True, stores PDF on Tailprint CDN and returns a hosted link dict.
+
+        Returns:
+            bytes (PDF binary stream) or dict (if store=True).
+        """
+        payload: Dict[str, Any] = {
+            "format": format,
+            "landscape": landscape,
+            "print_background": print_background,
+            "smart_pagination": smart_pagination,
+            "no_store": no_store,
+            "store": store,
+            "expires_in": expires_in,
+        }
+        if html is not None:
+            payload["html"] = html
+        if url is not None:
+            payload["url"] = url
+        if margin is not None:
+            payload["margin"] = margin
+        if header_html is not None:
+            payload["header_html"] = header_html
+        if footer_html is not None:
+            payload["footer_html"] = footer_html
+        if display_header_footer is not None:
+            payload["display_header_footer"] = display_header_footer
+        if password is not None:
+            payload["password"] = password
+        if owner_password is not None:
+            payload["owner_password"] = owner_password
+        if wait_for is not None:
+            payload["wait_for"] = wait_for
+        if delay_ms is not None:
+            payload["delay_ms"] = delay_ms
+        if block_popups:
+            payload["block_popups"] = True
+
+        return self._request("/v1/render/pdf", payload=payload, expect_binary=not store)
+
+    # =========================================================================
+    # ASYNCHRONOUS & BATCH RENDERING
+    # =========================================================================
+
+    def render_pdf_async(
+        self,
+        html: Optional[str] = None,
+        url: Optional[str] = None,
+        webhook_url: Optional[str] = None,
+        webhook_headers: Optional[Dict[str, str]] = None,
+        format: str = "A4",
+        landscape: bool = False,
+        margin: Optional[Dict[str, str]] = None,
+        header_html: Optional[str] = None,
+        footer_html: Optional[str] = None,
+        smart_pagination: bool = True,
+        delay_ms: Optional[int] = None,
+        expires_in: str = "24h",
+    ) -> Dict[str, Any]:
+        """Submits a PDF rendering job asynchronously in background.
+
+        Returns immediately with a job_id and status_url.
+        """
+        payload: Dict[str, Any] = {
+            "format": format,
+            "landscape": landscape,
+            "smart_pagination": smart_pagination,
+            "async": True,
+            "expires_in": expires_in,
+        }
+        if html is not None:
+            payload["html"] = html
+        if url is not None:
+            payload["url"] = url
+        if webhook_url is not None:
+            payload["webhook_url"] = webhook_url
+        if webhook_headers is not None:
+            payload["webhook_headers"] = webhook_headers
+        if margin is not None:
+            payload["margin"] = margin
+        if header_html is not None:
+            payload["header_html"] = header_html
+        if footer_html is not None:
+            payload["footer_html"] = footer_html
+        if delay_ms is not None:
+            payload["delay_ms"] = delay_ms
+
+        res = self._request("/v1/render/pdf", payload=payload, expect_binary=False)
+        return res if isinstance(res, dict) else {}
+
+    def render_batch(
+        self,
+        items: List[Dict[str, Any]],
+        merge_output: bool = False,
+        merged_filename: str = "merged-batch.pdf",
+        webhook_url: Optional[str] = None,
+        webhook_headers: Optional[Dict[str, str]] = None,
+        expires_in: str = "24h",
+    ) -> Dict[str, Any]:
+        """Submits up to 100 documents for concurrent batch rendering with optional merging."""
+        payload: Dict[str, Any] = {
+            "items": items,
+            "merge_output": merge_output,
+            "merged_filename": merged_filename,
+            "expires_in": expires_in,
+        }
+        if webhook_url is not None:
+            payload["webhook_url"] = webhook_url
+        if webhook_headers is not None:
+            payload["webhook_headers"] = webhook_headers
+
+        res = self._request("/v1/render/batch", payload=payload, expect_binary=False)
+        return res if isinstance(res, dict) else {}
+
+    def get_job(self, job_id: str) -> Dict[str, Any]:
+        """Retrieves the live processing status, progress, and download links of a job."""
+        res = self._request(f"/v1/jobs/{job_id}", method="GET", expect_binary=False)
+        return res if isinstance(res, dict) else {}
+
+    def wait_for_job(
+        self,
+        job_id: str,
+        poll_interval: float = 1.0,
+        timeout: float = 60.0,
+    ) -> Dict[str, Any]:
+        """Polls a job until it reaches 'completed' or 'failed', or until timeout expires."""
+        start_time = time.time()
+        while time.time() - start_time < timeout:
+            job = self.get_job(job_id)
+            if job.get("status") in ("completed", "failed"):
+                return job
+            time.sleep(poll_interval)
+
+        raise TimeoutError(f"Job {job_id} did not finish within {timeout}s", 408)
+
+    # =========================================================================
+    # EUROPEAN E-INVOICING (Factur-X / ZUGFeRD / EN 16931)
+    # =========================================================================
+
+    def generate_einvoice(
+        self,
+        invoice_number: str,
+        seller: Dict[str, Any],
+        buyer: Dict[str, Any],
+        line_items: List[Dict[str, Any]],
+        currency: str = "EUR",
+        issue_date: Optional[str] = None,
+        due_date: Optional[str] = None,
+        payment_iban: Optional[str] = None,
+        payment_bic: Optional[str] = None,
+        notes: Optional[str] = None,
+        profile: str = "BASIC",
+        store: bool = False,
+        expires_in: str = "24h",
+    ) -> Union[bytes, Dict[str, Any]]:
+        """Generates a legally compliant European Factur-X / ZUGFeRD hybrid PDF/A-3 invoice with embedded XML."""
+        payload: Dict[str, Any] = {
+            "invoiceNumber": invoice_number,
+            "currency": currency,
+            "seller": seller,
+            "buyer": buyer,
+            "lineItems": line_items,
+            "profile": profile,
+            "store": store,
+            "expires_in": expires_in,
+        }
+        if issue_date:
+            payload["issueDate"] = issue_date
+        if due_date:
+            payload["dueDate"] = due_date
+        if payment_iban:
+            payload["paymentIban"] = payment_iban
+        if payment_bic:
+            payload["paymentBic"] = payment_bic
+        if notes:
+            payload["notes"] = notes
+
+        return self._request("/v1/render/einvoice", payload=payload, expect_binary=not store)
+
+    def validate_einvoice(
+        self,
+        pdf: Optional[PDFInput] = None,
+        xml: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """Inspects a PDF or XML invoice to verify compliance with European standard EN 16931."""
+        payload: Dict[str, Any] = {}
+        if pdf is not None:
+            payload["pdf"] = self._to_base64_data_uri(pdf)
+        if xml is not None:
+            payload["xml"] = xml
+
+        res = self._request("/v1/pdf/validate-einvoice", payload=payload, expect_binary=False)
+        return res if isinstance(res, dict) else {}
+
+    # =========================================================================
+    # PDF OPERATIONS (Merge, Split, Fill, Compress, Stamp)
+    # =========================================================================
+
+    def merge_pdfs(
+        self,
+        pdfs: List[PDFInput],
+        output_filename: str = "merged.pdf",
+        store: bool = False,
+        expires_in: str = "24h",
+    ) -> Union[bytes, Dict[str, Any]]:
+        """Merges two or more PDFs into a single unified vector PDF."""
+        payload = {
+            "pdfs": [self._to_base64_data_uri(p) for p in pdfs],
+            "output_filename": output_filename,
+            "store": store,
+            "expires_in": expires_in,
+        }
+        return self._request("/v1/pdf/merge", payload=payload, expect_binary=not store)
+
+    def split_pdf(
+        self,
+        pdf: PDFInput,
+        pages: str,
+        output_filename: str = "extracted.pdf",
+        store: bool = False,
+        expires_in: str = "24h",
+    ) -> Union[bytes, Dict[str, Any]]:
+        """Extracts specific pages or page ranges from a PDF (e.g. '1-3, 5, 8-10')."""
+        payload = {
+            "pdf": self._to_base64_data_uri(pdf),
+            "pages": pages,
+            "output_filename": output_filename,
+            "store": store,
+            "expires_in": expires_in,
+        }
+        return self._request("/v1/pdf/split", payload=payload, expect_binary=not store)
+
+    def fill_pdf_form(
+        self,
+        pdf: PDFInput,
+        fields: Dict[str, Any],
+        flatten: bool = True,
+        output_filename: str = "completed-form.pdf",
+        store: bool = False,
+        expires_in: str = "24h",
+    ) -> Union[bytes, Dict[str, Any]]:
+        """Fills interactive AcroForms with text, checkboxes, and radios."""
+        payload = {
+            "pdf": self._to_base64_data_uri(pdf),
+            "fields": fields,
+            "flatten": flatten,
+            "output_filename": output_filename,
+            "store": store,
+            "expires_in": expires_in,
+        }
+        return self._request("/v1/pdf/fill-form", payload=payload, expect_binary=not store)
+
+    def compress_pdf(
+        self,
+        pdf: PDFInput,
+        output_filename: str = "compressed.pdf",
+        store: bool = False,
+        expires_in: str = "24h",
+    ) -> Union[bytes, Dict[str, Any]]:
+        """Shrinks PDF file size via object stream compression."""
+        payload = {
+            "pdf": self._to_base64_data_uri(pdf),
+            "output_filename": output_filename,
+            "store": store,
+            "expires_in": expires_in,
+        }
+        return self._request("/v1/pdf/compress", payload=payload, expect_binary=not store)
+
+    def stamp_pdf(
+        self,
+        pdf: PDFInput,
+        watermark_text: str,
+        color: str = "red",
+        opacity: float = 0.15,
+        font_size: int = 54,
+        output_filename: Optional[str] = None,
+        store: bool = False,
+        expires_in: str = "24h",
+    ) -> Union[bytes, Dict[str, Any]]:
+        """Stamps a diagonal watermark or compliance stamp across all pages of a PDF."""
+        payload: Dict[str, Any] = {
+            "pdf": self._to_base64_data_uri(pdf),
+            "watermark_text": watermark_text,
+            "color": color,
+            "opacity": opacity,
+            "font_size": font_size,
+            "store": store,
+            "expires_in": expires_in,
+        }
+        if output_filename:
+            payload["output_filename"] = output_filename
+        return self._request("/v1/pdf/stamp", payload=payload, expect_binary=not store)
+
+    # =========================================================================
+    # UTILITIES & USAGE
+    # =========================================================================
+
+    def get_usage(self) -> Dict[str, Any]:
+        """Returns real-time monthly quota usage and limits."""
+        res = self._request("/v1/usage", method="GET", expect_binary=False)
+        return res if isinstance(res, dict) else {}
+
+    def verify_webhook_signature(
+        self,
+        payload_bytes: bytes,
+        signature_header: str,
+        secret: Optional[str] = None,
+    ) -> bool:
+        """Verifies the HMAC-SHA256 signature on an incoming webhook request."""
+        signing_key = (secret or self.api_key).encode("utf-8")
+        expected_sig = hmac.new(signing_key, payload_bytes, hashlib.sha256).hexdigest()
+
+        header_val = signature_header.strip()
+        if header_val.startswith("sha256="):
+            header_val = header_val[7:]
+
+        return hmac.compare_digest(expected_sig, header_val)

tailprint/errors.py

@@ -0,0 +1,36 @@
+"""Tailprint SDK exception classes."""
+
+from typing import Any, Optional
+
+
+class TailprintError(Exception):
+    """Base exception for all Tailprint SDK errors."""
+
+    def __init__(self, message: str, status_code: int = 500, details: Optional[Any] = None) -> None:
+        super().__init__(message)
+        self.message = message
+        self.status_code = status_code
+        self.details = details
+
+    def __repr__(self) -> str:
+        return f"{self.__class__.__name__}(message={self.message!r}, status_code={self.status_code})"
+
+
+class AuthenticationError(TailprintError):
+    """Raised when an API key is missing, invalid, or inactive (HTTP 401)."""
+    pass
+
+
+class RateLimitError(TailprintError):
+    """Raised when the monthly quota is exhausted (HTTP 429)."""
+    pass
+
+
+class ValidationError(TailprintError):
+    """Raised when request parameters fail schema validation (HTTP 400)."""
+    pass
+
+
+class TimeoutError(TailprintError):
+    """Raised when a job or HTTP request exceeds its timeout (HTTP 408 / 504)."""
+    pass

tailprint-1.3.0.dist-info/METADATA

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: tailprint
+Version: 1.3.0
+Summary: Official Python SDK for Tailprint — Developer-First PDF & Document Engine
+Author-email: Tailprint <reach@clewaa.com>
+License-Expression: MIT
+Project-URL: Homepage, https://tailprint.com
+Project-URL: Documentation, https://tailprint.com/docs
+Project-URL: Repository, https://github.com/coheroseb/tailprint
+Project-URL: Issues, https://github.com/coheroseb/tailprint/issues
+Keywords: pdf,html-to-pdf,tailwind,factur-x,zugferd,einvoice,playwright,pdf-merge,pdf-split,pdf-stamp,document-generation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# Tailprint Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/tailprint.svg)](https://pypi.org/project/tailprint/)
+[![Python versions](https://img.shields.io/pypi/pyversions/tailprint.svg)](https://pypi.org/project/tailprint/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+Official Python client for **Tailprint** ([tailprint.com](https://tailprint.com)) — the developer-first programmable PDF and document engine.
+
+Turns Tailwind CSS HTML, dynamic data, and AI prompts into pixel-perfect vector **PDFs**, European **Factur-X / ZUGFeRD e-invoices**, and provides full PDF manipulation operations (merge, split, fill forms, stamp, compress, validate).
+
+- **Zero dependencies:** Built entirely with standard library modules (`urllib`, `json`, `base64`, `hmac`). Installs in < 1 second with 0 dependency conflicts.
+- **Async & Batch:** Native support for asynchronous background rendering and concurrent multi-document batch runs.
+- **Enterprise-Ready:** Cryptographic webhook signature verification and zero-retention GDPR mode.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install tailprint
+```
+
+---
+
+## 🚀 Quickstart
+
+```python
+import os
+from tailprint import Tailprint
+
+# Initialize with your API key (or set TAILPRINT_API_KEY environment variable)
+tp = Tailprint(api_key=os.environ.get("TAILPRINT_API_KEY", "sec_live_..."))
+
+# 1. Render Tailwind HTML to Vector PDF
+pdf_bytes = tp.render_pdf(
+    html="""
+    <div class="p-12 bg-slate-900 text-white font-sans">
+        <h1 class="text-3xl font-bold text-indigo-400">Quarterly Invoice</h1>
+        <p class="text-slate-400 mt-2">Styled dynamically with Tailwind CSS.</p>
+    </div>
+    """,
+    format="A4",
+    smart_pagination=True,
+)
+
+with open("invoice.pdf", "wb") as f:
+    f.write(pdf_bytes)
+```
+
+---
+
+## ⚡ Asynchronous Rendering & Webhooks
+
+For heavy 100+ page reports or async pipelines:
+
+```python
+# Submit rendering job in background
+job = tp.render_pdf_async(
+    html="<h1>Heavy 200-page Annual Financial Report</h1>",
+    webhook_url="https://your-api.com/webhooks/pdf",
+    webhook_headers={"X-Secret": "your_webhook_secret"},
+)
+
+print("Job queued:", job["job_id"])
+
+# Optionally poll until finished:
+completed_job = tp.wait_for_job(job["job_id"], poll_interval=1.0, timeout=60.0)
+print("Download URL:", completed_job["results"][0]["download_url"])
+```
+
+---
+
+## 📦 Concurrent Batch Rendering with Auto-Merge
+
+Render up to 100 documents concurrently and optionally merge them into a single multi-page PDF:
+
+```python
+batch = tp.render_batch(
+    items=[
+        {"html": "<h1>Invoice #101</h1>", "filename": "inv-101.pdf"},
+        {"html": "<h1>Invoice #102</h1>", "filename": "inv-102.pdf"},
+        {"html": "<h1>Invoice #103</h1>", "filename": "inv-103.pdf"},
+    ],
+    merge_output=True,
+    merged_filename="all-invoices.pdf",
+    webhook_url="https://your-api.com/webhooks/pdf",
+)
+
+completed = tp.wait_for_job(batch["job_id"])
+print("Merged PDF link:", completed["merged_output"]["download_url"])
+```
+
+---
+
+## 🇪🇺 European Factur-X / ZUGFeRD E-Invoicing
+
+### Generate Compliant Hybrid PDF/A-3
+```python
+invoice_pdf = tp.generate_einvoice(
+    invoice_number="INV-2026-0042",
+    currency="EUR",
+    seller={"name": "Acme Nordic ApS", "country": "DK", "vat_id": "DK12345678"},
+    buyer={"name": "Global Logistics GmbH", "country": "DE", "vat_id": "DE987654321"},
+    line_items=[
+        {"name": "Consulting Services", "quantity": 10, "unit_price": 150.0, "vat_rate": 25.0}
+    ],
+    payment_iban="DK001234567890",
+)
+```
+
+### Validate E-Invoice Compliance (EN 16931)
+```python
+report = tp.validate_einvoice(pdf=invoice_pdf)
+print("Compliant:", report["is_valid"])
+print("Profile:", report["profile"])
+print("Totals:", report["invoice_details"]["totals"])
+```
+
+---
+
+## 🛠 Complete PDF Operations
+
+```python
+# 1. Merge multiple PDFs
+merged_pdf = tp.merge_pdfs([doc1_bytes, doc2_bytes])
+
+# 2. Extract pages (e.g. pages 1 to 3, and page 5)
+split_pdf = tp.split_pdf(doc_bytes, pages="1-3, 5")
+
+# 3. Fill interactive AcroForms
+filled_pdf = tp.fill_pdf_form(doc_bytes, fields={"customer_name": "Alice", "opt_in": True})
+
+# 4. Stamp watermark or compliance mark
+stamped_pdf = tp.stamp_pdf(doc_bytes, watermark_text="CONFIDENTIAL", opacity=0.2)
+
+# 5. Compress PDF file size
+compressed_pdf = tp.compress_pdf(doc_bytes)
+```
+
+---
+
+## 🔐 Webhook Signature Verification
+
+Verify HMAC-SHA256 signatures in FastAPI, Flask, or Django:
+
+```python
+from fastapi import FastAPI, Request, HTTPException
+
+app = FastAPI()
+
+@app.post("/webhooks/pdf")
+async def handle_webhook(request: Request):
+    payload = await request.body()
+    sig_header = request.headers.get("x-tailprint-signature", "")
+    
+    if not tp.verify_webhook_signature(payload, sig_header):
+        raise HTTPException(status_code=401, detail="Invalid signature")
+        
+    data = await request.json()
+    print("PDF rendered:", data["data"]["download_url"])
+    return {"status": "ok"}
+```
+
+---
+
+## 📄 License
+
+MIT © [Tailprint](https://tailprint.com)

tailprint-1.3.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+tailprint/__init__.py,sha256=hA7ByzWVbiWIaODta1m2ZHyKptBK0lRHsV7CLWaRpW0,390
+tailprint/client.py,sha256=xLkgsHqC_gFgINHZV_Ni7oRBZ9109odAgsd9htMFUeg,17648
+tailprint/errors.py,sha256=SeWqbIQiWpIaocRtvAtRXeRxWK6zX-cBs_UFaw-fzvQ,1035
+tailprint/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tailprint-1.3.0.dist-info/METADATA,sha256=_tK99WjDxMlb4ASoVPjpjFgWkU4_EDSNMHb1_Gl5uRo,6338
+tailprint-1.3.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+tailprint-1.3.0.dist-info/top_level.txt,sha256=9scmpv9ZYPn3tuzljvNF82itjYgKrB_htvow786Yg58,10
+tailprint-1.3.0.dist-info/RECORD,,

tailprint-1.3.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

tailprint-1.3.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+tailprint