π§ π Haf π¦Ί βοΈ
Haf is a fully typed
βοΈ Auto-completed dot-notation suggestions as you type when you try to get()/set()/delete()/reset() data from the store.β The type of the value you get() from the store is correctly inferred. So you always know what you'll get().β Non-nullable values aren't suggested on delete(). Trying to delete() a non-nullable field will throw a type error.
Installation
npm i @batuhanw/haf
OR
yarn add @batuhanw/haf
π Getting Started
1. Define Your Schema
interface DogSchema {
name: string;
age: number;
toys: string[];
vaccines: { name: string; date: string; nextDate?: string }[];
appearance: {
eyeColor: string;
hairColor: {
primary: string;
secondary?: string;
otherColors: string[];
};
};
sterilizedAt?: string;
hasPuppies: boolean;
}2. Initiate Haf
import Haf from '@batuhanw/haf'
const haf = new Haf<DogSchema>(
{
name: 'myDog',
defaultSchema: {
name: 'Pop',
age: 2,
toys: ['socks', 'toilet paper'],
vaccines: [
{ name: 'rabbies', date: '2020-01-01' },
{ name: 'parasite', date: '2020-01-01', next: '2020-01-03' },
],
appearance: {
eyeColor: 'brown',
hairColor: {
primary: 'white',
secondary: undefined,
otherColors: ['black'],
},
},
sterilizedAt: undefined,
hasPuppies: false,
}
}
)3. Enjoy
Get
const name = haf.get('name') // string
const age = haf.get('age') // number
const hasPuppies = haf.get('hasPuppies') // boolean
const vaccines = haf.get('vaccines') // { name: string; date: string; nextDate?: string }[]
const hairColor: haf.get('appearance.haircolor') // { primary: string; secondary?: string, otherColors: string[] }
const secondaryHairColor: haf.get('appearance.hairColor.secondary') // string | undefined
const invalid = haf.get('non-existent') // type errorSet
haf.set('name', 'Pop');
haf.set('appearance.hairColor', { primary: 'white' });
haf.set('appearance.hairColor.secondary', 'brown');
haf.set('appearance.hairColor.secondary', undefined);
haf.set('appearance.hairColor.otherColors', ['black']) // This will overwrite existing array
haf.set('name', 1); // type error
haf.set('toys', [1, 2]); // type error
haf.set('appearance.haircolor', { primary: 1 }); //type error
haf.set('appearance.hairColor.primary', 1); // type error
haf.set('appearance.haircolor', { notExist: 'white' }); //type errorAppend
Appends given values to the existing array
haf.get('toys') // ['socks', 'toilet paper']
haf.append('toys', 'human hand', 'bone')
haf.get('toys') // ['socks', 'toilet paper', 'human hand', 'bone']Delete
haf.delete('sterilizedAt');
haf.delete('appearance.hairColor.secondary');
haf.delete('name'); // type error
haf.delete('appearance.hairColor.primary'); // type errorGifs
Get
Set
Delete
