usefeathers

1.0.3 • Public • Published

useFeathers

⚓️ React Hooks + FeathersJS = useFeathers. Increase productivity in building small and medium applications. 🚀

Hooks

  • useFeathers
  • useFind
  • useGet
  • useCreate
  • usePatch
  • useUpdate
  • useRemove
  • useRealtime
  • useAuthenticate
  • useLogout
  • useAuthenticationEvents

Additional features

  • Paginate
  • Realtime
  • Realtime deep populate
  • Custom filter realtime
  • Cache

Install

Use yarn

yarn add usefeathers

or use npm

npm i usefeathers --save 

Demo

Example

useFeathers

Set instante feathers client for initilalization hooks.

import io from 'socket.io-client';
import feathers from '@feathersjs/feathers';
import socketio from '@feathersjs/socketio-client';
import auth from '@feathersjs/authentication-client';
import useFeathers from 'usefeathers';
 
const URL = 'http://localhost:3030';
 
const socket = io(URL);
const feathers = feathers()
  .configure(socketio(socket))
  .configure(auth({
    storage: window.localStorage
  }));
 
useFeathers(feathers);

useFind

import { useFind } from 'usefeathers';
 
const [users, loading, error] = useFind('users', query);
// OR
const [fetchUsers, users, loading, error] = useFind(() => 'users');
const response = await fetchUsers(query); // return Promise;
// OR
const options = { paginate: true }; // optional
const [{ data }, loading, error, fetchMore] = useFind('users', query, options);
// OR
const options = { paginate: true }; // optional
const [fetchUsers, users, loading, error, fetchMore] = useFind(() => 'users', options);
const options = {
    paginate: true || false,
    realtime: true || false // watch events created, patched, updated, removed, and automatically make the changes 
};

useGet

import { useGet } from 'usefeathers';
 
const options = { realtime: true }; // optional
const [user, loading, error] = useGet('users', id, query, options);
// OR
const [getUser, user, loading, error] = useGet(() => 'users', options);
const response = await getUser(id, query); // return Promise
const options = {
    realtime: true || false
};

useCreate

import { useCreate } from 'usefeathers';
 
const [user, loading, error] = useCreate('users', {
    name: 'foo',
    email: 'foo@mail.com'
}, query);
// OR
const [createUser, user, loading, error] = useCreate(() => 'users');
const response = await createUsers(data, query); // return Promise
 
// query optional

usePatch

import { usePatch } from 'usefeathers';
 
const [user, loading, error] = usePatch('users', id, {
    name: 'foo',
    email: 'foo@mail.com'
}, query);
// OR
const [patchUser, user, loading, error] = usePatch(() => 'users');
const response = await patchUser(id, data, query); // return Promise
 
// query optional

useUpdate

import { useUpdate } from 'usefeathers';
 
const [user, loading, error] = useUpdate('users', id, {
    name: 'foo',
    email: 'foo@mail.com'
}, query);
// OR
const [updateUser, user, loading, error] = useUpdate(() => 'users');
const response = await updateUser(id, data, query); // return Promise
 
// query optional

useRemove

import { useRemove } from 'usefeathers';
 
const [user, loading, error] = useRemove('users', id, query);
// OR
const [removeUser, user, loading, error] = useRemove(() => 'users');
const response = await removeUser(id, query); // return Promise
 
// query optional

useRealtime

import { useRealtime } from 'usefeathers';
 
// events "created", "patched", "updated", "removed"
 
const [userCreated] = useRealtime('users', 'created');
// OR
const [userCreated] = useRealtime('users', 'created', (userCreated) => {
    console.log('created => ', userCreated);
});

useAuthenticate / useLogout / useAuthenticationEvents

import { useAuthenticate, useLogout, useAuthenticationEvents } from 'usefeathers';
 
const [authenticate, dataAuth, authenticated, loading, error] = useAuthenticate();
const [logout] = useLogout();
const response = useAuthenticationEvents('authenticated', (...args) => {
    console.log('event authenticated => ', args);
});
 
// events "authenticated", "logout", "reauthentication-error"

License

Package Sidebar

Install

npm i usefeathers

Weekly Downloads

2

Version

1.0.3

License

MIT

Unpacked Size

59.5 kB

Total Files

6

Last publish

Collaborators

  • hileomsi