@meshconnect/web-link-sdk 3.9.5 → 3.9.8

package/Link.js

@@ -45,7 +45,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
-import { addPopup, iframeId, removePopup } from './utils/popup';
+import { addPopup, buildIframeAllowPolicy, iframeId, removePopup } from './utils/popup';
 import { isLinkEventTypeKey } from './utils/event-types';
 import { sdkSpecs } from './utils/sdk-specs';
 import { appendQueryParam } from './utils/url';
@@ -195,7 +195,7 @@ export var createLink = function (options) {
         if (customIframeId) {
             var iframe_1 = document.getElementById(customIframeId);
             if (iframe_1) {
-                iframe_1.allow = 'clipboard-read *; clipboard-write *';
+                iframe_1.allow = buildIframeAllowPolicy(linkTokenOrigin);
                 iframe_1.src = linkUrl;
                 currentIframeId = customIframeId;
             }
@@ -221,9 +221,18 @@ export var createLink = function (options) {
         window.removeEventListener('message', eventsListener);
         (_a = options.onExit) === null || _a === void 0 ? void 0 : _a.call(options);
     };
+    var closeLinkRequested = function () {
+        if ((currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.renderType) === 'embedded') {
+            sendMessageToIframe({ type: 'closeRequested' });
+        }
+        else {
+            closeLink();
+        }
+    };
     return {
         openLink: openLink,
-        closeLink: closeLink
+        closeLink: closeLink,
+        closeLinkRequested: closeLinkRequested
     };
 };
 function addLanguage(linkUrl, language) {

package/README.md

@@ -40,7 +40,6 @@ import { createLink } from '@meshconnect/web-link-sdk';
 // ...
 
 const linkConnection = createLink({
-  clientId: '<Your Mesh Connect Client Id>',
   onIntegrationConnected: (data: LinkPayload) => {
     // use broker account data
   },
@@ -97,7 +96,6 @@ After successfull authentication on the Link session, the popup will be closed a
 
 | key                      | type                                                   | description                                                                          |
 | ------------------------ | ------------------------------------------------------ | ------------------------------------------------------------------------------------ |
-| `clientId`               | `string`                                               | Keys from https://dashboard.meshconnect.com/company/keys page                        |
 | `onIntegrationConnected` | `(payload: LinkPayload) => void`                       | Callback called when users connects their accounts                                   |
 | `onExit`                 | `((error?: string \| undefined) => void) \| undefined` | Called if connection not happened                                                    |
 | `onTransferFinished`     | `(payload: TransferFinishedPayload) => void`           | Callback called when a crypto transfer is executed                                   |
@@ -106,13 +104,15 @@ After successfull authentication on the Link session, the popup will be closed a
 | `language`               | `'en' \| undefined`                                    | Link UI language                                                                     |
 | `displayFiatCurrency`    | `'USD' \| undefined`                                   | A fiat currency to display fiat equivalent of a crypto amount                        |
 | `theme`                  | `'dark' \| 'light' \| 'system' \| undefined`           | Color theme of Link UI interface                                                     |
+| `renderType`             | `'overlay' \| 'embedded' \| undefined`                 | `'overlay'` (default) renders a full-screen popup; `'embedded'` renders inside a client-supplied iframe (requires `customIframeId` in `openLink`) |
 
 #### `createLink` return value
 
-| key         | type                                   | description              |
-| ----------- | -------------------------------------- | ------------------------ |
-| `openLink`  | `(linkToken: string) => Promise<void>` | Opens the Link UI popup  |
-| `closeLink` | `() => Promise<void>`                  | Closes the Link UI popup |
+| key                  | type                                                        | description                                                                                                |
+| -------------------- | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| `openLink`           | `(linkToken: string, customIframeId?: string) => void`      | Opens the Link UI popup. Optionally targets an existing iframe by ID instead of creating a new popup       |
+| `closeLink`          | `() => void`                                                | Closes the Link UI popup immediately                                                                       |
+| `closeLinkRequested` | `() => void`                                                | Requests graceful close in `embedded` mode (sends `closeRequested` to iframe); closes immediately otherwise  |
 
 ### Using tokens
 
@@ -121,3 +121,19 @@ You can use broker tokens to perform requests to get current balance, assets and
 ## Typescript support
 
 TypeScript definitions for `@meshconnect/web-link-sdk` are built into the npm package.
+
+### Exported types
+
+| type                      | description                                                                                   |
+| ------------------------- | --------------------------------------------------------------------------------------------- |
+| `LinkPayload`             | Payload passed to `onIntegrationConnected`                                                    |
+| `AccessTokenPayload`      | Broker access token details within `LinkPayload`                                              |
+| `DelayedAuthPayload`      | Delayed auth details within `LinkPayload`                                                     |
+| `IntegrationAccessToken`  | Access token shape used in the `accessTokens` option                                          |
+| `TransferFinishedPayload` | Payload passed to `onTransferFinished`                                                        |
+| `BrokerType`              | Union of supported broker/integration type strings (re-exported from `@meshconnect/node-api`) |
+| `LinkOptions`             | Full options object passed to `createLink`                                                    |
+| `Link`                    | Return type of `createLink`                                                                   |
+| `AccountToken`            | Account token within `AccessTokenPayload`                                                     |
+| `Account`                 | Account details within `AccountToken`                                                         |
+| `BrandInfo`               | Integration brand/logo info                                                                   |

package/index.d.ts

@@ -1,3 +1,4 @@
 export * from './utils/types';
 export * from './utils/event-types';
 export { createLink } from './Link';
+export type { BrokerType } from '@meshconnect/node-api';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshconnect/web-link-sdk",
-  "version": "3.9.5",
+  "version": "3.9.8",
   "description": "A client-side JS library for integrating with Mesh Connect",
   "exports": "./index.js",
   "license": "MIT",

package/utils/popup.d.ts

@@ -1,3 +1,4 @@
 export declare const iframeId = "mesh-link-popup__iframe";
+export declare function buildIframeAllowPolicy(origin: string): string;
 export declare function removePopup(): void;
 export declare function addPopup(iframeLink: string): void;

package/utils/popup.js

@@ -5,6 +5,9 @@ var popupContentId = 'mesh-link-popup__popup-content';
 var stylesId = 'mesh-link-popup__styles';
 export var iframeId = 'mesh-link-popup__iframe';
 var getStylesContent = function (style) { return "\n  body {\n    position: fixed;\n    left: 0;\n    top: 0;\n    bottom: 0;\n    right: 0;\n    overflow: hidden;\n  }\n\n  #".concat(popupId, " {\n    all: unset;\n    position: fixed;\n    left: 0;\n    top: 0;\n    bottom: 0;\n    right: 0;\n    display: flex;\n    flex-direction: column;\n    align-items: center;\n    justify-content: center;\n    z-index: 10000;\n    pointer-events: auto;\n  }\n\n  #").concat(backdropId, " {\n    position: absolute;\n    left: 0;\n    top: 0;\n    bottom: 0;\n    right: 0;\n    z-index: 10000;\n    background: black;\n    opacity: ").concat(getNumber(0.6, style === null || style === void 0 ? void 0 : style.io), ";\n  }\n\n  #").concat(popupContentId, " {\n    position: absolute;\n    height: 80%;\n    max-height: 710px;\n    min-height: 685px;\n    margin: auto;\n    z-index: 10001;\n    width: 30%;\n    max-width: 430px;\n    min-width: 380px;\n    display: flex;\n    flex-direction: column;\n    border-radius: ").concat(getNumber(24, style === null || style === void 0 ? void 0 : style.ir), "px;\n    flex-grow: 1;\n  }\n\n  #").concat(popupContentId, " iframe {\n    border: none;\n    width: 100%;\n    flex-grow: 1;\n    border-radius: ").concat(getNumber(24, style === null || style === void 0 ? void 0 : style.ir), "px;\n  }\n\n  @media only screen and (max-width: 768px) {\n    #").concat(popupContentId, " {\n      height: 100vh;\n      width: 100vw;\n      max-width: 100%;\n      min-width: 100%;\n      max-height: 100%;\n      min-height: 100%;\n      border-radius: 0px;\n    }\n\n    #").concat(popupContentId, " iframe {\n      border-radius: 0px;\n    }\n  }\n\n  @media only screen and (max-height: 710px) {\n    #").concat(popupContentId, " {\n      max-height: 100%;\n      min-height: 100%;\n    }\n  }\n"); };
+export function buildIframeAllowPolicy(origin) {
+    return "clipboard-read *; clipboard-write *; camera ".concat(origin, "; microphone ").concat(origin);
+}
 export function removePopup() {
     var _a, _b;
     var existingPopup = window.document.getElementById(popupId);
@@ -29,7 +32,7 @@ export function addPopup(iframeLink) {
     var iframeElement = document.createElement('iframe');
     iframeElement.id = iframeId;
     iframeElement.src = iframeLink;
-    iframeElement.allow = 'clipboard-read *; clipboard-write *';
+    iframeElement.allow = buildIframeAllowPolicy(new URL(iframeLink).origin);
     popupContentElement.appendChild(iframeElement);
     popupRootElement.appendChild(popupContentElement);
     window.document.body.appendChild(popupRootElement);

package/utils/types.d.ts

@@ -12,6 +12,10 @@ export interface Link {
      * A function to close Link UI popup
      */
     closeLink: () => void;
+    /**
+     * A function to request Link UI to close gracefully in embedded mode.
+     */
+    closeLinkRequested: () => void;
 }
 export interface AccountToken {
     account: Account;
@@ -100,7 +104,7 @@ export interface IntegrationAccessToken {
 }
 export interface LinkOptions {
     /**
-     * Client ID that can be obtained at https://dashboard.meshconnect.com/company/keys
+     * @deprecated This property is unused and will be removed in the next major version.
      */
     clientId?: string;
     /**

package/utils/version.d.ts

@@ -1 +1 @@
-export declare const sdkVersion = "3.9.5";
+export declare const sdkVersion = "3.9.8";

package/utils/version.js

@@ -1 +1 @@
-export var sdkVersion = '3.9.5';
+export var sdkVersion = '3.9.8';