web-launch-kit 0.0.5 → 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.5";
+  var version$3 = "0.0.6";
   var packageJSON$3 = {
   	version: version$3};
 
@@ -1900,6 +1900,7 @@
   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 + ']';
@@ -2116,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;
@@ -2154,6 +2156,8 @@
                   }
               }
           }
+          if (terminal)
+              return;
           try {
               iframe = createHiddenElement('iframe');
               iframe.src = url;
@@ -2172,6 +2176,17 @@
           catch (_) {
           }
       }
+      if (terminal) {
+          return new Promise(function (resolve, reject) {
+              try {
+                  open();
+                  resolve();
+              }
+              catch (_) {
+                  reject();
+              }
+          });
+      }
       return new Promise(function (resolve, reject) {
           if (DEBUG)
               debugger;
@@ -2253,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;
@@ -2687,7 +2769,7 @@
                       done(true);
                   else
                       done(false);
-              }, 1000);
+              }, CANCEL_DELAY);
           }
           function onvisibilitychange() {
               if (!isDocumentHidden())
@@ -2819,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);
@@ -2829,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 = {}; }
@@ -2911,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':
@@ -2929,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':
@@ -2949,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') {
@@ -2965,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'];
@@ -2976,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')
@@ -2985,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 = {}; }