@zoho_apptics/apptics-js-sdk 2.0.0-beta → 2.0.0-beta.2

package/dist/esm/feedback/ui.js

@@ -1,12 +1,15 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.2 | (c) Zoho Corporation Private Limited | see LICENSE */
 import { AP_TRACKING_STATUS } from '../core/constants.js';
 import { _ZAP } from '../core/state.js';
-import { Console } from '../core/logger.js';
+import { Console, warnAlways } from '../core/logger.js';
 import { isEmpty, isEmptyObj } from '../core/utils.js';
 import { opt_in_status } from '../core/consent.js';
 import { timerHtml, feedbackUIHtml } from './template.js';
 import { sendFeedbackData } from './send.js';
-import { wireDrag, wireUserPicker, wireLogControls, logChoice, userChoice } from './controls.js';
+import { chooseUserForSend, userChoice, wireTimerDrag, wireDrag, wireUserPicker, wireLogControls, logChoice } from './controls.js';
+import { injectStylesheet } from '../core/stylesheet.js';
+import { recordingDomain, loadQuartz, quartzScriptSource } from './quartz.js';
+import css from './styles.js';
 
 // Quartz is an optional page-level SDK. Without it every call is a no-op (fix #5).
 const QUARTZ_NOOP = {
@@ -19,6 +22,12 @@ const QUARTZ_NOOP = {
     submitRecording() { return Promise.resolve({}); }
 };
 const QUARTZ_CONSTANTS_NOOP = { ErrorType: {}, FeedbackState: {} };
+/** From Quartz's RECORDING_IN_PROGRESS until the form has come back from it. */
+var recordingInProgress = false;
+/** Send was pressed during a recording: it is sent, recording and all, once the recording has ended. */
+var sendWhenEnded = false;
+/** How long the form takes to shrink away when a recording starts: the stylesheet's transition. */
+const HIDE_MS = 300;
 function hasQuartz() {
     return typeof Quartz !== 'undefined' && !!Quartz; // no i18n
 }
@@ -37,34 +46,55 @@ function submitFeedback(dataobj) {
         if (!result) {
             return null;
         }
-        feedback.handleStatusmsg(result.ok, result.message);
         if (result.ok) {
-            setTimeout(() => {
-                feedback.close();
-            }, 2000);
+            // sent: the form goes at once rather than holding the page for the success line
+            feedback.close();
+        }
+        else {
+            feedback.handleStatusmsg(result.ok, result.message);
         }
         return result;
     });
 }
-function sendFeedback(feedbackType, feedbackMessage, attachments, logsFiles, includeDyninfo, includeLog) {
+/** Whether a value is an options object: a plain object, not a type number or a message string. */
+function isOptions(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value); // no i18n
+}
+/** Said once: the old one-argument-after-another form of feedbackFormOpen. */
+var saidOpenForm = false;
+function sendFeedback(options) {
+    if (options !== undefined && !isOptions(options)) {
+        // the old form, sendFeedback(type, message, ...): sending it as it stands would send an
+        // empty report, so it is refused, and says what to pass instead
+        return Promise.reject(new Error('AppticsFeedback.sendFeedback: takes one options object, as sendFeedback({ type, message, attachments, logFiles, includeDiagnostics, includeLog, isAnonymous })')); // no i18n
+    }
+    const o = options || {};
     const dataobj = {
-        type: !isEmpty(feedbackType) ? feedbackType : 1,
-        message: feedbackMessage || '', // no i18n
-        attachment: attachments || null,
-        logsFiles: logsFiles || null,
+        type: !isEmpty(o.type) ? o.type : 1,
+        message: o.message || '', // no i18n
+        attachment: o.attachments || null,
+        logsFiles: o.logFiles || null,
         // both flags stay as given: unset lets send.ts decide from what is actually stored
-        includeDyninfo: includeDyninfo,
-        includeLog: includeLog,
+        includeDyninfo: o.includeDiagnostics,
+        includeLog: o.includeLog,
         quartzid: '' // no i18n
     };
+    // from the active user, or from nobody with isAnonymous; the form's own choice is put back after
+    var restoreUser = chooseUserForSend(o.isAnonymous === true);
     // an app awaiting this must be able to tell its user the feedback did not go: resolving on a
     // failure would have it say "thanks, sent" for a report the server never received
     return submitFeedback(dataobj).then(function (result) {
+        restoreUser();
+        return result;
+    }, function (err) {
+        restoreUser();
+        throw err;
+    }).then(function (result) {
         if (!result) {
-            throw new Error('apptics.sendFeedback: not sent, the browser is offline or Apptics is disabled for this client'); // no i18n
+            throw new Error('AppticsFeedback.sendFeedback: not sent, the browser is offline or Apptics is disabled for this client'); // no i18n
         }
         if (!result.ok) {
-            throw new Error('apptics.sendFeedback: not sent, ' + result.message); // no i18n
+            throw new Error('AppticsFeedback.sendFeedback: not sent, ' + result.message); // no i18n
         }
     });
 }
@@ -109,23 +139,54 @@ function newTransfer() {
         return null;
     }
 }
-function feedbackOpen(type, message, includeLog, includeDyninfo, attachments, logFiles, isAnonymous) {
+function feedbackFormOpen(options) {
+    if (options !== undefined && !isOptions(options) && !saidOpenForm) {
+        // the old form, feedbackFormOpen(type, message, ...): the form still opens, with its defaults
+        saidOpenForm = true;
+        warnAlways('AppticsFeedback.feedbackFormOpen: takes one options object, as feedbackFormOpen({ type, message, includeLog, includeDiagnostics, attachments, logFiles, isAnonymous }); opening it with its defaults'); // no i18n
+    }
+    const o = isOptions(options) ? options : {};
     const opts = {
-        includeLog: includeLog === true,
-        includeDyninfo: includeDyninfo === true,
-        isAnonymous: isAnonymous === true,
+        includeLog: o.includeLog === true,
+        includeDyninfo: o.includeDiagnostics === true,
+        isAnonymous: o.isAnonymous === true,
     };
-    if (typeof type === 'number')
-        opts.type = type; // no i18n
-    if (typeof message === 'string' && message.length > 0)
-        opts.message = message; // no i18n
-    if (attachments && attachments.length > 0)
-        opts.attachments = attachments;
-    if (logFiles && logFiles.length > 0)
-        opts.logFiles = logFiles;
+    if (typeof o.type === 'number')
+        opts.type = o.type; // no i18n
+    if (typeof o.message === 'string' && o.message.length > 0)
+        opts.message = o.message; // no i18n
+    if (o.attachments && o.attachments.length > 0)
+        opts.attachments = o.attachments;
+    if (o.logFiles && o.logFiles.length > 0)
+        opts.logFiles = o.logFiles;
+    // the form brings its own styles, so an app imports or links no css
+    injectStylesheet(css);
     feedback.init(opts);
 }
-function feedbackClose() {
+/** The themes the form has: 'auto' follows the visitor's system setting. */
+const FEEDBACK_THEMES = ['light', 'dark', 'auto']; // no i18n
+/**
+ * Sets the form's theme, for a page with its own light and dark modes: 'auto' follows the
+ * operating system, which is not what such a page shows. Restyles a form or recording timer that
+ * is open now, and every one opened after; Apptics.init()'s feedback_theme only sets the first.
+ */
+function setFeedbackTheme(theme) {
+    if (FEEDBACK_THEMES.indexOf(theme) === -1) {
+        Console.warn('AppticsFeedback.setFeedbackTheme: takes \'light\', \'dark\' or \'auto\', not ' + JSON.stringify(theme)); // no i18n
+        return;
+    }
+    _ZAP._config.feedback_theme = theme;
+    if (typeof document === 'undefined') { // no i18n
+        return;
+    }
+    ['zasdkFeedbackModal', 'zasdkrectimer'].forEach(function (id) {
+        var open = document.getElementById(id);
+        if (open) {
+            open.setAttribute('data-zasdk-theme', theme); // no i18n
+        }
+    });
+}
+function feedbackFormClose() {
     feedback.close();
 }
 const feedback = {
@@ -150,31 +211,27 @@ const feedback = {
         feedback._opts = opts || {};
         var modal = document.getElementById("zasdkFeedbackModal"); // no i18n
         if (!isEmpty(modal)) {
+            // already open. A recording takes the form out of sight, and one that ended without the
+            // form hearing of it would leave it there, every later open a no-op. Asked to open, it
+            // comes back; a recording still going carries on, and its end is handled as ever
+            if (feedback.isHidden || feedback.isScaled) {
+                feedback.showForm();
+            }
             return;
         }
         const tempContainer = document.createElement('div'); // no i18n
         feedback.uploadFileAry = [];
         tempContainer.id = 'zasdkFeedbackModal'; // no i18n
         tempContainer.className = 'zasdk-modal'; // no i18n
+        tempContainer.setAttribute('data-zasdk-theme', _ZAP._config.feedback_theme); // no i18n
         tempContainer.innerHTML = feedback.feedbackUIHtml;
         document.body.appendChild(tempContainer);
         var modal = document.getElementById("zasdkFeedbackModal"); // no i18n
-        var defaultoption = _ZAP._defaultoptions;
-        var qz_ws_key = defaultoption.quartz_workspace_key;
-        var qz_dp_key = defaultoption.quartz_department_key;
-        var quartz_DC = {
-            "Local": "https://quartz.localzoho.com", // no i18n
-            "US": "https://quartz.zoho.com", // no i18n
-            "EU": "https://quartz.zoho.eu", // no i18n
-            "IN": "https://quartz.zoho.in", // no i18n
-            "AU": "https://quartz.zoho.com.au", // no i18n
-            "CN": "https://quartz.zoho.com.cn", // no i18n
-            "CA": "https://quartz.zohocloud.ca", // no i18n
-            "JP": "https://quartz.zoho.jp", // no i18n
-            "SA": "https://quartz.zoho.sa", // no i18n
-            "AE": "https://quartz.zoho.ae" // no i18n
-        };
-        var qz_dc_key = (!isEmpty(defaultoption.DC) && defaultoption.DC !== '-') ? (quartz_DC[defaultoption.DC] || '') : ''; // no i18n
+        // screen recording as the console set it up for this app (getsdkconfig's quartz block)
+        var qz = _ZAP._quartz;
+        var qz_ws_key = qz.workspace;
+        var qz_dp_key = qz.department;
+        var qz_dc_key = recordingDomain(qz.domain);
         var closeBtn = modal.querySelector("#appticsfeedbackclose"); // no i18n
         var feedbackTypes = modal.querySelectorAll(".zasdk-feedback-type"); // no i18n
         feedback.fileInput = modal.querySelector("#zasdkFileInput"); // no i18n
@@ -197,17 +254,37 @@ const feedback = {
         document.addEventListener('quartz-feedback-state', feedback.bindQuartzEvent); // no i18n
         document.removeEventListener('quartz-feedback-error', feedback.handleErrorQuartzEvent); // no i18n
         document.addEventListener('quartz-feedback-error', feedback.handleErrorQuartzEvent); // no i18n
-        // the consent checkbox and its label only when a recording can actually be made: the Quartz
-        // script on the page, a DC it knows, and both keys. "-" for any of them turns it off; DC "-"
-        // has already become '' above. A checkbox that leads only to "unavailable" is not offered
-        var recordingAvailable = hasQuartz() && !isEmpty(qz_dc_key)
-            && !isEmpty(qz_ws_key) && qz_ws_key !== "-" && !isEmpty(qz_dp_key) && qz_dp_key !== "-"; // no i18n
-        modal.querySelector("#zasdkreccheckcnt").style.display = recordingAvailable ? "block" : "none"; // no i18n
+        // the consent checkbox and its label only when a recording can actually be made: recording
+        // on for the app, its workspace, department and domain, and Quartz on the page. A checkbox
+        // that leads only to "unavailable" is not offered. Quartz is loaded here, the first time
+        // the form needs it, and the checkbox shows once it has arrived
+        var recordingConfigured = qz.enabled && !isEmpty(qz_dc_key) && !isEmpty(qz_ws_key) && !isEmpty(qz_dp_key);
+        var recordingBlock = modal.querySelector("#zasdkreccheckcnt"); // no i18n
+        recordingBlock.style.display = recordingConfigured && hasQuartz() ? "block" : "none"; // no i18n
+        if (recordingConfigured && !hasQuartz()) {
+            // quartz_cdn_url, or Zoho's CDN for this serviceUrl when the answer carries none
+            loadQuartz(quartzScriptSource(qz.cdnUrl, String(_ZAP._defaultoptions.serviceUrl || ''))).then(function (loaded) {
+                if (loaded && recordingBlock.isConnected) {
+                    recordingBlock.style.display = "block"; // no i18n
+                }
+            });
+        }
         feedbackbox.addEventListener('transitionend', function (event) {
-            if (event.propertyName === 'transform' && feedback.isScaled) { // no i18n
-                feedback.toggleWindowAnimation();
+            if (event.propertyName === 'transform') { // no i18n
+                feedback.finishHiding();
             }
         });
+        // the form, opened again while a recording goes on, says so and can stop it
+        const recStop = modal.querySelector('#zasdkRecStatusStop'); // no i18n
+        recStop.onclick = function () {
+            feedback.stopRecording();
+        };
+        recStop.onkeydown = function (e) {
+            if (e.key === 'Enter' || e.key === ' ') { // no i18n
+                e.preventDefault();
+                feedback.stopRecording();
+            }
+        };
         quartzrecbtn.onclick = function (e) {
             e.stopImmediatePropagation();
             let recordingDetails = {
@@ -229,8 +306,16 @@ const feedback = {
             quartz().startRecording(recordingDetails);
         };
         closeBtn.onclick = function () {
-            feedback.close();
+            feedback.dismiss();
+        };
+        // keyboard: Enter or Space on the close control, and Escape anywhere, close the form
+        closeBtn.onkeydown = function (e) {
+            if (e.key === 'Enter' || e.key === ' ') { // no i18n
+                e.preventDefault();
+                feedback.dismiss();
+            }
         };
+        document.addEventListener('keydown', feedback.onEscape); // no i18n
         preivewButton.addEventListener('click', function () {
             quartz().previewVideo();
         });
@@ -253,6 +338,12 @@ const feedback = {
             submitbtncnt.classList.add('zasdkbtndisabled'); // no i18n
             submitbtn.value = '';
             try {
+                if (recordingInProgress) {
+                    // sent with the recording: stopped first, and sent once Quartz has stored it
+                    sendWhenEnded = true;
+                    feedback.stopRecording();
+                    return;
+                }
                 let videoElement = modal.querySelector('#previewVideoElemId'), // no i18n
                 videoVisible = videoElement && videoElement.offsetParent !== null;
                 if (videoVisible) {
@@ -281,6 +372,11 @@ const feedback = {
             }
         });
         descriptionField.addEventListener('input', feedback.validateFeedbackField); // no i18n
+        // keyboard and screen-reader users land in the form, not behind it
+        try {
+            descriptionField.focus({ preventScroll: true });
+        }
+        catch (err) { /* focus is a courtesy */ }
         feedbackTypes.forEach(function (type) {
             type.addEventListener("click", function () {
                 feedbackTypes.forEach(function (t) {
@@ -289,7 +385,7 @@ const feedback = {
                 this.classList.add("zasdk-selected"); // no i18n
             });
         });
-        // what feedbackOpen() was given: select that type, fill the description
+        // what feedbackFormOpen() was given: select that type, fill the description
         if (typeof feedback._opts.type === 'number') { // no i18n
             var wanted = Object.keys(feedback.typeObj).filter(function (name) {
                 return feedback.typeObj[name] === feedback._opts.type;
@@ -349,6 +445,10 @@ const feedback = {
             let counterElem = elem.parentElement ? elem.parentElement.querySelector(".zaleftcharcnt") : null; // no i18n
             if (counterElem) {
                 counterElem.textContent = String(maxLength - val.length); // Update remaining count
+                var unit = counterElem.parentElement ? counterElem.parentElement.querySelector(".zaleftchartxt") : null; // no i18n
+                if (unit) {
+                    unit.textContent = maxLength - val.length === 1 ? 'character left' : 'characters left'; // no i18n
+                }
             }
         });
     },
@@ -384,7 +484,14 @@ const feedback = {
     },
     bindQuartzEvent: function (event) {
         let feedbackState = event.detail.feedbackState;
+        if (feedbackState == quartzConstants().FeedbackState.RECORDING_COMPLETED) {
+            // Quartz's own stop control and the browser's "Stop sharing" end the recording without
+            // the SDK's timer; this is the only word of it the form gets
+            feedback.recordingEnded();
+            return;
+        }
         if (feedbackState == quartzConstants().FeedbackState.RECORDING_IN_PROGRESS) {
+            recordingInProgress = true;
             var feedbacktimer = document.getElementById("zasdkrectimer"); // no i18n
             if (!isEmpty(feedbacktimer)) {
                 feedbacktimer.remove();
@@ -392,8 +499,11 @@ const feedback = {
             const tempDiv = document.createElement("div"); // no i18n
             tempDiv.innerHTML = feedback.timerHtml;
             const node = tempDiv.firstElementChild;
+            node.setAttribute('data-zasdk-theme', _ZAP._config.feedback_theme); // no i18n
             document.body.appendChild(node);
             var feedbacktimer = document.getElementById("zasdkrectimer"); // no i18n
+            // draggable anywhere on the page; wired before the click that stops the recording
+            wireTimerDrag(feedbacktimer);
             feedback.timerDisplay = feedbacktimer.querySelector('#zasdkTimerDisplay'); // no i18n
             feedback.recordButton = feedbacktimer;
             feedback.TOTAL_TIME = 5 * 60; // 5 minutes in seconds
@@ -401,13 +511,52 @@ const feedback = {
             feedback.isRecording = true;
             feedback.recordButton.addEventListener('click', feedback.toggleRecording); // no i18n
             feedback.startRecording();
+            feedback.updateDisplay();
+            feedback.showRecordingStatus(true);
             feedback.toggleWindowAnimation();
         }
     },
+    onEscape: function (e) {
+        if (e.key === 'Escape') { // no i18n
+            feedback.dismiss();
+        }
+    },
+    dismiss: function () {
+        // the form's own close (its X, Escape) during a recording puts it out of sight rather than
+        // throwing away what was typed: the recording goes on, and the next open brings it all back
+        if (recordingInProgress) {
+            if (!feedback.isScaled && !feedback.isHidden) {
+                feedback.toggleWindowAnimation();
+            }
+            return;
+        }
+        feedback.close();
+    },
+    showRecordingStatus: function (on) {
+        var modal = document.getElementById("zasdkFeedbackModal"); // no i18n
+        if (!modal) {
+            return;
+        }
+        modal.querySelector("#zasdkrecstatus").style.display = on ? "flex" : "none"; // no i18n
+        if (on) {
+            modal.querySelector("#zasdkreccheckcnt").style.display = "none"; // no i18n
+        }
+    },
     close: function () {
         var modal = document.getElementById("zasdkFeedbackModal"); // no i18n
+        document.removeEventListener('keydown', feedback.onEscape); // no i18n
         document.removeEventListener('quartz-feedback-state', feedback.bindQuartzEvent); // no i18n
         quartz().clearFeedback();
+        // the recording goes with the form: no timer left on the page, and the next form starts clean
+        recordingInProgress = false;
+        sendWhenEnded = false;
+        feedback.isRecording = false;
+        clearInterval(feedback.timerInterval || undefined);
+        feedback.timerInterval = null;
+        var timer = document.getElementById("zasdkrectimer"); // no i18n
+        if (timer) {
+            timer.remove();
+        }
         if (!isEmpty(modal)) {
             modal.remove();
         }
@@ -416,23 +565,29 @@ const feedback = {
         var modal = document.getElementById("zasdkFeedbackModal"); // no i18n
         const box = modal.querySelector('#zasdkFeedbackconatiner'); // no i18n
         if (feedback.isHidden) {
-            modal.style.display = 'block'; // no i18n
-            setTimeout(() => {
-                box.style.transform = 'scale(1)'; // no i18n
-                feedback.validateFeedbackField();
-            }, 10);
-            feedback.isHidden = false;
-            feedback.isScaled = false;
+            feedback.showForm();
         }
         else if (feedback.isScaled) {
-            modal.style.display = 'none'; // no i18n
-            feedback.isHidden = true;
+            feedback.finishHiding();
         }
         else {
+            // shrinks away (the stylesheet's transition), and is taken off the page once it has;
+            // the timeout covers a page where the transition does not run (reduced motion)
             box.style.transform = 'scale(0)'; // no i18n
+            box.style.opacity = '0'; // no i18n
             feedback.isScaled = true;
+            setTimeout(feedback.finishHiding, HIDE_MS + 50);
         }
     },
+    finishHiding: function () {
+        var modal = document.getElementById("zasdkFeedbackModal"); // no i18n
+        // once only, and not when the form was brought back meanwhile
+        if (!modal || !feedback.isScaled || feedback.isHidden) {
+            return;
+        }
+        modal.style.display = 'none'; // no i18n
+        feedback.isHidden = true;
+    },
     fileAttachment: function () {
         var uploadedFiles = feedback.fileInput.files;
         feedback.uploadTotalSize = 0;
@@ -546,16 +701,65 @@ const feedback = {
         }
     },
     stopRecording: function () {
-        var modal = document.getElementById("zasdkFeedbackModal"); // no i18n
+        if (!recordingInProgress) {
+            // Quartz has ended it already (its RECORDING_COMPLETED came first): asking again
+            // only gets a "no recording in progress" error shown in the form
+            return;
+        }
         clearInterval(feedback.timerInterval || undefined);
         feedback.timerInterval = null;
-        document.querySelector("#zasdkrectimer").remove(); // no i18n
-        feedback.toggleWindowAnimation();
+        // the preview is read from what Quartz stored, so only once the recording has ended
+        Promise.resolve(quartz().endRecording()).catch(function (err) {
+            Console.log('stopRecording: ' + err); // no i18n
+        }).then(feedback.recordingEnded);
+    },
+    recordingEnded: function () {
+        if (!recordingInProgress) {
+            return;
+        }
+        recordingInProgress = false;
+        feedback.isRecording = false;
+        clearInterval(feedback.timerInterval || undefined);
+        feedback.timerInterval = null;
+        var timer = document.getElementById("zasdkrectimer"); // no i18n
+        if (timer) {
+            timer.remove();
+        }
+        var modal = document.getElementById("zasdkFeedbackModal"); // no i18n
+        if (!modal) {
+            return; // the form was closed meanwhile
+        }
+        var send = sendWhenEnded;
+        sendWhenEnded = false;
+        feedback.showRecordingStatus(false);
+        feedback.showForm();
         modal.querySelector("#editRecordedVideo").style.display = "block"; // no i18n
         modal.querySelector("#zasdkreccheckcnt").style.display = "none"; // no i18n
         let videoElem = modal.querySelector('#previewVideoElemId'); // no i18n
-        quartz().endRecording();
-        quartz().setVideoContent(videoElem);
+        Promise.resolve(quartz().setVideoContent(videoElem)).catch(function (err) {
+            Console.warn('AppticsFeedback: the recording could not be shown: ' + err); // no i18n
+        }).then(function () {
+            if (send && document.getElementById("zasdkFeedbackModal")) { // no i18n
+                feedback.submitRecording();
+            }
+        });
+    },
+    showForm: function () {
+        // shown outright, not toggled: a recording that ends mid-way through the scale-down would
+        // otherwise be toggled out of sight instead of back into it
+        var modal = document.getElementById("zasdkFeedbackModal"); // no i18n
+        if (!modal) {
+            return;
+        }
+        const box = modal.querySelector('#zasdkFeedbackconatiner'); // no i18n
+        feedback.isHidden = false;
+        feedback.isScaled = false;
+        modal.style.display = 'block'; // no i18n
+        setTimeout(() => {
+            box.style.transform = 'scale(1)'; // no i18n
+            box.style.opacity = '1'; // no i18n
+            feedback.validateFeedbackField();
+        }, 10);
     },
     submitRecording: function () {
         var modal = document.getElementById("zasdkFeedbackModal"); // no i18n
@@ -596,7 +800,15 @@ const feedback = {
     updateDisplay: function () {
         const minutes = Math.floor(feedback.remainingTime / 60);
         const seconds = feedback.remainingTime % 60;
-        feedback.timerDisplay.textContent = `${minutes.toString().padStart(2, '0')}:${seconds.toString().padStart(2, '0')}`; // no i18n
+        const shown = `${minutes.toString().padStart(2, '0')}:${seconds.toString().padStart(2, '0')}`; // no i18n
+        if (feedback.timerDisplay) {
+            feedback.timerDisplay.textContent = shown;
+        }
+        // and in the form, for when it is opened again mid-recording
+        var inForm = document.getElementById("zasdkRecStatusTime"); // no i18n
+        if (inForm) {
+            inForm.textContent = shown;
+        }
     },
     validateFeedbackField: function () {
         feedback.updateLeftCount();
@@ -623,4 +835,4 @@ const feedback = {
     }
 };
 
-export { feedback, feedbackClose, feedbackOpen, sendFeedback };
+export { feedback, feedbackFormClose, feedbackFormOpen, sendFeedback, setFeedbackTheme };

package/dist/esm/heatmap/send.d.ts

@@ -8,6 +8,8 @@ import type { Dict, ServerResult } from '../types.js';
  *
  * Gated on the server's own heatmap flag (getsdkconfig module 18), not on engagement: an app may
  * want events while declining to have every click's coordinates recorded.
+ *
+ * The scheduler reaches it through hooks.sendHeatmaps, which src/index.ts sets.
  */
 export declare function sendHeatmapData(forget?: boolean): Promise<void>;
 export declare function requestToSendHeatmaps(_payload: Dict, forget?: boolean): Promise<ServerResult>;

package/dist/esm/heatmap/send.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.2 | (c) Zoho Corporation Private Limited | see LICENSE */
 import { _ZAP } from '../core/state.js';
 import { Console, warnAlways } from '../core/logger.js';
 import { cloneObject } from '../core/utils.js';
@@ -7,7 +7,6 @@ import { is_apptics_disabled } from '../core/env.js';
 import { shouldTrackOrSendData } from '../core/consent.js';
 import { defer, clearDefer, withSendLock, freshItems, awaitUnlessClosing, sendBatch } from '../core/batch.js';
 import { isPermanentRefusal } from '../core/transport.js';
-import { hooks } from '../core/hooks.js';
 
 /**
  * Sends queued heatmap records to heatmap/add.
@@ -18,6 +17,8 @@ import { hooks } from '../core/hooks.js';
  *
  * Gated on the server's own heatmap flag (getsdkconfig module 18), not on engagement: an app may
  * want events while declining to have every click's coordinates recorded.
+ *
+ * The scheduler reaches it through hooks.sendHeatmaps, which src/index.ts sets.
  */
 function sendHeatmapData(forget) {
     if (is_apptics_disabled() || !shouldTrackOrSendData() || !_ZAP._heatmapTracking) {
@@ -72,8 +73,5 @@ function requestToSendHeatmaps(_payload, forget) {
     var label = 'requestToSendHeatmaps'; // no i18n
     return sendBatch('heatmap', label, _payload, forget); // no i18n
 }
-// the scheduler flushes through this, so importing the heatmap entry is what puts heatmap
-// records on the flush timer at all
-hooks.sendHeatmaps = sendHeatmapData;
 
 export { requestToSendHeatmaps, sendHeatmapData };

package/dist/esm/heatmap/track.d.ts

@@ -1,4 +1,4 @@
 /** Turns capture on or off. Listeners are passive, so they never delay a click or a scroll. */
-export declare function enableHeatmap(status?: boolean): void;
+export declare function trackHeatmap(status?: boolean): void;
 /** Forgets what this visit recorded. reset() calls it; the cap starts again from zero. */
 export declare function resetHeatmapSession(): void;