@nitra/vite-boot
v6.0.4
Published
Vite boot
Readme
@nitra/vite-boot
Boot-набір для Vue 3 + Quasar SPA на Hasura: готовий URQL-клієнт (HTTP + WebSocket-subscriptions з JWT), робота з токеном/користувачем, роутер-гуарди й Pinia.
Subpath-експорти
| Імпорт | Призначення |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| @nitra/vite-boot/urql | URQL (HTTP+WS), urqlPlugin, graphqlClient, gql, useQuery/useMutation/useSubscription |
| @nitra/vite-boot/graphql-dev | opt-in Vite fixture для GraphQL HTTP, multipart, SSE і graphql-transport-ws |
| @nitra/vite-boot/token | checkToken, getToken, refreshToken, autoLogin, defaultLogin, cleanToken |
| @nitra/vite-boot/user | реактивний user, checkedToken, setUser/unsetUser |
| @nitra/vite-boot/router | setRouter, canUserAccess (route-guard за ролями) |
| @nitra/vite-boot/pinia | сконфігурований інстанс pinia |
Env-змінні
| Змінна | Використання |
| ---------------------- | --------------------------------------------------------------------------------------------- |
| VITE_HASURA_HOST | хост Hasura — з нього будується HTTP https://<host>/v1/graphql і WS-URL |
| VITE_HASURA_PROTOCOL | протокол WS (wss/ws); wss → HTTP стає https |
| VITE_HASURA_ROLE | список дозволених ролей через кому; user.role = перший збіг із x-hasura-allowed-roles JWT |
| VITE_DOMAIN | домен для видалення cookie __session при cleanToken() |
| BASE_URL | база застосунку (logout-redirect, refresh-endpoint) |
@nitra/vite-boot/urql
Готовий URQL-клієнт із розділенням трафіку: subscriptions → WebSocket, решта (query/mutation) → HTTP. До кожного запиту автоматично додаються Authorization: Bearer <checkedToken> і x-hasura-role: <user.role>.
// main.js
import { createApp } from 'vue'
import { graphqlClient, urqlPlugin } from '@nitra/vite-boot/urql'
import App from './App.vue'
createApp(App).use(urqlPlugin, graphqlClient)Експорти: graphqlClient, wsClient, urqlPlugin, gql, useQuery, useMutation, useSubscription, logout, restartGraphqlTransport, resetGraphqlClient, а також core primitives cacheExchange, createClient, getOperationName, makeResult.
restartGraphqlTransport() закриває поточний WebSocket і створює новий lazy-клієнт. Викликайте його після успішного оновлення JWT, щоб наступна subscription передала свіжий токен у connectionParams. Базовий проактивний refresh лишається в @nitra/vite-boot/token → refreshToken() і робить це автоматично.
@nitra/vite-boot/graphql-dev
graphqlDevServer() — opt-in Vite plugin лише для development та integration tests. Він сам серіалізує одиничний result як GraphQL HTTP JSON, а AsyncIterable — як multipart/mixed або GraphQL-over-SSE залежно від Accept. HTTP operation, що починається з subscription, і graphql-transport-ws operation обидві передаються до subscribe. Пакет не містить schema або fixture-даних: їх визначає застосунок.
import { graphqlDevServer } from '@nitra/vite-boot/graphql-dev'
export default {
plugins: [graphqlDevServer({
execute: ({ operationName }) => operationName === 'Health' ? { data: { health: true } } : undefined,
subscribe: ({ operationName }) => operationName === 'WatchHealth' ? watchHealth() : undefined
})]
}execute отримує query або mutation і повертає один result або AsyncIterable results. subscribe повертає AsyncIterable для HTTP subscription і WebSocket operation. Endpoint за замовчуванням — /v1/graphql; його можна змінити опцією path.
