tom-microservice 3.7.1 → 3.8.0

package/README.md

@@ -62,6 +62,10 @@ To view details for a command at any time use `tom --help`
 
 ### from Node.js
 
+#### as process
+
+You can interact with **tom** 🐶 from Node.js user code:
+
 ```js
 // First of all you need to declare a configuration file.
 const config = {/* See configuration section */}
@@ -73,6 +77,37 @@ const tom = require('tom-microservice')(config)
 const { payment, email } = tom
 ```
 
+#### as HTTP router
+
+Additionally, you can get the **tom** 🐶 HTTP router in standalone way:
+
+```js
+const { createRoutes } = require('tom-microservice')
+const config = {/* See configuration section */}
+
+const router = createRoutes(config, ({ tom, router, send }) => {
+  router
+    .get('/ping', (req, res) => send(res, 200, 'healthy'))
+})
+```
+
+#### as HTTP server
+
+You can also intialize **tom** 🐶 HTTP server from code:
+
+```js
+const { listen, createRoutes } = require('tom-microservice')
+
+const config = {/* See configuration section */}
+
+const router = createRoutes(config, ({ tom, router, send }) => {
+  router
+    .get('/ping', (req, res) => send(res, 200, 'healthy'))
+})
+
+listen(config, { routes })
+```
+
 ## Configuration
 
 !> Combine with [miconfig](https://www.npmjs.com/package/miconfig) for loading different settings based on environment.

package/bin/listen.js

@@ -7,8 +7,9 @@ const { createServer } = require('http')
 const PORT =
   process.env.PORT || process.env.port || process.env.TOM_PORT || 3000
 
-module.exports = async (tomConfig, { port = PORT } = {}) => {
-  const routes = require('../src/routes')(tomConfig)
+module.exports = async (tomConfig, { port = PORT, routes } = {}) => {
+  if (!routes) routes = require('../src/routes')(tomConfig)
+
   const server = createServer(routes)
 
   server.listen(port, () => {

package/package.json

@@ -2,7 +2,7 @@
   "name": "tom-microservice",
   "description": "Tom creates customers, subscriptions plans & send notifications.",
   "homepage": "https://tom.js.org",
-  "version": "3.7.1",
+  "version": "3.8.0",
   "main": "src",
   "bin": {
     "tom": "bin/index.js"

package/src/routes.js

@@ -1,6 +1,6 @@
 'use strict'
 
-const { get, eq, forEach } = require('lodash')
+const { get, eq, forEach, noop } = require('lodash')
 const { buffer, text } = require('http-body')
 const requestIp = require('request-ip')
 const toQuery = require('to-query')()
@@ -92,15 +92,15 @@ const createRouter = () => {
   }
 
   router
-    .get('/', (req, res) => send(res, 204))
-    .get('/robots.txt', (req, res) => send(res, 204))
-    .get('/favicon.ico', (req, res) => send(res, 204))
-    .get('/ping', (req, res) => send(res, 200, 'pong'))
+    .get('/', (_, res) => send(res, 204))
+    .get('/robots.txt', (_, res) => send(res, 204))
+    .get('/favicon.ico', (_, res) => send(res, 204))
+    .get('/ping', (_, res) => send(res, 200, 'pong'))
 
   return router
 }
 
-module.exports = tomConfig => {
+module.exports = (tomConfig, fn = noop) => {
   if (!tomConfig) throw TypeError('You need to provide tom configuration file.')
 
   const router = createRouter()
@@ -116,5 +116,7 @@ module.exports = tomConfig => {
     })
   })
 
+  fn({ tom, router, send })
+
   return router
 }