The Store

The Store is a single object which contains the store state and serves as the single source of truth.

To create a store, you need to extend Akita's Store, passing the type as well as its initial state:

session.store.ts

import { Store, StoreConfig } from '@datorama/akita';

export interface SessionState {
   token: string;
   name: string;
}

export function createInitialState(): SessionState {
  return {
    token: '',
    name: ''
  };
}

@StoreConfig({ name: 'session' })
export class SessionStore extends Store<SessionState> {
  constructor() {
    super(createInitialState());
  }
}

With this setup you get a Store with the following methods:

update()

When you want to update the store, you can call the update() method passing the new state:

session.service.ts

import { SessionStore } from './session.store';
 
export class SessionService {
  constructor(private sessionStore: SessionStore) {}

  updateUserName(newName: string) {
    this.sessionStore.update({ name: newName });
  }  
}

The second update() option gives you more control. It receives a callback function, which gets the current state, and returns a new immutable state, which will be the new value of the store. For example:

session.service.ts

import { SessionStore } from './session.store';
 
export class SessionService {
  constructor(private sessionStore: SessionStore) {}

  updateUserName(newName: string) {
    this.sessionStore.update(state => ({
      name: newName
    }));
  }  
}

setLoading()

Set the loading state:

session.service.ts

import { SessionStore } from './session.store';
 
export class SessionService {
  constructor(private sessionStore: SessionStore, 
              private http: HttpClient) {}

  async updateUserName(newName: string) {
    this.sessionStore.setLoading(true);
    await this.http(...).toPromise();
    this.sessionStore.update({ name: newName});
    this.sessionStore.setLoading(false);
  }  
}

setError()

Set the error state:

session.service.ts

import { SessionStore } from './session.store';
 
export class SessionService {
  constructor(private sessionStore: SessionStore, 
              private http: HttpClient) {}

  async updateUserName(newName: string) {
    try {
      await this.http(...).toPromise();
    } catch(error) {
      this.sessionStore.setError(error);
    }
  }  
}

destroy()

Destroys the store:

sessionStore.destroy();