@ddd-ts-kit/kafka 0.7.0 → 0.9.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 +3 -3
- package/dist/codec/decode.d.ts +1 -1
- package/dist/codec/decode.d.ts.map +1 -1
- package/dist/codec/decode.js +5 -1
- package/dist/codec/decode.js.map +1 -1
- package/dist/codec/encode.d.ts.map +1 -1
- package/dist/codec/encode.js +2 -1
- package/dist/codec/encode.js.map +1 -1
- package/dist/codec/headers.d.ts +1 -0
- package/dist/codec/headers.d.ts.map +1 -1
- package/dist/codec/headers.js +1 -0
- package/dist/codec/headers.js.map +1 -1
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -206,9 +206,9 @@ An existing topic is never altered: `topics` applies at creation only. With
|
|
|
206
206
|
publication.
|
|
207
207
|
|
|
208
208
|
A record is the envelope as JSON (`id`, `type`, `version`, `occurredAt`, `payload`,
|
|
209
|
-
`traceparent`, `correlationId`), its key is `keyOf(event)`, and its headers are
|
|
210
|
-
`x-event-type`, `x-event-version`, `traceparent
|
|
211
|
-
consume it.
|
|
209
|
+
`traceparent`, `correlationId`, `tenantId`), its key is `keyOf(event)`, and its headers are
|
|
210
|
+
`x-event-id`, `x-event-type`, `x-event-version`, `traceparent`, `x-correlation-id` and
|
|
211
|
+
`x-tenant-id`. Any Kafka client can consume it.
|
|
212
212
|
|
|
213
213
|
Two consumers of one type are two groups and both receive every event. Two instances of one
|
|
214
214
|
consumer are two members of its group: each partition, so each key, goes to one of them.
|
package/dist/codec/decode.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type
|
|
1
|
+
import { type IntegrationEvent } from '@ddd-ts-kit/kernel';
|
|
2
2
|
/** The envelope exactly as published, or `undefined` for a value that is not one (poison). */
|
|
3
3
|
export declare function decode(value: Buffer | null): IntegrationEvent | undefined;
|
|
4
4
|
//# sourceMappingURL=decode.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../src/codec/decode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../src/codec/decode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEvE,8FAA8F;AAC9F,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,gBAAgB,GAAG,SAAS,CAiBzE"}
|
package/dist/codec/decode.js
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { isTenantId } from '@ddd-ts-kit/kernel';
|
|
1
2
|
/** The envelope exactly as published, or `undefined` for a value that is not one (poison). */
|
|
2
3
|
export function decode(value) {
|
|
3
4
|
const body = value === null ? undefined : parsed(value);
|
|
@@ -12,6 +13,7 @@ export function decode(value) {
|
|
|
12
13
|
payload: body.payload,
|
|
13
14
|
...(typeof body.traceparent === 'string' ? { traceparent: body.traceparent } : {}),
|
|
14
15
|
...(typeof body.correlationId === 'string' ? { correlationId: body.correlationId } : {}),
|
|
16
|
+
...(isTenantId(body.tenantId) ? { tenantId: body.tenantId } : {}),
|
|
15
17
|
};
|
|
16
18
|
}
|
|
17
19
|
function parsed(content) {
|
|
@@ -30,7 +32,9 @@ function isEnvelope(body) {
|
|
|
30
32
|
hasText(body, 'type') &&
|
|
31
33
|
hasText(body, 'occurredAt') &&
|
|
32
34
|
'version' in body &&
|
|
33
|
-
typeof body.version === 'number'
|
|
35
|
+
typeof body.version === 'number' &&
|
|
36
|
+
// A tenant outside the grammar could widen what the consumer reaches: the envelope is poison.
|
|
37
|
+
(!('tenantId' in body) || body.tenantId === undefined || isTenantId(body.tenantId)));
|
|
34
38
|
}
|
|
35
39
|
function hasText(body, field) {
|
|
36
40
|
const value = Reflect.get(body, field);
|
package/dist/codec/decode.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"decode.js","sourceRoot":"","sources":["../../src/codec/decode.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"decode.js","sourceRoot":"","sources":["../../src/codec/decode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,oBAAoB,CAAC;AAEvE,8FAA8F;AAC9F,MAAM,UAAU,MAAM,CAAC,KAAoB;IACzC,MAAM,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAExD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,GAAG,CAAC,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,GAAG,CAAC,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC;AACJ,CAAC;AAaD,SAAS,MAAM,CAAC,OAAe;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAa;IAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CACL,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;QACnB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC;QAC3B,SAAS,IAAI,IAAI;QACjB,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;QAChC,8FAA8F;QAC9F,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CACpF,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,KAAa;IAC1C,MAAM,KAAK,GAAY,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAEhD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"encode.d.ts","sourceRoot":"","sources":["../../src/codec/encode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;
|
|
1
|
+
{"version":3,"file":"encode.d.ts","sourceRoot":"","sources":["../../src/codec/encode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAS3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,CAgBhF"}
|
package/dist/codec/encode.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { CORRELATION_HEADER, EVENT_ID_HEADER, EVENT_TYPE_HEADER, EVENT_VERSION_HEADER, TRACEPARENT_HEADER, } from './headers.js';
|
|
1
|
+
import { CORRELATION_HEADER, EVENT_ID_HEADER, EVENT_TYPE_HEADER, EVENT_VERSION_HEADER, TENANT_HEADER, TRACEPARENT_HEADER, } from './headers.js';
|
|
2
2
|
/**
|
|
3
3
|
* The value is the whole envelope as JSON, so any Kafka client can consume it. The headers
|
|
4
4
|
* repeat what a router, a tracer or an operator needs without opening the value.
|
|
@@ -15,6 +15,7 @@ export function encode(event, routing) {
|
|
|
15
15
|
[EVENT_VERSION_HEADER]: String(event.version),
|
|
16
16
|
...(event.traceparent === undefined ? {} : { [TRACEPARENT_HEADER]: event.traceparent }),
|
|
17
17
|
...(event.correlationId === undefined ? {} : { [CORRELATION_HEADER]: event.correlationId }),
|
|
18
|
+
...(event.tenantId === undefined ? {} : { [TENANT_HEADER]: event.tenantId }),
|
|
18
19
|
},
|
|
19
20
|
},
|
|
20
21
|
};
|
package/dist/codec/encode.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"encode.js","sourceRoot":"","sources":["../../src/codec/encode.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAItB;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,KAAuB,EAAE,OAAgB;IAC9D,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;QAClC,OAAO,EAAE;YACP,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI;YACjC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAC5B,OAAO,EAAE;gBACP,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,EAAE;gBAC3B,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,IAAI;gBAC/B,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;gBAC7C,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;gBACvF,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"encode.js","sourceRoot":"","sources":["../../src/codec/encode.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAItB;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,KAAuB,EAAE,OAAgB;IAC9D,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;QAClC,OAAO,EAAE;YACP,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI;YACjC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAC5B,OAAO,EAAE;gBACP,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,EAAE;gBAC3B,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,IAAI;gBAC/B,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;gBAC7C,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;gBACvF,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;gBAC3F,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;aAC7E;SACF;KACF,CAAC;AACJ,CAAC"}
|
package/dist/codec/headers.d.ts
CHANGED
|
@@ -3,6 +3,7 @@ export declare const EVENT_TYPE_HEADER = "x-event-type";
|
|
|
3
3
|
export declare const EVENT_VERSION_HEADER = "x-event-version";
|
|
4
4
|
export declare const TRACEPARENT_HEADER = "traceparent";
|
|
5
5
|
export declare const CORRELATION_HEADER = "x-correlation-id";
|
|
6
|
+
export declare const TENANT_HEADER = "x-tenant-id";
|
|
6
7
|
export declare const ATTEMPT_HEADER = "x-attempt";
|
|
7
8
|
export declare const ERROR_CODE_HEADER = "x-error-code";
|
|
8
9
|
export declare const DEAD_REASON_HEADER = "x-dead-reason";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../src/codec/headers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAChD,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AACrD,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAClD,qEAAqE;AACrE,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,iBAAiB,CAAC"}
|
|
1
|
+
{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../src/codec/headers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAChD,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AACrD,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAC3C,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAClD,qEAAqE;AACrE,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,iBAAiB,CAAC"}
|
package/dist/codec/headers.js
CHANGED
|
@@ -3,6 +3,7 @@ export const EVENT_TYPE_HEADER = 'x-event-type';
|
|
|
3
3
|
export const EVENT_VERSION_HEADER = 'x-event-version';
|
|
4
4
|
export const TRACEPARENT_HEADER = 'traceparent';
|
|
5
5
|
export const CORRELATION_HEADER = 'x-correlation-id';
|
|
6
|
+
export const TENANT_HEADER = 'x-tenant-id';
|
|
6
7
|
export const ATTEMPT_HEADER = 'x-attempt';
|
|
7
8
|
export const ERROR_CODE_HEADER = 'x-error-code';
|
|
8
9
|
export const DEAD_REASON_HEADER = 'x-dead-reason';
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../src/codec/headers.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAChD,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AACtD,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAChD,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAChD,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAClD,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;AACxC,sFAAsF;AACtF,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC"}
|
|
1
|
+
{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../src/codec/headers.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAChD,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AACtD,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAChD,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AACrD,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAChD,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAClD,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;AACxC,sFAAsF;AACtF,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ddd-ts-kit/kafka",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.9.0",
|
|
4
4
|
"description": "Kafka provider for integration events: idempotent keyed publishing for the outbox relay, one consumer group per consumer, offsets committed after handling, bounded retries and a dead-letter topic.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -26,12 +26,12 @@
|
|
|
26
26
|
"dist"
|
|
27
27
|
],
|
|
28
28
|
"dependencies": {
|
|
29
|
-
"@ddd-ts-kit/events": "0.
|
|
30
|
-
"@ddd-ts-kit/kernel": "0.
|
|
29
|
+
"@ddd-ts-kit/events": "0.9.0",
|
|
30
|
+
"@ddd-ts-kit/kernel": "0.9.0"
|
|
31
31
|
},
|
|
32
32
|
"devDependencies": {
|
|
33
33
|
"@confluentinc/kafka-javascript": "^1.11.0",
|
|
34
|
-
"@ddd-ts-kit/testing": "0.
|
|
34
|
+
"@ddd-ts-kit/testing": "0.9.0"
|
|
35
35
|
},
|
|
36
36
|
"peerDependencies": {
|
|
37
37
|
"@confluentinc/kafka-javascript": ">=1.11.0 <2"
|