Haf is a fully typed 🔒, cross-platform, persistent 💾 JSON storage ⚙️ solution for your NodeJS projects with a great developer experience!
- ✏️ 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.
npm i @batuhanw/haf
OR
yarn add @batuhanw/haf
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;
}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', nextDate: '2020-01-03' },
],
appearance: {
eyeColor: 'brown',
hairColor: {
primary: 'white',
secondary: undefined,
otherColors: ['black'],
},
},
sterilizedAt: undefined,
hasPuppies: false,
},
}); 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 errorhaf.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 errorAppends 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']haf.delete('sterilizedAt');
haf.delete('appearance.hairColor.secondary');
haf.delete('name'); // type error
haf.delete('appearance.hairColor.primary'); // type error
