tango-app-api-trax 3.7.87 → 3.7.89

package/src/utils/visitChecklistPdf.utils.js

@@ -38,8 +38,8 @@ function toPlainObject( doc ) {
  * @param {string} [checklistName] Full checklist name from API or DB
  * @return {{ titleLine1: string, titleLine2: string }} titleLine1 and titleLine2 for the PDF cover
  */
-function splitCoverTitle( checklistName ) {
-  const n = ( checklistName || '' ).trim();
+function splitCoverTitle( checklistName ) {
+  const n = ( checklistName || '' ).trim();
 
   if ( !n ) {
     return { titleLine1: 'AOM', titleLine2: 'Visit Checklist' };
@@ -50,122 +50,122 @@ function splitCoverTitle( checklistName ) {
   if ( m ) {
     return { titleLine1: m[1].trim() || 'AOM', titleLine2: 'Visit Checklist' };
   }
-
-  return { titleLine1: n, titleLine2: 'Visit Checklist' };
-}
-
-function getMatchedAnswerForUserAnswer( question, userAnswer ) {
-  if ( !userAnswer || !Array.isArray( question?.answers ) ) return null;
-
-  return question.answers.find( ( answer ) => {
-    if ( userAnswer.no !== undefined && answer.index === userAnswer.no ) {
-      return true;
-    }
-
-    if ( userAnswer.index !== undefined && answer.index === userAnswer.index ) {
-      return true;
-    }
-
-    if ( userAnswer.answeroptionNumber !== undefined && answer.answeroptionNumber === userAnswer.answeroptionNumber ) {
-      return true;
-    }
-
-    return answer.answer === userAnswer.answer;
-  } ) || null;
-}
-
-function isMeaningfulUserAnswer( userAnswer = {} ) {
-  return Boolean(
-      userAnswer &&
-      (
-        ( typeof userAnswer.answer === 'string' && userAnswer.answer.trim() ) ||
-        ( typeof userAnswer.validationAnswer === 'string' && userAnswer.validationAnswer.trim() ) ||
-        ( typeof userAnswer.referenceImage === 'string' && userAnswer.referenceImage.trim() )
-      ),
-  );
-}
-
-function getSourceUserAnswers( question ) {
-  const fromUserAnswer = Array.isArray( question?.userAnswer ) ? question.userAnswer : [];
-  const fromMultiAnswer = Array.isArray( question?.Multianswer ) ? question.Multianswer : [];
-  const isMultiAnswerQuestion = question?.answerType === 'multiplechoicemultiple' ||
-    question?.answerType === 'multipleImage' ||
-    question?.answerType === 'image/video' ||
-    ( question?.answerType === 'dropdown' && question?.allowMultiple );
-
-  if ( isMultiAnswerQuestion ) {
-    return [ ...fromUserAnswer, ...fromMultiAnswer ];
-  }
-
-  return fromUserAnswer;
-}
-
-function getUserAnswerKey( userAnswer = {}, index = 0 ) {
-  return [
-    userAnswer.no ?? '',
-    userAnswer.index ?? '',
-    userAnswer.answeroptionNumber ?? '',
-    userAnswer.answer ?? '',
-    userAnswer.validationAnswer ?? '',
-    userAnswer.referenceImage ?? '',
-    index,
-  ].join( '|' );
-}
-
-function getMediaDisplayType( questionAnswerType, userAnswer = {} ) {
-  if ( questionAnswerType === 'video' ) {
-    return userAnswer.answerType === 'image' ? 'image' : 'video';
-  }
-  if ( [ 'image', 'descriptiveImage', 'multipleImage' ].includes( questionAnswerType ) ) {
-    return userAnswer.answerType === 'video' ? 'video' : 'image';
-  }
-  if ( questionAnswerType === 'image/video' ) {
-    return userAnswer.answerType === 'video' ? 'video' : 'image';
-  }
-
-  return 'text';
-}
-
-function getValidationDisplayType( validationType ) {
-  if ( validationType === 'Capture Image' ) return 'image';
-  if ( validationType === 'Capture Video' ) return 'video';
-  return 'text';
-}
-
-function buildQuestionAnswerEntries( question ) {
-  const rawUserAnswers = getSourceUserAnswers( question );
-  const uniqueUserAnswers = [];
-  const seenUserAnswers = new Set();
-
-  rawUserAnswers.forEach( ( userAnswer, index ) => {
-    if ( !isMeaningfulUserAnswer( userAnswer ) ) return;
-
-    const key = getUserAnswerKey( userAnswer, index );
-    if ( seenUserAnswers.has( key ) ) return;
-
-    seenUserAnswers.add( key );
-    uniqueUserAnswers.push( userAnswer );
-  } );
-
-  return uniqueUserAnswers.map( ( userAnswer ) => {
-    const matchedAnswer = getMatchedAnswerForUserAnswer( question, userAnswer );
-    const validation = matchedAnswer?.validation ?? userAnswer?.validation ?? false;
-    const validationType = matchedAnswer?.validationType || userAnswer?.validationType || '';
-    const validationAnswer = matchedAnswer?.validationAnswer || userAnswer?.validationAnswer || '';
-
-    return {
-      answer: userAnswer?.answer || '',
-      answerType: getMediaDisplayType( question?.answerType, userAnswer ),
-      referenceImage: userAnswer?.referenceImage || matchedAnswer?.referenceImage || '',
-      remarks: userAnswer?.remarks || '',
-      sopFlag: userAnswer?.sopFlag ?? matchedAnswer?.sopFlag ?? false,
-      validation,
-      validationType,
-      validationAnswer,
-      validationDisplayType: getValidationDisplayType( validationType ),
-    };
-  } );
-}
+
+  return { titleLine1: n, titleLine2: 'Visit Checklist' };
+}
+
+function getMatchedAnswerForUserAnswer( question, userAnswer ) {
+  if ( !userAnswer || !Array.isArray( question?.answers ) ) return null;
+
+  return question.answers.find( ( answer ) => {
+    if ( userAnswer.no !== undefined && answer.index === userAnswer.no ) {
+      return true;
+    }
+
+    if ( userAnswer.index !== undefined && answer.index === userAnswer.index ) {
+      return true;
+    }
+
+    if ( userAnswer.answeroptionNumber !== undefined && answer.answeroptionNumber === userAnswer.answeroptionNumber ) {
+      return true;
+    }
+
+    return answer.answer === userAnswer.answer;
+  } ) || null;
+}
+
+function isMeaningfulUserAnswer( userAnswer = {} ) {
+  return Boolean(
+      userAnswer &&
+      (
+        ( typeof userAnswer.answer === 'string' && userAnswer.answer.trim() ) ||
+        ( typeof userAnswer.validationAnswer === 'string' && userAnswer.validationAnswer.trim() ) ||
+        ( typeof userAnswer.referenceImage === 'string' && userAnswer.referenceImage.trim() )
+      ),
+  );
+}
+
+function getSourceUserAnswers( question ) {
+  const fromUserAnswer = Array.isArray( question?.userAnswer ) ? question.userAnswer : [];
+  const fromMultiAnswer = Array.isArray( question?.Multianswer ) ? question.Multianswer : [];
+  const isMultiAnswerQuestion = question?.answerType === 'multiplechoicemultiple' ||
+    question?.answerType === 'multipleImage' ||
+    question?.answerType === 'image/video' ||
+    ( question?.answerType === 'dropdown' && question?.allowMultiple );
+
+  if ( isMultiAnswerQuestion ) {
+    return [ ...fromUserAnswer, ...fromMultiAnswer ];
+  }
+
+  return fromUserAnswer;
+}
+
+function getUserAnswerKey( userAnswer = {}, index = 0 ) {
+  return [
+    userAnswer.no ?? '',
+    userAnswer.index ?? '',
+    userAnswer.answeroptionNumber ?? '',
+    userAnswer.answer ?? '',
+    userAnswer.validationAnswer ?? '',
+    userAnswer.referenceImage ?? '',
+    index,
+  ].join( '|' );
+}
+
+function getMediaDisplayType( questionAnswerType, userAnswer = {} ) {
+  if ( questionAnswerType === 'video' ) {
+    return userAnswer.answerType === 'image' ? 'image' : 'video';
+  }
+  if ( [ 'image', 'descriptiveImage', 'multipleImage' ].includes( questionAnswerType ) ) {
+    return userAnswer.answerType === 'video' ? 'video' : 'image';
+  }
+  if ( questionAnswerType === 'image/video' ) {
+    return userAnswer.answerType === 'video' ? 'video' : 'image';
+  }
+
+  return 'text';
+}
+
+function getValidationDisplayType( validationType ) {
+  if ( validationType === 'Capture Image' ) return 'image';
+  if ( validationType === 'Capture Video' ) return 'video';
+  return 'text';
+}
+
+function buildQuestionAnswerEntries( question ) {
+  const rawUserAnswers = getSourceUserAnswers( question );
+  const uniqueUserAnswers = [];
+  const seenUserAnswers = new Set();
+
+  rawUserAnswers.forEach( ( userAnswer, index ) => {
+    if ( !isMeaningfulUserAnswer( userAnswer ) ) return;
+
+    const key = getUserAnswerKey( userAnswer, index );
+    if ( seenUserAnswers.has( key ) ) return;
+
+    seenUserAnswers.add( key );
+    uniqueUserAnswers.push( userAnswer );
+  } );
+
+  return uniqueUserAnswers.map( ( userAnswer ) => {
+    const matchedAnswer = getMatchedAnswerForUserAnswer( question, userAnswer );
+    const validation = matchedAnswer?.validation ?? userAnswer?.validation ?? false;
+    const validationType = matchedAnswer?.validationType || userAnswer?.validationType || '';
+    const validationAnswer = matchedAnswer?.validationAnswer || userAnswer?.validationAnswer || '';
+
+    return {
+      answer: userAnswer?.answer || '',
+      answerType: getMediaDisplayType( question?.answerType, userAnswer ),
+      referenceImage: userAnswer?.referenceImage || matchedAnswer?.referenceImage || '',
+      remarks: userAnswer?.remarks || '',
+      sopFlag: userAnswer?.sopFlag ?? matchedAnswer?.sopFlag ?? false,
+      validation,
+      validationType,
+      validationAnswer,
+      validationDisplayType: getValidationDisplayType( validationType ),
+    };
+  } );
+}
 
 
 /**
@@ -193,28 +193,29 @@ function mapSectionsFromQuestionAnswer( questionAnswer ) {
   ( questionAnswer || [] ).forEach( ( section, sectionIdx ) => {
     let sectionScore = 0;
 
-    let sectionMax = 0;
-
-    let passedCount = 0;
-
-    const questions = [];
-    const sourceQuestionsCount = section.questions?.length || 0;
-
-
-    ( section.questions || [] ).forEach( ( q ) => {
-      const userAnswersWithRef = buildQuestionAnswerEntries( q );
-
-      if ( !userAnswersWithRef.length ) {
-        return;
-      }
-
-      const ua = userAnswersWithRef[0];
-
-      const matchedAnswer = ua && getMatchedAnswerForUserAnswer( q, ua );
-
-      const score = matchedAnswer?.complianceScore ?? q.complianceScore ?? q.answers?.[0]?.complianceScore ?? 0;
-
-      const max = 10;
+    let sectionMax = 0;
+
+    let passedCount = 0;
+
+    const questions = [];
+    const sourceQuestionsCount = section.questions?.length || 0;
+
+
+    ( section.questions || [] ).forEach( ( q ) => {
+      const userAnswersWithRef = buildQuestionAnswerEntries( q );
+
+      if ( !userAnswersWithRef.length ) {
+        return;
+      }
+
+      const ua = userAnswersWithRef[0];
+
+
+      const max = q.compliance ? Math.max( ...q?.answers.map( ( o ) => o?.complianceScore ?? Math.max( o?.matchedCount ?? 0, o?.notMatchedCount ?? 0 ) ) ) : 0;
+
+
+      const score = q.compliance ? Math.max( ...q?.userAnswer?.map( ( o ) => o?.complianceScore ?? 0 ) ) : 0;
+
 
       sectionScore += score;
 
@@ -227,7 +228,7 @@ function mapSectionsFromQuestionAnswer( questionAnswer ) {
       if ( score >= 10 ) passedCount++;
 
 
-      const answerText = ( ua?.answer || '' ).toString().trim();
+      const answerText = ( ua?.answer || '' ).toString().trim();
 
       const isYes = answerText.toLowerCase() === 'yes';
 
@@ -249,43 +250,43 @@ function mapSectionsFromQuestionAnswer( questionAnswer ) {
         } );
       }
 
-      questions.push( {
+      questions.push( {
 
         qno: q.qno || q.uniqueqno,
 
-        qname: q.qname || q.oldQname,
-
-        score: score,
-
-        remarks: ( q.userAnswer?.[0]?.remarks ) || q.remarks || '',
-
-        answerType: q.answerType || '',
-
-        compliance: Boolean( q.compliance ),
-
-        isYes: isYes || ( !isNo && score >= 10 ),
+        qname: q.qname || q.oldQname,
+
+        score: score,
+
+        remarks: ( q.userAnswer?.[0]?.remarks ) || q.remarks || '',
+
+        answerType: q.answerType || '',
+
+        compliance: Boolean( q.compliance ),
+
+        isYes: isYes || ( !isNo && score >= 10 ),
 
         isNo,
 
         answerDisplay: isYes ? 'Yes' : ( isNo ? 'No' : ( answerText && answerText.startsWith( 'http' ) ? 'Image' : ( answerText || '—' ) ) ),
 
-        userAnswer: userAnswersWithRef.length ? userAnswersWithRef : [ {
-          answer: '',
-          answerType: 'text',
-          remarks: '',
-          referenceImage: '',
-          imageMatchStatus: 'Matched',
-          validation: false,
-          validationType: '',
-          validationAnswer: '',
-          validationDisplayType: 'text',
-        } ],
-
-      } );
-    } );
-
-
-    const questionsCount = questions.length || sourceQuestionsCount;
+        userAnswer: userAnswersWithRef.length ? userAnswersWithRef : [ {
+          answer: '',
+          answerType: 'text',
+          remarks: '',
+          referenceImage: '',
+          imageMatchStatus: 'Matched',
+          validation: false,
+          validationType: '',
+          validationAnswer: '',
+          validationDisplayType: 'text',
+        } ],
+
+      } );
+    } );
+
+
+    const questionsCount = questions.length || sourceQuestionsCount;
 
 
     sectionInsights.push( {
@@ -340,7 +341,7 @@ function mapSectionsFromQuestionAnswer( questionAnswer ) {
 
  */
 
-export function buildVisitChecklistTemplateDataFromProcessed( processedDoc, brandInfo = {} ) {
+export function buildVisitChecklistTemplateDataFromProcessed( processedDoc, brandInfo = {} ) {
   const doc = toPlainObject( processedDoc );
 
   const questionAnswer = doc.questionAnswers || [];
@@ -371,28 +372,28 @@ export function buildVisitChecklistTemplateDataFromProcessed( processedDoc, bran
     ( doc.submitTime_string?.split( ',' )?.[0]?.trim() || '' );
 
 
-  const hasCompliancePage = questionAnswer.some( ( section ) =>
-    ( section.questions || [] ).some( ( question ) => Boolean( question.compliance ) ),
-  );
-  const detailPageStart = hasCompliancePage ? 3 : 2;
-  const detailPageGroups = [];
-
-  for ( let i = 0; i < questionAnswers.length; i += 2 ) {
-    const groupSections = questionAnswers.slice( i, i + 2 );
-    const pageNumber = detailPageStart + detailPageGroups.length;
-
-    groupSections.forEach( ( section ) => {
-      section.pageNumber = pageNumber;
-    } );
-
-    detailPageGroups.push( {
-      pageNumber,
-      sections: groupSections,
-      isLastGroup: i + 2 >= questionAnswers.length,
-    } );
-  }
-
-  const totalPages = 1 + ( hasCompliancePage ? 1 : 0 ) + detailPageGroups.length;
+  const hasCompliancePage = questionAnswer.some( ( section ) =>
+    ( section.questions || [] ).some( ( question ) => Boolean( question.compliance ) ),
+  );
+  const detailPageStart = hasCompliancePage ? 3 : 2;
+  const detailPageGroups = [];
+
+  for ( let i = 0; i < questionAnswers.length; i += 2 ) {
+    const groupSections = questionAnswers.slice( i, i + 2 );
+    const pageNumber = detailPageStart + detailPageGroups.length;
+
+    groupSections.forEach( ( section ) => {
+      section.pageNumber = pageNumber;
+    } );
+
+    detailPageGroups.push( {
+      pageNumber,
+      sections: groupSections,
+      isLastGroup: i + 2 >= questionAnswers.length,
+    } );
+  }
+
+  const totalPages = 1 + ( hasCompliancePage ? 1 : 0 ) + detailPageGroups.length;
 
 
   const checklistName = doc.checkListName || 'Visit Checklist';
@@ -401,8 +402,41 @@ export function buildVisitChecklistTemplateDataFromProcessed( processedDoc, bran
 
   const { titleLine1, titleLine2 } = splitCoverTitle( checklistName );
 
+
+  let historyData = [];
+
+
+  const rawHistory = doc.historyData;
+
+
+  if ( Array.isArray( rawHistory ) && rawHistory.length > 0 ) {
+    historyData = rawHistory.map( ( h ) => {
+      const pct = Math.min( 100, Math.max( h.complianceScore ?? 0 ) );
+
+
+      return {
+
+
+        date: h.date,
+
+
+        value: pct,
+
+
+        percentage: pct,
+
+
+        barHeight: Math.round( ( pct / 100 ) * 140 ),
+
+
+      };
+    } );
+  }
+
+
   return {
 
+
     brandLogo: brandInfo.brandLogo || '',
 
     brandName: brandInfo.clientName || brandInfo.brandName || 'lenskart',
@@ -427,15 +461,15 @@ export function buildVisitChecklistTemplateDataFromProcessed( processedDoc, bran
 
     aiBreached: typeof doc.runAIFlag === 'number' ? doc.runAIFlag : 0,
 
-    submittedBy: doc.userName || '--',
-
-    country: doc.country || '--',
-
-    hasCompliancePage,
-
-    detailPageStart,
-
-    totalPages,
+    submittedBy: doc.userName || '--',
+
+    country: doc.country || '--',
+
+    hasCompliancePage,
+
+    detailPageStart,
+
+    totalPages,
 
     totalPercentage,
 
@@ -449,7 +483,7 @@ export function buildVisitChecklistTemplateDataFromProcessed( processedDoc, bran
 
       '',
 
-    historyData: [],
+    historyData,
 
     sectionInsights,
 
@@ -492,26 +526,26 @@ function buildFromViewChecklistApi( getchecklistData, viewchecklistData, brandIn
   const totalPercentage = maxScore > 0 ? Math.round( ( totalScore / maxScore ) * 100 ) : 0;
 
 
-  const hasCompliancePage = Boolean( checklistInfo.complianceCount );
-  const detailPageStart = hasCompliancePage ? 3 : 2;
-  const detailPageGroups = [];
-
-  for ( let i = 0; i < questionAnswers.length; i += 2 ) {
-    const groupSections = questionAnswers.slice( i, i + 2 );
-    const pageNumber = detailPageStart + detailPageGroups.length;
-
-    groupSections.forEach( ( section ) => {
-      section.pageNumber = pageNumber;
-    } );
-
-    detailPageGroups.push( {
-      pageNumber,
-      sections: groupSections,
-      isLastGroup: i + 2 >= questionAnswers.length,
-    } );
-  }
-
-  const totalPages = 1 + ( hasCompliancePage ? 1 : 0 ) + detailPageGroups.length;
+  const hasCompliancePage = Boolean( checklistInfo.complianceCount );
+  const detailPageStart = hasCompliancePage ? 3 : 2;
+  const detailPageGroups = [];
+
+  for ( let i = 0; i < questionAnswers.length; i += 2 ) {
+    const groupSections = questionAnswers.slice( i, i + 2 );
+    const pageNumber = detailPageStart + detailPageGroups.length;
+
+    groupSections.forEach( ( section ) => {
+      section.pageNumber = pageNumber;
+    } );
+
+    detailPageGroups.push( {
+      pageNumber,
+      sections: groupSections,
+      isLastGroup: i + 2 >= questionAnswers.length,
+    } );
+  }
+
+  const totalPages = 1 + ( hasCompliancePage ? 1 : 0 ) + detailPageGroups.length;
 
   const rawChecklistTitle = checklistInfo?.checklistName || getchecklistData?.data?.checklistName || 'AOM Visit Checklist';
 
@@ -538,7 +572,6 @@ function buildFromViewChecklistApi( getchecklistData, viewchecklistData, brandIn
       };
     } );
   }
-  console.log( brandInfo.brandLogo, 'jhgfghj' );
 
   return {
 
@@ -570,15 +603,15 @@ function buildFromViewChecklistApi( getchecklistData, viewchecklistData, brandIn
 
     aiBreached: checklistAnswer?.aiBreachedCount ?? 0,
 
-    submittedBy: checklistInfo?.submittedBy || storeProfile?.userName || '--',
-
-    country: storeProfile?.Country || '--',
-
-    hasCompliancePage,
-
-    detailPageStart,
-
-    totalPages,
+    submittedBy: checklistInfo?.submittedBy || storeProfile?.userName || '--',
+
+    country: storeProfile?.Country || '--',
+
+    hasCompliancePage,
+
+    detailPageStart,
+
+    totalPages,
 
     totalPercentage,
 
@@ -598,7 +631,7 @@ function buildFromViewChecklistApi( getchecklistData, viewchecklistData, brandIn
 
     flags,
 
-    complianceCount: hasCompliancePage,
+    complianceCount: hasCompliancePage,
 
   };
 }
@@ -625,16 +658,283 @@ export function buildVisitChecklistTemplateData( arg1, arg2, arg3 ) {
 
 /**
 
- * Generates PDF buffer from template data
 
- * @param {Object} templateData - Context for visit-checklist.hbs
+ * In-memory image cache: URL → base64 data URI.
+
 
- * @param {string} baseUrl - Base URL for resolving image URLs (e.g. cloudfront)
+ * Shared across all PDFs in a single request lifecycle.
 
- * @return {Promise<Buffer>} PDF buffer
 
  */
 
+
+export function createImageCache() {
+  const cache = new Map();
+
+
+  async function fetchAsDataUri( url ) {
+    if ( !url || typeof url !== 'string' || !url.startsWith( 'http' ) ) return url;
+
+
+    if ( cache.has( url ) ) return cache.get( url );
+
+
+    try {
+      const controller = new AbortController();
+
+
+      const timeout = setTimeout( () => controller.abort(), 10000 );
+
+
+      const res = await fetch( url, { signal: controller.signal } );
+
+
+      clearTimeout( timeout );
+
+
+      if ( !res.ok ) {
+        cache.set( url, url );
+
+
+        return url;
+      }
+
+
+      const contentType = res.headers.get( 'content-type' ) || 'image/png';
+
+
+      const buffer = Buffer.from( await res.arrayBuffer() );
+
+
+      const dataUri = `data:${contentType};base64,${buffer.toString( 'base64' )}`;
+
+
+      cache.set( url, dataUri );
+
+
+      return dataUri;
+    } catch {
+      cache.set( url, url );
+
+
+      return url;
+    }
+  }
+
+
+  async function resolveAllImages( resolvedData ) {
+    const urls = new Set();
+
+
+    if ( resolvedData.brandLogo && resolvedData.brandLogo.startsWith( 'http' ) ) {
+      urls.add( resolvedData.brandLogo );
+    }
+
+
+    const collectFromSection = ( section ) => {
+      section.questions?.forEach( ( q ) => {
+        q.userAnswer?.forEach( ( ua ) => {
+          if ( ua.referenceImage && ua.referenceImage.startsWith( 'http' ) ) urls.add( ua.referenceImage );
+
+
+          if ( ua.answer && ua.answerType === 'image' && ua.answer.startsWith( 'http' ) ) urls.add( ua.answer );
+
+
+          if ( ua.validationAnswer && ua.validationDisplayType === 'image' && ua.validationAnswer.startsWith( 'http' ) ) urls.add( ua.validationAnswer );
+        } );
+      } );
+    };
+
+
+    resolvedData.questionAnswers?.forEach( collectFromSection );
+
+
+    resolvedData.detailPageGroups?.forEach( ( group ) => {
+      group.sections?.forEach( collectFromSection );
+    } );
+
+
+    // Fetch all unique URLs in parallel (max 20 concurrent)
+
+
+    const urlArray = [ ...urls ];
+
+
+    const BATCH_SIZE = 20;
+
+
+    for ( let i = 0; i < urlArray.length; i += BATCH_SIZE ) {
+      await Promise.all( urlArray.slice( i, i + BATCH_SIZE ).map( ( u ) => fetchAsDataUri( u ) ) );
+    }
+
+
+    // Replace URLs with cached data URIs
+
+
+    if ( resolvedData.brandLogo ) {
+      resolvedData.brandLogo = cache.get( resolvedData.brandLogo ) || resolvedData.brandLogo;
+    }
+
+
+    const replaceInSection = ( section ) => {
+      section.questions?.forEach( ( q ) => {
+        q.userAnswer?.forEach( ( ua ) => {
+          if ( ua.referenceImage && cache.has( ua.referenceImage ) ) ua.referenceImage = cache.get( ua.referenceImage );
+
+
+          if ( ua.answer && ua.answerType === 'image' && cache.has( ua.answer ) ) ua.answer = cache.get( ua.answer );
+
+
+          if ( ua.validationAnswer && ua.validationDisplayType === 'image' && cache.has( ua.validationAnswer ) ) ua.validationAnswer = cache.get( ua.validationAnswer );
+        } );
+      } );
+    };
+
+
+    resolvedData.questionAnswers?.forEach( replaceInSection );
+
+
+    resolvedData.detailPageGroups?.forEach( ( group ) => {
+      group.sections?.forEach( replaceInSection );
+    } );
+
+
+    return resolvedData;
+  }
+
+
+  return { fetchAsDataUri, resolveAllImages, cache };
+}
+
+
+export function getCompiledVisitChecklistTemplate() {
+  const templatePath = path.join( __dirname, '../hbs/visit-checklist.hbs' );
+
+
+  const templateHtml = fs.readFileSync( templatePath, 'utf8' );
+
+
+  return handlebars.compile( templateHtml );
+}
+
+
+export function resolveTemplateUrls( templateData, baseUrl = 'https://d1r0hc2sskgmri.cloudfront.net/' ) {
+  if ( baseUrl && !baseUrl.endsWith( '/' ) ) baseUrl += '/';
+
+
+  const resolveUrl = ( url ) => {
+    if ( !url || typeof url !== 'string' ) return url;
+
+
+    if ( url.startsWith( 'http' ) ) return url;
+
+
+    return baseUrl + url.replace( /^\//, '' );
+  };
+
+
+  const resolvedData = JSON.parse( JSON.stringify( templateData ) );
+
+
+  const resolveQuestionMedia = ( section ) => {
+    section.questions?.forEach( ( q ) => {
+      q.userAnswer?.forEach( ( ua ) => {
+        if ( ua.referenceImage ) ua.referenceImage = resolveUrl( ua.referenceImage );
+
+
+        if ( ua.validationAnswer && ua.validationDisplayType !== 'text' ) {
+          ua.validationAnswer = resolveUrl( ua.validationAnswer );
+        }
+
+
+        if ( ua.answer && ua.answerType !== 'text' ) {
+          ua.answer = resolveUrl( ua.answer );
+        }
+      } );
+    } );
+  };
+
+
+  resolvedData.questionAnswers?.forEach( resolveQuestionMedia );
+
+
+  resolvedData.detailPageGroups?.forEach( ( group ) => {
+    group.sections?.forEach( resolveQuestionMedia );
+  } );
+
+
+  if ( resolvedData.brandLogo && !resolvedData.brandLogo.startsWith( 'http' ) ) {
+    resolvedData.brandLogo = resolveUrl( resolvedData.brandLogo );
+  }
+
+
+  return resolvedData;
+}
+
+
+export async function generatePDFFromPage( page, template, templateData, baseUrl, imageCache ) {
+  const resolvedData = resolveTemplateUrls( templateData, baseUrl );
+
+
+  if ( imageCache ) {
+    await imageCache.resolveAllImages( resolvedData );
+  }
+
+
+  const html = template( resolvedData );
+
+
+  await page.setContent( html, { waitUntil: 'domcontentloaded' } );
+
+
+  if ( !imageCache ) {
+    await Promise.race( [
+
+
+      page.evaluate( async () => {
+        const images = Array.from( document.images );
+
+
+        await Promise.all(
+
+
+            images.map( ( img ) => {
+              if ( img.complete ) return;
+
+
+              return new Promise( ( resolve ) => {
+                img.onload = img.onerror = resolve;
+              } );
+            } ),
+
+
+        );
+      } ),
+
+
+      new Promise( ( resolve ) => setTimeout( resolve, 30000 ) ),
+
+
+    ] );
+  }
+
+
+  return page.pdf( {
+
+
+    format: 'A4',
+
+
+    printBackground: true,
+
+
+    margin: { top: '10mm', right: '10mm', bottom: '10mm', left: '10mm' },
+
+
+  } );
+}
+
+
 export async function generateVisitChecklistPDF( templateData, baseUrl = 'https://d1r0hc2sskgmri.cloudfront.net/' ) {
   const templatePath = path.join( __dirname, '../hbs/visit-checklist.hbs' );
 
@@ -657,26 +957,26 @@ export async function generateVisitChecklistPDF( templateData, baseUrl = 'https:
 
   const resolvedData = JSON.parse( JSON.stringify( templateData ) );
 
-  const resolveQuestionMedia = ( section ) => {
-    section.questions?.forEach( ( q ) => {
-      q.userAnswer?.forEach( ( ua ) => {
-        if ( ua.referenceImage ) ua.referenceImage = resolveUrl( ua.referenceImage );
-
-        if ( ua.validationAnswer && ua.validationDisplayType !== 'text' ) {
-          ua.validationAnswer = resolveUrl( ua.validationAnswer );
-        }
-
-        if ( ua.answer && ua.answerType !== 'text' ) {
-          ua.answer = resolveUrl( ua.answer );
-        }
-      } );
-    } );
-  };
-
-  resolvedData.questionAnswers?.forEach( resolveQuestionMedia );
-  resolvedData.detailPageGroups?.forEach( ( group ) => {
-    group.sections?.forEach( resolveQuestionMedia );
-  } );
+  const resolveQuestionMedia = ( section ) => {
+    section.questions?.forEach( ( q ) => {
+      q.userAnswer?.forEach( ( ua ) => {
+        if ( ua.referenceImage ) ua.referenceImage = resolveUrl( ua.referenceImage );
+
+        if ( ua.validationAnswer && ua.validationDisplayType !== 'text' ) {
+          ua.validationAnswer = resolveUrl( ua.validationAnswer );
+        }
+
+        if ( ua.answer && ua.answerType !== 'text' ) {
+          ua.answer = resolveUrl( ua.answer );
+        }
+      } );
+    } );
+  };
+
+  resolvedData.questionAnswers?.forEach( resolveQuestionMedia );
+  resolvedData.detailPageGroups?.forEach( ( group ) => {
+    group.sections?.forEach( resolveQuestionMedia );
+  } );
 
   if ( resolvedData.brandLogo && !resolvedData.brandLogo.startsWith( 'http' ) ) {
     resolvedData.brandLogo = resolveUrl( resolvedData.brandLogo );