@ngstato/eslint-plugin

Catch mistakes before they reach production.

3 rules for ngStato best practices. Zero config with recommended preset.

Install

npm install -D @ngstato/eslint-plugin

Setup (flat config)

// eslint.config.js
import ngstato from '@ngstato/eslint-plugin'

export default [
  ngstato.configs.recommended
]

Rules

| Rule | Default | Description | |------|---------|-------------| | ngstato/no-state-mutation-outside-action | error | Prevent direct state mutation outside actions | | ngstato/no-async-without-error-handling | warn | Require try/catch in async actions | | ngstato/require-devtools | warn | Suggest connectDevTools() after createStore() |

no-state-mutation-outside-action

// ❌ Error
this.store.count = 5

// ✅ OK
actions: {
  setCount(state, n: number) { state.count = n }
}

no-async-without-error-handling

// ⚠️ Warning
actions: {
  async loadUsers(state) {
    state.users = await http.get('/users')  // no try/catch
  }
}

// ✅ OK — try/catch
actions: {
  async loadUsers(state) {
    try {
      state.users = await http.get('/users')
    } catch (e) {
      state.error = (e as Error).message
    }
  }
}

// ✅ OK — wrapped in retryable
actions: {
  loadUsers: retryable(async (state) => {
    state.users = await http.get('/users')
  }, { attempts: 3 })
}

require-devtools

// ⚠️ Warning
const store = createStore({ count: 0 })
// missing: connectDevTools(store, 'Counter')

// ✅ OK
const store = createStore({ count: 0 })
connectDevTools(store, 'Counter')

License

MIT