account-lookup-service 15.5.0-iso.0

package/test/fixtures/index.js

@@ -0,0 +1,131 @@
+const { randomUUID } = require('node:crypto')
+const { Enum } = require('@mojaloop/central-services-shared')
+const isoFixtures = require('./iso')
+
+const { Headers } = Enum.Http
+
+const headersDto = ({
+  source = 'fromDfsp',
+  destination = 'toDfsp',
+  proxy = '',
+  date = '2024-05-24 08:52:19',
+  accept
+} = {}) => Object.freeze({
+  [Headers.FSPIOP.SOURCE]: source,
+  ...(destination && { [Headers.FSPIOP.DESTINATION]: destination }),
+  ...(proxy && { [Headers.FSPIOP.PROXY]: proxy }),
+  date,
+  accept,
+  'content-type': accept
+})
+
+const protocolVersionsDto = () => ({
+  CONTENT: {
+    DEFAULT: '2.1',
+    VALIDATELIST: ['2.1']
+  },
+  ACCEPT: {
+    DEFAULT: '2',
+    VALIDATELIST: ['2', '2.1']
+  }
+})
+
+const partiesCallHeadersDto = ({
+  source,
+  destination,
+  proxy,
+  date
+} = {}) => headersDto({
+  source,
+  destination,
+  proxy,
+  date,
+  accept: 'application/vnd.interoperability.parties+json;version=1.1'
+})
+
+const participantsCallHeadersDto = ({
+  source,
+  destination,
+  proxy,
+  date
+} = {}) => headersDto({
+  source,
+  destination,
+  proxy,
+  date,
+  accept: 'application/vnd.interoperability.participants+json;version=1'
+})
+
+const oracleRequestResponseDto = ({
+  partyList = [{ fspId: 'dfspFromOracle' }]
+} = {}) => ({
+  data: {
+    partyList
+  }
+})
+
+const putPartiesSuccessResponseDto = ({
+  partyIdType = 'MSISDN',
+  partyId = `test-party-${randomUUID()}`,
+  fspId = `fspId-${randomUUID()}`,
+  partySubIdOrType = ''
+} = {}) => ({
+  party: {
+    partyIdInfo: {
+      partyIdType,
+      partyIdentifier: partyId,
+      ...(partySubIdOrType && { partySubIdOrType }),
+      ...(fspId && { fspId })
+    },
+    merchantClassificationCode: '32',
+    name: `testPartyName-${partyId}`
+    // personalInfo: { ... }
+  }
+})
+
+const errorCallbackResponseDto = ({
+  errorCode = '1234',
+  errorDescription = 'Error description',
+  extension = [{
+    key: 'k1', value: 'v1'
+  }]
+} = {}) => ({
+  errorInformation: {
+    errorCode,
+    errorDescription,
+    ...(extension && {
+      extensionList: { extension }
+    })
+  }
+})
+
+const mockAlsRequestDto = (sourceId, type, partyId) => ({
+  sourceId,
+  type,
+  partyId
+})
+
+const mockHapiRequestDto = ({ // https://hapi.dev/api/?v=21.3.3#request-properties
+  method = 'GET',
+  traceid = randomUUID(),
+  id = randomUUID()
+} = {}) => ({
+  method,
+  headers: { traceid },
+  info: {
+    id,
+    received: 123456789
+  }
+})
+
+module.exports = {
+  ...isoFixtures,
+  partiesCallHeadersDto,
+  participantsCallHeadersDto,
+  oracleRequestResponseDto,
+  putPartiesSuccessResponseDto,
+  errorCallbackResponseDto,
+  mockAlsRequestDto,
+  protocolVersionsDto,
+  mockHapiRequestDto
+}

package/test/fixtures/iso.js

@@ -0,0 +1,110 @@
+const idDto = ({
+  id = '1234'
+} = {}) => Object.freeze({
+  OrgId: {
+    AnyBIC: 'J5BMVH7D',
+    Othr: {
+      Id: id
+    }
+  }
+})
+
+const acctDto = () => Object.freeze({
+  Id: {
+    ...idDto(),
+    IBAN: 'PT123' // add to idDto?
+  },
+  SchmeNm: {
+    Cd: 'BIC',
+    Prtry: '123'
+  },
+  Issr: 'BIC'
+})
+
+const agtDto = () => Object.freeze({
+  FinInstnId: {
+    BICFI: 'J5BMVH7D'
+  },
+  BrnchId: {
+    Id: '123'
+  }
+})
+
+const ctctDtlsDto = ({ Nm = 'Contact Name' } = {}) => Object.freeze({
+  Nm,
+  PhneNb: '+123-123-321',
+  MobNb: '+123-123-321',
+  FaxNb: '+123-123-321',
+  EmailAdr: 'assignor@example.com'
+})
+
+const pstlAdrDto = () => Object.freeze({
+  AdrTp: {
+    Cd: 'ADDR'
+  },
+  Dept: 'Dept',
+  SubDept: 'SubDept',
+  StrtNm: 'StrtNm',
+  BldgNb: 'BldgNb',
+  BldgNm: 'BldgNm',
+  Flr: 'Flr',
+  PstBx: 'PstBx',
+  Room: 'Room',
+  PstCd: 'PstCd',
+  TwnNm: 'TwnNm',
+  TwnLctnNm: 'TwnLctnNm',
+  DstrctNm: 'DstrctNm',
+  CtrySubDvsn: 'CtrySubDvsn',
+  Ctry: 'BE',
+  AdrLine: 'AdrLine'
+})
+
+const party40ChoiceDto = ({
+  Id = idDto(),
+  Nm = 'Party Name'
+} = {}) => Object.freeze({
+  Pty: {
+    Id,
+    Nm,
+    PstlAdr: pstlAdrDto(),
+    CtryOfRes: 'BE',
+    CtctDtls: ctctDtlsDto({ Nm })
+  }
+})
+
+const assgnmtDto = () => ({
+  MsgId: '123',
+  CreDtTm: '2020-01-01T00:00:00Z',
+  Assgnr: party40ChoiceDto(),
+  Assgne: party40ChoiceDto()
+})
+
+const rptDto = () => Object.freeze({
+  OrgnlId: '1234567890123456',
+  Vrfctn: true,
+  OrgnlPtyAndAcctId: {
+    ...party40ChoiceDto(),
+    Acct: acctDto(),
+    Agt: agtDto()
+  },
+  UpdtdPtyAndAcctId: {
+    ...party40ChoiceDto(),
+    Acct: acctDto(),
+    Agt: agtDto()
+  }
+})
+
+const isoPartiesPutPayloadDto = () => Object.freeze({
+  Assgnmt: assgnmtDto(),
+  Rpt: rptDto()
+})
+
+module.exports = {
+  isoPartiesPutPayloadDto,
+  assgnmtDto,
+  rptDto,
+  party40ChoiceDto,
+  pstlAdrDto,
+  ctctDtlsDto,
+  idDto
+}

package/test/integration/.env

@@ -0,0 +1,8 @@
+# PROXY_HOST=localhost
+PROXY_HOST=proxy
+PROXY_PORT=4300
+PROXY_NAME=proxyXY
+
+# CL_HOST=localhost
+CL_HOST=central-ledger
+CL_PORT=3001

package/test/integration/api/parties.test.js

@@ -0,0 +1,137 @@
+/*****
+ License
+ --------------
+ Copyright © 2017 Bill & Melinda Gates Foundation
+ The Mojaloop files are made available by the Bill & Melinda Gates 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
+ Gates 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>.
+ * Gates Foundation
+ - Name Surname <name.surname@gatesfoundation.com>
+
+ * Eugen Klymniuk <eugen.klymniuk@infitx.com>
+ --------------
+ **********/
+
+const { setTimeout: sleep } = require('node:timers/promises')
+const { randomUUID } = require('node:crypto')
+const { createProxyCache } = require('@mojaloop/inter-scheme-proxy-cache-lib')
+
+const config = require('../../../src/lib/config')
+const fixtures = require('../../fixtures')
+const { AlsApiClient, ProxyApiClient } = require('../../util')
+const { PAYER_DFSP, PARTY_ID_TYPE } = require('../constants')
+
+const alsClient = new AlsApiClient()
+const proxyClient = new ProxyApiClient() // mock ISPA
+
+describe('Parties Endpoints Tests -->', () => {
+  const { type, proxyConfig } = config.PROXY_CACHE_CONFIG
+  const proxyCache = createProxyCache(type, proxyConfig)
+
+  beforeAll(async () => {
+    await proxyCache.connect()
+  })
+
+  afterAll(async () => {
+    await proxyCache.disconnect()
+  })
+
+  describe('GET /parties... endpoints tests -->', () => {
+    test('should do GET /parties/{Type}/{ID} call to proxy', async () => {
+      const partyId = 'PT123456789'
+      const alsReq = fixtures.mockAlsRequestDto(PAYER_DFSP, PARTY_ID_TYPE, partyId)
+      let isExists = await proxyCache.receivedSuccessResponse(alsReq)
+      expect(isExists).toBe(false)
+
+      let history = await proxyClient.deleteHistory()
+      expect(history).toEqual([])
+
+      const result = await alsClient.getPartyByIdAndType({
+        partyId,
+        partyIdType: PARTY_ID_TYPE,
+        source: PAYER_DFSP,
+        destination: ''
+      })
+      expect(result.status).toBe(202)
+
+      await sleep(1000)
+      history = await proxyClient.getHistory()
+      expect(history.length).toBe(2)
+      expect(history[0].path).toBe(`/oracle/participants/${PARTY_ID_TYPE}/${partyId}`)
+      expect(history[1].path).toBe(`/parties/${PARTY_ID_TYPE}/${partyId}`)
+
+      isExists = await proxyCache.receivedSuccessResponse(alsReq)
+      expect(isExists).toBe(true)
+    })
+
+    test('should handle PUT /parties/{Type}/{ID}/error without accept-header', async () => {
+      const partyId = `PT-${Date.now()}`
+      const body = fixtures.errorCallbackResponseDto()
+
+      const { accept, ...headers } = fixtures.partiesCallHeadersDto({ proxy: 'proxyAB' })
+      expect(headers.accept).toBeUndefined()
+
+      const result = await alsClient.putPartiesError({
+        partyId,
+        partyIdType: PARTY_ID_TYPE,
+        body,
+        headers
+      })
+      expect(result.status).toBe(200)
+    })
+  })
+
+  describe('PUT /parties... endpoints tests -->', () => {
+    const generatePutPartiesTestDataDto = ({
+      partyId = `party-${randomUUID()}`,
+      partyIdType = PARTY_ID_TYPE,
+      source = `sourceFsp-${Date.now()}`,
+      destination = PAYER_DFSP,
+      proxy = `proxy-${randomUUID()}`
+    } = {}) => ({
+      partyId,
+      partyIdType,
+      source,
+      destination,
+      proxy,
+      body: fixtures.putPartiesSuccessResponseDto({ partyId, partyIdType, fspId: source })
+    })
+
+    test('should add dfspIdToProxyMapping after callback response from proxy', async () => {
+      const testData = generatePutPartiesTestDataDto()
+
+      let cached = await proxyCache.lookupProxyByDfspId(testData.source)
+      expect(cached).toBeNull()
+
+      await alsClient.putPartiesSuccess(testData)
+      await sleep(1000)
+
+      cached = await proxyCache.lookupProxyByDfspId(testData.source)
+      expect(cached).toBe(testData.proxy)
+    })
+
+    test('should update oracle with party details from proxy callback response', async () => {
+      const testData = generatePutPartiesTestDataDto()
+      let history = await proxyClient.deleteHistory()
+      expect(history).toEqual([])
+
+      const result = await alsClient.putPartiesSuccess(testData)
+      expect(result.status).toBe(200)
+      await sleep(1000)
+
+      history = await proxyClient.getHistory()
+      expect(history.length).toBeGreaterThan(0)
+    })
+  })
+})

package/test/integration/constants.js

@@ -0,0 +1,20 @@
+const {
+  PROXY_HOST,
+  PROXY_PORT,
+  PROXY_NAME,
+  CL_PORT
+} = process.env
+
+console.log({ PROXY_HOST, PROXY_PORT, PROXY_NAME, CL_PORT })
+
+const PARTY_ID_TYPE = 'IBAN' // for proxy testing
+const PAYER_DFSP = 'testPayerDfsp'
+
+module.exports = {
+  PROXY_HOST,
+  PROXY_PORT,
+  PROXY_NAME,
+  CL_PORT,
+  PARTY_ID_TYPE,
+  PAYER_DFSP
+}