Actions

Actions are methods declared under actions in defineModel(). They are bound to the model's internal proxy, so this can read state, views, actions, direct query fetch functions, $queries handles, and child models.

import { defineModel } from 'doura'

export const counterModel = defineModel({
  name: 'counter',
  state: {
    count: 0,
  },
  actions: {
    increment(step = 1) {
      this.count += step
    },
    reset() {
      this.$state = { count: 0 }
    },
    patchCount(count: number) {
      this.$patch({ count })
    },
  },
})

Do not use arrow functions for actions that need this.

Queries split direct fetch from cache control:

actions: {
  async loadUser(id: string) {
    const user = await this.fetchUser(id)
    this.userData = user
  },
  refreshUser(id: string) {
    this.$queries.fetchUser.invalidate(id)
  },
}

Async Actions

Actions can be asynchronous and can call other actions:

export const userModel = defineModel({
  name: 'user',
  state: {
    userData: null as User | null,
    loading: false,
  },
  actions: {
    async registerUser(login: string, password: string) {
      this.loading = true
      try {
        this.userData = await api.post({ login, password })
      } finally {
        this.loading = false
      }
    },
  },
})

Action return types and arguments are inferred from the model definition:

const counter = store.getModel(counterModel)

counter.increment(2)