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

package/dist/esm/remoteconfig/custom.js

@@ -1,74 +1,54 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta | (c) Zoho Corporation Private Limited | see LICENSE */
-import { user_defaults, storageReady } from '../core/storage.js';
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+import { storageReady } from '../core/storage.js';
 import { Console } from '../core/logger.js';
 import { reresolve } from './store.js';
 
 /**
- * Custom condition values, as Android's AppticsRemoteConfig.setCustomConditionValue: the app says
- * what this device is for a custom criteria the console defines (a condition key with a list of
- * values), and a condition on that key matches when the value set here is one of the listed ones.
+ * Custom condition values: a console condition on the custom criteria (`custom_sdk_value`) is
+ * answered by what the app says this device is for that condition, by the condition's name:
  *
- *   AppticsRemoteConfig.setCustomConditionValue('plan_tier', 'gold');
+ *   AppticsRemoteConfig.setCustomConditionValue('is_custom', 'custom_color');
+ *   AppticsRemoteConfig.setCustomConditionValue('is_custom', 'gold,platinum');   // several
  *
- * The rules are evaluated on the device, so the values have to be here on the next visit too:
- * they are stored, and a value set on this page wins over a stored one. Setting one before
- * storage has loaded — before init(), say — is kept in memory and saved once it has.
- *
- * Assumed wire format, until the server confirms it: a custom criteria arrives with the custom
- * key as its `key` and operator 1 ("is one of"), the same shape as the built-in criteria. A
- * different shape fails closed — the condition does not match and the default is used.
+ * The condition matches when one of the comma separated values is one of the values it lists.
+ * Values are for this page: an app sets them as it starts, as it would any other app state.
  */
-const STORE_KEY = 'remoteconfig_custom'; // no i18n
-/** This page's values; null marks a key removed here, so a stored value no longer counts. */
 var mine = {};
-function stored() {
-    var saved = user_defaults.item(STORE_KEY);
-    return saved && typeof saved === 'object' ? saved : {}; // no i18n
-}
-/** The value set for a custom criteria key, or undefined when none is. */
-function customConditionValue(key) {
-    if (Object.prototype.hasOwnProperty.call(mine, key)) {
-        var here = mine[key];
-        return here === null ? undefined : here;
-    }
-    var saved = stored();
-    return Object.prototype.hasOwnProperty.call(saved, key) ? saved[key] : undefined;
+/** The values set for a condition, by its name; empty when none are. */
+function customConditionValues(conditionname) {
+    var name = String(conditionname || '').trim(); // no i18n
+    return Object.prototype.hasOwnProperty.call(mine, name) ? mine[name] : [];
 }
 /**
- * Sets what this device is for a custom criteria, or removes it with an empty value. Re-applies
- * the stored rules as soon as storage is ready, so the next read sees the new result without a
- * fetch.
+ * Sets what this device is for a custom condition, by its name, as comma separated values; an
+ * empty value removes it. Re-applies the stored rules once storage is ready, so the next read sees
+ * the new result without a fetch.
  */
-function setCustomConditionValue(key, value) {
-    var name = typeof key === 'string' ? key.trim() : ''; // no i18n
+function setCustomConditionValue(conditionname, value) {
+    var name = typeof conditionname === 'string' ? conditionname.trim() : ''; // no i18n
     if (name === '') { // no i18n
-        Console.warn('AppticsRemoteConfig.setCustomConditionValue: a condition key is required'); // no i18n
+        Console.warn('AppticsRemoteConfig.setCustomConditionValue: a condition name is required'); // no i18n
         return;
     }
-    var text = value === null || value === undefined ? '' : String(value).trim(); // no i18n
-    mine[name] = text === '' ? null : text; // no i18n
+    var values = (value === null || value === undefined ? '' : String(value)).split(',') // no i18n
+        .map(function (one) { return one.trim(); })
+        .filter(function (one, i, all) { return one !== '' && all.indexOf(one) === i; }); // no i18n
+    if (values.length === 0) {
+        delete mine[name];
+    }
+    else {
+        mine[name] = values;
+    }
     storageReady().then(function (backend) {
-        if (!backend) {
-            return;
-        }
-        var saved = stored();
-        Object.keys(mine).forEach(function (one) {
-            var here = mine[one];
-            if (here === null || here === undefined) {
-                delete saved[one];
-            }
-            else {
-                saved[one] = here;
-            }
-        });
-        user_defaults.add(STORE_KEY, saved);
         // only once storage has loaded: re-resolving before it would read an empty rule set and keep it
-        reresolve();
+        if (backend) {
+            reresolve();
+        }
     });
 }
-/** reset(): forgets the values set on this page; the stored ones go with the rest of storage. */
+/** reset(): forgets the values set on this page. */
 function clearCustomConditionValues() {
     mine = {};
 }
 
-export { clearCustomConditionValues, customConditionValue, setCustomConditionValue };
+export { clearCustomConditionValues, customConditionValues, setCustomConditionValue };

package/dist/esm/remoteconfig/evaluate.d.ts

@@ -10,10 +10,10 @@ export declare function conditionMatches(condition: Dict): boolean;
 /**
  * The value of one parameter on this device, as the string the server stores it as.
  *
- * `byId` is every condition the answer carried, keyed by its id — the mapping on the parameter
- * names a condition but does not repeat its criteria.
+ * `conditions` is `all_condition` as the server sent it: its order is the order they are tried
+ * in. The parameter's own `conditions` say which of them apply to it, and with what value.
  */
-export declare function resolve(parameter: Dict, byId: Record<string, Dict>): string;
+export declare function resolve(parameter: Dict, conditions: Dict[]): string;
 /**
  * Every parameter resolved against this device, as a flat name -> value map.
  *

package/dist/esm/remoteconfig/evaluate.js

@@ -1,8 +1,9 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 import { Console } from '../core/logger.js';
 import { _ZAP } from '../core/state.js';
 import { isEmpty } from '../core/utils.js';
-import { customConditionValue } from './custom.js';
+import { customConditionValues } from './custom.js';
+import { deviceCountry } from './country.js';
 
 /**
  * Working out what a parameter is worth on this device.
@@ -11,11 +12,17 @@ import { customConditionValue } from './custom.js';
  * condition with its criteria, and the mapping between them. Resolving it here rather than on
  * the server is what lets a value be read with no network at all on the next visit.
  *
- * A parameter resolves by walking its conditions in `conditionorder` and taking the value of the
- * first one that matches this device. Nothing matches, or nothing is mapped: the default.
+ * A parameter resolves by walking the conditions in the order of `all_condition`, the console's
+ * own order, and taking the value the parameter maps to the first one that both applies to it and
+ * matches this device. A condition matches when every one of its criteria does. Nothing matches,
+ * or nothing is mapped: the parameter's default value.
+ *
+ * Criteria are answered from what the browser knows about itself (app version, device type,
+ * country...), except a custom one (`custom_sdk_value`): that is answered by what the app set with
+ * setCustomConditionValue(conditionname, 'a,b'), and matches when one of those values is listed.
  *
  * Everything fails closed. An operator we do not recognise, a criteria key we cannot answer, a
- * condition the parameter names but the server did not send — each one means "does not match",
+ * condition the parameter names but the server did not send: each one means "does not match",
  * never "matches". A config system that guesses hands an app a value its author never chose, on
  * a device they cannot see, and that is far worse than falling back to the default.
  */
@@ -39,9 +46,12 @@ const FACTS = Object.freeze({
     osversion: function () { return String(_ZAP._device_info.osversion || ''); }, // no i18n
     devicetype: function () { return String(_ZAP._device_info.devicetype || ''); }, // no i18n
     language: function () { return String(navigator.language || ''); }, // no i18n
+    country: deviceCountry,
     customergroupid: function () { return String(_ZAP._user_info.groupid || ''); }, // no i18n
     userid: function () { return String(_ZAP._user_info.userid || ''); }, // no i18n
 });
+/** The criteria key of a custom condition, answered by setCustomConditionValue. */
+const CUSTOM_KEY = 'custom_sdk_value'; // no i18n
 /** Codes and keys already complained about, so one unknown rule is not a log per read. */
 var reported = {};
 function sayOnce(key, message) {
@@ -63,8 +73,8 @@ function valuesOf(criteria) {
     }
     return raw.map(function (one) { return String(one); });
 }
-/** Whether one criteria holds on this device. */
-function criteriaMatches(criteria) {
+/** Whether one criteria holds on this device; `conditionname` answers a custom criteria. */
+function criteriaMatches(criteria, conditionname) {
     var key = String(criteria.key || ''); // no i18n
     var operator = OPERATORS[String(criteria.status)];
     if (operator === undefined) {
@@ -72,21 +82,31 @@ function criteriaMatches(criteria) {
             + '", so conditions using it will not match'); // no i18n
         return false;
     }
+    var listed = valuesOf(criteria);
+    if (key === CUSTOM_KEY) {
+        var mine = customConditionValues(conditionname);
+        if (mine.length === 0) {
+            sayOnce('custom:' + conditionname, 'AppticsRemoteConfig: no value for the custom condition "' + conditionname // no i18n
+                + '"; set one with setCustomConditionValue, or it will not match'); // no i18n
+            return false;
+        }
+        // 'in': one of the values the app set is one of the listed ones
+        return mine.some(function (one) { return listed.indexOf(one) !== -1; });
+    }
     var fact = FACTS[key];
-    // not something a browser knows about itself: a custom criteria, answered by what the app set
-    // with setCustomConditionValue
-    var actual = fact !== undefined ? fact() : customConditionValue(key);
-    if (actual === undefined) {
-        sayOnce('key:' + key, 'AppticsRemoteConfig: no value for criteria "' + key // no i18n
-            + '"; set one with setCustomConditionValue, or conditions using it will not match'); // no i18n
+    if (fact === undefined) {
+        // not something a browser knows about itself
+        sayOnce('key:' + key, 'AppticsRemoteConfig: unknown criteria "' + key // no i18n
+            + '", so conditions using it will not match'); // no i18n
         return false;
     }
+    var actual = fact();
     if (actual === '') {
         return false;
     }
     // 'in': the device's value is one of the listed ones. Compared as strings because that is
     // what both sides are - '1.1' is a version, not the number 1.1
-    return valuesOf(criteria).indexOf(actual) !== -1;
+    return listed.indexOf(actual) !== -1;
 }
 /**
  * Whether a condition holds: every one of its criteria must. The template requires at least one
@@ -99,43 +119,40 @@ function conditionMatches(condition) {
         return false;
     }
     for (var i = 0; i < criterias.length; i++) {
-        if (!criteriaMatches(criterias[i])) {
+        if (!criteriaMatches(criterias[i], String(condition.conditionname || ''))) { // no i18n
             return false;
         }
     }
     return true;
 }
-/** The conditions a parameter names, in the order the console put them in. */
-function orderedConditions(parameter) {
-    var mapped = parameter.conditions;
-    if (!Array.isArray(mapped)) {
-        return [];
-    }
-    return mapped.slice().sort(function (a, b) {
-        return Number(a.conditionorder || 0) - Number(b.conditionorder || 0); // no i18n
-    });
-}
 /**
  * The value of one parameter on this device, as the string the server stores it as.
  *
- * `byId` is every condition the answer carried, keyed by its id — the mapping on the parameter
- * names a condition but does not repeat its criteria.
+ * `conditions` is `all_condition` as the server sent it: its order is the order they are tried
+ * in. The parameter's own `conditions` say which of them apply to it, and with what value.
  */
-function resolve(parameter, byId) {
-    var mapped = orderedConditions(parameter);
-    for (var i = 0; i < mapped.length; i++) {
-        var link = mapped[i];
-        var condition = byId[String(link.conditionid)];
-        if (condition === undefined) {
-            // the parameter points at a condition the answer did not include
-            sayOnce('missing:' + link.conditionid, 'AppticsRemoteConfig: parameter "' + parameter.paramname // no i18n
-                + '" uses condition ' + link.conditionid + ', which the server did not send'); // no i18n
-            continue;
-        }
-        if (conditionMatches(condition)) {
+function resolve(parameter, conditions) {
+    var links = {};
+    (Array.isArray(parameter.conditions) ? parameter.conditions : []).forEach(function (link) {
+        links[String(link.conditionid)] = link;
+    });
+    var sent = {};
+    for (var i = 0; i < conditions.length; i++) {
+        var condition = conditions[i];
+        var id = String(condition.conditionid);
+        sent[id] = true;
+        var link = links[id];
+        if (link !== undefined && conditionMatches(condition)) {
             return String(link.value === undefined || link.value === null ? '' : link.value);
         }
     }
+    Object.keys(links).forEach(function (id) {
+        if (!sent[id]) {
+            // the parameter points at a condition the answer did not include
+            sayOnce('missing:' + id, 'AppticsRemoteConfig: parameter "' + parameter.paramname // no i18n
+                + '" uses condition ' + id + ', which the server did not send'); // no i18n
+        }
+    });
     return String(parameter.defaultvalue === undefined || parameter.defaultvalue === null ? '' : parameter.defaultvalue);
 }
 /**
@@ -149,16 +166,12 @@ function resolveAll(remoteconfig) {
     var out = {};
     var parameters = Array.isArray(remoteconfig.all_parameter) ? remoteconfig.all_parameter : [];
     var conditions = Array.isArray(remoteconfig.all_condition) ? remoteconfig.all_condition : [];
-    var byId = {};
-    conditions.forEach(function (condition) {
-        byId[String(condition.conditionid)] = condition;
-    });
     parameters.forEach(function (parameter) {
         var name = String(parameter.paramname || ''); // no i18n
         if (name === '') {
             return;
         }
-        out[name] = resolve(parameter, byId);
+        out[name] = resolve(parameter, conditions);
     });
     return out;
 }

package/dist/esm/remoteconfig/fetch.d.ts

@@ -15,10 +15,10 @@ export declare function fetchRemoteConfig(): Promise<Record<string, unknown>>;
 export declare function resetRemoteConfig(): void;
 /**
  * Makes sure the values are this page's own: from a fetch that just succeeded, or one within
- * CACHE_MS. Resolves true when they are, false when the fetch failed, could not be made, or was
- * past the coldFetch limit — the caller then decides whether stored values will do. Never rejects.
+ * CACHE_MS. Resolves true when they are, false when the fetch failed or could not be made — the
+ * caller then decides whether stored values will do. Never rejects.
  *
  * Waits for start-up and for the device to be registered, which a first visit is still doing
  * when ready() resolves: getupdates is refused without the device ids.
  */
-export declare function obtain(coldFetch?: boolean): Promise<boolean>;
+export declare function obtain(): Promise<boolean>;

package/dist/esm/remoteconfig/fetch.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 import { SDK_MODULE } from '../core/constants.js';
 import { hooks } from '../core/hooks.js';
 import { _ZAP } from '../core/state.js';
@@ -7,8 +7,8 @@ import { nowMs } from '../core/utils.js';
 import { rejectIfOffline, rejectIfNoDeviceIds, postToApptics, apiHeaders } from '../core/transport.js';
 import { deviceReady } from '../device/index.js';
 import { ready } from '../lifecycle.js';
-import { reresolve, clearRemoteConfig, store, storeUnchanged, flagtime } from './store.js';
 import { clearCustomConditionValues } from './custom.js';
+import { store, storeUnchanged, flagtime, reresolve, clearRemoteConfig } from './store.js';
 
 /**
  * The getupdates call.
@@ -32,16 +32,11 @@ var inFlight = null;
 var generation = 0;
 /**
  * How long a fetch that succeeded on this page answers for later ones, as on Android: a value
- * read on every render must not be a request on every render. coldFetch skips it.
+ * read on every render must not be a request on every render.
  */
 const CACHE_MS = 5 * 60 * 1000;
-/** coldFetch goes to the network every time, so it is limited: three in any minute, as on Android. */
-const COLD_LIMIT = 3;
-const COLD_WINDOW_MS = 60 * 1000;
 /** When a fetch on this page last succeeded; 0 until one has. */
 var fetchedAt = 0;
-/** When the coldFetch calls of the last minute went out. */
-var coldCalls = [];
 /**
  * Whether remote config is still worth asking about.
  *
@@ -154,36 +149,27 @@ function resetRemoteConfig() {
     generation++;
     inFlight = null;
     fetchedAt = 0;
-    coldCalls = [];
     _ZAP._remoteConfigReported = true;
     clearCustomConditionValues();
     clearRemoteConfig();
 }
 /**
  * Makes sure the values are this page's own: from a fetch that just succeeded, or one within
- * CACHE_MS. Resolves true when they are, false when the fetch failed, could not be made, or was
- * past the coldFetch limit — the caller then decides whether stored values will do. Never rejects.
+ * CACHE_MS. Resolves true when they are, false when the fetch failed or could not be made — the
+ * caller then decides whether stored values will do. Never rejects.
  *
  * Waits for start-up and for the device to be registered, which a first visit is still doing
  * when ready() resolves: getupdates is refused without the device ids.
  */
-function obtain(coldFetch) {
+function obtain() {
     return ready().then(function (running) {
         if (!running) {
             return false;
         }
         var now = nowMs();
-        if (coldFetch !== true && fetchedAt > 0 && now - fetchedAt < CACHE_MS) {
+        if (fetchedAt > 0 && now - fetchedAt < CACHE_MS) {
             return true;
         }
-        if (coldFetch === true) {
-            coldCalls = coldCalls.filter(function (at) { return now - at < COLD_WINDOW_MS; });
-            if (coldCalls.length >= COLD_LIMIT) {
-                Console.warn(LABEL + ': coldFetch is limited to ' + COLD_LIMIT + ' a minute; this one is not sent'); // no i18n
-                return false;
-            }
-            coldCalls.push(now);
-        }
         return deviceReady().then(function () {
             return fetchRemoteConfig();
         }).then(function () {
@@ -196,11 +182,11 @@ function obtain(coldFetch) {
 }
 /** Start-up's own fetch, so values are this session's without the app asking. */
 function fetchOnStart() {
-    obtain(false);
+    obtain();
 }
 hooks.resetRemoteConfig = resetRemoteConfig;
 hooks.remoteConfigStarted = fetchOnStart;
-// a condition on the customer group answers differently once AppticsSetUser has named one
+// a condition on the customer group answers differently once AppticsUser.setUser has named one
 hooks.remoteConfigUserChanged = reresolve;
 // imported after start-up has already finished (a lazy import, say): fetch now, as start-up would have
 if (_ZAP._ready) {

package/dist/esm/remoteconfig/index.d.ts

@@ -1,13 +1,15 @@
-/** Android's AppticsRemoteConfig: fetchValue, fetchValues, setCustomConditionValue, setFallbackWithOfflineValue. */
+/** AppticsRemoteConfig: fetchValue, fetchValues and setCustomConditionValue, each with the parameter names the console shows. */
 export declare const AppticsRemoteConfig: {
-    fetchValue: (name: string, callback?: (value: string | null) => void, coldFetch?: boolean) => Promise<string | null>;
-    fetchValues: (defaults: Record<string, string | null>, callback?: (values: Record<string, string | null>) => void, coldFetch?: boolean) => Promise<Record<string, string | null>>;
-    /** Whether a failed fetch answers with the values fetched before (the default) or with null. */
-    setFallbackWithOfflineValue: (enabled?: boolean) => void;
+    fetchValue: (name: string, callback?: (value: string | null) => void) => Promise<string | null>;
+    /** The parameters named, or every parameter when none are: name -> value, null when there is none. */
+    fetchValues: {
+        (names?: string[], callback?: (values: Record<string, string | null>) => void): Promise<Record<string, string | null>>;
+        (callback: (values: Record<string, string | null>) => void): Promise<Record<string, string | null>>;
+    };
     /**
-     * What this device is for a custom criteria the console defines, as Android's
-     * setCustomConditionValue; an empty value removes it. Kept across visits.
+     * What this device is for a custom condition, by the condition's name, as comma separated
+     * values: it matches when one of them is listed. An empty value removes it.
      */
-    setCustomConditionValue: (key: string, value: string | number | boolean | null) => void;
+    setCustomConditionValue: (conditionname: string, value: string | number | boolean | null) => void;
 };
 export default AppticsRemoteConfig;

package/dist/esm/remoteconfig/index.js

@@ -1,5 +1,5 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta | (c) Zoho Corporation Private Limited | see LICENSE */
-import { guard } from '../core/guard.js';
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+import { forward, guard } from '../core/guard.js';
 import { Console } from '../core/logger.js';
 import { obtain } from './fetch.js';
 import { setCustomConditionValue } from './custom.js';
@@ -9,30 +9,21 @@ import { all } from './store.js';
  * Remote config, shipped as its own entry point:
  *   import { AppticsRemoteConfig } from '@zoho_apptics/apptics-js-sdk/remote-config';
  *
- * Four calls, as on Android: fetchValue(name) and fetchValues({ name: default }) read parameters,
- * setCustomConditionValue says what this device is for a custom criteria, and
- * setFallbackWithOfflineValue chooses what a failed fetch answers with. The rule set is stored and
- * resolved on the device, so a fetch within five minutes, or a failed one with the offline fallback
- * on, answers without waiting on the network. The SDK fetches on start-up, and re-applies the rules
- * on its own when AppticsSetUser or setCustomConditionValue changes what this device is.
+ * fetchValue(name) reads one parameter, fetchValues(['a', 'b']) several, and fetchValues() every
+ * parameter the console has. Each parameter's value is the console's: the value of the first
+ * condition, in the console's order, that this device matches, else the parameter's default value.
+ * setCustomConditionValue(conditionname, 'a,b') answers the custom conditions.
+ * The rule set is stored and resolved on the device, so a fetch within five minutes answers without
+ * waiting on the network, and a failed one answers with the values fetched before. The SDK fetches
+ * on start-up, and re-applies the rules on its own when AppticsUser.setUser changes the user.
  *
- * A parameter the console does not have is null from fetchValue and the caller's default from
- * fetchValues, never undefined: a config system whose failure mode is `undefined` moves the
- * problem into the app's rendering code.
+ * A name the console does not have is null, never undefined: a config system whose failure mode
+ * is `undefined` moves the problem into the app's rendering code.
  */
 function raw(name) {
     var values = all();
     return Object.prototype.hasOwnProperty.call(values, name) ? values[name] : undefined;
 }
-/**
- * Whether a fetch that failed still answers with what was fetched before. On by default, as
- * `fallbackWithOfflineValue` is on Android: a page offline for a moment keeps its config.
- */
-var fallbackWithOfflineValue = true;
-/** Off: a failed fetch answers with null, or the caller's defaults, rather than stored values. */
-function setFallbackWithOfflineValue(enabled) {
-    fallbackWithOfflineValue = typeof enabled === 'boolean' ? enabled : true; // no i18n
-}
 /** Hands a result to the app's callback, which must not be able to break the Promise. */
 function answer(value, callback) {
     if (typeof callback === 'function') { // no i18n
@@ -47,39 +38,74 @@ function answer(value, callback) {
 }
 /**
  * One parameter, fetched for this page, as Android's fetchValue: resolves with its value, or null
- * when the console has no such parameter or the fetch failed with the offline fallback off.
+ * when the console has no such parameter. A failed fetch answers with the value fetched before.
  */
-function fetchValue(name, callback, coldFetch) {
-    return obtain(coldFetch).then(function (fresh) {
-        var value = fresh || fallbackWithOfflineValue ? raw(name) : undefined;
+function fetchValue(name, callback) {
+    return obtain().then(function () {
+        var value = raw(name);
         return answer(value === undefined ? null : value, callback);
     });
 }
 /**
- * Several parameters at once, as Android's fetchValues: `defaults` maps each name to the value to
- * use when there is none, and the result has exactly those names.
+ * Several parameters at once: `names` lists the ones wanted, and the result has exactly those
+ * names, null for one the console does not have. With no names (or an empty list), every
+ * parameter the console has. A callback may come first when there are no names.
  */
-function fetchValues(defaults, callback, coldFetch) {
-    return obtain(coldFetch).then(function (fresh) {
+function fetchValues(names, callback) {
+    if (typeof names === 'function') { // no i18n
+        // fetchValues(callback)
+        callback = names;
+        names = undefined;
+    }
+    var wanted = wantedNames(names);
+    var done = typeof callback === 'function' ? callback : undefined; // no i18n
+    return obtain().then(function () {
+        var values = all();
         var out = {};
-        Object.keys(defaults || {}).forEach(function (name) {
-            var value = fresh || fallbackWithOfflineValue ? raw(name) : undefined;
-            out[name] = value === undefined ? defaults[name] : value;
+        (wanted === null ? Object.keys(values) : wanted).forEach(function (name) {
+            var value = raw(name);
+            out[name] = value === undefined ? null : value;
         });
-        return answer(out, callback);
+        return answer(out, done);
+    });
+}
+/** The names asked for, or null for every parameter. Anything but a list of names counts as none. */
+function wantedNames(names) {
+    if (names === undefined || names === null) {
+        return null;
+    }
+    if (!Array.isArray(names)) {
+        Console.warn('AppticsRemoteConfig.fetchValues: takes a list of parameter names, as fetchValues([\'a\', \'b\']); answering with every parameter'); // no i18n
+        return null;
+    }
+    var out = [];
+    names.forEach(function (name) {
+        var one = typeof name === 'string' ? name.trim() : ''; // no i18n
+        if (one !== '' && out.indexOf(one) === -1) { // no i18n
+            out.push(one);
+        }
     });
+    return out.length === 0 ? null : out;
 }
-/** Android's AppticsRemoteConfig: fetchValue, fetchValues, setCustomConditionValue, setFallbackWithOfflineValue. */
+const fetchValueGuarded = guard('AppticsRemoteConfig.fetchValue', fetchValue); // no i18n
+const fetchValuesGuarded = guard('AppticsRemoteConfig.fetchValues', fetchValues); // no i18n
+const setCustomConditionValueGuarded = guard('AppticsRemoteConfig.setCustomConditionValue', setCustomConditionValue); // no i18n
+/** AppticsRemoteConfig: fetchValue, fetchValues and setCustomConditionValue, each with the parameter names the console shows. */
 const AppticsRemoteConfig = {
-    fetchValue: guard('AppticsRemoteConfig.fetchValue', fetchValue), // no i18n
-    fetchValues: guard('AppticsRemoteConfig.fetchValues', fetchValues), // no i18n
-    /** Whether a failed fetch answers with the values fetched before (the default) or with null. */
-    setFallbackWithOfflineValue: guard('AppticsRemoteConfig.setFallbackWithOfflineValue', setFallbackWithOfflineValue), // no i18n
+    fetchValue: function fetchValue(name, callback) {
+        return forward(fetchValueGuarded, arguments);
+    },
+    /** The parameters named, or every parameter when none are: name -> value, null when there is none. */
+    fetchValues: function fetchValues(names, callback) {
+        return forward(fetchValuesGuarded, arguments);
+    }, // no i18n
     /**
-     * What this device is for a custom criteria the console defines, as Android's
-     * setCustomConditionValue; an empty value removes it. Kept across visits.
+     * What this device is for a custom condition, by the condition's name, as comma separated
+     * values: it matches when one of them is listed. An empty value removes it.
      */
-    setCustomConditionValue: guard('AppticsRemoteConfig.setCustomConditionValue', setCustomConditionValue), // no i18n
+    setCustomConditionValue: function setCustomConditionValue(conditionname, value) {
+        forward(setCustomConditionValueGuarded, arguments);
+    },
 };
 
 export { AppticsRemoteConfig, AppticsRemoteConfig as default };

package/dist/esm/remoteconfig/store.js

@@ -1,4 +1,4 @@
-/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta | (c) Zoho Corporation Private Limited | see LICENSE */
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
 import { Console } from '../core/logger.js';
 import { user_defaults } from '../core/storage.js';
 import { resolveAll, resetEvaluationWarnings } from './evaluate.js';

package/dist/esm/remoteconfig/tz-countries.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The country of every IANA time zone, by its ISO 3166 code: generated by
+ * scripts/tz-countries.mjs from tzdata 2026d-rearguard (zone.tab, and the old names its links keep).
+ * Do not edit by hand.
+ *
+ * Packed as "CC:Area/City,City|Area/City;CC:...": a country, then its zones grouped by area.
+ */
+export declare const TZ_COUNTRIES = "AD:Europe/Andorra;AE:Asia/Dubai;AF:Asia/Kabul;AG:America/Antigua;AI:America/Anguilla;AL:Europe/Tirane;AM:Asia/Yerevan;AO:Africa/Luanda;AQ:Antarctica/Casey,Davis,DumontDUrville,Mawson,McMurdo,Palmer,Rothera,Syowa,Troll,Vostok;AR:America/Argentina/Buenos_Aires,Argentina/Catamarca,Argentina/ComodRivadavia,Argentina/Cordoba,Argentina/Jujuy,Argentina/La_Rioja,Argentina/Mendoza,Argentina/Rio_Gallegos,Argentina/Salta,Argentina/San_Juan,Argentina/San_Luis,Argentina/Tucuman,Argentina/Ushuaia,Buenos_Aires,Catamarca,Cordoba,Jujuy,Mendoza,Rosario;AS:Pacific/Pago_Pago,Samoa|US/Samoa;AT:Europe/Vienna;AU:Antarctica/Macquarie|Australia/ACT,Adelaide,Brisbane,Broken_Hill,Canberra,Currie,Darwin,Eucla,Hobart,LHI,Lindeman,Lord_Howe,Melbourne,NSW,North,Perth,Queensland,South,Sydney,Tasmania,Victoria,West,Yancowinna;AW:America/Aruba;AX:Europe/Mariehamn;AZ:Asia/Baku;BA:Europe/Sarajevo;BB:America/Barbados;BD:Asia/Dacca,Dhaka;BE:CET,MET|Europe/Brussels;BF:Africa/Ouagadougou;BG:Europe/Sofia;BH:Asia/Bahrain;BI:Africa/Bujumbura;BJ:Africa/Porto-Novo;BL:America/St_Barthelemy;BM:Atlantic/Bermuda;BN:Asia/Brunei;BO:America/La_Paz;BQ:America/Kralendijk;BR:America/Araguaina,Bahia,Belem,Boa_Vista,Campo_Grande,Cuiaba,Eirunepe,Fortaleza,Maceio,Manaus,Noronha,Porto_Acre,Porto_Velho,Recife,Rio_Branco,Santarem,Sao_Paulo|Brazil/Acre,DeNoronha,East,West;BS:America/Nassau;BT:Asia/Thimbu,Thimphu;BW:Africa/Gaborone;BY:Europe/Minsk;BZ:America/Belize;CA:America/Atikokan,Blanc-Sablon,Cambridge_Bay,Creston,Dawson,Dawson_Creek,Edmonton,Fort_Nelson,Glace_Bay,Goose_Bay,Halifax,Inuvik,Iqaluit,Moncton,Montreal,Nipigon,Pangnirtung,Rainy_River,Rankin_Inlet,Regina,Resolute,St_Johns,Swift_Current,Thunder_Bay,Toronto,Vancouver,Whitehorse,Winnipeg,Yellowknife|Canada/Atlantic,Central,Eastern,Mountain,Newfoundland,Pacific,Saskatchewan,Yukon;CC:Indian/Cocos;CD:Africa/Kinshasa,Lubumbashi;CF:Africa/Bangui;CG:Africa/Brazzaville;CH:Europe/Zurich;CI:Africa/Abidjan,Timbuktu|Iceland;CK:Pacific/Rarotonga;CL:America/Coyhaique,Punta_Arenas,Santiago|Chile/Continental,EasterIsland|Pacific/Easter;CM:Africa/Douala;CN:Asia/Chongqing,Chungking,Harbin,Kashgar,Shanghai,Urumqi|PRC;CO:America/Bogota;CR:America/Costa_Rica;CU:America/Havana|Cuba;CV:Atlantic/Cape_Verde;CW:America/Curacao;CX:Indian/Christmas;CY:Asia/Famagusta,Nicosia|Europe/Nicosia;CZ:Europe/Prague;DE:Atlantic/Jan_Mayen|Europe/Berlin,Busingen;DJ:Africa/Djibouti;DK:Europe/Copenhagen;DM:America/Dominica;DO:America/Santo_Domingo;DZ:Africa/Algiers;EC:America/Guayaquil|Pacific/Galapagos;EE:Europe/Tallinn;EG:Africa/Cairo|Egypt;EH:Africa/El_Aaiun;ER:Africa/Asmara;ES:Africa/Ceuta|Atlantic/Canary|Europe/Madrid;ET:Africa/Addis_Ababa;FI:Europe/Helsinki;FJ:Pacific/Fiji;FK:Atlantic/Stanley;FM:Pacific/Chuuk,Kosrae,Pohnpei;FO:Atlantic/Faeroe,Faroe;FR:Europe/Paris;GA:Africa/Libreville;GB:Europe/Belfast,London|GB,GB-Eire;GD:America/Grenada;GE:Asia/Tbilisi;GF:America/Cayenne;GG:Europe/Guernsey;GH:Africa/Accra;GI:Europe/Gibraltar;GL:America/Danmarkshavn,Godthab,Nuuk,Scoresbysund,Thule;GM:Africa/Banjul;GN:Africa/Conakry;GP:America/Guadeloupe;GQ:Africa/Malabo;GR:EET|Europe/Athens;GS:Atlantic/South_Georgia;GT:America/Guatemala;GU:Pacific/Guam;GW:Africa/Bissau;GY:America/Guyana;HK:Asia/Hong_Kong|Hongkong;HN:America/Tegucigalpa;HR:Europe/Zagreb;HT:America/Port-au-Prince;HU:Europe/Budapest;ID:Asia/Jakarta,Jayapura,Makassar,Pontianak,Ujung_Pandang;IE:Eire|Europe/Dublin;IL:Asia/Jerusalem,Tel_Aviv|Israel;IM:Europe/Isle_of_Man;IN:Asia/Calcutta,Kolkata;IO:Indian/Chagos;IQ:Asia/Baghdad;IR:Asia/Tehran|Iran;IS:Atlantic/Reykjavik;IT:Europe/Rome;JE:Europe/Jersey;JM:America/Jamaica|Jamaica;JO:Asia/Amman;JP:Asia/Tokyo|Japan;KE:Africa/Asmera,Nairobi;KG:Asia/Bishkek;KH:Asia/Phnom_Penh;KI:Pacific/Enderbury,Kanton,Kiritimati,Tarawa;KM:Indian/Comoro;KN:America/St_Kitts;KP:Asia/Pyongyang;KR:Asia/Seoul|ROK;KW:Asia/Kuwait;KY:America/Cayman;KZ:Asia/Almaty,Aqtau,Aqtobe,Atyrau,Oral,Qostanay,Qyzylorda;LA:Asia/Vientiane;LB:Asia/Beirut;LC:America/St_Lucia;LI:Europe/Vaduz;LK:Asia/Colombo;LR:Africa/Monrovia;LS:Africa/Maseru;LT:Europe/Vilnius;LU:Europe/Luxembourg;LV:Europe/Riga;LY:Africa/Tripoli|Libya;MA:Africa/Casablanca;MC:Europe/Monaco;MD:Europe/Chisinau,Tiraspol;ME:Europe/Podgorica;MF:America/Marigot;MG:Indian/Antananarivo;MH:Kwajalein|Pacific/Kwajalein,Majuro;MK:Europe/Skopje;ML:Africa/Bamako;MM:Asia/Rangoon,Yangon;MN:Asia/Choibalsan,Hovd,Ulaanbaatar,Ulan_Bator;MO:Asia/Macao,Macau;MP:Pacific/Saipan;MQ:America/Martinique;MR:Africa/Nouakchott;MS:America/Montserrat;MT:Europe/Malta;MU:Indian/Mauritius;MV:Indian/Maldives;MW:Africa/Blantyre;MX:America/Bahia_Banderas,Cancun,Chihuahua,Ciudad_Juarez,Ensenada,Hermosillo,Matamoros,Mazatlan,Merida,Mexico_City,Monterrey,Ojinaga,Santa_Isabel,Tijuana|Mexico/BajaNorte,BajaSur,General;MY:Asia/Kuala_Lumpur,Kuching;MZ:Africa/Maputo;NA:Africa/Windhoek;NC:Pacific/Noumea;NE:Africa/Niamey;NF:Pacific/Norfolk;NG:Africa/Lagos;NI:America/Managua;NL:Europe/Amsterdam;NO:Europe/Oslo;NP:Asia/Kathmandu,Katmandu;NR:Pacific/Nauru;NU:Pacific/Niue;NZ:Antarctica/South_Pole|NZ,NZ-CHAT|Pacific/Auckland,Chatham;OM:Asia/Muscat;PA:America/Coral_Harbour,Panama|EST;PE:America/Lima;PF:Pacific/Gambier,Marquesas,Tahiti;PG:Pacific/Bougainville,Port_Moresby,Truk,Yap;PH:Asia/Manila;PK:Asia/Karachi;PL:Europe/Warsaw|Poland;PM:America/Miquelon;PN:Pacific/Pitcairn;PR:America/Puerto_Rico,Virgin;PS:Asia/Gaza,Hebron;PT:Atlantic/Azores,Madeira|Europe/Lisbon|Portugal,WET;PW:Pacific/Palau;PY:America/Asuncion;QA:Asia/Qatar;RE:Indian/Reunion;RO:Europe/Bucharest;RS:Europe/Belgrade;RU:Asia/Anadyr,Barnaul,Chita,Irkutsk,Kamchatka,Khandyga,Krasnoyarsk,Magadan,Novokuznetsk,Novosibirsk,Omsk,Sakhalin,Srednekolymsk,Tomsk,Ust-Nera,Vladivostok,Yakutsk,Yekaterinburg|Europe/Astrakhan,Kaliningrad,Kirov,Moscow,Samara,Saratov,Ulyanovsk,Volgograd|W-SU;RW:Africa/Kigali;SA:Asia/Riyadh;SB:Pacific/Guadalcanal,Ponape;SC:Indian/Mahe;SD:Africa/Khartoum;SE:Europe/Stockholm;SG:Asia/Singapore|Singapore;SH:Atlantic/St_Helena;SI:Europe/Ljubljana;SJ:Arctic/Longyearbyen;SK:Europe/Bratislava;SL:Africa/Freetown;SM:Europe/San_Marino;SN:Africa/Dakar;SO:Africa/Mogadishu;SR:America/Paramaribo;SS:Africa/Juba;ST:Africa/Sao_Tome;SV:America/El_Salvador;SX:America/Lower_Princes;SY:Asia/Damascus;SZ:Africa/Mbabane;TC:America/Grand_Turk;TD:Africa/Ndjamena;TF:Indian/Kerguelen;TG:Africa/Lome;TH:Asia/Bangkok;TJ:Asia/Dushanbe;TK:Pacific/Fakaofo;TL:Asia/Dili;TM:Asia/Ashgabat,Ashkhabad;TN:Africa/Tunis;TO:Pacific/Tongatapu;TR:Asia/Istanbul|Europe/Istanbul|Turkey;TT:America/Port_of_Spain;TV:Pacific/Funafuti;TW:Asia/Taipei|ROC;TZ:Africa/Dar_es_Salaam;UA:Europe/Kiev,Kyiv,Simferopol,Uzhgorod,Zaporozhye;UG:Africa/Kampala;UM:Pacific/Midway,Wake;US:America/Adak,Anchorage,Atka,Boise,Chicago,Denver,Detroit,Fort_Wayne,Indiana/Indianapolis,Indiana/Knox,Indiana/Marengo,Indiana/Petersburg,Indiana/Tell_City,Indiana/Vevay,Indiana/Vincennes,Indiana/Winamac,Indianapolis,Juneau,Kentucky/Louisville,Kentucky/Monticello,Knox_IN,Los_Angeles,Louisville,Menominee,Metlakatla,New_York,Nome,North_Dakota/Beulah,North_Dakota/Center,North_Dakota/New_Salem,Phoenix,Shiprock,Sitka,Yakutat|HST,MST,Navajo|Pacific/Honolulu,Johnston|US/Alaska,Aleutian,Arizona,Central,East-Indiana,Eastern,Hawaii,Indiana-Starke,Michigan,Mountain,Pacific;UY:America/Montevideo;UZ:Asia/Samarkand,Tashkent;VA:Europe/Vatican;VC:America/St_Vincent;VE:America/Caracas;VG:America/Tortola;VI:America/St_Thomas;VN:Asia/Ho_Chi_Minh,Saigon;VU:Pacific/Efate;WF:Pacific/Wallis;WS:Pacific/Apia;YE:Asia/Aden;YT:Indian/Mayotte;ZA:Africa/Johannesburg;ZM:Africa/Lusaka;ZW:Africa/Harare";