Central Dogma client for Node.js

![npm version
!npm bundle size
!Dependencies
](https://www.npmjs.com/package/@matsumana/centraldogma-nodejs)

![npm downloads
](https://npmcharts.com/compare/@matsumana/centraldogma-nodejs)

![CircleCI
](https://app.circleci.com/pipelines/github/matsumana/centraldogma-nodejs?branch=main)

![Known Vulnerabilities
](https://snyk.io/test/github/matsumana/centraldogma-nodejs)

This is an "unofficial" client library for Central Dogma.

What is Central Dogma?

Central Dogma is an open-source, highly-available and version-controlled service configuration repository

Please visit the official web site for more information.

In Central Dogma, there are various use cases.

e.g.

- Service discovery
- Managing Rate limit configuration
- Managing A/B testing configuration
- etc

If you refer to a Central Dogma server via client library, an app can get a change immediately.

It means that no need to restart your app for applying that changes.

Configure something that you want to apply changes without restarting your server application.

How to use this client library

$3

``
$ npm i @matsumana/centraldogma-nodejs
`

$3

You can get changes via EventEmitter continuously.

Please refer to the examples for more details.

`typescript
import { CentralDogma } from '@matsumana/centraldogma-nodejs';

const centralDogma = new CentralDogma({
baseURL: 'http://localhost:36462',
});

const emitter = centralDogma.watch.watchFile({
project: 'project1',
repo: 'repo1',
filePath: '/example_config.json',
});
`

$3

#### get a file

`typescript
import { CentralDogma } from '@matsumana/centraldogma-nodejs';

const centralDogma = new CentralDogma({
baseURL: 'http://localhost:36462',
});

const entry = await centralDogma.content.getFile({
project: 'project1',
repo: 'repo1',
query: {
path: '/example_config.json',
type: QueryTypes.Identity,
},
});
`

#### register or change files

`typescript
import { CentralDogma } from '@matsumana/centraldogma-nodejs';

const centralDogma = new CentralDogma({
baseURL: 'http://localhost:36462',
});

const result = await centralDogma.content.push({
project: 'project1',
repo: 'repo1',
baseRevision: 'HEAD',
commitMessage: {
summary: 'Add /config1.json and /config2.json',
detail: 'You can write a detail for changes',
},
changes: [
{
path: '/config1.json',
type: ChangeTypes.UpsertJson,
content: { field1: 'foo' },
},
{
path: '/config2.json',
type: ChangeTypes.UpsertJson,
content: { field1: 'bar' },
},
],
});
``

$3

There are some more APIs.

Please refer to the sources and tests for more details.