Model defaults

You can define default options for all the models in your application. This is useful for setting up default values for properties that are common across all models, such as getKey.

Set them on the modelDefaults option of createStore.

Accepted properties

You can define the following properties in the modelDefaults option:

• getKey: a function that takes the model name and the item and returns the key for the item. This is useful for setting up default keys for all models.

• isInstanceOf: a function that takes the model and returns a new function taking the item as parameter and returning a boolean indicating if the item is an instance of the model.

• computed: an object that contains computed fields for all models. This is useful for setting up default computed fields for all models. Each model can override the default computed fields by defining its own computed properties with the same name.

• fields: an object that contains field configurations for all models. This is useful for setting up default field configurations for all models. Each model can override the default field configurations by defining its own fields properties with the same name.

• meta: an object that contains metadata for all models. This is useful for setting up default metadata for all models. Each model can override the default metadata by defining its own meta properties with the same name.

Plugin API

Plugins can also define default options for all models - using the addModelDefaults method:

import { definePlugin } from '@rstore/vue'

export default definePlugin({
  name: 'my-rstore-plugin',
  setup({ addModelDefaults, hook }) {
    addModelDefaults({
      getKey: (modelName, item) => item.customId,
      // ...
    })
  }
})

Recipes

Default key

const store = createStore({
  models,
  plugins,
  modelDefaults: {
    getKey: (modelName, item) => item.customId,
  },
})

Instance checking using __typename

const store = createStore({
  models,
  plugins,
  modelDefaults: {
    isInstanceOf: model => item => item.__typename === model.name
  },
})

Default parse for dates

Using the field configuration, you can set up a default parse function for all date fields in your models. This is useful for parsing dates from the server and converting them to JavaScript Date objects.

function parseDate(value: any): Date {
  return typeof value === 'string' ? new Date(value) : value
}

const store = createStore({
  models,
  plugins,
  modelDefaults: {
    fields: {
      createdAt: {
        parse: parseDate,
      },
      updatedAt: {
        parse: parseDate,
      },
    },
  },
})