`@julienbenac/ally-orange` is an [Orange](https://www.orange.fr) 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-orange` package.
๐ฆ Using npm
```bash
npm install @julienbenac/ally-orange
```
๐ Using pnpm
```bash
pnpm add @julienbenac/ally-orange
```
๐งถ Using yarn
```bash
yarn add @julienbenac/ally-orange
```
๐ฅ Using bun
```bash
bun add @julienbenac/ally-orange
```
### 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-orange
```
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 { orange } from '@julienbenac/ally-orange'
const allyConfig = defineConfig({
orange: orange({
clientId: env.get('ORANGE_CLIENT_ID'),
clientSecret: env.get('ORANGE_CLIENT_SECRET'),
callbackUrl: env.get('ORANGE_CALLBACK_URL'),
}),
})
```
Finally, you can use the Orange driver in your AdonisJS application as below.
```ts
// start/routes.ts
import router from '@adonisjs/core/services/router'
router.get('/orange', ({ response }) => {
return response.send(' Login with Orange ')
})
router.get('/orange/redirect', ({ ally }) => {
// You can use or override default scopes
return ally.use('orange').redirect()
})
router.get('/orange/callback', async ({ ally }) => {
const orange = ally.use('orange')
if (orange.accessDenied()) {
return 'Access was denied.'
}
if (orange.hasError()) {
return orange.getError()
}
if (orange.stateMisMatch()) {
return 'State mismatch.'
}
return await orange.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
```