History

Daniel Lockyer 713cbd3cc4 Unpinned all dependencies no issue - this Utils repo contains libraries, whose dependencies should not be pinned in order to reduce multiple versions of the same package appearing for consumers		2021-04-16 13:06:54 +01:00
..
lib	Improved handling of invalid actions	2020-05-18 15:41:16 +02:00
test	Remove trailing commas from .eslintrc.js files	2020-08-04 14:48:07 +01:00
types	Added newly generated TypeScript definiton files	2021-04-07 13:41:49 +12:00
.eslintrc.js	Remove trailing commas from .eslintrc.js files	2020-08-04 14:48:07 +01:00
index.js
LICENSE	2021	2021-01-25 16:20:43 +00:00
package.json	Unpinned all dependencies	2021-04-16 13:06:54 +01:00
README.md	2021	2021-01-25 16:20:43 +00:00
tsconfig.json

README.md

Moleculer Service From Class

This module is used to wrap a standard JS Class as a moleculer service, exposing the public methods as actions on the service. It will also wrap other moleculer services in an object with methods, for each of the services actions and injects them into the class constructor.

This allows us to write generic code, and then use moleculer as the transport layer between services, taking advantage of its load balancing, transporters, logging, tracing & other niceitys

Because moleculer is an asyncronous transport mechanism - all methods MUST be async. Also all methods should accept params as an object with keys - this works with moleculers concept of ctx.params much better.

Private methods are prefixed with an underscore ('_')

Install

npm install @tryghost/moleculer-service-from-class --save

yarn add @tryghost/moleculer-service-from-class

Usage

const srvFromClass = require('@tryghost/moleculer-service-from-class');

class SomeService {
    async capitalize({string}) {
        return string.toUpperCase();
    }
}

class MyAwesomeService {
    constructor({someService, someConfig}) {
        this._someService = someService;
        this._someConfig = someConfig;
    }

    async myCoolMethod({name}) {
        const NAME = await this._someService.capitalize({string: name});

        return `${this._someConfig.greeting}, ${NAME}`;
    }
}

/**
 * Moleculer way
 */

const { ServiceBroker } = require('moleculer');

const broker = new ServiceBroker();
broker.addService(srvFromClass({
    Service: SomeService,
    name: 'some-service'
}));
broker.addService(srvFromClass({
    Service: MyAwesomeService,
    name: 'awesome',
    serviceDeps: {
        someService: 'some-service'
    },
    staticDeps: {
        someConfig: { greeting: 'hello' }
    }
}))

broker.start().then(() => {
    broker.call('awesome.myCoolMethod', {name: 'egg'}).then(console.log);
});


/**
 * Generic way
 */

const awesome = new MyAwesomeService({
    someConfig: { greeting: 'Hello' },
    someService: new SomeService()
});

awesome.myCoolMethod({name: 'egg'}).then(console.log);

Develop

This is a mono repository, managed with lerna.

Follow the instructions for the top-level repo.

git clone this repo & cd into it as usual
Run yarn to install top-level dependencies.

Run

yarn dev

Test

yarn lint run just eslint
yarn test run lint and tests