@pixldocs/canvas-renderer 0.5.218 → 0.5.220

package/dist/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const index = require("./index-D3NJNdX_.cjs");
+const index = require("./index-DRHaeOxK.cjs");
 exports.DEPLOYMENT_VERSION_MARKER = index.DEPLOYMENT_VERSION_MARKER;
 exports.FONT_FALLBACK_DEVANAGARI = index.FONT_FALLBACK_DEVANAGARI;
 exports.FONT_FALLBACK_MATH = index.FONT_FALLBACK_MATH;

package/dist/index.d.ts

@@ -97,6 +97,22 @@ export declare function collectImageUrls(config: TemplateConfig): string[];
  */
 export declare function configHasAutoShrinkText(config: TemplateConfig | null | undefined): boolean;
 
+export declare interface DeliveryChannelResult {
+    channel: 'email' | 'whatsapp' | string;
+    status: 'sent' | 'failed' | 'pending_setup';
+    error?: string;
+}
+
+/** Recipient info for delivery. */
+export declare interface DeliveryRecipient {
+    /** Required for email delivery. */
+    email: string;
+    /** Used as "Hi {name}" in the email body. Optional. */
+    name?: string;
+    /** E.164 phone (e.g. "+919876543210"). Reserved for future WhatsApp delivery. */
+    phone?: string;
+}
+
 export declare const DEPLOYMENT_VERSION_MARKER: string;
 
 export declare function dumpSvgTextDiagnostics(svgStr: string, pageIndex: number, tag: string, stage: string, maxItems?: number): void;
@@ -552,6 +568,28 @@ export declare class PixldocsRenderer {
      * This is the primary PDF export API — mirrors renderFromForm() but returns a PDF.
      */
     renderPdfFromForm(options: PdfFromFormOptions): Promise<PdfRenderResult>;
+    /**
+     * Render the template AND deliver the resulting PDF to the user — currently
+     * via email (SendGrid). The PDF is rendered server-side on EC2, uploaded to
+     * S3 (returned as `pdfUrl` for download fallback), and emailed with the PDF
+     * attached.
+     *
+     * Every delivery is logged in the `delivery_log` table for audit + admin
+     * resend. The same `pdfUrl` is returned to the caller so the host app can
+     * also offer a "Download" button on the success screen.
+     *
+     * ```ts
+     * const result = await renderer.renderAndDeliver({
+     *   templateId, formSchemaId, sectionState,
+     *   project: 'biomaker',
+     *   recipient: { email: 'user@example.com', name: 'Anya' },
+     * });
+     * // → { jobId, pdfUrl, deliveries: [{ channel: 'email', status: 'sent' }] }
+     * ```
+     *
+     * Requires `RendererConfig.deliveryServerUrl` to be set.
+     */
+    renderAndDeliver(options: RenderAndDeliverOptions): Promise<RenderAndDeliverResult>;
     renderById(templateId: string, formData?: Record<string, any>, options?: RenderOptions): Promise<RenderResult>;
     /**
      * Convenience: fetch by ID with flat data and render ALL pages.
@@ -631,6 +669,38 @@ export declare interface PublishedTemplate {
     updated_at: string;
 }
 
+/** Options for renderAndDeliver — renders the template and emails it to the recipient. */
+export declare interface RenderAndDeliverOptions {
+    templateId: string;
+    formSchemaId: string;
+    sectionState: SectionFormState;
+    /**
+     * Project key — selects which sender profile (from address, subject, branding)
+     * the EC2 server uses. Currently supported: `'biomaker'`, `'pixldocs'`.
+     */
+    project: 'biomaker' | 'pixldocs' | string;
+    recipient: DeliveryRecipient;
+    /** Delivery channels. Default: `['email']`. Future: `'whatsapp'`. */
+    channels?: Array<'email' | 'whatsapp'>;
+    themeId?: string;
+    /** Force watermark on/off. Default: server decides based on template price. */
+    watermark?: boolean;
+    /** Render scale 1–4 (default 2). */
+    scale?: number;
+}
+
+export declare interface RenderAndDeliverResult {
+    /** Unique job ID — links all retries/resends of the same render. */
+    jobId: string;
+    /** Public/signed download URL of the rendered PDF on S3. */
+    pdfUrl: string;
+    /** S3 key (e.g. "deliveries/{jobId}.pdf"). */
+    s3Key?: string;
+    /** Per-channel delivery result. */
+    deliveries: DeliveryChannelResult[];
+    elapsedMs?: number;
+}
+
 export declare interface RendererConfig {
     /** Supabase project URL for fetching templates */
     supabaseUrl: string;
@@ -671,6 +741,12 @@ export declare interface RendererConfig {
      * Default: auto-normalize data:image sources to `2048`; pass `0` to disable.
      */
     maxImageEdgePx?: number;
+    /**
+     * Base URL of the PixlDocs PDF/delivery server (EC2). Required by
+     * `renderAndDeliver()`. Example: `'https://pdf.pixldocs.com'`. If omitted,
+     * `renderAndDeliver` will throw — the rest of the SDK works without it.
+     */
+    deliveryServerUrl?: string;
 }
 
 /** Options for renderFromForm — matches the server API payload */

package/dist/index.js

@@ -1,4 +1,4 @@
-import { D, F, o, q, s, P, t, u, v, w, x, y, z, B, C, E, G, H, I, J, K, L, M, b, N, O, Q, R, S, U, V, W, X, Y, Z, _, $, a0, a1, a2, a3, a4, a5 } from "./index-CZk_GpIL.js";
+import { D, F, o, q, s, P, t, u, v, w, x, y, z, B, C, E, G, H, I, J, K, L, M, b, N, O, Q, R, S, U, V, W, X, Y, Z, _, $, a0, a1, a2, a3, a4, a5 } from "./index-KtRZhEPi.js";
 export {
   D as DEPLOYMENT_VERSION_MARKER,
   F as FONT_FALLBACK_DEVANAGARI,

package/dist/{vectorPdfExport-som_tmDY.js → vectorPdfExport-D5bhT-57.js}

@@ -1,7 +1,7 @@
 import { jsPDF, ShadingPattern } from "jspdf";
 import { svg2pdf } from "svg2pdf.js";
 import * as fabric from "fabric";
-import { p as parseTextMarkdown, r as renderSmartElementToSvg, g as getCanvasForPage, c as captureFabricCanvasSvgForPdf, f as findNodeById, a as getAbsoluteBounds, b as getProxiedImageUrl, d as getImageProxyFetchOptions, A as API_URL, n as normalizeShapeType, i as isElement, e as isGroup, h as buildRoundedTrianglePath, j as hasEdgeFade, k as bakeEdgeFade, l as getRoundedRectRadii, T as TRIANGLE_STROKE_MITER_LIMIT, m as getTrianglePoints } from "./index-CZk_GpIL.js";
+import { p as parseTextMarkdown, r as renderSmartElementToSvg, g as getCanvasForPage, c as captureFabricCanvasSvgForPdf, f as findNodeById, a as getAbsoluteBounds, b as getProxiedImageUrl, d as getImageProxyFetchOptions, A as API_URL, n as normalizeShapeType, i as isElement, e as isGroup, h as buildRoundedTrianglePath, j as hasEdgeFade, k as bakeEdgeFade, l as getRoundedRectRadii, T as TRIANGLE_STROKE_MITER_LIMIT, m as getTrianglePoints } from "./index-KtRZhEPi.js";
 import { resetPdfFontRegistry, FONT_FALLBACK_SYMBOLS, FONT_FALLBACK_MATH, FONT_FALLBACK_DEVANAGARI, embedFontWithGoogleFallback, getEmbeddedVariantsList, isFontAvailable, isFamilyEmbedded, resolveBestRegisteredVariant, getEmbeddedJsPDFFontName, resolveFontWeight, doesVariantSupportChar } from "./pdfFonts-DhEaMTZl.js";
 async function embedFontsForSvg(pdf, svgStr) {
   var _a;
@@ -2955,7 +2955,7 @@ async function fetchSvgAsElement(imageUrl, colorMap) {
 async function getRecoloredSvgDataUrl(imageUrl, colorMap) {
   if (!colorMap || Object.keys(colorMap).length === 0) return null;
   try {
-    const { getNormalizedSvgUrl } = await import("./index-CZk_GpIL.js").then((n) => n.a6);
+    const { getNormalizedSvgUrl } = await import("./index-KtRZhEPi.js").then((n) => n.a6);
     return await getNormalizedSvgUrl(imageUrl, colorMap);
   } catch {
     return null;
@@ -3764,7 +3764,7 @@ async function fetchImageAsBase64(imageUrl, opts = {}) {
     }
     let fetchUrl = imageUrl;
     if (imageUrl.startsWith("http://") || imageUrl.startsWith("https://")) {
-      const { isPrivateUrl } = await import("./index-CZk_GpIL.js").then((n) => n.a6);
+      const { isPrivateUrl } = await import("./index-KtRZhEPi.js").then((n) => n.a6);
       if (isPrivateUrl(imageUrl)) return null;
       const proxyUrl = new URL(`${API_URL}/image-proxy`);
       proxyUrl.searchParams.set("url", imageUrl);
@@ -5865,4 +5865,4 @@ export {
   preparePagesForExport,
   rewriteSvgFontsForJsPDFWithSourceMeta
 };
-//# sourceMappingURL=vectorPdfExport-som_tmDY.js.map
+//# sourceMappingURL=vectorPdfExport-D5bhT-57.js.map