@zoho_apptics/apptics-js-sdk 1.0.2 → 2.0.0-beta.1

package/dist/esm/engagement/track.js

@@ -0,0 +1,365 @@
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+import { AP_LOG_MODULE, AP_CONSTANTS, AP_CONFIG } from '../core/constants.js';
+import { _ZAP } from '../core/state.js';
+import { logFailure, Console, warnAlways } from '../core/logger.js';
+import { isEmpty, nowMs, getNewUUID } from '../core/utils.js';
+import { engagement_transactions } from '../core/storage.js';
+import { closeScreen, commitPendingSession, tabId } from './session.js';
+import { getConnectionType, getOrientation, getNetworkStatus } from '../core/env.js';
+import { canTrackEngagement } from '../core/consent.js';
+import { validateScreenName, validateEventOrGroup, validateJSON } from '../core/validate.js';
+import { noteDebugActivity } from '../core/debug.js';
+import { hooks } from '../core/hooks.js';
+import { urlTracked, normalizeApiPath } from './api-rules.js';
+import { asDefinedEvent } from './defined-events.js';
+import { automaticScreenName } from './auto-screen.js';
+
+/** Messages already printed, so a name refused in a loop says so once. */
+var refusedSaid = {};
+/**
+ * A call the SDK refused because of what the app passed it (an invalid event, group or screen
+ * name): reported as every failure is, and said in the console too, debug or not, once per
+ * message. Nothing else tells an integrator why the event or screen never shows up.
+ */
+function refused(module, message) {
+    logFailure(module, message);
+    if (!refusedSaid[message]) {
+        refusedSaid[message] = true;
+        warnAlways(message);
+    }
+}
+/**
+ * Records an event: `trackEvent(name, group?, properties?)`, or a defined event with
+ * `trackEvent(DefinedEvents.AP_USER_LOGIN, properties?)`, which brings its own group.
+ *
+ * As on Android, an invalid name or group is not logged. A group left out is `default`, so the
+ * one-argument form keeps working; a group given but invalid is a mistake worth being told about,
+ * not one to file quietly under `default`.
+ */
+function trackEvent(eventName, groupName, jsonObj) {
+    if (!canTrackEngagement('trackEvent')) { // no i18n
+        return;
+    }
+    var defined = asDefinedEvent(eventName);
+    if (defined) {
+        // the defined event's own name and group, which alone may carry the reserved AP_ prefix
+        jsonObj = (groupName && typeof groupName === 'object' ? groupName : jsonObj); // no i18n
+        groupName = defined.group;
+        eventName = defined.event;
+    }
+    else {
+        if (typeof eventName !== 'string' || !validateEventOrGroup(eventName)) { // no i18n
+            refused(AP_LOG_MODULE.EVENT, 'AppticsEvent.addEvent: Invalid eventName: ' + String(eventName)); // no i18n
+            return;
+        }
+        if (groupName === undefined || groupName === null || groupName === '') { // no i18n
+            groupName = AP_CONFIG.default_group_name;
+        }
+        else if (typeof groupName !== 'string' || !validateEventOrGroup(groupName)) { // no i18n
+            refused(AP_LOG_MODULE.EVENT, 'AppticsEvent.addEvent: Invalid groupName for "' + eventName + '": ' + String(groupName)); // no i18n
+            return;
+        }
+    }
+    jsonObj = jsonObj || {};
+    var _jsonObj = validateJSON(jsonObj);
+    // epoch time in seconds
+    var time = nowMs();
+    var eventData = {
+        id: getNewUUID(),
+        type: AP_CONSTANTS.EVENT,
+        group: groupName,
+        event: eventName,
+        starttime: time,
+        endtime: time,
+        edge: _ZAP._device_info.connectionType || getConnectionType(),
+        networkstatus: getNetworkStatus(),
+        screen: _ZAP._current_screen.screen || '', // no i18n
+        sessionstarttime: _ZAP._current_session.starttime || time,
+        customproperties: _jsonObj
+    };
+    // save the event
+    // the session may still be waiting out its minimum; this event is what earns it
+    commitPendingSession();
+    noteDebugActivity();
+    engagement_transactions.add(eventData);
+    Console.log('AppticsEvent.addEvent(\'' + eventName + '\',\'' + groupName + '\',' + JSON.stringify(_jsonObj || {}) + ')'); // no i18n
+    Console.dir(eventData);
+}
+/**
+ * The app's own screen view with a known id and start. The public inScreen takes the id and the
+ * time when the app calls it, so the id it hands back is the view's even when start-up is still
+ * running and this runs a moment later.
+ */
+function inScreenAt(screenName, jsonObj, id, startedAt) {
+    if (!validateScreenName(screenName)) {
+        refused(AP_LOG_MODULE.SCREEN, 'AppticsScreen.inScreen: Invalid screenName: ' + String(screenName)); // no i18n
+        return;
+    }
+    // the app named this screen itself: the automatic view of the same navigation gives way to it
+    hooks.screenTrackedByApp();
+    recordScreen(screenName, jsonObj, id, startedAt);
+}
+/** Ends the screen view inScreen() began, as Android's AppticsScreenTracker.outScreen(id). */
+function outScreenAt(id, endedAt) {
+    if (isEmpty(id)) {
+        logFailure(AP_LOG_MODULE.SCREEN, 'AppticsScreen.outScreen: no screen id given'); // no i18n
+        return;
+    }
+    closeScreen(id, endedAt);
+}
+/**
+ * Queues a screen view and makes it the current screen.
+ *
+ * The view is stored open (endtime 0) and closed when the next screen starts, when the page is
+ * hidden or closed, when its session ends, or by outScreen() — which is what gives it a duration.
+ * An open view is not sent until it is closed, as an open session is not.
+ */
+function recordScreen(screenName, jsonObj, id, startedAt, implicit) {
+    if (!canTrackEngagement('inScreen')) { // no i18n
+        return;
+    }
+    if (!validateScreenName(screenName)) {
+        refused(AP_LOG_MODULE.SCREEN, 'AppticsScreen.inScreen: Invalid screenName: ' + String(screenName)); // no i18n
+        return;
+    }
+    jsonObj = jsonObj || {};
+    var _jsonObj = validateJSON(jsonObj);
+    // epoch time in milliseconds
+    var time = typeof startedAt === 'number' ? startedAt : nowMs(); // no i18n
+    var screenData = {
+        id: id || getNewUUID(),
+        type: AP_CONSTANTS.SCREEN,
+        screen: screenName,
+        starttime: time,
+        endtime: 0,
+        edge: _ZAP._device_info.connectionType || getConnectionType(),
+        networkstatus: getNetworkStatus(),
+        orientation: getOrientation(),
+        sessionstarttime: _ZAP._current_session.starttime || time,
+        customproperties: _jsonObj,
+        // the tab showing it, so a tab that is gone can have its view ended (closeScreensOfGoneTabs).
+        // SDK bookkeeping, removed before sending, as lastseen is
+        tab: tabId(),
+    };
+    // the screen being left ends where this one starts
+    var previous = _ZAP._current_screen && _ZAP._current_screen.id;
+    if (previous && previous !== screenData.id) {
+        closeScreen(previous, time);
+    }
+    commitPendingSession();
+    noteDebugActivity();
+    engagement_transactions.add(screenData);
+    // `implicit`: a view recorded only so a heatmap record has one to belong to. Kept on the
+    // in-memory copy alone, never on the stored item, which goes to the server as it is
+    _ZAP._current_screen = implicit ? Object.assign({}, screenData, { implicit: true }) : screenData;
+    Console.log('AppticsScreen.inScreen(\'' + screenName + '\',' + JSON.stringify(_jsonObj || {}) + ')'); // no i18n
+    Console.dir(screenData);
+}
+/**
+ * The screen a heatmap record belongs to, making sure engagement/add has a view of it: the console
+ * places a record by its screen, and a screen that was never sent as a view leaves it nowhere.
+ *
+ * A screen the app or automatic screen tracking named is used as it is — that one already has its
+ * view. Otherwise (automatic tracking off and no inScreen() call) the page is named the way
+ * automatic tracking would name it, and a view is recorded for it: once per screen, a new one when
+ * the path changes, and given way as soon as anything else names the screen.
+ */
+function screenForRecord() {
+    var current = _ZAP._current_screen;
+    if (current && !isEmpty(current.screen) && !current.implicit) {
+        return String(current.screen);
+    }
+    var name = automaticScreenName() || '/'; // no i18n
+    if (!current || !current.id || current.screen !== name || current.endtime) {
+        recordScreen(name, undefined, undefined, undefined, true);
+    }
+    return name;
+}
+/**
+ * Back in view after being hidden: the hide ended the screen view, so the screen the user is on
+ * starts a new one, as an Android activity coming back to the foreground does.
+ */
+function resumeScreen() {
+    var current = _ZAP._current_screen;
+    if (!current || !current.id || !current.endtime || isEmpty(current.screen)) {
+        return;
+    }
+    recordScreen(String(current.screen));
+}
+/**
+ * What the proxy accepts as an api item's hostname and path (security-regex.xml: api_hostname,
+ * api_urlpath). It validates these before the server sees them, and a rejected item is dropped
+ * there — nothing reaches the console and nothing says why. Checking here means trackApi can
+ * repair or refuse the value while there is still a caller to tell.
+ */
+const API_HOSTNAME = /^([a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+[a-zA-Z]{2,}$/;
+const API_PATH_DISALLOWED = /[^a-zA-Z0-9\-._*\/]+/g;
+/**
+ * Rewrites a path to the characters the proxy allows, one `*` per run of anything else, so an id
+ * that happens to hold an email or an encoded character costs that segment's detail rather than
+ * the whole call. Segment boundaries survive, which is what the console groups by.
+ */
+function sanitizeApiPath(path) {
+    if (isEmpty(path)) {
+        return '/'; // no i18n
+    }
+    var cleaned = path.replace(API_PATH_DISALLOWED, '*'); // no i18n
+    return cleaned.charAt(0) === '/' ? cleaned : '/' + cleaned; // no i18n
+}
+/** A path for a log line, without the query, which can carry tokens. */
+function withoutQueryForLog(path) {
+    return String(path || '').split(/[?#]/)[0]; // no i18n
+}
+function trackApi(jsonObj) {
+    if (!canTrackEngagement('trackApi')) { // no i18n
+        return;
+    }
+    jsonObj = jsonObj || {};
+    // Extract raw values from jsonObj (from XHR/fetch hook or manual calls)
+    var rawUrl = jsonObj.url || jsonObj.path || '';
+    var method = (jsonObj.method || 'GET').toString();
+    var responsecode = (typeof jsonObj.responsecode === 'number') ? jsonObj.responsecode :
+        (typeof jsonObj.status === 'number') ? jsonObj.status : 0;
+    // the template requires this key, and fetch leaves statusText empty on HTTP/2, so a
+    // placeholder stands in rather than risking the item being refused for an empty value
+    var responsemessage = jsonObj.responsemessage || jsonObj.statusText || jsonObj.error || '-';
+    // Time fields (ms since epoch, consistent with other trackers)
+    var now = nowMs();
+    var starttime = (typeof jsonObj.starttime === 'number') ? jsonObj.starttime : now;
+    var endtime;
+    if (typeof jsonObj.endtime === 'number') {
+        endtime = jsonObj.endtime;
+    }
+    else if (typeof jsonObj.duration === 'number') {
+        endtime = starttime + jsonObj.duration;
+    }
+    else {
+        endtime = now;
+    }
+    // URL breakdown: scheme, hostname, port, path
+    var scheme = jsonObj.scheme || '';
+    var hostname = jsonObj.hostname || '';
+    var port = (typeof jsonObj.port === 'number') ? jsonObj.port : 0;
+    var path = jsonObj.path || '';
+    // a call reported by its parts, a hostname and a path with no url: its scheme and port are its
+    // own (https and 443 unless given), not the page's, which belong to another host
+    var partsOnly = isEmpty(jsonObj.url) && !isEmpty(jsonObj.hostname);
+    if (!isEmpty(rawUrl)) {
+        try {
+            var urlObj = new URL(rawUrl, window.location.origin);
+            if (isEmpty(scheme) && !partsOnly) {
+                scheme = urlObj.protocol.replace(':', ''); // "https:"
+            }
+            if (isEmpty(hostname)) {
+                hostname = urlObj.hostname;
+            }
+            if (!port && !partsOnly) {
+                if (urlObj.port) {
+                    port = parseInt(urlObj.port, 10);
+                }
+                else {
+                    port = (urlObj.protocol === 'https:') ? 443 : 80;
+                }
+            }
+            if (isEmpty(path)) {
+                path = urlObj.pathname;
+            }
+        }
+        catch (e) {
+            // Fallback: treat rawUrl as path if parsing fails
+            if (isEmpty(path)) {
+                path = rawUrl;
+            }
+        }
+    }
+    // only http and https exist as far as the proxy's api_scheme is concerned
+    scheme = (scheme === 'https' || scheme === 'http') ? scheme : 'https'; // no i18n
+    if (!port) {
+        port = scheme === 'https' ? 443 : 80; // no i18n
+    }
+    // a hostname the proxy refuses cannot be repaired without inventing one, so the call is
+    // dropped here and said out loud. localhost and bare IPs land here: api_hostname wants at
+    // least one dot and an alphabetic suffix, which is worth knowing when nothing shows up locally
+    if (!API_HOSTNAME.test(hostname)) {
+        logFailure(AP_LOG_MODULE.API, 'AppticsApi: hostname not accepted by the server: ' + String(hostname)); // no i18n
+        return;
+    }
+    // configureApiTracking: the app's rules decide whether this call is recorded at all, tried on
+    // the URL as it was called, without its query
+    var defaultPort = (scheme === 'https' && port === 443) || (scheme === 'http' && port === 80); // no i18n
+    var calledUrl = scheme + '://' + hostname + (port && !defaultPort ? ':' + port : '') + (String(path).charAt(0) === '/' ? '' : '/') + path; // no i18n
+    if (!urlTracked(calledUrl)) {
+        Console.log('AppticsApi: ' + hostname + withoutQueryForLog(path) + ' is left out by configureApiTracking'); // no i18n
+        return;
+    }
+    // and the name it is recorded under: ids become *, so the console groups calls by endpoint
+    // rather than by every id that went through it
+    path = sanitizeApiPath(normalizeApiPath(path));
+    var sessionStart = _ZAP._current_session.starttime || starttime;
+    // no customproperties: apiWebSDK does not declare the key, unlike the screen and event
+    // templates, so anything extra the caller passes is context for the log line only
+    var apiData = {
+        id: getNewUUID(),
+        type: AP_CONSTANTS.API,
+        // Required by backend schema
+        scheme: scheme,
+        port: port,
+        hostname: hostname,
+        path: path,
+        method: method,
+        responsecode: responsecode,
+        responsemessage: responsemessage,
+        starttime: starttime,
+        endtime: endtime,
+        sessionstarttime: sessionStart,
+        networkstatus: getNetworkStatus(),
+        edge: _ZAP._device_info.connectionType || getConnectionType()
+    };
+    // save the api
+    commitPendingSession();
+    noteDebugActivity();
+    engagement_transactions.add(apiData);
+    Console.log('AppticsApi(\'' + method + ' ' + scheme + '://' + hostname + path + '\')'); // no i18n
+    Console.dir(apiData);
+}
+/** Begun calls by id. Bounded, so an app that starts calls it never ends can't grow it forever. */
+var openCalls = {};
+var openOrder = [];
+const MAX_OPEN_CALLS = 500;
+/**
+ * Begins timing one API call, as Android's AppticsApiTracker.startTrackApi(url, method): returns
+ * the id to hand to endTrackApi once the response is in. Records nothing by itself.
+ */
+function startTrackApi(url, method) {
+    var id = getNewUUID();
+    openCalls[id] = { url: String(url || ''), method: String(method || 'GET').toUpperCase(), starttime: nowMs() }; // no i18n
+    openOrder.push(id);
+    if (openOrder.length > MAX_OPEN_CALLS) {
+        delete openCalls[openOrder.shift()];
+    }
+    return id;
+}
+/**
+ * Finishes a call startTrackApi began and records it, timed from start to `endedAt`. The public
+ * wrapper takes `endedAt` when the app calls it, so a call ended while start-up is still running
+ * keeps its real duration even though it is recorded a moment later.
+ */
+function endTrackApiAt(id, responseCode, responseMessage, endedAt) {
+    var open = openCalls[id];
+    if (!open) {
+        logFailure(AP_LOG_MODULE.API, 'AppticsApi.endTrackApi: no call started with id ' + String(id)); // no i18n
+        return;
+    }
+    delete openCalls[id];
+    openOrder = openOrder.filter(function (one) { return one !== id; });
+    trackApi({
+        url: open.url,
+        method: open.method,
+        responsecode: typeof responseCode === 'number' ? responseCode : 0, // no i18n
+        responsemessage: responseMessage,
+        starttime: open.starttime,
+        endtime: endedAt,
+    });
+}
+
+export { endTrackApiAt, inScreenAt, outScreenAt, recordScreen, resumeScreen, screenForRecord, startTrackApi, trackApi, trackEvent };

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

@@ -0,0 +1,6 @@
+import type { Dict, ServerResult } from '../types.js';
+/**
+ * Sends pending errors to the Apptics API.
+ */
+export declare function sendErrorData(forget?: boolean): Promise<void>;
+export declare function requestToSendErrors(_payload: Dict, forget?: boolean): Promise<ServerResult>;

package/dist/esm/errors/send.js

@@ -0,0 +1,70 @@
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (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';
+import { error_transactions } from '../core/storage.js';
+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';
+
+/**
+ * Sends pending errors to the Apptics API.
+ */
+function sendErrorData(forget) {
+    // errortracking off (getupdates): queued errors stay until tracking is back on or they expire
+    if (is_apptics_disabled() || !shouldTrackOrSendData() || !_ZAP._errorTracking) {
+        return Promise.resolve();
+    }
+    if (navigator.onLine == false) {
+        Console.warn('sendErrorData: No Network'); // no i18n
+        return Promise.resolve();
+    }
+    // if we're busy sending, retry in .5s
+    if (_ZAP._sending) {
+        defer(sendErrorData);
+        return Promise.resolve();
+    }
+    _ZAP._sending = true;
+    clearDefer();
+    return withSendLock('errors', function () {
+        return freshItems(error_transactions, function (item) { return item.happenedat != 0; }, function (item) { return item.happenedat; }).then(function (error_items) {
+            if (error_items.length == 0) {
+                return;
+            }
+            let exceptiondetails = [];
+            var sent = [];
+            cloneObject(error_items).forEach(function (item) {
+                sent.push({ ...item });
+                if (!item.hasOwnProperty('screenname')) { // no i18n
+                    item.screenname = ''; // no i18n
+                }
+                delete item.id;
+                delete item.type;
+                exceptiondetails.push(item);
+            });
+            return awaitUnlessClosing(requestToSendErrors({ exceptiondetails: exceptiondetails }, forget).then(function () {
+                return error_transactions.remove(sent);
+            }, function (err) {
+                // the server will never accept this batch. Keeping it would block every later
+                // batch behind it for good, so it is dropped and said out loud
+                if (isPermanentRefusal(err)) {
+                    warnAlways('apptics: the server refused these errors, so they were dropped: ' + String(err && err.message)); // no i18n
+                    return error_transactions.remove(sent);
+                }
+                return Promise.reject(err);
+            }), forget, 'sendErrorData'); // no i18n
+        });
+    }).catch(function (err) {
+        Console.log('sendErrorData:' + err); // no i18n
+    }).then(function () {
+        _ZAP._sending = false;
+    });
+}
+// Function to send error data to server
+function requestToSendErrors(_payload, forget) {
+    var label = 'requestToSendErrors'; // no i18n
+    return sendBatch('error', label, _payload, forget); // no i18n
+}
+
+export { requestToSendErrors, sendErrorData };

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

@@ -0,0 +1,4 @@
+import type { Properties } from '../types.js';
+export declare function trackError(errorEvent: any, jsonObj?: Properties): void;
+export declare function trackGlobalErrorHandler(status?: boolean): void;
+export declare function extractMethodNameFromStackTrace(stackTrace: string): string;

package/dist/esm/errors/track.js

@@ -0,0 +1,163 @@
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+import { AP_CONSTANTS } from '../core/constants.js';
+import { _ZAP } from '../core/state.js';
+import { Console } from '../core/logger.js';
+import { isEmpty, nowMs, getNewUUID } from '../core/utils.js';
+import { error_transactions } from '../core/storage.js';
+import { commitPendingSession } from '../engagement/session.js';
+import { getConnectionType, getNetworkStatus } from '../core/env.js';
+import { canTrackErrors } from '../core/consent.js';
+import { validateJSON } from '../core/validate.js';
+import { noteDebugActivity } from '../core/debug.js';
+
+/**
+ * The stack to report. Three sources, in order of how much they tell us:
+ *
+ * `reason.stack` and `error.stack` are where a promise rejection and a window error event keep it.
+ * `errorEvent.stack` covers an Error handed straight to trackError — `trackError(new Error('x'))`
+ * is the first thing anyone writes, and reading only the wrapped forms lost its trace silently.
+ *
+ * Failing all of those, a cross-origin script error or a non-Error throw carries no stack at all,
+ * and the event's own filename, line and column are the only detail there is, so they are written
+ * as a one-frame stack rather than discarded.
+ */
+function stackOf(errorEvent) {
+    var stack = errorEvent.reason?.stack || errorEvent.error?.stack || errorEvent.stack || ''; // no i18n
+    if (!isEmpty(stack)) {
+        return stack;
+    }
+    var file = errorEvent.filename || errorEvent.fileName || ''; // no i18n
+    if (isEmpty(file)) {
+        return ''; // no i18n
+    }
+    var line = errorEvent.lineno !== undefined ? errorEvent.lineno : errorEvent.lineNumber;
+    var column = errorEvent.colno !== undefined ? errorEvent.colno : errorEvent.columnNumber;
+    return 'at ' + file + (isEmpty(line) ? '' : ':' + line) + (isEmpty(column) ? '' : ':' + column); // no i18n
+}
+/** Said in place of a stack when there is none, so `message` is never sent empty. */
+const NO_STACK = 'no stack available'; // no i18n
+/** The element an event came from, as `<script src="…">`, so a failed load says what failed. */
+function describeTarget(target) {
+    var el = target;
+    if (!el || typeof el.tagName !== 'string') { // no i18n
+        return ''; // no i18n
+    }
+    var tag = el.tagName.toLowerCase();
+    var url = el.currentSrc || el.src || el.href || ''; // no i18n
+    return ' on <' + tag + (url ? (el.href && !el.src ? ' href="' : ' src="') + url + '"' : '') + '>'; // no i18n
+}
+/**
+ * What was thrown or rejected, as text an issue can be named by. An Error reads as itself. A
+ * promise rejected with an Event - what a failed script or image load hands over - used to be
+ * recorded as "[object Event]"; it is named by its type and where it came from instead. Anything
+ * else that is an object is shown as its JSON, cut short.
+ */
+function describeThrown(thrown) {
+    if (thrown === null || thrown === undefined) {
+        return ''; // no i18n
+    }
+    if (typeof thrown !== 'object') { // no i18n
+        return String(thrown);
+    }
+    if (thrown instanceof Error || typeof thrown.message === 'string' && typeof thrown.name === 'string') { // no i18n
+        return String(thrown);
+    }
+    if (typeof Event !== 'undefined' && thrown instanceof Event) { // no i18n
+        return 'Event "' + thrown.type + '"' + describeTarget(thrown.target); // no i18n
+    }
+    var text = String(thrown);
+    if (text !== '[object Object]') { // no i18n
+        return text;
+    }
+    try {
+        return JSON.stringify(thrown).slice(0, 300);
+    }
+    catch (err) {
+        return text;
+    }
+}
+function trackError(errorEvent, jsonObj) {
+    if (!canTrackErrors('trackError')) { // no i18n
+        return;
+    }
+    if (isEmpty(errorEvent)) {
+        Console.warn('AppticsError.trackError: Invalid error'); // no i18n
+        return;
+    }
+    var _jsonObj = validateJSON(jsonObj);
+    var stack = stackOf(errorEvent);
+    var methodName = extractMethodNameFromStackTrace(stack) || "";
+    var issuetype = errorEvent.type || "";
+    var thrown = describeThrown(errorEvent.reason || errorEvent.error || errorEvent.message || "");
+    // "Error: x at handler", or just "Error: x" when the stack names no method. issuename is
+    // required too, so something that carried no message at all is still named rather than blank
+    var described = !isEmpty(String(thrown)) ? String(thrown) : (!isEmpty(issuetype) ? String(issuetype) : 'Unknown error'); // no i18n
+    var message = described + (isEmpty(methodName) ? "" : ' at ' + methodName);
+    // epoch time in seconds
+    var time = nowMs();
+    var errorData = {
+        id: getNewUUID(),
+        type: AP_CONSTANTS.ERROR,
+        edge: _ZAP._device_info.connectionType || getConnectionType(),
+        networkstatus: getNetworkStatus(),
+        happenedat: time,
+        issuename: message,
+        // the template requires this key, so a stackless error still says something: an empty value
+        // risks the proxy refusing the item, and errors travel in batches
+        message: !isEmpty(stack) ? stack : (!isEmpty(String(thrown)) ? String(thrown) : NO_STACK),
+        screenname: _ZAP._current_screen.screen || window.location.pathname,
+        sessionstarttime: _ZAP._current_session.starttime || time,
+        customproperties: _jsonObj
+    };
+    // save the error
+    // an error is worth a session even in the first seconds of a visit
+    commitPendingSession();
+    noteDebugActivity();
+    error_transactions.add(errorData);
+    Console.log('AppticsError.trackError(\'' + issuetype + '\',\'' + message + '\',' + JSON.stringify(_jsonObj || {}) + ')'); // no i18n
+    Console.dir(errorData);
+}
+function trackGlobalErrorHandler(status) {
+    _ZAP._isGlobalErrorTracking = typeof status === "boolean" ? status : true; // no i18n
+}
+function extractMethodNameFromStackTrace(stackTrace) {
+    let methodName = ''; // no i18n
+    if (isEmpty(stackTrace)) {
+        return methodName;
+    }
+    const lines = stackTrace.split('\n'); // no i18n
+    if (lines.length < 2) {
+        return methodName; // Not enough information in the stack trace
+    }
+    // The method name is typically included in the second line
+    const methodNamePattern1 = /at (\S+) \(/;
+    const methodNamePattern2 = /^(\w+)@/;
+    for (let line of lines) {
+        const match1 = line.match(methodNamePattern1);
+        const match2 = line.match(methodNamePattern2);
+        // For browsers like Chrome, Ula
+        if (match1 && match1[1]) {
+            // Return the method name
+            const urlRegex = /\((.*)\)/;
+            // Extract the URL from the error string
+            const urlMatch = urlRegex.exec(line);
+            // Extracted URL
+            const url = urlMatch ? urlMatch[1] : 'Unknown URL'; // no i18n
+            methodName = match1[1];
+            url.split('/').pop(); // no i18n
+            methodName = methodName; // + '@'+ fileNameAndLine;
+            break;
+        }
+        // For browsers like Safari
+        if (match2 && match2[1]) {
+            // Return the method name
+            methodName = match2[1];
+            line.split('@')[1].split('/').pop(); // no i18n
+            methodName = methodName; // + '@'+ fileNameAndLine; // no i18n
+            break;
+        }
+    }
+    return methodName;
+}
+
+export { extractMethodNameFromStackTrace, trackError, trackGlobalErrorHandler };

package/dist/esm/feedback/controls.d.ts

@@ -0,0 +1,37 @@
+import type { Dict } from '../types.js';
+/** Who the next submission is attributed to: the picked user, or nobody. */
+export interface UserChoice {
+    anonymous: boolean;
+    userid: string;
+    groupid: string;
+}
+/** Read by core/transport when it builds the feedback request's parameters. */
+export declare const userChoice: UserChoice;
+/** Whether the next submission carries the stored logs and diagnostics. Unset means "decide from what is stored". */
+export declare const logChoice: {
+    includeLog?: boolean;
+    includeDyninfo?: boolean;
+};
+/**
+ * Who a sendFeedback() report, made without the form, is attributed to: nobody when `anonymous`,
+ * else the user AppticsUser.setUser set (or the active registered one, status 1). Returns a function
+ * that puts back the choice that was there, so a form left open keeps its own.
+ */
+export declare function chooseUserForSend(anonymous: boolean): () => void;
+/**
+ * The "User" dropdown above the description. It lists Anonymous plus every registered user, and
+ * starts on the active one (status 1) unless the caller asked for anonymous.
+ */
+export declare function wireUserPicker(modal: HTMLElement, forceAnonymous: boolean): void;
+/**
+ * The two "Include …" switches and the viewer behind their View links. A row is shown only when
+ * there is something to include, and is then on by default, so a submission carries what the app
+ * recorded unless the user turns it off.
+ */
+export declare function wireLogControls(modal: HTMLElement, opts: Dict): void;
+/**
+ * Drags the dialog by its header. The right/bottom placement from the stylesheet is converted to
+ * an explicit left/top on the first drag, so the offsets have something to add to, and the box is
+ * kept inside the viewport.
+ */
+export declare function wireDrag(box: HTMLElement): void;