@vasto-queue/fastify-adapter

Fastify integration adapter for Vasto dashboard API.

For in-process mounting, ensure Fastify has middleware support (@fastify/middie or @fastify/express) and then mount the adapter middleware into your app.

Usage

import path from 'node:path';
import {
  bindVastoFastifyWebSocket,
  vastoFastifyAdapter,
} from '@vasto-queue/fastify-adapter';

await fastify.register(import('@fastify/middie'));
fastify.use(
  vastoFastifyAdapter({
    supervisor,
    apiBase: '/api/vasto',
    uiDir: path.resolve(process.cwd(), 'public/vasto-dashboard'),
    uiBase: '/',
    protectUiWithAuth: false,
  })
);

bindVastoFastifyWebSocket(fastify.server, {
  supervisor,
  apiBase: '/api/vasto',
});

Publishing UI assets

queue dashboard:publish --out=./public/vasto-dashboard

dashboard:publish resolves assets from installed @vasto-queue/dashboard in node_modules and copies them into the target directory. A dashboard-config.example.js file is also generated in the output directory — see its inline comments for all available runtime config keys.

Runtime configuration

If WebSocket upgrades are unavailable (proxy, serverless platform, CDN), force polling without rebuilding the dashboard by injecting a config object before the dashboard <script> tag in your page template:

<script>
  window.__VASTO_DASHBOARD_CONFIG__ = {
    transport: 'polling',          // 'auto' (default) | 'polling'
    endpoint:  '/api/vasto',  // must match the apiBase option above
  };
</script>

You can also test per-request with the URL query param: ?transport=polling.