@taxbit/react-sdk 1.0.0-beta.3 → 1.0.0-beta.4

package/README.md

@@ -4,10 +4,14 @@ A React component and hook for gathering Tax Documentation data for US and EU Ta
 
 ## Usage
 
-The Taxbit React SDK provides a React component and hook for gathering tax documentation data from users. The component can be used to collect data for the Taxbit DPS (Digital Platform Sales) or W-Form (W-9, W-8BEN, W-8BEN-E) tax documentation forms. A hook provides more tools to understand the user's tax documentation status and download any pdf versions of the files that are created if eligible.
+The Taxbit React SDK provides a React component, hook, and Typescript types for gathering tax documentation data from users. The component can be used to collect data for the Taxbit DPS (Digital Platform Sales) or W-Form (W-9, W-8BEN, W-8BEN-E) tax documentation forms. A hook provides more tools to understand the user's tax documentation status and download any pdf versions of the files that are created if eligible.
 
 DPS (Digital Platform Sales) is a data standard and UI flow used by Taxbit to gather the information needed to report income as directed by the DAC7 for the European Union, and equivalent reporting requirements in Canada, New Zealand, and the United Kingdom.
 
+## Beta Stage
+
+During this stage, the Taxbit SDK is fully supported, and can be used in production environments. However, there may be breaking changes without a new major version release. If used in a production environment, Taxbit recommends setting a fixed version, updating regularly, and testing after each update.
+
 ## Installation
 
 ```bash
@@ -22,13 +26,13 @@ import { TaxbitQuestionnaire, ClientTaxDocumentation } from '@taxbit/react-sdk';
 ### Data
 
 ```typescript
-exampleData: ClientTaxDocumentation = {
+const exampleData: ClientTaxDocumentation = {
   accountHolder: {
     name: 'John Smith',
     tin: '456456456',
     ftin: '667788991',
-    usAccountType: 'individual',
-    foreignAccountType: 'individual',
+    usAccountType: 'INDIVIDUAL',
+    foreignAccountType: 'INDIVIDUAL',
     address: {
       firstLine: '123 Main St',
       secondLine: 'Unit #2',
@@ -113,6 +117,27 @@ The WForm component language can be set to 'en', 'fr', or 'es'.
 
 See the `Locale` type below.
 
+## useTaxbit Hook
+
+The `useTaxbit` hook can be used to get the data from the server or the account status.
+
+```typescript
+const {
+  statusData,
+  serverData,
+  canGetDocumentUrl,
+  getNewDocumentUrl,
+  isGettingDocumentUrl,
+  documentUrl,
+} = useTaxbit(bearerToken, questionnaire);
+```
+
+It can also be used to get the document URL for the user's tax documentation. The `getNewDocumentUrl` function will trigger a temporary URL generation. The `documentUrl` will be the URL of the document if it is available. `isGettingDocumentUrl` will be true while the URL is being generated. `canGetDocumentUrl` will be true if the user has submitted the questionnaire and a PDF tax document is available to this user. Note, `DPS` data does not generate a PDF document.
+
+### Server Data
+
+The serverData object contains the currently saved tax documentation data for the user. It is also a `ClientTaxDocumentation` object.
+
 ### Status
 
 The `useTaxbit` hook will return a `status` object that can be used to determine the status of the user's tax documentation. The `status` object will have the following shape:
@@ -265,6 +290,10 @@ type QuestionnaireType = 'DPS' | 'W-FORM';
 
 ## Changelog
 
+### Version 1.0.0-beta.4
+
+1. More explicit typing for TaxbitQuestionnaire component props
+
 ### Version 1.0.0-beta.3
 
 1. Transforming deprecated tax documentation data types for import to SDK

package/dist/src/contexts/TaxDocumentation/useTaxDocumentation.d.ts

@@ -10,7 +10,7 @@ export type UseTaxDocumentationProps = {
     data?: ClientTaxDocumentation;
     language?: Locale;
     externalValidations?: ExternalValidations;
-    onSubmit: (data: ClientTaxDocumentation) => void | Promise<void>;
+    onSubmit?: (data?: ClientTaxDocumentation) => void | Promise<void>;
     onProgress?: (progress: Progress) => void | Promise<void>;
     step?: InputStep;
     questionnaire: Questionnaire;

package/dist/src/entry/TaxbitQuestionnaire/TaxbitQuestionnaire.d.ts

@@ -1,12 +1,26 @@
+import { ClientTaxDocumentation } from '@taxbit/utilities';
 import React from 'react';
-import { TaxbitQuestionnairePersistProps } from 'widgets';
-import { TaxbitQuestionnaireUIProps } from 'wizard';
-import { Questionnaire } from '../../types';
+import type { Locale, Questionnaire } from '../../types';
+import { TaxbitQuestionnairePersistProps } from '../../widgets';
 export type TaxbitQuestionnaireProps = {
+    data?: ClientTaxDocumentation;
+    language?: Locale;
     questionnaire: Questionnaire;
-} & ((TaxbitQuestionnaireUIProps & {
+    onProgress?: TaxbitQuestionnairePersistProps['onProgress'];
+    onSubmit?: TaxbitQuestionnairePersistProps['onSubmit'];
+} & ({
     demoMode: true;
-}) | (TaxbitQuestionnairePersistProps & {
+    bearerToken?: never;
+    onSuccess?: never;
+    onSettled?: never;
+    onError?: never;
+    staging?: never;
+} | {
     demoMode?: false | undefined;
-}));
-export declare const TaxbitQuestionnaire: ({ ...props }: TaxbitQuestionnaireProps) => React.JSX.Element;
+    bearerToken: TaxbitQuestionnairePersistProps['bearerToken'];
+    onSuccess?: TaxbitQuestionnairePersistProps['onSuccess'];
+    onSettled?: TaxbitQuestionnairePersistProps['onSettled'];
+    onError?: TaxbitQuestionnairePersistProps['onError'];
+    staging?: TaxbitQuestionnairePersistProps['staging'];
+});
+export declare const TaxbitQuestionnaire: ({ questionnaire, data, onSubmit, onSuccess, onSettled, onError, language, onProgress, bearerToken, demoMode, staging, }: TaxbitQuestionnaireProps) => React.JSX.Element;

package/dist/src/hooks/useTaxbit/useTaxbitConnect.d.ts

@@ -1,7 +1,7 @@
 import type { SignedClientTaxDocumentation } from '@taxbit/utilities';
 import { Questionnaire } from 'types';
 export declare const useTaxbitConnect: (bearerToken: string, questionnaire: Questionnaire, staging?: boolean) => {
-    doPostData: (data: SignedClientTaxDocumentation) => Promise<Response>;
+    doPostData: (data?: SignedClientTaxDocumentation) => Promise<Response>;
     formStatus: "COMPLETE" | "INCOMPLETE" | undefined;
     serverData: SignedClientTaxDocumentation | undefined;
     statusData: import("../../entry").ClientTaxDocumentationStatus | undefined;

package/dist/src/hooks/useTaxbit/useTaxbitStatus.d.ts

@@ -1,6 +1,6 @@
 import type { SignedClientTaxDocumentation } from '@taxbit/utilities';
-import { Questionnaire } from 'types';
-import type { ClientTaxDocumentationStatus } from 'types/client';
+import { Questionnaire } from '../../types';
+import type { ClientTaxDocumentationStatus } from '../../types/client';
 export declare const useTaxbitStatus: (bearerToken: string, questionnaire: Questionnaire, staging?: boolean) => {
     formStatus: "COMPLETE" | "INCOMPLETE" | undefined;
     serverData: SignedClientTaxDocumentation | undefined;

package/dist/src/widgets/TaxbitQuestionnairePersist/TaxbitQuestionnairePersist.d.ts

@@ -1,5 +1,5 @@
-import type { UseTaxDocumentationProps } from 'contexts';
 import React from 'react';
+import type { UseTaxDocumentationProps } from '../../contexts';
 import { UseTaxbitPersistProps } from './useTaxbitPersist';
-export type TaxbitQuestionnairePersistProps = Omit<UseTaxDocumentationProps, 'onSubmit'> & UseTaxbitPersistProps;
+export type TaxbitQuestionnairePersistProps = UseTaxDocumentationProps & UseTaxbitPersistProps;
 export declare const TaxbitQuestionnairePersist: ({ staging, data, bearerToken, language, questionnaire, onProgress, onSubmit, onSettled, onSuccess, onError, }: TaxbitQuestionnairePersistProps) => React.JSX.Element;

package/dist/src/widgets/TaxbitQuestionnairePersist/useTaxbitPersist.d.ts

@@ -1,7 +1,7 @@
-import { ClientTaxDocumentation, SignedClientTaxDocumentation } from '@taxbit/utilities';
+import { ClientTaxDocumentation } from '@taxbit/utilities';
 import { Questionnaire } from 'types';
 import { ExternalValidations } from 'types/client';
-type TaxbitResponseError = {
+export type TaxbitResponseError = {
     message: string;
     response: Response;
 };
@@ -16,10 +16,9 @@ export type UseTaxbitPersistProps = {
     onSubmit?: (data?: ClientTaxDocumentation) => void | Promise<void>;
 };
 export declare const useTaxbitPersist: ({ bearerToken, data, onSubmit, onSuccess, onSettled, onError, staging, questionnaire, }: UseTaxbitPersistProps) => {
-    handleOnSubmit: (data: SignedClientTaxDocumentation) => Promise<void>;
+    handleOnSubmit: (data?: ClientTaxDocumentation) => Promise<void>;
     externalValidations: ExternalValidations;
     formData: ClientTaxDocumentation;
     isComplete: boolean;
     isLoading: boolean;
 };
-export {};

package/dist/taxbit-react-sdk.js

@@ -1882,7 +1882,7 @@ const Y = (e) => e === void 0 || e === "" || e === null, ie = (e) => !Y(e), Ne =
       At(t)
     ]
   )
-), Od = "1.0.0-beta.3", Pe = (e) => e === "yes", be = (e) => e === void 0 ? void 0 : e === "yes", Ad = (e) => {
+), Od = "1.0.0-beta.4", Pe = (e) => e === "yes", be = (e) => e === void 0 ? void 0 : e === "yes", Ad = (e) => {
   const n = {
     city: e.accountHolderAddressCity,
     country: e.accountHolderAddressCountry,
@@ -8017,7 +8017,7 @@ A 2553 election is for an eligible entity to be treated as an S-Corporation for
     y && o && o(y);
   }, [o, y]);
   const H = async (V) => {
-    od(V), G(!0), await a(V), G(!1);
+    od(V), a && (G(!0), await a(V), G(!1));
   }, N = (V) => {
     const Z = F(V);
     E(V), H(Ed(V, c)).then(() => {
@@ -10529,7 +10529,42 @@ A 2553 election is for an eligible entity to be treated as an S-Corporation for
     },
     JSON.stringify(I) + e + a + o
   );
-}, Wu = ({ ...e }) => e.demoMode === !0 ? /* @__PURE__ */ i.jsx(qa, { ...e }) : /* @__PURE__ */ i.jsx(Gu, { ...e });
+}, Wu = ({
+  questionnaire: e,
+  data: n,
+  onSubmit: t,
+  onSuccess: a,
+  onSettled: o,
+  onError: d,
+  language: c,
+  onProgress: u,
+  bearerToken: l,
+  demoMode: m,
+  staging: f
+}) => m === !0 ? /* @__PURE__ */ i.jsx(
+  qa,
+  {
+    questionnaire: e,
+    data: n,
+    onSubmit: t,
+    onProgress: u,
+    language: c
+  }
+) : /* @__PURE__ */ i.jsx(
+  Gu,
+  {
+    questionnaire: e,
+    data: n,
+    language: c,
+    bearerToken: l,
+    onSubmit: t,
+    onProgress: u,
+    onSuccess: a,
+    onSettled: o,
+    onError: d,
+    staging: f
+  }
+);
 export {
   Wu as TaxbitQuestionnaire,
   $u as useTaxbit