Declarative service integration into bus

[tshemsedinov]

We need declarative way to describe integration

To map remote APIs into local application server namespaces with declarative (metadata) descriptions converting them into local stubs catching all calls and transferring them into HTTP(S), WS(S) or other transport interaction.

Here is an example

Service metadata: application/bus/adderService/.service.js

({
  url: 'https://adderService.com/api/adder',
  token: config.secrets.adderService.token,
});

Method metadata: application/bus/adderService/add.js

({
  parameters: {
    a: 'number',
    b: 'number',
  },

  method: {
    get: '/add',
    form: ['a', 'b'],
  },

  returns: 'number',
});

Call example: application/domain/usageExample/doSomething.js

async () => {
  const result = await bus.adderService.add({ a: 100, b: 200 });
  if (result !== 300) throw new Error('I can not believe that');
};

Do not forget to support

• Path parameters
• Query parameters
• HTTP headers
• Body serialization
• Cookies

See also: https://swagger.io/docs/specification/serialization/