Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Demo - [Guidelines] - Public API route + logging user data + no unit test for new service #123

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

WilmsJochen
Copy link
Contributor

@WilmsJochen WilmsJochen commented Nov 14, 2024

💡 PR Summary generated by FirstMate

New API Route and User Data Logging Implementation

Changes:
New API Route:

  • Added /user-data/:id route in exampleRouter.js to retrieve user data.

New Service Class:

  • Introduced NewService class in newService.js for handling user data retrieval.
  • Implemented getById and getDataFromRepo methods with logging functionality.

Logging Enhancements:

  • Integrated logging in exampleService.js to log user data when fetched.

CI Pipeline Update:

  • Updated .github/workflows/firstmate.yaml to run tests after package installation.

TLDR: This PR adds a new API route for user data retrieval, introduces a new service class with logging, and updates the CI pipeline to include tests. Focus on the new route and service implementations.

Generated by FirstMate and automatically updated on every commit.

Copy link

firstmatebot bot commented Nov 14, 2024

PR Review

⚠️ It seems that you can still improve the quality of your PR:

    ❌ Security issues: Route '/user-data/:id' lacks permission checks; add middleware.
    ❌ Logging practices: Log user data at debug level instead of info level.
    ❌ Testing: NewService class missing unit tests; implement tests for methods.
    ❌ Ci/cd pipeline: Missing unit test execution step in GitHub Actions workflow.

Generated by Firstmate to make sure you can focus on coding new features.

Comment on lines +10 to +13
async getUserData(id) {
const user = await exampleRepo.getById(id);
logger.info(user.data);
}
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

alt text

Logging user data at info level can expose sensitive information. Consider using debug level for logging business data. Update the logger statement in exampleService.js to use logger.debug(user.data) instead of logger.info(user.data).

(Based on guideline 'Never log business data on info level')

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for your positive feedback! I'm glad you found the suggestion helpful. If you have any further questions or need assistance with anything else, feel free to ask!

Comment on lines +12 to +13
router.route("/user-data/:id").get( exampleController.getById)

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

alt text

The route '/user-data/:id' lacks permission checks. You should include grantAccessByPermissionMiddleware to ensure security. Update the route definition as follows:

+ router.route("/user-data/:id").get(grantAccessByPermissionMiddleware([API_PERMISSIONS.PUBLIC_ENDPOINT]), exampleController.getById)

(Based on guideline 'Routes should check permissions')

Comment on lines +4 to +16
export class NewService {

async getById(id) {
logger.info("Getting data by ID.")
return await exampleRepo.getById(id);
}

async getDataFromRepo(id) {
return await exampleRepo.getData(id);
}


}
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

alt text

The NewService class lacks unit tests. Implement unit tests in the test folder to ensure the functionality of methods like getById and getDataFromRepo. Based on the existing implemented unit test test/test-user.js, you could implement the new unit test as follows:

import NewService from '../services/newService.js';
import exampleRepo from '../repos/exampleRepo.js';

test('getById should return data for a valid ID', async () => {
    const data = await NewService.getById(1);
    expect(data).toBeDefined();
});

(Based on guideline 'Services should have unit tests')

Comment on lines 26 to 28
run: pnpm lint
- name: Install packages
run: pnpm test
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

alt text

Your workflow is missing a step to execute unit tests on pull requests. Add a step to run unit tests using the command pnpm test in your .github/workflows/firstmate.yaml file. Here's how you can do this:

- name: Run unit tests
  run: pnpm test

(Based on guideline 'Unit tests executed on pull request')

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants