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

package/dist/cjs/remotelog/send.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.2 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 var constants = require('../core/constants.js');
@@ -42,7 +42,7 @@ function entryFor(item) {
     var entry = {
         sessionstarttime: state._ZAP._current_session.starttime || item.happenedat || utils.nowMs(),
         logtime: item.happenedat || utils.nowMs(),
-        // an app's line carries the level it was logged at; the SDK's own failures carry none
+        // an app's line carries the level it was logged at; only a line an older SDK stored has none
         level: Number(item.level) || constants.REMOTE_LOG_LEVEL,
         logmessage: String(item.exceptionlog).slice(0, constants.CONSOLE_LOG_MAX_BODY),
         function: String(item.module || 'SDK').slice(0, constants.LOG_FUNCTION_MAX), // no i18n

package/dist/cjs/remotelogger/index.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.2 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 Object.defineProperty(exports, '__esModule', { value: true });

package/dist/cjs/scheduler.d.ts

@@ -3,6 +3,8 @@
  * response (page hide), so they survive the page going away.
  */
 export declare function flush(forget?: boolean): Promise<void>;
-/** Starts the flush and getupdates intervals once; later calls do nothing until stopTimers(). */
+/** Apptics.flush(): flush(), at most once every CALLED_FLUSH_GAP_MS. A call sooner sends nothing. */
+export declare function calledFlush(): Promise<void>;
+/** Starts the flush interval once; later calls do nothing until stopTimers(). */
 export declare function startTimers(): void;
 export declare function stopTimers(): void;

package/dist/cjs/scheduler.js

@@ -1,9 +1,9 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.2 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 var state = require('./core/state.js');
-var utils = require('./core/utils.js');
 var logger = require('./core/logger.js');
+var utils = require('./core/utils.js');
 var consent = require('./core/consent.js');
 var batch = require('./core/batch.js');
 var send = require('./engagement/send.js');
@@ -29,9 +29,26 @@ function flush(forget) {
         return hooks.hooks.sendHeatmaps(forget);
     });
 }
+/**
+ * How often Apptics.flush() sends when it is called by hand, from the console or the app's own
+ * code: once every 15 seconds, however often it is called. The SDK's own sends (the flush
+ * interval, page hide and close, back online) call flush() directly and are not held to it.
+ */
+const CALLED_FLUSH_GAP_MS = 15 * 1000;
+/** When Apptics.flush() last sent; 0 until it has. */
+var calledFlushAt = 0;
+/** Apptics.flush(): flush(), at most once every CALLED_FLUSH_GAP_MS. A call sooner sends nothing. */
+function calledFlush() {
+    var now = utils.nowMs();
+    if (calledFlushAt > 0 && now - calledFlushAt < CALLED_FLUSH_GAP_MS) {
+        logger.Console.log('Apptics.flush: sent ' + (now - calledFlushAt) + ' ms ago; it sends at most once every ' + CALLED_FLUSH_GAP_MS + ' ms, and the timer sends the rest'); // no i18n
+        return Promise.resolve();
+    }
+    calledFlushAt = now;
+    return flush();
+}
 var sendingInterval = null;
-var getUpdatesInterval = null;
-/** Starts the flush and getupdates intervals once; later calls do nothing until stopTimers(). */
+/** Starts the flush interval once; later calls do nothing until stopTimers(). */
 function startTimers() {
     if (sendingInterval === null) {
         sendingInterval = setInterval(function () {
@@ -48,31 +65,17 @@ function startTimers() {
             });
         }, state.getConfig('batch_flush_interval')); // no i18n
     }
-    if (getUpdatesInterval === null) {
-        // the interval is the floor, not the schedule: getsdkconfig answers with next_check_after,
-        // and asking again before then is a call the server has already told us it will not answer
-        // differently. The timer still ticks so a server that sends no hint behaves as before.
-        getUpdatesInterval = setInterval(function () {
-            if (state._ZAP._nextConfigCheck > 0 && utils.nowMs() < state._ZAP._nextConfigCheck) {
-                return;
-            }
-            logger.Console.log('scheduleToGetUpdatesFromServer: asking the server for its config'); // no i18n
-            index.getUpdatesFromServer().catch(function (err) {
-                logger.Console.log(err);
-            });
-        }, state.getConfig('getupdates_interval')); // no i18n
-    }
 }
 function stopTimers() {
     if (sendingInterval !== null)
         clearInterval(sendingInterval);
-    if (getUpdatesInterval !== null)
-        clearInterval(getUpdatesInterval);
     sendingInterval = null;
-    getUpdatesInterval = null;
     batch.clearDefer();
+    index.stopServerSettingChecks();
+    calledFlushAt = 0;
 }
 
+exports.calledFlush = calledFlush;
 exports.flush = flush;
 exports.startTimers = startTimers;
 exports.stopTimers = stopTimers;

package/dist/cjs/types.d.ts

@@ -37,7 +37,7 @@ export interface ServerResult<T = Dict> {
 export type TrackingStatus = (typeof AP_TRACKING_STATUS)[keyof typeof AP_TRACKING_STATUS];
 export type FeedbackType = (typeof AP_FEEDBACK_TYPE)[keyof typeof AP_FEEDBACK_TYPE];
 export type Properties = Record<string, unknown>;
-/** The config init() requires. The console snippet provides the same shape as window.appticssettings._defaultoptions. */
+/** The config init() requires. */
 export interface AppticsConfig {
     /** Apptics host every request goes to, e.g. https://apptics.zoho.com (a trailing slash is ignored). Was `serviceUrl`. */
     base_url: string;
@@ -87,6 +87,18 @@ export interface AppticsConfig {
      * navigation replaces its automatic view; set this false to track only the app's own calls.
      */
     track_screen?: boolean;
+    /**
+     * Record uncaught errors and unhandled promise rejections automatically. On by default; set this
+     * false to record only the errors the app hands to AppticsError.trackError(). Switched later with
+     * AppticsError.setErrorTracking().
+     */
+    track_error?: boolean;
+    /**
+     * Record clicks on elements tagged `apeventaction` (or `data-apeventaction`) as events, in the
+     * group of the nearest `apgroupaction` around them. On by default; switched later with
+     * AppticsEvent.setClickTracking().
+     */
+    track_click?: boolean;
     /**
      * 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:
@@ -105,13 +117,19 @@ export interface AppticsConfig {
     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. */
+    /**
+     * How long to wait before reading the server's tracking settings again, in milliseconds, when its
+     * answer gives no time for the next check (next_check_after). Default 120000, at least 10000.
+     */
     getupdates_interval?: number;
     /** Most items in one batch. Default 50, between 1 and 500. */
     batch_size?: number;
     /** Days an unsent item is kept before it is dropped. Default 7, between 1 and 30. */
     batch_request_timeout?: number;
-    /** Idle minutes that end a session. Default 30, between 1 and 1440. */
+    /**
+     * Minutes a tab can be inactive (hidden, minimised, in the background) before its session ends,
+     * at the moment the user left. Default 30, between 1 and 1440.
+     */
     inactiveduration?: number;
     /**
      * How long a visit must last before its session is recorded, in milliseconds. Default 5000, at
@@ -120,8 +138,8 @@ export interface AppticsConfig {
      */
     min_session_duration?: number;
     /**
-     * Record where people click and how far they scroll. Off by default; AppticsHeatmap.trackHeatmap()
-     * switches it later.
+     * Record where people click and how far they scroll. Off by default;
+     * AppticsHeatmap.setHeatmapTracking() switches it later.
      */
     track_heatmap?: boolean;
     /** Most heatmap records one visit may produce. Default 500; capture pauses past it. */
@@ -175,8 +193,9 @@ export interface QuartzApi {
         quartzBranding: boolean;
     }): void;
     clearFeedback(): void;
-    endRecording(): void;
-    setVideoContent(element: Element | null): void;
+    /** Resolves once the recording has ended and is stored; Quartz's own build returns a Promise. */
+    endRecording(): Promise<unknown> | void;
+    setVideoContent(element: Element | null): Promise<unknown> | void;
     submitRecording(details: {
         email: string;
         subject: string;
@@ -256,7 +275,7 @@ export interface SendFeedbackOptions {
     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. */
+    /** The addDiagnosticsInfo() entries: unset sends them when there are any, false never does. */
     includeDiagnostics?: boolean;
     /** The addFeedbackLog() lines: unset sends them when there are any, false never does. */
     includeLog?: boolean;
@@ -305,11 +324,15 @@ export interface AppticsFeedbackApi {
 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. */
+        /** Starts the SDK with the app's config object, which is required. */
         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. */
+        /**
+         * Sends stored engagements, errors and heatmap records now; resolves once they have gone out.
+         * At most once every 15 seconds: a call sooner than that sends nothing and resolves at once,
+         * and what is queued goes with the next timed send.
+         */
         flush(): Promise<void>;
         /** Clears stored identity, queued data and remote config values, then starts again. */
         reset(): void;
@@ -326,10 +349,15 @@ export interface AppticsSdk {
     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;
+        /** An event. The group is required: an event without one, or with an invalid name or group, is not logged, and the console says why. */
+        addEvent(eventName: string, groupName: string, properties?: Properties): void;
         /** A defined event (AppticsEvent.DefinedEvents.AP_USER_LOGIN, …), which brings its own group. */
         addEvent(definedEvent: DefinedEvent, properties?: Properties): void;
+        /**
+         * Turns click tracking from markup (`apeventaction`) on or off after Apptics.init(); `enabled`
+         * defaults to true. The `track_click` config flag sets it at start-up.
+         */
+        setClickTracking(enabled?: boolean): void;
     };
     /** Android's AppticsScreenTracker. */
     AppticsScreen: {
@@ -337,6 +365,11 @@ export interface AppticsSdk {
         inScreen(screenName: string, properties?: Properties): string;
         /** Ends the screen view inScreen began, before the next screen would. */
         outScreen(id: string): void;
+        /**
+         * Turns automatic screen tracking on or off after Apptics.init(); `enabled` defaults to true.
+         * The `track_screen` config flag sets it at start-up. inScreen() records either way.
+         */
+        setScreenTracking(enabled?: boolean): void;
     };
     /** Android's AppticsApiTracker. */
     AppticsApi: {
@@ -349,16 +382,23 @@ export interface AppticsSdk {
         /** 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.
+         * Turns automatic API tracking on or off after Apptics.init(); `enabled` defaults to true.
+         * The `track_api` config flag sets it at start-up.
          */
+        setApiTracking(enabled?: boolean): void;
+        /** @deprecated renamed setApiTracking; this name still works, with a console warning */
         enableApiTracking(enabled?: boolean): void;
     };
     /** 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. */
+        /**
+         * Turns the automatic tracking of uncaught errors and unhandled rejections on or off after
+         * Apptics.init(); `enabled` defaults to true. The `track_error` config flag sets it at start-up.
+         */
+        setErrorTracking(enabled?: boolean): void;
+        /** @deprecated renamed setErrorTracking; this name still works, with a console warning */
         trackGlobalErrorHandler(enabled?: boolean): void;
     };
     /** Android's AppticsUser. */
@@ -372,7 +412,12 @@ export interface AppticsSdk {
     };
     /** Click and scroll capture for the console's heatmaps. */
     AppticsHeatmap: {
-        /** Starts or stops recording clicks and scrolls; `on` defaults to true. */
+        /**
+         * Starts or stops recording clicks and scrolls; `enabled` defaults to true. The
+         * `track_heatmap` config flag sets it at start-up.
+         */
+        setHeatmapTracking(enabled?: boolean): void;
+        /** @deprecated renamed setHeatmapTracking; this name still works, with a console warning */
         trackHeatmap(on?: boolean): void;
     };
     /** Android's AppticsSettings: what the SDK may track for this visitor. */

package/dist/cjs/user/index.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.2 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 var constants = require('../core/constants.js');
@@ -104,11 +104,15 @@ function registerUserWithApptics(user_info) {
         var data = result.data || {};
         user_info.userid = data.userid;
         user_info.groupid = data.customergroupid;
-        consent.setTrackingStatus(constants.AP_TRACKING_STATUS.USAGE_TRACKING_WITH_PII);
+        // stored only: user/register has told the server, and the device is registered already
+        consent.recordTrackingStatus(constants.AP_TRACKING_STATUS.USAGE_TRACKING_WITH_PII);
         addOrUpdateUser(user_info);
         getUserInfo();
         // the user and their customer group are known now: remote config conditions on them re-apply
         hooks.hooks.remoteConfigUserChanged();
+        // getsdkconfig answers for the user (with every module off for one whose customer group
+        // is not tracked, customergrouptracking: false), so it is asked again for them now
+        hooks.hooks.askServerSettings();
         return data;
     });
 }

package/dist/esm/core/attempts.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (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 { 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,7 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (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, 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';

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

@@ -1,3 +1,4 @@
+import { type EngagementType } from './constants.js';
 import type { TrackingStatus } from '../types.js';
 /**
  * DNT counts only when not ignored; while it counts, tracking is NO_TRACKING (opt_in_status).
@@ -12,8 +13,11 @@ export declare function shouldTrackOrSendData(): boolean;
  * and consent / server flags allow tracking.
  */
 export declare function canTrack(caller: string): boolean;
-/** canTrack plus the server's `engagementtracking` flag from getupdates (events, screens, sessions, api calls). */
-export declare function canTrackEngagement(caller: string): boolean;
+/**
+ * canTrack plus the server's flag for this kind of item: getsdkconfig's event (5), api (6),
+ * screen (10) and session (11) modules, each switched on its own.
+ */
+export declare function canTrackEngagement(caller: string, type: EngagementType): boolean;
 /**
  * canTrack plus the server's heatmap flag (getsdkconfig module 18).
  *
@@ -21,7 +25,13 @@ export declare function canTrackEngagement(caller: string): boolean;
  * well want events while declining to have every click's coordinates recorded.
  */
 export declare function canTrackHeatmap(caller: string): boolean;
-/** canTrack plus the server's `errortracking` flag from getupdates. */
+/** canTrack plus the server's js_error module (15) from getsdkconfig. */
 export declare function canTrackErrors(caller: string): boolean;
+/**
+ * Stores the visitor's tracking status without telling the server. True when it changed.
+ * user/register uses this alone: the server learns of the user from that call, so a device/add
+ * after it would only repeat a registration the device already has.
+ */
+export declare function recordTrackingStatus(trackingState: TrackingStatus): boolean;
 export declare function setTrackingStatus(trackingState: TrackingStatus): void;
 export declare function getTrackingStatus(): TrackingStatus;

package/dist/esm/core/consent.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (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 './constants.js';
 import { _ZAP } from './state.js';
 import { Console } from './logger.js';
@@ -51,13 +51,16 @@ function canTrack(caller) {
     }
     return shouldTrackOrSendData();
 }
-/** canTrack plus the server's `engagementtracking` flag from getupdates (events, screens, sessions, api calls). */
-function canTrackEngagement(caller) {
+/**
+ * canTrack plus the server's flag for this kind of item: getsdkconfig's event (5), api (6),
+ * screen (10) and session (11) modules, each switched on its own.
+ */
+function canTrackEngagement(caller, type) {
     if (!canTrack(caller)) {
         return false;
     }
-    if (!_ZAP._engagementTracking) {
-        Console.log('apptics.' + caller + ': engagement tracking is turned off by the server'); // no i18n
+    if (!_ZAP._engagementTracking[type]) {
+        Console.log('apptics.' + caller + ': ' + type + ' tracking is turned off by the server'); // no i18n
         return false;
     }
     return true;
@@ -78,7 +81,7 @@ function canTrackHeatmap(caller) {
     }
     return true;
 }
-/** canTrack plus the server's `errortracking` flag from getupdates. */
+/** canTrack plus the server's js_error module (15) from getsdkconfig. */
 function canTrackErrors(caller) {
     if (!canTrack(caller)) {
         return false;
@@ -89,17 +92,27 @@ function canTrackErrors(caller) {
     }
     return true;
 }
+/**
+ * Stores the visitor's tracking status without telling the server. True when it changed.
+ * user/register uses this alone: the server learns of the user from that call, so a device/add
+ * after it would only repeat a registration the device already has.
+ */
+function recordTrackingStatus(trackingState) {
+    if (tracking_preference.opt_in_status() == trackingState) {
+        return false;
+    }
+    tracking_preference.update_status(trackingState);
+    _ZAP._devicestatus = tracking_preference.opt_in_status();
+    return true;
+}
 function setTrackingStatus(trackingState) {
     if (isEmpty(trackingState)) {
         Console.warn('setTrackingStatus: trackingStatus is Empty'); // no i18n
         return;
     }
-    if (tracking_preference.opt_in_status() == trackingState) {
+    if (!recordTrackingStatus(trackingState)) {
         return;
     }
-    tracking_preference.update_status(trackingState);
-    _ZAP._devicestatus = tracking_preference.opt_in_status();
-    _ZAP._isanonrequired = tracking_preference.opt_in_status() == AP_TRACKING_STATUS.USAGE_TRACKING_WITH_PII ? false : _ZAP._isanonrequired;
     if (tracking_preference.opt_in_status() != AP_TRACKING_STATUS.NO_TRACKING) {
         Console.log('setTrackingStatus: Updating device info with new tracking status'); // no i18n
         hooks.updateDevice(_ZAP._device_info).then(function (result) {
@@ -119,4 +132,4 @@ function getTrackingStatus() {
     return opt_in_status();
 }
 
-export { canTrack, canTrackEngagement, canTrackErrors, canTrackHeatmap, getTrackingStatus, hasDoNotTrackEnabled, opt_in_status, setTrackingStatus, shouldTrackOrSendData };
+export { canTrack, canTrackEngagement, canTrackErrors, canTrackHeatmap, getTrackingStatus, hasDoNotTrackEnabled, opt_in_status, recordTrackingStatus, setTrackingStatus, shouldTrackOrSendData };

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

@@ -34,6 +34,8 @@ export declare const AP_CONSTANTS: Readonly<{
     readonly SUCCESS: "success";
     readonly BROWSER: "Browser";
 }>;
+/** The kinds of engagement item, each with its own getsdkconfig module: AP_CONSTANTS' type values. */
+export type EngagementType = 'event' | 'screen' | 'session' | 'api';
 export declare const DEFAULT_API_PATHS: Readonly<{
     readonly addversion: "app/addversion";
     readonly regdevice: "device/add";
@@ -79,9 +81,13 @@ export declare const SDK_MODULE: Readonly<{
      * authority. Where they disagree, getsdkconfig wins.
      */
     readonly REMOTE_CONFIG: "2";
+    readonly EVENT: "5";
+    readonly API: "6";
+    readonly SCREEN: "10";
     readonly SESSION: "11";
     readonly FEEDBACK: "12";
-    readonly CRASH: "13";
+    /** Uncaught and reported JavaScript errors: js_error. 13 (crash) and 14 (nonfatal) are the native SDKs'. */
+    readonly JS_ERROR: "15";
     readonly REMOTE_LOGGER: "17";
     readonly HEATMAP: "18";
 }>;
@@ -97,9 +103,10 @@ export declare const LOG_FILENAME_MAX = 100;
  */
 export declare const DEVICE_NAME_MAX = 100;
 /**
- * The `level` every line goes out with. Everything the remote logger carries is a failure inside
- * the SDK — logFailure is its only caller — so the level never varies. 3 is what the v2 reference
- * shows in its only example; the scale itself is not documented anywhere we can see.
+ * The `level` a remote log line goes out with when it has none of its own: 3, Info. Every line an
+ * app writes with AppticsLogger carries its level (1 verbose to 5 error, see LOG_LEVEL in
+ * remotelog/logger.ts). Only a line an older SDK stored, when the SDK logged its own failures
+ * there, has none; it is sent as Info rather than having the batch refused for a missing level.
  */
 export declare const REMOTE_LOG_LEVEL = 3;
 /**
@@ -109,29 +116,17 @@ export declare const REMOTE_LOG_LEVEL = 3;
  * enough that a tab left open overnight is not still sending every call to its debug twin.
  */
 export declare const DEBUG_IDLE_MS: number;
-/** Idle minutes that end a session. Lives on state, not in _config, but defaults here. */
+/** Minutes a tab can be inactive before its session ends. Lives on state, not in _config, but defaults here. */
 export declare const DEFAULT_INACTIVE_MINUTES = 30;
 /** Global defaults. `state._config` holds a mutable copy per init. */
 export declare const AP_CONFIG: Readonly<{
     endpoint: "/sdk/web/";
     method: "POST";
-    transport: "XHR";
-    track_link_timeout: 300;
-    cookie_expiration_days: 365;
-    storage_type: "localStorage";
-    enable_batch_requests: true;
     batch_size: 50;
     batch_flush_interval: 30000;
     getupdates_interval: 120000;
     batch_request_timeout: 7;
-    auto_starts_batch: true;
-    mode: 1;
-    default_group_name: "default";
-    default_optin_status: number;
-    enable_pageview_tracking: false;
-    save_referrer: true;
     debug: boolean;
-    track_by_default: true;
     ignore_do_not_track: boolean;
     /**
      * Wrap XHR and fetch to record the app's API calls without it calling startTrackApi(). Off by
@@ -144,6 +139,16 @@ export declare const AP_CONFIG: Readonly<{
      * default; the app's own inScreen() during a navigation replaces that navigation's view.
      */
     track_screen: boolean;
+    /**
+     * Record uncaught errors and unhandled promise rejections, from the window's `error` and
+     * `unhandledrejection` events. On by default; AppticsError.setErrorTracking() switches it later.
+     */
+    track_error: boolean;
+    /**
+     * Record clicks on elements tagged `apeventaction` (or `data-apeventaction`) as events. On by
+     * default; AppticsEvent.setClickTracking() switches it later.
+     */
+    track_click: boolean;
     /**
      * 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

package/dist/esm/core/constants.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.2 | (c) Zoho Corporation Private Limited | see LICENSE */
 const AP_TRACKING_STATUS = Object.freeze({
     USAGE_TRACKING_WITH_PII: 1,
     USAGE_TRACKING_WITHOUT_PII: 4,
@@ -83,9 +83,13 @@ const SDK_MODULE = Object.freeze({
      * authority. Where they disagree, getsdkconfig wins.
      */
     REMOTE_CONFIG: '2', // no i18n
+    EVENT: '5', // no i18n
+    API: '6', // no i18n
+    SCREEN: '10', // no i18n
     SESSION: '11', // no i18n
     FEEDBACK: '12', // no i18n
-    CRASH: '13', // no i18n
+    /** Uncaught and reported JavaScript errors: js_error. 13 (crash) and 14 (nonfatal) are the native SDKs'. */
+    JS_ERROR: '15', // no i18n
     REMOTE_LOGGER: '17', // no i18n
     HEATMAP: '18', // no i18n
 });
@@ -101,9 +105,10 @@ const LOG_FILENAME_MAX = 100;
  */
 const DEVICE_NAME_MAX = 100;
 /**
- * The `level` every line goes out with. Everything the remote logger carries is a failure inside
- * the SDK — logFailure is its only caller — so the level never varies. 3 is what the v2 reference
- * shows in its only example; the scale itself is not documented anywhere we can see.
+ * The `level` a remote log line goes out with when it has none of its own: 3, Info. Every line an
+ * app writes with AppticsLogger carries its level (1 verbose to 5 error, see LOG_LEVEL in
+ * remotelog/logger.ts). Only a line an older SDK stored, when the SDK logged its own failures
+ * there, has none; it is sent as Info rather than having the batch refused for a missing level.
  */
 const REMOTE_LOG_LEVEL = 3;
 /**
@@ -113,30 +118,18 @@ const REMOTE_LOG_LEVEL = 3;
  * enough that a tab left open overnight is not still sending every call to its debug twin.
  */
 const DEBUG_IDLE_MS = 60 * 60 * 1000;
-/** Idle minutes that end a session. Lives on state, not in _config, but defaults here. */
+/** Minutes a tab can be inactive before its session ends. Lives on state, not in _config, but defaults here. */
 const DEFAULT_INACTIVE_MINUTES = 30;
 /** Global defaults. `state._config` holds a mutable copy per init. */
 const AP_CONFIG = Object.freeze({
     // the version is per path (API_VERSIONS); this is only the part before it
     endpoint: '/sdk/web/', // no i18n
     method: 'POST', // no i18n
-    transport: 'XHR', // no i18n
-    track_link_timeout: 300,
-    cookie_expiration_days: 365,
-    storage_type: 'localStorage', // no i18n
-    enable_batch_requests: true,
     batch_size: 50,
     batch_flush_interval: 30000,
-    getupdates_interval: 120000, // 2 minutes in milliseconds
+    getupdates_interval: 120000, // 2 minutes in milliseconds, when getsdkconfig gives no next_check_after
     batch_request_timeout: 7,
-    auto_starts_batch: true,
-    mode: 1,
-    default_group_name: 'default', // no i18n
-    default_optin_status: AP_TRACKING_STATUS.USAGE_TRACKING_WITHOUT_PII,
-    enable_pageview_tracking: false,
-    save_referrer: true,
     debug: false,
-    track_by_default: true,
     ignore_do_not_track: false,
     /**
      * Wrap XHR and fetch to record the app's API calls without it calling startTrackApi(). Off by
@@ -149,6 +142,16 @@ const AP_CONFIG = Object.freeze({
      * default; the app's own inScreen() during a navigation replaces that navigation's view.
      */
     track_screen: true,
+    /**
+     * Record uncaught errors and unhandled promise rejections, from the window's `error` and
+     * `unhandledrejection` events. On by default; AppticsError.setErrorTracking() switches it later.
+     */
+    track_error: true,
+    /**
+     * Record clicks on elements tagged `apeventaction` (or `data-apeventaction`) as events. On by
+     * default; AppticsEvent.setClickTracking() switches it later.
+     */
+    track_click: true,
     /**
      * 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

package/dist/esm/core/db.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (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 { Console } from './logger.js';
 import { nowMs } from './utils.js';
 

package/dist/esm/core/debug.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (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 { DEBUG_IDLE_MS } from './constants.js';
 import { _ZAP } from './state.js';
 import { Console } from './logger.js';

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

@@ -1,4 +1,3 @@
-import type { AppticsConfig } from '../types.js';
 export declare function isBlockedWS(ua: string): boolean;
 /** Device RAM as the API wants it ("4 GB"). Chromium only; empty elsewhere. */
 export declare function getRam(): string;
@@ -24,5 +23,3 @@ export declare function getTimeZone(): string;
 export declare function is_apptics_disabled(): boolean;
 /** Pure DNT check (no side effects). consent.hasDoNotTrackEnabled() applies NO_TRACKING. */
 export declare function isDntOn(): boolean;
-/** The console snippet's config (window.appticssettings._defaultoptions), if the page defines one. */
-export declare function getSnippetOptions(): AppticsConfig | undefined;

package/dist/esm/core/env.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (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 { BLOCKED_WS } from './constants.js';
 import { includes } from './utils.js';
 
@@ -240,12 +240,5 @@ function isDntOn() {
         return includes(dntValues, dntValue);
     });
 }
-/** The console snippet's config (window.appticssettings._defaultoptions), if the page defines one. */
-function getSnippetOptions() {
-    if (typeof window === 'undefined' || !window.appticssettings) { // no i18n
-        return undefined;
-    }
-    return window.appticssettings._defaultoptions;
-}
 
-export { getBatteryPercent, getBrowser, getBrowserVersion, getConnectionType, getDevice, getNetworkStatus, getOS, getOrientation, getRam, getReferringURL, getSnippetOptions, getTimeZone, isBlockedWS, isDntOn, is_apptics_disabled };
+export { getBatteryPercent, getBrowser, getBrowserVersion, getConnectionType, getDevice, getNetworkStatus, getOS, getOrientation, getRam, getReferringURL, getTimeZone, isBlockedWS, isDntOn, is_apptics_disabled };