PISP - Payment Initiation Service Providers

This repo contains the documentation, specifications and tests for the Mojaloop-PISP workstream.

Overview

• Project Documentation - Project Documentation, flows, uml diagrams and so on
• Docker-Local - Onboarding environment for local development & end to end testing
• Docker-Contract - Environment for testing with ml-testing-toolkit

External Links

• Proposal Documentation on Google drive
• ZenHub board

Running Tests

Tests are run automatically by CircleCI.

End To End tests

# install local node modules
npm install

# start the services
cd ./docker-local
docker-compose up -d

# wait for services to be healthy
npm run wait-4-docker

# Seed the environment with test data
npm run reseed

# Run the end to end tests
npm run test:e2e

Note: You can also invoke these tests using Jest's watch mode:

npm run test:e2e -- --watch

Contract Tests

# start the services
cd ./docker-contract
docker-compose up -d

npm run test:contract

Note: You can also invoke these tests using Jest's watch mode:

npm run test:contract -- --watch

Writing tests for PISP Features:

When working on PISP features, we will follow these test guidelines:

Note: I like to refer to Martin Fowler's Testing Pyramid for testing inspiration and clarity.

1. Unit Tests - Implemented in their own repos on pisp/* feature branches.

   • use tape for existing repos, and jest for new repos

2. Integration Tests - Implemented in their respective repos

3. End To End Tests - Test the full end to end functionality of the PISP features. Implemented in this repository.

• End to end tests will call the HTTP endpoints of the real components + simulators to verify the end to end functionality
• use jest + typescript (these are the Mojaloop Standards for new repos) and evaluate Cucumber or Gherkin jest extensions.

4. Contract Tests - Test the interfaces between the Mojaloop Switch and DFSP/PISP components. Will be implemented in this repository.

• use mojaloop-simulator + ml-testing-toolkit

Note: Are there other contracts we need to test here? Internally, we don't do much of this type of testing. We might find that we will want contract tests between the new auth-service and other Mojaloop components

BDD

jest-cucumber allows to use jest to execute Gherkin scenarios. Thanks to jest we are getting also code coverage for BDD Scenarios.

in test/features are Feature/Scenarios in .feature files which contain declarations in Gherkin language.

in test/step-definitions are Steps implementations in .step.ts files.

Execute scenarios and report code coverage:

npm run test:bdd

Unit Testing

Jest setup, which allows to prepare unit tests specified in test/**/*.(spec|test).ts files. Coverage report is always generated. If the speed of unit tests will go very slow we will refactor configuration to generate coverage only on demand.

npm run test:unit

If you want to generate test report in junit format do:

npm run test:junit

There is mojaloop convention to use test/unit path to keep tests. The placement of test folder should be similar to placement of tested code in src folder

Source Code Linting

eslint setup compatible with javascript standard and dedicated for TypeScript typescript-eslint.

• it is much more flexible
• has good support for editors to visualize linting problem during typing.

To lint all files simply run

npm run lint

Linting & Auto fixing via pre-commit husky hook

Committing untested and bad formatted code to repo is bad behavior, so we use husky integrated with lint-staged.

There is defined pre-commit hook which runs linting only for staged files, so execution time is as fast as possible - only staged files are linted and if possible automatically fixed.

Corresponding excerpt from package.json:

 "husky": {
    "hooks": {
      "pre-commit": "lint-staged && npm run test:unit",
      "post-commit": "git update-index --again"
    }
  },
  "lint-staged": {
    "*.{js,ts}": "eslint --cache --fix"
  }

1. Demos - End to End demos/examples
   • We should maintain a simple end to end postman collection for demo and illustration purposes
   • These tests can be a subset of what we implement in the #3 End to End Tests, and are not used to evaluate CI/CD passes or failure
   • For now, this should be a part of this repo, but upon the release of the PISP Features, they can be included in the mojaloop/postman Golden Path tests.

Updating Thirdparty API Specification

1. Edit src/interface/api-template.yaml.

2. Wherever possible use snippets defined in https://github.com/mojaloop/api-snippets

3. Run npm run build:openapi to bundle, render and validate the generated api.