wealthica-sdk-js 0.0.16 → 0.0.18

package/README.md

@@ -165,7 +165,7 @@ token = await user.getToken(); // fetches and returns a new token
 token = await user.getToken({ minimumLifeTime: 600 }); // fetches and returns another new token
 ```
 
-#### user.getConnectData({ provider, redirectURI, state, lang, theme, providersPerLine })
+#### user.getConnectData({ provider, redirectURI, state, lang, theme, providersPerLine, webhookURI })
 
 This method returns a Wealthica Connect URL and authentication token for user to connect an institution.
 
@@ -192,6 +192,7 @@ const { url, token } = await user.getConnectData({
   theme: 'light', // optional (light | dark), 'light' by default
   providersPerLine: 1, // optional (1 | 2), 2 by default
   features: 'feature1,feature2', // optional, a comma-separated list of features. undefined by default
+  webhookURI: 'YOUR_WEBHOOK_URI', // optional, URL to receive webhook notifications (must be HTTPS)
 });
 // {
 //   url: "https://connect.wealthica.com/connect/coinbase?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&origin=YOUR_SITE_ORIGIN&state=YOUR_APP_STATE&lang=en&theme=light&providersPerLine=2",
@@ -227,7 +228,7 @@ const user2 = wealthica.login('USER_ID_2');
 const { url: url2, token } = await user2.getConnectData();
 ```
 
-#### user.connect({ provider, providers, institutionId, lang, theme, providersPerLine, features, origin })
+#### user.connect({ provider, providers, institutionId, lang, theme, providersPerLine, features, origin, webhookURI })
 
 This method starts the Wealthica Connect process inside your webpage/app for user to connect their institution.
 
@@ -238,6 +239,7 @@ This method accepts the same parameters as `user.getConnectData()` except for `r
 ```javascript
 user.connect({
   // additional options
+  webhookURI: 'YOUR_WEBHOOK_URI', // optional, URL to receive webhook notifications (must be HTTPS)
 }).onConnection((institution, data) => {
   console.log('provider', data.provider);
   // Send the institution to your server
@@ -249,7 +251,7 @@ user.connect({
 });
 ```
 
-#### user.reconnect(institutionId)
+#### user.reconnect(institutionId, { lang, theme, features, origin, webhookURI })
 
 This method starts the Wealthica Connect process to re-connect an existing institution that has expired/revoked credentials.
 
@@ -258,6 +260,7 @@ Connection response are provided via callbacks.
 ```javascript
 user.reconnect('INSTITUTION_ID', {
   // additional options
+  webhookURI: 'YOUR_WEBHOOK_URI', // optional, URL to receive webhook notifications (must be HTTPS)
 }).onConnection(((institution, data) => {
   console.log('provider', data.provider);
   // Send the institution to your server

package/dist/wealthica.es5.js

@@ -6208,9 +6208,11 @@ var API = /*#__PURE__*/function () {
           theme,
           providersPerLine,
           features,
+          webhookURI,
           _this$config5,
           clientId,
           connectURL,
+          _url,
           token,
           query,
           queryString,
@@ -6221,13 +6223,32 @@ var API = /*#__PURE__*/function () {
             switch (_context4.prev = _context4.next) {
               case 0:
                 options = _args4.length > 0 && _args4[0] !== undefined ? _args4[0] : {};
-                provider = options.provider, institutionId = options.institutionId, state = options.state, _options$origin = options.origin, origin = _options$origin === void 0 ? this.isBrowser ? window.location.origin : undefined : _options$origin, lang = options.lang, _options$redirectURI = options.redirectURI, redirectURI = _options$redirectURI === void 0 ? this.config.redirectURI : _options$redirectURI, providers = options.providers, _options$providerGrou = options.providerGroups, providerGroups = _options$providerGrou === void 0 ? ['core'] : _options$providerGrou, theme = options.theme, providersPerLine = options.providersPerLine, features = options.features;
-                _this$config5 = this.config, clientId = _this$config5.clientId, connectURL = _this$config5.connectURL; // Get a token with at least 10 minutes left
-                _context4.next = 5;
+                provider = options.provider, institutionId = options.institutionId, state = options.state, _options$origin = options.origin, origin = _options$origin === void 0 ? this.isBrowser ? window.location.origin : undefined : _options$origin, lang = options.lang, _options$redirectURI = options.redirectURI, redirectURI = _options$redirectURI === void 0 ? this.config.redirectURI : _options$redirectURI, providers = options.providers, _options$providerGrou = options.providerGroups, providerGroups = _options$providerGrou === void 0 ? ['core'] : _options$providerGrou, theme = options.theme, providersPerLine = options.providersPerLine, features = options.features, webhookURI = options.webhookURI;
+                _this$config5 = this.config, clientId = _this$config5.clientId, connectURL = _this$config5.connectURL; // Validate webhookURI if provided
+                if (!webhookURI) {
+                  _context4.next = 13;
+                  break;
+                }
+                _context4.prev = 4;
+                _url = new URL(webhookURI);
+                if (!(_url.protocol !== 'https:')) {
+                  _context4.next = 8;
+                  break;
+                }
+                throw new Error('Webhook URI must use HTTPS protocol');
+              case 8:
+                _context4.next = 13;
+                break;
+              case 10:
+                _context4.prev = 10;
+                _context4.t0 = _context4["catch"](4);
+                throw new Error("Invalid webhook URI: ".concat(_context4.t0.message));
+              case 13:
+                _context4.next = 15;
                 return this.getToken({
                   minimumLifetime: 600
                 });
-              case 5:
+              case 15:
                 token = _context4.sent;
                 query = {
                   client_id: clientId,
@@ -6240,7 +6261,8 @@ var API = /*#__PURE__*/function () {
                   provider_groups: providerGroups.join(','),
                   theme: ['light', 'dark'].includes(theme) ? theme : 'light',
                   providers_per_line: providersPerLine && ['1', '2'].includes(providersPerLine.toString()) ? providersPerLine.toString() : '2',
-                  features: features
+                  features: features,
+                  webhook_uri: webhookURI
                 }; // Cleanup blank params
                 Object.keys(query).forEach(function (key) {
                   return [undefined, null, ''].includes(query[key]) && delete query[key];
@@ -6254,12 +6276,12 @@ var API = /*#__PURE__*/function () {
                   url: "".concat(url, "?").concat(queryString),
                   token: token
                 });
-              case 12:
+              case 22:
               case "end":
                 return _context4.stop();
             }
           }
-        }, _callee4, this);
+        }, _callee4, this, [[4, 10]]);
       }));
       function getConnectData() {
         return _getConnectData.apply(this, arguments);
@@ -6313,14 +6335,14 @@ var API = /*#__PURE__*/function () {
       var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
       if (!this.isBrowser) throw new Error('Only supported in Browser.');
       _asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee5() {
-        var provider, providers, providerGroups, institutionId, lang, theme, providersPerLine, features, connectionType, origin, _yield$_this$getConne, url, token;
+        var provider, providers, providerGroups, institutionId, lang, theme, providersPerLine, features, connectionType, origin, webhookURI, _yield$_this$getConne, url, token;
         return regeneratorRuntime.wrap(function _callee5$(_context5) {
           while (1) {
             switch (_context5.prev = _context5.next) {
               case 0:
                 _context5.prev = 0;
                 _this._widgetOpened = true;
-                provider = options.provider, providers = options.providers, providerGroups = options.providerGroups, institutionId = options.institutionId, lang = options.lang, theme = options.theme, providersPerLine = options.providersPerLine, features = options.features, connectionType = options.connectionType, origin = options.origin;
+                provider = options.provider, providers = options.providers, providerGroups = options.providerGroups, institutionId = options.institutionId, lang = options.lang, theme = options.theme, providersPerLine = options.providersPerLine, features = options.features, connectionType = options.connectionType, origin = options.origin, webhookURI = options.webhookURI;
                 _context5.next = 5;
                 return _this.getConnectData({
                   provider: provider,
@@ -6331,7 +6353,8 @@ var API = /*#__PURE__*/function () {
                   theme: theme,
                   providersPerLine: providersPerLine,
                   features: features,
-                  origin: origin
+                  origin: origin,
+                  webhookURI: webhookURI
                 });
               case 5:
                 _yield$_this$getConne = _context5.sent;
@@ -6360,7 +6383,7 @@ var API = /*#__PURE__*/function () {
               case 16:
                 _context5.prev = 16;
                 _context5.t0 = _context5["catch"](0);
-                _this._closeWidgetWithError(500, 'Connection refused');
+                _this._closeWidgetWithError(500, _context5.t0.message || 'Connection refused');
               case 19:
               case "end":
                 return _context5.stop();
@@ -6451,8 +6474,10 @@ var API = /*#__PURE__*/function () {
     value: function _closeWidgetWithError(error_type, message) {
       this._closeWidget();
       this._triggerCallback(CALLBACK_ERROR, {
-        error_type: error_type,
-        message: message
+        error: {
+          error_type: error_type,
+          message: message
+        }
       });
     }
   }, {

package/dist/wealthica.js

@@ -6198,9 +6198,11 @@ var API = /*#__PURE__*/function () {
           theme,
           providersPerLine,
           features,
+          webhookURI,
           _this$config5,
           clientId,
           connectURL,
+          _url,
           token,
           query,
           queryString,
@@ -6211,13 +6213,32 @@ var API = /*#__PURE__*/function () {
             switch (_context4.prev = _context4.next) {
               case 0:
                 options = _args4.length > 0 && _args4[0] !== undefined ? _args4[0] : {};
-                provider = options.provider, institutionId = options.institutionId, state = options.state, _options$origin = options.origin, origin = _options$origin === void 0 ? this.isBrowser ? window.location.origin : undefined : _options$origin, lang = options.lang, _options$redirectURI = options.redirectURI, redirectURI = _options$redirectURI === void 0 ? this.config.redirectURI : _options$redirectURI, providers = options.providers, _options$providerGrou = options.providerGroups, providerGroups = _options$providerGrou === void 0 ? ['core'] : _options$providerGrou, theme = options.theme, providersPerLine = options.providersPerLine, features = options.features;
-                _this$config5 = this.config, clientId = _this$config5.clientId, connectURL = _this$config5.connectURL; // Get a token with at least 10 minutes left
-                _context4.next = 5;
+                provider = options.provider, institutionId = options.institutionId, state = options.state, _options$origin = options.origin, origin = _options$origin === void 0 ? this.isBrowser ? window.location.origin : undefined : _options$origin, lang = options.lang, _options$redirectURI = options.redirectURI, redirectURI = _options$redirectURI === void 0 ? this.config.redirectURI : _options$redirectURI, providers = options.providers, _options$providerGrou = options.providerGroups, providerGroups = _options$providerGrou === void 0 ? ['core'] : _options$providerGrou, theme = options.theme, providersPerLine = options.providersPerLine, features = options.features, webhookURI = options.webhookURI;
+                _this$config5 = this.config, clientId = _this$config5.clientId, connectURL = _this$config5.connectURL; // Validate webhookURI if provided
+                if (!webhookURI) {
+                  _context4.next = 13;
+                  break;
+                }
+                _context4.prev = 4;
+                _url = new URL(webhookURI);
+                if (!(_url.protocol !== 'https:')) {
+                  _context4.next = 8;
+                  break;
+                }
+                throw new Error('Webhook URI must use HTTPS protocol');
+              case 8:
+                _context4.next = 13;
+                break;
+              case 10:
+                _context4.prev = 10;
+                _context4.t0 = _context4["catch"](4);
+                throw new Error("Invalid webhook URI: ".concat(_context4.t0.message));
+              case 13:
+                _context4.next = 15;
                 return this.getToken({
                   minimumLifetime: 600
                 });
-              case 5:
+              case 15:
                 token = _context4.sent;
                 query = {
                   client_id: clientId,
@@ -6230,7 +6251,8 @@ var API = /*#__PURE__*/function () {
                   provider_groups: providerGroups.join(','),
                   theme: ['light', 'dark'].includes(theme) ? theme : 'light',
                   providers_per_line: providersPerLine && ['1', '2'].includes(providersPerLine.toString()) ? providersPerLine.toString() : '2',
-                  features: features
+                  features: features,
+                  webhook_uri: webhookURI
                 }; // Cleanup blank params
                 Object.keys(query).forEach(function (key) {
                   return [undefined, null, ''].includes(query[key]) && delete query[key];
@@ -6244,12 +6266,12 @@ var API = /*#__PURE__*/function () {
                   url: "".concat(url, "?").concat(queryString),
                   token: token
                 });
-              case 12:
+              case 22:
               case "end":
                 return _context4.stop();
             }
           }
-        }, _callee4, this);
+        }, _callee4, this, [[4, 10]]);
       }));
       function getConnectData() {
         return _getConnectData.apply(this, arguments);
@@ -6303,14 +6325,14 @@ var API = /*#__PURE__*/function () {
       var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
       if (!this.isBrowser) throw new Error('Only supported in Browser.');
       _asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee5() {
-        var provider, providers, providerGroups, institutionId, lang, theme, providersPerLine, features, connectionType, origin, _yield$_this$getConne, url, token;
+        var provider, providers, providerGroups, institutionId, lang, theme, providersPerLine, features, connectionType, origin, webhookURI, _yield$_this$getConne, url, token;
         return regeneratorRuntime.wrap(function _callee5$(_context5) {
           while (1) {
             switch (_context5.prev = _context5.next) {
               case 0:
                 _context5.prev = 0;
                 _this._widgetOpened = true;
-                provider = options.provider, providers = options.providers, providerGroups = options.providerGroups, institutionId = options.institutionId, lang = options.lang, theme = options.theme, providersPerLine = options.providersPerLine, features = options.features, connectionType = options.connectionType, origin = options.origin;
+                provider = options.provider, providers = options.providers, providerGroups = options.providerGroups, institutionId = options.institutionId, lang = options.lang, theme = options.theme, providersPerLine = options.providersPerLine, features = options.features, connectionType = options.connectionType, origin = options.origin, webhookURI = options.webhookURI;
                 _context5.next = 5;
                 return _this.getConnectData({
                   provider: provider,
@@ -6321,7 +6343,8 @@ var API = /*#__PURE__*/function () {
                   theme: theme,
                   providersPerLine: providersPerLine,
                   features: features,
-                  origin: origin
+                  origin: origin,
+                  webhookURI: webhookURI
                 });
               case 5:
                 _yield$_this$getConne = _context5.sent;
@@ -6350,7 +6373,7 @@ var API = /*#__PURE__*/function () {
               case 16:
                 _context5.prev = 16;
                 _context5.t0 = _context5["catch"](0);
-                _this._closeWidgetWithError(500, 'Connection refused');
+                _this._closeWidgetWithError(500, _context5.t0.message || 'Connection refused');
               case 19:
               case "end":
                 return _context5.stop();
@@ -6441,8 +6464,10 @@ var API = /*#__PURE__*/function () {
     value: function _closeWidgetWithError(error_type, message) {
       this._closeWidget();
       this._triggerCallback(CALLBACK_ERROR, {
-        error_type: error_type,
-        message: message
+        error: {
+          error_type: error_type,
+          message: message
+        }
       });
     }
   }, {