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

package/dist/cjs/remoteconfig/store.js

@@ -1,21 +1,22 @@
-/*! @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.2 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 var logger = require('../core/logger.js');
 var storage = require('../core/storage.js');
+var utils = require('../core/utils.js');
 var evaluate = require('./evaluate.js');
 
 /**
  * What remote config keeps between visits.
  *
- * The rule set is stored, not just the resolved values, for two reasons. The server only resends
- * it when something changed — a fetch with a non-zero `flagtime` and no changes answers with no
- * `remoteconfig` block at all — so throwing it away would mean asking for it again with
- * flagtime 0 on every visit. And the resolved values depend on the device: an app version or a
- * customer group that changed since the last visit has to re-resolve against the same rules.
+ * The rule set is stored, not just the resolved values: the values depend on the device, so an
+ * app version or a customer group that changed has to re-resolve against the same rules, and a
+ * visit that cannot reach the server still has the last visit's values to read.
  *
- * `flagtime` is the whole protocol here: it is the moment this SDK last had a rule set, and
- * sending it back is how the server decides whether anything needs saying.
+ * `flagtime` is the whole protocol here. The first getupdates of a page load sends 0 and gets the
+ * whole rule set, which replaces what is stored. Each later one sends the time the last answered
+ * request went out, and gets only what was added or changed since: those parameters and
+ * conditions are merged into the stored set, and one that did not change is kept as it was.
  */
 const STORE_KEY = 'remoteconfig'; // no i18n
 var values = {};
@@ -24,55 +25,86 @@ function read() {
     var saved = storage.user_defaults.item(STORE_KEY);
     return saved && typeof saved === 'object' ? saved : null;
 }
-/** The flagtime to send: 0 until we hold a rule set, which asks the server for everything. */
+/** When the last answered getupdates went out; 0 when nothing is stored. */
 function flagtime() {
     var saved = read();
     return saved && typeof saved.flagtime === 'number' ? saved.flagtime : 0;
 }
-/**
- * The newest `version[].date` in a rule set, which is what the next fetch sends as flagtime.
- *
- * The array is a publication history and is not promised to be in order, so it is the highest
- * date that matters rather than the first or last entry.
- */
-function publishedAt(rules) {
-    var versions = Array.isArray(rules.version) ? rules.version : [];
-    var newest = 0;
-    versions.forEach(function (one) {
-        var at = Number(one.date);
-        if (isFinite(at) && at > newest) {
-            newest = at;
-        }
-    });
-    return newest;
-}
 /** Re-resolves the stored rules against this device, without fetching. */
 function reresolve() {
     var saved = read();
     values = saved && saved.rules ? evaluate.resolveAll(saved.rules) : {};
     loaded = true;
 }
-/** Stores a rule set the server just sent, and resolves it. */
-function store(rules, at) {
+/**
+ * Stores a whole rule set, the answer to flagtime 0, in place of what was stored, and resolves
+ * it. `askedAt` is when the request went out: the next one asks for what changed since then.
+ */
+function store(rules, askedAt) {
     evaluate.resetEvaluationWarnings();
-    var record = { flagtime: publishedAt(rules) || at, rules: rules, fetchedat: at };
+    var record = { flagtime: askedAt, rules: rules, fetchedat: utils.nowMs() };
     storage.user_defaults.add(STORE_KEY, record);
     values = evaluate.resolveAll(rules);
     loaded = true;
-    logger.Console.log('AppticsRemoteConfig: ' + Object.keys(values).length + ' parameters, published ' + record.flagtime); // no i18n
+    logger.Console.log('AppticsRemoteConfig: ' + Object.keys(values).length + ' parameters, as of ' + askedAt); // no i18n
+}
+/**
+ * `changed` laid over `stored`, matched by `key`: an entry the server resent replaces the one
+ * with the same key, in its place; a new one goes on the end; the rest stay as they were.
+ */
+function mergeList(stored, changed, key) {
+    var out = Array.isArray(stored) ? stored.slice() : [];
+    if (!Array.isArray(changed)) {
+        return out;
+    }
+    changed.forEach(function (entry) {
+        if (!entry || typeof entry !== 'object') {
+            return;
+        }
+        var id = key(entry);
+        var at = id === '' ? -1 : out.findIndex(function (one) { return key(one) === id; });
+        if (at >= 0) {
+            out[at] = entry;
+        }
+        else {
+            out.push(entry);
+        }
+    });
+    return out;
+}
+/** An entry's id, or its name when it has none, as the key to match a resent entry by. */
+function idOr(idKey, nameKey) {
+    return function (entry) {
+        var id = entry[idKey] !== undefined && entry[idKey] !== null ? entry[idKey] : entry[nameKey];
+        return id === undefined || id === null ? '' : String(id); // no i18n
+    };
+}
+/**
+ * Merges what a later getupdates sent, everything added or changed since its flagtime, into the
+ * stored rule set, and resolves the result. With nothing stored, it is the whole set.
+ */
+function merge(changes, askedAt) {
+    var saved = read();
+    var base = saved && saved.rules && typeof saved.rules === 'object' ? saved.rules : {};
+    var rules = Object.assign({}, base, changes);
+    rules.all_parameter = mergeList(base.all_parameter, changes.all_parameter, idOr('paramid', 'paramname')); // no i18n
+    rules.all_condition = mergeList(base.all_condition, changes.all_condition, idOr('conditionid', 'conditionname')); // no i18n
+    rules.version = mergeList(base.version, changes.version, idOr('versionid', 'date')); // no i18n
+    store(rules, askedAt);
 }
 /**
- * Records a fetch that brought no rule set.
+ * Records a later fetch that brought no changes.
  *
- * That is the normal answer when nothing has changed, and it is not a failure: what is stored
- * stays, and only the fetch time moves.
+ * That is the normal answer, and it is not a failure: what is stored stays, and the next request
+ * asks for what changed since this one went out.
  */
-function storeUnchanged(at) {
+function storeUnchanged(askedAt) {
     var saved = read();
     if (saved === null) {
         return;
     }
-    saved.fetchedat = at;
+    saved.flagtime = askedAt;
+    saved.fetchedat = utils.nowMs();
     storage.user_defaults.add(STORE_KEY, saved);
 }
 /** Forgets the rule set and its values, so the next fetch asks with flagtime 0. */
@@ -93,6 +125,7 @@ function all() {
 exports.all = all;
 exports.clearRemoteConfig = clearRemoteConfig;
 exports.flagtime = flagtime;
+exports.merge = merge;
 exports.reresolve = reresolve;
 exports.store = store;
 exports.storeUnchanged = storeUnchanged;

package/dist/cjs/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";

package/dist/cjs/remoteconfig/tz-countries.js

@@ -0,0 +1,13 @@
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.2 | (c) Zoho Corporation Private Limited | see LICENSE */
+'use strict';
+
+/**
+ * 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.
+ */
+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'; // no i18n
+
+exports.TZ_COUNTRIES = TZ_COUNTRIES;

package/dist/{esm/core → cjs/remotelog}/callsite.d.ts

@@ -1,10 +1,11 @@
 /**
- * Where a log line was raised, for logSDK's `filename` and `linenumber`.
+ * Where in the app an AppticsLogger line was written, for logSDK's `filename`, `linenumber` and
+ * `function`: the Remote Logger page shows each line with them.
  *
  * There is no caller introspection in a browser, so the only way to answer "which line was this"
- * is to throw an Error nobody catches and read its stack. That is cheap enough for a channel that
- * only carries the SDK's own failures, but it is never on the app's path: everything here is
- * wrapped so a stack we cannot parse costs a line its call site and nothing more.
+ * is to make an Error and read its stack, skipping the SDK's own frames. That costs a little on
+ * every line the app logs, and nothing on any other call. Everything here is wrapped so a stack
+ * that cannot be parsed costs a line its call site and nothing more: the line is still logged.
  */
 export interface CallSite {
     /** The script's basename, not its url: logSDK caps filename at 100 characters. */
@@ -15,6 +16,12 @@ export interface CallSite {
     fn?: string;
 }
 export declare const NO_CALL_SITE: CallSite;
+/**
+ * A call typed in the browser's developer console: there is no file, line or function to report,
+ * only the console's own placeholder for its input, so the line says plainly that it came from
+ * nowhere in the app. file_name and the function field both accept `-`.
+ */
+export declare const CONSOLE_CALL_SITE: CallSite;
 /**
  * The frame `skip` frames down a stack, counting only the ones that name a file — V8 heads its
  * stacks with an `Error` line and Firefox does not, so counting raw lines would read a different

package/dist/cjs/{core → remotelog}/callsite.js

@@ -1,15 +1,32 @@
-/*! @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.2 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 /**
- * Where a log line was raised, for logSDK's `filename` and `linenumber`.
+ * Where in the app an AppticsLogger line was written, for logSDK's `filename`, `linenumber` and
+ * `function`: the Remote Logger page shows each line with them.
  *
  * There is no caller introspection in a browser, so the only way to answer "which line was this"
- * is to throw an Error nobody catches and read its stack. That is cheap enough for a channel that
- * only carries the SDK's own failures, but it is never on the app's path: everything here is
- * wrapped so a stack we cannot parse costs a line its call site and nothing more.
+ * is to make an Error and read its stack, skipping the SDK's own frames. That costs a little on
+ * every line the app logs, and nothing on any other call. Everything here is wrapped so a stack
+ * that cannot be parsed costs a line its call site and nothing more: the line is still logged.
  */
 const NO_CALL_SITE = { filename: '', linenumber: 0, fn: '' };
+/**
+ * A call typed in the browser's developer console: there is no file, line or function to report,
+ * only the console's own placeholder for its input, so the line says plainly that it came from
+ * nowhere in the app. file_name and the function field both accept `-`.
+ */
+const CONSOLE_CALL_SITE = { filename: '-', linenumber: 0, fn: '-' };
+/**
+ * The frame of code run from the developer console, in each browser:
+ *   V8 (Chrome, Edge):  `    at <anonymous>:1:15`        (the file is <anonymous>)
+ *   Firefox:            `@debugger eval code:1:15`
+ *   Safari:             `global code` or `eval code`, with no location at all
+ * V8 names a string run through eval or new Function <anonymous> too; it is no file either.
+ */
+const CONSOLE_FILE_V8 = '<anonymous>'; // no i18n
+const CONSOLE_FIREFOX = /debugger eval code/; // no i18n
+const CONSOLE_SAFARI = /^(global|eval) code(@|$)/; // no i18n
 /** logSDK declares max-len="100" on filename. */
 const FILENAME_MAX = 100;
 /**
@@ -63,14 +80,19 @@ function callSiteFromStack(stack, skip) {
     var lines = stack.split('\n');
     var seen = 0;
     for (var i = 0; i < lines.length; i++) {
-        var frame = parseFrame(lines[i] || '');
+        var raw = (lines[i] || '').trim(); // no i18n
+        var frame = parseFrame(raw);
         if (frame === null) {
+            // Safari's console frame has no location, so it is never a frame parseFrame reads
+            if (seen === skip && CONSOLE_SAFARI.test(raw)) {
+                return CONSOLE_CALL_SITE;
+            }
             continue;
         }
         if (seen++ < skip) {
             continue;
         }
-        return frame;
+        return frame.filename === CONSOLE_FILE_V8 || CONSOLE_FIREFOX.test(raw) ? CONSOLE_CALL_SITE : frame;
     }
     return NO_CALL_SITE;
 }
@@ -88,6 +110,7 @@ function callSite(skip) {
     }
 }
 
+exports.CONSOLE_CALL_SITE = CONSOLE_CALL_SITE;
 exports.NO_CALL_SITE = NO_CALL_SITE;
 exports.callSite = callSite;
 exports.callSiteFromStack = callSiteFromStack;

package/dist/cjs/remotelog/gate.d.ts

@@ -1,11 +1,2 @@
-export declare function setAppLogger(on: boolean): void;
-export declare function appLoggerEnabled(): boolean;
-/** The SDK's own diagnostics may be recorded: `remote_log` is on and the logger is reachable. */
-export declare function remoteLogEnabled(): boolean;
-/** An app's own log line may be recorded: the app enabled the logger and it is reachable. */
-export declare function appLogEnabled(): boolean;
-/**
- * What is stored may be sent. Either writer is enough: app logging works with `remote_log`
- * off, since that switch covers only the SDK's own diagnostics.
- */
-export declare function remoteLogSendable(): boolean;
+/** Whether a remote log line may be recorded and sent now. */
+export declare function remoteLoggerReachable(): boolean;

package/dist/cjs/remotelog/gate.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.2 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 var state = require('../core/state.js');
@@ -6,21 +6,14 @@ var env = require('../core/env.js');
 var consent = require('../core/consent.js');
 
 /**
- * The one switch both halves of the remote logger ask: may this line be recorded, and may
- * what is stored be sent? It lives on its own so recording and sending don't import each other.
- */
-/** The app logger's switch: off until the app calls logger.enable(), as on Android and iOS. */
-let appLoggerOn = false;
-function setAppLogger(on) {
-    appLoggerOn = on;
-}
-function appLoggerEnabled() {
-    return appLoggerOn;
-}
-/**
- * What every remote-log line needs, whoever wrote it: a running SDK, a client we send anything
- * for, the server's remote logger switch, and consent.
+ * The one switch both halves of the remote logger ask: may this line be recorded, and may what is
+ * stored be sent? It lives on its own so recording and sending don't import each other.
+ *
+ * There is no switch of the app's own: a line the app writes with AppticsLogger is recorded,
+ * whenever the SDK is running, the server has the remote logger on for the app, and the visitor
+ * allows tracking.
  */
+/** Whether a remote log line may be recorded and sent now. */
 function remoteLoggerReachable() {
     if (!state._ZAP._token || env.is_apptics_disabled()) {
         return false;
@@ -31,24 +24,5 @@ function remoteLoggerReachable() {
     }
     return consent.shouldTrackOrSendData();
 }
-/** The SDK's own diagnostics may be recorded: `remote_log` is on and the logger is reachable. */
-function remoteLogEnabled() {
-    return state.getConfig('remote_log') && remoteLoggerReachable(); // no i18n
-}
-/** An app's own log line may be recorded: the app enabled the logger and it is reachable. */
-function appLogEnabled() {
-    return appLoggerOn && remoteLoggerReachable();
-}
-/**
- * What is stored may be sent. Either writer is enough: app logging works with `remote_log`
- * off, since that switch covers only the SDK's own diagnostics.
- */
-function remoteLogSendable() {
-    return (state.getConfig('remote_log') || appLoggerOn) && remoteLoggerReachable(); // no i18n
-}
 
-exports.appLogEnabled = appLogEnabled;
-exports.appLoggerEnabled = appLoggerEnabled;
-exports.remoteLogEnabled = remoteLogEnabled;
-exports.remoteLogSendable = remoteLogSendable;
-exports.setAppLogger = setAppLogger;
+exports.remoteLoggerReachable = remoteLoggerReachable;

package/dist/cjs/remotelog/index.d.ts

@@ -1,25 +1,8 @@
 /**
- * Remote logger: the SDK's own diagnostics, sent to console/addlog.
+ * Remote logger delivery: the AppticsLogger lines (logger.ts) are stored in the remotelogs queue
+ * and sent from it to log/add by send.ts. gate.ts holds the switch both ask.
  *
- * This file is not the app-facing logging API — that is logger.ts, which shares this queue and
- * delivery but has its own switch. This file answers "this app reports no data — what is the SDK
- * actually doing on the user's machine?", so what it carries is the SDK's own failures, each
- * tagged with the module that was mid-flight (Session, Screen, Event, API, Properties).
- * App errors belong to exception/error, an app's remote log lines to logger.ts, and lines meant
- * for a feedback report to feedback/logs.ts.
- *
- * This file records lines, send.ts delivers them, and gate.ts holds the switch both ask.
- * Nothing here is exported to apps: the SDK writes these lines itself, through logFailure()
- * in core/logger.ts.
- */
-import { AP_LOG_MODULE } from '../core/constants.js';
-import { type CallSite } from '../core/callsite.js';
-/** One of console/addlog's `module` values. */
-export type LogModule = (typeof AP_LOG_MODULE)[keyof typeof AP_LOG_MODULE];
-/**
- * Records one line about `module` for console/addlog. Never throws and never blocks the caller:
- * a diagnostics channel that breaks the flow it reports on would be worse than no channel.
+ * The SDK writes nothing of its own here: its failures go to the browser console (core/logger.ts,
+ * in debug mode), and only the lines an app logs reach the Remote Logger page.
  */
-export declare function remoteLog(module: LogModule, message: unknown, site?: CallSite): void;
-export { remoteLogEnabled } from './gate.js';
 export { forgetStoredLogs, sendStoredLogs } from './send.js';

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

@@ -7,22 +7,16 @@ export declare const LOG_LEVEL: Readonly<{
     ERROR: 5;
 }>;
 export interface AppticsLogger {
-    /** Starts recording log lines. Off until called. */
-    enable(): void;
-    /** Stops recording log lines. */
-    disable(): void;
-    /** Whether log lines are being recorded. */
-    isEnabled(): boolean;
-    /** Verbose, level 1. The tag leads the message as `[tag]`. */
-    v(tag: string, message: unknown, ...details: unknown[]): void;
-    /** Debug, level 2. */
-    d(tag: string, message: unknown, ...details: unknown[]): void;
-    /** Info, level 3. */
-    i(tag: string, message: unknown, ...details: unknown[]): void;
-    /** Warning, level 4. */
-    w(tag: string, message: unknown, ...details: unknown[]): void;
-    /** Error, level 5. */
-    e(tag: string, message: unknown, ...details: unknown[]): void;
+    /** Verbose, level 1 (Android's v). `properties` (an object, as JSON; an Error, as its stack) is appended to the message. */
+    verbose(message: unknown, properties?: unknown): void;
+    /** Debug, level 2 (Android's d). */
+    debug(message: unknown, properties?: unknown): void;
+    /** Info, level 3 (Android's i). */
+    info(message: unknown, properties?: unknown): void;
+    /** Warning, level 4 (Android's w). */
+    warn(message: unknown, properties?: unknown): void;
+    /** Error, level 5 (Android's e). */
+    error(message: unknown, properties?: unknown): void;
 }
-/** Android's AppticsLogger: enable, disable, isEnabled and v / d / i / w / e(tag, message). */
+/** AppticsLogger: verbose / debug / info / warn / error(message, properties?). */
 export declare const AppticsLogger: AppticsLogger;

package/dist/cjs/remotelog/logger.js

@@ -1,30 +1,26 @@
-/*! @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.2 | (c) Zoho Corporation Private Limited | see LICENSE */
 'use strict';
 
 var constants = require('../core/constants.js');
-var callsite = require('../core/callsite.js');
+var callsite = require('./callsite.js');
 var storage = require('../core/storage.js');
 var guard = require('../core/guard.js');
 var utils = require('../core/utils.js');
-var state = require('../core/state.js');
 var gate = require('./gate.js');
 var send = require('./send.js');
 
 /**
- * AppticsLogger, as on Android: lines the app writes, shown on the console's Remote Logger page.
+ * AppticsLogger: lines the app writes, shown on the console's Remote Logger page.
  *
- *   AppticsLogger.enable();
- *   AppticsLogger.i('Checkout', 'Payment started');
- *   AppticsLogger.e('Checkout', 'Payment failed', err);
+ *   AppticsLogger.info('Payment started');
+ *   AppticsLogger.error('Payment failed', err);
  *
- * It mirrors the native SDKs so the page reads the same whatever sent the line: off until
- * enable() (AppticsLogger.enable() on Android, APLog.setShouldLog on iOS), and five levels in
- * the iOS order — verbose, debug, info, warn, error — sent as 1 to 5, which is the scale the
- * Remote Logger page reads back.
+ * Nothing is logged on its own: only the lines the app writes, at five levels in the native SDKs'
+ * order (verbose, debug, info, warn, error, sent as 1 to 5, the scale the Remote Logger page reads
+ * back). A line is recorded as it is written, with no switch to turn on first, whenever the server
+ * has the remote logger on for the app and the visitor allows tracking.
  *
- * Lines share the SDK diagnostics' queue and its log/add delivery, so they are stored before
- * they are sent and survive a failed send and a reload. They are a separate switch, though:
- * `remote_log: false` silences the SDK's own failures, not the app's logging.
+ * Lines are stored before they are sent (send.ts), so they survive a failed send and a reload.
  */
 /** The level numbers log/add takes and the Remote Logger page names, in the native SDKs' order. */
 const LOG_LEVEL = Object.freeze({ VERBOSE: 1, DEBUG: 2, INFO: 3, WARN: 4, ERROR: 5 });
@@ -63,11 +59,12 @@ function describe(value) {
  * it — which is why the time and call site are taken by the caller, not here.
  */
 function record(level, message, details, at, site) {
-    if (!gate.appLogEnabled()) {
+    if (!gate.remoteLoggerReachable()) {
         return;
     }
     var text = [message].concat(details).map(describe).join(' '); // no i18n
-    storage.consolelog_transactions.add({
+    storage.remotelog_transactions.add({
+        type: 'remotelog', // no i18n
         module: functionName(site),
         level: level,
         happenedat: at,
@@ -79,60 +76,35 @@ function record(level, message, details, at, site) {
     send.scheduleSend();
 }
 const recordLine = guard.guard('AppticsLogger', record); // no i18n
-/** The browser console method each level prints with under `show_logs`, as Logcat shows them. */
-const CONSOLE_METHOD = Object.freeze({
-    1: 'debug', 2: 'debug', 3: 'info', 4: 'warn', 5: 'error', // no i18n
-});
 /**
- * `show_logs`: the line in the browser console too, as Android's showLogs prints to Logcat. For
- * the developer, so it prints whether or not the remote logger is enabled or allowed to record,
- * and the arguments go over untouched so the console can still expand an object or an Error.
+ * A level's method, `verbose/debug/info/warn/error(message, properties?)` (Android's v/d/i/w/e,
+ * without the tag, which the Remote Logger page does not use). The function, file and line are
+ * the caller's.
  */
-function show(level, args) {
-    if (state.getConfig('show_logs') !== true) {
-        return;
-    }
-    var method = CONSOLE_METHOD[level] || 'log'; // no i18n
-    if (typeof console !== 'undefined' && typeof console[method] === 'function') { // no i18n
-        console[method].apply(console, args);
-    }
-}
-/**
- * A level's Android-style method, `v/d/i/w/e(tag, message, ...details)`. The tag leads the
- * message as `[tag]`; the function, file and line are still the caller's, as with the long names.
- */
-function tagged(level) {
-    return function (tag, message, ...details) {
+function atLevel(level) {
+    return function log(message, properties) {
         try {
-            var label = tag === undefined || tag === null ? '' : String(tag).trim(); // no i18n
-            var parts = label === '' ? [message].concat(details) : ['[' + label + ']', message].concat(details); // no i18n
-            show(level, parts);
+            void properties;
+            // everything after the message is appended to it: properties, and anything else a caller
+            // passed (an Error as well, say), as before
+            var details = Array.prototype.slice.call(arguments, 1);
             // skip 1: this function's own frame, so the site is the app's line that logged
-            recordLine(level, parts[0], parts.slice(1), utils.nowMs(), callsite.callSite(1));
+            recordLine(level, message, details, utils.nowMs(), callsite.callSite(1));
         }
         catch (err) {
             // logging must never be the thing that breaks the app
         }
     };
 }
-/** Turns the app logger on, or off with `false`. Off by default. */
-function enable(on) {
-    gate.setAppLogger(on !== false);
-}
-/** Turns the app logger off, as AppticsLogger.disable() does; the same as enable(false). */
-function disable() {
-    gate.setAppLogger(false);
-}
-/** Android's AppticsLogger: enable, disable, isEnabled and v / d / i / w / e(tag, message). */
+/** AppticsLogger: verbose / debug / info / warn / error(message, properties?). */
 const AppticsLogger = {
-    enable: guard.guard('AppticsLogger.enable', function () { enable(true); }), // no i18n
-    disable: guard.guard('AppticsLogger.disable', disable), // no i18n
-    isEnabled: guard.guard('AppticsLogger.isEnabled', gate.appLoggerEnabled), // no i18n
-    v: tagged(LOG_LEVEL.VERBOSE),
-    d: tagged(LOG_LEVEL.DEBUG),
-    i: tagged(LOG_LEVEL.INFO),
-    w: tagged(LOG_LEVEL.WARN),
-    e: tagged(LOG_LEVEL.ERROR),
+    // not wrapped in a guard of their own: the call site is read a fixed number of frames up, and
+    // a frame more would report the SDK's own line instead of the app's
+    verbose: atLevel(LOG_LEVEL.VERBOSE),
+    debug: atLevel(LOG_LEVEL.DEBUG),
+    info: atLevel(LOG_LEVEL.INFO),
+    warn: atLevel(LOG_LEVEL.WARN),
+    error: atLevel(LOG_LEVEL.ERROR),
 };
 
 exports.AppticsLogger = AppticsLogger;