npm package: @julienbenac/ally-gerermesaffaires
Description: GererMesAffaires driver for AdonisJS Ally
Author: Julien Benac
Latest version: 1.1.11

<div align="center">
  <img src="https://github.com/user-attachments/assets/74aa6d90-cc19-4c32-adb6-d621dd3e5270" />
</div>

<div align="center">

![Version](https://img.shields.io/npm/v/@julienbenac/ally-gerermesaffaires?style=for-the-badge&colorA=4c566a&colorB=5382a1&logo=npm&logoColor=white)
![Code Size](https://img.shields.io/github/languages/code-size/julienbenac/ally-gerermesaffaires?style=for-the-badge&colorA=4c566a&colorB=ebcb8b&logo=github&logoColor=white)
![License](https://img.shields.io/github/license/julienbenac/ally-gerermesaffaires?style=for-the-badge&colorA=4c566a&colorB=a3be8c)

</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.

<details open>
  <summary><strong>📦 Using npm</strong></summary>

```bash
npm install @julienbenac/ally-gerermesaffaires
```

</details>

<details>
  <summary><strong>🚀 Using pnpm</strong></summary>

```bash
pnpm add @julienbenac/ally-gerermesaffaires
```

</details>

<details>
  <summary><strong>🧶 Using yarn</strong></summary>

```bash
yarn add @julienbenac/ally-gerermesaffaires
```

</details>

<details>
  <summary><strong>🥟 Using bun</strong></summary>

```bash
bun add @julienbenac/ally-gerermesaffaires
```

</details>

### 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
```