@monterosa/sdk-launcher-kit 0.18.9 → 0.18.10

package/dist/index.cjs.js

@@ -165,6 +165,10 @@ exports.Action = void 0;
      * Notifies child Experience about the request to load more data
      */
     Action["OnMoreDataRequested"] = "onMoreDataRequested";
+    /**
+     * Notifies about a share request
+     */
+    Action["OnShare"] = "onShare";
 })(exports.Action || (exports.Action = {}));
 /**
  * @internal
@@ -234,7 +238,7 @@ exports.QueryParam = void 0;
  *
  * 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
@@ -273,14 +277,14 @@ exports.BridgeError = void 0;
      */
     BridgeError["RequestTimeoutError"] = "request_timeout_error";
 })(exports.BridgeError || (exports.BridgeError = {}));
-var BridgeErrorMessages = (_a$2 = {},
-    _a$2[exports.BridgeError.InvalidRequestTimeoutError] = function () {
+var BridgeErrorMessages = (_a$3 = {},
+    _a$3[exports.BridgeError.InvalidRequestTimeoutError] = function () {
         return 'Request timeout must be greater than 0';
     },
-    _a$2[exports.BridgeError.RequestTimeoutError] = function (action, timeout) {
+    _a$3[exports.BridgeError.RequestTimeoutError] = function (action, timeout) {
         return "Request timeout: action \"" + action + "\" did not receive a response within " + timeout + "ms";
     },
-    _a$2);
+    _a$3);
 
 /**
  * @license
@@ -350,7 +354,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 = sdkUtil.getGlobal();
 var receiveMessage = function (message) {
@@ -382,7 +386,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 sdkUtil.Emitter(),
     receiveMessage: receiveMessage,
@@ -411,13 +415,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 = sdkUtil.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;
 /**
@@ -1059,7 +1063,7 @@ function unstashStyles(element) {
     element.removeAttribute('data-stash');
 }
 
-var version = "0.18.9";
+var version = "0.18.10";
 
 /**
  * @license
@@ -1567,13 +1571,168 @@ function reportExperienceSizeChanges(element) {
     return function () { return observer.unobserve(element); };
 }
 
+/**
+ * @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;
+exports.ShareError = void 0;
+(function (ShareError) {
+    ShareError["ParentAppError"] = "parent_app_error";
+    ShareError["ShareFailed"] = "share_failed";
+})(exports.ShareError || (exports.ShareError = {}));
+var ShareErrorMessages = (_a = {},
+    _a[exports.ShareError.ParentAppError] = function (error) {
+        return "Parent application error: " + error;
+    },
+    _a[exports.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 sdkUtil.createError(exports.ShareError.ShareFailed, ShareErrorMessages, sdkUtil.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, exports.Action.OnShare, data, SHARE_REQUEST_TIMEOUT)];
+                case 1:
+                    response = _a.sent();
+                    if (response.payload.result === 'failure') {
+                        throw sdkUtil.createError(exports.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 === exports.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 !== exports.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, exports.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: sdkUtil.getErrorMessage(err_2),
+                        data: {},
+                    });
+                    return [3 /*break*/, 7];
+                case 7: return [2 /*return*/];
+            }
+        });
+    }); });
+}
+registerEmbedHook(onExperienceEmbed);
+
 exports.BRIDGE_VERSION = VERSION$1;
 exports.BridgeImpl = BridgeImpl;
 exports.ExperienceImpl = ExperienceImpl;
 exports.ParentApplicationImpl = ParentApplicationImpl;
+exports.ShareErrorMessages = ShareErrorMessages;
 exports.VERSION = VERSION;
 exports.embed = embed;
 exports.enableLogging = enableLogging;
+exports.executeShare = executeShare;
 exports.getBridge = getBridge;
 exports.getExperience = getExperience;
 exports.getParentApplication = getParentApplication;
@@ -1583,6 +1742,7 @@ exports.onMessage = onMessage;
 exports.onMoreDataRequested = onMoreDataRequested;
 exports.onReady = onReady;
 exports.onSdkMessage = onSdkMessage;
+exports.onShare = onShare;
 exports.registerEmbedHook = registerEmbedHook;
 exports.reportExperienceSizeChanges = reportExperienceSizeChanges;
 exports.requestMoreData = requestMoreData;
@@ -1597,6 +1757,7 @@ exports.sendRequest = sendRequest;
 exports.sendSdkMessage = sendSdkMessage;
 exports.sendSdkRequest = sendSdkRequest;
 exports.setRequestTimeout = setRequestTimeout;
+exports.share = share;
 exports.shouldHideHeaderAndFooter = shouldHideHeaderAndFooter;
 exports.unmount = unmount;
 //# sourceMappingURL=index.cjs.js.map