twenty/tools/eslint-rules/rules
Jérémy M de20c564c7
feat: add eslint rule for enforcing WorkspaceService naming convention (#6308)
### Description

This PR introduces a custom ESLint rule named
`inject-workspace-repository`. The purpose of this rule is to enforce
naming conventions for files and classes that use the
`@InjectWorkspaceRepository` decorator or include services ending with
`WorkspaceService` in their constructors.

### Rule Overview

The new ESLint rule checks for the following conditions:

1. **File Naming**:
- Only file ending with `.service.ts` or `.workspace-service.ts` are
checked.
- If a file contains a class using the `@InjectWorkspaceRepository`
decorator or a service ending with `WorkspaceService` in the
constructor, the file name must end with `.workspace-service.ts`.

2. **Class Naming**:
- Classes that use the `@InjectWorkspaceRepository` decorator or include
services ending with `WorkspaceService` in their constructors must have
names that end with `WorkspaceService`.

### How It Works

The rule inspects each TypeScript file to ensure that the naming
conventions are adhered to. It specifically looks for:

- Constructor parameters with the `@InjectWorkspaceRepository`
decorator.
- Constructor parameters with a type annotation ending with
`WorkspaceService`.

When such parameters are found, it checks the class name and the file
name to ensure they conform to the expected patterns.

### Example Code

#### Valid Cases

1. **Correct File and Class Name with Decorator**:
    ```typescript
    // Filename: my.workspace-service.ts
    class MyWorkspaceService {
      constructor(@InjectWorkspaceRepository() private repository) {}
    }
    ```

2. **Service Dependency**:
    ```typescript
    // Filename: another.workspace-service.ts
    class AnotherWorkspaceService {
      constructor(private myWorkspaceService: MyWorkspaceService) {}
    }
    ```

#### Invalid Cases

1. **Incorrect Class Name**:
    ```typescript
    // Filename: my.workspace-service.ts
    class MyService {
      constructor(@InjectWorkspaceRepository() private repository) {}
    }
    // Error: Class name should end with 'WorkspaceService'.
    ```

2. **Incorrect File Name**:
    ```typescript
    // Filename: my.service.ts
    class MyWorkspaceService {
      constructor(@InjectWorkspaceRepository() private repository) {}
    }
    // Error: File name should end with '.workspace-service.ts'.
    ```

3. **Incorrect File and Class Name**:
    ```typescript
    // Filename: my.service.ts
    class MyService {
      constructor(@InjectWorkspaceRepository() private repository) {}
    }
    // Error: Class name should end with 'WorkspaceService'.
    // Error: File name should end with '.workspace-service.ts'.
    ```

4. **Incorrect File Type**:
    ```typescript
    // Filename: another.service.ts
    class AnotherService {
      constructor(private myWorkspaceService: MyWorkspaceService) {}
    }
    // Error: Class name should end with 'WorkspaceService'.
    // Error: File name should end with '.workspace-service.ts'.

    ```

5. **Incorrect Class Name with Dependency**:
    ```typescript
    // Filename: another.workspace-service.ts
    class AnotherService {
      constructor(private myWorkspaceService: MyWorkspaceService) {}
    }
    // Error: Class name should end with 'WorkspaceService'.
    ```

### First step

This rule is only a warning for now, and then we'll migrate all the code
that need to be migrated and move from `warn` to `error`.

Fix #6309

Co-authored-by: Charles Bochet <charles@twenty.com>
2024-07-19 19:17:57 +02:00
..
component-props-naming.spec.ts POC: chore: use Nx workspace lint rules (#3163) 2024-01-03 23:07:25 +01:00
component-props-naming.ts POC: chore: use Nx workspace lint rules (#3163) 2024-01-03 23:07:25 +01:00
effect-components.spec.ts POC: chore: use Nx workspace lint rules (#3163) 2024-01-03 23:07:25 +01:00
effect-components.ts POC: chore: use Nx workspace lint rules (#3163) 2024-01-03 23:07:25 +01:00
explicit-boolean-predicates-in-if.ts Fix explicit boolean predicates rule not working with boolean constants (#5009) 2024-04-17 17:06:37 +02:00
inject-workspace-repository.spec.ts feat: add eslint rule for enforcing WorkspaceService naming convention (#6308) 2024-07-19 19:17:57 +02:00
inject-workspace-repository.ts feat: add eslint rule for enforcing WorkspaceService naming convention (#6308) 2024-07-19 19:17:57 +02:00
matching-state-variable.spec.ts POC: chore: use Nx workspace lint rules (#3163) 2024-01-03 23:07:25 +01:00
matching-state-variable.ts POC: chore: use Nx workspace lint rules (#3163) 2024-01-03 23:07:25 +01:00
max-consts-per-file.spec.ts TWNTY-3825 - ESLint rule: const naming (#4171) 2024-02-25 13:52:48 +01:00
max-consts-per-file.ts TWNTY-3825 - ESLint rule: const naming (#4171) 2024-02-25 13:52:48 +01:00
no-hardcoded-colors.spec.ts POC: chore: use Nx workspace lint rules (#3163) 2024-01-03 23:07:25 +01:00
no-hardcoded-colors.ts POC: chore: use Nx workspace lint rules (#3163) 2024-01-03 23:07:25 +01:00
no-navigate-prefer-link.spec.ts Create ESLint rule to discourage usage of navigate() and prefer Link (#5642) 2024-06-04 17:04:57 +02:00
no-navigate-prefer-link.ts Create ESLint rule to discourage usage of navigate() and prefer Link (#5642) 2024-06-04 17:04:57 +02:00
no-state-useref.spec.ts POC: chore: use Nx workspace lint rules (#3163) 2024-01-03 23:07:25 +01:00
no-state-useref.ts POC: chore: use Nx workspace lint rules (#3163) 2024-01-03 23:07:25 +01:00
sort-css-properties-alphabetically.spec.ts POC: chore: use Nx workspace lint rules (#3163) 2024-01-03 23:07:25 +01:00
sort-css-properties-alphabetically.ts POC: chore: use Nx workspace lint rules (#3163) 2024-01-03 23:07:25 +01:00
styled-components-prefixed-with-styled.spec.ts POC: chore: use Nx workspace lint rules (#3163) 2024-01-03 23:07:25 +01:00
styled-components-prefixed-with-styled.ts POC: chore: use Nx workspace lint rules (#3163) 2024-01-03 23:07:25 +01:00
use-getLoadable-and-getValue-to-get-atoms.spec.ts TWNTY-3794 - ESLint rule: only take explicit boolean predicates in if statements (#4354) 2024-03-09 10:48:19 +01:00
use-getLoadable-and-getValue-to-get-atoms.ts TWNTY-2244 - ESLint rule: enforce usage of .getLoadable() + .getValue() to get atoms (#4143) 2024-03-06 00:24:20 +01:00
useRecoilCallback-has-dependency-array.spec.ts [ESLint rule] prevent useRecoilCallback without a dependency array (#4411) 2024-03-12 15:12:17 +01:00
useRecoilCallback-has-dependency-array.ts [ESLint rule] prevent useRecoilCallback without a dependency array (#4411) 2024-03-12 15:12:17 +01:00