@pixldocs/canvas-renderer 0.5.5 → 0.5.7

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { FormConfig } from '../../../src/lib/formsApi';
 import { InferredSection } from '../../../src/lib/inferFormSchemaFromTemplate';
 import { jsPDF } from 'jspdf';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
@@ -147,6 +148,52 @@ declare type FontWeightFiles = {
     semiboldItalic?: string;
 };
 
+declare type FormDefField = {
+    id: string;
+    label: string;
+    key: string;
+    type: 'text' | 'textarea' | 'email' | 'tel' | 'url' | 'date' | 'number' | 'image' | 'color' | 'select' | 'toggle' | 'currency' | 'rating';
+    placeholder?: string;
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    order: number;
+    width?: 'full' | 'half' | 'third';
+    description?: string;
+};
+
+declare type FormDefRepeatablePage = {
+    id: string;
+    label: string;
+    description?: string;
+    order: number;
+    templateKeyPrefix: string;
+    fields: FormDefField[];
+    minEntries?: number;
+    maxEntries?: number;
+    children?: FormDefSection[];
+};
+
+declare type FormDefSchema = {
+    sections: FormDefSection[];
+    repeatablePages?: FormDefRepeatablePage[];
+    formRenderPreset?: 'default' | 'compact' | 'cards' | 'minimal' | 'biodata';
+};
+
+declare type FormDefSection = {
+    id: string;
+    label: string;
+    description?: string;
+    order: number;
+    fields: FormDefField[];
+    repeatable?: boolean;
+    minEntries?: number;
+    maxEntries?: number;
+    templateKeyPrefix?: string;
+    children?: FormDefSection[];
+};
+
 /**
  * Get the embedded jsPDF font name for a given font family + weight + italic.
  * This is the name used for pdf.setFont() and must match the font-family
@@ -197,6 +244,8 @@ export declare interface PdfFromFormOptions {
     themeId?: string;
     /** Whether to inject watermark. Default: auto (true for paid templates, false for free). */
     watermark?: boolean;
+    /** Optional prefetched rows from a trusted server to skip browser-side REST fetching. */
+    prefetched?: ResolveFromFormOptions['prefetched'];
     /** PDF document title */
     title?: string;
     /** Base URL for TTF font files for PDF font embedding */
@@ -359,6 +408,8 @@ export declare interface RenderFromFormOptions extends Omit<RenderOptions, 'page
     themeId?: string;
     /** Whether to inject watermark on preview. Default: auto (true for paid templates, false for free). */
     watermark?: boolean;
+    /** Optional prefetched rows from a trusted server to skip browser-side REST fetching. */
+    prefetched?: ResolveFromFormOptions['prefetched'];
 }
 
 export declare interface RenderOptions {
@@ -417,6 +468,36 @@ export declare interface ResolveFromFormOptions {
     supabaseUrl: string;
     /** Supabase anon key */
     supabaseAnonKey: string;
+    /** Optional prefetched rows from a trusted server so browser-side package resolution can skip REST fetches entirely. */
+    prefetched?: {
+        templateRow?: {
+            id?: string;
+            name?: string;
+            price?: number;
+            config: TemplateConfig;
+            form_schema?: {
+                repeatableSections?: {
+                    nodeId: string;
+                    label: string;
+                    minEntries?: number;
+                    maxEntries?: number;
+                }[];
+                repeatablePages?: unknown[];
+                dynamicFields?: DynamicField[];
+                fieldGroups?: any[];
+            } | null;
+            default_data?: unknown;
+        };
+        formSchemaRow?: {
+            id?: string;
+            schema: FormDefSchema;
+        } | null;
+        defaultForm?: {
+            config: FormConfig;
+            values: Record<string, any>;
+            saved_data: Record<string, any>;
+        } | null;
+    };
 }
 
 export declare interface ResolveOptions {

package/dist/index.js

@@ -10497,11 +10497,11 @@ async function resolveTemplateData(options) {
 }
 async function resolveFromForm(options) {
   var _a, _b, _c;
-  const { templateId, formSchemaId, sectionState, themeId, supabaseUrl, supabaseAnonKey } = options;
+  const { templateId, formSchemaId, sectionState, themeId, supabaseUrl, supabaseAnonKey, prefetched } = options;
   const [templateRow, formSchemaRow, defaultForm] = await Promise.all([
-    fetchRow(supabaseUrl, supabaseAnonKey, "templates", templateId),
-    fetchRow(supabaseUrl, supabaseAnonKey, "form_schemas", formSchemaId),
-    fetchDefaultForm(supabaseUrl, supabaseAnonKey, formSchemaId)
+    (prefetched == null ? void 0 : prefetched.templateRow) ? Promise.resolve(prefetched.templateRow) : fetchRow(supabaseUrl, supabaseAnonKey, "templates", templateId),
+    (prefetched == null ? void 0 : prefetched.formSchemaRow) !== void 0 ? Promise.resolve(prefetched.formSchemaRow) : fetchRow(supabaseUrl, supabaseAnonKey, "form_schemas", formSchemaId),
+    (prefetched == null ? void 0 : prefetched.defaultForm) !== void 0 ? Promise.resolve(prefetched.defaultForm) : fetchDefaultForm(supabaseUrl, supabaseAnonKey, formSchemaId)
   ]);
   const templateConfig = templateRow.config;
   const templateFormSchema = templateRow.form_schema;
@@ -11114,14 +11114,15 @@ class PixldocsRenderer {
    * This is the primary external API for the package.
    */
   async renderFromForm(options) {
-    const { templateId, formSchemaId, sectionState, themeId, watermark, ...renderOpts } = options;
+    const { templateId, formSchemaId, sectionState, themeId, watermark, prefetched, ...renderOpts } = options;
     const resolved = await resolveFromForm({
       templateId,
       formSchemaId,
       sectionState,
       themeId,
       supabaseUrl: this.config.supabaseUrl,
-      supabaseAnonKey: this.config.supabaseAnonKey
+      supabaseAnonKey: this.config.supabaseAnonKey,
+      prefetched
     });
     const shouldWatermark = watermark ?? resolved.price > 0;
     let configToRender = resolved.config;
@@ -11166,14 +11167,15 @@ class PixldocsRenderer {
    * Resolve from V2 sectionState and return SVGs for all pages (for server vector PDF).
    */
   async renderSvgsFromForm(options) {
-    const { templateId, formSchemaId, sectionState, themeId, watermark } = options;
+    const { templateId, formSchemaId, sectionState, themeId, watermark, prefetched } = options;
     const resolved = await resolveFromForm({
       templateId,
       formSchemaId,
       sectionState,
       themeId,
       supabaseUrl: this.config.supabaseUrl,
-      supabaseAnonKey: this.config.supabaseAnonKey
+      supabaseAnonKey: this.config.supabaseAnonKey,
+      prefetched
     });
     const shouldWatermark = watermark ?? resolved.price > 0;
     let configToRender = resolved.config;
@@ -11197,14 +11199,15 @@ class PixldocsRenderer {
    * This is the primary PDF export API — mirrors renderFromForm() but returns a PDF.
    */
   async renderPdfFromForm(options) {
-    const { templateId, formSchemaId, sectionState, themeId, watermark, title, fontBaseUrl } = options;
+    const { templateId, formSchemaId, sectionState, themeId, watermark, prefetched, title, fontBaseUrl } = options;
     const resolved = await resolveFromForm({
       templateId,
       formSchemaId,
       sectionState,
       themeId,
       supabaseUrl: this.config.supabaseUrl,
-      supabaseAnonKey: this.config.supabaseAnonKey
+      supabaseAnonKey: this.config.supabaseAnonKey,
+      prefetched
     });
     const shouldWatermark = watermark ?? resolved.price > 0;
     let configToRender = resolved.config;