feat(types): add typescript type generation as part of build process. Add named export run that exports middleware/queues in arena.

Author: Eric Hayes

.gitignore

@@ -1,8 +1,9 @@
+index.d.ts
 node_modules
 package-lock.json
 *.DS_Store
 .vscode
 .idea
 *.tern-port
 *.sublime-workspace
-dump.rdb
+dump.rdb

.prettierignore

@@ -1,4 +1,6 @@
 *.hbs
 *.min.js
 *.min.css
+*.d.ts
+tsconfig.json
 pull_request_template.md

README.md

@@ -171,6 +171,41 @@ router.use('/', arena);
 - `useCdn` - set false to use the bundled js and css files (default: true)
 - `customCssPath` - an URL to an external stylesheet (default: null)
 
+In addition to the default export, you can also access both arena and the underlying queues using the named export `run`:
+
+```js
+const Arena = require('bull-arena').run;
+
+const express = require('express');
+const router = express.Router();
+
+const arena = Arena({
+  // Include a reference to the bee-queue or bull libraries, depending on the library being used.
+
+  queues: [
+    {
+      // First queue configuration
+    },
+    {
+      // Second queue configuration
+    },
+    {
+      // And so on...
+    },
+  ],
+});
+
+// manage arena queues using queue
+//app.queues.list()
+
+router.use('/', arena.app);
+```
+
+When calling the named export `run` the following are returned:
+
+- `app` - the arena middleware
+- `queues` - the underlying queues in arena
+
 ##### Example config (for bull)
 
 ```js

index.js

@@ -25,7 +25,18 @@ function run(config, listenOpts = {}) {
     });
   }
 
-  return app;
+  return {
+    app,
+    queues: Queues,
+  };
 }
 
-module.exports = run;
+function runDefault(config, listenOpts = {}) {
+  return run(config, listenOpts).app;
+}
+
+// default export remains unchanged
+module.exports = runDefault;
+
+// named exports
+module.exports.run = run;

package-lock.json

@@ -2,6 +2,7 @@
   "name": "bull-arena",
   "description": "An interactive UI dashboard for Bee Queue",
   "main": "index.js",
+  "types": "index.d.ts",
   "author": "Mixmax <hello@mixmax.com>",
   "license": "MIT",
   "dependencies": {
@@ -23,6 +24,7 @@
     "@semantic-release/github": "^7.0.7",
     "@semantic-release/npm": "^7.0.5",
     "@semantic-release/release-notes-generator": "^9.0.1",
+    "@types/express": "^4.17.11",
     "bee-queue": "^1.2.3",
     "bull": "^3.16.0",
     "conventional-changelog-conventionalcommits": "^4.3.0",
@@ -33,12 +35,14 @@
     "lint-staged": "^10.5.4",
     "prettier": "^2.0.5",
     "pretty-quick": "^3.1.0",
-    "semantic-release": "^17.4.2"
+    "semantic-release": "^17.4.2",
+    "typescript": "^4.2.4"
   },
   "scripts": {
-    "ci": "npm run lint && if [ -z \"$CI\" ]; then npm run ci:commitlint; fi",
+    "ci": "npm run generate:types && npm run lint && if [ -z \"$CI\" ]; then npm run ci:commitlint; fi",
     "ci:commitlint": "commitlint --from \"origin/${GITHUB_BASE_REF:-master}\"",
     "dry:run": "npm publish --dry-run",
+    "generate:types": "tsc",
     "lint": "prettier -c .",
     "lint:staged": "lint-staged",
     "prepare": "husky install",

package.json

@@ -36,6 +36,6 @@ module.exports = function (config) {
 
   return {
     app,
-    Queues: app.locals.Queues,
+    Queues: queues,
   };
 };

src/server/app.js

@@ -0,0 +1,9 @@
+{
+  "files": ["index.js"],
+  "compilerOptions": {
+    "allowJs": true,
+    "declaration": true,
+    "emitDeclarationOnly": true,
+    "outFile": "index.d.ts"
+  }
+}