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

package/README.md

@@ -12,10 +12,10 @@ The SDK is plain TypeScript with no framework dependency. It works with any bund
 ## Install Apptics
 
 ```bash
-npm install @zoho_apptics/apptics-js-sdk@2.0.0-beta.1
+npm install @zoho_apptics/apptics-js-sdk@2.0.0-beta.2
 ```
 
-A plain `npm install @zoho_apptics/apptics-js-sdk` still installs 1.0.2, the current `latest`. Upgrading from 1.0.2? `Apptics.init()` takes different config now; see [Migrating from 1.0.2 to 2.0.0-beta.1](#migrating-from-102-to-200-beta1).
+A plain `npm install @zoho_apptics/apptics-js-sdk` still installs 1.0.2, the current `latest`. Upgrading from 1.0.2? `Apptics.init()` takes different config now; see [Migrating from 1.0.2 to 2.0.0-beta.2](#migrating-from-102-to-200-beta2).
 
 ## Initialize Apptics
 
@@ -44,7 +44,7 @@ The config object is **required**, with `base_url`, `auth_key`, `app_domain` and
 
 `Apptics.init()` returns right away. The SDK finishes starting once its storage has loaded, usually within a few milliseconds. Calls you make before that are queued and run in order, so you don't have to wait. If you need to know when it's running, use `await Apptics.ready()`.
 
-Every call belongs to an object, named after its feature, so you import only the object and code reads much as it does on Android: `Apptics.init()`, `AppticsEvent.addEvent()`, `AppticsError.trackError()`, `AppticsFeedback.feedbackFormOpen()`. See [The API at a glance](#the-api-at-a-glance). CommonJS works too (`const { Apptics } = require('@zoho_apptics/apptics-js-sdk')`). Importing the SDK is safe during server-side rendering: nothing runs until `Apptics.init()` is called in the browser.
+Every call belongs to an object, named after its feature, so you import only the object: `Apptics.init()`, `AppticsEvent.addEvent()`, `AppticsError.trackError()`, `AppticsFeedback.feedbackFormOpen()`. See [The API at a glance](#the-api-at-a-glance). CommonJS works too (`const { Apptics } = require('@zoho_apptics/apptics-js-sdk')`). Importing the SDK is safe during server-side rendering: nothing runs until `Apptics.init()` is called in the browser.
 
 ### With a `<script>` tag (CDN)
 
@@ -52,7 +52,7 @@ Load the browser build and call `Apptics.init()` after it. One `<script>` tag is
 form's styles are inside the build, so there is no stylesheet to add.
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/@zoho_apptics/apptics-js-sdk@2.0.0-beta.1/dist/apptics.min.js"></script>
+<script src="https://static.zohocdn.com/apptics-js-sdk/2.0.0-beta.2/apptics.min.js"></script>
 <script>
   Apptics.init({
     base_url: 'YOUR_BASE_URL',
@@ -71,7 +71,7 @@ The build defines the same objects as globals (`Apptics`, `AppticsEvent`, `Appti
 or send something are ignored until `Apptics.init()` has run, and the first such call logs a console
 warning saying so.
 
-**Pin the version** (`@2.0.0-beta.1`) rather than a tag or range such as `@beta`, so a release can't change what your pages load. See [Loading from a CDN](#loading-from-a-cdn) for module builds, unpkg and subresource integrity.
+Each release has its own folder on the CDN, `https://static.zohocdn.com/apptics-js-sdk/{version}/`, so a page keeps loading the version it names until you change it. See [Loading from a CDN](#loading-from-a-cdn) for module builds and subresource integrity.
 
 ### The API at a glance
 
@@ -80,22 +80,23 @@ Each feature's calls are on one object:
 | Object | Calls | Entry point |
 |---|---|---|
 | `Apptics` | `init(config)`, `ready()`, `flush()`, `reset()`, `enableDebug()`, `disableDebug()` | main |
-| `AppticsEvent` | `addEvent(eventName, groupName?, properties?)`, `addEvent(DefinedEvents.X, properties?)`, `DefinedEvents` | main |
-| `AppticsScreen` | `inScreen(screenName, properties?)` → id, `outScreen(id)` | main |
-| `AppticsError` | `trackError(error, properties?)`, `trackGlobalErrorHandler(enabled?)` | main |
+| `AppticsEvent` | `addEvent(eventName, groupName, properties?)`, `addEvent(DefinedEvents.X, properties?)`, `setClickTracking(enabled?)`, `DefinedEvents` | main |
+| `AppticsScreen` | `inScreen(screenName, properties?)` → id, `outScreen(id)`, `setScreenTracking(enabled?)` | main |
+| `AppticsError` | `trackError(error, properties?)`, `setErrorTracking(enabled?)` | main |
 | `AppticsUser` | `setUser(userid, groupid?, properties?)`, `getUser()`, `UserBuilder` | main |
 | `AppticsSettings` | `setTrackingStatus(status)`, `getTrackingStatus()`, the `AP_TRACKING_STATUS` constants | main |
-| `AppticsApi` | `startTrackApi(url, method?)` → id, `endTrackApi(id, responseCode, responseMessage?)`, `configure(config)`, `enableApiTracking(enabled?)`, `ApiTrackingBuilder` | main |
-| `AppticsHeatmap` | `trackHeatmap(on?)` | main |
+| `AppticsApi` | `startTrackApi(url, method?)` → id, `endTrackApi(id, responseCode, responseMessage?)`, `configure(config)`, `setApiTracking(enabled?)`, `ApiTrackingBuilder` | main |
+| `AppticsHeatmap` | `setHeatmapTracking(enabled?)` | main |
 | `AppticsLogger` | `verbose(message, properties?)`, `debug(message, properties?)`, `info(message, properties?)`, `warn(message, properties?)`, `error(message, properties?)` | `/remote-logger` |
 | `AppticsFeedback` | `feedbackFormOpen(options?)`, `feedbackFormClose()`, `sendFeedback(options?)`, `addFeedbackLog(message)`, `addDiagnosticsInfo(heading, key, value)`, `setFeedbackTheme(theme)`, the `AP_FEEDBACK_TYPE` constants | `/feedback` |
-| `AppticsRemoteConfig` | `fetchValue(name, callback?)`, `fetchValues(names?, callback?)`, `setCustomConditionValue(conditionname, value)` | `/remote-config` |
+| `AppticsRemoteConfig` | `fetchValue(name, callback?, coldFetch?)`, `fetchValues(names?, callback?, coldFetch?)`, `setCustomConditionValue(conditionname, value)` | `/remote-config` |
 
-The package exports only these objects: `DefinedEvents` is `AppticsEvent.DefinedEvents`, and the builders are `AppticsApi.ApiTrackingBuilder` and `AppticsUser.UserBuilder`. Android's `AppticsScreenTracker` and `AppticsApiTracker` are `AppticsScreen` and `AppticsApi` here.
+The `set…Tracking(enabled?)` calls switch each automatic tracker on or off while the page runs
+(see [Turning automatic tracking on and off](#turning-automatic-tracking-on-and-off)).
 
 ### Frameworks
 
-React, Vue, Angular, Svelte, Ember, Solid, jQuery and hand-written JS all start the same way, and every one of them needs only that: the SDK follows the route itself ([automatic screen tracking](#automatic-screen-tracking)). To name screens from your router instead, call `AppticsScreen.inScreen()` from the hook in the last column: a call made as the route changes replaces the automatic view, and `track_screen: false` turns the automatic one off altogether, which is what the recipes in `examples/frameworks` do.
+React, Vue, Angular, Svelte, Ember, Solid, jQuery and hand-written JS all start the same way, and every one of them needs only that: the SDK follows the route itself ([automatic screen tracking](#automatic-screen-tracking)). To name screens from your router instead, call `AppticsScreen.inScreen()` from the hook in the last column: a call made as the route changes replaces the automatic view, and `track_screen: false` turns the automatic one off altogether.
 
 | Framework | Start | Screen on navigation, with `track_screen: false` |
 |---|---|---|
@@ -108,8 +109,6 @@ React, Vue, Angular, Svelte, Ember, Solid, jQuery and hand-written JS all start
 | Nuxt 3 | `plugins/apptics.client.ts` | `useRouter().afterEach(…)` |
 | Plain JS, jQuery | the `<script>` tag itself | `AppticsScreen.inScreen()` where you change view |
 
-**Server-side rendering** (Next, Nuxt, SvelteKit, Remix, Angular Universal): importing the SDK on the server is safe (`Apptics.init()` returns `false` instead of throwing), but it tracks nothing there. Start it from a browser-only hook, as the recipes do. There is no Node/server-side tracking: `engines.node` in `package.json` is the floor for building the package and running its CLI.
-
 ## Error Tracking
 
 Uncaught errors and unhandled promise rejections are tracked automatically, as JS errors in the console.
@@ -126,7 +125,15 @@ try {
 }
 ```
 
-`AppticsError.trackError` also accepts `error` and `unhandledrejection` events as they are, and properties as a second argument. Turn the automatic tracking off with `AppticsError.trackGlobalErrorHandler(false)`.
+`AppticsError.trackError` also accepts `error` and `unhandledrejection` events as they are, and properties as a second argument.
+
+To record only the errors you report yourself, turn the automatic tracking off, at start-up or
+later. `AppticsError.trackError()` records either way:
+
+```ts
+Apptics.init({ ...config, track_error: false });   // from the start
+AppticsError.setErrorTracking(false);              // or while the page runs; true turns it back on
+```
 
 React, Vue, Angular, SvelteKit and Ember catch render errors themselves, so those never reach `window.onerror`. Report them from the framework's own error hook:
 
@@ -140,22 +147,37 @@ React, Vue, Angular, SvelteKit and Ember catch render errors themselves, so thos
 
 ## Event Tracking
 
-Track an event, with an optional group and properties:
+Track an event in a group, with optional properties:
 
 ```ts
 import { AppticsEvent } from '@zoho_apptics/apptics-js-sdk';
 
+AppticsEvent.addEvent('eventName', 'eventGroupName');
 AppticsEvent.addEvent('eventName', 'eventGroupName', { propKey: 'propValue' });
 ```
 
+The group is required. An event without one (left out, `''`, or properties in its place, as in
+`addEvent('eventName', { propKey: 'propValue' })`) is not logged, and the console says so, debug
+or not:
+
+```
+AppticsEvent.addEvent: groupName is required for "eventName": addEvent(eventName, groupName, properties?)
+```
+
 Event and group names start with a letter, followed by letters, digits or `_`, at most 100
-characters, and may not start with `ap_` or `AP_`, which is reserved for defined events. As on
-Android, an event with an invalid name or group is not logged, and the console says why. A group
-left out is `default`.
+characters, and may not start with `ap_` or `AP_`, which is reserved for defined events. An event
+with an invalid name or group is not logged, and the console says why.
+
+Properties: keys start with a letter, followed by up to 49 letters, digits or `_`, and may not
+start with `ap_`. Values are numbers, booleans or strings of up to 250 characters; anything else
+(an object, an array) is sent as its JSON text. A property that breaks these rules
+is dropped and the event is still logged with the rest. At most 24 properties and 7,666
+characters in all; past that the later ones are dropped. The same rules apply to screen and error
+properties.
 
 ### Defined events
 
-Apptics' ready-made events, as Android's `DefinedEvents`, each with its own `AP_` group. They are
+Apptics' ready-made events, each with its own `AP_` group. They are
 not tracked automatically; log the ones that apply:
 
 ```ts
@@ -177,7 +199,9 @@ AppticsEvent.addEvent(DefinedEvents.AP_SEARCH, { results: 12 });
 
 With a `<script>` tag it is `AppticsEvent.DefinedEvents` too.
 
-Clicks can also be tracked from markup, without code:
+### Click tracking
+
+Clicks can be tracked from attributes in your markup, with no code:
 
 ```html
 <section apgroupaction="checkout">
@@ -185,21 +209,27 @@ Clicks can also be tracked from markup, without code:
 </section>
 ```
 
-Clicking the button, or anything inside it, tracks `buy_clicked` in group `checkout`. The
-`data-` spellings work too (`data-apeventaction`, `data-apgroupaction`, `data-apeventprops`), which
-React and TypeScript accept as they are.
+Clicking the button, or anything inside it, tracks `buy_clicked` in group `checkout`, the nearest
+`apgroupaction` around it, with the properties in `apeventprops` (JSON). An element with no
+`apgroupaction` around it is not tracked, and the console says the group is missing. The `data-`
+spellings work too (`data-apeventaction`, `data-apgroupaction`, `data-apeventprops`), which React
+and TypeScript accept as they are.
+
+#### Turning click tracking off
+
+`track_click: false` in `Apptics.init()`, or `AppticsEvent.setClickTracking(false)` while the page
+runs, stops click tracking from markup. `AppticsEvent.addEvent()` records either way.
+
+```ts
+Apptics.init({ ...config, track_click: false });   // from the start
+AppticsEvent.setClickTracking(true);               // or switch it later
+```
 
-Properties: keys start with a letter, followed by up to 49 letters, digits or `_`, and may not
-start with `ap_`. Values are numbers, booleans or strings of up to 250 characters; anything else
-(an object, an array) is sent as its JSON text. As on Android, a property that breaks these rules
-is dropped and the event is still logged with the rest. At most 24 properties and 7,666
-characters in all; past that the later ones are dropped. The same rules apply to screen and error
-properties.
 
 ## Screen Tracking
 
 Screens are tracked automatically, from the URL (see [below](#automatic-screen-tracking)). To
-record one yourself, with your own name or with properties, call `AppticsScreen.inScreen`, as on Android:
+record one yourself, with your own name or with properties, call `AppticsScreen.inScreen`:
 
 ```ts
 import { AppticsScreen } from '@zoho_apptics/apptics-js-sdk';
@@ -210,7 +240,7 @@ AppticsScreen.inScreen('checkout');
 Each screen view records how long it lasted. It ends when the next screen starts, when the page
 is hidden (coming back starts a new view of the same screen), or when its session ends.
 `AppticsScreen.inScreen` returns the view's id; hand it to `AppticsScreen.outScreen` to end the view yourself (a dialog
-that closes without the page changing, say), as Android's `AppticsScreenTracker.outScreen` does:
+that closes without the page changing, say):
 
 ```ts
 import { AppticsScreen } from '@zoho_apptics/apptics-js-sdk';
@@ -283,6 +313,13 @@ aren't routes, or hooks that run later than that), turn automatic tracking off:
 Apptics.init({ ...config, track_screen: false });
 ```
 
+or switch it while the page runs, for a part of the app that names its screens itself:
+
+```ts
+AppticsScreen.setScreenTracking(false);   // only inScreen() calls are recorded
+AppticsScreen.setScreenTracking(true);    // back on: the page as it is now is recorded
+```
+
 `Apptics.reset()` takes the history wrappers off; the `Apptics.init()` it runs puts them back.
 
 ## Track User
@@ -348,10 +385,10 @@ Record the API calls your app makes, for the console's API page. Either let the
 Apptics.init({ ...config, track_api: true });   // record every fetch and XHR call
 ```
 
-`AppticsApi.enableApiTracking(enabled)` switches it later. Which hosts and endpoints are recorded is set with
+`AppticsApi.setApiTracking(enabled)` switches it later. Which hosts and endpoints are recorded is set with
 [`AppticsApi.configure`](#configuring-api-tracking).
 
-or record calls yourself with `AppticsApi.startTrackApi` / `endTrackApi`, as on Android. The
+or record calls yourself with `AppticsApi.startTrackApi` / `endTrackApi`. The
 SDK times the call between the two:
 
 ```ts
@@ -414,7 +451,7 @@ The rules apply to every call, the ones `track_api` catches and the ones you rep
 
 The SDK's own requests are never recorded, and neither are calls to `localhost` or a bare IP
 address: the server only accepts hostnames with a dot and a letters-only suffix, so the SDK drops
-those calls and says so in the console. `AppticsApi.enableApiTracking(false)` removes the wrappers again.
+those calls and says so in the console. `AppticsApi.setApiTracking(false)` removes the wrappers again.
 With a `<script>` tag, `AppticsApi` is a global as it is here, `AppticsApi.ApiTrackingBuilder`
 included.
 
@@ -429,6 +466,7 @@ const banner = await AppticsRemoteConfig.fetchValue('bannerText');         // nu
 const some = await AppticsRemoteConfig.fetchValues(['primaryColor', 'maxItems']);
 // → { primaryColor: '#0b6e4f', maxItems: '10' }
 const all = await AppticsRemoteConfig.fetchValues();                       // every parameter
+const fresh = await AppticsRemoteConfig.fetchValue('bannerText', true);   // coldFetch: asks the server now
 
 // for a custom condition: its name, then this device's values, comma separated
 AppticsRemoteConfig.setCustomConditionValue('is_custom', 'custom_color');
@@ -447,10 +485,13 @@ Values are text, as the console stores them: `Number(values.maxItems)`,
 The SDK fetches once on its own when it starts (or when this module is imported after it has),
 so values are this session's without a call of yours.
 
-**Fetching.** `fetchValue` and `fetchValues` reuse a fetch from the last five minutes
-rather than asking the server again, so reading a value on every render costs no requests; once
-that fetch is older, the next call asks the server. Each also takes a callback, as on Android,
-and returns a Promise either way.
+**Fetching.** The first fetch of each page load asks for the whole rule set, and its answer
+replaces what was stored. After that the SDK keeps the values up to date by itself: every 3
+minutes, and when the tab comes back after 15 seconds or more away, it asks only for what changed
+since its last fetch and merges that into the stored set. `fetchValue` and `fetchValues` answer
+from those values, so reading a value on every render costs no requests. Each also takes a
+callback, and returns a Promise either way. To ask the server now instead, see
+[Cold fetch](#cold-fetch).
 
 **When a fetch fails** (offline, or a server error), they answer with the values fetched before;
 with none fetched yet, `null` (and `fetchValues()` answers with no parameters).
@@ -467,18 +508,44 @@ Conditions on the user, such as the customer group, are re-applied on their own
 
 | Call | Notes |
 |---|---|
-| `fetchValue(name, callback?)` | One parameter for this session; `null` when the console has none. |
-| `fetchValues(names?, callback?)` | The parameters named in the list, `null` for a missing one; with no names, every parameter. `fetchValues(callback)` works too. |
+| `fetchValue(name, callback?, coldFetch?)` | One parameter for this session; `null` when the console has none. `fetchValue(name, coldFetch)` works too. `coldFetch: true` asks the server now (see [Cold fetch](#cold-fetch)). |
+| `fetchValues(names?, callback?, coldFetch?)` | The parameters named in the list, `null` for a missing one; with no names, every parameter. `fetchValues(callback)`, `fetchValues(names, coldFetch)` and `fetchValues(coldFetch)` work too. |
 | `setCustomConditionValue(conditionname, value)` | This device's values for a custom condition, comma separated (`'gold,platinum'`); an empty value removes them. |
 
 With a `<script>` tag, `AppticsRemoteConfig` is a global as it is here.
 
+### Cold fetch
+
+By default `fetchValue` and `fetchValues` answer from the values the page already has, which the
+SDK keeps up to date every 3 minutes. For a value that must be current now, say right after it was
+changed in the console, or before a step that depends on it, pass `true` as the last argument:
+`fetchValue('bannerText', true)`, `fetchValues(['primaryColor', 'maxItems'], true)`,
+`fetchValues(true)` for every parameter, or after a callback, as in
+`fetchValue('bannerText', render, true)`.
+
+What a cold fetch does:
+
+- It asks the server for the whole rule set now (`getupdates` with `flagtime` 0), whatever the page
+  has already fetched, and the answer **replaces** the stored set, as the first fetch of a page
+  load does. The value is then chosen from it as usual, and the SDK's 3-minute updates go on from
+  there.
+- It waits for start-up, and on a first visit for the device to be registered, before asking:
+  calling it straight after `Apptics.init()` is fine.
+- **At most three cold fetches in any minute**, per page. One past that makes no request and
+  answers from the values the page already has, as `coldFetch: false` would; with
+  `console_log: true`, the console says so.
+- Cold fetches made at the same time share one request.
+- If it fails (offline, or a server error), it answers from the values fetched before, or `null`
+  with none fetched yet, as any fetch does.
+
+`coldFetch` is `false` by default. Use it for the moments that need it, not on every read: each
+one is a request for the whole rule set.
+
 ## Remote Logger
 
 Send your app's log lines to the console's Remote Logger page with `AppticsLogger`, from its own
 entry point (`@zoho_apptics/apptics-js-sdk/remote-logger`) so apps that don't log don't ship it.
-Nothing is logged on its own: only the lines your app writes, at five levels, as Android's
-`v` / `d` / `i` / `w` / `e` with their names in full. A line is recorded as it is written, with no
+Nothing is logged on its own: only the lines your app writes, at five levels. A line is recorded as it is written, with no
 switch to turn on first:
 
 ```ts
@@ -503,12 +570,11 @@ AppticsLogger.error('Payment failed', err);          // an Error as properties:
 an `Error` as its stack. Each line records the time it was logged and the function, file and line
 that logged it, even when logged before start-up finishes. Lines are stored before they are sent
 and go out in batches of up to 50: a line survives a failed send and a reload, and is removed once
-the server accepts it. At most 1 MB of lines waits at once, oldest dropped first, as on Android,
+the server accepts it. At most 1 MB of lines waits at once, oldest dropped first,
 and a line is trimmed to 10,000 characters. Nothing is recorded while the server has the remote
 logger switched off for the app, or while tracking is off.
 
-Unlike Android, which uploads at the next cold start or on a schedule, lines go out about a
-second after they're logged: a browser tab can close at any moment, and waiting would lose them.
+Lines go out about a second after they're logged: a browser tab can close at any moment, and waiting would lose them.
 
 ## In-App Feedback
 
@@ -640,15 +706,15 @@ main entry point and off until you turn it on.
 import { Apptics, AppticsHeatmap } from '@zoho_apptics/apptics-js-sdk';
 
 Apptics.init({ ...config, track_heatmap: true });
-// or turn it on later: AppticsHeatmap.trackHeatmap(true)
+// or turn it on later: AppticsHeatmap.setHeatmapTracking(true)
 ```
 
 `track_heatmap: true` in `Apptics.init()` starts capture with the SDK. With a `<script>` tag it's
-`AppticsHeatmap.trackHeatmap()` on the `AppticsHeatmap` global.
+`AppticsHeatmap.setHeatmapTracking()` on the `AppticsHeatmap` global.
 
 | Call | Notes |
 |---|---|
-| `AppticsHeatmap.trackHeatmap(on?)` | Starts or stops capture; `on` defaults to `true`. |
+| `AppticsHeatmap.setHeatmapTracking(enabled?)` | Starts or stops capture; `enabled` defaults to `true`. |
 
 Heatmap records go out with the rest of the stored data: on the flush timer, or when you call
 `Apptics.flush()`.
@@ -709,6 +775,8 @@ Everything `Apptics.init(config)` accepts.
 | `track_heatmap` | | Record clicks and scrolls (see [Heatmaps](#heatmaps)). Off by default |
 | `heatmap_max_per_session` | | Most heatmap records one visit may produce: 500 by default, 0 to 10000. Capture pauses past it |
 | `track_screen` | | Record a screen view for every navigation, named by its path. On by default; `false` turns it off (see [Automatic screen tracking](#automatic-screen-tracking)) |
+| `track_error` | | Record uncaught errors and unhandled promise rejections. On by default; `false` turns it off (see [Error Tracking](#error-tracking)) |
+| `track_click` | | Record clicks on elements tagged `apeventaction`. On by default; `false` turns it off (see [Click tracking](#click-tracking)) |
 | `screen_routes` | | How automatic screen tracking names a path: route patterns (`'/users/{id}/orders'`), `{ equals, name }` and `{ regex, name }` rules, tried in order (see [Automatic screen tracking](#automatic-screen-tracking)) |
 | `feedback_theme` | | The feedback form's theme: `'light'`, `'dark'` or `'auto'` (the default, which follows the visitor's system setting). See [Show feedback screen](#show-feedback-screen) |
 | `device_name` | | Names this device in debug mode (see [Debugging](#debugging)) |
@@ -717,45 +785,55 @@ The earlier names still work, with a console warning naming the key to use: `ser
 `base_domain` for `base_url`, `zak` and `token` for `auth_key`, and `identifier` for `app_domain`.
 `aaid`, `zsoid` and `projectID` are no longer needed, and are ignored if passed.
 
-### Timing
+**Changing `base_url`, `app_domain` or `auth_key`.** What the SDK stores in a browser belongs to
+the app it was registered with. When a page starts with a different `base_url`, `app_domain` or
+`auth_key` from the stored data's, the SDK clears all of it, unsent data included, and starts as on
+a first visit: the app version and the device are registered again. Only a short fingerprint of
+`auth_key` is stored, not the key itself.
 
-Data is stored first and sent on a timer, so these control how often the SDK talks to the server. All are optional; a value outside its range is ignored with a warning and the default is used.
+`Apptics.flush()` sends at most once every 15 seconds, however often it is called: a call sooner
+than that sends nothing, and what is stored goes with the next send.
 
-| Key | Default | Range | Description |
-|---|---|---|---|
-| `batch_flush_interval` | `30000` | 1000 to 3600000 | How often stored data is sent, in milliseconds |
-| `getupdates_interval` | `120000` | 10000 to 86400000 | How often the server's tracking settings are checked, in milliseconds; the server can ask for a longer wait |
-| `batch_size` | `50` | 1 to 500 | Most items in one request (also capped at 1 MB) |
-| `batch_request_timeout` | `7` | 1 to 30 | Days an unsent item is kept before it is dropped |
-| `inactiveduration` | `30` | 1 to 1440 | Idle minutes that end a session |
-| `min_session_duration` | `5000` | 0 to 60000 | Milliseconds a visit must last before its session is recorded; anything tracked sooner records it at once. `0` turns the wait off |
+### Turning automatic tracking on and off
 
-Data is also sent when you call `Apptics.flush()`, when the page is hidden, when the tab closes, and when the browser comes back online. The interval is the floor, not the only trigger.
+Each tracker the SDK runs on its own has a config key, read when `Apptics.init()` runs, and a call
+to switch it while the page runs. The call takes `true` or `false`; with no argument it means
+`true`.
 
-## API reference
-
-| Call | Notes |
-|---|---|
-| `Apptics.init(config)` | Starts the SDK. Returns `true` when start-up has begun. |
-| `Apptics.ready()` | Promise that resolves `true` once the SDK is running (`false` if it can't start). |
-| `AppticsEvent.addEvent(eventName, groupName?, properties?)` / `AppticsEvent.addEvent(AppticsEvent.DefinedEvents.X, properties?)` | See [Event Tracking](#event-tracking). |
-| `AppticsScreen.inScreen(screenName, properties?)` → id / `AppticsScreen.outScreen(id)` | See [Screen Tracking](#screen-tracking). |
-| `AppticsError.trackError(error, properties?)` / `AppticsError.trackGlobalErrorHandler(enabled?)` | See [Error Tracking](#error-tracking). |
-| `AppticsUser.setUser(userid, groupid?, properties?)` / `AppticsUser.getUser()` / `AppticsUser.UserBuilder` | See [Track User](#track-user). |
-| `AppticsSettings.setTrackingStatus(status)` / `AppticsSettings.getTrackingStatus()` / `AppticsSettings.AP_TRACKING_STATUS` | See [Tracking settings](#tracking-settings). |
-| `AppticsApi.startTrackApi(url, method?)` / `endTrackApi(id, responseCode, responseMessage?)` / `configure(config)` / `enableApiTracking(enabled?)` / `AppticsApi.ApiTrackingBuilder` | See [API Tracking](#api-tracking). |
-| `AppticsLogger.verbose / debug / info / warn / error(message, properties?)` | From `/remote-logger`; see [Remote Logger](#remote-logger). |
-| `AppticsRemoteConfig.fetchValue(name, callback?)` / `fetchValues(names?, callback?)` / `setCustomConditionValue(conditionname, value)` | From `/remote-config`; see [Remote Config](#remote-config). |
-| `AppticsFeedback.addFeedbackLog(message)` / `AppticsFeedback.addDiagnosticsInfo(heading, key, value)` | From `/feedback`; see [Attach logs and diagnostics](#attach-logs-and-diagnostics-with-feedback). |
-| `AppticsFeedback.feedbackFormOpen(options?)` / `feedbackFormClose()` / `sendFeedback(options?)` / `setFeedbackTheme(theme)` / `AppticsFeedback.AP_FEEDBACK_TYPE` | From `/feedback`; see [In-App Feedback](#in-app-feedback). |
-| `AppticsHeatmap.trackHeatmap(on?)` | See [Heatmaps](#heatmaps). |
-| `Apptics.flush()` | Send stored data now (engagement, errors and heatmap records); it's otherwise sent every 30 s (see [Timing](#timing)). |
-| `Apptics.enableDebug()` / `Apptics.disableDebug()` | See [Debugging](#debugging). |
-| `Apptics.reset()` | Clear stored identity, queued data and remote config values, then start again. |
-
-Entry points: `@zoho_apptics/apptics-js-sdk` (everything above except what follows), `/feedback`, `/remote-config`
-(see [Remote Config](#remote-config)), `/remote-logger` (see [Remote Logger](#remote-logger)). Types ship with the package:
-`import type { AppticsConfig, TrackingStatus } from '@zoho_apptics/apptics-js-sdk'`.
+| Tracker | Default | Config key | Call |
+|---|---|---|---|
+| Screen views from the URL | on | `track_screen` | `AppticsScreen.setScreenTracking(enabled)` |
+| Uncaught errors and unhandled rejections | on | `track_error` | `AppticsError.setErrorTracking(enabled)` |
+| Clicks on tagged elements | on | `track_click` | `AppticsEvent.setClickTracking(enabled)` |
+| The app's fetch and XHR calls | off | `track_api` | `AppticsApi.setApiTracking(enabled)` |
+| Clicks and scrolls for heatmaps | off | `track_heatmap` | `AppticsHeatmap.setHeatmapTracking(enabled)` |
+
+- The config key decides at start-up. A call made before `Apptics.init()` is replaced by it, and
+  `Apptics.reset()` goes back to the config too.
+- The calls you make yourself (`addEvent`, `inScreen`, `trackError`, `startTrackApi`) record
+  whichever way a switch is set.
+- To stop all tracking for a visitor, use
+  `AppticsSettings.setTrackingStatus(AppticsSettings.AP_TRACKING_STATUS.NO_TRACKING)` instead (see
+  [Tracking settings](#tracking-settings)).
+
+The 2.0.0-beta.1 names of three of these calls still work, with a console warning naming the one to
+use: `AppticsApi.enableApiTracking`, `AppticsError.trackGlobalErrorHandler` and
+`AppticsHeatmap.trackHeatmap`.
+
+### Sessions
+
+A session starts with the visit and goes on while the user comes back to the tab within
+`inactiveduration` minutes (30 by default).
+
+- When the tab goes inactive (hidden, minimised, or its window loses focus to another one), that
+  moment is the session's last active time. Moving focus into an iframe on the page does not count.
+- Back within `inactiveduration`, the same session goes on.
+- Not back by then, the session ends at its last active time and is sent, so the time away is not
+  counted. Coming back later starts a new session.
+- A tab closed while inactive ends its session at its last active time too, not when it closed; a
+  tab closed while in use ends it then.
+- While another tab of the site is still on the session, a tab that goes inactive or closes only
+  leaves it: the last one ends it.
 
 ## Loading from a CDN
 
@@ -763,9 +841,12 @@ For `<script type="module">`, load the minified ESM build (a few requests instea
 
 ```html
 <script type="module">
-  import { Apptics, AppticsEvent } from 'https://cdn.jsdelivr.net/npm/@zoho_apptics/apptics-js-sdk@2.0.0-beta.1/dist/apptics.esm.min.js';
-  // The feedback form is a separate file, so pages without it don't download it
-  import { AppticsFeedback } from 'https://cdn.jsdelivr.net/npm/@zoho_apptics/apptics-js-sdk@2.0.0-beta.1/dist/feedback.esm.min.js';
+  import { Apptics, AppticsEvent } from 'https://static.zohocdn.com/apptics-js-sdk/2.0.0-beta.2/apptics.esm.min.js';
+  // Feedback, remote config and the remote logger are files of their own, so a page downloads
+  // only the ones it imports
+  import { AppticsFeedback } from 'https://static.zohocdn.com/apptics-js-sdk/2.0.0-beta.2/feedback.esm.min.js';
+  import { AppticsRemoteConfig } from 'https://static.zohocdn.com/apptics-js-sdk/2.0.0-beta.2/remoteconfig.esm.min.js';
+  import { AppticsLogger } from 'https://static.zohocdn.com/apptics-js-sdk/2.0.0-beta.2/remotelogger.esm.min.js';
 
   Apptics.init({
     base_url: 'YOUR_BASE_URL',
@@ -780,16 +861,18 @@ For `<script type="module">`, load the minified ESM build (a few requests instea
 
 | File | For | Size (gzipped) |
 |---|---|---|
-| `dist/apptics.min.js` | `<script>` pages; sets `window.apptics`, includes every module | ~53 kB |
-| `dist/apptics.esm.min.js` | `<script type="module">`; analytics only (with the `dist/chunks/` files it imports) | ~30 kB |
-| `dist/feedback.esm.min.js` | the feedback form, for module pages | ~17 kB more |
+| `apptics.min.js` | `<script>` pages; sets `window.apptics`, includes every module | ~53 kB |
+| `apptics.esm.min.js` | `<script type="module">`; the main entry (with the `chunks/` files it imports) | ~32 kB |
+| `feedback.esm.min.js` | `AppticsFeedback`, the feedback form, for module pages | ~17 kB more |
+| `remoteconfig.esm.min.js` | `AppticsRemoteConfig`, for module pages | ~7 kB more |
+| `remotelogger.esm.min.js` | `AppticsLogger`, for module pages | ~1 kB more |
 
-The module files share one copy of the SDK through `dist/chunks/`, so load them all from the same version and path.
+The module files share one copy of the SDK through the `chunks/` folder beside them, so load them all from the same version's folder.
 
-unpkg works the same way: `https://unpkg.com/@zoho_apptics/apptics-js-sdk@2.0.0-beta.1/dist/apptics.min.js`. Add `defer` if you don't need the SDK before the page renders. For a subresource-integrity hash:
+Every release is in a folder of its own, `https://static.zohocdn.com/apptics-js-sdk/{version}/`, holding `apptics.min.js`, `apptics.esm.min.js`, `feedback.esm.min.js`, `remoteconfig.esm.min.js`, `remotelogger.esm.min.js`, `chunks/` and the source maps. Add `defer` if you don't need the SDK before the page renders. For a subresource-integrity hash:
 
 ```bash
-curl -s https://cdn.jsdelivr.net/npm/@zoho_apptics/apptics-js-sdk@2.0.0-beta.1/dist/apptics.min.js \
+curl -s https://static.zohocdn.com/apptics-js-sdk/2.0.0-beta.2/apptics.min.js \
   | openssl dgst -sha384 -binary | openssl base64 -A
 ```
 
@@ -797,20 +880,20 @@ curl -s https://cdn.jsdelivr.net/npm/@zoho_apptics/apptics-js-sdk@2.0.0-beta.1/d
 <script src="…/apptics.min.js" integrity="sha384-…" crossorigin="anonymous"></script>
 ```
 
-## Migrating from 1.0.2 to 2.0.0-beta.1
+## Migrating from 1.0.2 to 2.0.0-beta.2
 
 ### What you need to change
 
 - **Every call is on the object of its feature.** Rename them everywhere, router hooks included: a
   call to an old name left in place throws.
 
-  | 1.0.2 | 2.0.0-beta.1 |
+  | 1.0.2 | 2.0.0-beta.2 |
   |---|---|
   | `apptics.init(config)` | `Apptics.init(config)` |
   | `apptics.trackEvent(name, group, props)` | `AppticsEvent.addEvent(eventName, groupName, properties)` |
   | `apptics.trackScreen(name, props)` | `AppticsScreen.inScreen(screenName, properties)`, which also returns the view's id for `AppticsScreen.outScreen(id)` |
   | `apptics.trackError(event, props)` | `AppticsError.trackError(error, properties)` |
-  | `apptics.enableGlobalErrorHandler(on)` | `AppticsError.trackGlobalErrorHandler(enabled)` |
+  | `apptics.enableGlobalErrorHandler(on)` | `AppticsError.setErrorTracking(enabled)`, or `track_error` in `Apptics.init()` |
   | `apptics.setUser(userid, groupid, props)` | `AppticsUser.setUser(userid, groupid, properties)` |
   | `apptics.getUser()`, `new users.UserBuilder()` | `AppticsUser.getUser()`, `new AppticsUser.UserBuilder()` |
   | `apptics.setTrackingStatus(s)`, `getTrackingStatus()` | `AppticsSettings.setTrackingStatus(status)`, `AppticsSettings.getTrackingStatus()` |
@@ -823,6 +906,10 @@ curl -s https://cdn.jsdelivr.net/npm/@zoho_apptics/apptics-js-sdk@2.0.0-beta.1/d
   required (1.0.2's `base_domain` and `token` still work, with a warning). The SDK gets `aaid` and the portal and project ids from the server itself, so
   `aaid`/`aaID`, `zsoid` and `projectID` are no longer needed and are ignored if passed. Without a
   required key, `Apptics.init()` logs which one is missing and returns `false`.
+- **Every event needs a group.** 1.0.2 filed an event with no group under `default`; now it is
+  not logged, and the console says the group is missing. Pass one to every
+  `AppticsEvent.addEvent(eventName, groupName, properties?)`, and put an `apgroupaction` around
+  every element tracked with `apeventaction`. Defined events bring their own.
 - **`appversion` is required.** 1.0.2 quietly defaulted it to `1.0`, which attributed every session,
   error and crash to a version that was never shipped. Pass your real build version.
 - **npm users can import the SDK.** 1.0.2 exported nothing, so it only worked alongside the console
@@ -841,11 +928,11 @@ curl -s https://cdn.jsdelivr.net/npm/@zoho_apptics/apptics-js-sdk@2.0.0-beta.1/d
 ### Behaviour you may notice
 
 - **`debug: true` now turns on debug mode** (requests followed in the Apptics web console). In 1.0.2 it logged to the browser console.
-- When the Apptics server tells the SDK to stop tracking an app version, it stops; 1.0.2 ignored that signal.
+- When the Apptics server tells the SDK to stop tracking an app version, it stops; 1.0.2 ignored that signal. Events, screens, sessions, API calls and errors each follow their own switch in the Apptics console, so turning one off leaves the others on.
 - `ignore_do_not_track: true` now ignores the browser's Do Not Track setting; in 1.0.2 it disabled tracking. Do Not Track is decided on every visit and never stored.
 - `mute()` and `unmute()` are gone. To stop tracking, use `AppticsSettings.setTrackingStatus(AppticsSettings.AP_TRACKING_STATUS.NO_TRACKING)`; unlike `mute()`, it is stored across visits. Feedback is still sent with tracking off.
 - **Screens are tracked automatically**, from the URL, including single-page route changes. An `AppticsScreen.inScreen()` called from your router replaces the automatic view of that navigation, so nothing is counted twice; `track_screen: false` turns automatic tracking off, and `screen_routes` names paths. Each screen view now records how long it lasted.
-- **Events and properties follow the Android rules**: an event with an invalid group is not logged (a missing group is still `default`), names and keys may not start with `ap_`, and a bad property is dropped on its own rather than taking the others with it. Booleans arrive as Boolean, and `1` / `0` as Number. An invalid name is said in the console.
+- **Events and properties are checked**: an event with a missing or invalid group is not logged, names and keys may not start with `ap_`, and a bad property is dropped on its own rather than taking the others with it. Booleans arrive as Boolean, and `1` / `0` as Number. An invalid name is said in the console.
 - Calling `Apptics.init()` a second time is ignored; use `Apptics.reset()` to start over.
 - `Apptics.init()` still returns at once, but start-up finishes a few milliseconds later, once storage loads, so `window.appticsReady()` fires slightly later than in 1.0.2. Calls made in between are queued and replayed; `await Apptics.ready()` waits for it. A first visit with no network starts once the browser is back online.
 - `AppticsFeedback.sendFeedback()` returns a Promise. `includeLog` and `includeDiagnostics` are three-way: `true` always sends that file, `false` never does, and leaving it unset sends it when something is stored.
@@ -853,7 +940,7 @@ curl -s https://cdn.jsdelivr.net/npm/@zoho_apptics/apptics-js-sdk@2.0.0-beta.1/d
 - Clicks tracked with `apeventaction` (or `data-apeventaction`) no longer need jQuery.
 - Data moves from localStorage to IndexedDB on the first visit (device identity, consent, unsent events, feedback log entries), and the old keys are removed. Where IndexedDB is unavailable, the SDK keeps using localStorage.
 - Queued data is sent when the page is hidden or closed, using `pagehide` / `visibilitychange` instead of `beforeunload`.
-- New, and off until you use them: heatmaps (`AppticsHeatmap.trackHeatmap()`), remote config, API tracking and the remote logger (`AppticsLogger`). Remote config, once imported, fetches its values on start-up.
+- New, and off until you use them: heatmaps (`AppticsHeatmap.setHeatmapTracking()`), remote config, API tracking and the remote logger (`AppticsLogger`). Remote config, once imported, fetches its values on start-up.
 
 ## License
 

package/dist/apptics.esm.min.js

@@ -1,3 +1,3 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
-import{o as e,C as t,B as n,n as r,c as a,D as i,E as s,G as o,H as c,_ as u,d as l,j as p,e as d,I as f,J as g,K as m,A as h,L as _,M as w,N as A,b as v,O as b,P as k,Q as y,R as T,S as E,T as H,U as S,V as M,w as x,W as U,X as D,Y as L,Z as N,$ as O,x as P,a0 as Y,y as C,a1 as G,z as W,a2 as X,a3 as j,a4 as I,a5 as z,a6 as q,a7 as B,a8 as K,a9 as R,aa as J,ab as Q,ac as V,ad as Z,ae as $,af as F,ag as ee,ah as te}from"./chunks/lifecycle-VYr43KcB.min.js";var ne=!1,re=0,ae=[],ie=0,se=0,oe=0,ce=null,ue=null,le=new WeakMap,pe=0,de=0;function fe(){var e=o("heatmap_max_per_session");return("number"!=typeof e||e<=0)&&(e=c.heatmap_max_per_session),!(re>=e)||(re===e&&(re++,t.log("apptics.heatmap: reached "+e+" records for this session, pausing capture")),!1)}function ge(){var e=document.documentElement,t=document.body;return Math.max(e?e.scrollHeight:0,t?t.scrollHeight:0,e?e.clientHeight:0)}function me(e,t){if(!t||t<=0)return 0;var value=e/t;return value<0&&(value=0),value>1&&(value=1),Math.round(1e3*value)/1e3}function he(){return window.innerWidth||(document.documentElement?document.documentElement.clientWidth:0)||1}function _e(e){if(!e)return"";for(var t=["data-ap-label","apeventaction","data-apeventaction","aria-label","name","id","title"],n=0;n<t.length;n++){var value=e.getAttribute?e.getAttribute(t[n]):null;if(!a(value))return String(value).slice(0,80)}var r=e.tagName?e.tagName.toLowerCase():"element";if(m()!==h.USAGE_TRACKING_WITH_PII){var i=e.getAttribute?e.getAttribute("role"):null;return a(i)?r:r+"["+i+"]"}var s=(e.textContent||"").replace(/\s+/g," ").trim();return a(s)?r:s.slice(0,80)}function we(e){if(!e)return 0;for(var t="",n=e,r=0;n&&r<12;){var a=n.parentElement,i=0;if(a)for(var s=a.children,o=0;o<s.length;o++)if(s[o]===n){i=o;break}t="/"+(n.tagName||"?")+":"+i+t,n=a,r++}for(var c=2166136261,u=0;u<t.length;u++)c=16777619*(c^=t.charCodeAt(u))>>>0;return c}function Ae(e,t,n){return(ae=ae.filter(function(e){return n-e.at<=1e3})).push({at:n,x:e,y:t}),ae.filter(function(n){return Math.abs(n.x-e)<=30&&Math.abs(n.y-t)<=30}).length>=3}function ve(){return{id:g(),session_start_time:u._current_session.starttime||r(),triggered_time:r(),screen:String(f()).slice(0,500),url_path:String(window.location.pathname).slice(0,500),screen_width:window.screen?window.screen.width:0,screen_height:window.screen?window.screen.height:0,content_height:ge(),orientation:d(),network_status:p(),edge_type:u._device_info.connectionType||l(),scroll_offset_x:Math.round(window.scrollX||window.pageXOffset||0),scroll_offset_y:Math.round(window.scrollY||window.pageYOffset||0)}}function be(e){re++,_(),w(),A.add(e),t.dir(e)}function ke(e){if(n("heatmap")&&fe())try{var t=r(),o=e.target,c=function(e){for(var t=0;e&&t<10;){var n=e.tagName?e.tagName.toLowerCase():"",r=e.getAttribute?e.getAttribute("role"):null;if("a"===n||"button"===n||"input"===n||"select"===n||"textarea"===n||"summary"===n||"label"===n||"button"===r||"link"===r||"tab"===r||"menuitem"===r||e.hasAttribute&&e.hasAttribute("onclick"))return e;e=e.parentElement,t++}return null}(o),u=c||o,l=Math.round(e.clientX),p=Math.round(e.clientY),d=ge()||1,f=e.pointerType,g=Object.assign(ve(),{triggered_type:"default",gesture_type:"click",gesture_duration:0,input_type:a(f)?"mouse":String(f),element_label:_e(u),triggered_id:we(u),coordinate_x:l,coordinate_y:p,normalized_x:me(l,he()),normalized_y:me((window.scrollY||0)+p,d),velocity:0,is_clickable:c?1:0,is_rage_click:Ae(l,p,t)?1:0,is_dead_click:0});be(g),function(e){if(1===e.is_clickable||"function"!=typeof MutationObserver)return;var t=!1,url=window.location.href,n=new MutationObserver(function(){t=!0});try{n.observe(document.documentElement,{childList:!0,subtree:!0,attributes:!0})}catch(e){return}setTimeout(function(){n.disconnect(),t||window.location.href!==url||(e.is_dead_click=1,A.update(e))},1500)}(g)}catch(e){i(s.HEATMAP,"apptics.heatmap: click capture failed: "+String(e))}}function ye(e){if(n("heatmap")&&fe()){var t=function(e){var t=document;if(!e||1!==e.nodeType||e===t.documentElement||e===t.body)return null;var n=e;return n.clientHeight>=.5*(window.innerHeight||0)&&n.clientWidth>=.5*he()?n:void 0}(e?e.target:null);if(void 0!==t){if(null!==ce&&t!==ue&&(clearTimeout(ce),Te()),null===ce){ue=t;var a=function(e){return null===e?{x:pe,y:de}:le.get(e)||{x:0,y:0}}(t);ie=r(),se=a.x,oe=a.y}else clearTimeout(ce);ce=setTimeout(Te,150)}}}function Te(){ce=null;var e=ue;ue=null;try{var t=function(e){return null===e?{x:Math.round(window.scrollX||window.pageXOffset||0),y:Math.round(window.scrollY||window.pageYOffset||0)}:{x:Math.round(e.scrollLeft||0),y:Math.round(e.scrollTop||0)}}(e),n=t.x,a=t.y,o=n-se,c=a-oe;if(null===e?(pe=n,de=a):le.set(e,t),0===o&&0===c)return;var u=Math.max(1,r()-ie),l=Math.sqrt(o*o+c*c),p=Math.abs(c)>=Math.abs(o)?c>0?"down-scroll":"up-scroll":o>0?"right-scroll":"left-scroll",d=(null===e?ge():e.scrollHeight)||1,f=null===e?window.innerHeight||0:e.clientHeight;be(Object.assign(ve(),null===e?{}:{content_height:e.scrollHeight,scroll_offset_x:n,scroll_offset_y:a},{triggered_type:"default",gesture_type:p,gesture_duration:Math.round(u),element_label:"",triggered_id:0,coordinate_x:n,coordinate_y:a,normalized_x:0,normalized_y:me(a+f,d),velocity:Math.round(l/u*1e3),is_clickable:0,is_rage_click:0,is_dead_click:0}))}catch(e){i(s.HEATMAP,"apptics.heatmap: scroll capture failed: "+String(e))}}function trackHeatmap(status){var e="boolean"!=typeof status||status;if(e!==ne){if(e)return pe=Math.round(window.scrollX||0),de=Math.round(window.scrollY||0),window.addEventListener("pointerdown",ke,{capture:!0,passive:!0}),window.addEventListener("scroll",ye,{capture:!0,passive:!0}),ne=!0,void t.log("apptics.heatmap: capturing clicks and scrolls");window.removeEventListener("pointerdown",ke,!0),window.removeEventListener("scroll",ye,!0),null!==ce&&(clearTimeout(ce),Te()),ue=null,ne=!1,t.log("apptics.heatmap: capture stopped")}}e.trackHeatmap=trackHeatmap,e.resetHeatmap=function(){re=0,ae=[],pe=0,de=0,le=new WeakMap},e.sendHeatmaps=function e(n){return!v()&&b()&&u._heatmapTracking?0==navigator.onLine?(t.warn("sendHeatmapData: No Network"),Promise.resolve()):u._sending?(k(e),Promise.resolve()):(u._sending=!0,y(),T("heatmaps",function(){return E(A,function(){return!0},function(e){return e.triggered_time||e.session_start_time}).then(function(e){if(0!=e.length){var t=[],r=[];return H(e).forEach(function(e){r.push({...e}),delete e.id,t.push(e)}),S(function(e,t){return U("heatmap","requestToSendHeatmaps",e,t)}({data:t},n).then(function(){return A.remove(r)},function(e){return M(e)?(x("apptics: the server refused these heatmap records, so they were dropped: "+String(e&&e.message)),A.remove(r)):Promise.reject(e)}),n,"sendHeatmapData")}})}).catch(function(e){t.log("sendHeatmapData:"+e)}).then(function(){u._sending=!1})):Promise.resolve()};const Ee=C("Apptics.init",G),He=C("Apptics.ready",W),Se=C("Apptics.flush",X),Me=C("Apptics.reset",j),xe=C("Apptics.enableDebug",I),Ue=C("Apptics.disableDebug",z),De={init:function init(config){return P(Ee,arguments)},ready:function ready(){return P(He,arguments)},flush:function flush(){return P(Se,arguments)},reset:function reset(){return P(Me,arguments)},enableDebug:function enableDebug(){return P(xe,arguments)},disableDebug:function disableDebug(){return P(Ue,arguments)}},Le=C("AppticsEvent.addEvent",q),Ne={DefinedEvents:N,addEvent:function addEvent(eventName,groupName,properties){return P(Le,arguments)}},Oe=C("AppticsScreen.inScreen",B),Pe=C("AppticsScreen.outScreen",K),Ye={inScreen:function inScreen(screenName,properties){if(!Y(screenName))return Oe(screenName,properties,"",r()),"";var id=g();return Oe(screenName,properties,id,r()),id},outScreen:function outScreen(id){Pe(id,r())}},Ce=C("AppticsApi.endTrackApi",R),Ge=C("AppticsApi.startTrackApi",J),We=C("AppticsApi.configure",Q),Xe=C("AppticsApi.enableApiTracking",V),je={startTrackApi:function startTrackApi(url,method){return P(Ge,arguments)},endTrackApi:function endTrackApi(id,responseCode,responseMessage){Ce(id,responseCode,responseMessage,r())},ApiTrackingBuilder:L,configure:function configure(config){return P(We,arguments)},enableApiTracking:function enableApiTracking(enabled){return P(Xe,arguments)}},Ie=C("AppticsError.trackError",Z),ze=C("AppticsError.trackGlobalErrorHandler",$),qe={trackError:function trackError(error,properties){return P(Ie,arguments)},trackGlobalErrorHandler:function trackGlobalErrorHandler(enabled){return P(ze,arguments)}},Be=C("AppticsUser.setUser",F),Ke=C("AppticsUser.getUser",ee),Re={setUser:function setUser(userid,groupid,properties){return P(Be,arguments)},getUser:function getUser(){return P(Ke,arguments)},UserBuilder:O},Je=C("AppticsHeatmap.trackHeatmap",trackHeatmap),Qe={trackHeatmap:function trackHeatmap(on){return P(Je,arguments)}},Ve=C("AppticsSettings.setTrackingStatus",te),Ze=C("AppticsSettings.getTrackingStatus",m),$e={AP_TRACKING_STATUS:h,setTrackingStatus:function setTrackingStatus(status){return P(Ve,arguments)},getTrackingStatus:function getTrackingStatus(){return P(Ze,arguments)}},Fe={Apptics:De,AppticsEvent:Ne,AppticsScreen:Ye,AppticsApi:je,AppticsError:qe,AppticsUser:Re,AppticsSettings:$e,AppticsHeatmap:Qe};var et;et=De,"undefined"!=typeof window&&queueMicrotask(function(){!function(e){if(u._initialised)return!1;var t=D();t&&"object"==typeof t&&e.init(t)}(et)});export{De as Apptics,je as AppticsApi,qe as AppticsError,Ne as AppticsEvent,Qe as AppticsHeatmap,Ye as AppticsScreen,$e as AppticsSettings,Re as AppticsUser,Fe as default};
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.2 | (c) Zoho Corporation Private Limited | see LICENSE */
+import{C as e,y as t,n,c as r,z as a,B as i,D as s,E as c,_ as o,d as u,j as l,e as p,G as d,H as f,A as g,I as m,J as h,m as A,b as _,K as k,L as w,M as v,w as b,v as T,x as y,N as E,O as H,P as S}from"./chunks/send-CgUO82ne.min.js";import{s as M,c as x,d as U,a as D,w as C,f as L,b as N,e as O,A as P,D as j,U as G,v as Y,g as z,o as I,i as W,h as X,j as q,r as B,k as K,l as R,m as J,n as F,p as Q,t as V,q as Z,u as $,x as ee,y as te,z as ne}from"./chunks/lifecycle-C6m1W7jo.min.js";var re=!1,ae=0,ie=[],se=0,ce=0,oe=0,ue=null,le=null,pe=new WeakMap,de=0,fe=0;function ge(){var t=s("heatmap_max_per_session");return("number"!=typeof t||t<=0)&&(t=c.heatmap_max_per_session),!(ae>=t)||(ae===t&&(ae++,e.log("apptics.heatmap: reached "+t+" records for this session, pausing capture")),!1)}function me(){var e=document.documentElement,t=document.body;return Math.max(e?e.scrollHeight:0,t?t.scrollHeight:0,e?e.clientHeight:0)}function he(e,t){if(!t||t<=0)return 0;var value=e/t;return value<0&&(value=0),value>1&&(value=1),Math.round(1e3*value)/1e3}function Ae(){return window.innerWidth||(document.documentElement?document.documentElement.clientWidth:0)||1}function _e(e){if(!e)return"";for(var t=["data-ap-label","apeventaction","data-apeventaction","aria-label","name","id","title"],n=0;n<t.length;n++){var value=e.getAttribute?e.getAttribute(t[n]):null;if(!r(value))return String(value).slice(0,80)}var a=e.tagName?e.tagName.toLowerCase():"element";if(f()!==g.USAGE_TRACKING_WITH_PII){var i=e.getAttribute?e.getAttribute("role"):null;return r(i)?a:a+"["+i+"]"}var s=(e.textContent||"").replace(/\s+/g," ").trim();return r(s)?a:s.slice(0,80)}function ke(e){if(!e)return 0;for(var t="",n=e,r=0;n&&r<12;){var a=n.parentElement,i=0;if(a)for(var s=a.children,c=0;c<s.length;c++)if(s[c]===n){i=c;break}t="/"+(n.tagName||"?")+":"+i+t,n=a,r++}for(var o=2166136261,u=0;u<t.length;u++)o=16777619*(o^=t.charCodeAt(u))>>>0;return o}function we(e,t,n){return(ie=ie.filter(function(e){return n-e.at<=1e3})).push({at:n,x:e,y:t}),ie.filter(function(n){return Math.abs(n.x-e)<=30&&Math.abs(n.y-t)<=30}).length>=3}function ve(){return{id:d(),session_start_time:o._current_session.starttime||n(),triggered_time:n(),screen:String(M()).slice(0,500),url_path:String(window.location.pathname).slice(0,500),screen_width:window.screen?window.screen.width:0,screen_height:window.screen?window.screen.height:0,content_height:me(),orientation:p(),network_status:l(),edge_type:o._device_info.connectionType||u(),scroll_offset_x:Math.round(window.scrollX||window.pageXOffset||0),scroll_offset_y:Math.round(window.scrollY||window.pageYOffset||0)}}function be(t){ae++,m(),x(),h.add(t),e.dir(t)}function Te(e){if(t("heatmap")&&ge())try{var s=n(),c=e.target,o=function(e){for(var t=0;e&&t<10;){var n=e.tagName?e.tagName.toLowerCase():"",r=e.getAttribute?e.getAttribute("role"):null;if("a"===n||"button"===n||"input"===n||"select"===n||"textarea"===n||"summary"===n||"label"===n||"button"===r||"link"===r||"tab"===r||"menuitem"===r||e.hasAttribute&&e.hasAttribute("onclick"))return e;e=e.parentElement,t++}return null}(c),u=o||c,l=Math.round(e.clientX),p=Math.round(e.clientY),d=me()||1,f=e.pointerType,g=Object.assign(ve(),{triggered_type:"default",gesture_type:"click",gesture_duration:0,input_type:r(f)?"mouse":String(f),element_label:_e(u),triggered_id:ke(u),coordinate_x:l,coordinate_y:p,normalized_x:he(l,Ae()),normalized_y:he((window.scrollY||0)+p,d),velocity:0,is_clickable:o?1:0,is_rage_click:we(l,p,s)?1:0,is_dead_click:0});be(g),function(e){if(1===e.is_clickable||"function"!=typeof MutationObserver)return;var t=!1,url=window.location.href,n=new MutationObserver(function(){t=!0});try{n.observe(document.documentElement,{childList:!0,subtree:!0,attributes:!0})}catch(e){return}setTimeout(function(){n.disconnect(),t||window.location.href!==url||(e.is_dead_click=1,h.update(e))},1500)}(g)}catch(e){a(i.HEATMAP,"apptics.heatmap: click capture failed: "+String(e))}}function ye(e){if(t("heatmap")&&ge()){var r=function(e){var t=document;if(!e||1!==e.nodeType||e===t.documentElement||e===t.body)return null;var n=e;return n.clientHeight>=.5*(window.innerHeight||0)&&n.clientWidth>=.5*Ae()?n:void 0}(e?e.target:null);if(void 0!==r){if(null!==ue&&r!==le&&(clearTimeout(ue),Ee()),null===ue){le=r;var a=function(e){return null===e?{x:de,y:fe}:pe.get(e)||{x:0,y:0}}(r);se=n(),ce=a.x,oe=a.y}else clearTimeout(ue);ue=setTimeout(Ee,150)}}}function Ee(){ue=null;var e=le;le=null;try{var t=function(e){return null===e?{x:Math.round(window.scrollX||window.pageXOffset||0),y:Math.round(window.scrollY||window.pageYOffset||0)}:{x:Math.round(e.scrollLeft||0),y:Math.round(e.scrollTop||0)}}(e),r=t.x,s=t.y,c=r-ce,o=s-oe;if(null===e?(de=r,fe=s):pe.set(e,t),0===c&&0===o)return;var u=Math.max(1,n()-se),l=Math.sqrt(c*c+o*o),p=Math.abs(o)>=Math.abs(c)?o>0?"down-scroll":"up-scroll":c>0?"right-scroll":"left-scroll",d=(null===e?me():e.scrollHeight)||1,f=null===e?window.innerHeight||0:e.clientHeight;be(Object.assign(ve(),null===e?{}:{content_height:e.scrollHeight,scroll_offset_x:r,scroll_offset_y:s},{triggered_type:"default",gesture_type:p,gesture_duration:Math.round(u),element_label:"",triggered_id:0,coordinate_x:r,coordinate_y:s,normalized_x:0,normalized_y:he(s+f,d),velocity:Math.round(l/u*1e3),is_clickable:0,is_rage_click:0,is_dead_click:0}))}catch(e){a(i.HEATMAP,"apptics.heatmap: scroll capture failed: "+String(e))}}function trackHeatmap(status){var t="boolean"!=typeof status||status;if(t!==re){if(t)return de=Math.round(window.scrollX||0),fe=Math.round(window.scrollY||0),window.addEventListener("pointerdown",Te,{capture:!0,passive:!0}),window.addEventListener("scroll",ye,{capture:!0,passive:!0}),re=!0,void e.log("apptics.heatmap: capturing clicks and scrolls");window.removeEventListener("pointerdown",Te,!0),window.removeEventListener("scroll",ye,!0),null!==ue&&(clearTimeout(ue),Ee()),le=null,re=!1,e.log("apptics.heatmap: capture stopped")}}A.trackHeatmap=trackHeatmap,A.resetHeatmap=function(){ae=0,ie=[],de=0,fe=0,pe=new WeakMap},A.sendHeatmaps=function t(n){return!_()&&k()&&o._heatmapTracking?0==navigator.onLine?(e.warn("sendHeatmapData: No Network"),Promise.resolve()):o._sending?(U(t),Promise.resolve()):(o._sending=!0,D(),C("heatmaps",function(){return L(h,function(){return!0},function(e){return e.triggered_time||e.session_start_time}).then(function(e){if(0!=e.length){var t=[],r=[];return w(e).forEach(function(e){r.push({...e}),delete e.id,t.push(e)}),N(function(e,t){return O("heatmap","requestToSendHeatmaps",e,t)}({data:t},n).then(function(){return h.remove(r)},function(e){return v(e)?(b("apptics: the server refused these heatmap records, so they were dropped: "+String(e&&e.message)),h.remove(r)):Promise.reject(e)}),n,"sendHeatmapData")}})}).catch(function(t){e.log("sendHeatmapData:"+t)}).then(function(){o._sending=!1})):Promise.resolve()};const He=y("Apptics.init",K),Se=y("Apptics.ready",B),Me=y("Apptics.flush",q),xe=y("Apptics.reset",X),Ue=y("Apptics.enableDebug",H),De=y("Apptics.disableDebug",E);var Ce={};function Le(e,t){Ce[e]||(Ce[e]=!0,b(e+" is now "+t+"; rename it in your code"))}const Ne={init:function init(config){return T(He,arguments)},ready:function ready(){return T(Se,arguments)},flush:function flush(){return T(Me,arguments)},reset:function reset(){return T(xe,arguments)},enableDebug:function enableDebug(){return T(Ue,arguments)},disableDebug:function disableDebug(){return T(De,arguments)}},Oe=y("AppticsEvent.addEvent",$),Pe=y("AppticsEvent.setClickTracking",Z),je={DefinedEvents:j,addEvent:function addEvent(eventName,groupName,properties){return T(Oe,arguments)},setClickTracking:function setClickTracking(enabled){return T(Pe,arguments)}},Ge=y("AppticsScreen.inScreen",W),Ye=y("AppticsScreen.outScreen",I),ze=y("AppticsScreen.setScreenTracking",ee),Ie={inScreen:function inScreen(screenName,properties){if(!Y(screenName))return Ge(screenName,properties,"",n()),"";var id=d();return Ge(screenName,properties,id,n()),id},outScreen:function outScreen(id){Ye(id,n())},setScreenTracking:function setScreenTracking(enabled){return T(ze,arguments)}},We=y("AppticsApi.endTrackApi",z),Xe=y("AppticsApi.startTrackApi",F),qe=y("AppticsApi.configure",J),Be=y("AppticsApi.setApiTracking",R),Ke={startTrackApi:function startTrackApi(url,method){return T(Xe,arguments)},endTrackApi:function endTrackApi(id,responseCode,responseMessage){We(id,responseCode,responseMessage,n())},ApiTrackingBuilder:P,configure:function configure(config){return T(qe,arguments)},setApiTracking:function setApiTracking(enabled){return T(Be,arguments)},enableApiTracking:function enableApiTracking(enabled){return Le("AppticsApi.enableApiTracking","AppticsApi.setApiTracking"),T(Be,arguments)}},Re=y("AppticsError.trackError",V),Je=y("AppticsError.setErrorTracking",Q),Fe={trackError:function trackError(error,properties){return T(Re,arguments)},setErrorTracking:function setErrorTracking(enabled){return T(Je,arguments)},trackGlobalErrorHandler:function trackGlobalErrorHandler(enabled){return Le("AppticsError.trackGlobalErrorHandler","AppticsError.setErrorTracking"),T(Je,arguments)}},Qe=y("AppticsUser.setUser",ne),Ve=y("AppticsUser.getUser",te),Ze={setUser:function setUser(userid,groupid,properties){return T(Qe,arguments)},getUser:function getUser(){return T(Ve,arguments)},UserBuilder:G},$e=y("AppticsHeatmap.setHeatmapTracking",trackHeatmap),et={setHeatmapTracking:function setHeatmapTracking(enabled){return T($e,arguments)},trackHeatmap:function trackHeatmap(on){return Le("AppticsHeatmap.trackHeatmap","AppticsHeatmap.setHeatmapTracking"),T($e,arguments)}},tt=y("AppticsSettings.setTrackingStatus",S),nt=y("AppticsSettings.getTrackingStatus",f),rt={AP_TRACKING_STATUS:g,setTrackingStatus:function setTrackingStatus(status){return T(tt,arguments)},getTrackingStatus:function getTrackingStatus(){return T(nt,arguments)}},at={Apptics:Ne,AppticsEvent:je,AppticsScreen:Ie,AppticsApi:Ke,AppticsError:Fe,AppticsUser:Ze,AppticsSettings:rt,AppticsHeatmap:et};export{Ne as Apptics,Ke as AppticsApi,Fe as AppticsError,je as AppticsEvent,et as AppticsHeatmap,Ie as AppticsScreen,rt as AppticsSettings,Ze as AppticsUser,at as default};
 //# sourceMappingURL=apptics.esm.min.js.map