tango-app-api-trax 3.9.39 → 3.9.41

package/src/controllers/traxDashboard.controllers.js

@@ -276,29 +276,10 @@ export const checklistPerformance = async ( req, res ) => {
     toDate = new Date( toDate.getTime() - userTimezoneOffset );
     toDate.setUTCHours( 23, 59, 59, 59 );
     let result = {};
-    let checklistIdList = [];
 
     let limit = parseInt( requestData?.limit ) || 10;
     let skip = limit * ( requestData?.offset ) || 0;
 
-    const detectionPayload = {
-      'fromDate': requestData.fromDate,
-      'toDate': requestData.toDate,
-      'clientId': requestData.clientId,
-      'sortColumnName': requestData.sortColumnName,
-      'sortBy': requestData.sortBy,
-      'storeId': requestData.storeId,
-    };
-
-
-    let complianceURL = JSON.parse( process.env.LAMBDAURL ).complianceURL;
-    const complianceData = await LamdaServiceCall( complianceURL, detectionPayload );
-    if ( complianceData?.data?.length && requestData?.sortColumnName == 'questionCompliance' ) {
-      const end = skip + requestData?.limit;
-      checklistIdList = complianceData.data.slice( skip, end )?.map( ( ele ) => ele?.sourceCheckList_id );
-    }
-
-
     // Get User Based Checklist //
     // let loginUser = { clientId: requestData.clientId, role: req.user.role, userType: req.user.userType, userEmail: req.user.email };
     // let getUserEmails = await getChecklistUsers( loginUser );
@@ -314,10 +295,6 @@ export const checklistPerformance = async ( req, res ) => {
         { $or: [ { store_id: { $in: requestData.storeId } }, { store_id: { $eq: '' }, userEmail: { $in: requestData.userEmailes } } ] },
     );
 
-    if ( requestData?.sortColumnName == 'questionCompliance' ) {
-      findAndQuery.push( { sourceCheckList_id: { $in: checklistIdList } } );
-    }
-
     findQuery.push( { $match: { $and: findAndQuery } } );
 
     if ( requestData.searchValue && requestData.searchValue != '' ) {
@@ -367,6 +344,16 @@ export const checklistPerformance = async ( req, res ) => {
         timeFlag: { $sum: '$timeFlag' },
         questionFlagCount: { $sum: '$questionFlag' },
         runAIFlagCount: { $sum: '$runAIFlag' },
+        userComplianceCountTotal: {
+          $sum: {
+            $cond: [
+              { $eq: [ '$checklistStatus', 'submit' ] },
+              { $ifNull: [ '$userComplianceCount', 0 ] },
+              0,
+            ],
+          },
+        },
+        complianceCount: { $first: '$complianceCount' },
         checkListType: { $last: '$checkListType' },
         redo: { $sum: { $cond: [ { $eq: [ '$redoStatus', true ] }, 1, 0 ] } },
         task: {
@@ -426,6 +413,41 @@ export const checklistPerformance = async ( req, res ) => {
         checkListType: 1,
         redo: 1,
         task: 1,
+        questionCompliance: {
+          $let: {
+            vars: {
+              divisor: {
+                $cond: [
+                  { $gt: [ '$submittedChecklist', 1 ] },
+                  { $multiply: [ { $ifNull: [ '$complianceCount', 0 ] }, '$submittedChecklist' ] },
+                  { $ifNull: [ '$complianceCount', 0 ] },
+                ],
+              },
+            },
+            in: {
+              $cond: [
+                { $gt: [ '$$divisor', 0 ] },
+                {
+                  $max: [
+                    0,
+                    {
+                      $round: [
+                        {
+                          $multiply: [
+                            { $divide: [ '$userComplianceCountTotal', '$$divisor' ] },
+                            100,
+                          ],
+                        },
+                        0,
+                      ],
+                    },
+                  ],
+                },
+                0,
+              ],
+            },
+          },
+        },
       },
     } );
 
@@ -446,18 +468,10 @@ export const checklistPerformance = async ( req, res ) => {
       },
     } );
     let getChecklistPerformanceData = await processedchecklistService.aggregate( findQuery );
-    if ( !getChecklistPerformanceData[0].data.length ) {
+    if ( !getChecklistPerformanceData?.[0]?.data?.length ) {
       return res.sendError( 'no data found', 204 );
     }
 
-    getChecklistPerformanceData?.[0]?.data.forEach( ( ele ) => {
-      let findCompliance;
-      if ( complianceData?.data?.length ) {
-        findCompliance = complianceData?.data?.find( ( data ) => data.sourceCheckList_id == ele?.sourceCheckList_id );
-      }
-      ele['questionComplianceRate'] = findCompliance?.compliancePercentage ?? 0;
-    } );
-
     if ( requestData.export ) {
       const exportdata = [];
       getChecklistPerformanceData[0].data.forEach( ( element ) => {
@@ -4335,26 +4349,26 @@ function escapeRegex( text ) {
 //   }
 // }
 
-async function LamdaServiceCall( url, data ) {
-  try {
-    const requestOptions = {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify( data ),
-    };
-    console.log( data );
-    const response = await fetch( url, requestOptions );
-    if ( !response.ok ) {
-      throw new Error( `Response status: ${response.status}` );
-      return false;
-    }
-    const json = await response.json();
-    return json;
-  } catch ( error ) {
-    console.log( error );
-    logger.error( { error: error, message: data, function: 'LamdaServiceCall' } );
-    return false;
-  }
-}
+// async function LamdaServiceCall( url, data ) {
+//   try {
+//     const requestOptions = {
+//       method: 'POST',
+//       headers: {
+//         'Content-Type': 'application/json',
+//       },
+//       body: JSON.stringify( data ),
+//     };
+//     console.log( data );
+//     const response = await fetch( url, requestOptions );
+//     if ( !response.ok ) {
+//       throw new Error( `Response status: ${response.status}` );
+//       return false;
+//     }
+//     const json = await response.json();
+//     return json;
+//   } catch ( error ) {
+//     console.log( error );
+//     logger.error( { error: error, message: data, function: 'LamdaServiceCall' } );
+//     return false;
+//   }
+// }

package/src/hbs/flag.hbs

@@ -176,7 +176,7 @@
                         <td class="flagText" style="padding-left:30px; line-height: 24px;">No of Flags :</td>
                         <td></td>
                         <td></td>
-                        <td class="flagText">{{data.flagCount}}</td>
+                        <td class="flagText">{{data.flagCount}}{{#eq data.status 'submit'}}(RunAIFlag:{{data.runAIFlag}},QuestionFlag:{{data.questionFlag}}){{/eq}}</td>
                     </tr>
                     <tr bgcolor="#ffffff" style="border:none;margin-top:3px;">
                         <td class="flagText" style="padding-left:30px; line-height: 24px;">Submitted By :</td>

package/src/hbs/template.hbs

@@ -267,6 +267,13 @@
                                                             <img src="{{this}}" alt="test" width="200" height="180">
                                                         {{/each}}
                                                     </div>
+                                                    {{#if validationVideo.length}}
+                                                        <div class="Reference"><span>Uploaded Video</span><br>
+                                                            {{#each validationVideo}}
+                                                                <a href="{{this}}" target="_blank" style="text-decoration: underline;color:#0085D2">{{this}}</a><br>
+                                                            {{/each}}
+                                                        </div>
+                                                    {{/if}}
                                                 {{/eq}}
                                             </td>
                                         </tr>

package/src/hbs/visit-checklist.hbs

@@ -56,14 +56,16 @@
   .dp-header{display:flex;justify-content:space-between;align-items:center;margin-bottom:20px;padding-bottom:12px;border-bottom:2px solid #00AEEF}
   .dp-header h2{font-size:18px;font-weight:700;color:#1a1a2e}
   .dp-score{font-size:15px;font-weight:700;color:#000000}
-  .q-row{display:flex;gap:12px;margin-bottom:14px;padding:12px;border-radius:8px;background:transparent}
-  .q-num{font-size:12px;font-weight:700;color:#000;min-width:22px}
-  .q-body{flex:1}
+  .q-row{position:relative;margin-bottom:14px;padding:12px 12px 12px 40px;border-radius:8px;background:transparent}
+  .q-num{position:absolute;left:12px;top:12px;font-size:12px;font-weight:700;color:#000}
   .q-text{font-size:13px;color:#444;margin-bottom:4px}
   .q-ans{display:inline-flex;align-items:center;gap:4px;font-size:12px;font-weight:600;padding:2px 8px;border-radius:12px}
   .ans-yes{background:#e1f5ee;color:#0f6e56}
   .ans-no{background:#fcebeb;color:#a32d2d}
   .flag-badge{background:#faeeda;color:#854f0b;font-size:10px;font-weight:600;padding:1px 6px;border-radius:8px;margin-left:6px}
+  .det-badge{display:inline-block;font-size:10px;font-weight:600;padding:2px 8px;border-radius:10px;white-space:nowrap}
+  .det-matched{background:#e1f5ee;color:#0f6e56}
+  .det-notmatched{background:#fcebeb;color:#a32d2d}
   .q-answer-list{margin-top:6px}
   .q-answer-item{margin-top:6px;padding:0;background:transparent;border:none;border-radius:0}
   .q-answer-text{font-size:12px;color:#1a1a1a;line-height:1.5}
@@ -72,9 +74,21 @@
   .q-answer-media img,.q-answer-media video,.q-answer-item td img{display:block;width:200px;height:180px;object-fit:cover;border-radius:6px;margin-bottom:6px}
   .img-grid{display:flex;flex-wrap:wrap;gap:8px}
   .img-grid img{margin-bottom:0}
+  .answer-media-grid{margin-top:8px;font-size:0}
+  .answer-media-cell{display:inline-block;width:calc(50% - 6px);vertical-align:top;margin-bottom:12px;break-inside:avoid}
+  .answer-media-cell:nth-child(2n+1){margin-right:12px}
+  .answer-media-cell .q-answer-caption{margin-bottom:4px}
+  .answer-media-cell img{display:block;width:100%;height:200px;object-fit:fill;border-radius:6px;margin-bottom:0}
   .q-answer-link{font-size:12px;color:#0085D2;text-decoration:underline;word-break:break-all}
   .q-answer-caption{font-size:11px;color:#666;margin-bottom:4px}
   .q-answer-remarks{font-size:11px;color:#666;margin-top:6px;white-space:pre-line}
+  /* User verification (Submitted By) */
+  .user-verify{margin-top:28px;padding-top:18px;border-top:1px solid #d9d9d9;break-inside:avoid}
+  .user-verify-title{font-size:15px;font-weight:700;color:#1a1a1a;margin-bottom:14px}
+  .user-verify-photo{display:block;width:200px;height:240px;object-fit:cover;border-radius:8px;margin-bottom:10px}
+  .user-verify-name{font-size:14px;color:#1a1a1a;font-weight:600}
+  .user-verify-sign-label{font-size:12px;color:#666;margin-top:16px;margin-bottom:6px;font-weight:600}
+  .user-verify-signature{display:block;width:220px;height:auto;max-height:110px;object-fit:contain;border:1px solid #eee;border-radius:6px;padding:6px;background:#fff}
   /* Footer */
   .page-footer{position:absolute;bottom:20px;left:40px;right:40px;display:flex;justify-content:space-between;align-items:center;font-size:11px;color:#999;border-top:1px solid #d9d9d9;padding-top:10px}
   .footer-brand{display:flex;align-items:center;gap:8px;font-weight:600;color:#0066CC;font-size:11px}
@@ -112,8 +126,12 @@
  
 <div class="cover-summary">
 <div class="cover-sum-row"><span class="cover-sum-label">No. of questions</span><span class="cover-sum-colon">:</span><span class="cover-sum-val">{{numQuestions}}</span></div>
-<div class="cover-sum-row"><span class="cover-sum-label">No. of flags</span><span class="cover-sum-colon">:</span><span class="cover-sum-val">{{numFlags}}</span></div>
-{{!-- <div class="cover-sum-row"><span class="cover-sum-label">AI Breached</span><span class="cover-sum-colon">:</span><span class="cover-sum-val">{{aiBreached}}</span></div> --}}
+{{#if showFlags}}
+<div class="cover-sum-row"><span class="cover-sum-label">Question Flag</span><span class="cover-sum-colon">:</span><span class="cover-sum-val">{{numFlags}}</span></div>
+{{/if}}
+{{#if showRunAIFlag}}
+<div class="cover-sum-row"><span class="cover-sum-label">Run AI Flag</span><span class="cover-sum-colon">:</span><span class="cover-sum-val">{{runAIFlag}}</span></div>
+{{/if}}
 <div class="cover-sum-row"><span class="cover-sum-label">Submitted By</span><span class="cover-sum-colon">:</span><span class="cover-sum-val">{{submittedBy}}</span></div>
 <div class="cover-sum-row"><span class="cover-sum-label">Country</span><span class="cover-sum-colon">:</span><span class="cover-sum-val">{{country}}</span></div>
 </div>
@@ -175,10 +193,10 @@
 <div class="q-row">
 <span class="q-num">{{this.qno}}</span>
 <div class="q-body">
-<div class="q-text" style="display:flex;justify-content:space-between">
+<div class="q-text" style="display:flex;justify-content:space-between;align-items:center;gap:8px">
   <div>{{this.qname}}</div>
   {{#if this.compliance}}
-  <div>Score:{{this.score}}</div>
+  <div style="flex-shrink:0">Score:{{this.score}}</div>
   {{/if}}
 </div>
 {{#if this.questionReferenceImage}}
@@ -204,7 +222,7 @@
 <div class="q-answer-item">
   {{#eq this.answerType 'text'}}
     {{#if this.answer}}
-    <div class="q-answer-text {{#if this.sopFlag}}flagged{{/if}}">{{this.answer}}</div>
+    <div class="q-answer-text {{#if this.sopFlag}}flagged{{/if}}">{{this.answer}}{{#if this.showDetectionStatus}} <span class="det-badge {{#eq this.detectionStatus 'Matched'}}det-matched{{else}}det-notmatched{{/eq}}">{{this.detectionStatus}}</span>{{/if}}</div>
     {{/if}}
   {{/eq}}
   {{#eq this.answerType 'video'}}
@@ -215,6 +233,20 @@
     </div>
     {{/if}}
   {{/eq}}
+  {{!-- This answer's own images (reference / uploaded / validation), grouped with its label, two per row --}}
+  {{#if this.answerMedia.length}}
+  <div class="answer-media-grid">
+    {{#each this.answerMedia}}
+    <div class="answer-media-cell">
+      <div class="q-answer-caption" style="display:flex;justify-content:space-between;align-items:center;gap:6px">
+        <span>{{this.label}}</span>
+        {{#if this.detectionStatus}}<span class="det-badge {{#eq this.detectionStatus 'Matched'}}det-matched{{else}}det-notmatched{{/eq}}">{{this.detectionStatus}}</span>{{/if}}
+      </div>
+      <img src="{{this.url}}" alt="{{this.label}}" />
+    </div>
+    {{/each}}
+  </div>
+  {{/if}}
   {{#eq this.validationDisplayType 'text'}}
     {{#if this.validationAnswer}}
     <div class="q-answer-text {{#if this.sopFlag}}flagged{{/if}}">validation Answer: {{this.validationAnswer}}</div>
@@ -227,95 +259,36 @@
     {{/if}}
   {{/eq}}
 
-  <table style="width:100%;margin-top:8px;table-layout:fixed"><tr>
-    <td style="width:50%;vertical-align:top;padding-right:8px">
-      {{#neq ../answerType 'image/video'}}
-        {{#neq ../answerType 'multipleImage'}}
-          {{#if this.multiReferenceImage.length}}
-          <div class="q-answer-media">
-            <div class="q-answer-caption">Reference Images</div>
-            {{#each this.multiReferenceImage}}
-            <img src="{{this}}" alt="Reference Image" />
-            {{/each}}
-          </div>
-          {{else}}
-            {{#if this.referenceImage}}
-            <div class="q-answer-media">
-              <div class="q-answer-caption">Reference Image</div>
-              <img src="{{this.referenceImage}}" alt="Reference Image" />
-            </div>
-            {{else}}
-              {{#eq this.answerType 'image'}}
-                {{#if this.answer}}
-                <div class="q-answer-media">
-                  <div class="q-answer-caption">Uploaded Image</div>
-                  <img src="{{this.answer}}" alt="Uploaded Image" />
-                </div>
-                {{/if}}
-              {{/eq}}
-            {{/if}}
-          {{/if}}
-        {{else}}
-          {{#eq this.answerType 'image'}}
-            {{#if this.answer}}
-            <div class="q-answer-media">
-              <div class="q-answer-caption">Uploaded Image</div>
-              <img src="{{this.answer}}" alt="Uploaded Image" />
-            </div>
-            {{/if}}
-          {{/eq}}
-        {{/neq}}
-      {{else}}
-        {{#eq this.answerType 'image'}}
-          {{#if this.answer}}
-          <div class="q-answer-media">
-            <div class="q-answer-caption">Uploaded Image</div>
-            <img src="{{this.answer}}" alt="Uploaded Image" />
-          </div>
-          {{/if}}
-        {{/eq}}
-      {{/neq}}
-    </td>
-    <td style="width:50%;vertical-align:top;padding-left:8px">
-      {{#eq this.answerType 'image'}}
-        {{#if this.answer}}
-          {{#neq ../answerType 'image/video'}}
-            {{#neq ../answerType 'multipleImage'}}
-              {{#if this.multiReferenceImage.length}}
-              <div class="q-answer-caption">Uploaded Image</div>
-              <img src="{{this.answer}}" alt="Uploaded Image" />
-              {{else}}
-                {{#if this.referenceImage}}
-                <div class="q-answer-caption">Uploaded Image</div>
-                <img src="{{this.answer}}" alt="Uploaded Image" />
-                {{/if}}
-              {{/if}}
-            {{/neq}}
-          {{/neq}}
-        {{/if}}
-      {{/eq}}
-      {{#if this.validation}}
-        {{#eq this.validationDisplayType 'image'}}
-          {{#if this.validationAnswer}}
-          <div class="q-answer-caption">Validation Image</div>
-          <img src="{{this.validationAnswer}}" alt="Validation Image" />
-          {{/if}}
-        {{/eq}}        
-        {{#eq this.validationDisplayType 'multiImage'}}
-          {{#if this.validationImage.length}}
-          <div class="q-answer-caption">Validation Image</div>
-          {{#each this.validationImage}}
-          <img src="{{this}}" alt="Validation Image" />
-          {{/each}}
-          {{/if}}
-        {{/eq}}
-      {{/if}}
-    </td>
-  </tr></table>
+  {{!-- Validation videos captured with multi-image validation (shown as links) --}}
+  {{#eq this.validationDisplayType 'multiImage'}}
+    {{#if this.validationVideo.length}}
+    <div class="q-answer-media">
+      <div class="q-answer-caption">Validation Video</div>
+      {{#each this.validationVideo}}
+      <a class="q-answer-link" href="{{this}}" target="_blank">{{this}}</a>
+      {{/each}}
+    </div>
+    {{/if}}
+  {{/eq}}
+
 </div>
 {{/each}}
 </div>
 {{/if}}
+{{!-- All images for this question (reference / uploaded / validation), two per row --}}
+{{#if this.mediaItems.length}}
+<div class="answer-media-grid">
+  {{#each this.mediaItems}}
+  <div class="answer-media-cell">
+    <div class="q-answer-caption" style="display:flex;justify-content:space-between;align-items:center;gap:6px">
+      <span>{{this.label}}</span>
+      {{#if this.detectionStatus}}<span class="det-badge {{#eq this.detectionStatus 'Matched'}}det-matched{{else}}det-notmatched{{/eq}}">{{this.detectionStatus}}</span>{{/if}}
+    </div>
+    <img src="{{this.url}}" alt="{{this.label}}" />
+  </div>
+  {{/each}}
+</div>
+{{/if}}
 {{#if this.remarks}}
 <div class="q-answer-remarks">Remarks: {{this.remarks}}</div>
 {{/if}}
@@ -324,6 +297,17 @@
 {{/each}}
 </div>
 {{/each}}
+{{#if showUserVerification}}
+<div class="user-verify">
+  <div class="user-verify-title">Submitted By</div>
+  {{#if userImage}}
+  <img class="user-verify-photo" src="{{userImage}}" alt="Submitted by photo" />
+  {{/if}}
+  {{#if submittedBy}}
+  <div class="user-verify-name">{{userSignature}}</div>
+  {{/if}}
+</div>
+{{/if}}
 </div>
  
 </body>

package/src/logging/activityLogFlusher.js

@@ -0,0 +1,59 @@
+import { insertOpenSearchData, logger } from 'tango-app-api-middleware';
+import { loggingConfig } from './config.js';
+import { compressBatches } from './compressBatches.js';
+
+export async function flushActivityLog( ctx, status ) {
+  if ( !loggingConfig.enabled ) return;
+  if ( !ctx ) return;
+
+  if ( ctx.steps.length === 0 && !ctx.error ) return;
+
+  const compressedSteps = safeCompress( ctx.steps );
+
+  const doc = {
+    version: loggingConfig.version,
+    requestId: ctx.requestId,
+    timestamp: new Date( ctx.startTime ).toISOString(),
+    duration: Date.now() - ctx.startTime,
+    user: ctx.user,
+    api: {
+      method: ctx.api.method,
+      path: ctx.api.path,
+      action: ctx.api.action,
+      body: stringifyBody( ctx.api.body ),
+    },
+    response: {
+      code: ctx.response?.code ?? null,
+      body: stringifyBody( ctx.response?.body ),
+    },
+    status,
+    steps: compressedSteps,
+    error: ctx.error,
+  };
+
+  try {
+    await insertOpenSearchData( loggingConfig.index, doc );
+  } catch ( e ) {
+    logger.error( { functionName: 'flushActivityLog', error: e } );
+  }
+}
+
+function safeCompress( steps ) {
+  try {
+    return compressBatches( steps );
+  } catch ( _e ) {
+    // Never let compression failure block log delivery — fall back to raw steps.
+    return steps;
+  }
+}
+
+function stringifyBody( body ) {
+  if ( body === null || body === undefined ) return null;
+  if ( typeof body === 'string' ) return body;
+  if ( body instanceof Error ) return body.message || String( body );
+  try {
+    return JSON.stringify( body );
+  } catch ( _e ) {
+    return '[unserializable]';
+  }
+}

package/src/logging/activityLogMiddleware.js

@@ -0,0 +1,45 @@
+import { activityLogStore, createLogContext } from './activityLogStore.js';
+import { flushActivityLog } from './activityLogFlusher.js';
+import { loggingConfig } from './config.js';
+
+function refreshUser( ctx, req ) {
+  if ( req?.user ) {
+    ctx.user = {
+      _id: req.user._id,
+      userName: req.user.userName,
+      email: req.user.email,
+    };
+  }
+}
+
+export default function traxActivityLogMiddleware( req, res, next ) {
+  if ( !loggingConfig.enabled ) return next();
+
+  const WRITE_METHODS = [ 'POST', 'PUT', 'PATCH', 'DELETE' ];
+  if ( !WRITE_METHODS.includes( req.method ) ) return next();
+
+  const ctx = createLogContext( req );
+
+  activityLogStore.run( ctx, () => {
+    const originalSendSuccess = res.sendSuccess;
+    const originalSendError = res.sendError;
+
+    res.sendSuccess = ( data ) => {
+      refreshUser( ctx, req );
+      ctx.response.code = 200;
+      ctx.response.body = data;
+      originalSendSuccess( data );
+      setImmediate( () => flushActivityLog( ctx, 'success' ).catch( () => {} ) );
+    };
+
+    res.sendError = ( message, code ) => {
+      refreshUser( ctx, req );
+      ctx.response.code = code ?? 500;
+      ctx.response.body = message;
+      originalSendError( message, code );
+      setImmediate( () => flushActivityLog( ctx, 'failed' ).catch( () => {} ) );
+    };
+
+    next();
+  } );
+}

package/src/logging/activityLogStore.js

@@ -0,0 +1,91 @@
+import { AsyncLocalStorage } from 'async_hooks';
+import { randomUUID } from 'crypto';
+
+export const activityLogStore = new AsyncLocalStorage();
+
+const SENSITIVE_KEYS = [ 'password', 'token', 'secret', 'authorization' ];
+
+export function createLogContext( req ) {
+  return {
+    requestId: randomUUID(),
+    startTime: Date.now(),
+    user: req.user ? {
+      _id: req.user._id,
+      userName: req.user.userName,
+      email: req.user.email,
+    } : null,
+    api: {
+      method: req.method,
+      path: req.path,
+      action: `${ req.method } ${ req.path }`,
+      body: sanitizeBody( req.body ),
+    },
+    response: {
+      code: null,
+      body: null,
+    },
+    steps: [],
+    stepCounter: 0,
+    error: null,
+  };
+}
+
+export function getLogContext() {
+  return activityLogStore.getStore();
+}
+
+export function pushStep( entry ) {
+  const ctx = getLogContext();
+  if ( !ctx ) return;
+
+  const last = ctx.steps[ctx.steps.length - 1];
+  if (
+    last &&
+    last.name === entry.name &&
+    last.type === entry.type &&
+    last.status === 'success' &&
+    entry.status === 'success'
+  ) {
+    last.count = ( last.count || 1 ) + 1;
+    last.ms += entry.ms;
+    return;
+  }
+
+  ctx.stepCounter++;
+  ctx.steps.push( {
+    stepIndex: ctx.stepCounter,
+    name: entry.name,
+    type: entry.type,
+    status: entry.status,
+    ms: entry.ms,
+  } );
+}
+
+export function pushStepFailure( entry, error ) {
+  const ctx = getLogContext();
+  if ( !ctx ) return;
+  ctx.stepCounter++;
+  const message = error?.message || String( error );
+  ctx.steps.push( {
+    stepIndex: ctx.stepCounter,
+    name: entry.name,
+    type: entry.type,
+    status: 'failed',
+    ms: entry.ms,
+    error: message,
+  } );
+  ctx.error = {
+    message,
+    failedAtStepIndex: ctx.stepCounter,
+    failedStepName: entry.name,
+  };
+}
+
+function sanitizeBody( body ) {
+  if ( !body || typeof body !== 'object' ) return body;
+  const cleaned = { ...body };
+  for ( const key of SENSITIVE_KEYS ) {
+    if ( cleaned[key] !== undefined ) cleaned[key] = '[REDACTED]';
+  }
+  return cleaned;
+}