@tryfinch/react-connect 3.15.1 → 4.0.0

package/.eslintrc.js

@@ -21,6 +21,7 @@ module.exports = {
     'import/resolver': {
       node: {
         paths: ['src'],
+        extensions: ['.js', '.jsx', '.ts', '.tsx'],
       },
     },
   },
@@ -32,6 +33,16 @@ module.exports = {
     'jsx-a11y/anchor-is-valid': 'off',
     'react/jsx-props-no-spreading': 'off',
     'no-underscore-dangle': 'off',
+    'import/extensions': [
+      'error',
+      'ignorePackages',
+      {
+        js: 'never',
+        jsx: 'never',
+        ts: 'never',
+        tsx: 'never',
+      },
+    ],
     'max-len': [
       'warn',
       {

package/CHANGELOG.md

@@ -0,0 +1,6 @@
+# v4.0.0
+
+## ⚠️ Breaking Changes
+- A session ID is now required when calling the `open` method to launch Finch Connect. You can create a session using the [Connect session endpoint](https://developer.tryfinch.com/api-reference/connect/new-session) on the Finch API.
+- The `state` parameter has been moved from the `initialize` call to the `open` call
+- The `open` call no longer allows overriding values for the auth session, all values must be set in the session created by calling the API

package/README.md

@@ -10,6 +10,8 @@ npm install --save @tryfinch/react-connect
 
 ## Usage
 
+See the example app at `example/src` for a functional example
+
 ```jsx
 import React, { useState } from 'react';
 import { useFinchConnect } from '@tryfinch/react-connect';
@@ -17,33 +19,38 @@ import { useFinchConnect } from '@tryfinch/react-connect';
 const App = () => {
   const [code, setCode] = useState(null);
 
-  const onSuccess = ({ code }) => setCode(code);
+  // Define callbacks
+
+  /**
+   * @param {string} code - The authorization code to exchange for an access token
+   * @param {string?} state - The state value that was provided when launching Connect
+   */
+  const onSuccess = ({ code, state }) => setCode(code);
   /**
    * @param {string} errorMessage - The error message
    * @param {'validation_error' | 'employer_error'} errorType - The type of error
-   * - 'validation_error': Finch Connect failed to open due to validation error
-   * - 'employer_connection_error': The errors employers see within the Finch Connect flow
+   *    - 'validation_error': Finch Connect failed to open due to validation error
+   *    - 'employer_connection_error': The errors employers see within the Finch Connect flow
    */
   const onError = ({ errorMessage, errorType }) => console.error(errorMessage, errorType);
   const onClose = () => console.log('User exited Finch Connect');
 
-  // Generate a session ID using the /connect/sessions endpoint on the Finch API
-  // See the docs here https://developer.tryfinch.com/api-reference/connect/new-session#create-a-new-connect-session
-  const sessionId = '';
-
+  // Initialize the FinchConnect hook
   const { open } = useFinchConnect({
-    sessionId,
-    // zIndex: 999, // Set this to change the z-index of the Connect iframe, defaults to 999
     onSuccess,
     onError,
     onClose,
   });
 
+  // Generate a session ID using the /connect/sessions endpoint on the Finch API
+  // See the docs here https://developer.tryfinch.com/api-reference/connect/new-session#create-a-new-connect-session
+  const sessionId = '';
+
   return (
     <div>
       <header>
         <p>Code: {code}</p>
-        <button type="button" onClick={() => open()}>
+        <button type="button" onClick={() => open({ sessionId })}>
           Open Finch Connect
         </button>
       </header>

package/dist/index.d.ts

@@ -8,35 +8,27 @@ export type ErrorEvent = {
     errorMessage: string;
     errorType?: ErrorType;
 };
-export type Sandbox = 'finch' /** This is to enable the new Finch (simulated) Sandbox */ | 'provider' /** This is to enable the new Provider Sandbox */ | boolean /** This is the old sandbox flag retained for backwards compatibility */;
-type BaseConnectOptions = {
-    state: string | null;
+type ApiConfig = {
+    connectUrl: string;
+};
+export type ConnectInitializeArgs = {
     onSuccess: (e: SuccessEvent) => void;
     onError: (e: ErrorEvent) => void;
     onClose: () => void;
-    zIndex: number;
-    apiConfig?: {
-        connectUrl: string;
-        redirectUrl: string;
-    };
+    apiConfig?: ApiConfig;
 };
-type ConnectOptionsWithSessionId = BaseConnectOptions & {
+export type ConnectLaunchArgs = {
     sessionId: string;
-    products?: string[];
-};
-type ConnectOptionsWithClientId = BaseConnectOptions & {
-    category: string | null;
-    clientId: string;
-    manual: boolean;
-    payrollProvider: string | null;
-    products: string[];
-    clientName?: string;
-    connectionId?: string;
-    sandbox: Sandbox;
+    state?: string;
+    zIndex?: number;
 };
-export type ConnectOptions = ConnectOptionsWithSessionId | ConnectOptionsWithClientId;
-type OpenFn = (overrides?: Partial<ConnectOptions>) => void;
-export declare const useFinchConnect: (options: Partial<ConnectOptions>) => {
+type OpenFn = (args: ConnectLaunchArgs) => void;
+export declare const constructAuthUrl: ({ sessionId, state, apiConfig, }: {
+    sessionId: string;
+    state?: string | undefined;
+    apiConfig?: ApiConfig | undefined;
+}) => string;
+export declare const useFinchConnect: (initializeArgs: ConnectInitializeArgs) => {
     open: OpenFn;
 };
 export {};

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"./","sources":["index.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,SAAS,GAAG,kBAAkB,GAAG,2BAA2B,CAAC;AAElE,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,OAAO,GACf,OAAO,CAAC,0DAA0D,GAClE,UAAU,CAAC,iDAAiD,GAC5D,OAAO,CAAC,wEAAwE,CAAC;AAErF,KAAK,kBAAkB,GAAG;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IACjC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH,CAAC;AAEF,KAAK,2BAA2B,GAAG,kBAAkB,GAAG;IAEtD,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,KAAK,0BAA0B,GAAG,kBAAkB,GAAG;IACrD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,2BAA2B,GAAG,0BAA0B,CAAC;AAEtF,KAAK,MAAM,GAAG,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;AA0G5D,eAAO,MAAM,eAAe,YAAa,QAAQ,cAAc,CAAC;UAAW,MAAM;CAgHhF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"./","sources":["index.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,SAAS,GAAG,kBAAkB,GAAG,2BAA2B,CAAC;AAClE,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IACjC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;AA6BhD,eAAO,MAAM,gBAAgB;eAKhB,MAAM;;;YAkBlB,CAAC;AAIF,eAAO,MAAM,eAAe,mBAAoB,qBAAqB;UAAW,MAAM;CAkGrF,CAAC"}

package/dist/index.es.js

@@ -2,68 +2,23 @@ import { useRef, useEffect } from 'react';
 
 const POST_MESSAGE_NAME = 'finch-auth-message-v2';
 const BASE_FINCH_CONNECT_URI = 'https://connect.tryfinch.com';
-const DEFAULT_FINCH_REDIRECT_URI = 'https://tryfinch.com';
 const FINCH_CONNECT_IFRAME_ID = 'finch-connect-iframe';
-const constructAuthUrl = (connectOptions) => {
-    const { state, apiConfig } = connectOptions;
+const constructAuthUrl = ({ sessionId, state, apiConfig, }) => {
     const CONNECT_URL = (apiConfig === null || apiConfig === void 0 ? void 0 : apiConfig.connectUrl) || BASE_FINCH_CONNECT_URI;
-    const REDIRECT_URL = (apiConfig === null || apiConfig === void 0 ? void 0 : apiConfig.redirectUrl) || DEFAULT_FINCH_REDIRECT_URI;
     const authUrl = new URL(`${CONNECT_URL}/authorize`);
-    if ('sessionId' in connectOptions) {
-        const { sessionId, products } = connectOptions;
-        authUrl.searchParams.append('session', sessionId);
-        if (products)
-            authUrl.searchParams.append('products', products.join(' '));
-    }
-    else {
-        const { clientId, payrollProvider, category, products, manual, sandbox, clientName, connectionId, } = connectOptions;
-        if (clientId)
-            authUrl.searchParams.append('client_id', clientId);
-        if (payrollProvider)
-            authUrl.searchParams.append('payroll_provider', payrollProvider);
-        if (category)
-            authUrl.searchParams.append('category', category);
-        if (clientName)
-            authUrl.searchParams.append('client_name', clientName);
-        if (connectionId)
-            authUrl.searchParams.append('connection_id', connectionId);
-        authUrl.searchParams.append('products', (products !== null && products !== void 0 ? products : []).join(' '));
-        if (manual)
-            authUrl.searchParams.append('manual', String(manual));
-        if (sandbox)
-            authUrl.searchParams.append('sandbox', String(sandbox));
-    }
+    authUrl.searchParams.append('session', sessionId);
     authUrl.searchParams.append('app_type', 'spa');
-    authUrl.searchParams.append('redirect_uri', REDIRECT_URL);
     /** The host URL of the SDK. This is used to store the referrer for postMessage purposes */
     authUrl.searchParams.append('sdk_host_url', window.location.origin);
     authUrl.searchParams.append('mode', 'employer');
     if (state)
         authUrl.searchParams.append('state', state);
     // replace with actual SDK version by rollup
-    authUrl.searchParams.append('sdk_version', 'react-3.15.1');
+    authUrl.searchParams.append('sdk_version', 'react-4.0.0');
     return authUrl.href;
 };
-const noop = () => {
-    // intentionally empty
-};
-const BASE_DEFAULTS = {
-    onSuccess: noop,
-    onError: noop,
-    onClose: noop,
-    state: null,
-    zIndex: 999,
-};
-const DEFAULT_OPTIONS_WITH_CLIENT_ID = Object.assign(Object.assign({}, BASE_DEFAULTS), { clientId: '', category: null, manual: false, payrollProvider: null, products: [], clientName: undefined, sandbox: false });
-const DEFAULT_OPTIONS_WITH_SESSION_ID = Object.assign(Object.assign({}, BASE_DEFAULTS), { sessionId: '' });
 let isUseFinchConnectInitialized = false;
-const useFinchConnect = (options) => {
-    if (!('sessionId' in options) && !('clientId' in options)) {
-        throw new Error('must specify either sessionId or clientId in options for useFinchConnect');
-    }
-    if ('sessionId' in options && 'clientId' in options) {
-        throw new Error('cannot specify both sessionId and clientId in options for useFinchConnect');
-    }
+const useFinchConnect = (initializeArgs) => {
     const isHookMounted = useRef(false);
     useEffect(() => {
         if (!isHookMounted.current) {
@@ -76,17 +31,19 @@ const useFinchConnect = (options) => {
             isHookMounted.current = true;
         }
     }, []);
-    const combinedOptions = 'sessionId' in options
-        ? Object.assign(Object.assign({}, DEFAULT_OPTIONS_WITH_SESSION_ID), options) : Object.assign(Object.assign({}, DEFAULT_OPTIONS_WITH_CLIENT_ID), options);
-    const open = (overrides) => {
-        const openOptions = Object.assign(Object.assign({}, combinedOptions), overrides);
+    const open = (launchArgs) => {
+        var _a;
         if (!document.getElementById(FINCH_CONNECT_IFRAME_ID)) {
             const iframe = document.createElement('iframe');
-            iframe.src = constructAuthUrl(openOptions);
+            iframe.src = constructAuthUrl({
+                sessionId: launchArgs.sessionId,
+                state: launchArgs.state,
+                apiConfig: initializeArgs.apiConfig,
+            });
             iframe.frameBorder = '0';
             iframe.id = FINCH_CONNECT_IFRAME_ID;
             iframe.style.position = 'fixed';
-            iframe.style.zIndex = openOptions.zIndex.toString();
+            iframe.style.zIndex = ((_a = launchArgs.zIndex) === null || _a === void 0 ? void 0 : _a.toString()) || '999';
             iframe.style.height = '100%';
             iframe.style.width = '100%';
             iframe.style.top = '0';
@@ -108,7 +65,7 @@ const useFinchConnect = (options) => {
     useEffect(() => {
         function handleFinchAuth(event) {
             var _a, _b, _c, _d;
-            const CONNECT_URL = ((_a = combinedOptions.apiConfig) === null || _a === void 0 ? void 0 : _a.connectUrl) || BASE_FINCH_CONNECT_URI;
+            const CONNECT_URL = ((_a = initializeArgs.apiConfig) === null || _a === void 0 ? void 0 : _a.connectUrl) || BASE_FINCH_CONNECT_URI;
             if (!event.data)
                 return;
             if (event.data.name !== POST_MESSAGE_NAME)
@@ -119,18 +76,18 @@ const useFinchConnect = (options) => {
                 close();
             switch (event.data.kind) {
                 case 'closed':
-                    combinedOptions.onClose();
+                    initializeArgs.onClose();
                     break;
                 case 'error':
                     if ((_b = event.data.error) === null || _b === void 0 ? void 0 : _b.shouldClose)
                         close();
-                    combinedOptions.onError({
+                    initializeArgs.onError({
                         errorMessage: (_c = event.data.error) === null || _c === void 0 ? void 0 : _c.message,
                         errorType: (_d = event.data.error) === null || _d === void 0 ? void 0 : _d.type,
                     });
                     break;
                 case 'success':
-                    combinedOptions.onSuccess({
+                    initializeArgs.onSuccess({
                         code: event.data.code,
                         state: event.data.state,
                         idpRedirectUri: event.data.idpRedirectUri,
@@ -138,7 +95,7 @@ const useFinchConnect = (options) => {
                     break;
                 default: {
                     // This case should never happen, if it does it should be reported to us
-                    combinedOptions.onError({
+                    initializeArgs.onError({
                         errorMessage: `Report to developers@tryfinch.com: unable to handle window.postMessage for:  ${JSON.stringify(event.data)}`,
                     });
                 }
@@ -149,11 +106,11 @@ const useFinchConnect = (options) => {
             window.removeEventListener('message', handleFinchAuth);
             isUseFinchConnectInitialized = false;
         };
-    }, [combinedOptions.onClose, combinedOptions.onError, combinedOptions.onSuccess]);
+    }, [initializeArgs.onClose, initializeArgs.onError, initializeArgs.onSuccess]);
     return {
         open,
     };
 };
 
-export { useFinchConnect };
+export { constructAuthUrl, useFinchConnect };
 //# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.es.js","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"index.es.js","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/index.js

@@ -6,68 +6,23 @@ var react = require('react');
 
 const POST_MESSAGE_NAME = 'finch-auth-message-v2';
 const BASE_FINCH_CONNECT_URI = 'https://connect.tryfinch.com';
-const DEFAULT_FINCH_REDIRECT_URI = 'https://tryfinch.com';
 const FINCH_CONNECT_IFRAME_ID = 'finch-connect-iframe';
-const constructAuthUrl = (connectOptions) => {
-    const { state, apiConfig } = connectOptions;
+const constructAuthUrl = ({ sessionId, state, apiConfig, }) => {
     const CONNECT_URL = (apiConfig === null || apiConfig === void 0 ? void 0 : apiConfig.connectUrl) || BASE_FINCH_CONNECT_URI;
-    const REDIRECT_URL = (apiConfig === null || apiConfig === void 0 ? void 0 : apiConfig.redirectUrl) || DEFAULT_FINCH_REDIRECT_URI;
     const authUrl = new URL(`${CONNECT_URL}/authorize`);
-    if ('sessionId' in connectOptions) {
-        const { sessionId, products } = connectOptions;
-        authUrl.searchParams.append('session', sessionId);
-        if (products)
-            authUrl.searchParams.append('products', products.join(' '));
-    }
-    else {
-        const { clientId, payrollProvider, category, products, manual, sandbox, clientName, connectionId, } = connectOptions;
-        if (clientId)
-            authUrl.searchParams.append('client_id', clientId);
-        if (payrollProvider)
-            authUrl.searchParams.append('payroll_provider', payrollProvider);
-        if (category)
-            authUrl.searchParams.append('category', category);
-        if (clientName)
-            authUrl.searchParams.append('client_name', clientName);
-        if (connectionId)
-            authUrl.searchParams.append('connection_id', connectionId);
-        authUrl.searchParams.append('products', (products !== null && products !== void 0 ? products : []).join(' '));
-        if (manual)
-            authUrl.searchParams.append('manual', String(manual));
-        if (sandbox)
-            authUrl.searchParams.append('sandbox', String(sandbox));
-    }
+    authUrl.searchParams.append('session', sessionId);
     authUrl.searchParams.append('app_type', 'spa');
-    authUrl.searchParams.append('redirect_uri', REDIRECT_URL);
     /** The host URL of the SDK. This is used to store the referrer for postMessage purposes */
     authUrl.searchParams.append('sdk_host_url', window.location.origin);
     authUrl.searchParams.append('mode', 'employer');
     if (state)
         authUrl.searchParams.append('state', state);
     // replace with actual SDK version by rollup
-    authUrl.searchParams.append('sdk_version', 'react-3.15.1');
+    authUrl.searchParams.append('sdk_version', 'react-4.0.0');
     return authUrl.href;
 };
-const noop = () => {
-    // intentionally empty
-};
-const BASE_DEFAULTS = {
-    onSuccess: noop,
-    onError: noop,
-    onClose: noop,
-    state: null,
-    zIndex: 999,
-};
-const DEFAULT_OPTIONS_WITH_CLIENT_ID = Object.assign(Object.assign({}, BASE_DEFAULTS), { clientId: '', category: null, manual: false, payrollProvider: null, products: [], clientName: undefined, sandbox: false });
-const DEFAULT_OPTIONS_WITH_SESSION_ID = Object.assign(Object.assign({}, BASE_DEFAULTS), { sessionId: '' });
 let isUseFinchConnectInitialized = false;
-const useFinchConnect = (options) => {
-    if (!('sessionId' in options) && !('clientId' in options)) {
-        throw new Error('must specify either sessionId or clientId in options for useFinchConnect');
-    }
-    if ('sessionId' in options && 'clientId' in options) {
-        throw new Error('cannot specify both sessionId and clientId in options for useFinchConnect');
-    }
+const useFinchConnect = (initializeArgs) => {
     const isHookMounted = react.useRef(false);
     react.useEffect(() => {
         if (!isHookMounted.current) {
@@ -80,17 +35,19 @@ const useFinchConnect = (options) => {
             isHookMounted.current = true;
         }
     }, []);
-    const combinedOptions = 'sessionId' in options
-        ? Object.assign(Object.assign({}, DEFAULT_OPTIONS_WITH_SESSION_ID), options) : Object.assign(Object.assign({}, DEFAULT_OPTIONS_WITH_CLIENT_ID), options);
-    const open = (overrides) => {
-        const openOptions = Object.assign(Object.assign({}, combinedOptions), overrides);
+    const open = (launchArgs) => {
+        var _a;
         if (!document.getElementById(FINCH_CONNECT_IFRAME_ID)) {
             const iframe = document.createElement('iframe');
-            iframe.src = constructAuthUrl(openOptions);
+            iframe.src = constructAuthUrl({
+                sessionId: launchArgs.sessionId,
+                state: launchArgs.state,
+                apiConfig: initializeArgs.apiConfig,
+            });
             iframe.frameBorder = '0';
             iframe.id = FINCH_CONNECT_IFRAME_ID;
             iframe.style.position = 'fixed';
-            iframe.style.zIndex = openOptions.zIndex.toString();
+            iframe.style.zIndex = ((_a = launchArgs.zIndex) === null || _a === void 0 ? void 0 : _a.toString()) || '999';
             iframe.style.height = '100%';
             iframe.style.width = '100%';
             iframe.style.top = '0';
@@ -112,7 +69,7 @@ const useFinchConnect = (options) => {
     react.useEffect(() => {
         function handleFinchAuth(event) {
             var _a, _b, _c, _d;
-            const CONNECT_URL = ((_a = combinedOptions.apiConfig) === null || _a === void 0 ? void 0 : _a.connectUrl) || BASE_FINCH_CONNECT_URI;
+            const CONNECT_URL = ((_a = initializeArgs.apiConfig) === null || _a === void 0 ? void 0 : _a.connectUrl) || BASE_FINCH_CONNECT_URI;
             if (!event.data)
                 return;
             if (event.data.name !== POST_MESSAGE_NAME)
@@ -123,18 +80,18 @@ const useFinchConnect = (options) => {
                 close();
             switch (event.data.kind) {
                 case 'closed':
-                    combinedOptions.onClose();
+                    initializeArgs.onClose();
                     break;
                 case 'error':
                     if ((_b = event.data.error) === null || _b === void 0 ? void 0 : _b.shouldClose)
                         close();
-                    combinedOptions.onError({
+                    initializeArgs.onError({
                         errorMessage: (_c = event.data.error) === null || _c === void 0 ? void 0 : _c.message,
                         errorType: (_d = event.data.error) === null || _d === void 0 ? void 0 : _d.type,
                     });
                     break;
                 case 'success':
-                    combinedOptions.onSuccess({
+                    initializeArgs.onSuccess({
                         code: event.data.code,
                         state: event.data.state,
                         idpRedirectUri: event.data.idpRedirectUri,
@@ -142,7 +99,7 @@ const useFinchConnect = (options) => {
                     break;
                 default: {
                     // This case should never happen, if it does it should be reported to us
-                    combinedOptions.onError({
+                    initializeArgs.onError({
                         errorMessage: `Report to developers@tryfinch.com: unable to handle window.postMessage for:  ${JSON.stringify(event.data)}`,
                     });
                 }
@@ -153,11 +110,12 @@ const useFinchConnect = (options) => {
             window.removeEventListener('message', handleFinchAuth);
             isUseFinchConnectInitialized = false;
         };
-    }, [combinedOptions.onClose, combinedOptions.onError, combinedOptions.onSuccess]);
+    }, [initializeArgs.onClose, initializeArgs.onError, initializeArgs.onSuccess]);
     return {
         open,
     };
 };
 
+exports.constructAuthUrl = constructAuthUrl;
 exports.useFinchConnect = useFinchConnect;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":[null],"names":["useRef","useEffect"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":[null],"names":["useRef","useEffect"],"mappings":"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"}

package/dist/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"./","sources":["index.test.ts"],"names":[],"mappings":""}

package/example/package-lock.json

@@ -21,11 +21,12 @@
     },
     "..": {
       "name": "@tryfinch/react-connect",
-      "version": "3.14.0",
+      "version": "4.0.0",
       "license": "MIT",
       "devDependencies": {
         "@rollup/plugin-replace": "^4.0.0",
         "@rollup/plugin-typescript": "^11.1.0",
+        "@types/jest": "^30.0.0",
         "@types/react": "^16.14.40",
         "@typescript-eslint/eslint-plugin": "^5.59.0",
         "@typescript-eslint/parser": "^5.59.0",
@@ -33,9 +34,14 @@
         "eslint-config-airbnb": "^18.2.0",
         "eslint-config-prettier": "^6.11.0",
         "eslint-plugin-prettier": "^3.1.4",
+        "jest": "^30.0.5",
+        "jest-environment-jsdom": "^30.0.5",
+        "jsdom": "^26.1.0",
         "react": "^16.9.0",
         "rollup": "^2.75.7",
         "rollup-plugin-peer-deps-external": "^2.2.0",
+        "ts-jest": "^29.4.1",
+        "tslib": "^2.8.1",
         "typescript": "^4.9.5"
       },
       "engines": {
@@ -21321,6 +21327,7 @@
       "requires": {
         "@rollup/plugin-replace": "^4.0.0",
         "@rollup/plugin-typescript": "^11.1.0",
+        "@types/jest": "^30.0.0",
         "@types/react": "^16.14.40",
         "@typescript-eslint/eslint-plugin": "^5.59.0",
         "@typescript-eslint/parser": "^5.59.0",
@@ -21328,9 +21335,14 @@
         "eslint-config-airbnb": "^18.2.0",
         "eslint-config-prettier": "^6.11.0",
         "eslint-plugin-prettier": "^3.1.4",
+        "jest": "^30.0.5",
+        "jest-environment-jsdom": "^30.0.5",
+        "jsdom": "^26.1.0",
         "react": "^16.9.0",
         "rollup": "^2.75.7",
         "rollup-plugin-peer-deps-external": "^2.2.0",
+        "ts-jest": "^29.4.1",
+        "tslib": "^2.8.1",
         "typescript": "^4.9.5"
       },
       "dependencies": {

package/example/src/App.tsx

@@ -6,36 +6,61 @@ import Result, { ResultContainer } from './Result';
 import './App.css';
 
 const App = () => {
+  const [sessionId, setSessionId] = useState<string>('');
   const [sendState, setSendState] = useState<boolean>(false);
   const [result, setResult] = useState<ResultContainer>();
 
+  // Define callbacks
   const onSuccess = (value: SuccessEvent) => setResult({ kind: 'success', value });
   const onError = (value: ErrorEvent) => setResult({ kind: 'error', value });
   const onClose = () => setResult({ kind: 'closed' });
 
-  const sessionId = '';
-
+  // Initialize the FinchConnect hook
   const { open } = useFinchConnect({
-    sessionId,
     onSuccess,
     onError,
     onClose,
   });
 
-  const submissionHandler: React.FormEventHandler<HTMLFormElement>  = (e) => {
+  // Call the open method when submitting the form
+  const submissionHandler: React.FormEventHandler<HTMLFormElement> = (e) => {
     e.preventDefault();
     open({
-      ...(sendState ? { state: new Date().toISOString() } : undefined),
-    })
+      // Generate a session ID using the /connect/sessions endpoint on the Finch API
+      // See the docs here https://developer.tryfinch.com/api-reference/connect/new-session#create-a-new-connect-session
+      sessionId: sessionId.trim(),
+      // An optional state parameter can be passed
+      // https://datatracker.ietf.org/doc/html/rfc6749#section-10.12
+      ...(sendState ? { state: new Date().toISOString() } : {}),
+      // An optional value for the z-index of the Finch Connect iframe
+      // Defaults to 999 if not provided
+      // zIndex: 998,
+    });
   };
 
   return (
     <div className="container">
-      <h2><a href="https://www.npmjs.com/package/@tryfinch/react-connect">@tryfinch/react-connect</a> Example App</h2>
+      <h2>
+        <a href="https://www.npmjs.com/package/@tryfinch/react-connect">@tryfinch/react-connect</a>{' '}
+        Example App
+      </h2>
       <form className="actions" onSubmit={submissionHandler}>
+        <div className="row">
+          <label className="top-label">Session UUID:</label>
+          <input
+            type="text"
+            placeholder="Enter session UUID"
+            value={sessionId}
+            onChange={(e) => setSessionId(e.target.value)}
+          />
+        </div>
         <div className="row">
           <label className="top-label">Include State:</label>
-          <input type="checkbox" checked={sendState} onChange={() => setSendState(prev => !prev)} />
+          <input
+            type="checkbox"
+            checked={sendState}
+            onChange={() => setSendState((prev) => !prev)}
+          />
         </div>
         <div className="row">
           <button className="cta" type="submit">
@@ -44,8 +69,10 @@ const App = () => {
         </div>
       </form>
       <div className="results">
-          { !result && <p>Complete a Finch Connect session and the success event will be displayed here</p> }
-          { result && <Result result={result} /> }
+        {!result && (
+          <p>Complete a Finch Connect session and the success event will be displayed here</p>
+        )}
+        {result && <Result result={result} />}
       </div>
     </div>
   );

package/jest.config.js

@@ -0,0 +1,7 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'jsdom',
+  roots: ['<rootDir>/src'],
+  testMatch: ['**/__tests__/**/*.test.ts', '**/*.test.ts'],
+  collectCoverageFrom: ['src/**/*.{ts,tsx}', '!src/**/*.d.ts'],
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryfinch/react-connect",
-  "version": "3.15.1",
+  "version": "4.0.0",
   "description": "Finch SDK for embedding Finch Connect in API React Single Page Applications (SPA)",
   "keywords": [
     "finch",
@@ -25,6 +25,8 @@
     "build": "rollup -c",
     "lint": "eslint --ext .js,.jsx,.ts,.tsx src",
     "start": "rollup -c -w",
+    "test": "jest",
+    "test:watch": "jest --watch",
     "prepare": "npm run build",
     "predeploy": "cd example && npm install && npm run build"
   },
@@ -34,6 +36,7 @@
   "devDependencies": {
     "@rollup/plugin-replace": "^4.0.0",
     "@rollup/plugin-typescript": "^11.1.0",
+    "@types/jest": "^30.0.0",
     "@types/react": "^16.14.40",
     "@typescript-eslint/eslint-plugin": "^5.59.0",
     "@typescript-eslint/parser": "^5.59.0",
@@ -41,9 +44,14 @@
     "eslint-config-airbnb": "^18.2.0",
     "eslint-config-prettier": "^6.11.0",
     "eslint-plugin-prettier": "^3.1.4",
+    "jest": "^30.0.5",
+    "jest-environment-jsdom": "^30.0.5",
+    "jsdom": "^26.1.0",
     "react": "^16.9.0",
     "rollup": "^2.75.7",
     "rollup-plugin-peer-deps-external": "^2.2.0",
+    "ts-jest": "^29.4.1",
+    "tslib": "^2.8.1",
     "typescript": "^4.9.5"
   }
 }

package/src/index.test.ts

@@ -0,0 +1,54 @@
+import { constructAuthUrl } from './index';
+
+const NOOP_CALLBACKS = {
+  onSuccess: jest.fn(),
+  onError: jest.fn(),
+  onClose: jest.fn(),
+  zIndex: 999,
+};
+
+describe('Finch React SDK', () => {
+  describe('constructAuthUrl', () => {
+    it('adds the session parameter', () => {
+      const authUrl = constructAuthUrl({
+        sessionId: 'test-session-id',
+      });
+      expect(authUrl).toContain('session=test-session-id');
+    });
+
+    it('adds all the expected base parameters to the auth URL', () => {
+      const expectedParameters = {
+        app_type: 'spa',
+        sdk_host_url: encodeURIComponent('http://localhost'),
+        mode: 'employer',
+        sdk_version: 'react-SDK_VERSION',
+      };
+
+      const authUrl = constructAuthUrl({
+        sessionId: 'test-session-id',
+      });
+
+      Object.entries(expectedParameters).forEach(([key, value]) => {
+        expect(authUrl).toContain(`${key}=${value}`);
+      });
+    });
+
+    it('adds the state parameter if it is provided', () => {
+      const testOptions = { sessionId: 'test-session-id', state: 'test-state', ...NOOP_CALLBACKS };
+      const authUrl = constructAuthUrl(testOptions);
+
+      expect(authUrl).toContain('state=test-state');
+    });
+
+    it('uses the provided connectUrl if provided', () => {
+      const authUrl = constructAuthUrl({
+        sessionId: '123',
+        apiConfig: {
+          connectUrl: 'https://cool.site',
+        },
+        ...NOOP_CALLBACKS,
+      });
+      expect(authUrl.startsWith('https://cool.site/authorize?')).toBe(true);
+    });
+  });
+});

package/src/index.ts

@@ -1,7 +1,5 @@
 import { useEffect, useRef } from 'react';
 
-type HasKey<T, K extends PropertyKey> = T extends Record<K, unknown> ? T : never;
-
 export type SuccessEvent = {
   code: string;
   state?: string;
@@ -9,50 +7,29 @@ export type SuccessEvent = {
 };
 
 type ErrorType = 'validation_error' | 'employer_connection_error';
-
 export type ErrorEvent = {
   errorMessage: string;
   errorType?: ErrorType;
 };
 
-export type Sandbox =
-  | 'finch' /** This is to enable the new Finch (simulated) Sandbox */
-  | 'provider' /** This is to enable the new Provider Sandbox */
-  | boolean /** This is the old sandbox flag retained for backwards compatibility */;
+type ApiConfig = {
+  connectUrl: string;
+};
 
-type BaseConnectOptions = {
-  state: string | null;
+export type ConnectInitializeArgs = {
   onSuccess: (e: SuccessEvent) => void;
   onError: (e: ErrorEvent) => void;
   onClose: () => void;
-  zIndex: number;
-  apiConfig?: {
-    connectUrl: string;
-    redirectUrl: string;
-  };
+  apiConfig?: ApiConfig;
 };
 
-type ConnectOptionsWithSessionId = BaseConnectOptions & {
-  // Use this option if you have a Finch Connect sessionID from the IDP redirect flow
+export type ConnectLaunchArgs = {
   sessionId: string;
-  // Allow for overriding products for the session
-  products?: string[];
-};
-
-type ConnectOptionsWithClientId = BaseConnectOptions & {
-  category: string | null;
-  clientId: string;
-  manual: boolean;
-  payrollProvider: string | null;
-  products: string[];
-  clientName?: string;
-  connectionId?: string;
-  sandbox: Sandbox;
+  state?: string;
+  zIndex?: number;
 };
 
-export type ConnectOptions = ConnectOptionsWithSessionId | ConnectOptionsWithClientId;
-
-type OpenFn = (overrides?: Partial<ConnectOptions>) => void;
+type OpenFn = (args: ConnectLaunchArgs) => void;
 
 const POST_MESSAGE_NAME = 'finch-auth-message-v2' as const;
 
@@ -78,46 +55,24 @@ interface FinchConnectPostMessage {
 }
 
 const BASE_FINCH_CONNECT_URI = 'https://connect.tryfinch.com';
-const DEFAULT_FINCH_REDIRECT_URI = 'https://tryfinch.com';
 
 const FINCH_CONNECT_IFRAME_ID = 'finch-connect-iframe';
 
-const constructAuthUrl = (connectOptions: ConnectOptions) => {
-  const { state, apiConfig } = connectOptions;
-
+export const constructAuthUrl = ({
+  sessionId,
+  state,
+  apiConfig,
+}: {
+  sessionId: string;
+  state?: string;
+  apiConfig?: ApiConfig;
+}) => {
   const CONNECT_URL = apiConfig?.connectUrl || BASE_FINCH_CONNECT_URI;
-  const REDIRECT_URL = apiConfig?.redirectUrl || DEFAULT_FINCH_REDIRECT_URI;
 
   const authUrl = new URL(`${CONNECT_URL}/authorize`);
 
-  if ('sessionId' in connectOptions) {
-    const { sessionId, products } = connectOptions;
-    authUrl.searchParams.append('session', sessionId);
-    if (products) authUrl.searchParams.append('products', products.join(' '));
-  } else {
-    const {
-      clientId,
-      payrollProvider,
-      category,
-      products,
-      manual,
-      sandbox,
-      clientName,
-      connectionId,
-    } = connectOptions;
-
-    if (clientId) authUrl.searchParams.append('client_id', clientId);
-    if (payrollProvider) authUrl.searchParams.append('payroll_provider', payrollProvider);
-    if (category) authUrl.searchParams.append('category', category);
-    if (clientName) authUrl.searchParams.append('client_name', clientName);
-    if (connectionId) authUrl.searchParams.append('connection_id', connectionId);
-    authUrl.searchParams.append('products', (products ?? []).join(' '));
-    if (manual) authUrl.searchParams.append('manual', String(manual));
-    if (sandbox) authUrl.searchParams.append('sandbox', String(sandbox));
-  }
-
+  authUrl.searchParams.append('session', sessionId);
   authUrl.searchParams.append('app_type', 'spa');
-  authUrl.searchParams.append('redirect_uri', REDIRECT_URL);
   /** The host URL of the SDK. This is used to store the referrer for postMessage purposes */
   authUrl.searchParams.append('sdk_host_url', window.location.origin);
   authUrl.searchParams.append('mode', 'employer');
@@ -128,45 +83,9 @@ const constructAuthUrl = (connectOptions: ConnectOptions) => {
   return authUrl.href;
 };
 
-const noop = () => {
-  // intentionally empty
-};
-
-const BASE_DEFAULTS = {
-  onSuccess: noop,
-  onError: noop,
-  onClose: noop,
-  state: null,
-  zIndex: 999,
-};
-
-const DEFAULT_OPTIONS_WITH_CLIENT_ID: HasKey<ConnectOptions, 'clientId'> = {
-  ...BASE_DEFAULTS,
-  clientId: '',
-  category: null,
-  manual: false,
-  payrollProvider: null,
-  products: [],
-  clientName: undefined,
-  sandbox: false,
-};
-
-const DEFAULT_OPTIONS_WITH_SESSION_ID: HasKey<ConnectOptions, 'sessionId'> = {
-  ...BASE_DEFAULTS,
-  sessionId: '',
-};
-
 let isUseFinchConnectInitialized = false;
 
-export const useFinchConnect = (options: Partial<ConnectOptions>): { open: OpenFn } => {
-  if (!('sessionId' in options) && !('clientId' in options)) {
-    throw new Error('must specify either sessionId or clientId in options for useFinchConnect');
-  }
-
-  if ('sessionId' in options && 'clientId' in options) {
-    throw new Error('cannot specify both sessionId and clientId in options for useFinchConnect');
-  }
-
+export const useFinchConnect = (initializeArgs: ConnectInitializeArgs): { open: OpenFn } => {
   const isHookMounted = useRef(false);
 
   useEffect(() => {
@@ -183,24 +102,18 @@ export const useFinchConnect = (options: Partial<ConnectOptions>): { open: OpenF
     }
   }, []);
 
-  const combinedOptions: ConnectOptions =
-    'sessionId' in options
-      ? { ...DEFAULT_OPTIONS_WITH_SESSION_ID, ...options }
-      : { ...DEFAULT_OPTIONS_WITH_CLIENT_ID, ...options };
-
-  const open: OpenFn = (overrides) => {
-    const openOptions: ConnectOptions = {
-      ...combinedOptions,
-      ...overrides,
-    };
-
+  const open: OpenFn = (launchArgs) => {
     if (!document.getElementById(FINCH_CONNECT_IFRAME_ID)) {
       const iframe = document.createElement('iframe');
-      iframe.src = constructAuthUrl(openOptions);
+      iframe.src = constructAuthUrl({
+        sessionId: launchArgs.sessionId,
+        state: launchArgs.state,
+        apiConfig: initializeArgs.apiConfig,
+      });
       iframe.frameBorder = '0';
       iframe.id = FINCH_CONNECT_IFRAME_ID;
       iframe.style.position = 'fixed';
-      iframe.style.zIndex = openOptions.zIndex.toString();
+      iframe.style.zIndex = launchArgs.zIndex?.toString() || '999';
       iframe.style.height = '100%';
       iframe.style.width = '100%';
       iframe.style.top = '0';
@@ -222,7 +135,7 @@ export const useFinchConnect = (options: Partial<ConnectOptions>): { open: OpenF
 
   useEffect(() => {
     function handleFinchAuth(event: FinchConnectPostMessage) {
-      const CONNECT_URL = combinedOptions.apiConfig?.connectUrl || BASE_FINCH_CONNECT_URI;
+      const CONNECT_URL = initializeArgs.apiConfig?.connectUrl || BASE_FINCH_CONNECT_URI;
 
       if (!event.data) return;
       if (event.data.name !== POST_MESSAGE_NAME) return;
@@ -232,18 +145,18 @@ export const useFinchConnect = (options: Partial<ConnectOptions>): { open: OpenF
 
       switch (event.data.kind) {
         case 'closed':
-          combinedOptions.onClose();
+          initializeArgs.onClose();
           break;
         case 'error':
           if (event.data.error?.shouldClose) close();
 
-          combinedOptions.onError({
+          initializeArgs.onError({
             errorMessage: event.data.error?.message,
             errorType: event.data.error?.type,
           });
           break;
         case 'success':
-          combinedOptions.onSuccess({
+          initializeArgs.onSuccess({
             code: event.data.code,
             state: event.data.state,
             idpRedirectUri: event.data.idpRedirectUri,
@@ -251,7 +164,7 @@ export const useFinchConnect = (options: Partial<ConnectOptions>): { open: OpenF
           break;
         default: {
           // This case should never happen, if it does it should be reported to us
-          combinedOptions.onError({
+          initializeArgs.onError({
             errorMessage: `Report to developers@tryfinch.com: unable to handle window.postMessage for:  ${JSON.stringify(
               event.data
             )}`,
@@ -265,7 +178,7 @@ export const useFinchConnect = (options: Partial<ConnectOptions>): { open: OpenF
       window.removeEventListener('message', handleFinchAuth);
       isUseFinchConnectInitialized = false;
     };
-  }, [combinedOptions.onClose, combinedOptions.onError, combinedOptions.onSuccess]);
+  }, [initializeArgs.onClose, initializeArgs.onError, initializeArgs.onSuccess]);
 
   return {
     open,