@mojaloop/bulk-api-adapter 17.1.6

package/docker/wait-for/wait-for-mockserver.sh

@@ -0,0 +1,20 @@
+#!/bin/sh
+# wait-for-mockserver.sh
+
+source /opt/wait-for/wait-for.env
+
+function healthCheck() {  
+  curl -s -X GET "http://$WAIT_FOR_MOCK_HOST:$WAIT_FOR_MOCK_PORT"
+}
+
+function command() {
+  curl -s -X PUT "http://$WAIT_FOR_MOCK_HOST:$WAIT_FOR_MOCK_PORT/expectation" -d '{ "httpRequest": { "method": ".*", "path": "/.*transfers.*" }, "times" : { "remainingTimes" : 0,	"unlimited" : true }, "timeToLive" : { "unlimited" : true }, "httpResponse": { "statusCode": 200, "body": "{}" } }';
+}
+
+until healthCheck; do
+  >&2 echo "mockserver is unavailable - sleeping"
+  sleep 1
+done
+
+>&2 echo "mockserver is up - executing command"
+command

package/docker/wait-for/wait-for-mysql.sh

@@ -0,0 +1,11 @@
+#!/bin/sh
+
+echo "** STARTUP - Checking for DB connection..."
+
+source /opt/wait-for/wait-for.env
+
+apk --no-cache add mysql-client
+
+until result=$(mysql -h $WAIT_FOR_DB_HOST -P $WAIT_FOR_DB_PORT -u $WAIT_FOR_DB_USER --password=$WAIT_FOR_DB_PASSWORD  $WAIT_FOR_DB_DATABASE -ss -N -e 'select 1;') && eval 'echo is_connected=$result' && if [ -z $result ]; then false; fi && if [ $result -ne 1 ]; then false; fi; do echo waiting for MySQL; sleep 2; done;
+
+echo "** STARTUP - DB connection successful!"

package/docker/wait-for/wait-for-objstore.sh

@@ -0,0 +1,7 @@
+#!/bin/sh
+
+echo "** STARTUP - Checking for Object Store connection..."
+
+source /opt/wait-for/wait-for.env
+
+sh /opt/wait-for/wait-for.sh $WAIT_FOR_OBJSTORE_SERVER -t 240 -- echo "** STARTUP - Object Store connection successful!"

package/docker/wait-for/wait-for.env

@@ -0,0 +1,11 @@
+# Environment config for wait-for scripts
+
+WAIT_FOR_DB_HOST=mysql
+WAIT_FOR_DB_PORT=3306
+WAIT_FOR_DB_USER=central_ledger
+WAIT_FOR_DB_PASSWORD=password
+WAIT_FOR_DB_DATABASE=central_ledger
+WAIT_FOR_OBJSTORE_SERVER=objstore:27017
+WAIT_FOR_DB_KAFKA_BROKER=kafka:29092
+WAIT_FOR_MOCK_HOST=mockserver
+WAIT_FOR_MOCK_PORT=1080

package/docker/wait-for/wait-for.sh

@@ -0,0 +1,81 @@
+#!/bin/sh
+
+# Script from https://github.com/eficode/wait-for
+
+TIMEOUT=15
+QUIET=0
+
+echoerr() {
+  if [ "$QUIET" -ne 1 ]; then printf "%s\n" "$*" 1>&2; fi
+}
+
+usage() {
+  exitcode="$1"
+  cat << USAGE >&2
+Usage:
+  $cmdname host:port [-t timeout] [-- command args]
+  -q | --quiet                        Do not output any status messages
+  -t TIMEOUT | --timeout=timeout      Timeout in seconds, zero for no timeout
+  -- COMMAND ARGS                     Execute command with args after the test finishes
+USAGE
+  exit "$exitcode"
+}
+
+wait_for() {
+  for i in `seq $TIMEOUT` ; do
+    nc -z "$HOST" "$PORT" > /dev/null 2>&1
+    
+    result=$?
+    if [ $result -eq 0 ] ; then
+      if [ $# -gt 0 ] ; then
+        exec "$@"
+      fi
+      exit 0
+    fi
+    sleep 1
+  done
+  echo "Operation timed out" >&2
+  exit 1
+}
+
+while [ $# -gt 0 ]
+do
+  case "$1" in
+    *:* )
+    HOST=$(printf "%s\n" "$1"| cut -d : -f 1)
+    PORT=$(printf "%s\n" "$1"| cut -d : -f 2)
+    shift 1
+    ;;
+    -q | --quiet)
+    QUIET=1
+    shift 1
+    ;;
+    -t)
+    TIMEOUT="$2"
+    if [ "$TIMEOUT" = "" ]; then break; fi
+    shift 2
+    ;;
+    --timeout=*)
+    TIMEOUT="${1#*=}"
+    shift 1
+    ;;
+    --)
+    shift
+    break
+    ;;
+    --help)
+    usage 0
+    ;;
+    *)
+    echoerr "Unknown argument: $1"
+    usage 1
+    ;;
+  esac
+done
+
+if [ "$HOST" = "" -o "$PORT" = "" ]; then
+  echoerr "Error: you need to provide a host and port to test."
+  usage 2
+fi
+
+wait_for "$@"

package/docker-compose.yml

@@ -0,0 +1,167 @@
+networks:
+  ba-mojaloop-net:
+    name: ba-mojaloop-net
+
+services:
+  bulk-api-adapter:
+    build:
+      context: .
+      cache_from:
+        - mojaloop/bulk-api-adapter
+        - bulk-api-adapter
+    container_name: ba_bulk-api-adapter
+    user: root
+    command:
+      - "sh"
+      - "-c"
+      - "sh /opt/wait-for/wait-for-bulk-api-adapter.sh && node src/api/index.js"
+    ports:
+      - "3003:3003"
+    environment:
+      - LOG_LEVEL=info
+      - CSL_LOG_TRANSPORT=file
+    volumes:
+       - ./docker/bulk-api-adapter/default.json:/opt/app/config/default.json
+       - ./docker/wait-for:/opt/wait-for
+    networks:
+      - ba-mojaloop-net
+    depends_on:
+      - central-ledger
+      - kafka
+      - objstore
+    healthcheck:
+      test: ["CMD", "sh", "-c" ,"apk --no-cache add curl", ";", "curl", "http://localhost:3003/health"]
+      timeout: 20s
+      retries: 10
+      interval: 30s
+
+  objstore:
+    image: mongo:8.0
+    container_name: ba_objstore
+    logging:
+      driver: none
+    ports:
+      - "27017:27017"
+    networks:
+      - ba-mojaloop-net
+    healthcheck:
+      test: mongo localhost:27017/test --quiet 1
+      interval: 10s
+      timeout: 10s
+      retries: 5
+      start_period: 40s
+
+  central-ledger:
+    image: mojaloop/central-ledger:v18.0.1
+    container_name: ba_central-ledger
+    user: root
+    command:
+      - "sh"
+      - "-c"
+      - "sh /opt/wait-for/wait-for-central-ledger.sh && node src/api/index.js"
+    links:
+      - mysql
+      - kafka
+    ports:
+      - "3001:3001"
+    volumes:
+       - ./docker/central-ledger/default.json:/opt/app/config/default.json
+       - ./docker/wait-for:/opt/wait-for
+    depends_on:
+      - mysql
+      - kafka
+    environment:
+      - CLEDG_DATABASE_URI=mysql://central_ledger:password@mysql:3306/central_ledger
+      - CLEDG_SIDECAR__DISABLED=true
+    networks:
+      - ba-mojaloop-net
+    healthcheck:
+      test: ["CMD", "bash", "-c" ,"apk --no-cache add curl", ";", "curl", "http://localhost:3001/health"]
+      timeout: 20s
+      retries: 10
+      interval: 30s
+
+  mysql:
+    image: mysql/mysql-server:8.0
+    container_name: ba_mysql
+    logging:
+      driver: none
+    ports:
+      - "3306:3306"
+    volumes:
+      # this fixes the permissions issue, but docker-compose up will fail on first attempt
+      - ./docker/sql-init/:/docker-entrypoint-initdb.d/
+    environment:
+      - MYSQL_USER=${DBUSER:-central_ledger}
+      - MYSQL_PASSWORD=${DBPASS:-password}
+      - MYSQL_DATABASE=${DBUSER:-central_ledger}
+      - MYSQL_ALLOW_EMPTY_PASSWORD=true
+    networks:
+      - ba-mojaloop-net
+    healthcheck:
+      test: ["CMD", "mysqladmin" ,"ping", "-h", "mysql"]
+      timeout: 20s
+      retries: 10
+      start_period: 40s
+      interval: 30s
+
+  kafka:
+    image: docker.io/bitnami/kafka:3.9
+    container_name: cs_kafka
+    networks:
+      - ba-mojaloop-net
+    ports:
+      - "9092:9092"
+    environment:
+      # BITNAMI_DEBUG: "yes"
+      ALLOW_PLAINTEXT_LISTENER: "yes"
+      KAFKA_ADVERTISED_HOST_NAME: kafka
+      KAFKA_CFG_LISTENERS: CONTROLLER://:9093,LISTENER_DOCKER://:29092,LISTENER_EXTERN://:9092
+      KAFKA_CFG_ADVERTISED_LISTENERS: LISTENER_DOCKER://kafka:29092,LISTENER_EXTERN://localhost:9092
+      KAFKA_CFG_LISTENER_SECURITY_PROTOCOL_MAP: CONTROLLER:PLAINTEXT,LISTENER_DOCKER:PLAINTEXT,LISTENER_EXTERN:PLAINTEXT
+      KAFKA_CFG_INTER_BROKER_LISTENER_NAME: LISTENER_DOCKER
+      KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1
+      KAFKA_CFG_MESSAGE_MAX_BYTES: 200000000
+      KAFKA_CFG_NODE_ID: 1
+      KAFKA_CFG_PROCESS_ROLES: broker,controller
+      KAFKA_CFG_CONTROLLER_LISTENER_NAMES: CONTROLLER
+      KAFKA_CFG_CONTROLLER_QUORUM_VOTERS: 1@127.0.0.1:9093
+      KAFKA_AUTO_CREATE_TOPICS_ENABLE: "true"
+      KAFKA_ENABLE_KRAFT: "true"
+    healthcheck:
+      test: ["CMD" ,"/opt/bitnami/kafka/bin/kafka-broker-api-versions.sh","--bootstrap-server","kafka:29092"]
+      timeout: 20s
+      retries: 10
+      start_period: 40s
+      interval: 30s
+
+  kafka-provisioning:
+    container_name: cs_kafka-provisioning
+    networks:
+      - ba-mojaloop-net
+    image: docker.io/bitnami/kafka:3.9
+    depends_on:
+      - kafka
+    volumes:
+      - ./docker/kafka/scripts:/tmp/kafka/scripts
+    command: bash /tmp/kafka/scripts/provision.sh
+
+  simulator:
+    image: mojaloop/simulator:v12.2.1
+    container_name: ba_simulator
+    ports:
+      - "8444:8444"
+    environment:
+      - LOG_LEVEL=info
+      - TRANSFERS_ENDPOINT=http://host.docker.internal:3000
+      - QUOTES_ENDPOINT=http://host.docker.internal:3002
+      - PARTIES_ENDPOINT=http://host.docker.internal:4002
+      - TRANSFERS_FULFIL_RESPONSE_DISABLED=false
+    networks:
+      - ba-mojaloop-net
+    healthcheck:
+      test: ["CMD", "sh", "-c" ,"apk --no-cache add curl", ";", "curl", "http://localhost:8444/health"]
+      timeout: 20s
+      retries: 10
+      interval: 30s
+

package/jsdoc.json

@@ -0,0 +1,38 @@
+{
+  "tags": {
+    "allowUnknownTags": true
+  },
+  "source": {
+    "include": [
+      "src"
+    ],
+    "includePattern": ".js$",
+    "excludePattern": "(node_modules/|docs)"
+  },
+  "plugins": [
+    "plugins/markdown"
+  ],
+  "opts": {
+    "template": "node_modules/docdash",
+    "encoding": "utf8",
+    "destination": "docs/",
+    "recurse": true,
+    "verbose": true
+  },
+  "markdown": {
+    "parser": "gfm",
+    "hardwrap": true
+  },
+  "templates": {
+    "cleverLinks": false,
+    "monospaceLinks": false,
+    "default": {
+      "outputSourceFiles": true,
+      "includeDate": false
+    }
+  },
+  "docdash": {
+    "static": false,
+    "sort": true
+  }
+}

package/package.json

@@ -0,0 +1,152 @@
+{
+  "name": "@mojaloop/bulk-api-adapter",
+  "version": "17.1.6",
+  "description": "Mojaloop Bulk API Adapter",
+  "license": "Apache-2.0",
+  "author": "ModusBox",
+  "contributors": [
+    "Georgi Georgiev <georgi.georgiev@modusbox.com>",
+    "Miguel de Barros <miguel.debarros@modusbox.com>",
+    "Sam Kummary <sam@mojaloop.io",
+    "Steven Oderayi <steven.oderayi@modusbox.com>",
+    "Valentin Genev <valentin.genev@modusbox.com>"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/mojaloop/bulk-api-adapter.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "engines": {
+    "node": ">=18.x"
+  },
+  "imports": {
+    "#src/*": "./src/*.js",
+    "#test/*": "./test/*.js"
+  },
+  "main": "./src/api/index.js",
+  "pre-commit": [
+    "lint",
+    "dep:check",
+    "test"
+  ],
+  "scripts": {
+    "start": "npm run start:api",
+    "start:api": "node src/api/index.js",
+    "watch:api": "npx nodemon src/api/index.js",
+    "regenerate": "yo swaggerize:test --framework hapi --apiPath './src/interface/swagger.yaml'",
+    "standard": "npx standard",
+    "standard:fix": "npx standard --fix",
+    "lint": "npm run standard",
+    "lint:fix": "npm run standard:fix",
+    "test": "npm run test:unit",
+    "test:all": "npm run test",
+    "test:unit": "tape 'test/unit/**/*.test.js' | tap-spec",
+    "test:xunit": "tape 'test/unit/**/*.test.js' | tap-xunit",
+    "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:functional": "echo 'No functional tests defined'",
+    "test:integration": "echo 'No integration tests defined'",
+    "docker:build": "docker build --build-arg NODE_VERSION=\"$(cat .nvmrc)-alpine\" -t mojaloop/bulk-api-adapter:local .",
+    "docker:up": "docker-compose -f docker-compose.yml up -d",
+    "docker:stop": "docker-compose -f docker-compose.yml stop",
+    "docker:rm": "docker-compose -f docker-compose.yml rm -f -v",
+    "docker:down": "docker-compose -f docker-compose.yml down -v",
+    "docker:clean": "docker-compose -f docker-compose.yml down --rmi local",
+    "audit:fix": "npm audit fix",
+    "audit:check": "npx audit-ci --config ./audit-ci.jsonc",
+    "dep:check": "npx ncu -e 2",
+    "dep:update": "npx ncu -u",
+    "release": "npx standard-version --releaseCommitMessageFormat 'chore(release): {{currentTag}} [skip ci]'",
+    "snapshot": "npx standard-version --no-verify --skip.changelog --prerelease snapshot --releaseCommitMessageFormat 'chore(snapshot): {{currentTag}}'"
+  },
+  "dependencies": {
+    "@hapi/basic": "7.0.2",
+    "@hapi/boom": "10.0.1",
+    "@hapi/catbox": "12.1.1",
+    "@hapi/catbox-memory": "6.0.2",
+    "@hapi/good": "9.0.1",
+    "@hapi/hapi": "21.3.12",
+    "@hapi/inert": "7.1.0",
+    "@hapi/vision": "7.0.3",
+    "@mojaloop/central-services-error-handling": "13.0.6",
+    "@mojaloop/central-services-health": "15.0.2",
+    "@mojaloop/central-services-logger": "11.5.5",
+    "@mojaloop/central-services-metrics": "12.4.5",
+    "@mojaloop/central-services-shared": "18.15.1",
+    "@mojaloop/central-services-stream": "11.4.3",
+    "@mojaloop/sdk-standard-components": "19.6.4",
+    "@mojaloop/event-sdk": "14.1.3",
+    "@mojaloop/object-store-lib": "12.0.5",
+    "@now-ims/hapi-now-auth": "2.1.0",
+    "axios": "1.7.9",
+    "blipp": "4.0.2",
+    "commander": "13.1.0",
+    "hapi-auth-bearer-token": "8.0.0",
+    "hapi-openapi": "3.0.0",
+    "hapi-swagger": "17.3.2",
+    "immutable": "5.0.3",
+    "joi": "^17.13.3",
+    "mongo-uri-builder": "^4.0.0",
+    "mustache": "4.2.0",
+    "parse-strings-in-object": "2.0.0",
+    "rc": "1.2.8",
+    "uuid4": "2.0.3"
+  },
+  "overrides": {
+    "ansi-regex": "5.0.1",
+    "postcss": {
+      "nanoid": "^3.3.8"
+    },
+    "swagmock": {
+      "validator": "13.12.0"
+    },
+    "shins": {
+      "ajv": "6.12.3",
+      "ejs": "3.1.10",
+      "path-to-regexp": "0.1.12",
+      "sanitize-html": "2.12.1",
+      "markdown-it": "12.3.2",
+      "undici": "6.21.1"
+    },
+    "widdershins": {
+      "swagger2openapi": "7.0.8",
+      "markdown-it": "12.3.2"
+    },
+    "request": {
+      "tough-cookie": "4.1.3"
+    },
+    "jsonwebtoken": "9.0.0",
+    "jsonpointer": "5.0.0",
+    "cross-spawn": "7.0.6",
+    "trim": "0.0.3",
+    "yargs-parser": "21.1.1"
+  },
+  "devDependencies": {
+    "audit-ci": "^7.1.0",
+    "nyc": "17.1.0",
+    "nodemon": "3.1.9",
+    "npm-check-updates": "17.1.14",
+    "pre-commit": "1.2.2",
+    "proxyquire": "2.1.3",
+    "replace": "^1.2.2",
+    "rewire": "7.0.0",
+    "sinon": "19.0.2",
+    "standard": "17.1.2",
+    "standard-version": "^9.5.0",
+    "swagmock": "1.0.0",
+    "tap-spec": "^5.0.0",
+    "tap-xunit": "2.4.1",
+    "tape": "5.9.0",
+    "tapes": "4.1.0"
+  },
+  "generator-swaggerize": {
+    "version": "4.1.0"
+  },
+  "standard-version": {
+    "scripts": {
+      "postchangelog": "replace '\\[mojaloop/#(\\d+)\\]\\(https://github.com/mojaloop/(.*)/issues/(\\d+)\\)' '[mojaloop/#$1](https://github.com/mojaloop/project/issues/$1)' CHANGELOG.md"
+    }
+  }
+}

package/sonar-project.properties

@@ -0,0 +1,17 @@
+# Required metadata
+sonar.projectKey=bulk-api-adapter
+sonar.projectName=bulk-api-adapter
+sonar.projectVersion=1.0
+
+# Comma-separated paths to directories with sources (required)
+sonar.sources=src,test
+
+# Language
+sonar.language=js
+
+# Encoding of the source files
+sonar.sourceEncoding=UTF-8
+sonar.exclusions=migrations
+
+# To import the LCOV report
+sonar.javascript.lcov.reportPath=lcov.info

package/src/api/handlers/bulkTransfers/{id}/error.js

@@ -0,0 +1,71 @@
+/*****
+ License
+ --------------
+ Copyright © 2020-2025 Mojaloop Foundation
+ The Mojaloop files are made available by the Mojaloop Foundation under the Apache License, Version 2.0 (the "License") and you may not use these files except in compliance with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, the Mojaloop files are distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+
+ Contributors
+ --------------
+ This is the official list of the Mojaloop project contributors for this file.
+ Names of the original copyright holders (individuals or organizations)
+ should be listed with a '*' in the first column. People who have
+ contributed from an organization can be listed under the organization
+ that actually holds the copyright for their contributions (see the
+ Mojaloop Foundation organization for an example). Those individuals should have
+ their names indented and be marked with a '-'. Email address can be added
+ optionally within square brackets <email>.
+
+ * Mojaloop Foundation
+ - Name Surname <name.surname@mojaloop.io>
+
+ * ModusBox
+ - Steven Oderayi <steven.oderayi@modusbox.com>
+ --------------
+ ******/
+
+'use strict'
+
+const TransferService = require('../../../../domain/bulkTransfer')
+const Logger = require('@mojaloop/central-services-logger')
+const ErrorHandler = require('@mojaloop/central-services-error-handling')
+const Hash = require('@mojaloop/central-services-shared').Util.Hash
+const Uuid = require('uuid4')
+const HTTPENUM = require('@mojaloop/central-services-shared').Enum.Http
+const BulkTransferModels = require('@mojaloop/object-store-lib').Models.BulkTransfer
+
+/**
+ * Operations on /bulkTransfers/{id}/error
+ */
+module.exports = {
+  /**
+     * summary: Handles bulk transfer error callback
+     * description: If the server is unable to find or create a bulk transfer, or another processing error occurs, the error callback PUT /bulkTransfers/<ID>/error is used. The <ID> in the URI should contain the bulkTransferId that was used for the creation request of the bulk transfer (POST /bulkTransfers), or the <ID> that was used in the GET /bulkTransfers/<ID>.
+     * parameters: id, body, Content-Length, Content-Type, Date, X-Forwarded-For, FSPIOP-Source, FSPIOP-Destination, FSPIOP-Encryption, FSPIOP-Signature, FSPIOP-URI, FSPIOP-HTTP-Method
+     * produces: application/json
+     * responses: default
+     */
+  put: async function putBulkTransferErrorById (request, h) {
+    try {
+      Logger.debug('error::payload(%s)', JSON.stringify(request.payload))
+
+      const bulkTransferId = request.params.id
+      const { errorInformation, extensionList } = request.payload
+      const hash = Hash.generateSha256(JSON.stringify(request.payload))
+      const messageId = Uuid()
+      const message = { bulkTransferId, errorInformation, extensionList, hash }
+
+      const IndividualTransferFulfilModel = BulkTransferModels.getIndividualTransferFulfilModel()
+      await new IndividualTransferFulfilModel({ messageId, bulkTransferId, payload: request.payload }).save()
+      await TransferService.bulkTransferError(messageId, request.headers, message)
+
+      return h.response().code(HTTPENUM.ReturnCodes.OK.CODE)
+    } catch (err) {
+      Logger.error(err)
+      throw ErrorHandler.Factory.reformatFSPIOPError(err)
+    }
+  }
+}

package/src/api/handlers/bulkTransfers/{id}.js

@@ -0,0 +1,98 @@
+/*****
+ License
+ --------------
+ Copyright © 2020-2025 Mojaloop Foundation
+ The Mojaloop files are made available by the Mojaloop Foundation under the Apache License, Version 2.0 (the "License") and you may not use these files except in compliance with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, the Mojaloop files are distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+
+ Contributors
+ --------------
+ This is the official list of the Mojaloop project contributors for this file.
+ Names of the original copyright holders (individuals or organizations)
+ should be listed with a '*' in the first column. People who have
+ contributed from an organization can be listed under the organization
+ that actually holds the copyright for their contributions (see the
+ Mojaloop Foundation organization for an example). Those individuals should have
+ their names indented and be marked with a '-'. Email address can be added
+ optionally within square brackets <email>.
+
+ * Mojaloop Foundation
+ - Name Surname <name.surname@mojaloop.io>
+
+ * ModusBox
+ - Georgi Georgiev <georgi.georgiev@modusbox.com>
+ - Valentin Genev <valentin.genev@modusbox.com>
+ - Steven Oderayi <steven.oderayi@modusbox.com>
+ --------------
+ ******/
+'use strict'
+
+const Uuid = require('uuid4')
+const Logger = require('@mojaloop/central-services-logger')
+const ErrorHandler = require('@mojaloop/central-services-error-handling')
+const BulkTransferModels = require('@mojaloop/object-store-lib').Models.BulkTransfer
+const Hash = require('@mojaloop/central-services-shared').Util.Hash
+const HTTPENUM = require('@mojaloop/central-services-shared').Enum.Http
+const TransferService = require('../../../domain/bulkTransfer')
+
+/**
+ * Operations on /bulkTransfers/{id}
+ */
+module.exports = {
+  /**
+   * summary: Get a bulk transfer by Id
+   * description:
+   * parameters: accept, content-type, date, x-forwarded-for, fspiop-source, fspiop-destination, fspiop-encryption, fspiop-signature, fspiop-uri, fspiop-http-method, id
+   * produces:
+   * responses: default
+   */
+  get: async function getBulkTransfersId (request, h) {
+    try {
+      Logger.isInfoEnabled && Logger.info(`getBulkTransfersId::id(${request.params.id})`)
+      const messageId = Uuid()
+      await TransferService.getBulkTransferById(messageId, request.headers, request.params)
+      return h.response().code(HTTPENUM.ReturnCodes.ACCEPTED.CODE)
+    } catch (err) {
+      Logger.error(err)
+      throw ErrorHandler.Factory.reformatFSPIOPError(err)
+    }
+  },
+  /**
+   * summary: Fulfil bulkTransfer
+   * description:
+   * parameters: content-type, date, x-forwarded-for, fspiop-source, fspiop-destination, fspiop-encryption, fspiop-signature, fspiop-uri, fspiop-http-method, id, body
+   * produces:
+   * responses: default
+   */
+  put: async function BulkTransfersByIDPut (request, h) {
+    try {
+      Logger.debug('create::payload(%s)', JSON.stringify(request.payload))
+      const bulkTransferId = request.params.id
+      const { bulkTransferState, completedTimestamp, extensionList } = request.payload
+      const hash = Hash.generateSha256(JSON.stringify(request.payload))
+      const messageId = Uuid()
+      /**
+       * Disabled writing to ML Object Store (bulkTransferFulfils) as it is not used:
+       */
+      // const BulkTransferFulfilModel = BulkTransferModels.getBulkTransferFulfilModel()
+      // const doc = Object.assign({}, { messageId, headers: request.headers, bulkTransferId }, request.payload)
+      // await new BulkTransferFulfilModel(doc).save()
+
+      const IndividualTransferFulfilModel = BulkTransferModels.getIndividualTransferFulfilModel()
+      await Promise.all(request.payload.individualTransferResults.map(payload => {
+        new IndividualTransferFulfilModel({ messageId, bulkTransferId, payload }).save()
+        return null
+      }))
+      const count = request.payload.individualTransferResults.length
+      const message = { bulkTransferId, bulkTransferState, completedTimestamp, extensionList, count, hash }
+      await TransferService.bulkFulfil(messageId, request.headers, message)
+      return h.response().code(HTTPENUM.ReturnCodes.OK.CODE)
+    } catch (err) {
+      Logger.error(err)
+      throw ErrorHandler.Factory.reformatFSPIOPError(err)
+    }
+  }
+}