@monterosa/sdk-launcher-kit 0.18.9 → 0.18.10

package/dist/index.esm5.js

@@ -1,4 +1,4 @@
-import { Logger, Sdk, getSdk, LogLevel } from '@monterosa/sdk-core';
+import { Logger, getSdk, LogLevel, Sdk } from '@monterosa/sdk-core';
 import { createError, getGlobal, Emitter, getErrorMessage, subscribe, delay, throttle } from '@monterosa/sdk-util';
 import { v4 } from 'uuid';
 import { fetchListings } from '@monterosa/sdk-interact-interop';
@@ -161,6 +161,10 @@ var Action;
      * Notifies child Experience about the request to load more data
      */
     Action["OnMoreDataRequested"] = "onMoreDataRequested";
+    /**
+     * Notifies about a share request
+     */
+    Action["OnShare"] = "onShare";
 })(Action || (Action = {}));
 /**
  * @internal
@@ -230,7 +234,7 @@ var QueryParam;
  *
  * More details on the license can be found at https://www.monterosa.co/sdk/license
  */
-var _a$2;
+var _a$3;
 /**
  * Defines a set of error codes that may be encountered when using the
  * Launcher Kit bridge
@@ -269,14 +273,14 @@ var BridgeError;
      */
     BridgeError["RequestTimeoutError"] = "request_timeout_error";
 })(BridgeError || (BridgeError = {}));
-var BridgeErrorMessages = (_a$2 = {},
-    _a$2[BridgeError.InvalidRequestTimeoutError] = function () {
+var BridgeErrorMessages = (_a$3 = {},
+    _a$3[BridgeError.InvalidRequestTimeoutError] = function () {
         return 'Request timeout must be greater than 0';
     },
-    _a$2[BridgeError.RequestTimeoutError] = function (action, timeout) {
+    _a$3[BridgeError.RequestTimeoutError] = function (action, timeout) {
         return "Request timeout: action \"" + action + "\" did not receive a response within " + timeout + "ms";
     },
-    _a$2);
+    _a$3);
 
 /**
  * @license
@@ -346,7 +350,7 @@ function isMessage(message) {
  *
  * More details on the license can be found at https://www.monterosa.co/sdk/license
  */
-var _a$1, _b$1, _c$1, _d$1;
+var _a$2, _b$1, _c$1, _d$1;
 var _e, _f, _g;
 var globals$2 = getGlobal();
 var receiveMessage = function (message) {
@@ -378,7 +382,7 @@ function handleWindowMessage(_a) {
  */
 // The Monterosa SDK namespace may already exist, either because it was created
 // by a native SDK or by another web app using the JS SDK from the same scope.
-(_a$1 = globals$2.monterosaSdk) !== null && _a$1 !== void 0 ? _a$1 : (globals$2.monterosaSdk = {
+(_a$2 = globals$2.monterosaSdk) !== null && _a$2 !== void 0 ? _a$2 : (globals$2.monterosaSdk = {
     initialised: false,
     emitter: new Emitter(),
     receiveMessage: receiveMessage,
@@ -407,13 +411,13 @@ if (!globals$2.monterosaSdk.initialised) {
  *
  * More details on the license can be found at https://www.monterosa.co/sdk/license
  */
-var _a, _b, _c, _d;
+var _a$1, _b, _c, _d;
 var globals$1 = getGlobal();
 /**
  * @internal
  */
 var IFRAME_ID_PREFIX = 'micBridge';
-var IS_IOS = !!((_c = (_b = (_a = globals$1.webkit) === null || _a === void 0 ? void 0 : _a.messageHandlers) === null || _b === void 0 ? void 0 : _b.monterosaSdk) === null || _c === void 0 ? void 0 : _c.postMessage);
+var IS_IOS = !!((_c = (_b = (_a$1 = globals$1.webkit) === null || _a$1 === void 0 ? void 0 : _a$1.messageHandlers) === null || _b === void 0 ? void 0 : _b.monterosaSdk) === null || _c === void 0 ? void 0 : _c.postMessage);
 var IS_ANDROID = !!((_d = globals$1.monterosaSdk) === null || _d === void 0 ? void 0 : _d.postMessage);
 var IS_WEB = globals$1.self !== globals$1.parent;
 /**
@@ -1055,7 +1059,7 @@ function unstashStyles(element) {
     element.removeAttribute('data-stash');
 }
 
-var version = "0.18.9";
+var version = "0.18.10";
 
 /**
  * @license
@@ -1563,5 +1567,158 @@ function reportExperienceSizeChanges(element) {
     return function () { return observer.unobserve(element); };
 }
 
-export { Action, VERSION$1 as BRIDGE_VERSION, BridgeError, BridgeImpl, ExperienceImpl, ParentApplicationImpl, QueryParam, Source, VERSION, embed, enableLogging, getBridge, getExperience, getParentApplication, getParentBridge, isAutoresizesHeight, onMessage, onMoreDataRequested, onReady, onSdkMessage, registerEmbedHook, reportExperienceSizeChanges, requestMoreData, respondToMessage, respondToSdkMessage, sendExperienceSize, sendExperienceSizeThrottled, sendFinishedLoadingUI, sendMessage, sendReady, sendRequest, sendSdkMessage, sendSdkRequest, setRequestTimeout, shouldHideHeaderAndFooter, unmount };
+/**
+ * @license
+ * share.ts
+ * launcher-kit
+ *
+ * Copyright © 2026 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+var _a;
+/**
+ * Share requests block on the native share tray which waits for user
+ * interaction (composing a message, picking a target app, etc.). The default
+ * bridge timeout of 20 seconds is too short for this. 5 minutes gives users
+ * ample time while still acting as a safety net against lost messages.
+ */
+var SHARE_REQUEST_TIMEOUT = 300000;
+var ShareError;
+(function (ShareError) {
+    ShareError["ParentAppError"] = "parent_app_error";
+    ShareError["ShareFailed"] = "share_failed";
+})(ShareError || (ShareError = {}));
+var ShareErrorMessages = (_a = {},
+    _a[ShareError.ParentAppError] = function (error) {
+        return "Parent application error: " + error;
+    },
+    _a[ShareError.ShareFailed] = function (error) { return "Share failed: " + error; },
+    _a);
+/**
+ * Executes share using the Web Share API.
+ *
+ * @internal
+ */
+function executeShare(data) {
+    return __awaiter(this, void 0, void 0, function () {
+        var err_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    _a.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, navigator.share({
+                            url: data.url,
+                            title: data.title,
+                            text: data.description,
+                        })];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/, 'success'];
+                case 2:
+                    err_1 = _a.sent();
+                    if (err_1 instanceof DOMException && err_1.name === 'AbortError') {
+                        return [2 /*return*/, 'cancelled'];
+                    }
+                    throw createError(ShareError.ShareFailed, ShareErrorMessages, getErrorMessage(err_1));
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Initiates a share action. When running inside a parent application,
+ * the share request is sent to the parent via the communication bridge.
+ * When running standalone, `navigator.share()` is called directly.
+ *
+ * @param data - The data to share
+ */
+function share(data) {
+    return __awaiter(this, void 0, void 0, function () {
+        var parentApp, response;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    parentApp = getParentApplication();
+                    if (!(parentApp !== null)) return [3 /*break*/, 2];
+                    return [4 /*yield*/, sendSdkRequest(parentApp, Action.OnShare, data, SHARE_REQUEST_TIMEOUT)];
+                case 1:
+                    response = _a.sent();
+                    if (response.payload.result === 'failure') {
+                        throw createError(ShareError.ParentAppError, ShareErrorMessages, response.payload.message);
+                    }
+                    // 'success' and 'cancelled' both resolve silently
+                    return [2 /*return*/];
+                case 2: return [4 /*yield*/, executeShare(data)];
+                case 3:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Registers a callback to be called when a share request is received
+ * from a child Experience.
+ *
+ * @param experience - The Experience instance to listen on
+ * @param callback - Called with ShareData when a share request is received
+ * @returns Unsubscribe function
+ */
+function onShare(experience, callback) {
+    return onSdkMessage(experience, function (message) {
+        if (message.action === Action.OnShare) {
+            callback(message.payload);
+        }
+    });
+}
+function onExperienceEmbed(experience) {
+    var _this = this;
+    return onSdkMessage(experience, function (message) { return __awaiter(_this, void 0, void 0, function () {
+        var parentApp, payload, response, result, err_2;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (message.action !== Action.OnShare) {
+                        return [2 /*return*/];
+                    }
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 6, , 7]);
+                    parentApp = getParentApplication();
+                    payload = void 0;
+                    if (!(parentApp !== null)) return [3 /*break*/, 3];
+                    return [4 /*yield*/, sendSdkRequest(parentApp, Action.OnShare, message.payload, SHARE_REQUEST_TIMEOUT)];
+                case 2:
+                    response = _a.sent();
+                    payload = response.payload;
+                    return [3 /*break*/, 5];
+                case 3: return [4 /*yield*/, executeShare(message.payload)];
+                case 4:
+                    result = _a.sent();
+                    payload = {
+                        result: result,
+                        message: result === 'success' ? 'Share successful' : 'Share cancelled',
+                        data: {},
+                    };
+                    _a.label = 5;
+                case 5:
+                    respondToSdkMessage(experience, message, payload);
+                    return [3 /*break*/, 7];
+                case 6:
+                    err_2 = _a.sent();
+                    respondToSdkMessage(experience, message, {
+                        result: 'failure',
+                        message: getErrorMessage(err_2),
+                        data: {},
+                    });
+                    return [3 /*break*/, 7];
+                case 7: return [2 /*return*/];
+            }
+        });
+    }); });
+}
+registerEmbedHook(onExperienceEmbed);
+
+export { Action, VERSION$1 as BRIDGE_VERSION, BridgeError, BridgeImpl, ExperienceImpl, ParentApplicationImpl, QueryParam, ShareError, ShareErrorMessages, Source, VERSION, embed, enableLogging, executeShare, getBridge, getExperience, getParentApplication, getParentBridge, isAutoresizesHeight, onMessage, onMoreDataRequested, onReady, onSdkMessage, onShare, registerEmbedHook, reportExperienceSizeChanges, requestMoreData, respondToMessage, respondToSdkMessage, sendExperienceSize, sendExperienceSizeThrottled, sendFinishedLoadingUI, sendMessage, sendReady, sendRequest, sendSdkMessage, sendSdkRequest, setRequestTimeout, share, shouldHideHeaderAndFooter, unmount };
 //# sourceMappingURL=index.esm5.js.map