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

package/dist/esm/remoteconfig/index.js

@@ -0,0 +1,111 @@
+/*! @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';
+import { all } from './store.js';
+
+/**
+ * Remote config, shipped as its own entry point:
+ *   import { AppticsRemoteConfig } from '@zoho_apptics/apptics-js-sdk/remote-config';
+ *
+ * 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 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;
+}
+/** 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
+        try {
+            callback(value);
+        }
+        catch (err) {
+            Console.warn('AppticsRemoteConfig: the callback threw', err); // no i18n
+        }
+    }
+    return value;
+}
+/**
+ * One parameter, fetched for this page, as Android's fetchValue: resolves with its value, or null
+ * when the console has no such parameter. A failed fetch answers with the value fetched before.
+ */
+function fetchValue(name, callback) {
+    return obtain().then(function () {
+        var value = raw(name);
+        return answer(value === undefined ? null : value, callback);
+    });
+}
+/**
+ * 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(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 = {};
+        (wanted === null ? Object.keys(values) : wanted).forEach(function (name) {
+            var value = raw(name);
+            out[name] = value === undefined ? null : value;
+        });
+        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;
+}
+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: 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 condition, by the condition's name, as comma separated
+     * values: it matches when one of them is listed. An empty value removes it.
+     */
+    setCustomConditionValue: function setCustomConditionValue(conditionname, value) {
+        forward(setCustomConditionValueGuarded, arguments);
+    },
+};
+
+export { AppticsRemoteConfig, AppticsRemoteConfig as default };

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

@@ -0,0 +1,18 @@
+import type { Dict } from '../types.js';
+/** The flagtime to send: 0 until we hold a rule set, which asks the server for everything. */
+export declare function flagtime(): number;
+/** Re-resolves the stored rules against this device, without fetching. */
+export declare function reresolve(): void;
+/** Stores a rule set the server just sent, and resolves it. */
+export declare function store(rules: Dict, at: number): void;
+/**
+ * Records a fetch that brought no rule set.
+ *
+ * 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.
+ */
+export declare function storeUnchanged(at: number): void;
+/** Forgets the rule set and its values, so the next fetch asks with flagtime 0. */
+export declare function clearRemoteConfig(): void;
+/** Every parameter resolved for this device. Loads from storage on the first read. */
+export declare function all(): Record<string, string>;

package/dist/esm/remoteconfig/store.js

@@ -0,0 +1,91 @@
+/*! @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';
+
+/**
+ * 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.
+ *
+ * `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.
+ */
+const STORE_KEY = 'remoteconfig'; // no i18n
+var values = {};
+var loaded = false;
+function read() {
+    var saved = 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. */
+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 ? resolveAll(saved.rules) : {};
+    loaded = true;
+}
+/** Stores a rule set the server just sent, and resolves it. */
+function store(rules, at) {
+    resetEvaluationWarnings();
+    var record = { flagtime: publishedAt(rules) || at, rules: rules, fetchedat: at };
+    user_defaults.add(STORE_KEY, record);
+    values = resolveAll(rules);
+    loaded = true;
+    Console.log('AppticsRemoteConfig: ' + Object.keys(values).length + ' parameters, published ' + record.flagtime); // no i18n
+}
+/**
+ * Records a fetch that brought no rule set.
+ *
+ * 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.
+ */
+function storeUnchanged(at) {
+    var saved = read();
+    if (saved === null) {
+        return;
+    }
+    saved.fetchedat = at;
+    user_defaults.add(STORE_KEY, saved);
+}
+/** Forgets the rule set and its values, so the next fetch asks with flagtime 0. */
+function clearRemoteConfig() {
+    user_defaults.add(STORE_KEY, undefined);
+    values = {};
+    loaded = false;
+    resetEvaluationWarnings();
+}
+/** Every parameter resolved for this device. Loads from storage on the first read. */
+function all() {
+    if (!loaded) {
+        reresolve();
+    }
+    return values;
+}
+
+export { all, clearRemoteConfig, flagtime, reresolve, store, storeUnchanged };

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";

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

@@ -0,0 +1,11 @@
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+/**
+ * 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
+
+export { TZ_COUNTRIES };

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

@@ -0,0 +1,2 @@
+/** Whether a remote log line may be recorded and sent now. */
+export declare function remoteLoggerReachable(): boolean;

package/dist/esm/remotelog/gate.js

@@ -0,0 +1,26 @@
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+import { _ZAP } from '../core/state.js';
+import { is_apptics_disabled } from '../core/env.js';
+import { shouldTrackOrSendData } from '../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.
+ *
+ * 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 (!_ZAP._token || is_apptics_disabled()) {
+        return false;
+    }
+    // getsdkconfig module 17: the server can switch the remote logger off on its own
+    if (!_ZAP._remoteLoggerEnabled) {
+        return false;
+    }
+    return shouldTrackOrSendData();
+}
+
+export { remoteLoggerReachable };

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

@@ -0,0 +1,8 @@
+/**
+ * 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.
+ *
+ * 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 { forgetStoredLogs, sendStoredLogs } from './send.js';

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

@@ -0,0 +1,22 @@
+/** The level numbers log/add takes and the Remote Logger page names, in the native SDKs' order. */
+export declare const LOG_LEVEL: Readonly<{
+    VERBOSE: 1;
+    DEBUG: 2;
+    INFO: 3;
+    WARN: 4;
+    ERROR: 5;
+}>;
+export interface AppticsLogger {
+    /** 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;
+}
+/** AppticsLogger: verbose / debug / info / warn / error(message, properties?). */
+export declare const AppticsLogger: AppticsLogger;

package/dist/esm/remotelog/logger.js

@@ -0,0 +1,108 @@
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+import { LOG_FUNCTION_MAX } from '../core/constants.js';
+import { callSite } from '../core/callsite.js';
+import { remotelog_transactions } from '../core/storage.js';
+import { guard } from '../core/guard.js';
+import { nowMs } from '../core/utils.js';
+import { remoteLoggerReachable } from './gate.js';
+import { scheduleSend } from './send.js';
+
+/**
+ * AppticsLogger: lines the app writes, shown on the console's Remote Logger page.
+ *
+ *   AppticsLogger.info('Payment started');
+ *   AppticsLogger.error('Payment failed', err);
+ *
+ * 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 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 });
+/** What a line's `function` says when the caller had no name to give (an anonymous callback). */
+const ANONYMOUS_CALLER = 'App'; // no i18n
+/**
+ * The caller's name as logSDK's `function` accepts it: safe_string refuses angle brackets and an
+ * empty value, and the field stops at 100 characters.
+ */
+function functionName(site) {
+    var name = String(site.fn || '').replace(/<anonymous>/g, '').replace(/[<>]/g, '').trim(); // no i18n
+    if (name === '' || /^(Object|Module|eval)\.?$/.test(name)) {
+        return ANONYMOUS_CALLER;
+    }
+    return name.slice(0, LOG_FUNCTION_MAX);
+}
+/** One detail as text: an Error as its stack (which leads with name and message), JSON otherwise. */
+function describe(value) {
+    if (value instanceof Error) {
+        var head = value.name + ': ' + value.message; // no i18n
+        return value.stack && value.stack.indexOf(value.message) !== -1 ? value.stack : head;
+    }
+    if (typeof value === 'string') { // no i18n
+        return value;
+    }
+    try {
+        var json = JSON.stringify(value);
+        return json === undefined ? String(value) : json;
+    }
+    catch (err) {
+        return String(value);
+    }
+}
+/**
+ * Stores one line. Reached through guard(), so a line logged before start-up finishes waits for
+ * it — which is why the time and call site are taken by the caller, not here.
+ */
+function record(level, message, details, at, site) {
+    if (!remoteLoggerReachable()) {
+        return;
+    }
+    var text = [message].concat(details).map(describe).join(' '); // no i18n
+    remotelog_transactions.add({
+        type: 'remotelog', // no i18n
+        module: functionName(site),
+        level: level,
+        happenedat: at,
+        exceptionlog: text,
+        attempt: 1,
+        filename: site.filename,
+        linenumber: site.linenumber,
+    });
+    scheduleSend();
+}
+const recordLine = guard('AppticsLogger', record); // no i18n
+/**
+ * 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 atLevel(level) {
+    return function log(message, properties) {
+        try {
+            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, message, details, nowMs(), callSite(1));
+        }
+        catch (err) {
+            // logging must never be the thing that breaks the app
+        }
+    };
+}
+/** AppticsLogger: verbose / debug / info / warn / error(message, properties?). */
+const AppticsLogger = {
+    // 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),
+};
+
+export { AppticsLogger, LOG_LEVEL };

package/dist/esm/remotelog/send.d.ts

@@ -0,0 +1,13 @@
+/** Queues a pass over the stored lines, coalescing a burst into one. */
+export declare function scheduleSend(): void;
+/**
+ * Sends the stored lines as one batch. A batch the server refuses for its shape is dropped —
+ * retrying it could only fail the same way and would hold every later line behind it.
+ */
+export declare function sendStoredLogs(): Promise<void>;
+/**
+ * Sends what is stored as the page goes away, where a normal request would be cancelled.
+ * One keepalive request for the whole batch, which is what the endpoint now accepts. The lines
+ * stay stored until the server has confirmed them.
+ */
+export declare function forgetStoredLogs(): Promise<void>;

package/dist/esm/remotelog/send.js

@@ -0,0 +1,149 @@
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+import { LOG_FUNCTION_MAX, CONSOLE_LOG_MAX_BODY, REMOTE_LOG_LEVEL, LOG_FILENAME_MAX } from '../core/constants.js';
+import { _ZAP } from '../core/state.js';
+import { warnAlways, Console } from '../core/logger.js';
+import { nowMs, isEmpty } from '../core/utils.js';
+import { remotelog_transactions } from '../core/storage.js';
+import { postToApptics, apiHeaders, isPermanentRefusal, getMetaObj, postKeepalive } from '../core/transport.js';
+import { remoteLoggerReachable } from './gate.js';
+
+/**
+ * Delivery for the remote logger.
+ *
+ * v2 replaced console/addlog, which took one line per call and counted retries in an `attempt`
+ * param, with log/add, which takes a batch: `{ logs: [...], meta }`. A pass over the queue is now
+ * one request however many lines are waiting, so a burst of failures costs one call instead of
+ * twenty, and a line no longer has to carry its own retry bookkeeping — the batch either lands or
+ * stays for the next pass.
+ */
+/**
+ * What the stored lines may take up, as on Android (1 MB): past it the oldest are dropped, so a
+ * failing SDK or a chatty app can't fill storage. Measured in size rather than in lines, since one
+ * line can be a 10,000-character stack and another a word.
+ */
+const MAX_STORED_BYTES = 1024 * 1024;
+/** Sends are grouped, so one broken flow that logs twice makes one pass over the queue. */
+const SEND_DELAY_MS = 1000;
+/** The endpoint takes a 10 MB body; a batch is capped well inside that. */
+const MAX_PER_BATCH = 50;
+const LABEL = 'remoteLog'; // no i18n
+let sendScheduled = false;
+let sending = false;
+/**
+ * One stored line as logSDK wants it.
+ *
+ * `function` is where the module name goes — it is the only field describing *where* a line came
+ * from, and the template caps it at 100. `logmessage` is capped at 10000, so a long stack is
+ * trimmed rather than having the whole batch refused for one oversized line.
+ */
+function entryFor(item) {
+    var entry = {
+        sessionstarttime: _ZAP._current_session.starttime || item.happenedat || nowMs(),
+        logtime: item.happenedat || nowMs(),
+        // an app's line carries the level it was logged at; the SDK's own failures carry none
+        level: Number(item.level) || REMOTE_LOG_LEVEL,
+        logmessage: String(item.exceptionlog).slice(0, CONSOLE_LOG_MAX_BODY),
+        function: String(item.module || 'SDK').slice(0, LOG_FUNCTION_MAX), // no i18n
+        // the endpoint reads linenumber with getInt(), which throws on a missing key rather than
+        // defaulting, so it goes out on every line - 0 where the stack gave us no frame
+        linenumber: Number(item.linenumber) || 0,
+    };
+    // filename is read with optString and validated against file_name, whose pattern needs at
+    // least one character: sending '' would have the whole batch refused, so it is left out
+    if (!isEmpty(item.filename)) {
+        entry.filename = String(item.filename).slice(0, LOG_FILENAME_MAX);
+    }
+    return entry;
+}
+/** The batch body: `{ logs, meta }`, where meta is metaWebSDKV2 like every other v2 payload. */
+function bodyFor(items) {
+    return JSON.stringify({ logs: items.map(entryFor), meta: getMetaObj() }); // no i18n
+}
+/** Queues a pass over the stored lines, coalescing a burst into one. */
+function scheduleSend() {
+    if (sendScheduled) {
+        return;
+    }
+    sendScheduled = true;
+    setTimeout(function () {
+        sendScheduled = false;
+        sendStoredLogs();
+    }, SEND_DELAY_MS);
+}
+/** Drops the oldest lines once the queue is over MAX_STORED_BYTES, keeping the newest that fit. */
+function trim(items) {
+    var total = 0;
+    var keepFrom = items.length;
+    // newest first: they are the ones worth keeping
+    for (var i = items.length - 1; i >= 0; i--) {
+        total += JSON.stringify(items[i]).length;
+        if (total > MAX_STORED_BYTES) {
+            break;
+        }
+        keepFrom = i;
+    }
+    if (keepFrom === 0) {
+        return items;
+    }
+    remotelog_transactions.remove(items.slice(0, keepFrom));
+    return items.slice(keepFrom);
+}
+/**
+ * Sends the stored lines as one batch. A batch the server refuses for its shape is dropped —
+ * retrying it could only fail the same way and would hold every later line behind it.
+ */
+function sendStoredLogs() {
+    if (sending || !remoteLoggerReachable() || navigator.onLine === false) {
+        return Promise.resolve();
+    }
+    sending = true;
+    return remotelog_transactions.all().then(function (stored) {
+        var batch = trim(stored).slice(0, MAX_PER_BATCH);
+        if (batch.length === 0) {
+            return undefined;
+        }
+        return postToApptics('consolelog', bodyFor(batch), apiHeaders(), LABEL).then(function () {
+            return remotelog_transactions.remove(batch);
+        }, function (err) {
+            if (isPermanentRefusal(err)) {
+                warnAlways('apptics: the server refused these log lines, so they were dropped: ' + String(err && err.message)); // no i18n
+                return remotelog_transactions.remove(batch);
+            }
+            Console.log(LABEL + ': ' + String(err)); // no i18n
+            return undefined;
+        });
+    }).then(function () {
+        sending = false;
+    }).catch(function () {
+        sending = false;
+    });
+}
+/**
+ * Sends what is stored as the page goes away, where a normal request would be cancelled.
+ * One keepalive request for the whole batch, which is what the endpoint now accepts. The lines
+ * stay stored until the server has confirmed them.
+ */
+function forgetStoredLogs() {
+    if (!remoteLoggerReachable()) {
+        return Promise.resolve();
+    }
+    return remotelog_transactions.all().then(function (stored) {
+        if (stored.length === 0) {
+            return undefined;
+        }
+        var batch = stored.slice(0, MAX_PER_BATCH);
+        // removed once the server has them; lines whose answer never comes go on the next visit
+        postKeepalive('consolelog', bodyFor(batch), apiHeaders(), LABEL).then(function () {
+            return remotelog_transactions.remove(batch);
+        }, function (err) {
+            if (isPermanentRefusal(err)) {
+                return remotelog_transactions.remove(batch);
+            }
+            Console.log(LABEL + ': ' + String(err)); // no i18n
+            return undefined;
+        });
+        return undefined;
+    });
+}
+
+export { forgetStoredLogs, scheduleSend, sendStoredLogs };

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

@@ -0,0 +1,12 @@
+/**
+ * The app logger, shipped as its own entry point:
+ *   import { AppticsLogger } from '@zoho_apptics/apptics-js-sdk/remote-logger';
+ *
+ * AppticsLogger: verbose / debug / info / warn / error(message, props?), shown on the
+ * console's Remote Logger page. A line is recorded as it is written, with no switch to turn on.
+ * Apps that don't import it don't ship it.
+ */
+import { AppticsLogger } from '../remotelog/logger.js';
+export { AppticsLogger };
+export type { AppticsLogger as AppticsLoggerApi } from '../remotelog/logger.js';
+export default AppticsLogger;

package/dist/esm/remotelogger/index.js

@@ -0,0 +1,13 @@
+/*! @zoho_apptics/apptics-js-sdk v2.0.0-beta.1 | (c) Zoho Corporation Private Limited | see LICENSE */
+import { AppticsLogger } from '../remotelog/logger.js';
+
+/**
+ * The app logger, shipped as its own entry point:
+ *   import { AppticsLogger } from '@zoho_apptics/apptics-js-sdk/remote-logger';
+ *
+ * AppticsLogger: verbose / debug / info / warn / error(message, props?), shown on the
+ * console's Remote Logger page. A line is recorded as it is written, with no switch to turn on.
+ * Apps that don't import it don't ship it.
+ */
+
+export { AppticsLogger, AppticsLogger as default };

package/dist/esm/scheduler.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sends everything queued now. With `forget`, the requests are sent without waiting for a
+ * response (page hide), so they survive the page going away.
+ */
+export declare function flush(forget?: boolean): Promise<void>;
+/** Starts the flush and getupdates intervals once; later calls do nothing until stopTimers(). */
+export declare function startTimers(): void;
+export declare function stopTimers(): void;