The react headless library for using SuprSend features like inbox, preferences etc
npm install @suprsend/react-coreThis library provides hooks and context providers to intergrate SuprSend features like InApp feed, Preferences etc in react applications. This is a wrapper around the @suprsend/web-sdk. Use this library if you want to build UI from scratch. If you want react drop-in UI components, use @suprsend/react.
- Refer type definitions for this library here.
``bash
npm install @suprsend/react-core # for npm
yarn add @suprsend/react-core # for yarn
`
This provider internally create SuprSend client, identify and reset user. You can access client object using useSuprSendClient hook for accessing client methods. Other context providers and hooks must be children of this provider.
`javascript
import { SuprSendProvider } from '@suprsend/react-core';
function Example() {
return (
YOUR CODE
);
}
// props of SuprSendProvider
interface SuprSendProviderProps {
publicApiKey: string;
distinctId?: unknown;
userToken?: string; // jwt token needed when enhanced security mode is enabled
host?: string; // custom host url
refreshUserToken?: (
oldUserToken: string,
tokenPayload: Dictionary
) => Promise
vapidKey?: string; // for webpush notifications
swFileName?: string; // for webpush notifications
userAuthenticationHandler?: ({ response: ApiResponse }) => void; // callback will be called after internally authenticating user.
}
`
This provider internally creates InApp feed client and remove it on unmount. This should be called inside SuprSendProvider. FeedClient can be accessed using useFeedClient hook.
`javascript
import { SuprSendProvider, SuprSendFeedProvider } from '@suprsend/react-core';
function Example() {
return (
);
}
interface SuprSendFeedProviderProps {
tenantId?: string;
pageSize?: number;
stores?: IStore[] | null;
host?: { socketHost?: string, apiHost?: string };
}
interface IStore {
storeId: string;
label: string;
query?: {
tags?: string | string[],
categories?: string | string[],
read?: boolean,
archived?: boolean,
};
}
`
This provider can be used if you want to use internationalization. Wrap your inbox or feed components inside this. Pass locale prop to change language of the suprsend components. It defaults to english language and supports translations of below languages internally.
- en - English (default)fr
- - Frenchde
- - Germanes
- - Spanishar
- - Arabic
If you want to use other languages that are not supported by us or to override strings of existing languages, you can pass translations object as prop to SuprSendI18nProvider. View allowed keys inside translations object here.
`javascript Example`
translations={{ notifications: 'Test', markAllAsRead: 'Mark All Read' }}
>
This hook is used to get SuprSend client instance. Using this you can access user methods, webpush and preferences methods. Use this hook inside SuprSendProvider.
`javascript
import { useSuprSendClient } from '@suprsend/react-core';
function MyComponent() {
const suprSendClient = useSuprSendClient();
return (
$3
This hook is used to get authenticated user. Use this hook inside SuprSendProvider.
`javascript
import { useAuthenticateUser } from '@suprsend/react-core';function MyComponent() {
const { authenticatedUser } = useAuthenticateUser();
useEffect(() => {
if (authenticatedUser) {
console.log('user is authenticated', authenticatedUser);
}
}, [authenticatedUser]);
return
Hello world
;
}
`$3
This hook is used to get Feed client instance. Using this instance you can access inapp feed methods like mark seen, archive, read etc. Use this hook inside SuprSendFeedProvider.
`javascript
import {
SuprSendProvider,
SuprSendFeedProvider,
useFeedClient,
} from '@suprsend/react-core';function Example() {
return (
);
}
function MyComponent() {
const feedClient = useFeedClient();
return (
onClick={() => {
// feedClient.changeActiveStore(storeId);
// feedClient.markAsSeen(notificationId);
//
// feedClient.emitter.on(
// 'feed.new_notification',
// (notificationData: IRemoteNotification) => {
// console.log(notificationData)
// }
// );
}}
>
Click Me
);
}
`$3
This hooks returns state that contains notification store data which includes notifications list and other meta data. This state gets updated internally when there is any update in store. Use this state to render UI in your application. Use this hook inside SuprSendFeedProvider.
`javascript
import {useFeedData} from "@suprsend/core"function MyComponent() {
const feedData = useFeedData();
const notificationsList = feedData.notifications;
return
{notificationsList.map(notification)=>{notification.n_id}
};
}
`$3
This should be used inside
SuprSendI18nProvider and returns object that contains t a function that used to translate string based on locale and translations object you pass as props to SuprSendI18nProvider.`javascript
import { useTranslations, SuprSendI18nProvider } from '@suprsend/core';function ParentComponent() {
return (
);
}
function MyComponent() {
const { t } = useTranslations();
return
{t('notifications')}
;
}
``