@tryfinch/react-connect 2.8.0

package/.babelrc

@@ -0,0 +1,9 @@
+{
+  "presets": [
+    ["@babel/preset-env", {
+      "modules": false
+    }],
+    "@babel/preset-react"
+  ],
+  "plugins": ["@babel/plugin-proposal-class-properties"]
+}

package/.eslintignore

@@ -0,0 +1,5 @@
+node_modules
+coverage
+dist
+build
+out

package/.eslintrc.js

@@ -0,0 +1,43 @@
+module.exports = {
+  extends: ['airbnb', 'plugin:prettier/recommended', 'prettier/react'],
+  env: {
+    browser: true,
+    commonjs: true,
+    es6: true,
+    jest: true,
+    node: true,
+  },
+  parserOptions: {
+    sourceType: 'module',
+  },
+  settings: {
+    'import/resolver': {
+      node: {
+        paths: ['src'],
+      },
+    },
+  },
+  rules: {
+    'jsx-a11y/href-no-hash': ['off'],
+    'react/jsx-filename-extension': ['warn', { extensions: ['.js', '.jsx'] }],
+    'react/react-in-jsx-scope': 'off',
+    'react/prop-types': 'off',
+    'jsx-a11y/anchor-is-valid': 'off',
+    'react/jsx-props-no-spreading': 'off',
+    'no-underscore-dangle': 'off',
+    'max-len': [
+      'warn',
+      {
+        code: 100,
+        tabWidth: 2,
+        comments: 100,
+        ignoreComments: false,
+        ignoreTrailingComments: true,
+        ignoreUrls: true,
+        ignoreStrings: true,
+        ignoreTemplateLiterals: true,
+        ignoreRegExpLiterals: true,
+      },
+    ],
+  },
+};

package/.prettierrc.js

@@ -0,0 +1,5 @@
+module.exports = {
+  "printWidth": 100,
+  "singleQuote": true,
+  "trailingComma": "es5"
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Finch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# react-finch-connect
+
+>
+
+[![NPM](https://img.shields.io/npm/v/@tryfinch/react-connect)](https://www.npmjs.com/package/@tryfinch/react-connect) [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
+
+## Install
+
+```bash
+npm install --save @tryfinch/react-connect
+```
+
+## Usage
+
+```jsx
+import React, { useState } from 'react';
+import { useFinchConnect } from '@tryfinch/react-connect';
+
+const App = () => {
+  const [code, setCode] = useState(null);
+
+  const onSuccess = ({ code }) => setCode(code);
+  const onError = ({ errorMessage }) => console.error(errorMessage);
+  const onClose = () => console.log('User exited Finch Connect');
+
+  const { open } = useFinchConnect({
+    clientId: '<your-client-id>',
+    // The below are only a few of Finch's product scopes, please check Finch's [documentation](https://developer.tryfinch.com/docs/reference/ZG9jOjMxOTg1NTI3-permissions) for the full list
+    products: ['company', 'directory'],
+    // Check Finch's [documentation](https://developer.tryfinch.com/docs/reference/96f5be9e0ec1a-providers) for the full list of payroll provider IDs
+    // payrollProvider: '<payroll-provider-id>',
+    // sandbox: false,
+    // manual: false,
+    // zIndex: 999,
+    onSuccess,
+    onError,
+    onClose,
+  });
+
+  return (
+    <div>
+      <header>
+        <p>Code: {code}</p>
+        <button type="button" onClick={() => open()}>
+          Open Finch Connect
+        </button>
+      </header>
+    </div>
+  );
+};
+```

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+declare module 'react-finch-connect' {
+  export type SuccessEvent = {
+    code: string;
+  };
+
+  export type ErrorEvent = {
+    errorMessage: string;
+  };
+
+  export type ConnectOptions = {
+    clientId: string;
+    products?: string[];
+    mode?: string;
+    manual?: boolean;
+    payrollProvider?: string;
+    sandbox?: boolean;
+    category?: string;
+    onSuccess?: (e: SuccessEvent) => void;
+    onError?: (e: ErrorEvent) => void;
+    onClose?: () => void;
+    zIndex?: bigint | string;
+  };
+
+  export function useFinchConnect(opts: ConnectOptions): { open: () => void };
+}

package/dist/index.es.js

@@ -0,0 +1,120 @@
+import { useEffect } from 'react';
+
+var BASE_FINCH_CONNECT_URI = 'https://connect.tryfinch.com';
+var DEFAULT_FINCH_REDIRECT_URI = 'https://tryfinch.com';
+var FINCH_CONNECT_IFRAME_ID = 'finch-connect-iframe';
+var FINCH_AUTH_MESSAGE_NAME = 'finch-auth-message';
+
+var noop = function noop() {}; // eslint-disable-next-line import/prefer-default-export
+
+
+var useFinchConnect = function useFinchConnect() {
+  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var clientId = options.clientId,
+      _options$products = options.products,
+      products = _options$products === void 0 ? [] : _options$products,
+      _options$mode = options.mode,
+      mode = _options$mode === void 0 ? 'employer' : _options$mode,
+      category = options.category,
+      _options$manual = options.manual,
+      manual = _options$manual === void 0 ? false : _options$manual,
+      _options$payrollProvi = options.payrollProvider,
+      payrollProvider = _options$payrollProvi === void 0 ? null : _options$payrollProvi,
+      _options$sandbox = options.sandbox,
+      sandbox = _options$sandbox === void 0 ? false : _options$sandbox,
+      _options$onSuccess = options.onSuccess,
+      onSuccess = _options$onSuccess === void 0 ? noop : _options$onSuccess,
+      _options$onError = options.onError,
+      onError = _options$onError === void 0 ? noop : _options$onError,
+      _options$onClose = options.onClose,
+      onClose = _options$onClose === void 0 ? noop : _options$onClose,
+      _options$zIndex = options.zIndex,
+      zIndex = _options$zIndex === void 0 ? 999 : _options$zIndex;
+
+  var _constructAuthUrl = function _constructAuthUrl(clientId, products) {
+    var authUrl = new URL("".concat(BASE_FINCH_CONNECT_URI, "/authorize"));
+    if (clientId) authUrl.searchParams.append('client_id', clientId);
+    if (payrollProvider) authUrl.searchParams.append('payroll_provider', payrollProvider);
+    if (category) authUrl.searchParams.append('category', category);
+    authUrl.searchParams.append('products', products.join(' '));
+    authUrl.searchParams.append('app_type', 'spa');
+    authUrl.searchParams.append('redirect_uri', DEFAULT_FINCH_REDIRECT_URI);
+    authUrl.searchParams.append('mode', mode);
+    if (manual) authUrl.searchParams.append('manual', manual);
+    if (sandbox) authUrl.searchParams.append('sandbox', sandbox);
+    /* global "2.8.0" */
+
+    authUrl.searchParams.append('sdk_version', "react-".concat("2.8.0"));
+    return authUrl.href;
+  };
+
+  var open = function open() {
+    if (document.getElementById(FINCH_CONNECT_IFRAME_ID)) {
+      return null;
+    }
+
+    var iframe = document.createElement('iframe');
+    iframe.src = _constructAuthUrl(clientId, products);
+    iframe.frameBorder = '0';
+    iframe.id = FINCH_CONNECT_IFRAME_ID;
+    iframe.style.position = 'fixed';
+    iframe.style.zIndex = zIndex.toString();
+    iframe.style.height = '100%';
+    iframe.style.width = '100%';
+    iframe.style.top = '0';
+    iframe.style.backgroundColor = 'none transparent';
+    iframe.style.border = 'none';
+    document.body.prepend(iframe);
+    document.body.style.overflow = 'hidden';
+  };
+
+  var close = function close() {
+    var frameToRemove = document.getElementById(FINCH_CONNECT_IFRAME_ID);
+
+    if (frameToRemove) {
+      frameToRemove.parentNode.removeChild(frameToRemove);
+      document.body.style.overflow = 'inherit';
+    }
+  };
+
+  useEffect(function () {
+    function handleFinchAuth(event) {
+      var handleFinchAuthSuccess = function handleFinchAuthSuccess(code) {
+        return onSuccess({
+          code: code
+        });
+      };
+
+      var handleFinchAuthError = function handleFinchAuthError(error) {
+        return onError({
+          errorMessage: error
+        });
+      };
+
+      var handleFinchAuthClose = function handleFinchAuthClose() {
+        return onClose();
+      };
+
+      if (!event.data) return;
+      if (event.data.name !== FINCH_AUTH_MESSAGE_NAME) return;
+      if (!event.origin.startsWith(BASE_FINCH_CONNECT_URI)) return;
+      var _event$data = event.data,
+          code = _event$data.code,
+          error = _event$data.error,
+          closed = _event$data.closed;
+      close();
+      if (code) handleFinchAuthSuccess(code);else if (error) handleFinchAuthError(error);else if (closed) handleFinchAuthClose();
+    }
+
+    window.addEventListener('message', handleFinchAuth);
+    return function () {
+      return window.removeEventListener('message', handleFinchAuth);
+    };
+  }, [onClose, onError, onSuccess]);
+  return {
+    open: open
+  };
+};
+
+export { useFinchConnect };
+//# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.es.js","sources":["../src/index.js"],"sourcesContent":["import { useEffect } from 'react';\n\nconst BASE_FINCH_CONNECT_URI = 'https://connect.tryfinch.com';\nconst DEFAULT_FINCH_REDIRECT_URI = 'https://tryfinch.com';\nconst FINCH_CONNECT_IFRAME_ID = 'finch-connect-iframe';\nconst FINCH_AUTH_MESSAGE_NAME = 'finch-auth-message';\n\nconst noop = () => {};\n\n// eslint-disable-next-line import/prefer-default-export\nexport const useFinchConnect = (options = {}) => {\n  const {\n    clientId,\n    products = [],\n    mode = 'employer',\n    category,\n    manual = false,\n    payrollProvider = null,\n    sandbox = false,\n    onSuccess = noop,\n    onError = noop,\n    onClose = noop,\n    zIndex = 999,\n  } = options;\n\n  const _constructAuthUrl = (clientId, products) => {\n    const authUrl = new URL(`${BASE_FINCH_CONNECT_URI}/authorize`);\n\n    if (clientId) authUrl.searchParams.append('client_id', clientId);\n    if (payrollProvider) authUrl.searchParams.append('payroll_provider', payrollProvider);\n    if (category) authUrl.searchParams.append('category', category);\n    authUrl.searchParams.append('products', products.join(' '));\n    authUrl.searchParams.append('app_type', 'spa');\n    authUrl.searchParams.append('redirect_uri', DEFAULT_FINCH_REDIRECT_URI);\n    authUrl.searchParams.append('mode', mode);\n    if (manual) authUrl.searchParams.append('manual', manual);\n    if (sandbox) authUrl.searchParams.append('sandbox', sandbox);\n    /* global SDK_VERSION */\n    if (SDK_VERSION) authUrl.searchParams.append('sdk_version', `react-${SDK_VERSION}`);\n\n    return authUrl.href;\n  };\n\n  const open = () => {\n    if (document.getElementById(FINCH_CONNECT_IFRAME_ID)) {\n      return null;\n    }\n\n    const iframe = document.createElement('iframe');\n    iframe.src = _constructAuthUrl(clientId, products);\n    iframe.frameBorder = '0';\n    iframe.id = FINCH_CONNECT_IFRAME_ID;\n    iframe.style.position = 'fixed';\n    iframe.style.zIndex = zIndex.toString();\n    iframe.style.height = '100%';\n    iframe.style.width = '100%';\n    iframe.style.top = '0';\n    iframe.style.backgroundColor = 'none transparent';\n    iframe.style.border = 'none';\n    document.body.prepend(iframe);\n    document.body.style.overflow = 'hidden';\n  };\n\n  const close = () => {\n    const frameToRemove = document.getElementById(FINCH_CONNECT_IFRAME_ID);\n    if (frameToRemove) {\n      frameToRemove.parentNode.removeChild(frameToRemove);\n      document.body.style.overflow = 'inherit';\n    }\n  };\n\n  useEffect(() => {\n    function handleFinchAuth(event) {\n      const handleFinchAuthSuccess = (code) => onSuccess({ code });\n      const handleFinchAuthError = (error) => onError({ errorMessage: error });\n      const handleFinchAuthClose = () => onClose();\n\n      if (!event.data) return;\n      if (event.data.name !== FINCH_AUTH_MESSAGE_NAME) return;\n      if (!event.origin.startsWith(BASE_FINCH_CONNECT_URI)) return;\n\n      const { code, error, closed } = event.data;\n\n      close();\n      if (code) handleFinchAuthSuccess(code);\n      else if (error) handleFinchAuthError(error);\n      else if (closed) handleFinchAuthClose();\n    }\n\n    window.addEventListener('message', handleFinchAuth);\n    return () => window.removeEventListener('message', handleFinchAuth);\n  }, [onClose, onError, onSuccess]);\n\n  return {\n    open,\n  };\n};\n"],"names":["BASE_FINCH_CONNECT_URI","DEFAULT_FINCH_REDIRECT_URI","FINCH_CONNECT_IFRAME_ID","FINCH_AUTH_MESSAGE_NAME","noop","useFinchConnect","options","clientId","products","mode","category","manual","payrollProvider","sandbox","onSuccess","onError","onClose","zIndex","_constructAuthUrl","authUrl","URL","searchParams","append","join","SDK_VERSION","href","open","document","getElementById","iframe","createElement","src","frameBorder","id","style","position","toString","height","width","top","backgroundColor","border","body","prepend","overflow","close","frameToRemove","parentNode","removeChild","useEffect","handleFinchAuth","event","handleFinchAuthSuccess","code","handleFinchAuthError","error","errorMessage","handleFinchAuthClose","data","name","origin","startsWith","closed","window","addEventListener","removeEventListener"],"mappings":";;AAEA,IAAMA,sBAAsB,GAAG,8BAA/B,CAAA;AACA,IAAMC,0BAA0B,GAAG,sBAAnC,CAAA;AACA,IAAMC,uBAAuB,GAAG,sBAAhC,CAAA;AACA,IAAMC,uBAAuB,GAAG,oBAAhC,CAAA;;AAEA,IAAMC,IAAI,GAAG,SAAPA,IAAO,GAAM,EAAnB;;;AAGaC,IAAAA,eAAe,GAAG,SAAlBA,eAAkB,GAAkB;EAAA,IAAjBC,OAAiB,uEAAP,EAAO,CAAA;AAC/C,EAAA,IACEC,QADF,GAYID,OAZJ,CACEC,QADF;MAYID,iBAAAA,GAAAA,OAZJ,CAEEE,QAFF;MAEEA,QAFF,kCAEa,EAFb,GAAA,iBAAA;MAYIF,aAAAA,GAAAA,OAZJ,CAGEG,IAHF;MAGEA,IAHF,8BAGS,UAHT,GAAA,aAAA;AAAA,MAIEC,QAJF,GAYIJ,OAZJ,CAIEI,QAJF;MAYIJ,eAAAA,GAAAA,OAZJ,CAKEK,MALF;MAKEA,MALF,gCAKW,KALX,GAAA,eAAA;MAYIL,qBAAAA,GAAAA,OAZJ,CAMEM,eANF;MAMEA,eANF,sCAMoB,IANpB,GAAA,qBAAA;MAYIN,gBAAAA,GAAAA,OAZJ,CAOEO,OAPF;MAOEA,OAPF,iCAOY,KAPZ,GAAA,gBAAA;MAYIP,kBAAAA,GAAAA,OAZJ,CAQEQ,SARF;MAQEA,SARF,mCAQcV,IARd,GAAA,kBAAA;MAYIE,gBAAAA,GAAAA,OAZJ,CASES,OATF;MASEA,OATF,iCASYX,IATZ,GAAA,gBAAA;MAYIE,gBAAAA,GAAAA,OAZJ,CAUEU,OAVF;MAUEA,OAVF,iCAUYZ,IAVZ,GAAA,gBAAA;MAYIE,eAAAA,GAAAA,OAZJ,CAWEW,MAXF;MAWEA,MAXF,gCAWW,GAXX,GAAA,eAAA,CAAA;;EAcA,IAAMC,iBAAiB,GAAG,SAApBA,iBAAoB,CAACX,QAAD,EAAWC,QAAX,EAAwB;AAChD,IAAA,IAAMW,OAAO,GAAG,IAAIC,GAAJ,CAAA,EAAA,CAAA,MAAA,CAAWpB,sBAAX,EAAhB,YAAA,CAAA,CAAA,CAAA;IAEA,IAAIO,QAAJ,EAAcY,OAAO,CAACE,YAAR,CAAqBC,MAArB,CAA4B,WAA5B,EAAyCf,QAAzC,CAAA,CAAA;IACd,IAAIK,eAAJ,EAAqBO,OAAO,CAACE,YAAR,CAAqBC,MAArB,CAA4B,kBAA5B,EAAgDV,eAAhD,CAAA,CAAA;IACrB,IAAIF,QAAJ,EAAcS,OAAO,CAACE,YAAR,CAAqBC,MAArB,CAA4B,UAA5B,EAAwCZ,QAAxC,CAAA,CAAA;AACdS,IAAAA,OAAO,CAACE,YAAR,CAAqBC,MAArB,CAA4B,UAA5B,EAAwCd,QAAQ,CAACe,IAAT,CAAc,GAAd,CAAxC,CAAA,CAAA;AACAJ,IAAAA,OAAO,CAACE,YAAR,CAAqBC,MAArB,CAA4B,UAA5B,EAAwC,KAAxC,CAAA,CAAA;AACAH,IAAAA,OAAO,CAACE,YAAR,CAAqBC,MAArB,CAA4B,cAA5B,EAA4CrB,0BAA5C,CAAA,CAAA;AACAkB,IAAAA,OAAO,CAACE,YAAR,CAAqBC,MAArB,CAA4B,MAA5B,EAAoCb,IAApC,CAAA,CAAA;IACA,IAAIE,MAAJ,EAAYQ,OAAO,CAACE,YAAR,CAAqBC,MAArB,CAA4B,QAA5B,EAAsCX,MAAtC,CAAA,CAAA;IACZ,IAAIE,OAAJ,EAAaM,OAAO,CAACE,YAAR,CAAqBC,MAArB,CAA4B,SAA5B,EAAuCT,OAAvC,CAAA,CAAA;AACb;;IACiBM,OAAO,CAACE,YAAR,CAAqBC,MAArB,CAA4B,aAA5B,EAAA,QAAA,CAAA,MAAA,CAAoDE,OAApD,CAAA,CAAA,CAAA;IAEjB,OAAOL,OAAO,CAACM,IAAf,CAAA;GAfF,CAAA;;AAkBA,EAAA,IAAMC,IAAI,GAAG,SAAPA,IAAO,GAAM;AACjB,IAAA,IAAIC,QAAQ,CAACC,cAAT,CAAwB1B,uBAAxB,CAAJ,EAAsD;AACpD,MAAA,OAAO,IAAP,CAAA;AACD,KAAA;;AAED,IAAA,IAAM2B,MAAM,GAAGF,QAAQ,CAACG,aAAT,CAAuB,QAAvB,CAAf,CAAA;IACAD,MAAM,CAACE,GAAP,GAAab,iBAAiB,CAACX,QAAD,EAAWC,QAAX,CAA9B,CAAA;IACAqB,MAAM,CAACG,WAAP,GAAqB,GAArB,CAAA;IACAH,MAAM,CAACI,EAAP,GAAY/B,uBAAZ,CAAA;AACA2B,IAAAA,MAAM,CAACK,KAAP,CAAaC,QAAb,GAAwB,OAAxB,CAAA;IACAN,MAAM,CAACK,KAAP,CAAajB,MAAb,GAAsBA,MAAM,CAACmB,QAAP,EAAtB,CAAA;AACAP,IAAAA,MAAM,CAACK,KAAP,CAAaG,MAAb,GAAsB,MAAtB,CAAA;AACAR,IAAAA,MAAM,CAACK,KAAP,CAAaI,KAAb,GAAqB,MAArB,CAAA;AACAT,IAAAA,MAAM,CAACK,KAAP,CAAaK,GAAb,GAAmB,GAAnB,CAAA;AACAV,IAAAA,MAAM,CAACK,KAAP,CAAaM,eAAb,GAA+B,kBAA/B,CAAA;AACAX,IAAAA,MAAM,CAACK,KAAP,CAAaO,MAAb,GAAsB,MAAtB,CAAA;AACAd,IAAAA,QAAQ,CAACe,IAAT,CAAcC,OAAd,CAAsBd,MAAtB,CAAA,CAAA;AACAF,IAAAA,QAAQ,CAACe,IAAT,CAAcR,KAAd,CAAoBU,QAApB,GAA+B,QAA/B,CAAA;GAjBF,CAAA;;AAoBA,EAAA,IAAMC,KAAK,GAAG,SAARA,KAAQ,GAAM;AAClB,IAAA,IAAMC,aAAa,GAAGnB,QAAQ,CAACC,cAAT,CAAwB1B,uBAAxB,CAAtB,CAAA;;AACA,IAAA,IAAI4C,aAAJ,EAAmB;AACjBA,MAAAA,aAAa,CAACC,UAAd,CAAyBC,WAAzB,CAAqCF,aAArC,CAAA,CAAA;AACAnB,MAAAA,QAAQ,CAACe,IAAT,CAAcR,KAAd,CAAoBU,QAApB,GAA+B,SAA/B,CAAA;AACD,KAAA;GALH,CAAA;;AAQAK,EAAAA,SAAS,CAAC,YAAM;IACd,SAASC,eAAT,CAAyBC,KAAzB,EAAgC;AAC9B,MAAA,IAAMC,sBAAsB,GAAG,SAAzBA,sBAAyB,CAACC,IAAD,EAAA;AAAA,QAAA,OAAUvC,SAAS,CAAC;AAAEuC,UAAAA,IAAI,EAAJA,IAAAA;AAAF,SAAD,CAAnB,CAAA;OAA/B,CAAA;;AACA,MAAA,IAAMC,oBAAoB,GAAG,SAAvBA,oBAAuB,CAACC,KAAD,EAAA;AAAA,QAAA,OAAWxC,OAAO,CAAC;AAAEyC,UAAAA,YAAY,EAAED,KAAAA;AAAhB,SAAD,CAAlB,CAAA;OAA7B,CAAA;;MACA,IAAME,oBAAoB,GAAG,SAAvBA,oBAAuB,GAAA;AAAA,QAAA,OAAMzC,OAAO,EAAb,CAAA;OAA7B,CAAA;;AAEA,MAAA,IAAI,CAACmC,KAAK,CAACO,IAAX,EAAiB,OAAA;AACjB,MAAA,IAAIP,KAAK,CAACO,IAAN,CAAWC,IAAX,KAAoBxD,uBAAxB,EAAiD,OAAA;MACjD,IAAI,CAACgD,KAAK,CAACS,MAAN,CAAaC,UAAb,CAAwB7D,sBAAxB,CAAL,EAAsD,OAAA;MAEtD,IAAgCmD,WAAAA,GAAAA,KAAK,CAACO,IAAtC;UAAQL,IAAR,eAAQA,IAAR;UAAcE,KAAd,eAAcA,KAAd;UAAqBO,MAArB,eAAqBA,MAArB,CAAA;MAEAjB,KAAK,EAAA,CAAA;MACL,IAAIQ,IAAJ,EAAUD,sBAAsB,CAACC,IAAD,CAAtB,CAAV,KACK,IAAIE,KAAJ,EAAWD,oBAAoB,CAACC,KAAD,CAApB,CAAX,KACA,IAAIO,MAAJ,EAAYL,oBAAoB,EAAA,CAAA;AACtC,KAAA;;AAEDM,IAAAA,MAAM,CAACC,gBAAP,CAAwB,SAAxB,EAAmCd,eAAnC,CAAA,CAAA;IACA,OAAO,YAAA;AAAA,MAAA,OAAMa,MAAM,CAACE,mBAAP,CAA2B,SAA3B,EAAsCf,eAAtC,CAAN,CAAA;KAAP,CAAA;GAnBO,EAoBN,CAAClC,OAAD,EAAUD,OAAV,EAAmBD,SAAnB,CApBM,CAAT,CAAA;EAsBA,OAAO;AACLY,IAAAA,IAAI,EAAJA,IAAAA;GADF,CAAA;AAGD;;;;"}

package/dist/index.js

@@ -0,0 +1,124 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var react = require('react');
+
+var BASE_FINCH_CONNECT_URI = 'https://connect.tryfinch.com';
+var DEFAULT_FINCH_REDIRECT_URI = 'https://tryfinch.com';
+var FINCH_CONNECT_IFRAME_ID = 'finch-connect-iframe';
+var FINCH_AUTH_MESSAGE_NAME = 'finch-auth-message';
+
+var noop = function noop() {}; // eslint-disable-next-line import/prefer-default-export
+
+
+var useFinchConnect = function useFinchConnect() {
+  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var clientId = options.clientId,
+      _options$products = options.products,
+      products = _options$products === void 0 ? [] : _options$products,
+      _options$mode = options.mode,
+      mode = _options$mode === void 0 ? 'employer' : _options$mode,
+      category = options.category,
+      _options$manual = options.manual,
+      manual = _options$manual === void 0 ? false : _options$manual,
+      _options$payrollProvi = options.payrollProvider,
+      payrollProvider = _options$payrollProvi === void 0 ? null : _options$payrollProvi,
+      _options$sandbox = options.sandbox,
+      sandbox = _options$sandbox === void 0 ? false : _options$sandbox,
+      _options$onSuccess = options.onSuccess,
+      onSuccess = _options$onSuccess === void 0 ? noop : _options$onSuccess,
+      _options$onError = options.onError,
+      onError = _options$onError === void 0 ? noop : _options$onError,
+      _options$onClose = options.onClose,
+      onClose = _options$onClose === void 0 ? noop : _options$onClose,
+      _options$zIndex = options.zIndex,
+      zIndex = _options$zIndex === void 0 ? 999 : _options$zIndex;
+
+  var _constructAuthUrl = function _constructAuthUrl(clientId, products) {
+    var authUrl = new URL("".concat(BASE_FINCH_CONNECT_URI, "/authorize"));
+    if (clientId) authUrl.searchParams.append('client_id', clientId);
+    if (payrollProvider) authUrl.searchParams.append('payroll_provider', payrollProvider);
+    if (category) authUrl.searchParams.append('category', category);
+    authUrl.searchParams.append('products', products.join(' '));
+    authUrl.searchParams.append('app_type', 'spa');
+    authUrl.searchParams.append('redirect_uri', DEFAULT_FINCH_REDIRECT_URI);
+    authUrl.searchParams.append('mode', mode);
+    if (manual) authUrl.searchParams.append('manual', manual);
+    if (sandbox) authUrl.searchParams.append('sandbox', sandbox);
+    /* global "2.8.0" */
+
+    authUrl.searchParams.append('sdk_version', "react-".concat("2.8.0"));
+    return authUrl.href;
+  };
+
+  var open = function open() {
+    if (document.getElementById(FINCH_CONNECT_IFRAME_ID)) {
+      return null;
+    }
+
+    var iframe = document.createElement('iframe');
+    iframe.src = _constructAuthUrl(clientId, products);
+    iframe.frameBorder = '0';
+    iframe.id = FINCH_CONNECT_IFRAME_ID;
+    iframe.style.position = 'fixed';
+    iframe.style.zIndex = zIndex.toString();
+    iframe.style.height = '100%';
+    iframe.style.width = '100%';
+    iframe.style.top = '0';
+    iframe.style.backgroundColor = 'none transparent';
+    iframe.style.border = 'none';
+    document.body.prepend(iframe);
+    document.body.style.overflow = 'hidden';
+  };
+
+  var close = function close() {
+    var frameToRemove = document.getElementById(FINCH_CONNECT_IFRAME_ID);
+
+    if (frameToRemove) {
+      frameToRemove.parentNode.removeChild(frameToRemove);
+      document.body.style.overflow = 'inherit';
+    }
+  };
+
+  react.useEffect(function () {
+    function handleFinchAuth(event) {
+      var handleFinchAuthSuccess = function handleFinchAuthSuccess(code) {
+        return onSuccess({
+          code: code
+        });
+      };
+
+      var handleFinchAuthError = function handleFinchAuthError(error) {
+        return onError({
+          errorMessage: error
+        });
+      };
+
+      var handleFinchAuthClose = function handleFinchAuthClose() {
+        return onClose();
+      };
+
+      if (!event.data) return;
+      if (event.data.name !== FINCH_AUTH_MESSAGE_NAME) return;
+      if (!event.origin.startsWith(BASE_FINCH_CONNECT_URI)) return;
+      var _event$data = event.data,
+          code = _event$data.code,
+          error = _event$data.error,
+          closed = _event$data.closed;
+      close();
+      if (code) handleFinchAuthSuccess(code);else if (error) handleFinchAuthError(error);else if (closed) handleFinchAuthClose();
+    }
+
+    window.addEventListener('message', handleFinchAuth);
+    return function () {
+      return window.removeEventListener('message', handleFinchAuth);
+    };
+  }, [onClose, onError, onSuccess]);
+  return {
+    open: open
+  };
+};
+
+exports.useFinchConnect = useFinchConnect;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.js"],"sourcesContent":["import { useEffect } from 'react';\n\nconst BASE_FINCH_CONNECT_URI = 'https://connect.tryfinch.com';\nconst DEFAULT_FINCH_REDIRECT_URI = 'https://tryfinch.com';\nconst FINCH_CONNECT_IFRAME_ID = 'finch-connect-iframe';\nconst FINCH_AUTH_MESSAGE_NAME = 'finch-auth-message';\n\nconst noop = () => {};\n\n// eslint-disable-next-line import/prefer-default-export\nexport const useFinchConnect = (options = {}) => {\n  const {\n    clientId,\n    products = [],\n    mode = 'employer',\n    category,\n    manual = false,\n    payrollProvider = null,\n    sandbox = false,\n    onSuccess = noop,\n    onError = noop,\n    onClose = noop,\n    zIndex = 999,\n  } = options;\n\n  const _constructAuthUrl = (clientId, products) => {\n    const authUrl = new URL(`${BASE_FINCH_CONNECT_URI}/authorize`);\n\n    if (clientId) authUrl.searchParams.append('client_id', clientId);\n    if (payrollProvider) authUrl.searchParams.append('payroll_provider', payrollProvider);\n    if (category) authUrl.searchParams.append('category', category);\n    authUrl.searchParams.append('products', products.join(' '));\n    authUrl.searchParams.append('app_type', 'spa');\n    authUrl.searchParams.append('redirect_uri', DEFAULT_FINCH_REDIRECT_URI);\n    authUrl.searchParams.append('mode', mode);\n    if (manual) authUrl.searchParams.append('manual', manual);\n    if (sandbox) authUrl.searchParams.append('sandbox', sandbox);\n    /* global SDK_VERSION */\n    if (SDK_VERSION) authUrl.searchParams.append('sdk_version', `react-${SDK_VERSION}`);\n\n    return authUrl.href;\n  };\n\n  const open = () => {\n    if (document.getElementById(FINCH_CONNECT_IFRAME_ID)) {\n      return null;\n    }\n\n    const iframe = document.createElement('iframe');\n    iframe.src = _constructAuthUrl(clientId, products);\n    iframe.frameBorder = '0';\n    iframe.id = FINCH_CONNECT_IFRAME_ID;\n    iframe.style.position = 'fixed';\n    iframe.style.zIndex = zIndex.toString();\n    iframe.style.height = '100%';\n    iframe.style.width = '100%';\n    iframe.style.top = '0';\n    iframe.style.backgroundColor = 'none transparent';\n    iframe.style.border = 'none';\n    document.body.prepend(iframe);\n    document.body.style.overflow = 'hidden';\n  };\n\n  const close = () => {\n    const frameToRemove = document.getElementById(FINCH_CONNECT_IFRAME_ID);\n    if (frameToRemove) {\n      frameToRemove.parentNode.removeChild(frameToRemove);\n      document.body.style.overflow = 'inherit';\n    }\n  };\n\n  useEffect(() => {\n    function handleFinchAuth(event) {\n      const handleFinchAuthSuccess = (code) => onSuccess({ code });\n      const handleFinchAuthError = (error) => onError({ errorMessage: error });\n      const handleFinchAuthClose = () => onClose();\n\n      if (!event.data) return;\n      if (event.data.name !== FINCH_AUTH_MESSAGE_NAME) return;\n      if (!event.origin.startsWith(BASE_FINCH_CONNECT_URI)) return;\n\n      const { code, error, closed } = event.data;\n\n      close();\n      if (code) handleFinchAuthSuccess(code);\n      else if (error) handleFinchAuthError(error);\n      else if (closed) handleFinchAuthClose();\n    }\n\n    window.addEventListener('message', handleFinchAuth);\n    return () => window.removeEventListener('message', handleFinchAuth);\n  }, [onClose, onError, onSuccess]);\n\n  return {\n    open,\n  };\n};\n"],"names":["BASE_FINCH_CONNECT_URI","DEFAULT_FINCH_REDIRECT_URI","FINCH_CONNECT_IFRAME_ID","FINCH_AUTH_MESSAGE_NAME","noop","useFinchConnect","options","clientId","products","mode","category","manual","payrollProvider","sandbox","onSuccess","onError","onClose","zIndex","_constructAuthUrl","authUrl","URL","searchParams","append","join","SDK_VERSION","href","open","document","getElementById","iframe","createElement","src","frameBorder","id","style","position","toString","height","width","top","backgroundColor","border","body","prepend","overflow","close","frameToRemove","parentNode","removeChild","useEffect","handleFinchAuth","event","handleFinchAuthSuccess","code","handleFinchAuthError","error","errorMessage","handleFinchAuthClose","data","name","origin","startsWith","closed","window","addEventListener","removeEventListener"],"mappings":"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"}