web-launch-kit 0.0.4 → 0.0.6

package/dist/launch-kit.umd.js

@@ -4,7 +4,7 @@
   (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.LaunchKit = {}));
 })(this, (function (exports) { 'use strict';
 
-  var version$3 = "0.0.4";
+  var version$3 = "0.0.6";
   var packageJSON$3 = {
   	version: version$3};
 
@@ -264,7 +264,7 @@
           return true;
       if (/\belectron\//i.test(currentUserAgent))
           return true;
-      if (/(?:iphone|ipad|ipod)/i.test(currentUserAgent) && /applewebkit/i.test(currentUserAgent) && /safari/i.test(currentUserAgent) === false)
+      if (/iphone|ipad|ipod/i.test(currentUserAgent) && /applewebkit/i.test(currentUserAgent) && /safari/i.test(currentUserAgent) === false)
           return true;
       return parseInAppBrowser() !== null;
   }
@@ -494,7 +494,7 @@
       return {};
   }
 
-  var version$1 = "0.0.1";
+  var version$1 = "0.0.3";
   var packageJSON$1 = {
   	version: version$1};
 
@@ -944,8 +944,6 @@
   var LISTENER_STORE = [];
   var NOOP = function () {
   };
-  // Records live on the target itself, so they are collected with it and lookups only scan
-  // that target's own listeners. Targets that reject the expando fall back to LISTENER_STORE.
   var STORE_KEY = '__webEventKitListeners__';
   function resolveBucket(target, create) {
       var holder = target;
@@ -1003,9 +1001,6 @@
       if (typeof callback === 'object' && callback !== null && typeof callback.handleEvent === 'function')
           return callback.handleEvent(event);
   }
-  // The same Event object is handed to every listener, so any property this kit overrides has
-  // to be put back before the next one runs — otherwise a `pointerdown` listener would observe
-  // the `touchstart` type and synthetic touches written by a listener registered before it.
   function patchEventProperty(event, property, value, patches) {
       var holder = event;
       var had = false;
@@ -1171,8 +1166,6 @@
               return NOOP;
           var normalized = normalizeListenerOptions(options);
           var existing = findListenerRecord(target, type, callback, normalized.capture);
-          // Native `addEventListener` ignores a duplicate registration, so hand back a releaser
-          // that does nothing rather than one that would detach the first caller's listener.
           if (typeof existing !== 'undefined')
               return NOOP;
           if (typeof normalized.signal !== 'undefined' && normalized.signal.aborted)
@@ -1202,8 +1195,6 @@
               record.onAbort = function () {
                   releaseListenerRecord(record);
               };
-              // Engines without listener-options coerce `{once: true}` to capture, which would then
-              // fail to match on removal; releaseListenerRecord detaches this anyway.
               record.signal.addEventListener('abort', record.onAbort, false);
           }
           return function () {
@@ -1908,6 +1899,8 @@
   var GLOBAL = getGlobal$1();
   var NAVIGATOR = GLOBAL.navigator;
   var CLEANUP_INPUT_ELEMENT = null;
+  var DEBUG = false;
+  var APP_IN_FLIGHT = null;
   function createTypeGuard(tag) {
       return function (value) {
           return Object.prototype.toString.call(value) === '[object ' + tag + ']';
@@ -2124,7 +2117,8 @@
           };
       }
   }
-  function openURL(tried, url, timeout) {
+  function openURL(tried, url, timeout, terminal) {
+      if (terminal === void 0) { terminal = false; }
       var config = resolveFocusEventConfig();
       var top = getTopmostWindow();
       var topDocument = top.document;
@@ -2162,6 +2156,8 @@
                   }
               }
           }
+          if (terminal)
+              return;
           try {
               iframe = createHiddenElement('iframe');
               iframe.src = url;
@@ -2180,8 +2176,20 @@
           catch (_) {
           }
       }
+      if (terminal) {
+          return new Promise(function (resolve, reject) {
+              try {
+                  open();
+                  resolve();
+              }
+              catch (_) {
+                  reject();
+              }
+          });
+      }
       return new Promise(function (resolve, reject) {
-          debugger;
+          if (DEBUG)
+              debugger;
           var timeoutId;
           var resolved = false;
           function cleanup() {
@@ -2260,11 +2268,78 @@
           }
       });
   }
+  var FUNCTION_FALLBACK_LABEL = '[function fallback]';
+  var CANCEL_DELAY = 1000;
+  function createLaunchError(code, message, attempted) {
+      var error = new Error(message);
+      var holder = error;
+      holder['code'] = code;
+      holder['attempted'] = attempted;
+      return error;
+  }
+  function isWebURL(url) {
+      return /^https?:\/\//i.test(url);
+  }
+  function isTerminalCandidate(by, url) {
+      return (by === 'fallback' || by === 'store') && isWebURL(url);
+  }
+  function notifyAttempt(onAttempt, attempt) {
+      if (typeof onAttempt !== 'function')
+          return;
+      try {
+          onAttempt(attempt);
+      }
+      catch (_) {
+      }
+  }
+  function describeAttempts(attempted) {
+      var routes = [];
+      for (var i = 0; i < attempted.length; i++)
+          routes.push(attempted[i].by);
+      return ' ' + attempted.length + ' candidate(s) attempted (' + joining(routes, undefined, ' \u2b62 ') + '). Read error.attempted for the URLs.';
+  }
+  function runCandidates(candidates, timeout, onAttempt, failure) {
+      return new Promise(function (resolve, reject) {
+          var attempted = [];
+          var total = candidates.length;
+          function step(index) {
+              if (index >= total)
+                  return reject(createLaunchError('all-failed', failure + describeAttempts(attempted), attempted));
+              var by = candidates[index][0];
+              var url = candidates[index][1];
+              var attempt = {
+                  by: by,
+                  url: typeof url === 'string' ? url : FUNCTION_FALLBACK_LABEL,
+                  index: index,
+                  total: total,
+              };
+              attempted.push(attempt);
+              notifyAttempt(onAttempt, attempt);
+              if (typeof url !== 'string') {
+                  try {
+                      url();
+                  }
+                  catch (_) {
+                      return step(index + 1);
+                  }
+                  return resolve(by);
+              }
+              openURL(index, url, timeout, isTerminalCandidate(by, url))
+                  .then(function () {
+                  resolve(by);
+              })
+                  .catch(function () {
+                  step(index + 1);
+              });
+          }
+          step(0);
+      });
+  }
   function resolveOptions(option) {
       var resolved = [];
       var os = PlatformKit.os.name;
       if (os === 'unknown')
-          throw new Error('Cannot resolve app open options: unsupported or undetected OS. (userAgent: "' + PlatformKit.userAgent + '")');
+          throw createLaunchError('unsupported-os', 'Cannot resolve app open options: unsupported or undetected OS. (userAgent: "' + PlatformKit.userAgent + '")', []);
       var scheme;
       var fallback;
       var allowAppStore;
@@ -2694,7 +2769,7 @@
                       done(true);
                   else
                       done(false);
-              }, 1000);
+              }, CANCEL_DELAY);
           }
           function onvisibilitychange() {
               if (!isDocumentHidden())
@@ -2805,6 +2880,12 @@
   var LaunchKit = {
       SettingType: exports.SettingType,
       version: packageJSON$3.version,
+      get debug() {
+          return DEBUG;
+      },
+      set debug(value) {
+          DEBUG = value === true;
+      },
       utils: {
           get canOpenIntent() {
               return canOpenIntent();
@@ -2820,6 +2901,8 @@
       },
       app: function (options) {
           if (options === void 0) { options = {}; }
+          if (APP_IN_FLIGHT !== null)
+              return APP_IN_FLIGHT;
           var resolved;
           try {
               resolved = resolveOptions(options);
@@ -2830,39 +2913,15 @@
           var urls = resolved[0];
           var timeout = resolved[1];
           if (urls.length === 0)
-              return Promise.reject(new Error('No openable URL candidates were resolved for the current OS ("' + PlatformKit.os.name + '"). Provide at least one of: scheme, intent, universal, fallback, or store id for this platform.'));
-          return new Promise(function (resolve, reject) {
-              var tried = [];
-              function openURLSequential(index) {
-                  if (index === void 0) { index = 0; }
-                  if (index >= urls.length)
-                      return reject(new Error('Failed to open the application using all available URLs.\n\n' + 'Attempted URLs:\n' + joining(tried, undefined, '\n↓\n')));
-                  var entry = urls[index];
-                  var by = entry[0];
-                  var url = entry[1];
-                  if (typeof url === 'string') {
-                      tried[index] = url;
-                      return openURL(index, url, timeout)
-                          .then(function () {
-                          resolve(by);
-                      })
-                          .catch(function () {
-                          openURLSequential(index + 1);
-                      });
-                  }
-                  else {
-                      tried[index] = '[function fallback]';
-                      try {
-                          url();
-                      }
-                      catch (_) {
-                          return openURLSequential(index + 1);
-                      }
-                      resolve(by);
-                  }
-              }
-              return openURLSequential();
-          });
+              return Promise.reject(createLaunchError('no-candidates', 'No openable URL candidates were resolved for the current OS ("' + PlatformKit.os.name + '"). Provide at least one of: scheme, intent, universal, fallback, or store id for this platform.', []));
+          var attempt = runCandidates(urls, timeout, options.onAttempt, 'Failed to open the application.');
+          function release() {
+              if (APP_IN_FLIGHT === attempt)
+                  APP_IN_FLIGHT = null;
+          }
+          APP_IN_FLIGHT = attempt;
+          attempt.then(release, release);
+          return attempt;
       },
       telephone: function (options) {
           if (options === void 0) { options = {}; }
@@ -2912,7 +2971,7 @@
       map: function (options) {
           if (options === void 0) { options = {}; }
           var params = [];
-          var urls = [];
+          var candidates = [];
           var url = '';
           switch (PlatformKit.os.name) {
               case 'android':
@@ -2930,7 +2989,7 @@
                       params.push('z=' + options.zoom);
                   if (params.length > 0)
                       url = url + '?' + joining(params, undefined, '&');
-                  urls.push(url);
+                  candidates.push(['scheme', url]);
                   break;
               case 'ios':
               case 'macos':
@@ -2950,7 +3009,7 @@
                   }
                   if (typeof options.zoom !== 'undefined')
                       params.push('z=' + options.zoom);
-                  urls.push('maps://?' + joining(params, undefined, '&'));
+                  candidates.push(['scheme', 'maps://?' + joining(params, undefined, '&')]);
                   break;
               case 'windows':
                   if (typeof options.directions !== 'undefined') {
@@ -2966,10 +3025,10 @@
                   }
                   if (typeof options.zoom !== 'undefined')
                       params.push('lvl=' + options.zoom);
-                  urls.push('bingmaps:?' + joining(params, undefined, '&'));
+                  candidates.push(['scheme', 'bingmaps:?' + joining(params, undefined, '&')]);
           }
           if (typeof options.fallback !== 'undefined') {
-              urls.push(stripURL(options.fallback));
+              candidates.push(['fallback', stripURL(options.fallback)]);
           }
           else {
               var params_1 = ['api=1'];
@@ -2977,7 +3036,7 @@
                   params_1.push('destination=' + encodeMapValue(options.directions.destination));
                   if (typeof options.directions.origin !== 'undefined')
                       params_1.push('origin=' + encodeMapValue(options.directions.origin));
-                  urls.push('https://www.google.com/maps/dir/?' + joining(params_1, undefined, '&'));
+                  candidates.push(['fallback', 'https://www.google.com/maps/dir/?' + joining(params_1, undefined, '&')]);
               }
               else {
                   if (typeof options.coordinate !== 'undefined')
@@ -2986,34 +3045,10 @@
                       params_1.push('query=' + escapeURIComponentString(options.query));
                   if (typeof options.zoom !== 'undefined')
                       params_1.push('zoom=' + options.zoom);
-                  urls.push('https://www.google.com/maps/search/?' + joining(params_1, undefined, '&'));
+                  candidates.push(['fallback', 'https://www.google.com/maps/search/?' + joining(params_1, undefined, '&')]);
               }
           }
-          return new Promise(function (resolve, reject) {
-              var tried = [];
-              function openURLSequential(index) {
-                  if (index === void 0) { index = 0; }
-                  if (index >= urls.length)
-                      return reject(new Error('Failed to open a map using all available URLs.\n\nAttempted URLs:\n' + joining(tried, undefined, '\n↓\n')));
-                  var url = urls[index];
-                  if (typeof url === 'string') {
-                      tried[index] = url;
-                      return openURL(index, url, getDefaultTimeout())
-                          .then(function () {
-                          resolve();
-                      })
-                          .catch(function () {
-                          openURLSequential(index + 1);
-                      });
-                  }
-                  else {
-                      tried[index] = '[function fallback]';
-                      url();
-                      resolve();
-                  }
-              }
-              return openURLSequential();
-          });
+          return runCandidates(candidates, getDefaultTimeout(), options.onAttempt, 'Failed to open a map.');
       },
       filepicker: function (options) {
           if (options === void 0) { options = {}; }