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

package/dist/cjs/types.d.ts

@@ -1,8 +1,15 @@
 import type { AP_FEEDBACK_TYPE, AP_TRACKING_STATUS } from './core/constants.js';
 import type { UserBuilder } from './user/index.js';
 import type { ApiTrackingBuilder, ApiTrackingConfig } from './engagement/api-rules.js';
-import type { DefinedEvent } from './engagement/defined-events.js';
-import type { AppticsLogger } from './remotelog/logger.js';
+import type { DefinedEvent, DefinedEvents } from './engagement/defined-events.js';
+/** One entry of screen_routes: a route pattern, or an exact path or a regular expression with the name to record. */
+export type ScreenRoute = string | {
+    equals: string;
+    name: string;
+} | {
+    regex: RegExp | string;
+    name: string;
+};
 /** Loose record for legacy payloads and server JSON that are built and sent as-is. */
 export type Dict = Record<string, any>;
 /** An item in the engagement or error queue. */
@@ -32,12 +39,12 @@ export type FeedbackType = (typeof AP_FEEDBACK_TYPE)[keyof typeof AP_FEEDBACK_TY
 export type Properties = Record<string, unknown>;
 /** The config init() requires. The console snippet provides the same shape as window.appticssettings._defaultoptions. */
 export interface AppticsConfig {
-    /** Apptics host every request goes to, e.g. https://apptics.localzoho.com (a trailing slash is ignored). */
-    serviceUrl: string;
-    /** The app's token, sent as the `zak` header on app/addversion and device registration. */
-    zak: string;
-    /** App identifier, e.g. com.zoho.web.zylker. */
-    identifier: string;
+    /** Apptics host every request goes to, e.g. https://apptics.zoho.com (a trailing slash is ignored). Was `serviceUrl`. */
+    base_url: string;
+    /** The app's key from the console, sent as the `zak` header on app/addversion and device registration. Was `zak`. */
+    auth_key: string;
+    /** The app's domain as registered in the console, e.g. com.zoho.web.zylker. Was `identifier`. */
+    app_domain: string;
     /**
      * Your app's version or build number, e.g. '2.4.0' or 512. Required: everything the SDK reports
      * is only meaningful against the build it came from, so there is no default. Changing it
@@ -54,12 +61,10 @@ export interface AppticsConfig {
     zsoid?: string;
     /** @deprecated ignored: app/addversion answers with the project id */
     projectID?: string;
-    /** @deprecated console-snippet name for serviceUrl */
+    /** @deprecated 1.x console-snippet name for base_url: still read, with a warning */
     base_domain?: string;
-    /** @deprecated console-snippet name for zak */
+    /** @deprecated 1.x console-snippet name for auth_key: still read, with a warning */
     token?: string;
-    /** Data centre key for Quartz screen recording: US, EU, IN, AU, CN, CA, JP, SA, AE, Local, or '-' to disable. */
-    DC?: string;
     /**
      * Debug mode: send engagement, exception and log payloads to their `debug/` twins, which answer
      * with a request id and a link to the server's own logs, for following in the Apptics web
@@ -69,17 +74,10 @@ export interface AppticsConfig {
     /** Log the SDK's own activity to the browser console. Off by default. */
     console_log?: boolean;
     ignore_do_not_track?: boolean;
-    /**
-     * Send the SDK's own failures to console/addlog, so they can be read from the Apptics console.
-     * This carries no app data: one line per failure, tagged with the SDK module it happened in.
-     */
-    remote_log?: boolean;
-    quartz_workspace_key?: string;
-    quartz_department_key?: string;
     /**
      * Record the app's API calls automatically, by wrapping XHR and fetch. Off by default. The SDK's
      * own requests are never recorded. Which hosts and endpoints are recorded, and under what path,
-     * is set with configureApiTracking(new ApiTrackingBuilder()...build()).
+     * is set with AppticsApi.configure(new AppticsApi.ApiTrackingBuilder()...build()).
      */
     track_api?: boolean;
     /**
@@ -90,15 +88,21 @@ export interface AppticsConfig {
      */
     track_screen?: boolean;
     /**
-     * Print each `logger` line to the browser console too, at its level, as Android's showLogs
-     * prints to Logcat. Off by default. `console_log` is the SDK's own activity; this is the app's lines.
+     * How automatic screen tracking names a path, tried in order; the first that matches wins, and a
+     * path none matches keeps its own name. Each entry is one of:
+     * - a route pattern, `'/users/{id}/orders'`: `{name}`, `:name` and `*` each match one segment,
+     *   recorded as a star, so `/users/42/orders` and `/users/43/orders` are one screen;
+     * - `{ equals: '/', name: 'Home' }`: that path exactly;
+     * - `{ regex: /^\/orders\/\d+$/, name: 'Order detail' }`: any path the regular expression matches.
+     * Paths are matched without their query string.
      */
-    show_logs?: boolean;
+    screen_routes?: ScreenRoute[];
     /**
-     * Record sessions automatically. On by default; `false` records no sessions, while events,
-     * screens and the rest still are — Android's `automaticSessionsTrackingStatus = false`.
+     * The feedback form's theme: 'light', 'dark', or 'auto' (the default) to follow the visitor's
+     * system setting. The colors are CSS variables on the form (`--zasdk-primary-color` and the rest
+     * of the `--zasdk-*` set), which a page may override.
      */
-    track_session?: boolean;
+    feedback_theme?: 'light' | 'dark' | 'auto';
     /** How often queued data is sent, in milliseconds. Default 30000, at least 1000. */
     batch_flush_interval?: number;
     /** How often the server's tracking flags are fetched, in milliseconds. Default 120000, at least 10000. */
@@ -116,8 +120,8 @@ export interface AppticsConfig {
      */
     min_session_duration?: number;
     /**
-     * Record where people click and how far they scroll. Off by default, and it does nothing unless
-     * the app also imports '@zoho_apptics/apptics-js-sdk/heatmap'.
+     * Record where people click and how far they scroll. Off by default; AppticsHeatmap.trackHeatmap()
+     * switches it later.
      */
     track_heatmap?: boolean;
     /** Most heatmap records one visit may produce. Default 500; capture pauses past it. */
@@ -140,6 +144,26 @@ export interface UserValidationResult {
         keys: string[];
     }>;
 }
+/**
+ * Screen recording in the feedback form, as getsdkconfig's `quartz` block sets it up:
+ *   { quartz_enabled, quartz_workspace, quartz_department, quartz_domain, quartz_cdn_url }
+ * The app passes none of it; the console's settings for the app decide.
+ */
+export interface QuartzSettings {
+    enabled: boolean;
+    /** quartz_workspace: the workspace the recording is filed under. */
+    workspace: string;
+    /** quartz_department: the department within it. */
+    department: string;
+    /** quartz_domain, e.g. zoho.com: recordings go to https://quartz.<domain>. */
+    domain: string;
+    /**
+     * quartz_cdn_url: the Quartz script, loaded by the SDK when the form needs it. When the answer
+     * has none, the SDK uses Zoho's CDN for the serviceUrl (static.localzohocdn.com for localzoho,
+     * static.zohocdn.com otherwise).
+     */
+    cdnUrl: string;
+}
 export interface QuartzApi {
     startRecording(details: {
         workspaceLinkName: string;
@@ -216,97 +240,146 @@ export interface HeatmapRecord {
     is_rage_click: 0 | 1;
     is_dead_click: 0 | 1;
 }
-/** What `AppticsTrackError` accepts: a window `error` / `unhandledrejection` event or the same shape. */
+/** What `AppticsError.trackError` accepts: a window `error` / `unhandledrejection` event or the same shape. */
 export type ErrorLike = Event | {
     type?: string;
     error?: unknown;
     reason?: unknown;
 };
+/** What sendFeedback() sends. Every key is optional. */
+export interface SendFeedbackOptions {
+    /** AppticsFeedback.AP_FEEDBACK_TYPE: BUG (0), FEEDBACK (1, the default), HELP (2), REPORT (3). */
+    type?: FeedbackType;
+    /** The feedback's text. */
+    message?: string;
+    /** Files to attach: at most 5, 10 MB in all. */
+    attachments?: FileList | File[] | null;
+    /** Log files of the app's own to send along. */
+    logFiles?: FileList | File[] | null;
+    /** The addDiagnosticsInfo() entries and the device's details: unset sends them when there are entries waiting. */
+    includeDiagnostics?: boolean;
+    /** The addFeedbackLog() lines: unset sends them when there are any, false never does. */
+    includeLog?: boolean;
+    /** Sends it from nobody. Unset, it is from the active user AppticsUser.setUser registered. */
+    isAnonymous?: boolean;
+}
+/** What feedbackFormOpen() fills the form in with. Every key is optional. */
+export interface FeedbackOpenOptions {
+    /** The tab the form opens on: AppticsFeedback.AP_FEEDBACK_TYPE.BUG, FEEDBACK, HELP or REPORT. */
+    type?: FeedbackType;
+    /** Text already in the description. */
+    message?: string;
+    /** Starts the logs toggle on. */
+    includeLog?: boolean;
+    /** Starts the diagnostics toggle on. */
+    includeDiagnostics?: boolean;
+    /** Files already attached: at most 5, 10 MB in all. */
+    attachments?: FileList | File[] | null;
+    /** Log files of the app's own already attached. */
+    logFiles?: FileList | File[] | null;
+    /** Starts the user picker on Anonymous, even with a user registered. */
+    isAnonymous?: boolean;
+}
 /** The optional feedback modal, from '@zoho_apptics/apptics-js-sdk/feedback'. */
 export interface AppticsFeedbackApi {
     /**
      * Sends feedback without the form. Resolves once it is sent; rejects when it wasn't: the SDK
      * has not started (no init()), the browser is offline, or the server refused it.
      */
-    sendFeedback(type?: FeedbackType, message?: string, attachments?: FileList | File[] | null, logFiles?: FileList | File[] | null, 
-    /** dyninfo.txt (diagnostics entries + device info): unset sends it when diagnostics are waiting. */
-    includeDyninfo?: boolean, 
-    /** Stored addFeedbackLog() lines: unset sends them when there are any, false never does. */
-    includeLog?: boolean): Promise<void>;
+    sendFeedback(options?: SendFeedbackOptions): Promise<void>;
+    /** Opens the form, filled in with `options` when they are given. */
+    feedbackFormOpen(options?: FeedbackOpenOptions): void;
+    feedbackFormClose(): void;
+    /** The feedback types: BUG, FEEDBACK, HELP, REPORT. */
+    AP_FEEDBACK_TYPE: typeof AP_FEEDBACK_TYPE;
+    /** Records a timestamped line, sent as feedbacklog.txt with the next feedback submission. */
+    addFeedbackLog(message: string): void;
+    /** Records a diagnostics key/value under `heading`, sent inside dyninfo.txt with the next feedback. */
+    addDiagnosticsInfo(heading: string, key: string, value: unknown): void;
     /**
-     * Opens the form. Every argument is optional: `type` and `message` pre-fill it, the include
-     * flags start the log and diagnostics toggles on, and `isAnonymous` starts the user picker on
-     * Anonymous even when a user is registered.
+     * The form's theme from now on, restyling one open now: 'light', 'dark', or 'auto' to follow
+     * the visitor's system setting. For a page with its own theme switch, called as it changes.
      */
-    feedbackOpen(type?: FeedbackType, message?: string, includeLog?: boolean, includeDyninfo?: boolean, attachments?: FileList | File[] | null, logFiles?: FileList | File[] | null, isAnonymous?: boolean): void;
-    feedbackClose(): void;
+    setFeedbackTheme(theme: 'light' | 'dark' | 'auto'): void;
 }
-export interface AppticsApi {
-    /** Android's Apptics. */
+export interface AppticsSdk {
+    /** Android's Apptics: starting the SDK, and what applies to all of it. */
     Apptics: {
         /** Starts the SDK. The config object is required; the console snippet supplies it via auto-init. */
         init(config: AppticsConfig): boolean;
+        /** Resolves true once start-up (storage load, device, session) has finished; false if it can't start. */
+        ready(): Promise<boolean>;
+        /** Sends stored engagements, errors and heatmap records now; resolves once they have gone out. */
+        flush(): Promise<void>;
+        /** Clears stored identity, queued data and remote config values, then starts again. */
+        reset(): void;
+        /**
+         * Turns debug mode on, before or after Apptics.init(). Engagement, exception and log then go to
+         * their `debug/` twins, whose answers carry a request id and a link into the server's own logs. It
+         * switches itself off after an hour with nothing tracked.
+         */
+        enableDebug(): void;
+        /** Turns debug mode off, before or after Apptics.init(); wins over `debug` in init(). */
+        disableDebug(): void;
     };
     /** Android's AppticsEvents. */
-    AppticsEvents: {
+    AppticsEvent: {
+        /** Apptics' defined events, as Android's DefinedEvents, to log with addEvent. */
+        DefinedEvents: typeof DefinedEvents;
         /** An event. An invalid name or group is not logged; a group left out is `default`. */
         addEvent(eventName: string, groupName?: string, properties?: Properties): void;
-        /** A defined event (DefinedEvents.AP_USER_LOGIN, …), which brings its own group. */
+        /** A defined event (AppticsEvent.DefinedEvents.AP_USER_LOGIN, …), which brings its own group. */
         addEvent(definedEvent: DefinedEvent, properties?: Properties): void;
     };
-    /** Apptics' defined events, as Android's DefinedEvents. */
-    DefinedEvents: Readonly<Record<string, DefinedEvent>>;
     /** Android's AppticsScreenTracker. */
-    AppticsScreenTracker: {
+    AppticsScreen: {
         /** Records a screen view and returns its id, for outScreen; '' for an invalid name. */
         inScreen(screenName: string, properties?: Properties): string;
         /** Ends the screen view inScreen began, before the next screen would. */
         outScreen(id: string): void;
     };
     /** Android's AppticsApiTracker. */
-    AppticsApiTracker: {
+    AppticsApi: {
+        /** Builds the rules configure takes: `new AppticsApi.ApiTrackingBuilder()…build()`. */
+        ApiTrackingBuilder: typeof ApiTrackingBuilder;
         /** Begins timing one call; returns the id endTrackApi takes. */
         startTrackApi(url: string, method?: string): string;
         /** Finishes the call startTrackApi began, and records it. */
         endTrackApi(id: string, responseCode: number, responseMessage?: string): void;
         /** The rules API tracking records by, from ApiTrackingBuilder. Works before Apptics.init(). */
         configure(config: ApiTrackingConfig | ApiTrackingBuilder): void;
+        /**
+         * Turns automatic API tracking on or off after Apptics.init(). Equivalent to the `track_api`
+         * config flag, which is the usual way to set it.
+         */
+        enableApiTracking(enabled?: boolean): void;
     };
-    ApiTrackingBuilder: typeof ApiTrackingBuilder;
-    /** Android's AppticsLogger: off until enable(), then v / d / i / w / e(tag, message). */
-    AppticsLogger: AppticsLogger;
-    /** Resolves true once start-up (storage load, device, session) has finished; false if it can't start. */
-    ready(): Promise<boolean>;
-    /**
-     * Turns debug mode on, before or after Apptics.init(). Engagement, exception and log then go to
-     * their `debug/` twins, whose answers carry a request id and a link into the server's own logs. It
-     * switches itself off after an hour with nothing tracked.
-     */
-    enableDebug(): void;
-    /** Turns debug mode off, before or after Apptics.init(); wins over `debug` in init(). */
-    disableDebug(): void;
-    /**
-     * Turns automatic API tracking on or off after Apptics.init(). Equivalent to the `track_api`
-     * config flag, which is the usual way to set it.
-     */
-    enableApiTracking(enabled?: boolean): void;
-    /** Reports an error the app caught, or an `error` / `unhandledrejection` event. */
-    AppticsTrackError(error: ErrorLike, properties?: Properties): void;
-    enableGlobalErrorHandler(enabled?: boolean): void;
-    /** Properties may be a plain object, or the result of UserBuilder.build(). */
-    AppticsSetUser(userid: string, groupid?: string, properties?: Properties | UserValidationResult): void;
-    getUser(): UserInfo;
-    users: {
+    /** Errors the app caught, and the switch for tracking uncaught ones. */
+    AppticsError: {
+        /** Reports an error the app caught, or an `error` / `unhandledrejection` event. */
+        trackError(error: ErrorLike, properties?: Properties): void;
+        /** Turns the automatic tracking of uncaught errors and unhandled rejections on or off. */
+        trackGlobalErrorHandler(enabled?: boolean): void;
+    };
+    /** Android's AppticsUser. */
+    AppticsUser: {
+        /** Registers the signed-in user. Properties may be a plain object, or the result of UserBuilder.build(). */
+        setUser(userid: string, groupid?: string, properties?: Properties | UserValidationResult): void;
+        /** The registered user, or {} when there is none. */
+        getUser(): UserInfo;
+        /** Builds the user's properties for setUser. */
         UserBuilder: typeof UserBuilder;
     };
-    setTrackingStatus(status: TrackingStatus): void;
-    getTrackingStatus(): TrackingStatus;
-    flush(): void;
-    /** Records a timestamped line, sent as feedbacklog.txt with the next feedback submission. */
-    addFeedbackLog(message: string): void;
-    /** Records a diagnostics key/value under `heading`, sent inside dyninfo.txt with the next feedback. */
-    addDiagnosticsInfo(heading: string, key: string, value?: unknown): void;
-    reset(): void;
-    AP_TRACKING_STATUS: typeof AP_TRACKING_STATUS;
-    AP_FEEDBACK_TYPE: typeof AP_FEEDBACK_TYPE;
+    /** Click and scroll capture for the console's heatmaps. */
+    AppticsHeatmap: {
+        /** Starts or stops recording clicks and scrolls; `on` defaults to true. */
+        trackHeatmap(on?: boolean): void;
+    };
+    /** Android's AppticsSettings: what the SDK may track for this visitor. */
+    AppticsSettings: {
+        /** The states setTrackingStatus takes. */
+        AP_TRACKING_STATUS: typeof AP_TRACKING_STATUS;
+        setTrackingStatus(status: TrackingStatus): void;
+        getTrackingStatus(): TrackingStatus;
+    };
 }

package/dist/cjs/user/index.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.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 var constants = require('../core/constants.js');
@@ -25,7 +25,7 @@ function asUserProperties(jsonObj) {
         ? maybeBuilt
         : validate.userValidateJSON(jsonObj);
     built.message.forEach(function (problem) {
-        logger.logFailure(constants.AP_LOG_MODULE.PROPERTIES, 'AppticsSetUser: dropped ' + problem.keys.join(', ') + ' (error ' + problem.code + ')'); // no i18n
+        logger.logFailure(constants.AP_LOG_MODULE.PROPERTIES, 'AppticsUser.setUser: dropped ' + problem.keys.join(', ') + ' (error ' + problem.code + ')'); // no i18n
     });
     return built;
 }
@@ -37,7 +37,7 @@ function setUser(userid, groupid, jsonObj) {
         return;
     }
     if (utils.isEmpty(userid)) {
-        logger.logFailure(constants.AP_LOG_MODULE.PROPERTIES, 'AppticsSetUser: Invalid userid'); // no i18n
+        logger.logFailure(constants.AP_LOG_MODULE.PROPERTIES, 'AppticsUser.setUser: Invalid userid'); // no i18n
         return;
     }
     var user_info = {
@@ -68,8 +68,16 @@ function addOrUpdateUser(user_info) {
         users.push(user_info);
     }
     storage.user_defaults.add('users', users); // no i18n
+    // the user setUser registered, on its own as well: what this browser is tracking as now
+    storage.user_defaults.add('user_info', users[index !== -1 ? index : users.length - 1]); // no i18n
 }
 function getUserInfo() {
+    var stored = storage.user_defaults.item('user_info'); // no i18n
+    if (stored && typeof stored === 'object' && !utils.isEmpty(stored.userid)) { // no i18n
+        state._ZAP._user_info = stored;
+        return;
+    }
+    // registered before user_info was kept: the active one of the users list
     var users = storage.user_defaults.item('users') || []; // no i18n
     var activeuser = {};
     if (users.length > 0) {
@@ -166,8 +174,6 @@ class UserBuilder {
         return validate.userValidateJSON(user);
     }
 }
-// Users module for user management
-const users = { UserBuilder: UserBuilder };
 
 exports.UserBuilder = UserBuilder;
 exports.addOrUpdateUser = addOrUpdateUser;
@@ -175,4 +181,3 @@ exports.getUser = getUser;
 exports.getUserInfo = getUserInfo;
 exports.registerUserWithApptics = registerUserWithApptics;
 exports.setUser = setUser;
-exports.users = users;

package/dist/esm/auto-init.d.ts

@@ -1,8 +1,8 @@
-import type { AppticsApi } from './types.js';
+import type { AppticsSdk } from './types.js';
 /** Calls Apptics.init() when the page has the console snippet (window.appticssettings) and it hasn't run. */
-export declare function autoInit(api: AppticsApi['Apptics']): boolean;
+export declare function autoInit(api: AppticsSdk['Apptics']): boolean;
 /**
  * Queues autoInit so an app that sets window.appticssettings and calls init() in its
  * top-level code runs first (autoInit then sees init() already ran).
  */
-export declare function scheduleAutoInit(api: AppticsApi['Apptics']): void;
+export declare function scheduleAutoInit(api: AppticsSdk['Apptics']): void;

package/dist/esm/auto-init.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.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 import { _ZAP } from './core/state.js';
 import { getSnippetOptions } from './core/env.js';
 

package/dist/esm/core/attempts.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.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 import { RETRY_CAPABLE_PATHS } from './constants.js';
 import { user_defaults } from './storage.js';
 import { nowMs } from './utils.js';

package/dist/esm/core/batch.js

@@ -1,8 +1,9 @@
-/*! @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.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 import { _ZAP, isExpired } from './state.js';
 import { Console, warnAlways } from './logger.js';
 import { isEmptyObj, sizeof } from './utils.js';
 import './constants.js';
+import './db.js';
 import { shouldTrackOrSendData } from './consent.js';
 import { attemptsExhausted, MAX_ATTEMPTS, resetAttempts } from './attempts.js';
 import { rejectIfDisabled, rejectIfNoDeviceIds, getMetaObj, postKeepalive, apiHeaders, postToApptics } from './transport.js';

package/dist/esm/core/callsite.d.ts

@@ -15,6 +15,12 @@ export interface CallSite {
     fn?: string;
 }
 export declare const NO_CALL_SITE: CallSite;
+/**
+ * A call typed in the browser's developer console: there is no file, line or function to report,
+ * only the console's own placeholder for its input, so the line says plainly that it came from
+ * nowhere in the app. file_name and the function field both accept `-`.
+ */
+export declare const CONSOLE_CALL_SITE: CallSite;
 /**
  * The frame `skip` frames down a stack, counting only the ones that name a file — V8 heads its
  * stacks with an `Error` line and Firefox does not, so counting raw lines would read a different

package/dist/esm/core/callsite.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.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 /**
  * Where a log line was raised, for logSDK's `filename` and `linenumber`.
  *
@@ -8,6 +8,22 @@
  * wrapped so a stack we cannot parse costs a line its call site and nothing more.
  */
 const NO_CALL_SITE = { filename: '', linenumber: 0, fn: '' };
+/**
+ * A call typed in the browser's developer console: there is no file, line or function to report,
+ * only the console's own placeholder for its input, so the line says plainly that it came from
+ * nowhere in the app. file_name and the function field both accept `-`.
+ */
+const CONSOLE_CALL_SITE = { filename: '-', linenumber: 0, fn: '-' };
+/**
+ * The frame of code run from the developer console, in each browser:
+ *   V8 (Chrome, Edge):  `    at <anonymous>:1:15`        (the file is <anonymous>)
+ *   Firefox:            `@debugger eval code:1:15`
+ *   Safari:             `global code` or `eval code`, with no location at all
+ * V8 names a string run through eval or new Function <anonymous> too; it is no file either.
+ */
+const CONSOLE_FILE_V8 = '<anonymous>'; // no i18n
+const CONSOLE_FIREFOX = /debugger eval code/; // no i18n
+const CONSOLE_SAFARI = /^(global|eval) code(@|$)/; // no i18n
 /** logSDK declares max-len="100" on filename. */
 const FILENAME_MAX = 100;
 /**
@@ -61,14 +77,19 @@ function callSiteFromStack(stack, skip) {
     var lines = stack.split('\n');
     var seen = 0;
     for (var i = 0; i < lines.length; i++) {
-        var frame = parseFrame(lines[i] || '');
+        var raw = (lines[i] || '').trim(); // no i18n
+        var frame = parseFrame(raw);
         if (frame === null) {
+            // Safari's console frame has no location, so it is never a frame parseFrame reads
+            if (seen === skip && CONSOLE_SAFARI.test(raw)) {
+                return CONSOLE_CALL_SITE;
+            }
             continue;
         }
         if (seen++ < skip) {
             continue;
         }
-        return frame;
+        return frame.filename === CONSOLE_FILE_V8 || CONSOLE_FIREFOX.test(raw) ? CONSOLE_CALL_SITE : frame;
     }
     return NO_CALL_SITE;
 }
@@ -86,4 +107,4 @@ function callSite(skip) {
     }
 }
 
-export { NO_CALL_SITE, callSite, callSiteFromStack };
+export { CONSOLE_CALL_SITE, NO_CALL_SITE, callSite, callSiteFromStack };

package/dist/esm/core/consent.d.ts

@@ -1,5 +1,9 @@
 import type { TrackingStatus } from '../types.js';
-/** DNT counts only when not ignored; when it counts, tracking switches to NO_TRACKING. */
+/**
+ * DNT counts only when not ignored; while it counts, tracking is NO_TRACKING (opt_in_status).
+ * Decided on every visit and never stored: storing it made one visit with DNT on look like the
+ * visitor's own choice, so tracking stayed off after DNT was turned off or ignore_do_not_track set.
+ */
 export declare function hasDoNotTrackEnabled(): boolean;
 export declare function opt_in_status(): TrackingStatus;
 export declare function shouldTrackOrSendData(): boolean;

package/dist/esm/core/consent.js

@@ -1,21 +1,23 @@
-/*! @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.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 import { AP_TRACKING_STATUS } from './constants.js';
 import { _ZAP } from './state.js';
 import { Console } from './logger.js';
 import { isEmpty, isSuccess } from './utils.js';
 import { tracking_preference } from './storage.js';
-import { isDntOn, is_apptics_disabled } from './env.js';
+import { is_apptics_disabled, isDntOn } from './env.js';
 import { hooks } from './hooks.js';
 
-/** DNT counts only when not ignored; when it counts, tracking switches to NO_TRACKING. */
+/**
+ * DNT counts only when not ignored; while it counts, tracking is NO_TRACKING (opt_in_status).
+ * Decided on every visit and never stored: storing it made one visit with DNT on look like the
+ * visitor's own choice, so tracking stayed off after DNT was turned off or ignore_do_not_track set.
+ */
 function hasDoNotTrackEnabled() {
     if (_ZAP._ignoreDnt) {
         return false;
     }
     if (isDntOn()) {
-        Console.warn('hasDoNotTrackEnabled: DoNotTrack is enabled'); // no i18n
-        setTrackingStatus(AP_TRACKING_STATUS.NO_TRACKING);
-        Console.log('hasDoNotTrackEnabled: Setting tracking status to NO_TRACKING'); // no i18n
+        Console.warn('hasDoNotTrackEnabled: DoNotTrack is enabled, so nothing is tracked'); // no i18n
         return true;
     }
     return false;
@@ -41,7 +43,7 @@ function shouldTrackOrSendData() {
  */
 function canTrack(caller) {
     if (!_ZAP._token) {
-        Console.warn('apptics.' + caller + ': You must call apptics.init() first'); // no i18n
+        Console.warn('apptics.' + caller + ': You must call Apptics.init() first'); // no i18n
         return false;
     }
     if (is_apptics_disabled()) {

package/dist/esm/core/constants.d.ts

@@ -1,3 +1,19 @@
+/**
+ * A screen_routes entry as init() keeps it, ready to match: a route pattern, or an exact path or a
+ * regular expression with the name it records.
+ */
+export type ScreenRouteRule = {
+    kind: 'pattern';
+    pattern: string;
+} | {
+    kind: 'equals';
+    path: string;
+    name: string;
+} | {
+    kind: 'regex';
+    regex: RegExp;
+    name: string;
+};
 export declare const AP_TRACKING_STATUS: Readonly<{
     readonly USAGE_TRACKING_WITH_PII: 1;
     readonly USAGE_TRACKING_WITHOUT_PII: 4;
@@ -117,7 +133,6 @@ export declare const AP_CONFIG: Readonly<{
     debug: boolean;
     track_by_default: true;
     ignore_do_not_track: boolean;
-    remote_log: boolean;
     /**
      * Wrap XHR and fetch to record the app's API calls without it calling startTrackApi(). Off by
      * default: the hostnames and paths of every request an app makes is a wider grant than events
@@ -130,15 +145,16 @@ export declare const AP_CONFIG: Readonly<{
      */
     track_screen: boolean;
     /**
-     * Print each app logger line to the browser console as well, as Android's showLogs prints to
-     * Logcat. Off by default; console_log is the SDK's own activity, this is the app's lines.
+     * How automatic screen tracking names a path, as init() keeps the config's screen_routes: route
+     * patterns (`/users/{id}/orders`, each id recorded as a star), exact paths and regular
+     * expressions with a name. Tried in order; a path none matches keeps its own name.
      */
-    show_logs: boolean;
+    screen_routes: ScreenRouteRule[];
     /**
-     * Record sessions automatically. On by default; false is Android's
-     * automaticSessionsTrackingStatus = false: no sessions, while events and screens still are.
+     * The feedback form's theme: 'light', 'dark', or 'auto' to follow the visitor's system setting.
+     * 'auto' by default.
      */
-    track_session: boolean;
+    feedback_theme: "light" | "dark" | "auto";
     /**
      * How long a visit must last before its session is stored, in milliseconds. A shorter visit with
      * nothing tracked in it is dropped: a bounce or a crawler is not a session. Anything tracked
@@ -187,7 +203,13 @@ export type ApConfig = {
  * What init() must be given. Everything else the SDK needs — aaid, the portal and project ids that
  * go in every url — comes back from app/addversion, which these four are enough to call.
  */
-export declare const REQUIRED_CONFIG: readonly ["serviceUrl", "zak", "identifier", "appversion"];
+export declare const REQUIRED_CONFIG: readonly ["base_url", "auth_key", "app_domain", "appversion"];
+/**
+ * The init() keys and the names the SDK keeps them under inside (and in app_version_info, which
+ * already-visited browsers have stored): base_url is the host, auth_key the `zak` header, and
+ * app_domain the app's identifier.
+ */
+export declare const CONFIG_KEYS: Readonly<Record<string, string>>;
 /**
  * Paths with a `debug/` twin. The debug endpoints take the same body and answer with a request id
  * and a link to the server-side logs for that request, which is how a payload is traced end to
@@ -207,6 +229,9 @@ export declare const RETRY_CAPABLE_PATHS: Readonly<Record<string, boolean>>;
  * called before those ids are known, so it cannot carry them.
  */
 export declare const PATHS_WITHOUT_ORG: Readonly<Record<string, boolean>>;
-/** Console-snippet names accepted for the canonical keys above. */
-export declare const CONFIG_ALIASES: Readonly<Record<string, string>>;
+/**
+ * Earlier names of the init() keys: 2.0.0-beta's serviceUrl, zak and identifier, and the 1.x
+ * console snippet's base_domain and token. Still read, with a warning naming the key to use.
+ */
+export declare const RETIRED_CONFIG_NAMES: Readonly<Record<string, string>>;
 export declare const BLOCKED_WS: readonly string[];