This is the server component of Slay Q.
This is a thin wrapper around the super awesome Graphile Worker which is doing all of the heavy lifting.
Install package:
# npm
npm install @slay-pics/slay-q-server
# yarn
yarn add @slay-pics/slay-q-server
# pnpm
pnpm install @slay-pics/slay-q-server
# bun
bun install @slay-pics/slay-q-server
Run:
npx slay-q-server /path/to/slay-config.json
Run without installing:
npx @slay-pics/slay-q-server@latest /path/to/slay-config.json
- Postgres database
The first time you run the server, two migrations will be run:
- A schema and related tables called
graphile_worker
will be created. This schema is required for Graphile Worker to function. - A second schema and related tables/function called
slayq
will be created. This contains all the tables and functions SlayQ needs to do its housekeeping. - Additionally, a few functions will be created in the
public
schema. This is necessary for Supabase as you cannot access other schemas with their js libs.
You must have a few environment variables defined prior to launching slay-q-server
:
-
SLAY_Q_DATABASE_URL
- The connection string url for your postgres database. -
SLAY_Q_SECRET
- The secret used to sign events posted to your app's slay-q receiver endpoint. -
SLAY_Q_CRON_URL
- The URL to your slay-q receiver endpoint that will receive cron events.
To run slay-q-server
, you need to create a config file first:
{
"queues": {
"mail": {
"concurrency": 4
},
"messaging": {
"concurrency": 6,
"alias": [
"dispatch",
"ready"
]
},
"interactions": {
"concurrency": 1,
"alias": [
"reconcile",
"discord"
]
},
"housekeeping": {
"concurrency": 2
},
"profile": {
"concurrency": 8
},
"general": {
"concurrency": 10
}
}
}
We are essentially defining a variety of queues and their level of concurrency (the number of tasks that can run at once in the queue). Additionally, we are specifying aliases for these queues. These aliases are only provided to help keep things organized on the client side of things.
Published under MIT License.