{"id":47836,"library":"graphql-compose-bullmq","title":"graphql-compose-bullmq","description":"A GraphQL-Compose plugin (v1.21.0) that auto-generates GraphQL types for BullMQ queues and jobs. Uses graphql-compose's schema builder to create queries (queueKeys, queues, queue, job) and mutations (queueClean, jobAdd, jobRemove, etc.) from BullMQ queue configuration. Requires bullmq ^1.91.1 and graphql-compose ^7.15.0 || ^8.0.0 || ^9.0.0 as peer dependencies. Ships TypeScript types. Releases follow semantic versioning via semantic-release. Key differentiator: eliminates manual GraphQL schema writing for BullMQ; generates 40+ types for queue management.","status":"active","version":"1.21.0","language":"javascript","source_language":"en","source_url":"https://github.com/graphql-compose/graphql-compose-bullmq","tags":["javascript","graphql","compose","bull","bullmq","job","redis","typescript"],"install":[{"cmd":"npm install graphql-compose-bullmq","lang":"bash","label":"npm"},{"cmd":"yarn add graphql-compose-bullmq","lang":"bash","label":"yarn"},{"cmd":"pnpm add graphql-compose-bullmq","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency; provides BullMQ queue and job operations.","package":"bullmq","optional":false},{"reason":"Peer dependency; provides schemaComposer and type composition utilities.","package":"graphql-compose","optional":false}],"imports":[{"note":"ESM default; for CJS use require with .default or .composeBull.","wrong":"const composeBull = require('graphql-compose-bullmq').composeBull","symbol":"composeBull","correct":"import { composeBull } from 'graphql-compose-bullmq'"},{"note":"schemaComposer is exported by graphql-compose, not this package.","wrong":"import { schemaComposer } from 'graphql-compose-bullmq'","symbol":"schemaComposer","correct":"import { schemaComposer } from 'graphql-compose'"},{"note":"Exported type for use in custom resolvers; requires graphql-compose's TypeComposer.","wrong":null,"symbol":"BullQueueType","correct":"import { BullQueueType } from 'graphql-compose-bullmq'"}],"quickstart":{"code":"import { composeBull } from 'graphql-compose-bullmq';\nimport { schemaComposer } from 'graphql-compose';\n\nconst { queryFields, mutationFields } = composeBull({\n  schemaComposer,\n  typePrefix: 'MyApp',\n  jobDataTC: `type MyJobData { url: String! createdAt: String }`,\n  queue: {\n    name: 'email',\n    prefix: 'bull',\n  },\n  redis: process.env.REDIS_URL ?? 'redis://localhost:6379',\n});\n\nschemaComposer.Query.addFields(queryFields);\nschemaComposer.Mutation.addFields(mutationFields);\n\nconst schema = schemaComposer.buildSchema();\nconsole.log('GraphQL schema built with BullMQ integration.');","lang":"typescript","description":"Creates a GraphQL schema with BullMQ queries and mutations using composeBull."},"warnings":[{"fix":"npm install bullmq@^1.91.1","message":"peer dependency bullmq must be ^1.91.1; other versions may cause type/runtime errors.","severity":"breaking","affected_versions":"<1.91.1"},{"fix":"npm install graphql-compose@^7.15.0 || ^8.0.0 || ^9.0.0","message":"graphql-compose version must be ^7.15.0 || ^8.0.0 || ^9.0.0; other versions may be incompatible.","severity":"breaking","affected_versions":"<7.15.0 >9.0.0"},{"fix":"const { composeBull } = require('graphql-compose-bullmq');","message":"If using CommonJS (require), import { composeBull } from 'graphql-compose-bullmq' will be undefined; use .default or destructure .composeBull.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use a string SDL: `type JobData { ... }` or create via schemaComposer.createObjectTC().","message":"jobDataTC must be a valid GraphQL type string or TypeComposer; passing an object will throw.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Stick to bullmq@^1.x or check compatibility with future releases.","message":"composeBull does not support BullMQ v3+ queue options like defaultJobOptions; use queue options compatible with bullmq@^1.x.","severity":"deprecated","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'1.91.1':48 '40':80 '7.15.0':53 '8.0.0':54 '9.0.0':55 'auto':13 'auto-gener':12 'builder':28 'bull':88 'bullmq':4,18,43,47,78,89 'compos':3,8,25,52,87 'configur':45 'creat':30 'depend':58 'differenti':71 'elimin':72 'etc':41 'follow':63 'generat':14,79 'graphql':2,7,15,24,51,74,86 'graphql-compos':6,23,50 'graphql-compose-bullmq':1 'javascript':85 'job':21,35,90 'jobadd':39 'jobremov':40 'key':70 'manag':84 'manual':73 'mutat':37 'peer':57 'plugin':9 'queri':31 'queue':19,33,34,44,83 'queueclean':38 'queuekey':32 'redi':91 'releas':62,69 'requir':46 'schema':27,75 'semant':64,68 'semantic-releas':67 'ship':59 'type':16,61,81 'typescript':60,92 'use':22 'v1.21.0':10 'version':65 'via':66 'write':76","created_at":"2026-06-07T16:53:33.963401+00:00","updated_at":"2026-06-07T16:53:33.963401+00:00","problems":[{"fix":"Use named import: import { composeBull } from 'graphql-compose-bullmq'","cause":"Using default import with ESM or incorrect require pattern.","error":"TypeError: composeBull is not a function"},{"fix":"npm install bullmq@^1.91.1","cause":"bullmq not installed or wrong version.","error":"Error: Cannot find module 'bullmq'"},{"fix":"Pass schemaComposer from graphql-compose: import { schemaComposer } from 'graphql-compose'","cause":"Missing schemaComposer in options object.","error":"Error: schemaComposer must be provided"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/graphql-compose/graphql-compose-bullmq","github":"https://github.com/graphql-compose/graphql-compose-bullmq","docs":null,"changelog":null,"pypi":null,"npm":"graphql-compose-bullmq","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}