@julienbenac/ally-gerermesaffaires
Version:
GererMesAffaires driver for AdonisJS Ally
128 lines (88 loc) • 4.48 kB
Markdown
<div align="center">
<img src="https://github.com/user-attachments/assets/74aa6d90-cc19-4c32-adb6-d621dd3e5270" />
</div>
<div align="center">
</div>
`@julienbenac/ally-gerermesaffaires` is a [GererMesAffaires](https://www.gerermesaffaires.com) driver for [AdonisJS Ally](https://docs.adonisjs.com/guides/authentication/social-authentication).
## Getting started
### Installation
First of all, if you haven't already done so, you need to install and configure the [`@adonisjs/ally`](https://www.npmjs.com/package/@adonisjs/ally) package to implement social authentication in your AdonisJS application.
```bash
node ace add @adonisjs/ally
```
After going through the first step, you can now download the `@julienbenac/ally-gerermesaffaires` package.
```bash
npm install @julienbenac/ally-gerermesaffaires
```
### Usage
Next, configure the package by running the following command. This command will update the `.env` and `start/env.ts` files with the environment variables.
```bash
node ace configure @julienbenac/ally-gerermesaffaires
```
Then register the service inside the configuration file `config/ally.ts`.
```ts
// config/ally.ts
import env from '#start/env'
import { defineConfig } from '@adonisjs/ally'
import { gerermesaffaires } from '@julienbenac/ally-gerermesaffaires'
const allyConfig = defineConfig({
gerermesaffaires: gerermesaffaires({
clientId: env.get('GERERMESAFFAIRES_CLIENT_ID'),
clientSecret: env.get('GERERMESAFFAIRES_CLIENT_SECRET') || '',
callbackUrl: env.get('GERERMESAFFAIRES_CALLBACK_URL'),
env: env.get('GERERMESAFFAIRES_ENV'),
}),
})
```
Finally, you can use the GererMesAffaires driver in your AdonisJS application as below.
```ts
// start/routes.ts
import router from '@adonisjs/core/services/router'
router.get('/gerermesaffaires', ({ response }) => {
return response.send('<a href="/gerermesaffaires/redirect"> Login with GererMesAffaires </a>')
})
router.get('/gerermesaffaires/redirect', ({ ally }) => {
// You can use or override default scopes
return ally.use('gerermesaffaires').redirect((request) => {
request.clearScopes() // Clear default scopes
request.scopes(['openid', 'collaborator', 'profile', 'email', 'address', 'phone'])
})
})
router.get('/gerermesaffaires/callback', async ({ ally }) => {
const gerermesaffaires = ally.use('gerermesaffaires')
if (gerermesaffaires.accessDenied()) {
return 'Access was denied.'
}
if (gerermesaffaires.hasError()) {
return gerermesaffaires.getError()
}
if (gerermesaffaires.stateMisMatch()) {
return 'State mismatch.'
}
return await gerermesaffaires.user()
})
```
## Development
This section provides instructions for setting up the development environment and contributing to the package. The project uses Git hooks managed by [Husky](https://typicode.github.io/husky) to automate parts of the development workflow, helping maintain code quality and consistency.
### Install dependencies
To set up the development environment, install the project dependencies as follows.
```bash
npm install
```
### Update dependencies with Taze
Taze is a modern CLI tool that helps you keep your dependencies up to date by checking for newer versions and updating them according to your configuration. The project's `taze.config.js` file configures Taze with the following settings:
- Enables interactive mode, allowing you to select which dependencies to update.
- Automatically writes the updated versions to the `package.json`.
- Automatically installs the updated dependencies after updating.
- Checks and updates peer dependencies along with regular dependencies.
```bash
npm run taze
```
### Release package
To publish a new version of the package, run the following command which automates the entire release process. The script handles incrementing the version number, building the production-ready code, publishing the package, and creating a Git tag for the release, ensuring a consistent and error-free workflow.
```bash
npm run release
```