@meshconnect/web-link-sdk 2.0.0

package/Link.d.ts

@@ -0,0 +1,2 @@
+import { LinkOptions, Link } from './utils/types';
+export declare const createLink: (options: LinkOptions) => Link;

package/Link.js

@@ -0,0 +1,144 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        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 { isLinkEventTypeKey } from './utils/event-types';
+var currentOptions;
+var iframeUrlObject;
+var iframeElement = function () {
+    return document.getElementById(iframeId);
+};
+function eventsListener(event) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    switch (event.data.type) {
+        case 'brokerageAccountAccessToken': {
+            var payload = {
+                accessToken: event.data.payload
+            };
+            (_a = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onEvent) === null || _a === void 0 ? void 0 : _a.call(currentOptions, {
+                type: 'integrationConnected',
+                payload: payload
+            });
+            (_b = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onIntegrationConnected) === null || _b === void 0 ? void 0 : _b.call(currentOptions, payload);
+            break;
+        }
+        case 'delayedAuthentication': {
+            var payload = {
+                delayedAuth: event.data.payload
+            };
+            (_c = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onEvent) === null || _c === void 0 ? void 0 : _c.call(currentOptions, {
+                type: 'integrationConnected',
+                payload: payload
+            });
+            (_d = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onIntegrationConnected) === null || _d === void 0 ? void 0 : _d.call(currentOptions, payload);
+            break;
+        }
+        case 'transferFinished': {
+            var payload = event.data.payload;
+            (_e = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onEvent) === null || _e === void 0 ? void 0 : _e.call(currentOptions, {
+                type: 'transferCompleted',
+                payload: payload
+            });
+            (_f = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onTransferFinished) === null || _f === void 0 ? void 0 : _f.call(currentOptions, payload);
+            break;
+        }
+        case 'close':
+        case 'done': {
+            (_g = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onExit) === null || _g === void 0 ? void 0 : _g.call(currentOptions, event.data.message);
+            removePopup();
+            break;
+        }
+        case 'oauthLinkOpen': {
+            if (event.data.link) {
+                var w = 700;
+                var h = 800;
+                var left = screen.width / 2 - w / 2;
+                var top_1 = screen.height / 2 - h / 2;
+                (_h = window
+                    .open(event.data.link, '_blank', "popup,noopener,noreferrer,resizable,scrollbars,width=".concat(w, ",height=").concat(h, ",top=").concat(top_1, ",left=").concat(left))) === null || _h === void 0 ? void 0 : _h.focus();
+            }
+            break;
+        }
+        case 'loaded': {
+            if (currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.accessTokens) {
+                (_j = iframeElement().contentWindow) === null || _j === void 0 ? void 0 : _j.postMessage({ type: 'frontAccessTokens', payload: currentOptions.accessTokens }, (iframeUrlObject === null || iframeUrlObject === void 0 ? void 0 : iframeUrlObject.origin) || 'https://web.meshconnect.com');
+            }
+            if (currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.transferDestinationTokens) {
+                (_k = iframeElement().contentWindow) === null || _k === void 0 ? void 0 : _k.postMessage({
+                    type: 'frontTransferDestinationTokens',
+                    payload: currentOptions.transferDestinationTokens
+                }, (iframeUrlObject === null || iframeUrlObject === void 0 ? void 0 : iframeUrlObject.origin) || 'https://web.meshconnect.com');
+            }
+            (_l = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onEvent) === null || _l === void 0 ? void 0 : _l.call(currentOptions, { type: 'pageLoaded' });
+            break;
+        }
+        default: {
+            if (isLinkEventTypeKey(event.data.type)) {
+                (_m = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onEvent) === null || _m === void 0 ? void 0 : _m.call(currentOptions, event.data);
+            }
+            break;
+        }
+    }
+}
+export var createLink = function (options) {
+    var openLink = function (linkToken) { return __awaiter(void 0, void 0, void 0, function () {
+        var linkUrl;
+        var _a;
+        return __generator(this, function (_b) {
+            if (!linkToken) {
+                (_a = options === null || options === void 0 ? void 0 : options.onExit) === null || _a === void 0 ? void 0 : _a.call(options, 'Invalid link token!');
+                return [2 /*return*/];
+            }
+            currentOptions = options;
+            linkUrl = window.atob(linkToken);
+            iframeUrlObject = new URL(linkUrl);
+            window.removeEventListener('message', eventsListener);
+            addPopup(linkUrl);
+            window.addEventListener('message', eventsListener);
+            return [2 /*return*/];
+        });
+    }); };
+    var closeLink = function () {
+        var _a;
+        removePopup();
+        window.removeEventListener('message', eventsListener);
+        (_a = options.onExit) === null || _a === void 0 ? void 0 : _a.call(options);
+    };
+    return {
+        openLink: openLink,
+        closeLink: closeLink
+    };
+};

package/README.md

@@ -0,0 +1,127 @@
+# @meshconnect/web-link-sdk
+
+A client-side JS library for integrating with Mesh Connect
+
+### Install
+
+With `npm`:
+
+```
+npm install --save @meshconnect/web-link-sdk
+```
+
+With `yarn`
+
+```
+yarn add @meshconnect/web-link-sdk
+```
+
+### Getting Link token
+
+Link token should be obtained from the GET `/api/v1/linktoken` endpoint. Api reference for this request is available [here](https://integration-api.getfront.com/apireference#tag/Managed-Account-Authentication/paths/~1api~1v1~1linktoken/post). Request must be preformed from the server side because it requires the client secret. You will get the response in the following format:
+
+```json
+{
+  "content": {
+   "linkToken": "{linktoken}"
+},
+  },
+  "status": "ok",
+  "message": ""
+}
+```
+
+You can use `linkToken` value from this response to open the popup window with `openLink` method.
+
+### Generating connection method
+
+```tsx
+import { createLink } from '@meshconnect/web-link-sdk';
+
+// ...
+
+const linkConnection = createLink({
+  clientId: '<Your Mesh Connect Client Id>',
+  onIntegrationConnected: (data: LinkPayload) => {
+    // use broker account data
+  },
+  onExit: (error?: string) => {
+    if (error) {
+      // handle error
+    } else {
+      // ...
+    }
+  }
+
+```
+
+### Using connection to open auth link
+
+To open authentication link provided by Front Finance Integration API you need to call `openLink` method:
+
+```tsx
+linkConnection.openLink(linkToken)
+```
+
+ℹ️ See full source code example at [react-example/src/ui/Link.tsx](../../examples/react-example/src/ui/Link.tsx)
+
+```tsx
+import {
+  createLink,
+  Link,
+  LinkPayload
+} from '@meshconnect/web-link-sdk'
+
+// ...
+
+const [linkConnection, setLinkConnection] = useState<Link | null>(
+  null
+)
+
+useEffect(() => {
+  setLinkConnection(createLink(options))
+}, [])
+
+useEffect(() => {
+  if (authLink) {
+    linkConnection?.openLink(linkToken)
+  }
+}, [linkConnection, authLink])
+
+return <></>
+```
+
+### Getting tokens
+
+After successfull authentication on the Link session, the popup will be closed and the broker tokens will be passed to the `onIntegrationConnected` function.
+`Link` instance will check if URL contains query parameters, load broker tokens and fire the events.
+
+### Available Connection configuration options
+
+ℹ️ See [src/types/index.ts](src/utils/types.ts) for exported types.
+
+#### `createLink` arguments
+
+| key                      | type                                                    | description                                                                          |
+|--------------------------|---------------------------------------------------------| ------------------------------------------------------------------------------------ |
+| `clientId`               | `string`                                                | Keys from https://dashboard.getfront.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                                   |
+| `onEvent`                | `(payload: LinkEventType) => void`                     | A callback function that is called when various events occur within the Front iframe |
+| `accessTokens`           | `IntegrationAccessToken[]`                              | An array of integration access tokens                                                |
+
+#### `createLink` return value
+
+| key          | type                                   | description                    |
+| ------------ | -------------------------------------- | ------------------------------ |
+| `openLink`   | `(linkToken: string) => Promise<void>` | Opens the Link UI popup        |
+| `closeLink`  | `() => Promise<void>`                  | Closes the Link UI popup       |
+
+### Using tokens
+
+You can use broker tokens to perform requests to get current balance, assets and execute transactions. Full API reference can be found [here](https://integration-api.meshconnect.com/apireference).
+
+## Typescript support
+
+TypeScript definitions for `@meshconnect/web-link-sdk` are built into the npm package.

package/cjs/Link.js

@@ -0,0 +1,148 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLink = void 0;
+var popup_1 = require("./utils/popup");
+var event_types_1 = require("./utils/event-types");
+var currentOptions;
+var iframeUrlObject;
+var iframeElement = function () {
+    return document.getElementById(popup_1.iframeId);
+};
+function eventsListener(event) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    switch (event.data.type) {
+        case 'brokerageAccountAccessToken': {
+            var payload = {
+                accessToken: event.data.payload
+            };
+            (_a = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onEvent) === null || _a === void 0 ? void 0 : _a.call(currentOptions, {
+                type: 'integrationConnected',
+                payload: payload
+            });
+            (_b = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onIntegrationConnected) === null || _b === void 0 ? void 0 : _b.call(currentOptions, payload);
+            break;
+        }
+        case 'delayedAuthentication': {
+            var payload = {
+                delayedAuth: event.data.payload
+            };
+            (_c = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onEvent) === null || _c === void 0 ? void 0 : _c.call(currentOptions, {
+                type: 'integrationConnected',
+                payload: payload
+            });
+            (_d = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onIntegrationConnected) === null || _d === void 0 ? void 0 : _d.call(currentOptions, payload);
+            break;
+        }
+        case 'transferFinished': {
+            var payload = event.data.payload;
+            (_e = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onEvent) === null || _e === void 0 ? void 0 : _e.call(currentOptions, {
+                type: 'transferCompleted',
+                payload: payload
+            });
+            (_f = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onTransferFinished) === null || _f === void 0 ? void 0 : _f.call(currentOptions, payload);
+            break;
+        }
+        case 'close':
+        case 'done': {
+            (_g = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onExit) === null || _g === void 0 ? void 0 : _g.call(currentOptions, event.data.message);
+            (0, popup_1.removePopup)();
+            break;
+        }
+        case 'oauthLinkOpen': {
+            if (event.data.link) {
+                var w = 700;
+                var h = 800;
+                var left = screen.width / 2 - w / 2;
+                var top_1 = screen.height / 2 - h / 2;
+                (_h = window
+                    .open(event.data.link, '_blank', "popup,noopener,noreferrer,resizable,scrollbars,width=".concat(w, ",height=").concat(h, ",top=").concat(top_1, ",left=").concat(left))) === null || _h === void 0 ? void 0 : _h.focus();
+            }
+            break;
+        }
+        case 'loaded': {
+            if (currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.accessTokens) {
+                (_j = iframeElement().contentWindow) === null || _j === void 0 ? void 0 : _j.postMessage({ type: 'frontAccessTokens', payload: currentOptions.accessTokens }, (iframeUrlObject === null || iframeUrlObject === void 0 ? void 0 : iframeUrlObject.origin) || 'https://web.meshconnect.com');
+            }
+            if (currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.transferDestinationTokens) {
+                (_k = iframeElement().contentWindow) === null || _k === void 0 ? void 0 : _k.postMessage({
+                    type: 'frontTransferDestinationTokens',
+                    payload: currentOptions.transferDestinationTokens
+                }, (iframeUrlObject === null || iframeUrlObject === void 0 ? void 0 : iframeUrlObject.origin) || 'https://web.meshconnect.com');
+            }
+            (_l = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onEvent) === null || _l === void 0 ? void 0 : _l.call(currentOptions, { type: 'pageLoaded' });
+            break;
+        }
+        default: {
+            if ((0, event_types_1.isLinkEventTypeKey)(event.data.type)) {
+                (_m = currentOptions === null || currentOptions === void 0 ? void 0 : currentOptions.onEvent) === null || _m === void 0 ? void 0 : _m.call(currentOptions, event.data);
+            }
+            break;
+        }
+    }
+}
+var createLink = function (options) {
+    var openLink = function (linkToken) { return __awaiter(void 0, void 0, void 0, function () {
+        var linkUrl;
+        var _a;
+        return __generator(this, function (_b) {
+            if (!linkToken) {
+                (_a = options === null || options === void 0 ? void 0 : options.onExit) === null || _a === void 0 ? void 0 : _a.call(options, 'Invalid link token!');
+                return [2 /*return*/];
+            }
+            currentOptions = options;
+            linkUrl = window.atob(linkToken);
+            iframeUrlObject = new URL(linkUrl);
+            window.removeEventListener('message', eventsListener);
+            (0, popup_1.addPopup)(linkUrl);
+            window.addEventListener('message', eventsListener);
+            return [2 /*return*/];
+        });
+    }); };
+    var closeLink = function () {
+        var _a;
+        (0, popup_1.removePopup)();
+        window.removeEventListener('message', eventsListener);
+        (_a = options.onExit) === null || _a === void 0 ? void 0 : _a.call(options);
+    };
+    return {
+        openLink: openLink,
+        closeLink: closeLink
+    };
+};
+exports.createLink = createLink;

package/cjs/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLink = void 0;
+__exportStar(require("./utils/types"), exports);
+__exportStar(require("./utils/event-types"), exports);
+var Link_1 = require("./Link");
+Object.defineProperty(exports, "createLink", { enumerable: true, get: function () { return Link_1.createLink; } });

package/cjs/utils/event-types.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLinkEventTypeKey = void 0;
+var LINK_EVENT_TYPE_KEYS = [
+    'integrationConnected',
+    'integrationConnectionError',
+    'transferCompleted',
+    'integrationSelected',
+    'credentialsEntered',
+    'transferStarted',
+    'transferPreviewed',
+    'transferPreviewError',
+    'transferExecutionError',
+    'pageLoaded'
+];
+function isLinkEventTypeKey(key) {
+    return LINK_EVENT_TYPE_KEYS.includes(key);
+}
+exports.isLinkEventTypeKey = isLinkEventTypeKey;

package/cjs/utils/popup.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addPopup = exports.removePopup = exports.iframeId = void 0;
+var style_1 = require("./style");
+var popupId = 'mesh-link-popup';
+var backdropId = 'mesh-link-popup__backdrop';
+var popupContentId = 'mesh-link-popup__popup-content';
+var stylesId = 'mesh-link-popup__styles';
+exports.iframeId = 'mesh-link-popup__iframe';
+var getPopupHtml = function (link) { return "\n<div id=\"".concat(popupId, "\">\n  <div id=\"").concat(backdropId, "\"></div>\n  <div id=\"").concat(popupContentId, "\">\n    <iframe id=\"").concat(exports.iframeId, "\" src=\"").concat(link, "\" allow=\"clipboard-read *; clipboard-write *\" />\n  </div>\n</div>\n"); };
+var getStyles = function (style) { return "\n<style id=\"".concat(stylesId, "\">\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  }\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((0, style_1.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((0, style_1.getNumber)(24, style === null || style === void 0 ? void 0 : style.ir), "px;\n    background: white;\n    flex-grow: 1;\n  }\n\n  #").concat(popupContentId, " iframe {\n    border: none;\n    width: 100%;\n    flex-grow: 1;\n    border-radius: ").concat((0, style_1.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</style>\n"); };
+function removePopup() {
+    var _a, _b;
+    var existingPopup = window.document.getElementById(popupId);
+    (_a = existingPopup === null || existingPopup === void 0 ? void 0 : existingPopup.parentElement) === null || _a === void 0 ? void 0 : _a.removeChild(existingPopup);
+    var existingStyles = window.document.getElementById(stylesId);
+    (_b = existingStyles === null || existingStyles === void 0 ? void 0 : existingStyles.parentElement) === null || _b === void 0 ? void 0 : _b.removeChild(existingStyles);
+}
+exports.removePopup = removePopup;
+function addPopup(iframeLink) {
+    var style = (0, style_1.getLinkStyle)(iframeLink);
+    removePopup();
+    var popup = getPopupHtml(iframeLink);
+    var stylesElement = htmlToElement(getStyles(style));
+    if (stylesElement) {
+        window.document.head.appendChild(stylesElement);
+    }
+    var popupElement = htmlToElement(popup);
+    if (popupElement) {
+        window.document.body.appendChild(popupElement);
+    }
+}
+exports.addPopup = addPopup;
+function htmlToElement(html) {
+    var template = document.createElement('template');
+    html = html.trim();
+    template.innerHTML = html;
+    return template.content.firstChild;
+}

package/cjs/utils/style.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNumber = exports.getLinkStyle = void 0;
+function getLinkStyle(url) {
+    try {
+        var params = new URLSearchParams(new URL(url).search);
+        var style = params.get('link_style');
+        return style && JSON.parse(window.atob(style));
+    }
+    catch (e) {
+        return undefined;
+    }
+}
+exports.getLinkStyle = getLinkStyle;
+function getNumber(def, value) {
+    return value !== undefined ? value : def;
+}
+exports.getNumber = getNumber;

package/cjs/utils/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/index.d.ts

@@ -0,0 +1,3 @@
+export * from './utils/types';
+export * from './utils/event-types';
+export { createLink } from './Link';

package/index.js

@@ -0,0 +1,3 @@
+export * from './utils/types';
+export * from './utils/event-types';
+export { createLink } from './Link';

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@meshconnect/web-link-sdk",
+  "version": "2.0.0",
+  "description": "A client-side JS library for integrating with Mesh Connect",
+  "license": "MIT",
+  "repository": "https://github.com/FrontFin/mesh-web-sdk.git",
+  "homepage": "https://github.com/FrontFin/mesh-web-sdk",
+  "devDependencies": {
+    "@typescript-eslint/eslint-plugin": "^4.21.0",
+    "@typescript-eslint/parser": "^4.21.0",
+    "eslint": "^7.23.0",
+    "eslint-config-prettier": "^8.1.0",
+    "eslint-plugin-import": "^2.22.1",
+    "eslint-plugin-prettier": "^3.4.0",
+    "prettier": "^2.2.1",
+    "typescript": "^4.6.4",
+    "ts-jest": "^29.1.1",
+    "jest": "^29.6.4",
+    "@types/jest": "^29.5.4",
+    "jest-environment-jsdom": "^29.6.4"
+  },
+  "dependencies": {
+    "@meshconnect/node-api": "^2.0.0"
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "jsdom",
+    "testPathIgnorePatterns": [
+      "/node_modules/",
+      "/dist/"
+    ],
+    "coverageDirectory": "./coverage",
+    "transform": {
+      "\\.[jt]sx?$": "ts-jest"
+    },
+    "testEnvironmentOptions": {
+      "url": "http://localhost/"
+    }
+  },
+  "main": "cjs/index.js",
+  "module": "index.js",
+  "types": "index.d.ts"
+}

package/utils/event-types.d.ts

@@ -0,0 +1,68 @@
+import { LinkPayload, TransferFinishedPayload } from './types';
+export type LinkEventType = IntegrationConnected | IntegrationConnectionError | TransferCompleted | IntegrationSelected | CredentialsEntered | TransferStarted | TransferPreviewed | TransferPreviewError | TransferExecutionError | PageLoaded;
+declare const LINK_EVENT_TYPE_KEYS: readonly ["integrationConnected", "integrationConnectionError", "transferCompleted", "integrationSelected", "credentialsEntered", "transferStarted", "transferPreviewed", "transferPreviewError", "transferExecutionError", "pageLoaded"];
+export type LinkEventTypeKeys = (typeof LINK_EVENT_TYPE_KEYS)[number];
+export declare function isLinkEventTypeKey(key: string): key is LinkEventTypeKeys;
+interface LinkEventBase {
+    type: LinkEventTypeKeys;
+}
+export interface PageLoaded {
+    type: 'pageLoaded';
+}
+export interface IntegrationConnected extends LinkEventBase {
+    type: 'integrationConnected';
+    payload: LinkPayload;
+}
+export interface IntegrationConnectionError extends LinkEventBase {
+    type: 'integrationConnectionError';
+    payload: {
+        errorMessage: string;
+    };
+}
+export interface TransferCompleted extends LinkEventBase {
+    type: 'transferCompleted';
+    payload: TransferFinishedPayload;
+}
+export interface IntegrationSelected extends LinkEventBase {
+    type: 'integrationSelected';
+    payload: {
+        integrationType: string;
+        integrationName: string;
+    };
+}
+export interface CredentialsEntered extends LinkEventBase {
+    type: 'credentialsEntered';
+}
+export interface TransferStarted extends LinkEventBase {
+    type: 'transferStarted';
+}
+export interface TransferPreviewed extends LinkEventBase {
+    type: 'transferPreviewed';
+    payload: {
+        amount: number;
+        symbol: string;
+        toAddress: string;
+        networkId: string;
+        previewId: string;
+        networkName?: string;
+        amountInFiat?: number;
+        estimatedNetworkGasFee?: {
+            fee?: number;
+            feeCurrency?: string;
+            feeInFiat?: number;
+        };
+    };
+}
+export interface TransferPreviewError extends LinkEventBase {
+    type: 'transferPreviewError';
+    payload: {
+        errorMessage: string;
+    };
+}
+export interface TransferExecutionError extends LinkEventBase {
+    type: 'transferExecutionError';
+    payload: {
+        errorMessage: string;
+    };
+}
+export {};

package/utils/event-types.js

@@ -0,0 +1,15 @@
+var LINK_EVENT_TYPE_KEYS = [
+    'integrationConnected',
+    'integrationConnectionError',
+    'transferCompleted',
+    'integrationSelected',
+    'credentialsEntered',
+    'transferStarted',
+    'transferPreviewed',
+    'transferPreviewError',
+    'transferExecutionError',
+    'pageLoaded'
+];
+export function isLinkEventTypeKey(key) {
+    return LINK_EVENT_TYPE_KEYS.includes(key);
+}

package/utils/popup.d.ts

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

package/utils/popup.js

@@ -0,0 +1,34 @@
+import { getLinkStyle, getNumber } from './style';
+var popupId = 'mesh-link-popup';
+var backdropId = 'mesh-link-popup__backdrop';
+var popupContentId = 'mesh-link-popup__popup-content';
+var stylesId = 'mesh-link-popup__styles';
+export var iframeId = 'mesh-link-popup__iframe';
+var getPopupHtml = function (link) { return "\n<div id=\"".concat(popupId, "\">\n  <div id=\"").concat(backdropId, "\"></div>\n  <div id=\"").concat(popupContentId, "\">\n    <iframe id=\"").concat(iframeId, "\" src=\"").concat(link, "\" allow=\"clipboard-read *; clipboard-write *\" />\n  </div>\n</div>\n"); };
+var getStyles = function (style) { return "\n<style id=\"".concat(stylesId, "\">\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  }\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    background: white;\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</style>\n"); };
+export function removePopup() {
+    var _a, _b;
+    var existingPopup = window.document.getElementById(popupId);
+    (_a = existingPopup === null || existingPopup === void 0 ? void 0 : existingPopup.parentElement) === null || _a === void 0 ? void 0 : _a.removeChild(existingPopup);
+    var existingStyles = window.document.getElementById(stylesId);
+    (_b = existingStyles === null || existingStyles === void 0 ? void 0 : existingStyles.parentElement) === null || _b === void 0 ? void 0 : _b.removeChild(existingStyles);
+}
+export function addPopup(iframeLink) {
+    var style = getLinkStyle(iframeLink);
+    removePopup();
+    var popup = getPopupHtml(iframeLink);
+    var stylesElement = htmlToElement(getStyles(style));
+    if (stylesElement) {
+        window.document.head.appendChild(stylesElement);
+    }
+    var popupElement = htmlToElement(popup);
+    if (popupElement) {
+        window.document.body.appendChild(popupElement);
+    }
+}
+function htmlToElement(html) {
+    var template = document.createElement('template');
+    html = html.trim();
+    template.innerHTML = html;
+    return template.content.firstChild;
+}

package/utils/style.d.ts

@@ -0,0 +1,3 @@
+import { LinkStyle } from './types';
+export declare function getLinkStyle(url: string): LinkStyle | undefined;
+export declare function getNumber(def: number, value?: number): number;

package/utils/style.js

@@ -0,0 +1,13 @@
+export function getLinkStyle(url) {
+    try {
+        var params = new URLSearchParams(new URL(url).search);
+        var style = params.get('link_style');
+        return style && JSON.parse(window.atob(style));
+    }
+    catch (e) {
+        return undefined;
+    }
+}
+export function getNumber(def, value) {
+    return value !== undefined ? value : def;
+}

package/utils/types.d.ts

@@ -0,0 +1,108 @@
+import type { BrokerType } from '@meshconnect/node-api';
+import { LinkEventType } from './event-types';
+export type EventType = 'brokerageAccountAccessToken' | 'delayedAuthentication' | 'close' | 'done' | 'loaded' | 'oauthLinkOpen' | 'transferFinished';
+export interface Link {
+    /**
+     * A function that takes linkToken parameter from `/api/v1/linktoken` endpoint as an input, and opens the Link UI popup
+     */
+    openLink: (linkToken: string) => Promise<void>;
+    /**
+     * A function to close Link UI popup
+     */
+    closeLink: () => void;
+}
+export interface AccountToken {
+    account: Account;
+    accessToken: string;
+    refreshToken?: string;
+}
+export interface Account {
+    accountId: string;
+    accountName: string;
+    fund?: number;
+    cash?: number;
+    isReconnected?: boolean;
+}
+export interface BrandInfo {
+    brokerLogo: string;
+    brokerPrimaryColor?: string;
+}
+export interface LinkPayload {
+    accessToken?: AccessTokenPayload;
+    delayedAuth?: DelayedAuthPayload;
+}
+export interface AccessTokenPayload {
+    accountTokens: AccountToken[];
+    brokerBrandInfo: BrandInfo;
+    expiresInSeconds?: number;
+    refreshTokenExpiresInSeconds?: number;
+    brokerType: BrokerType;
+    brokerName: string;
+}
+export interface DelayedAuthPayload {
+    refreshTokenExpiresInSeconds?: number;
+    brokerType: BrokerType;
+    refreshToken: string;
+    brokerName: string;
+    brokerBrandInfo: BrandInfo;
+}
+export interface TransferFinishedSuccessPayload {
+    status: 'success';
+    txId: string;
+    fromAddress: string;
+    toAddress: string;
+    symbol: string;
+    amount: number;
+    networkId: string;
+}
+export interface TransferFinishedErrorPayload {
+    status: 'error';
+    errorMessage: string;
+}
+export type TransferFinishedPayload = TransferFinishedSuccessPayload | TransferFinishedErrorPayload;
+export interface IntegrationAccessToken {
+    accountId: string;
+    accountName: string;
+    accessToken: string;
+    brokerType: BrokerType;
+    brokerName: string;
+}
+export interface LinkOptions {
+    /**
+     * Client ID that can be obtained at https://dashboard.meshconnect.com/company/keys
+     */
+    clientId: string;
+    /**
+     * A callback function that is called when an integration is successfully connected.
+     * It receives a payload of type `LinkPayload`.
+     */
+    onIntegrationConnected: (payload: LinkPayload) => void;
+    /**
+     * (Optional) A callback function that is called when the Front iframe is closed.
+     */
+    onExit?: (error?: string) => void;
+    /**
+     * (Optional) A callback function that is called when a transfer is finished.
+     * It receives a payload of type `TransferFinishedPayload`.
+     */
+    onTransferFinished?: (payload: TransferFinishedPayload) => void;
+    /**
+     * (Optional) A callback function that is called when various events occur within the Front iframe.
+     * It receives an object with type `LinkEventTypeKeys` indicating the event, and an optional 'payload' containing additional data.
+     */
+    onEvent?: (event: LinkEventType) => void;
+    /**
+     * (Optional) An array of integration access tokens.
+     * These access tokens are used to initialize crypto transfers flow at 'Select asset step'
+     */
+    accessTokens?: IntegrationAccessToken[];
+    /**
+     * (Optional) An array of integration access tokens.
+     * Can be used to initialize the crypto transfers flow as an alternative to the target addresses.
+     */
+    transferDestinationTokens?: IntegrationAccessToken[];
+}
+export interface LinkStyle {
+    ir: number;
+    io: number;
+}

package/utils/types.js

@@ -0,0 +1 @@
+export {};