@strivacity/sdk-react 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# 1.0.0 (2024-09-20)
+
+
+### 🚀 Features
+
+- @strivacity/sdk-react package implemented
+
+
+### 🧱 Updated Dependencies
+
+- Updated sdk-core to 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Strivacity Inc. <info@strivacity.com>
+
+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,118 @@
+# @strivacity/sdk-react
+
+> **The SDK supports React version 16 and above**
+
+### Install
+
+```bash
+npm install @strivacity/sdk-react
+```
+
+### Usage
+
+#### Wrap your app with Auth Provider:
+
+```js
+import { AuthProvider, useStrivacity } from '@strivacity/sdk-react';
+
+const sdkOptions = {
+	mode: 'redirect',
+	issuer: 'https://<YOUR_DOMAIN>',
+	scopes: ['openid', 'profile'],
+	clientId: '<YOUR_CLIENT_ID>',
+	redirectUri: '<YOUR_REDIRECT_URI>',
+};
+const AppRoot = () => {
+	return (
+		<AuthProvider options={sdkOptions}>
+			<App />
+		</AuthProvider>
+	);
+};
+```
+
+#### How to use the SDK in your components:
+
+```jsx
+import { useEffect, useCallback } from 'react'
+import { useStrivacity } from '@strivacity/sdk-react';
+
+const { isAuthenticated, idTokenClaims, login, logout } = useStrivacity();
+const [name, setName] = useState('');
+const onLogin = useCallback(() => {
+	login();
+},[]);
+const onLogout = useCallback(() => {
+	logout();
+},[]);
+
+useEffect(() => {
+	setName(`${idTokenClaims?.given_name} ${idTokenClaims?.family_name}`);
+}, [isAuthenticated, idTokenClaims]);
+
+return (
+	{isAuthenticated ? (<>
+		<div>Welcome, {{ name }}!</div>
+		<button onClick={onLogout()}>Logout</button>
+	</>) : <>
+		<div>Not logged in</div>
+		<button onClick={onLogin()}>Log in</button>
+	</>}
+)
+```
+
+### API Documentation
+
+#### `useStrivacity` hook
+
+```typescript
+useStrivacity<T extends PopupContext | RedirectContext>(): T;
+```
+
+You can choose between `PopupContext` or `RedirectContext` with the `mode` option when you configure the sdk options.
+
+**Properties**
+
+- **`loading: boolean`**: Indicates if the session is being loaded.
+- **`isAuthenticated: boolean`**: Indicates whether the user is authenticated.
+- **`idTokenClaims: IdTokenClaims | null`**: Claims from the ID token or null if not available.
+- **`accessToken: string | null`**: The access token or null if not available.
+- **`refreshToken: string | null`**: The refresh token or null if not available.
+- **`accessTokenExpired: boolean`**: Indicates if the access token has expired.
+- **`accessTokenExpirationDate: number | null`**: Expiration date of the access token or null if not set.
+
+---
+
+Type: `RedirectContext`
+Represents the available methods for Redirect-based interactions.
+
+- **`login(options?: LoginOptions): Promise<void>`**: Initiates the login process by redirecting the user to the identity provider.
+  - `options` (optional): Configuration options for login.
+- **`register(options?: RegisterOptions): Promise<void>`**: Registers a new user using a redirect flow.
+  - `options` (optional): Configuration options for registration.
+- **`refresh(): Promise<void>`**: Refreshes the user's session using a redirect flow.
+- **`revoke(): Promise<void>`**: Revokes the current session tokens using a redirect flow.
+- **`logout(options?: LogoutOptions): Promise<void>`**: Logs out the user by redirecting to the logout page.
+  - `options` (optional): Configuration options for logout.
+- **`handleCallback(url?: string): Promise<void>`**: Handles the callback after a redirect-based authentication or token exchange.
+  - `url` (optional): The URL to handle for the callback.
+
+---
+
+Type: `PopupContext`
+Represents the available methods for Popup-based interactions.
+
+- **`login(options?: LoginOptions): Promise<void>`**: Initiates the login process using a popup window.
+  - `options` (optional): Configuration options for login.
+- **`register(options?: RegisterOptions): Promise<void>`**: Registers a new user using a popup flow.
+  - `options` (optional): Configuration options for registration.
+- **`refresh(): Promise<void>`**: Refreshes the user's session using a popup.
+- **`revoke(): Promise<void>`**: Revokes the current session tokens using a popup flow.
+- **`logout(options?: LogoutOptions): Promise<void>`**: Logs out the user using a popup window.
+  - `options` (optional): Configuration options for logout.
+- **`handleCallback(url?: string): Promise<void>`**: Handles the callback after a popup-based authentication or token exchange.
+  - `url` (optional): The URL to handle for the callback.
+
+### Links
+
+[Example app](https://github.com/Strivacity/sdk-js/tree/main/apps/react)

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("react/jsx-runtime"),s=require("react"),x=require("@strivacity/sdk-core"),p=require("@strivacity/sdk-core/storages/LocalStorage"),m=require("@strivacity/sdk-core/storages/SessionStorage"),k=s.createContext(null);let e;const A=()=>{const o=s.useContext(k);if(!o)throw Error("Missing Strivacity SDK context");return o},C=({options:o,children:S=void 0})=>{const[a,b]=s.useState(!0),[i,T]=s.useState(!1),[r,g]=s.useState(null),[c,v]=s.useState(null),[u,f]=s.useState(null),[l,E]=s.useState(!0),[d,h]=s.useState(null),t=async()=>{T(await e.isAuthenticated),g(e.idTokenClaims||null),v(e.accessToken||null),f(e.refreshToken||null),E(e.accessTokenExpired),h(e.accessTokenExpirationDate||null),a&&b(!1)},w=s.useMemo(()=>(e||(e=x.initFlow(o)),{loading:a,isAuthenticated:i,idTokenClaims:r,accessToken:c,refreshToken:u,accessTokenExpired:l,accessTokenExpirationDate:d,login:async n=>{await e.login(n),await t()},register:async n=>{await e.register(n),await t()},refresh:async()=>{await e.refresh(),await t()},revoke:async()=>{await e.revoke(),await t()},logout:async n=>{await e.logout(n),await t()},handleCallback:async n=>{await e.handleCallback(n),await t()}}),[a,r,c,u,l,d,i]);return s.useEffect(()=>{e&&(e.subscribeToEvent("init",t),e.subscribeToEvent("loggedIn",t),e.subscribeToEvent("sessionLoaded",t),e.subscribeToEvent("tokenRefreshed",t),e.subscribeToEvent("tokenRefreshFailed",t),e.subscribeToEvent("logoutInitiated",t),e.subscribeToEvent("tokenRevoked",t),e.subscribeToEvent("tokenRevokeFailed",t))},[]),y.jsx(k.Provider,{value:w,children:S})};Object.defineProperty(exports,"LocalStorage",{enumerable:!0,get:()=>p.LocalStorage});Object.defineProperty(exports,"SessionStorage",{enumerable:!0,get:()=>m.SessionStorage});exports.AuthProvider=C;exports.useStrivacity=A;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/index.tsx"],"sourcesContent":["import { type FC, createContext, useContext, useMemo, useEffect, useState } from 'react';\nimport { initFlow, type SDKOptions, type SDKStorage, type IdTokenClaims } from '@strivacity/sdk-core';\nimport type { PopupFlow } from '@strivacity/sdk-core/flows/PopupFlow';\nimport type { RedirectFlow } from '@strivacity/sdk-core/flows/RedirectFlow';\nimport { LocalStorage } from '@strivacity/sdk-core/storages/LocalStorage';\nimport { SessionStorage } from '@strivacity/sdk-core/storages/SessionStorage';\nimport type { Session, PopupContext, PopupSDK, RedirectContext, RedirectSDK, Children } from './types';\n\nexport type { SDKOptions, SDKStorage, Session, IdTokenClaims, PopupFlow, RedirectFlow, PopupContext, PopupSDK, RedirectContext, RedirectSDK };\nexport { LocalStorage, SessionStorage };\n\nconst StrivacitySdk = createContext<PopupContext | RedirectContext>(null!);\n\nlet sdk: RedirectFlow | PopupFlow;\n\n/**\n * Hook to access the Strivacity SDK context\n *\n * @template T Extends either PopupContext or RedirectContext.\n *\n * @returns {T} The current Strivacity SDK context.\n *\n * @throws {Error} If the context is not provided by an AuthProvider.\n */\nexport const useStrivacity = <T extends PopupContext | RedirectContext>() => {\n\tconst context = useContext(StrivacitySdk);\n\n\tif (!context) {\n\t\tthrow Error('Missing Strivacity SDK context');\n\t}\n\n\treturn context as T;\n};\n\n/**\n * Strivacity authentication provider component\n *\n * @param {SDKOptions} options - The SDK configuration options.\n * @param {Children} [children] - The child components wrapped by the provider.\n *\n * @returns {JSX.Element} A provider that passes the Strivacity SDK context to its children.\n */\nexport const AuthProvider: FC<{ options: SDKOptions; children?: Children }> = ({\n\toptions,\n\tchildren = undefined,\n}: {\n\toptions: SDKOptions;\n\tchildren?: Children;\n}) => {\n\tconst [loading, setLoading] = useState<boolean>(true);\n\tconst [isAuthenticated, setIsAuthenticated] = useState<boolean>(false);\n\tconst [idTokenClaims, setIdTokenClaims] = useState<IdTokenClaims | null>(null);\n\tconst [accessToken, setAccessToken] = useState<string | null>(null);\n\tconst [refreshToken, setRefreshToken] = useState<string | null>(null);\n\tconst [accessTokenExpired, setAccessTokenExpired] = useState<boolean>(true);\n\tconst [accessTokenExpirationDate, setAccessTokenExpirationDate] = useState<number | null>(null);\n\n\tconst updateSession = async () => {\n\t\tsetIsAuthenticated(await sdk.isAuthenticated);\n\t\tsetIdTokenClaims(sdk.idTokenClaims || null);\n\t\tsetAccessToken(sdk.accessToken || null);\n\t\tsetRefreshToken(sdk.refreshToken || null);\n\t\tsetAccessTokenExpired(sdk.accessTokenExpired);\n\t\tsetAccessTokenExpirationDate(sdk.accessTokenExpirationDate || null);\n\n\t\tif (loading) {\n\t\t\tsetLoading(false);\n\t\t}\n\t};\n\n\tconst value = useMemo<PopupContext | RedirectContext>(() => {\n\t\tif (!sdk) {\n\t\t\tsdk = initFlow(options);\n\t\t}\n\n\t\treturn {\n\t\t\tloading,\n\t\t\tisAuthenticated,\n\t\t\tidTokenClaims,\n\t\t\taccessToken,\n\t\t\trefreshToken,\n\t\t\taccessTokenExpired,\n\t\t\taccessTokenExpirationDate,\n\n\t\t\tlogin: async (options?: Parameters<PopupFlow['login'] | RedirectFlow['login']>[0]) => {\n\t\t\t\tawait sdk.login(options);\n\t\t\t\tawait updateSession();\n\t\t\t},\n\t\t\tregister: async (options?: Parameters<PopupFlow['register'] | RedirectFlow['register']>[0]) => {\n\t\t\t\tawait sdk.register(options);\n\t\t\t\tawait updateSession();\n\t\t\t},\n\t\t\trefresh: async () => {\n\t\t\t\tawait sdk.refresh();\n\t\t\t\tawait updateSession();\n\t\t\t},\n\t\t\trevoke: async () => {\n\t\t\t\tawait sdk.revoke();\n\t\t\t\tawait updateSession();\n\t\t\t},\n\t\t\tlogout: async (options?: Parameters<PopupFlow['logout'] | RedirectFlow['logout']>[0]) => {\n\t\t\t\tawait sdk.logout(options);\n\t\t\t\tawait updateSession();\n\t\t\t},\n\t\t\thandleCallback: async (url?: Parameters<PopupFlow['handleCallback'] | RedirectFlow['handleCallback']>[0]) => {\n\t\t\t\tawait sdk.handleCallback(url);\n\t\t\t\tawait updateSession();\n\t\t\t},\n\t\t};\n\t}, [loading, idTokenClaims, accessToken, refreshToken, accessTokenExpired, accessTokenExpirationDate, isAuthenticated]);\n\n\tuseEffect(() => {\n\t\tif (!sdk) {\n\t\t\treturn;\n\t\t}\n\n\t\tsdk.subscribeToEvent('init', updateSession);\n\t\tsdk.subscribeToEvent('loggedIn', updateSession);\n\t\tsdk.subscribeToEvent('sessionLoaded', updateSession);\n\t\tsdk.subscribeToEvent('tokenRefreshed', updateSession);\n\t\tsdk.subscribeToEvent('tokenRefreshFailed', updateSession);\n\t\tsdk.subscribeToEvent('logoutInitiated', updateSession);\n\t\tsdk.subscribeToEvent('tokenRevoked', updateSession);\n\t\tsdk.subscribeToEvent('tokenRevokeFailed', updateSession);\n\t}, []);\n\n\treturn <StrivacitySdk.Provider value={value}>{children}</StrivacitySdk.Provider>;\n};\n"],"names":["StrivacitySdk","createContext","sdk","useStrivacity","context","useContext","AuthProvider","options","children","loading","setLoading","useState","isAuthenticated","setIsAuthenticated","idTokenClaims","setIdTokenClaims","accessToken","setAccessToken","refreshToken","setRefreshToken","accessTokenExpired","setAccessTokenExpired","accessTokenExpirationDate","setAccessTokenExpirationDate","updateSession","value","useMemo","initFlow","url","useEffect","jsx"],"mappings":"4RAWMA,EAAgBC,EAAAA,cAA8C,IAAK,EAEzE,IAAIC,EAWG,MAAMC,EAAgB,IAAgD,CACtE,MAAAC,EAAUC,aAAWL,CAAa,EAExC,GAAI,CAACI,EACJ,MAAM,MAAM,gCAAgC,EAGtC,OAAAA,CACR,EAUaE,EAAiE,CAAC,CAC9E,QAAAC,EACA,SAAAC,EAAW,MACZ,IAGM,CACL,KAAM,CAACC,EAASC,CAAU,EAAIC,WAAkB,EAAI,EAC9C,CAACC,EAAiBC,CAAkB,EAAIF,WAAkB,EAAK,EAC/D,CAACG,EAAeC,CAAgB,EAAIJ,WAA+B,IAAI,EACvE,CAACK,EAAaC,CAAc,EAAIN,WAAwB,IAAI,EAC5D,CAACO,EAAcC,CAAe,EAAIR,WAAwB,IAAI,EAC9D,CAACS,EAAoBC,CAAqB,EAAIV,WAAkB,EAAI,EACpE,CAACW,EAA2BC,CAA4B,EAAIZ,WAAwB,IAAI,EAExFa,EAAgB,SAAY,CACdX,EAAA,MAAMX,EAAI,eAAe,EAC3Ba,EAAAb,EAAI,eAAiB,IAAI,EAC3Be,EAAAf,EAAI,aAAe,IAAI,EACtBiB,EAAAjB,EAAI,cAAgB,IAAI,EACxCmB,EAAsBnB,EAAI,kBAAkB,EACfqB,EAAArB,EAAI,2BAA6B,IAAI,EAE9DO,GACHC,EAAW,EAAK,CACjB,EAGKe,EAAQC,EAAAA,QAAwC,KAChDxB,IACJA,EAAMyB,EAAAA,SAASpB,CAAO,GAGhB,CACN,QAAAE,EACA,gBAAAG,EACA,cAAAE,EACA,YAAAE,EACA,aAAAE,EACA,mBAAAE,EACA,0BAAAE,EAEA,MAAO,MAAOf,GAAwE,CAC/E,MAAAL,EAAI,MAAMK,CAAO,EACvB,MAAMiB,EAAc,CACrB,EACA,SAAU,MAAOjB,GAA8E,CACxF,MAAAL,EAAI,SAASK,CAAO,EAC1B,MAAMiB,EAAc,CACrB,EACA,QAAS,SAAY,CACpB,MAAMtB,EAAI,UACV,MAAMsB,EAAc,CACrB,EACA,OAAQ,SAAY,CACnB,MAAMtB,EAAI,SACV,MAAMsB,EAAc,CACrB,EACA,OAAQ,MAAOjB,GAA0E,CAClF,MAAAL,EAAI,OAAOK,CAAO,EACxB,MAAMiB,EAAc,CACrB,EACA,eAAgB,MAAOI,GAAsF,CACtG,MAAA1B,EAAI,eAAe0B,CAAG,EAC5B,MAAMJ,EAAc,CACrB,CAAA,GAEC,CAACf,EAASK,EAAeE,EAAaE,EAAcE,EAAoBE,EAA2BV,CAAe,CAAC,EAEtHiB,OAAAA,EAAAA,UAAU,IAAM,CACV3B,IAIDA,EAAA,iBAAiB,OAAQsB,CAAa,EACtCtB,EAAA,iBAAiB,WAAYsB,CAAa,EAC1CtB,EAAA,iBAAiB,gBAAiBsB,CAAa,EAC/CtB,EAAA,iBAAiB,iBAAkBsB,CAAa,EAChDtB,EAAA,iBAAiB,qBAAsBsB,CAAa,EACpDtB,EAAA,iBAAiB,kBAAmBsB,CAAa,EACjDtB,EAAA,iBAAiB,eAAgBsB,CAAa,EAC9CtB,EAAA,iBAAiB,oBAAqBsB,CAAa,EACxD,EAAG,CAAE,CAAA,EAEGM,EAAAA,IAAA9B,EAAc,SAAd,CAAuB,MAAAyB,EAAe,SAAAjB,CAAS,CAAA,CACxD"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+import { FC } from 'react';
+import { SDKOptions, SDKStorage, IdTokenClaims } from '@strivacity/sdk-core';
+import { PopupFlow } from '@strivacity/sdk-core/flows/PopupFlow';
+import { RedirectFlow } from '@strivacity/sdk-core/flows/RedirectFlow';
+import { LocalStorage } from '@strivacity/sdk-core/storages/LocalStorage';
+import { SessionStorage } from '@strivacity/sdk-core/storages/SessionStorage';
+import { Session, PopupContext, PopupSDK, RedirectContext, RedirectSDK, Children } from './types';
+export type { SDKOptions, SDKStorage, Session, IdTokenClaims, PopupFlow, RedirectFlow, PopupContext, PopupSDK, RedirectContext, RedirectSDK };
+export { LocalStorage, SessionStorage };
+/**
+ * Hook to access the Strivacity SDK context
+ *
+ * @template T Extends either PopupContext or RedirectContext.
+ *
+ * @returns {T} The current Strivacity SDK context.
+ *
+ * @throws {Error} If the context is not provided by an AuthProvider.
+ */
+export declare const useStrivacity: <T extends PopupContext | RedirectContext>() => T;
+/**
+ * Strivacity authentication provider component
+ *
+ * @param {SDKOptions} options - The SDK configuration options.
+ * @param {Children} [children] - The child components wrapped by the provider.
+ *
+ * @returns {JSX.Element} A provider that passes the Strivacity SDK context to its children.
+ */
+export declare const AuthProvider: FC<{
+    options: SDKOptions;
+    children?: Children;
+}>;

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import{jsx as p}from"react/jsx-runtime";import{createContext as m,useContext as y,useState as o,useMemo as S,useEffect as A}from"react";import{initFlow as C}from"@strivacity/sdk-core";import{LocalStorage as j}from"@strivacity/sdk-core/storages/LocalStorage";import{SessionStorage as q}from"@strivacity/sdk-core/storages/SessionStorage";const k=m(null);let e;const F=()=>{const n=y(k);if(!n)throw Error("Missing Strivacity SDK context");return n},L=({options:n,children:T=void 0})=>{const[a,f]=o(!0),[i,v]=o(!1),[r,b]=o(null),[c,E]=o(null),[l,w]=o(null),[u,g]=o(!0),[d,h]=o(null),t=async()=>{v(await e.isAuthenticated),b(e.idTokenClaims||null),E(e.accessToken||null),w(e.refreshToken||null),g(e.accessTokenExpired),h(e.accessTokenExpirationDate||null),a&&f(!1)},x=S(()=>(e||(e=C(n)),{loading:a,isAuthenticated:i,idTokenClaims:r,accessToken:c,refreshToken:l,accessTokenExpired:u,accessTokenExpirationDate:d,login:async s=>{await e.login(s),await t()},register:async s=>{await e.register(s),await t()},refresh:async()=>{await e.refresh(),await t()},revoke:async()=>{await e.revoke(),await t()},logout:async s=>{await e.logout(s),await t()},handleCallback:async s=>{await e.handleCallback(s),await t()}}),[a,r,c,l,u,d,i]);return A(()=>{e&&(e.subscribeToEvent("init",t),e.subscribeToEvent("loggedIn",t),e.subscribeToEvent("sessionLoaded",t),e.subscribeToEvent("tokenRefreshed",t),e.subscribeToEvent("tokenRefreshFailed",t),e.subscribeToEvent("logoutInitiated",t),e.subscribeToEvent("tokenRevoked",t),e.subscribeToEvent("tokenRevokeFailed",t))},[]),p(k.Provider,{value:x,children:T})};export{L as AuthProvider,j as LocalStorage,q as SessionStorage,F as useStrivacity};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/index.tsx"],"sourcesContent":["import { type FC, createContext, useContext, useMemo, useEffect, useState } from 'react';\nimport { initFlow, type SDKOptions, type SDKStorage, type IdTokenClaims } from '@strivacity/sdk-core';\nimport type { PopupFlow } from '@strivacity/sdk-core/flows/PopupFlow';\nimport type { RedirectFlow } from '@strivacity/sdk-core/flows/RedirectFlow';\nimport { LocalStorage } from '@strivacity/sdk-core/storages/LocalStorage';\nimport { SessionStorage } from '@strivacity/sdk-core/storages/SessionStorage';\nimport type { Session, PopupContext, PopupSDK, RedirectContext, RedirectSDK, Children } from './types';\n\nexport type { SDKOptions, SDKStorage, Session, IdTokenClaims, PopupFlow, RedirectFlow, PopupContext, PopupSDK, RedirectContext, RedirectSDK };\nexport { LocalStorage, SessionStorage };\n\nconst StrivacitySdk = createContext<PopupContext | RedirectContext>(null!);\n\nlet sdk: RedirectFlow | PopupFlow;\n\n/**\n * Hook to access the Strivacity SDK context\n *\n * @template T Extends either PopupContext or RedirectContext.\n *\n * @returns {T} The current Strivacity SDK context.\n *\n * @throws {Error} If the context is not provided by an AuthProvider.\n */\nexport const useStrivacity = <T extends PopupContext | RedirectContext>() => {\n\tconst context = useContext(StrivacitySdk);\n\n\tif (!context) {\n\t\tthrow Error('Missing Strivacity SDK context');\n\t}\n\n\treturn context as T;\n};\n\n/**\n * Strivacity authentication provider component\n *\n * @param {SDKOptions} options - The SDK configuration options.\n * @param {Children} [children] - The child components wrapped by the provider.\n *\n * @returns {JSX.Element} A provider that passes the Strivacity SDK context to its children.\n */\nexport const AuthProvider: FC<{ options: SDKOptions; children?: Children }> = ({\n\toptions,\n\tchildren = undefined,\n}: {\n\toptions: SDKOptions;\n\tchildren?: Children;\n}) => {\n\tconst [loading, setLoading] = useState<boolean>(true);\n\tconst [isAuthenticated, setIsAuthenticated] = useState<boolean>(false);\n\tconst [idTokenClaims, setIdTokenClaims] = useState<IdTokenClaims | null>(null);\n\tconst [accessToken, setAccessToken] = useState<string | null>(null);\n\tconst [refreshToken, setRefreshToken] = useState<string | null>(null);\n\tconst [accessTokenExpired, setAccessTokenExpired] = useState<boolean>(true);\n\tconst [accessTokenExpirationDate, setAccessTokenExpirationDate] = useState<number | null>(null);\n\n\tconst updateSession = async () => {\n\t\tsetIsAuthenticated(await sdk.isAuthenticated);\n\t\tsetIdTokenClaims(sdk.idTokenClaims || null);\n\t\tsetAccessToken(sdk.accessToken || null);\n\t\tsetRefreshToken(sdk.refreshToken || null);\n\t\tsetAccessTokenExpired(sdk.accessTokenExpired);\n\t\tsetAccessTokenExpirationDate(sdk.accessTokenExpirationDate || null);\n\n\t\tif (loading) {\n\t\t\tsetLoading(false);\n\t\t}\n\t};\n\n\tconst value = useMemo<PopupContext | RedirectContext>(() => {\n\t\tif (!sdk) {\n\t\t\tsdk = initFlow(options);\n\t\t}\n\n\t\treturn {\n\t\t\tloading,\n\t\t\tisAuthenticated,\n\t\t\tidTokenClaims,\n\t\t\taccessToken,\n\t\t\trefreshToken,\n\t\t\taccessTokenExpired,\n\t\t\taccessTokenExpirationDate,\n\n\t\t\tlogin: async (options?: Parameters<PopupFlow['login'] | RedirectFlow['login']>[0]) => {\n\t\t\t\tawait sdk.login(options);\n\t\t\t\tawait updateSession();\n\t\t\t},\n\t\t\tregister: async (options?: Parameters<PopupFlow['register'] | RedirectFlow['register']>[0]) => {\n\t\t\t\tawait sdk.register(options);\n\t\t\t\tawait updateSession();\n\t\t\t},\n\t\t\trefresh: async () => {\n\t\t\t\tawait sdk.refresh();\n\t\t\t\tawait updateSession();\n\t\t\t},\n\t\t\trevoke: async () => {\n\t\t\t\tawait sdk.revoke();\n\t\t\t\tawait updateSession();\n\t\t\t},\n\t\t\tlogout: async (options?: Parameters<PopupFlow['logout'] | RedirectFlow['logout']>[0]) => {\n\t\t\t\tawait sdk.logout(options);\n\t\t\t\tawait updateSession();\n\t\t\t},\n\t\t\thandleCallback: async (url?: Parameters<PopupFlow['handleCallback'] | RedirectFlow['handleCallback']>[0]) => {\n\t\t\t\tawait sdk.handleCallback(url);\n\t\t\t\tawait updateSession();\n\t\t\t},\n\t\t};\n\t}, [loading, idTokenClaims, accessToken, refreshToken, accessTokenExpired, accessTokenExpirationDate, isAuthenticated]);\n\n\tuseEffect(() => {\n\t\tif (!sdk) {\n\t\t\treturn;\n\t\t}\n\n\t\tsdk.subscribeToEvent('init', updateSession);\n\t\tsdk.subscribeToEvent('loggedIn', updateSession);\n\t\tsdk.subscribeToEvent('sessionLoaded', updateSession);\n\t\tsdk.subscribeToEvent('tokenRefreshed', updateSession);\n\t\tsdk.subscribeToEvent('tokenRefreshFailed', updateSession);\n\t\tsdk.subscribeToEvent('logoutInitiated', updateSession);\n\t\tsdk.subscribeToEvent('tokenRevoked', updateSession);\n\t\tsdk.subscribeToEvent('tokenRevokeFailed', updateSession);\n\t}, []);\n\n\treturn <StrivacitySdk.Provider value={value}>{children}</StrivacitySdk.Provider>;\n};\n"],"names":["StrivacitySdk","createContext","sdk","useStrivacity","context","useContext","AuthProvider","options","children","loading","setLoading","useState","isAuthenticated","setIsAuthenticated","idTokenClaims","setIdTokenClaims","accessToken","setAccessToken","refreshToken","setRefreshToken","accessTokenExpired","setAccessTokenExpired","accessTokenExpirationDate","setAccessTokenExpirationDate","updateSession","value","useMemo","initFlow","url","useEffect","jsx"],"mappings":"gVAWA,MAAMA,EAAgBC,EAA8C,IAAK,EAEzE,IAAIC,EAWG,MAAMC,EAAgB,IAAgD,CACtE,MAAAC,EAAUC,EAAWL,CAAa,EAExC,GAAI,CAACI,EACJ,MAAM,MAAM,gCAAgC,EAGtC,OAAAA,CACR,EAUaE,EAAiE,CAAC,CAC9E,QAAAC,EACA,SAAAC,EAAW,MACZ,IAGM,CACL,KAAM,CAACC,EAASC,CAAU,EAAIC,EAAkB,EAAI,EAC9C,CAACC,EAAiBC,CAAkB,EAAIF,EAAkB,EAAK,EAC/D,CAACG,EAAeC,CAAgB,EAAIJ,EAA+B,IAAI,EACvE,CAACK,EAAaC,CAAc,EAAIN,EAAwB,IAAI,EAC5D,CAACO,EAAcC,CAAe,EAAIR,EAAwB,IAAI,EAC9D,CAACS,EAAoBC,CAAqB,EAAIV,EAAkB,EAAI,EACpE,CAACW,EAA2BC,CAA4B,EAAIZ,EAAwB,IAAI,EAExFa,EAAgB,SAAY,CACdX,EAAA,MAAMX,EAAI,eAAe,EAC3Ba,EAAAb,EAAI,eAAiB,IAAI,EAC3Be,EAAAf,EAAI,aAAe,IAAI,EACtBiB,EAAAjB,EAAI,cAAgB,IAAI,EACxCmB,EAAsBnB,EAAI,kBAAkB,EACfqB,EAAArB,EAAI,2BAA6B,IAAI,EAE9DO,GACHC,EAAW,EAAK,CACjB,EAGKe,EAAQC,EAAwC,KAChDxB,IACJA,EAAMyB,EAASpB,CAAO,GAGhB,CACN,QAAAE,EACA,gBAAAG,EACA,cAAAE,EACA,YAAAE,EACA,aAAAE,EACA,mBAAAE,EACA,0BAAAE,EAEA,MAAO,MAAOf,GAAwE,CAC/E,MAAAL,EAAI,MAAMK,CAAO,EACvB,MAAMiB,EAAc,CACrB,EACA,SAAU,MAAOjB,GAA8E,CACxF,MAAAL,EAAI,SAASK,CAAO,EAC1B,MAAMiB,EAAc,CACrB,EACA,QAAS,SAAY,CACpB,MAAMtB,EAAI,UACV,MAAMsB,EAAc,CACrB,EACA,OAAQ,SAAY,CACnB,MAAMtB,EAAI,SACV,MAAMsB,EAAc,CACrB,EACA,OAAQ,MAAOjB,GAA0E,CAClF,MAAAL,EAAI,OAAOK,CAAO,EACxB,MAAMiB,EAAc,CACrB,EACA,eAAgB,MAAOI,GAAsF,CACtG,MAAA1B,EAAI,eAAe0B,CAAG,EAC5B,MAAMJ,EAAc,CACrB,CAAA,GAEC,CAACf,EAASK,EAAeE,EAAaE,EAAcE,EAAoBE,EAA2BV,CAAe,CAAC,EAEtH,OAAAiB,EAAU,IAAM,CACV3B,IAIDA,EAAA,iBAAiB,OAAQsB,CAAa,EACtCtB,EAAA,iBAAiB,WAAYsB,CAAa,EAC1CtB,EAAA,iBAAiB,gBAAiBsB,CAAa,EAC/CtB,EAAA,iBAAiB,iBAAkBsB,CAAa,EAChDtB,EAAA,iBAAiB,qBAAsBsB,CAAa,EACpDtB,EAAA,iBAAiB,kBAAmBsB,CAAa,EACjDtB,EAAA,iBAAiB,eAAgBsB,CAAa,EAC9CtB,EAAA,iBAAiB,oBAAqBsB,CAAa,EACxD,EAAG,CAAE,CAAA,EAEGM,EAAA9B,EAAc,SAAd,CAAuB,MAAAyB,EAAe,SAAAjB,CAAS,CAAA,CACxD"}

package/dist/types.cjs

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+import { IdTokenClaims } from '@strivacity/sdk-core';
+import { PopupFlow } from '@strivacity/sdk-core/flows/PopupFlow';
+import { RedirectFlow } from '@strivacity/sdk-core/flows/RedirectFlow';
+export type Children = React.ReactElement | React.ReactNode | Array<React.ReactElement | React.ReactNode>;
+/**
+ * Represents the session state, including authentication details and token information.
+ */
+export type Session = {
+    /**
+     * Indicates if the session is being loaded.
+     */
+    loading: boolean;
+    /**
+     * Indicates whether the user is authenticated.
+     */
+    isAuthenticated: boolean;
+    /**
+     * Claims from the ID token or `null` if not available.
+     */
+    idTokenClaims: IdTokenClaims | null;
+    /**
+     * The access token or `null` if not available.
+     */
+    accessToken: string | null;
+    /**
+     * The refresh token or `null` if not available.
+     */
+    refreshToken: string | null;
+    /**
+     * Indicates if the access token has expired.
+     */
+    accessTokenExpired: boolean;
+    /**
+     * Expiration date of the access token or `null` if not set.
+     */
+    accessTokenExpirationDate: number | null;
+};
+/**
+ * Represents the available authentication flows and operations for Popup-based interactions.
+ */
+export type PopupSDK = {
+    /**
+     * Initiates the login process using a popup window.
+     */
+    login: InstanceType<typeof PopupFlow>['login'];
+    /**
+     * Registers a new user using a popup flow.
+     */
+    register: InstanceType<typeof PopupFlow>['register'];
+    /**
+     * Refreshes the user's session using a popup.
+     */
+    refresh: InstanceType<typeof PopupFlow>['refresh'];
+    /**
+     * Revokes the current session tokens using a popup flow.
+     */
+    revoke: InstanceType<typeof PopupFlow>['revoke'];
+    /**
+     * Logs out the user using a popup window.
+     */
+    logout: InstanceType<typeof PopupFlow>['logout'];
+    /**
+     * Handles the callback after a popup-based authentication or token exchange.
+     */
+    handleCallback: InstanceType<typeof PopupFlow>['handleCallback'];
+};
+/**
+ * Represents the available authentication flows and operations for Redirect-based interactions.
+ */
+export type RedirectSDK = {
+    /**
+     * Initiates the login process by redirecting the user to the identity provider.
+     */
+    login: InstanceType<typeof RedirectFlow>['login'];
+    /**
+     * Registers a new user using a redirect flow.
+     */
+    register: InstanceType<typeof RedirectFlow>['register'];
+    /**
+     * Refreshes the user's session using a redirect flow.
+     */
+    refresh: InstanceType<typeof RedirectFlow>['refresh'];
+    /**
+     * Revokes the current session tokens using a redirect flow.
+     */
+    revoke: InstanceType<typeof RedirectFlow>['revoke'];
+    /**
+     * Logs out the user by redirecting to the logout page.
+     */
+    logout: InstanceType<typeof RedirectFlow>['logout'];
+    /**
+     * Handles the callback after a redirect-based authentication or token exchange.
+     */
+    handleCallback: InstanceType<typeof RedirectFlow>['handleCallback'];
+};
+/**
+ * Represents a combined context for Popup-based flows, containing both the Popup SDK and the session state.
+ */
+export type PopupContext = PopupSDK & Session;
+/**
+ * Represents a combined context for Redirect-based flows, containing both the Redirect SDK and the session state.
+ */
+export type RedirectContext = RedirectSDK & Session;

package/dist/types.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@strivacity/sdk-react",
+  "version": "1.0.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Strivacity React SDK client",
+  "author": "strivacity <info@strivacity.com>",
+  "dependencies": {
+    "@strivacity/sdk-core": "1.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts"
+}