Socket
Socket
Sign inDemoInstall

fastify-queue

Package Overview
Dependencies
104
Maintainers
1
Versions
22
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

fastify-queue

Plugin to easily intergrate BullMQ into fastify through file based Queue/Worker creation.


Version published
Maintainers
1
Weekly downloads
184
increased by27.78%

Weekly downloads

Readme

Source

Fastify Queue

Plugin to easily intergrate BullMQ into fastify through file based Queue/Worker creation.

Install

npm i fastify-queue
npm i bullmq

Usage

import fp from 'fastify-plugin';
import queue, { FastifyQueueOptions } from 'fastify-queue';
import * as IORedis from 'ioredis';

export default fp<FastifyQueueOptions>(async (fastify, opts) => {
  const connection = new IORedis({
    maxRetriesPerRequest: null,
    enableReadyCheck: false,
  });

  fastify.register(queue, {
    bullPath: '*/bull/**/*.js',
    connection: connection,
  });
});
Specify bullPath

The bullPath is a glob path and it specifies in which directory your worker functions and queues can be found.

For example with the folder structure below, we would create a Queue with the name of user and auth.

src
  - bull
    - user
        profile.worker.ts
    - auth
        auth.worker.ts

The name of the file inside the subdiretories is irrelevant. The name of the Queue is based on the subdirectories name.

If the file inside the subdiretories do not export a default function, it will just create a Queue with the name of the subdiretory. If a defualt function export exists it will be used as the Worker.

Worker Function

This is an example for a Worker function that accepts a fastify instance and a BullMQ job. Needs to be the default export.

import { FastifyInstance } from 'fastify';
import { Job } from 'bullmq';

interface AuthData {
  id: string;
  username?: string;
  email?: string;
}

const authWorker = async (
  fastify: FastifyInstance,
  job: Job<AuthData, any, string>
) => {
  const { id, email, username } = job.data;

  switch (job.name) {
    case 'create':
      break;
    case 'update':
      // handle jobs based on job name
      break;
    case 'delete':
      break;
    default:
      break;
  }
};

export default authWorker;

Queue & Worker Options

You can export two addittional variables besides your Worker Function named queueConfig and workerConfig. They are of type QueueOptions and WorkerOptions and if exist, can be used to configure addtional options supported by BullMQ.

export const queueConfig: QueueOptions = {
  defaultJobOptions: {
    removeOnComplete: true,
  },
};

export const workerConfig: WorkerOptions = {
  autorun: true,
  // connection would override default connection defined in plugin options
};

Typescript

In order to have typing for the fastify instance, you should follow the example below: This is the typing for the folder structure above if each file exports a worker function

declare module 'fastify' {
  export interface FastifyInstance {
    queues: {
      profile: Queue<ProfileData, any, string>;
      auth: Queue<AuthData, any, string>;
    };
    workers: {
      profile: Queue<ProfileData, any, string>;
      auth: Worker<AuthData, any, string>;
    };
  }
}

Keywords

FAQs

Last updated on 23 Dec 2021

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc