Package Exports

nhost-js-sdk

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (nhost-js-sdk) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Nhost JS SDK

Nhost JS SDK to handle Auth and Storage.

Installation

npm install --save nhost-js-sdk

Setup

In ex /src/nhost/index.js:

import nhost from "nhost-js-sdk";

const config = {
  base_url: "https://backend-xxxx.nhost.app",
};

nhost.initializeApp(config);

const auth = nhost.auth();
const storage = nhost.storage();

export { auth, storage };

Usage auth and storage across in your app

import { auth, storage } from 'src/nhost/index.js';

Auth

Register

auth.register(email, password);

Register with user_data

auth.register(email, password, { display_name: "Joe Doe" });

auth.login(email, password);

Logout

auth.logout();

onAuthStateChanged

auth.onAuthStateChanged((logged_in) => {
  console.log("auth state changed!");
  console.log({ logged_in });
});

Check if user is authenticated

auth.isAuthenticated();

Get JWT token

auth.getJWTToken();

Get JWT claim

auth.getClaim("x-hasura-user-id");

Activate account

auth.activate(<ticket>);

Change email address

Note: The user must be logged in.

auth.changeEmail(new_email);

Request new email change

auth.changeEmailRequest(new_email);

Change to requested email

auth.changeEmailChange(ticket);

Change password

auth.changePassword(old_password, new_password);

Request new password

auth.changePasswordRequest(email);

Change password using ticket

auth.changePasswordChange(new_password, ticket);

Generate MFA QR-code

Note: User must be logged in.

auth.MFAGenerate();

Enable MFA

auth.enable(code);

Disable MFA

auth.enable(code);

Note: ticket comes from the auth.login() response if the user has MFA enabled.

auth.MFATotp(code, ticket);

Storage

Upload

storage.put(path, file, metadata?, onUploadProgress?);

Delete

storage.delete(path);

Get metadata

storage.getMetadata(path);

Setup in different environments

React Native

Install:

yarn add @react-native-community/async-storage

More info: https://react-native-community.github.io/async-storage/docs/install.

import nhost from "nhost-js-sdk";
import AsyncStorage from "@react-native-community/async-storage";

const config = {
  base_url: "https://backend-xxxx.nhost.app",
  client_storage: AsyncStorage,
  client_storage_type: "react-native",
};

nhost.initializeApp(config);

const auth = nhost.auth();
const storage = nhost.storage();

export { auth, storage };

Ionic

import nhost from "nhost-js-sdk";
import { Plugins } from "@capacitor/core";
const { Storage } = Plugins;

const config = {
  base_url: "https://backend-xxxx.nhost.app",
  client_storage: Storage,
  client_storage_type: "capacitor",
};

nhost.initializeApp(config);

const auth = nhost.auth();
const storage = nhost.storage();

export { auth, storage };

Expo