@treatwell/moleculer-essentials 1.1.0-beta.1 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +162 -0
- package/package.json +8 -7
package/README.md
CHANGED
|
@@ -1 +1,163 @@
|
|
|
1
1
|
# moleculer-essentials
|
|
2
|
+
|
|
3
|
+
[](https://treatwell.com/tech)
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/@treatwell/moleculer-essentials)
|
|
6
|
+
|
|
7
|
+
<!-- TOC -->
|
|
8
|
+
|
|
9
|
+
- [Purpose](#purpose)
|
|
10
|
+
- [Features](#features)
|
|
11
|
+
- [Installation](#installation)
|
|
12
|
+
- [Companion Packages](#companion-packages)
|
|
13
|
+
- [Usage](#usage)
|
|
14
|
+
- [Basic Example](#basic-example)
|
|
15
|
+
- [Mixins](#mixins)
|
|
16
|
+
- [License](#license)
|
|
17
|
+
<!-- TOC -->
|
|
18
|
+
|
|
19
|
+
## Purpose
|
|
20
|
+
|
|
21
|
+
`@treatwell/moleculer-essentials` is a collection of essential utilities and helpers for building
|
|
22
|
+
and managing microservices using the Moleculer framework. It aims to have a better TS support and add commonly use mixins
|
|
23
|
+
and middlewares.
|
|
24
|
+
|
|
25
|
+
## Features
|
|
26
|
+
|
|
27
|
+
- **TypeScript Support**: By using the `wrapService` (and `wrapMixin`) functions, TS can automatically infer methods signatures, settings, etc.
|
|
28
|
+
- **Common Mixins**: Includes MongoDB, Redis, Redlock, BullMQ, and more mixins commonly used in backend applications.
|
|
29
|
+
- **Zod Validation**: Integrates Zod for schema validation in service actions. Also supports (legacy) Ajv validation.
|
|
30
|
+
- **OpenAPI Integration**: Easily provide a OpenAPI (Swagger) documentation for your services.
|
|
31
|
+
- And more...
|
|
32
|
+
|
|
33
|
+
## Installation
|
|
34
|
+
|
|
35
|
+
You need to add both `moleculer-essentials` and `moleculer` in your dependencies:
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
yarn add @treatwell/moleculer-essentials moleculer
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## Companion Packages
|
|
42
|
+
|
|
43
|
+
To complete the TS support and improve the developer experience, we also provide the following companion packages:
|
|
44
|
+
|
|
45
|
+
- [@treatwell/moleculer-call-wrapper](https://github.com/treatwell/moleculer-call-wrapper): A dev dependency to generate a fully typed `call` function that replaces the default `ctx.call` in Moleculer services.
|
|
46
|
+
- [@treatwell/eslint-plugin-moleculer](https://github.com/treatwell/eslint-plugin-moleculer): An ESLint plugin to work with this package to improve TS support and prevent some common mistakes.
|
|
47
|
+
|
|
48
|
+
## Usage
|
|
49
|
+
|
|
50
|
+
### Basic Example
|
|
51
|
+
|
|
52
|
+
```ts
|
|
53
|
+
// src/index.ts
|
|
54
|
+
import fg from 'fast-glob';
|
|
55
|
+
import {
|
|
56
|
+
HealthCheckMiddleware,
|
|
57
|
+
createLoggerConfig,
|
|
58
|
+
createServiceBroker,
|
|
59
|
+
defaultLogger,
|
|
60
|
+
ZodValidator,
|
|
61
|
+
} from '@treatwell/moleculer-essentials';
|
|
62
|
+
import { fileURLToPath } from 'url';
|
|
63
|
+
import { dirname, join } from 'path';
|
|
64
|
+
import { config } from 'dotenv';
|
|
65
|
+
|
|
66
|
+
async function run() {
|
|
67
|
+
// Create Service Broker
|
|
68
|
+
const broker = createServiceBroker({
|
|
69
|
+
validator: new ZodValidator(),
|
|
70
|
+
logger: createLoggerConfig(),
|
|
71
|
+
});
|
|
72
|
+
|
|
73
|
+
// -> Filter out service to launch
|
|
74
|
+
const entries = await fg('**/*.service.{ts,js}', {
|
|
75
|
+
cwd: join(import.meta.dirname, 'services'),
|
|
76
|
+
absolute: true,
|
|
77
|
+
});
|
|
78
|
+
|
|
79
|
+
const services = entries.map(f => broker.loadService(f));
|
|
80
|
+
|
|
81
|
+
if (process.env.MOLECULER_CALL_WRAPPER === 'yes') {
|
|
82
|
+
import('@treatwell/moleculer-call-wrapper')
|
|
83
|
+
.then(async ({ createWrapperCall }) =>
|
|
84
|
+
createWrapperCall('./src/call.ts', services, entries, []),
|
|
85
|
+
)
|
|
86
|
+
.catch(err => {
|
|
87
|
+
broker.logger.error('Error while creating call wrapper', err);
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
await broker.start();
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
run().catch(err => {
|
|
95
|
+
defaultLogger.error('Error while starting server', { err });
|
|
96
|
+
process.exit(1);
|
|
97
|
+
});
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
```ts
|
|
101
|
+
// src/services/sum.service.ts
|
|
102
|
+
import { wrapService } from '@treatwell/moleculer-essentials';
|
|
103
|
+
import { z } from 'zod/v4';
|
|
104
|
+
import { Context } from 'moleculer';
|
|
105
|
+
|
|
106
|
+
const AddParamsSchema = z.object({ a: z.number(), b: z.number() });
|
|
107
|
+
|
|
108
|
+
export default wrapService({
|
|
109
|
+
name: `sum`,
|
|
110
|
+
actions: {
|
|
111
|
+
add: {
|
|
112
|
+
params: AddParamsSchema,
|
|
113
|
+
async handler(
|
|
114
|
+
ctx: Context<z.infer<typeof AddParamsSchema>>,
|
|
115
|
+
): Promise<number> {
|
|
116
|
+
return ctx.params.a + ctx.params.b;
|
|
117
|
+
},
|
|
118
|
+
},
|
|
119
|
+
},
|
|
120
|
+
});
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
### Mixins
|
|
124
|
+
|
|
125
|
+
Except for the `OpenAPIMixin`, mixins are **not** exported directly from `@treatwell/moleculer-essentials`.
|
|
126
|
+
Each mixin is available in its own namespace. For example, to use the `RedisMixin`, you first need to install the `ioredis`
|
|
127
|
+
package:
|
|
128
|
+
|
|
129
|
+
```bash
|
|
130
|
+
yarn add ioredis
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
Then, you can import and use the mixin like this:
|
|
134
|
+
|
|
135
|
+
```ts
|
|
136
|
+
import { wrapService } from '@treatwell/moleculer-essentials';
|
|
137
|
+
import { RedisMixin } from '@treatwell/moleculer-essentials/redis';
|
|
138
|
+
import { Context } from 'moleculer';
|
|
139
|
+
|
|
140
|
+
export default wrapService({
|
|
141
|
+
name: 'my-service',
|
|
142
|
+
mixins: [RedisMixin({ host: 'localhost' })],
|
|
143
|
+
|
|
144
|
+
actions: {
|
|
145
|
+
myAction: {
|
|
146
|
+
async handler(ctx: Context): Promise<string | undefined> {
|
|
147
|
+
return this.getRedis().get('key');
|
|
148
|
+
},
|
|
149
|
+
},
|
|
150
|
+
},
|
|
151
|
+
});
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
> Moleculer-essentials doesn't provide the dependencies for the mixins, but only declares them as optional `peerDependencies`.
|
|
155
|
+
> By using a specific namespace for each mixin, you can install only the dependencies you need and use.
|
|
156
|
+
|
|
157
|
+
### Documentation
|
|
158
|
+
|
|
159
|
+
The documentation isn't done yet, but you can check the [source code](./src/) to see what is available.
|
|
160
|
+
|
|
161
|
+
## License
|
|
162
|
+
|
|
163
|
+
[MIT](https://choosealicense.com/licenses/mit/)
|
package/package.json
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
"type": "git",
|
|
7
7
|
"url": "https://github.com/treatwell/moleculer-essentials"
|
|
8
8
|
},
|
|
9
|
-
"version": "1.
|
|
9
|
+
"version": "1.2.0",
|
|
10
10
|
"main": "./dist/index.cjs",
|
|
11
11
|
"module": "./dist/index.mjs",
|
|
12
12
|
"types": "./dist/index.d.cts",
|
|
@@ -109,7 +109,6 @@
|
|
|
109
109
|
"bson": "^6.2.0",
|
|
110
110
|
"date-fns": "^2.21.3",
|
|
111
111
|
"lodash-es": "^4.17.21",
|
|
112
|
-
"moleculer": "^0.14.33",
|
|
113
112
|
"pino": "^9.9.0",
|
|
114
113
|
"pino-pretty": "^13.1.1"
|
|
115
114
|
},
|
|
@@ -119,6 +118,7 @@
|
|
|
119
118
|
"ioredis": "^5.2.3",
|
|
120
119
|
"jsonwebtoken": "^9.0.2",
|
|
121
120
|
"jwks-rsa": "^3.0.1",
|
|
121
|
+
"moleculer": "^0.14.33",
|
|
122
122
|
"mongodb": "^6.15.0",
|
|
123
123
|
"redlock": "^4.2.0",
|
|
124
124
|
"zod": "^3.25.0 || ^4.0.0"
|
|
@@ -148,15 +148,15 @@
|
|
|
148
148
|
},
|
|
149
149
|
"devDependencies": {
|
|
150
150
|
"@aws-crypto/client-node": "^4.2.1",
|
|
151
|
-
"@eslint/js": "^9.
|
|
151
|
+
"@eslint/js": "^9.34.0",
|
|
152
152
|
"@treatwell/eslint-plugin-moleculer": "^1.1.0",
|
|
153
153
|
"@tsconfig/node-lts": "^22.0.2",
|
|
154
154
|
"@types/jsonwebtoken": "^9.0.10",
|
|
155
155
|
"@types/lodash-es": "^4.17.12",
|
|
156
156
|
"@types/node": "^24.3.0",
|
|
157
|
-
"@types/redlock": "^4.0.
|
|
157
|
+
"@types/redlock": "^4.0.7",
|
|
158
158
|
"bullmq": "^5.12.10",
|
|
159
|
-
"eslint": "^9.
|
|
159
|
+
"eslint": "^9.34.0",
|
|
160
160
|
"eslint-config-prettier": "^10.1.8",
|
|
161
161
|
"eslint-import-resolver-typescript": "^4.4.4",
|
|
162
162
|
"eslint-plugin-import": "^2.32.0",
|
|
@@ -165,6 +165,7 @@
|
|
|
165
165
|
"jiti": "^2.5.1",
|
|
166
166
|
"jsonwebtoken": "^9.0.2",
|
|
167
167
|
"jwks-rsa": "^3.0.1",
|
|
168
|
+
"moleculer": "^0.14.33",
|
|
168
169
|
"mongodb": "^6.15.0",
|
|
169
170
|
"mongodb-memory-server": "^10.2.0",
|
|
170
171
|
"pkgroll": "^2.15.3",
|
|
@@ -172,9 +173,9 @@
|
|
|
172
173
|
"redlock": "^4.2.0",
|
|
173
174
|
"semantic-release": "^24.2.7",
|
|
174
175
|
"typescript": "~5.9.2",
|
|
175
|
-
"typescript-eslint": "^8.
|
|
176
|
+
"typescript-eslint": "^8.41.0",
|
|
176
177
|
"vitest": "^3.2.4",
|
|
177
|
-
"zod": "^4.
|
|
178
|
+
"zod": "^4.1.5"
|
|
178
179
|
},
|
|
179
180
|
"files": [
|
|
180
181
|
"dist"
|