web-launch-kit 0.0.5 → 0.0.6

package/dist/launch-kit.mjs

@@ -1,4 +1,4 @@
-var version$3 = "0.0.5";
+var version$3 = "0.0.6";
 var packageJSON$3 = {
 	version: version$3};
 
@@ -1894,6 +1894,7 @@ 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 + ']';
@@ -2110,7 +2111,8 @@ function resolveFocusEventConfig() {
         };
     }
 }
-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;
@@ -2148,6 +2150,8 @@ function openURL(tried, url, timeout) {
                 }
             }
         }
+        if (terminal)
+            return;
         try {
             iframe = createHiddenElement('iframe');
             iframe.src = url;
@@ -2166,6 +2170,17 @@ function openURL(tried, url, timeout) {
         catch (_) {
         }
     }
+    if (terminal) {
+        return new Promise(function (resolve, reject) {
+            try {
+                open();
+                resolve();
+            }
+            catch (_) {
+                reject();
+            }
+        });
+    }
     return new Promise(function (resolve, reject) {
         if (DEBUG)
             debugger;
@@ -2247,11 +2262,78 @@ function openURL(tried, url, timeout) {
         }
     });
 }
+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;
@@ -2681,7 +2763,7 @@ function resolveFile(module) {
                     done(true);
                 else
                     done(false);
-            }, 1000);
+            }, CANCEL_DELAY);
         }
         function onvisibilitychange() {
             if (!isDocumentHidden())
@@ -2813,6 +2895,8 @@ var LaunchKit = {
     },
     app: function (options) {
         if (options === void 0) { options = {}; }
+        if (APP_IN_FLIGHT !== null)
+            return APP_IN_FLIGHT;
         var resolved;
         try {
             resolved = resolveOptions(options);
@@ -2823,39 +2907,15 @@ var LaunchKit = {
         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 = {}; }
@@ -2905,7 +2965,7 @@ var LaunchKit = {
     map: function (options) {
         if (options === void 0) { options = {}; }
         var params = [];
-        var urls = [];
+        var candidates = [];
         var url = '';
         switch (PlatformKit.os.name) {
             case 'android':
@@ -2923,7 +2983,7 @@ var LaunchKit = {
                     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':
@@ -2943,7 +3003,7 @@ var LaunchKit = {
                 }
                 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') {
@@ -2959,10 +3019,10 @@ var LaunchKit = {
                 }
                 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'];
@@ -2970,7 +3030,7 @@ var LaunchKit = {
                 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')
@@ -2979,34 +3039,10 @@ var LaunchKit = {
                     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 = {}; }