@ikonai/sdk 1.0.61 → 1.0.62

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikonai/sdk",
-  "version": "1.0.61",
+  "version": "1.0.62",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",

package/utils/external-link.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Handling for links that hand off to an external OS application (mailto:, tel:, sms:) rather than
+ * navigating the page.
+ *
+ * Clicking a plain `<a href="mailto:...">` makes the browser begin a top-level navigation: it fires
+ * `beforeunload`/`pagehide`, *then* recognises the scheme is externally handled, hands off to the OS
+ * and aborts the navigation. The document never actually unloads, but the unload events already
+ * fired — which tears down the Ikon connection and leaves the page unresponsive after the user
+ * returns from their mail/phone app.
+ *
+ * Launching the same URL through a transient hidden iframe triggers the OS handler without starting
+ * a top-level navigation, so none of the unload lifecycle fires and the connection stays alive.
+ */
+/**
+ * True when `href` uses a scheme that launches an external OS handler instead of navigating the
+ * page. Relative URLs, fragments and protocol-relative URLs (no scheme) are in-app navigation and
+ * return false; any scheme not in {@link NAVIGABLE_SCHEMES} is treated as an external handler.
+ */
+export declare function isExternalHandlerScheme(href: string): boolean;
+/**
+ * Trigger an external-handler URL (mailto:/tel:/sms:) without navigating the top-level document.
+ */
+export declare function launchExternalHandler(href: string): void;