use-facebook-auth
TypeScript icon, indicating that this package has built-in type declarations

0.0.6 • Public • Published

use-facebook-auth

A React based hook for facebook authentication.

npm version

Installiation

$ npm i use-facebook-auth

or

$ yarn add use-facebook-auth

Usage

This hook uses context and hooks to provide info throughout your application on wether or not you have an active session. You'll want to wrap your app by doing the following:

import FacebookProvider from 'use-facebook-auth';

const MY_APP_ID = 'xxxxxxxx';

ReactDOM.render(
	<React.StrictMode>
		<FacebookProvider options={{ appId: MY_APP_ID }}>
			<App />
		</FacebookProvider>
	</React.StrictMode>,
	document.getElementById('root')
);

Your App Id is the application you're using too authentcate against. Then on any page you wish to authenticate/logout/get sessino info you can use the following hook:

import { useFacebook } from 'use-facebook-auth';

const loginOptions = {
	scope: 'public_profile,email'
}

const MyMethod = () => {
	const {
		authenticatedSession: { // only comes back when authenticated
			accessToken: 'string';
			expiresIn: 'number';
			signedRequest: 'string';
			userID: 'string';
			grantedScopes: 'string'; // optional
			reauthorize_required_in: 'number'; // optional
		},
		authenticatedState: 'loading' | 'error' | 'authenticated' | 'unauthenticated',
		isAuthenticated: true | false, //derived from the auth state;
		loading: true | false, //derived from the auth state;
		logout(): void,
		login(loginOptions): void
	} = useFacebook();

	return (<div>Hello</div>);
}

Additional Provider Options

The Provider requires one option, the appId, but you can also pass in language and version if you wish to alter the defaults below:

Parameter Description
appId Required The facebook app your authentication associates too.
version Default: v8.0 - provide a specific version
language Default: en_US - Provide the language you wish to see translations in

License

MIT Licensed

Up next

  • [ ] Add user session info to hook
  • [ ] Add example section to readme

Package Sidebar

Install

npm i use-facebook-auth

Weekly Downloads

2

Version

0.0.6

License

MIT

Unpacked Size

238 kB

Total Files

13

Last publish

Collaborators

  • petrogad