README.md
# 🧠 🔒 Haf 🦺 ✏️
[](https://www.npmjs.com/package/@batuhanw/haf)
[](https://snyk.io/test/github/BatuhanW/haf?targetFile=package.json)
[](https://codeclimate.com/github/BatuhanW/haf/maintainability)
[](https://codeclimate.com/github/BatuhanW/haf/test_coverage)
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.
> [Go to gifs section to see it in action!](./README.md#Gifs)
## Installation
```
npm i @batuhanw/haf
OR
yarn add @batuhanw/haf
```
## 🏃 Getting Started
### 1. Define Your Schema
```typescript
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
```typescript
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,
},
});
```
### 3. Enjoy
#### Get
```typescript
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 error
```
#### Set
```typescript
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 error
```
#### Append
Appends given values to the existing array
```typescript
haf.get('toys'); // ['socks', 'toilet paper']
haf.append('toys', 'human hand', 'bone');
haf.get('toys'); // ['socks', 'toilet paper', 'human hand', 'bone']
```
#### Delete
```typescript
haf.delete('sterilizedAt');
haf.delete('appearance.hairColor.secondary');
haf.delete('name'); // type error
haf.delete('appearance.hairColor.primary'); // type error
```
### Gifs
#### Get
#### Set
#### Delete
