@dsivd/prestations-ng 18.8.0-beta.13 → 19.0.0-beta-9

package/ESLINT_MIGRATION_GUIDE.md

@@ -40,10 +40,10 @@ Before:
             builder: '@angular-devkit/build-angular:tslint',
             options: {
                 tsConfig: ['e2e/tsconfig.e2e.json'],
-                exclude: ['**/node_modules/**']
-            }
-        }
-    }
+                exclude: ['**/node_modules/**'],
+            },
+        },
+    },
 }
 ```
 
@@ -57,10 +57,10 @@ After:
         lint: {
             builder: '@angular-eslint/builder:lint',
             options: {
-                lintFilePatterns: ['e2e/**/*.ts', 'e2e/**/*.html']
-            }
-        }
-    }
+                lintFilePatterns: ['e2e/**/*.ts', 'e2e/**/*.html'],
+            },
+        },
+    },
 }
 ```
 
@@ -80,10 +80,10 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
     env: {
         browser: true,
         es6: true,
-        node: true
+        node: true,
     },
     parserOptions: {
-        ecmaVersion: 8
+        ecmaVersion: 8,
     },
     ignorePatterns: [
         '/projects/**/*',
@@ -92,8 +92,7 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
         '/karma.conf.js',
         '/.eslintrc.json',
         '/tsconfig*.json',
-        '/src/main.ts',
-        '/src/typings.d.ts'
+        '/src/typings.d.ts',
     ],
     reportUnusedDisableDirectives: true,
     settings: {
@@ -101,8 +100,8 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
         'import/internal-regex': '^@dsivd/',
         'import/resolver': {
             node: { extensions: ['.js', '.ts', '.d.ts'] },
-            typescript: {}
-        }
+            typescript: {},
+        },
     },
     overrides: [
         // Typescript
@@ -111,7 +110,7 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
             parserOptions: {
                 ecmaVersion: 2020,
                 project: ['tsconfig.json'],
-                createDefaultProgram: true
+                createDefaultProgram: true,
             },
             plugins: ['import', 'rxjs', 'rxjs-angular', 'simple-import-sort'],
             extends: [
@@ -122,7 +121,7 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
                 'plugin:import/recommended',
                 'plugin:import/errors',
                 'plugin:import/warnings',
-                'plugin:import/typescript'
+                'plugin:import/typescript',
             ],
             rules: {
                 /* @angular-eslint */
@@ -131,16 +130,16 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
                     {
                         type: 'element',
                         prefix: 'app',
-                        style: 'kebab-case'
-                    }
+                        style: 'kebab-case',
+                    },
                 ],
                 '@angular-eslint/directive-selector': [
                     'error',
                     {
                         type: 'attribute',
                         prefix: 'app',
-                        style: 'camelCase'
-                    }
+                        style: 'camelCase',
+                    },
                 ],
                 '@angular-eslint/no-empty-lifecycle-method': 'error',
                 '@angular-eslint/use-lifecycle-interface': 'error',
@@ -149,8 +148,8 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
                     'error',
                     {
                         default: 'array',
-                        readonly: 'array'
-                    }
+                        readonly: 'array',
+                    },
                 ],
                 '@typescript-eslint/ban-ts-comment': 'error',
                 '@typescript-eslint/ban-tslint-comment': 'error',
@@ -158,8 +157,8 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
                     'error',
                     '1tbs',
                     {
-                        allowSingleLine: true
-                    }
+                        allowSingleLine: true,
+                    },
                 ],
                 '@typescript-eslint/comma-dangle': [
                     'error',
@@ -169,8 +168,8 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
                         functions: 'never',
                         enums: 'never',
                         generics: 'always-multiline',
-                        tuples: 'always-multiline'
-                    }
+                        tuples: 'always-multiline',
+                    },
                 ],
                 '@typescript-eslint/consistent-type-assertions': 'error',
                 '@typescript-eslint/dot-notation': 'error',
@@ -181,14 +180,14 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
                         allowTypedFunctionExpressions: true,
                         allowHigherOrderFunctions: true,
                         allowDirectConstAssertionInArrowFunctions: true,
-                        allowConciseArrowFunctionExpressionsStartingWithVoid: false
-                    }
+                        allowConciseArrowFunctionExpressionsStartingWithVoid: false,
+                    },
                 ],
                 '@typescript-eslint/explicit-member-accessibility': [
                     'error',
                     {
-                        accessibility: 'no-public'
-                    }
+                        accessibility: 'no-public',
+                    },
                 ],
                 '@typescript-eslint/indent': [
                     'error',
@@ -205,8 +204,8 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
                         ImportDeclaration: 1,
                         flatTernaryExpressions: false,
                         offsetTernaryExpressions: true,
-                        ignoreComments: false
-                    }
+                        ignoreComments: false,
+                    },
                 ],
                 '@typescript-eslint/interface-name-prefix': 'off',
                 '@typescript-eslint/member-delimiter-style': 'error',
@@ -216,14 +215,14 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
                 '@typescript-eslint/no-inferrable-types': [
                     'error',
                     {
-                        ignoreParameters: true
-                    }
+                        ignoreParameters: true,
+                    },
                 ],
                 '@typescript-eslint/no-shadow': [
                     'error',
                     {
-                        hoist: 'all'
-                    }
+                        hoist: 'all',
+                    },
                 ],
                 '@typescript-eslint/no-unused-expressions': 'error',
                 '@typescript-eslint/no-use-before-define': 'off',
@@ -240,15 +239,15 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
                     {
                         path: 'always',
                         types: 'prefer-import',
-                        lib: 'always'
-                    }
+                        lib: 'always',
+                    },
                 ],
                 '@typescript-eslint/type-annotation-spacing': 'error',
                 '@typescript-eslint/typedef': [
                     'error',
                     {
-                        parameter: true
-                    }
+                        parameter: true,
+                    },
                 ],
                 '@typescript-eslint/unified-signatures': 'error',
                 /* @eslint */
@@ -273,8 +272,8 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
                 'no-console': [
                     'error',
                     {
-                        allow: ['log', 'warn', 'error', 'assert', 'clear']
-                    }
+                        allow: ['log', 'warn', 'error', 'assert', 'clear'],
+                    },
                 ],
                 'no-debugger': 'error',
                 'no-empty': ['error', { allowEmptyCatch: true }],
@@ -285,8 +284,8 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
                 'no-restricted-imports': [
                     'error',
                     {
-                        paths: ['rxjs/Rx', 'primeng/primeng', 'primeng']
-                    }
+                        paths: ['rxjs/Rx', 'primeng/primeng', 'primeng'],
+                    },
                 ],
                 'no-return-assign': 'error',
                 'no-shadow': 'off',
@@ -303,8 +302,8 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
                     'always',
                     {
                         avoidQuotes: true,
-                        avoidExplicitReturnArrows: false
-                    }
+                        avoidExplicitReturnArrows: false,
+                    },
                 ],
                 'one-var': ['error', 'never'],
                 'prefer-arrow-callback': 'error',
@@ -318,16 +317,16 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
                     {
                         anonymous: 'never',
                         asyncArrow: 'always',
-                        named: 'never'
-                    }
+                        named: 'never',
+                    },
                 ],
                 'space-in-parens': ['error', 'never'],
                 'spaced-comment': [
                     'error',
                     'always',
                     {
-                        markers: ['/']
-                    }
+                        markers: ['/'],
+                    },
                 ],
                 'use-isnan': 'error',
                 'valid-typeof': 'off',
@@ -339,16 +338,16 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
                     'warn',
                     {
                         maxDepth: 3,
-                        ignoreExternal: true
-                    }
+                        ignoreExternal: true,
+                    },
                 ],
                 'import/no-deprecated': 'warn',
                 'simple-import-sort/imports': 'error',
                 'simple-import-sort/exports': 'error',
                 'import/first': 'error',
                 'import/newline-after-import': 'error',
-                'import/no-duplicates': 'error'
-            }
+                'import/no-duplicates': 'error',
+            },
         },
         // HTML
         {
@@ -360,35 +359,35 @@ You can replace the content of your `.eslintrc.json` with the following `json`.
                 'max-len': [
                     'error',
                     {
-                        code: 200
-                    }
+                        code: 200,
+                    },
                 ],
-                '@angular-eslint/template/button-has-type': 'error'
-            }
+                '@angular-eslint/template/button-has-type': 'error',
+            },
         },
         // Jasmine
         {
             files: ['src/**/*.spec.ts', 'src/**/*.d.ts'],
             parserOptions: {
-                project: 'tsconfig.spec.json'
+                project: 'tsconfig.spec.json',
             },
             extends: ['plugin:jasmine/recommended'],
             plugins: ['jasmine'],
             env: { jasmine: true },
             rules: {
                 '@typescript-eslint/no-unused-vars': 'off',
-                'jasmine/new-line-before-expect': 'off'
-            }
+                'jasmine/new-line-before-expect': 'off',
+            },
         },
         // Javasript (setup ultra-basique)
         {
             files: ['*.js'],
             extends: ['eslint:recommended'],
             rules: {
-                quotes: ['error', 'single']
-            }
-        }
-    ]
+                quotes: ['error', 'single'],
+            },
+        },
+    ],
 }
 ```
 
@@ -430,11 +429,9 @@ When you are done with your migration and happy with the result, you can delete
 ## Configurating IntelliJ IDEA to use ESLint as your JavaScript linter
 
 - To configure ESLint automatically in the current project, open "_File -> Settings..._" (`Ctrl+Alt+S`) and either:
-
     - Search for `ESLint`
 
     or
-
     - Navigate to "_Languages & Frameworks -> Code Quality Tools -> ESLint_"
 
     and check radio box "_Automatic ESLint configuration_"

package/IAM_ACV_MIGRATION_OIDC.md

@@ -0,0 +1,138 @@
+# IAM ACV OIDC MIGRATION GUIDE
+
+Back offices that are behind IAM ACV should migrate to OIDC, IAM headers are now deprecated.
+
+## ADMIN
+
+- You have to request a new VIP for your application (<env>-<deployunit>.etat-de-vaud.ch)
+    - i.e. for eldoradobo (R260219_00034) : https://int-eldoradobo.etat-de-vaud.ch/
+- On IAM side, you have to request a client id / secret on every environment to be used in your configuration
+
+## FRONTEND
+
+- Enable the interceptor that is used for dev server by providing the following injection token in your app.component.ts : `{ provide: OIDC_ENABLED, useValue: 'true' }`
+- Update your proxy.conf.json to add `/oauth2`, `/login`, `/logout` :
+
+```json
+[
+    {
+        "context": ["/api", "/oauth2", "/login", "/logout"],
+        "target": "http://localhost:20900",
+        "secure": false
+    }
+]
+```
+
+- update your angular.json
+
+```json
+  "baseHref": "/",
+```
+
+## BACKEND
+
+- remove the server.servlet.context-path (your application should respond on "/")
+- Replace this import : `cyberadminbe.config.CyberAdminBeSecurityConfig` with this one `backofficebe.config.IamAcvOidcSecurityConfiguration`
+- add the following dependency :
+
+```xml
+<dependency>
+    <groupId>org.springframework.boot</groupId>
+    <artifactId>spring-boot-starter-oauth2-client</artifactId>
+</dependency>
+```
+
+- update your application.properties with
+
+```properties
+# OIDC common properties
+spring.security.oauth2.client.registration.acv.client-name=SSO ACV
+spring.security.oauth2.client.registration.acv.authorization-grant-type=authorization_code
+spring.security.oauth2.client.registration.acv.scope=openid,profile,email
+```
+
+- update your CO/environment.properties + UT/environment.properties with
+
+```properties
+spring.security.oauth2.client.registration.acv.client-id=mock-client-id
+spring.security.oauth2.client.registration.acv.client-secret=anySecret
+spring.security.oauth2.client.provider.acv.issuer-uri=http://localhost:8080/acv
+```
+
+- Expose the actuators on a different port, by updating your application.properties
+
+```properties
+# With OIDC we have to expose actuators without any security to be called by spring boot admin
+# so the are exposed on another port
+management.server.port=${port.divers:8086}
+# expose liveness/readiness probes on the same port as the application (/livez / readyz)
+management.endpoint.health.probes.add-additional-paths=true
+# send actuator access log to /dev/stdout
+management.server.tomcat.accesslog.enabled=true
+management.server.tomcat.accesslog.directory=/dev
+management.server.tomcat.accesslog.prefix=stdout
+management.server.tomcat.accesslog.suffix=
+```
+
+### TESTING
+
+To be able to use @SpringBootTest, you have to :
+
+- add the following dependency :
+
+```xml
+        <dependency>
+            <groupId>org.springframework.security</groupId>
+            <artifactId>spring-security-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+```
+
+- provide the token in your mock request, you can replace this helper :
+
+```java
+    static MockHttpServletRequestBuilder enrichWithAuthHeaders(MockHttpServletRequestBuilder builder) {
+        return builder.header("iam-userid", "sar8h6")
+                .header("iam-firstname", "Bruce")
+                .header("iam-lastname", "Wayne")
+                .header("iam-application", "app")
+                .header("iam-roles", "app-user");
+    }
+```
+
+with methods from `ch.vd.cyber.backofficebe.utils.MVCTestUtils`:
+
+- `enrichWithOidcTokenAsUser` : simulates that a request is done by an IAM user, with a valid OIDC token and the role "user"
+- `enrichWithOidcTokenAsRole` : same as previous, but you can set another role than "user"
+- `enrichWithAuthHeadersForEsgateAsUser` : simulates that a request is done by a techincal user through esgate and the role "user"
+- `enrichWithAuthHeadersForEsgate` : same as previous, but you can set another role than "user"
+
+## RUNNING YOUR APP
+
+- You can run a mock OIDC server with this command :
+
+```shell
+podman login docker-registry.etat-de-vaud.ch
+```
+
+```shell
+podman run -p 8080:8080 --rm docker-registry.etat-de-vaud.ch/tools/mock-oidc:latest
+```
+
+- You can also run your app with the mock OIDC server on startup by adding the following line in your TomcatRunner.java
+
+```java
+TomcatRunnerHelper.startIamAcvOIDCMockServer();
+```
+
+## Troubleshooting
+
+```shell
+Error: writing blob: adding layer with blob "sha256:c0980b751eb29a6c18ccca8f03a091a556268d924d2021c32c94db254c54d304": processing tar file(lchown /home/java: value too large for defined data type): exit status 1
+```
+
+If you have this error when running the mock OIDC server, you need to raise the UID/GID range.
+
+- Edit `/etc/subuid` and `/etc/subgid` and change the range for your user (i.e. `youruser:10000:65536` to `youruser:1000000:1000000`)
+- Execute `podman system migrate` to apply the changes
+- Try to run the mock OIDC server again

package/MULTI_ETAPES.md

@@ -37,7 +37,7 @@ public class EsproCreationController extends AbstractSdkController<EsproCreation
 
 ## Frontend
 
-- Routing update : duplicate main route in `app.routing.module.ts`
+- Routing update : duplicate main route in `app.routes.ts`
 
 current:
 

package/README.md

@@ -8,6 +8,8 @@ The generated documentation of our entire library is available online at [https:
 
 The documentation is available online at [https://dsi-vd.github.io/prestations-ng/](https://dsi-vd.github.io/prestations-ng/)
 
+- If you're using **Angular 21**, use `@dsivd/prestations-ng` at version `^19`.
+- If you're using **Angular 19**, use `@dsivd/prestations-ng` at version `^18`.
 - If you're using **Angular 17**, use `@dsivd/prestations-ng` at version `^17`.
 - If you're using **Angular 15**, use `@dsivd/prestations-ng` at version `^16`.
 - If you're using **Angular 13**, use `@dsivd/prestations-ng` at version `^15`.
@@ -20,6 +22,7 @@ The documentation is available online at [https://dsi-vd.github.io/prestations-n
 
 Migration guides are available to provide an upgrade path from one major version to another.
 
+- If you need to upgrade to version `19+`, please refer to [the V19 upgrade guide](UPGRADING_V19.md).
 - If you need to upgrade to version `18+`, please refer to [the V18 upgrade guide](UPGRADING_V18.md).
 - If you need to upgrade to version `17+`, please refer to [the V17 upgrade guide](UPGRADING_V17.md).
 - If you need to upgrade to version `16+`, please refer to [the V16 upgrade guide](UPGRADING_V16.md).
@@ -51,9 +54,9 @@ For accessibility testing purpose, an [accessibility page](https://dsi-vd.github
 
 More information on how to use `@dsivd/prestations-ng` in a project are available there: [USAGE_IN_PROJECTS.md](USAGE_IN_PROJECTS.md)
 
-## List of provided modules
+## List of provided components
 
-A list of modules provided by the library is available there: [MODULES.md](MODULES.md).
+A list of standalone components provided by the library is available there: [COMPONENTS.md](COMPONENTS.md).
 
 ## Contributing
 

package/UPGRADING_V12.md

@@ -55,24 +55,20 @@ The following components, attributes or methods have been removed.
 ### foehn-address component
 
 - Removed:
-
     - Component `foehn-address.component.ts` (selector: **foehn-address**)
     - Model `foehn-address.type.ts` (FoehnAddress)
 
 - Replaced by:
-
     - Component [foehn-display-address.component.ts](projects/prestations-ng/src/foehn-address/foehn-display-address.component.ts)
     - Model `address.type.ts` (Address)
 
 ### foehn-upload component
 
 - Removed:
-
     - Component `foehn-simple-upload.component.ts` (selector: **foehn-upload**)
     - Service `upload.service.ts` (UploadService)
 
 - Replaced by:
-
     - Component [foehn-multi-upload.component.ts](projects/prestations-ng/src/foehn-upload/foehn-multi-upload/foehn-multi-upload.component.ts)
     - Service [multi-upload.service.ts](projects/prestations-ng/src/foehn-upload/foehn-multi-upload/multi-upload.service.ts)
 
@@ -81,31 +77,25 @@ The following components, attributes or methods have been removed.
 ### appInfo() from application-info service
 
 - Removed:
-
     - getter `appInfo()` returning `ApplicationInfo` in [application-info.service.ts](projects/prestations-ng/src/sdk-appinfo/application-info.service.ts)
 
 - Replaced by:
-
     - getter `data()` returning an `Observable<ApplicationInfo>` in [application-info.service.ts](projects/prestations-ng/src/sdk-appinfo/application-info.service.ts)
 
 ### isProduction() from foehn-header component
 
 - Removed:
-
     - public function `isProduction()` returning a `boolean` because using deleted getter `appInfo`
 
 - Replaced by:
-
     - public variable `isProduction` returning an `Observable<boolean>` on which you can either `subscribe` or `pipe async` in your view
 
 ### getEnvironment() from foehn-header component
 
 - Removed:
-
     - public function `getEnvironment()` returning a `string` because using deleted getter `appInfo`
 
 - Replaced by:
-
     - No replacement
 
 ### getEnvironmentLabel() from foehn-header component

package/UPGRADING_V16.md

@@ -698,7 +698,6 @@ see example in skeleton: https://dsigit.etat-de-vaud.ch/outils/git/projects/CYBS
 ### POM cleanup
 
 - remove the following dependencies that are already imported in ``
-
     - `org.mockito.mockito-core`
     - `org.mockito.mockito-junit-jupiter`