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

package/dist/cjs/core/framework-id.js

@@ -1,9 +1,9 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 // Generated by scripts/register-version.mjs — do not edit by hand.
 // The framework id Apptics issued for this SDK, from POST /sdk/web/v1/framework/addversion
-// (version 2.0.0-beta, platform Browser). Regenerated on every npm pack.
-const FRAMEWORK_ID = 5996;
+// (version 2.0.0-beta.1, platform Browser). Regenerated on every npm pack.
+const FRAMEWORK_ID = 6002;
 
 exports.FRAMEWORK_ID = FRAMEWORK_ID;

package/dist/cjs/core/guard.d.ts

@@ -1,2 +1,11 @@
 /** Public calls never throw into the host app, and are buffered until start-up finishes. */
 export declare function guard<F extends (...args: any[]) => any>(name: string, fn: F): F;
+/**
+ * Hands a public call's own `arguments` to its guarded function, exactly as they were given.
+ *
+ * guard() returns a wrapper that takes `...args`, so a browser console shows every public call as
+ * `(...args)`. Each public call is therefore its own function with named parameters, which is what
+ * the console shows, and forwards through this: `arguments` rather than the named parameters, so
+ * a call keeps its argument count (addEvent tells its two forms apart by it).
+ */
+export declare function forward<F extends (...args: any[]) => any>(guarded: F, args: IArguments): ReturnType<F>;

package/dist/cjs/core/guard.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 var state = require('./state.js');
@@ -10,29 +10,31 @@ var logger = require('./logger.js');
  * The two log collectors run now so an entry keeps the time it actually happened.
  */
 const RUN_BEFORE_READY = {
-    'Apptics.init': true, ready: true, reset: true, getUser: true, getTrackingStatus: true, sendFeedback: true,
-    addFeedbackLog: true, addDiagnosticsInfo: true,
-    // a switch, so it takes effect in order with the lines logged after it
-    'AppticsLogger.enable': true, 'AppticsLogger.disable': true, 'AppticsLogger.isEnabled': true,
+    'Apptics.init': true, 'Apptics.ready': true, 'Apptics.reset': true, 'AppticsUser.getUser': true,
+    'AppticsSettings.getTrackingStatus': true, 'AppticsFeedback.sendFeedback': true,
+    'AppticsFeedback.addFeedbackLog': true, 'AppticsFeedback.addDiagnosticsInfo': true,
+    // a switch, which init() must not undo: it keeps what was set when its config has no theme
+    'AppticsFeedback.setFeedbackTheme': true,
     // a switch, and a call that hands back the id endTrackApi needs: neither can wait in a queue
-    'AppticsApiTracker.configure': true, 'AppticsApiTracker.startTrackApi': true,
+    'AppticsApi.configure': true, 'AppticsApi.startTrackApi': true,
     // these wait for ready() themselves, and a queued call would hand back undefined, not a Promise
     'AppticsRemoteConfig.fetchValue': true, 'AppticsRemoteConfig.fetchValues': true,
-    'AppticsRemoteConfig.setFallbackWithOfflineValue': true, 'AppticsRemoteConfig.setCustomConditionValue': true,
-    enableDebug: true, disableDebug: true,
+    'AppticsRemoteConfig.setCustomConditionValue': true,
+    'Apptics.enableDebug': true, 'Apptics.disableDebug': true,
 };
 /**
  * Calls that record or send something, and so are lost when the SDK hasn't started. Calls that only
- * set a switch or read a value (enableDebug, AppticsLogger.enable, addFeedbackLog, getUser, …)
+ * set a switch or read a value (Apptics.enableDebug, AppticsLogger.enable, AppticsFeedback.addFeedbackLog,
+ * AppticsUser.getUser, …)
  * work without Apptics.init() and are not listed.
  */
 const NEEDS_INIT = {
-    'AppticsEvents.addEvent': true, 'AppticsScreenTracker.inScreen': true, 'AppticsScreenTracker.outScreen': true,
-    'AppticsApiTracker.endTrackApi': true, AppticsTrackError: true, AppticsSetUser: true, flush: true,
-    AppticsLogger: true, sendFeedback: true, 'AppticsRemoteConfig.fetchValue': true,
+    'AppticsEvent.addEvent': true, 'AppticsScreen.inScreen': true, 'AppticsScreen.outScreen': true,
+    'AppticsApi.endTrackApi': true, 'AppticsError.trackError': true, 'AppticsUser.setUser': true,
+    'Apptics.flush': true, AppticsLogger: true, 'AppticsFeedback.sendFeedback': true, 'AppticsRemoteConfig.fetchValue': true,
     'AppticsRemoteConfig.fetchValues': true,
 };
-/** How a call is named in a message: `AppticsEvents.addEvent` as it is, `flush` as `apptics.flush`. */
+/** How a call is named in a message: every public call is named after its object, as `AppticsEvent.addEvent`. */
 function publicName(name) {
     return name.indexOf('Apptics') === 0 ? name : 'apptics.' + name; // no i18n
 }
@@ -68,5 +70,17 @@ function guard(name, fn) {
     };
     return guarded;
 }
+/**
+ * Hands a public call's own `arguments` to its guarded function, exactly as they were given.
+ *
+ * guard() returns a wrapper that takes `...args`, so a browser console shows every public call as
+ * `(...args)`. Each public call is therefore its own function with named parameters, which is what
+ * the console shows, and forwards through this: `arguments` rather than the named parameters, so
+ * a call keeps its argument count (addEvent tells its two forms apart by it).
+ */
+function forward(guarded, args) {
+    return guarded.apply(null, Array.prototype.slice.call(args));
+}
 
+exports.forward = forward;
 exports.guard = guard;

package/dist/cjs/core/hooks.d.ts

@@ -1,4 +1,3 @@
-import type { CallSite } from './callsite.js';
 import type { DeviceInfo, ServerResult } from '../types.js';
 /**
  * Late-bound calls from lower modules up to the modules above them (see spec §5). device.ts and
@@ -9,7 +8,6 @@ export declare const hooks: {
     updateDevice: (deviceInfo: DeviceInfo) => Promise<ServerResult>;
     refreshDeviceInfo: () => void;
     /** Set by remotelog/index.ts. Here, not imported, so the logger doesn't depend on the sender. */
-    remoteLog: (module: string, message: unknown, site?: CallSite) => void;
     /**
      * Set by feedback/controls.ts: the user picked in the feedback form, or null for anonymous.
      * Here so transport can read the choice without importing the modal.
@@ -24,7 +22,7 @@ export declare const hooks: {
      */
     sendHeatmaps: (forget?: boolean) => Promise<void>;
     /** Set by heatmap/track.ts, so init() and reset() can switch capture without importing it. */
-    enableHeatmap: (status?: boolean) => void;
+    trackHeatmap: (status?: boolean) => void;
     /** Set by heatmap/track.ts: clears what this visit recorded, so the cap starts again. */
     resetHeatmap: () => void;
     /** Set by remoteconfig/fetch.ts, so reset() can forget the rule set without importing it. */
@@ -36,6 +34,6 @@ export declare const hooks: {
     screenTrackedByApp: () => void;
     /** Set by remoteconfig/fetch.ts: start-up has finished, so remote config fetches its values. */
     remoteConfigStarted: () => void;
-    /** Set by remoteconfig/fetch.ts: AppticsSetUser changed who this is, so conditions on the user re-apply. */
+    /** Set by remoteconfig/fetch.ts: AppticsUser.setUser changed who this is, so conditions on the user re-apply. */
     remoteConfigUserChanged: () => void;
 };

package/dist/cjs/core/hooks.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 /**
@@ -9,10 +9,9 @@
 const hooks = {
     updateDevice: () => Promise.reject('apptics: device module not loaded'), // no i18n
     refreshDeviceInfo: () => { },
-    remoteLog: () => { },
     feedbackUser: () => null,
     sendHeatmaps: () => Promise.resolve(),
-    enableHeatmap: () => { },
+    trackHeatmap: () => { },
     resetHeatmap: () => { },
     resetRemoteConfig: () => { },
     screenTrackedByApp: () => { },

package/dist/cjs/core/locks.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Runs `run` while holding the Web Lock `name`, waiting for it if another tab of this site holds
+ * it. Locks are shared by every tab of an origin, which is what keeps two tabs from registering
+ * the same browser twice or overwriting each other's session.
+ *
+ * Without the Web Locks API (older browsers), `run` simply runs, as it did before locks were used.
+ * Not reentrant: `run` must not ask for the same lock again, or it waits for itself.
+ */
+export declare function withLock<T>(name: string, run: () => Promise<T>): Promise<T>;

package/dist/cjs/core/locks.js

@@ -0,0 +1,22 @@
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+'use strict';
+
+/**
+ * Runs `run` while holding the Web Lock `name`, waiting for it if another tab of this site holds
+ * it. Locks are shared by every tab of an origin, which is what keeps two tabs from registering
+ * the same browser twice or overwriting each other's session.
+ *
+ * Without the Web Locks API (older browsers), `run` simply runs, as it did before locks were used.
+ * Not reentrant: `run` must not ask for the same lock again, or it waits for itself.
+ */
+function withLock(name, run) {
+    var locks = typeof navigator !== 'undefined' ? navigator.locks : undefined; // no i18n
+    if (!locks || typeof locks.request !== 'function') { // no i18n
+        return run();
+    }
+    return locks.request('apptics-' + name, function () {
+        return run();
+    });
+}
+
+exports.withLock = withLock;

package/dist/cjs/core/logger.d.ts

@@ -8,9 +8,8 @@ export declare const Console: {
 /** Warnings the integrator must see even with debug off (e.g. missing required config). */
 export declare function warnAlways(...args: unknown[]): void;
 /**
- * A failure inside one of the SDK's own modules: logged to the console as usual, and sent to
- * console/addlog so it can be read back from the Apptics console when the SDK misbehaves in the
- * wild. `module` is one of AP_LOG_MODULE's values. The remote half does nothing until
- * the remotelog module has been loaded and its own switch allows it.
+ * A failure inside one of the SDK's own modules, `module` one of AP_LOG_MODULE's values: said in
+ * the browser console in debug mode. Nothing is sent: the Remote Logger page carries only the
+ * lines an app logs with AppticsLogger.
  */
 export declare function logFailure(module: string, ...args: unknown[]): void;

package/dist/cjs/core/logger.js

@@ -1,10 +1,8 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 var state = require('./state.js');
-var hooks = require('./hooks.js');
 var utils = require('./utils.js');
-var callsite = require('./callsite.js');
 
 const APConsole = typeof console !== 'undefined' ? console : null;
 function gated(method) {
@@ -38,47 +36,13 @@ function warnAlways(...args) {
     if (APConsole)
         APConsole.warn(...args);
 }
-function safeJson(value) {
-    try {
-        return JSON.stringify(value) || String(value);
-    }
-    catch (err) {
-        return String(value);
-    }
-}
 /**
- * A failure inside one of the SDK's own modules: logged to the console as usual, and sent to
- * console/addlog so it can be read back from the Apptics console when the SDK misbehaves in the
- * wild. `module` is one of AP_LOG_MODULE's values. The remote half does nothing until
- * the remotelog module has been loaded and its own switch allows it.
+ * A failure inside one of the SDK's own modules, `module` one of AP_LOG_MODULE's values: said in
+ * the browser console in debug mode. Nothing is sent: the Remote Logger page carries only the
+ * lines an app logs with AppticsLogger.
  */
 function logFailure(module, ...args) {
     Console.error.apply(null, args);
-    hooks.hooks.remoteLog(module, args.map(function (arg) {
-        if (arg instanceof Error) {
-            return arg.stack || (arg.name + ': ' + arg.message); // no i18n
-        }
-        return typeof arg === 'string' ? arg : safeJson(arg); // no i18n
-    }).join(' '), siteOf(args)); // no i18n
-}
-/**
- * Where to say the failure happened. An Error knows where it was thrown, which is the place
- * worth reporting; the alternative is where it was caught, which is usually a catch block three
- * modules away. Only a frame we could actually read counts, so an Error with no usable stack
- * falls through to logFailure's own caller.
- */
-function siteOf(args) {
-    for (var i = 0; i < args.length; i++) {
-        var arg = args[i];
-        if (arg instanceof Error) {
-            var thrownAt = callsite.callSiteFromStack(arg.stack, 0);
-            if (thrownAt.linenumber > 0) {
-                return thrownAt;
-            }
-        }
-    }
-    // past siteOf and logFailure, to whoever reported the failure
-    return callsite.callSite(2);
 }
 
 exports.Console = Console;

package/dist/cjs/core/state.d.ts

@@ -1,5 +1,5 @@
 import { type ApConfig } from './constants.js';
-import type { DeviceInfo, Dict, TrackingStatus, UserInfo } from '../types.js';
+import type { DeviceInfo, Dict, QuartzSettings, TrackingStatus, UserInfo } from '../types.js';
 /** Runtime state shared by every module (the former `_ZAP` object). */
 export interface State {
     _initialised: boolean;
@@ -44,7 +44,8 @@ export interface State {
     _remoteConfigReported: boolean;
     /** getsdkconfig module 12. */
     _feedbackEnabled: boolean;
-    _quartzEnabled: boolean;
+    /** getsdkconfig's `quartz` block: screen recording in the feedback form. Off until it says otherwise. */
+    _quartz: QuartzSettings;
     /** Epoch ms getsdkconfig asked us to wait until before asking again. 0 means no answer yet. */
     _nextConfigCheck: number;
     /**

package/dist/cjs/core/state.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 var constants = require('./constants.js');
@@ -45,7 +45,7 @@ function initialState() {
         _nextConfigCheck: 0,
         _debugUntil: 0,
         _errorTracking: true,
-        _quartzEnabled: true,
+        _quartz: { enabled: false, workspace: '', department: '', domain: '', cdnUrl: '' }, // no i18n
         _trackinfo: {},
     };
 }

package/dist/cjs/core/storage.d.ts

@@ -20,23 +20,38 @@ export declare const error_transactions: Queue;
  * These are not sent on their own: feedback/logs.ts renders them into the files that
  * feedback/add carries, and removes the ones a submission took with it.
  */
-export declare const log_transactions: Queue;
+export declare const feedbacklog_transactions: Queue;
 /** Clicks and scrolls waiting for heatmap/add. */
 export declare const heatmap_transactions: Queue;
 /**
- * Remote log lines waiting for console/addlog. Stored rather than sent straight out because the
+ * Remote log lines waiting for log/add. Stored rather than sent straight out because the
  * endpoint takes one line per call and counts retries (`attempt`), so a line has to outlive a
  * failed send — and a reload.
  */
-export declare const consolelog_transactions: Queue;
-/** Token, uuid, appversion, device_info, users, trackinfo. */
+export declare const remotelog_transactions: Queue;
+/**
+ * Sets one key of the stored device_info, and of this tab's copy: the uuid the device is
+ * registered under, whether it has had a session. Its other keys stay as they are.
+ */
+export declare function setDeviceInfoKey(key: string, value: unknown): void;
+/** device_info (uuid included), app_version_info, trackinfo (tracking_status included), users, user_info, and the rest. */
 export declare const user_defaults: {
     all(): Dict;
     item(key: string): any;
     add(key: string, value: unknown): void;
+    /** As add(), and resolves once the value is in storage, where other tabs can read it. */
+    save(key: string, value: unknown): Promise<void>;
     clear(): void;
 };
-/** Opt-in status, stored as the tracking_status setting. */
+/**
+ * Re-reads `keys` from storage. Settings are loaded into memory once, when a tab starts, so a value
+ * another tab of this site wrote since then — the device ids it registered — is only in storage.
+ * A key storage doesn't hold keeps this tab's value.
+ */
+export declare function reloadSettings(keys: string[]): Promise<void>;
+/** The visitor's tracking status, stored in trackinfo as tracking_status. */
+export declare function storedTrackingStatus(): TrackingStatus | undefined;
+/** Opt-in status, stored in the trackinfo setting as tracking_status. */
 export declare const tracking_preference: {
     _tracking_status: string;
     all(): Dict;

package/dist/cjs/core/storage.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 var constants = require('./constants.js');
@@ -30,8 +30,6 @@ function migrateLegacy(b) {
             errors: localStorage.getItem(db.LEGACY_KEYS.errors),
             logs: localStorage.getItem(db.LEGACY_KEYS.logs),
             consolelogs: localStorage.getItem(db.LEGACY_KEYS.consolelogs),
-            // read for completeness of the shape only: 1.x never wrote this key
-            heatmaps: null,
         };
     }
     catch (err) {
@@ -49,15 +47,17 @@ function migrateLegacy(b) {
             return null;
         }
     };
+    // 1.x's keys are logs and consolelogs; they are feedbacklogs and remotelogs now, and a
+    // feedback entry's type is feedbacklog or feedbackdiagnostics instead of log or diagnostics
     var queues = {
         engagements: db.asList(parse(raw.engagements)),
         errors: db.asList(parse(raw.errors)),
-        logs: db.asList(parse(raw.logs)),
-        consolelogs: db.asList(parse(raw.consolelogs)),
+        feedbacklogs: db.asList(parse(raw.logs)).map(db.renameFeedbackType),
+        remotelogs: db.asList(parse(raw.consolelogs)),
         // nothing to migrate: 1.x had no heatmaps
         heatmaps: [],
     };
-    queues.engagements.concat(queues.errors, queues.logs, queues.consolelogs).forEach(function (item) {
+    queues.engagements.concat(queues.errors, queues.feedbacklogs, queues.remotelogs).forEach(function (item) {
         if (!item.id)
             item.id = utils.getNewUUID();
     });
@@ -91,6 +91,7 @@ function storageReady() {
             }).then(function (loaded) {
                 // writes made before loading finished win over stored values
                 settings = Object.assign({}, loaded, settings);
+                moveRetiredSettings();
                 return b;
             });
         }).catch(function (err) {
@@ -161,21 +162,75 @@ const error_transactions = createQueue('errors'); // no i18n
  * These are not sent on their own: feedback/logs.ts renders them into the files that
  * feedback/add carries, and removes the ones a submission took with it.
  */
-const log_transactions = createQueue('logs'); // no i18n
+const feedbacklog_transactions = createQueue('feedbacklogs'); // no i18n
 /** Clicks and scrolls waiting for heatmap/add. */
 const heatmap_transactions = createQueue('heatmaps'); // no i18n
 /**
- * Remote log lines waiting for console/addlog. Stored rather than sent straight out because the
+ * Remote log lines waiting for log/add. Stored rather than sent straight out because the
  * endpoint takes one line per call and counts retries (`attempt`), so a line has to outlive a
  * failed send — and a reload.
  */
-const consolelog_transactions = createQueue('consolelogs'); // no i18n
+const remotelog_transactions = createQueue('remotelogs'); // no i18n
 /* ---------------- settings (sync reads, background writes) ---------------- */
+/** Writes `key`, or removes it from storage altogether when `value` is undefined. */
+function writeSetting(b, key) {
+    return settings[key] === undefined ? b.deleteSetting(key) : b.putSetting(key, settings[key]);
+}
 function setSetting(key, value) {
-    settings[key] = value === undefined ? undefined : utils.cloneObject(value);
-    withBackend('save ' + key, undefined, function (b) { return b.putSetting(key, settings[key]); }); // no i18n
+    if (value === undefined) {
+        delete settings[key];
+    }
+    else {
+        settings[key] = utils.cloneObject(value);
+    }
+    withBackend('save ' + key, undefined, function (b) { return writeSetting(b, key); }); // no i18n
+}
+/**
+ * Settings 2.0.0-beta kept as keys of their own, now kept inside device_info and trackinfo.
+ * Moved once, on the first load after an upgrade, before anything reads them: the uuid is the one
+ * the device is registered under, and the tracking status is the visitor's own choice, so losing
+ * either would register a new device or forget a consent. token was never read, and goes.
+ * appkey and appversion are read and removed by init(), which compares them with this visit's app.
+ */
+function moveRetiredSettings() {
+    var device = settings.device_info && typeof settings.device_info === 'object' ? settings.device_info : null; // no i18n
+    if (settings.uuid !== undefined || settings.hadsession !== undefined) {
+        device = Object.assign({}, device || {});
+        if (utils.isEmpty(device.uuid) && !utils.isEmpty(settings.uuid)) {
+            device.uuid = settings.uuid;
+        }
+        if (settings.hadsession === true) {
+            device.hadsession = true;
+        }
+        setSetting('device_info', device); // no i18n
+        setSetting('uuid', undefined); // no i18n
+        setSetting('hadsession', undefined); // no i18n
+    }
+    if (settings.tracking_status !== undefined) {
+        var track = Object.assign({}, settings.trackinfo && typeof settings.trackinfo === 'object' ? settings.trackinfo : {}); // no i18n
+        if (track.tracking_status === undefined) {
+            track.tracking_status = settings.tracking_status;
+        }
+        setSetting('trackinfo', track); // no i18n
+        setSetting('tracking_status', undefined); // no i18n
+    }
+    if (settings.token !== undefined) {
+        setSetting('token', undefined); // no i18n
+    }
 }
-/** Token, uuid, appversion, device_info, users, trackinfo. */
+/**
+ * Sets one key of the stored device_info, and of this tab's copy: the uuid the device is
+ * registered under, whether it has had a session. Its other keys stay as they are.
+ */
+function setDeviceInfoKey(key, value) {
+    var device = Object.assign({}, settings.device_info && typeof settings.device_info === 'object' ? settings.device_info : {}); // no i18n
+    device[key] = value;
+    if (state._ZAP._device_info && typeof state._ZAP._device_info === 'object') { // no i18n
+        state._ZAP._device_info[key] = value;
+    }
+    setSetting('device_info', device); // no i18n
+}
+/** device_info (uuid included), app_version_info, trackinfo (tracking_status included), users, user_info, and the rest. */
 const user_defaults = {
     all() {
         return utils.cloneObject(settings);
@@ -187,26 +242,66 @@ const user_defaults = {
     add(key, value) {
         setSetting(key, value);
     },
+    /** As add(), and resolves once the value is in storage, where other tabs can read it. */
+    save(key, value) {
+        if (value === undefined) {
+            delete settings[key];
+        }
+        else {
+            settings[key] = utils.cloneObject(value);
+        }
+        return withBackend('save ' + key, undefined, function (b) { return writeSetting(b, key); }); // no i18n
+    },
     clear() {
         settings = {};
         withBackend('clear settings', undefined, function (b) { return b.clearSettings(); }); // no i18n
     },
 };
-/** Opt-in status, stored as the tracking_status setting. */
+/**
+ * Re-reads `keys` from storage. Settings are loaded into memory once, when a tab starts, so a value
+ * another tab of this site wrote since then — the device ids it registered — is only in storage.
+ * A key storage doesn't hold keeps this tab's value.
+ */
+function reloadSettings(keys) {
+    return withBackend('reload settings', undefined, function (b) {
+        return b.loadSettings().then(function (loaded) {
+            keys.forEach(function (key) {
+                if (loaded[key] !== undefined) {
+                    settings[key] = loaded[key];
+                }
+            });
+        });
+    });
+}
+/** The visitor's tracking status, stored in trackinfo as tracking_status. */
+function storedTrackingStatus() {
+    var track = settings.trackinfo;
+    var status = track && typeof track === 'object' ? track.tracking_status : undefined; // no i18n
+    // a status only: getsdkconfig's own answer uses the same key for its per-module flags, and
+    // one stored by mistake must not read as a consent and stop all tracking
+    return status === constants.AP_TRACKING_STATUS.USAGE_TRACKING_WITH_PII || status === constants.AP_TRACKING_STATUS.USAGE_TRACKING_WITHOUT_PII
+        || status === constants.AP_TRACKING_STATUS.NO_TRACKING ? status : undefined;
+}
+/** Opt-in status, stored in the trackinfo setting as tracking_status. */
 const tracking_preference = {
     _tracking_status: 'tracking_status', // no i18n
     all() {
         return user_defaults.all();
     },
     opt_in_status() {
-        return (settings[tracking_preference._tracking_status] || constants.AP_TRACKING_STATUS.USAGE_TRACKING_WITHOUT_PII);
+        return (storedTrackingStatus() || constants.AP_TRACKING_STATUS.USAGE_TRACKING_WITHOUT_PII);
     },
     update_status(tracking_status) {
         state._ZAP._devicestatus = tracking_status;
         // Legacy order kept: this reads the status *before* the write below (setTrackingStatus recomputes it after).
         state._ZAP._isanonrequired =
             tracking_preference.opt_in_status() == constants.AP_TRACKING_STATUS.USAGE_TRACKING_WITH_PII ? false : state._ZAP._isanonrequired;
-        setSetting(tracking_preference._tracking_status, tracking_status);
+        var track = Object.assign({}, settings.trackinfo && typeof settings.trackinfo === 'object' ? settings.trackinfo : {}); // no i18n
+        track.tracking_status = tracking_status;
+        if (state._ZAP._trackinfo && typeof state._ZAP._trackinfo === 'object') { // no i18n
+            state._ZAP._trackinfo.tracking_status = tracking_status;
+        }
+        setSetting('trackinfo', track); // no i18n
     },
 };
 function getKeyFromDeviceInfo(key) {
@@ -218,12 +313,15 @@ function getKeyFromDeviceInfo(key) {
     return null;
 }
 
-exports.consolelog_transactions = consolelog_transactions;
 exports.engagement_transactions = engagement_transactions;
 exports.error_transactions = error_transactions;
+exports.feedbacklog_transactions = feedbacklog_transactions;
 exports.getKeyFromDeviceInfo = getKeyFromDeviceInfo;
 exports.heatmap_transactions = heatmap_transactions;
-exports.log_transactions = log_transactions;
+exports.reloadSettings = reloadSettings;
+exports.remotelog_transactions = remotelog_transactions;
+exports.setDeviceInfoKey = setDeviceInfoKey;
 exports.storageReady = storageReady;
+exports.storedTrackingStatus = storedTrackingStatus;
 exports.tracking_preference = tracking_preference;
 exports.user_defaults = user_defaults;

package/dist/cjs/core/stylesheet.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Adds the feedback form's styles to the page, once, as a <style> element, so no app imports or
+ * links a stylesheet: the css is carried in the JavaScript, for npm and the CDN builds alike.
+ *
+ * Nothing happens when `css` is empty (running from source, as the tests do) or when the page
+ * already has the styles (the element is marked data-apptics="style"). Never throws.
+ */
+export declare function injectStylesheet(css: string): void;

package/dist/cjs/core/stylesheet.js

@@ -0,0 +1,29 @@
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+'use strict';
+
+/**
+ * Adds the feedback form's styles to the page, once, as a <style> element, so no app imports or
+ * links a stylesheet: the css is carried in the JavaScript, for npm and the CDN builds alike.
+ *
+ * Nothing happens when `css` is empty (running from source, as the tests do) or when the page
+ * already has the styles (the element is marked data-apptics="style"). Never throws.
+ */
+function injectStylesheet(css) {
+    try {
+        if (!css || typeof document === 'undefined') { // no i18n
+            return;
+        }
+        if (document.querySelector('[data-apptics="style"]')) { // no i18n
+            return;
+        }
+        var style = document.createElement('style'); // no i18n
+        style.setAttribute('data-apptics', 'style'); // no i18n
+        style.textContent = css;
+        (document.head || document.documentElement).appendChild(style);
+    }
+    catch (err) {
+        // the form still works unstyled; the app must not break over a stylesheet
+    }
+}
+
+exports.injectStylesheet = injectStylesheet;

package/dist/cjs/core/transport.d.ts

@@ -81,3 +81,5 @@ export declare function getMetaObj(): Dict;
  * and feedback (P11).
  */
 export declare function rejectIfNoDeviceIds(label: string): Promise<never> | null;
+/** Whether device/add has given this browser its deviceid. */
+export declare function hasDeviceId(): boolean;

package/dist/cjs/core/transport.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 var constants = require('./constants.js');
@@ -174,8 +174,11 @@ function getParameters(path) {
         }
         return returnVal + mandatoryParams(returnVal);
     }
-    // add userid and groupid if opt_in_status is USAGE_TRACKING_WITH_PII
-    if (path != 'reguser' && identifiesDevice) { // no i18n
+    // add userid and groupid if opt_in_status is USAGE_TRACKING_WITH_PII. getupdates doesn't declare
+    // them, and refuses userid as EXTRA_PARAM_FOUND; it has no use for them either, since remote
+    // config conditions on the user are evaluated here, against the rule set it answers with
+    var carriesUser = path != 'reguser' && path != 'getupdates'; // no i18n
+    if (carriesUser && identifiesDevice) {
         if (consent.opt_in_status() == constants.AP_TRACKING_STATUS.USAGE_TRACKING_WITH_PII) {
             if (state._ZAP._user_info.hasOwnProperty('userid') && !utils.isEmpty(state._ZAP._user_info.userid)) { // no i18n
                 returnVal += '&userid=' + encodeURIComponent(String(state._ZAP._user_info.userid)); // no i18n
@@ -419,10 +422,21 @@ function getMetaObj() {
 function rejectIfNoDeviceIds(label) {
     if (utils.isEmpty(getHeaderParams('apid')) && utils.isEmpty(getHeaderParams('mapid'))) { // no i18n
         hooks.hooks.refreshDeviceInfo();
-        return Promise.reject(label + ': You must call apptics.init() first'); // no i18n
+        return Promise.reject(label + ': You must call Apptics.init() first'); // no i18n
+    }
+    // app/addversion has answered, device/add not yet (offline, or it failed): what is stored waits
+    // for the device it belongs to rather than going out without a deviceid. The refresh registers
+    // the device, joining a registration already in flight
+    if (!hasDeviceId()) {
+        hooks.hooks.refreshDeviceInfo();
+        return Promise.reject(label + ': the device is not registered yet, kept for the next send'); // no i18n
     }
     return null;
 }
+/** Whether device/add has given this browser its deviceid. */
+function hasDeviceId() {
+    return !utils.isEmpty(state._ZAP._device_info && state._ZAP._device_info.deviceid) || !utils.isEmpty(storage.getKeyFromDeviceInfo('deviceid')); // no i18n
+}
 
 exports.KEEPALIVE_BUDGET = KEEPALIVE_BUDGET;
 exports.REQUEST_TIMEOUT_MS = REQUEST_TIMEOUT_MS;
@@ -431,6 +445,7 @@ exports.getHeaderParams = getHeaderParams;
 exports.getMetaObj = getMetaObj;
 exports.getParameters = getParameters;
 exports.getUrlWithParams = getUrlWithParams;
+exports.hasDeviceId = hasDeviceId;
 exports.isPermanentRefusal = isPermanentRefusal;
 exports.makeRequest = makeRequest;
 exports.postKeepalive = postKeepalive;