@mojaloop/central-ledger 17.1.2 → 17.2.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [17.2.0](https://github.com/mojaloop/central-ledger/compare/v17.1.2...v17.2.0) (2023-09-07)
+
+
+### Features
+
+* **mojaloop/#3519:** add topic name override config map logic ([#969](https://github.com/mojaloop/central-ledger/issues/969)) ([b99d091](https://github.com/mojaloop/central-ledger/commit/b99d09129f328aab60e4059035be4d263ecd9f98)), closes [mojaloop/#3519](https://github.com/mojaloop/project/issues/3519)
+
 ### [17.1.2](https://github.com/mojaloop/central-ledger/compare/v17.1.1...v17.1.2) (2023-09-06)
 
 

package/README.md

@@ -88,6 +88,26 @@ The Central Ledger has many options that can be configured through environment v
 | CLEDG\_AMOUNT__PRECISION | Numeric value used to determine precision recorded for transfer amounts on this ledger. | 10 |
 | CLEDG\_AMOUNT__SCALE | Numeric value used to determine scale recorded for transfer amounts on this ledger. | 2 |
 
+### Kafka Position Event Type Action Topic Map
+
+In some cases, you might want to publish position type messages onto a customized topic name that
+diverges from the defaults.
+
+You can configure the customized topic names in the config. Each position action key
+refers to position messages with associated actions.
+
+NOTE: Only POSITION.PREPARE is supported at this time, with additional event-type-actions being added later when required.
+
+```
+  "KAFKA": {
+    "EVENT_TYPE_ACTION_TOPIC_MAP" : {
+      "POSITION":{
+        "PREPARE": "topic-transfer-position-batch"
+      }
+    }
+  }
+```
+
 ## API
 
 For endpoint documentation, see the [API documentation](API.md).
@@ -165,6 +185,11 @@ If you want to run integration tests in a repetitive manner, you can startup the
     npm run test:int
   ```
 
+If you want to run override position topic tests you can repeat the above and use `npm run test:int-override` after configuring settings found [here](#kafka-position-event-type-action-topic-map)
+
+If you want to just run all of the integration suite non-interactively then use npm run `test:integration`.
+It will handle docker start up, migration, service starting and testing. Be sure to exit any previously ran handlers or docker commands.
+
 ### Running Functional Tests
 
 If you want to run functional tests locally utilizing the [ml-core-test-harness](https://github.com/mojaloop/ml-core-test-harness), you can run the following commands:
@@ -221,7 +246,7 @@ Configuration modifiers:
   ```bash
   sh ./test/util/scripts/populateTestData.sh
   ```
-  
+
   View Logs for Mockserver (i.e. Payee Receiver) and ML-API-Adapter:
 
   ```bash

package/config/default.json

@@ -85,6 +85,11 @@
   },
   "API_DOC_ENDPOINTS_ENABLED": true,
   "KAFKA": {
+    "EVENT_TYPE_ACTION_TOPIC_MAP" : {
+      "POSITION":{
+        "PREPARE": null
+      }
+    },
     "TOPIC_TEMPLATES": {
       "PARTICIPANT_TOPIC_TEMPLATE": {
         "TEMPLATE": "topic-{{participantName}}-{{functionality}}-{{action}}",

package/docker/kafka/scripts/provision.sh

@@ -25,7 +25,8 @@ topics=(
   "topic-bulk-prepare"
   "topic-bulk-fulfil"
   "topic-bulk-processing"
-  "topic-bulk-get"
+  "topic-bulk-get",
+  "topic-transfer-position-batch"
 )
 
 # Loop through the topics and create them using kafka-topics.sh

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mojaloop/central-ledger",
-  "version": "17.1.2",
+  "version": "17.2.0",
   "description": "Central ledger hosted by a scheme to record and settle transfers",
   "license": "Apache-2.0",
   "author": "ModusBox",
@@ -47,9 +47,12 @@
     "test:xunit": "npm run test:unit | tap-xunit > ./test/results/xunit.xml",
     "test:coverage": "npx nyc --reporter=lcov --reporter=text-summary tapes -- 'test/unit/**/**.test.js'",
     "test:coverage-check": "npm run test:coverage && nyc check-coverage",
-    "test:int": "npx tape 'test/integration/**/*.test.js'",
-    "test:int:spec": "npm run test:int | tap-spec",
+    "test:int": "npx tape 'test/integration/**/*.test.js' ",
+    "test:int-override": "npx tape 'test/integration-override/**/*.test.js'",
+    "test:int:spec": "npm run test:int | npx tap-spec",
     "test:xint": "npm run test:int | tap-xunit > ./test/results/xunit-integration.xml",
+    "test:xint-override": "npm run test:int-override | tap-xunit > ./test/results/xunit-integration-override.xml",
+    "test:integration": "sh ./test/scripts/test-integration.sh",
     "test:functional": "sh ./test/scripts/test-functional.sh",
     "migrate": "npm run migrate:latest && npm run seed:run",
     "migrate:latest": "npx knex $npm_package_config_knex migrate:latest",
@@ -87,7 +90,7 @@
     "@mojaloop/central-services-health": "14.0.2",
     "@mojaloop/central-services-logger": "11.2.2",
     "@mojaloop/central-services-metrics": "12.0.8",
-    "@mojaloop/central-services-shared": "18.0.0",
+    "@mojaloop/central-services-shared": "18.1.0",
     "@mojaloop/central-services-stream": "11.1.1",
     "@mojaloop/event-sdk": "12.0.2",
     "@mojaloop/ml-number": "11.2.3",
@@ -126,7 +129,7 @@
     "jsdoc": "4.0.2",
     "jsonpath": "1.1.1",
     "nodemon": "3.0.1",
-    "npm-check-updates": "16.13.2",
+    "npm-check-updates": "16.13.3",
     "nyc": "15.1.0",
     "pre-commit": "1.2.2",
     "proxyquire": "2.1.3",
@@ -136,7 +139,7 @@
     "standard-version": "^9.5.0",
     "tap-spec": "^5.0.0",
     "tap-xunit": "2.4.1",
-    "tape": "4.13.2",
+    "tape": "4.16.2",
     "tapes": "4.1.0"
   },
   "config": {

package/src/handlers/transfers/handler.js

@@ -200,7 +200,7 @@ const prepare = async (error, messages) => {
         const eventDetail = { functionality, action }
         // Key position prepare message with payer account id
         const payerAccount = await Participant.getAccountByNameAndCurrency(payload.payerFsp, payload.amount.currency, Enum.Accounts.LedgerAccountType.POSITION)
-        await Kafka.proceed(Config.KAFKA_CONFIG, params, { consumerCommit, eventDetail, messageKey: payerAccount.participantCurrencyId.toString() })
+        await Kafka.proceed(Config.KAFKA_CONFIG, params, { consumerCommit, eventDetail, messageKey: payerAccount.participantCurrencyId.toString(), topicNameOverride: Config.KAFKA_CONFIG.EVENT_TYPE_ACTION_TOPIC_MAP?.POSITION?.PREPARE })
         histTimerEnd({ success: true, fspId: Config.INSTRUMENTATION_METRICS_LABELS.fspId })
         return true
       } else {