@ibertran/fortytwo-intra-client 3.1.4 → 4.0.0

package/README.md

@@ -1,6 +1,6 @@
 # FortytwoIntraClient
 
-A TypeScript library for interacting with the 42API with built-in rate limiting, automatic token management, and retry logic.
+A TypeScript library for interacting with the 42 API with built-in rate limiting, automatic token management, and retry logic.
 
 ## Installation
 
@@ -11,13 +11,12 @@ npm install @ibertran/fortytwo-intra-client
 ## Quick Start
 
 ```typescript
-import { FortytwoIntraClient } from '@ibertran/fortytwo-intra-client';
-
-const client = new FortytwoIntraClient('your_client_id', 'your_client_secret');
+import { FortytwoIntraClient } from "@ibertran/fortytwo-intra-client";
 
+const client = new FortytwoIntraClient("your_client_id", "your_client_secret");
 
 // Get a specific user by login
-const user = await client.get('users/ibertran');
+const user = await client.get("users/ibertran");
 console.log(user);
 ```
 
@@ -26,39 +25,37 @@ console.log(user);
 The `FortytwoIntraClient` class accepts three parameters:
 
 1. `client_id` (required): Your 42 API client ID
-2. `client_secret` (required): Your 42 API client secret  
+2. `client_secret` (required): Your 42 API client secret
 3. `config` (optional): Configuration object
 
 ### Configuration Options
 
 ```typescript
 interface FortytwoIntraClientConf {
-  redirect_uri: string | null;           // OAuth redirect URI (default: null)
-  base_url: string;                      // API base URL (default: "https://api.intra.42.fr/v2/")
-  token_url: string;                     // Token endpoint (default: "https://api.intra.42.fr/oauth/token")
-  oauth_url: string;                     // OAuth endpoint (default: "https://api.intra.42.fr/oauth/authorize")
-  token_info_url: string;                // Token info endpoint (default: "https://api.intra.42.fr/oauth/token/info")
-  scopes: string[];                      // OAuth scopes (default: ["public"])
-  rateLimitMaxRequests: number;          // Max requests per time window (default: 2)
-  rateLimitPerMilliseconds: number;      // Time window in milliseconds (default: 1200)
-  maxRetry: number;                      // Max retry attempts (default: 5)
-  logLine: boolean;                      // Enable request logging (default: true)
-  errLogBody: boolean;                   // Log error response bodies (default: true)
-  throwOnError: boolean;                 // Throw errors instead of returning them (default: true)
+	redirect_uri: string | null; // OAuth redirect URI (default: null)
+	base_url: string; // API base URL (default: "https://api.intra.42.fr/v2/")
+	token_url: string; // Token endpoint (default: "https://api.intra.42.fr/oauth/token")
+	oauth_url: string; // OAuth endpoint (default: "https://api.intra.42.fr/oauth/authorize")
+	token_info_url: string; // Token info endpoint (default: "https://api.intra.42.fr/oauth/token/info")
+	scopes: string[]; // OAuth scopes (default: ["public"])
+	rateLimitMaxRequests: number; // Max requests per time window (default: 2)
+	rateLimitPerMilliseconds: number; // Time window in milliseconds (default: 1200)
+	maxRetry: number; // Max retry attempts (default: 5)
+	logLine: boolean; // Enable request logging (default: true)
+	errLogBody: boolean; // Log error response bodies (default: true)
 }
 ```
 
 ### Example with Custom Configuration
 
 ```typescript
-const client = new FortytwoIntraClient('your_client_id', 'your_client_secret', {
-  rateLimitMaxRequests: 1,              // 1 request per 1200ms
-  rateLimitPerMilliseconds: 1200,       // Time window
-  maxRetry: 3,                          // Retry up to 3 times
-  logLine: false,                       // Disable logging
-  errLogBody: false,                    // Disable error body logging
-  throwOnError: false,                  // Return errors instead of throwing
-  scopes: ['public', 'projects']        // Extended scopes
+const client = new FortytwoIntraClient("your_client_id", "your_client_secret", {
+	rateLimitMaxRequests: 1, // 1 request per 1200ms
+	rateLimitPerMilliseconds: 1200, // Time window
+	maxRetry: 3, // Retry up to 3 times
+	logLine: false, // Disable logging
+	errLogBody: false, // Disable error body logging
+	scopes: ["public", "projects"], // Extended scopes
 });
 ```
 
@@ -68,11 +65,11 @@ const client = new FortytwoIntraClient('your_client_id', 'your_client_secret', {
 
 ```typescript
 // Get all campuses
-const campuses = await client.get('campus');
+const campuses = await client.get("campus");
 console.log(`Found ${campuses.length} campuses`);
 
 // Get a specific campus
-const lyonCampus = await client.get('campus/9');
+const lyonCampus = await client.get("campus/9");
 console.log(`${lyonCampus.name}: ${lyonCampus.users_count} users`);
 ```
 
@@ -80,11 +77,11 @@ console.log(`${lyonCampus.name}: ${lyonCampus.users_count} users`);
 
 ```typescript
 // Create a team for a project
-const team = await client.post('teams', {
-  body: {
-    name: 'awesome-team',
-    project_id: 42
-  }
+const team = await client.post("teams", {
+	body: {
+		name: "awesome-team",
+		project_id: 42,
+	},
 });
 ```
 
@@ -92,12 +89,12 @@ const team = await client.post('teams', {
 
 ```typescript
 // Update a team name
-const updatedTeam = await client.patch('teams/123', {
-  body: {
+const updatedTeam = await client.patch("teams/123", {
+	body: {
 		team: {
-			name: "updated-team-name"
-		}
-  }
+			name: "updated-team-name",
+		},
+	},
 });
 ```
 
@@ -105,7 +102,7 @@ const updatedTeam = await client.patch('teams/123', {
 
 ```typescript
 // Delete a team
-await client.delete('teams/123');
+await client.delete("teams/123");
 ```
 
 ### Get All Pages (Pagination Helper)
@@ -114,12 +111,12 @@ The `getAll` method automatically handles pagination and returns all results:
 
 ```typescript
 // Get all users from 42Lyon (handles pagination automatically)
-const lyonUsers = await client.getAll('campus/9/users');
+const lyonUsers = await client.getAll("campus/9/users");
 console.log(`42Lyon campus has ${lyonUsers.length} users`);
 
 // Get all projects with custom page size
-const allProjects = await client.getAll('projects', {
-  perPage: 50  // 50 items per page (default: 100)
+const allProjects = await client.getAll("projects", {
+	perPage: 50, // 50 items per page (default: 100)
 });
 ```
 
@@ -129,16 +126,16 @@ const allProjects = await client.getAll('projects', {
 
 ```typescript
 // 1. Get OAuth authorization URL
-const authUrl = client.getOAuthUrl('http://localhost:3000/callback');
+const { url: authUrl } = client.getOAuthUrl();
 // Redirect user to authUrl
 
 // 2. Exchange authorization code for tokens
-const tokens = await client.exchangeOAuthCode(code, 'http://localhost:3000/callback');
+const tokens = await client.exchangeOAuthCode(code, "http://localhost:3000/callback");
 // tokens contains: access_token, refresh_token, expires_in, etc.
 
 // 3. Use tokens for authenticated requests (USER-SPECIFIC DATA)
-const currentUser = await client.get('users/me', {
-  token: tokens
+const currentUser = await client.get("users/me", {
+	token: tokens,
 });
 console.log(`Welcome ${currentUser.displayname}!`);
 ```
@@ -147,12 +144,14 @@ console.log(`Welcome ${currentUser.displayname}!`);
 
 ```typescript
 // Set redirect URI in constructor
-const client = new IntraApiProxy('client_id', 'client_secret', {
-  redirect_uri: 'http://localhost:3000/callback'
+const client = new FortytwoIntraClient("client_id", "client_secret", {
+	redirect_uri: "http://localhost:3000/callback",
 });
 
 // Or pass it to getOAuthUrl
-const authUrl = client.getOAuthUrl('http://localhost:3000/callback');
+const { url: authUrl } = client.getOAuthUrl({
+	redirect_uri: "http://localhost:3000/callback",
+});
 ```
 
 ## Utility Methods
@@ -161,13 +160,13 @@ const authUrl = client.getOAuthUrl('http://localhost:3000/callback');
 
 ```typescript
 // Create a URL object for the API
-const userUrl = client.URL('users/jdoe');
+const userUrl = client.URL("users/jdoe");
 console.log(userUrl.toString()); // "https://api.intra.42.fr/v2/users/jdoe"
 
 // Build URLs for specific endpoints
-const campusUrl = client.URL('campus/1/users');
-const projectUrl = client.URL('projects/libft');
-const coalitionUrl = client.URL('coalitions/1/users');
+const campusUrl = client.URL("campus/1/users");
+const projectUrl = client.URL("projects/libft");
+const coalitionUrl = client.URL("coalitions/1/users");
 ```
 
 ## Error Handling
@@ -176,16 +175,16 @@ The library includes automatic retry logic for rate limiting (429) and authentic
 
 ```typescript
 try {
-  const user = await client.get('users/jdoe');
-  console.log(`Found user: ${user.displayname}`);
+	const user = await client.get("users/jdoe");
+	console.log(`Found user: ${user.displayname}`);
 } catch (error) {
-  if (error.status === 404) {
-    console.error('User not found');
-  } else if (error.status === 403) {
-    console.error('Access forbidden - check your token permissions');
-  } else {
-    console.error('Request failed after retries:', error.message);
-  }
+	if (error.statusCode === 404) {
+		console.error("User not found");
+	} else if (error.statusCode === 403) {
+		console.error("Access forbidden - check your token permissions");
+	} else {
+		console.error("Request failed after retries:", error.message);
+	}
 }
 ```
 
@@ -211,60 +210,60 @@ Disable logging by setting `logLine: false` in the configuration. Control error
 This library is written in TypeScript and includes full type definitions:
 
 ```typescript
-import { FortytwoIntraClient } from '@ibertran/fortytwo-intra-client';
+import { FortytwoIntraClient } from "@ibertran/fortytwo-intra-client";
 
 // Types are automatically inferred
-const client = new FortytwoIntraClient('client_id', 'client_secret');
+const client = new FortytwoIntraClient("client_id", "client_secret");
 ```
 
 ### OAuth Flow Example
 
 ```typescript
-import express from 'express';
-import { FortytwoIntraClient } from '@ibertran/fortytwo-intra-client';
+import express from "express";
+import { FortytwoIntraClient } from "@ibertran/fortytwo-intra-client";
 
 const app = express();
 const client = new FortytwoIntraClient(
-  process.env.INTRA_CLIENT_ID!,
-  process.env.INTRA_CLIENT_SECRET!,
-  { 
-    redirect_uri: 'http://localhost:3000/callback',
-    oauth_scope: ['public']
-  }
+	process.env.INTRA_CLIENT_ID!,
+	process.env.INTRA_CLIENT_SECRET!,
+	{
+		redirect_uri: "http://localhost:3000/callback",
+		scopes: ["public"],
+	},
 );
 
 // Redirect to 42 OAuth
-app.get('/login', (req, res) => {
-  const authUrl = client.getOAuthUrl();
-  res.redirect(authUrl);
+app.get("/login", (req, res) => {
+	const { url: authUrl } = client.getOAuthUrl();
+	res.redirect(authUrl);
 });
 
 // Handle OAuth callback
-app.get('/callback', async (req, res) => {
-  try {
-    const { code } = req.query;
-    const token = await client.exchangeOAuthCode(code as string);
-    
-    // Use tokens to make authenticated requests (accessing personal data)
-    const userData = await client.get('users/me', { token: token });
-        
-    res.json({ 
-      user: {
-        login: userData.login,
-        displayname: userData.displayname,
-        email: userData.email,
-        level: userData.cursus_users[0]?.level || 0,
-        wallet: userData.wallet,
-        campus: userData.campus[0]?.name
-      },
-    });
-  } catch (error) {
-    res.status(500).json({ error: error.message });
-  }
+app.get("/callback", async (req, res) => {
+	try {
+		const { code } = req.query;
+		const token = await client.exchangeOAuthCode(code as string);
+
+		// Use tokens to make authenticated requests (accessing personal data)
+		const userData = await client.get("users/me", { token: token });
+
+		res.json({
+			user: {
+				login: userData.login,
+				displayname: userData.displayname,
+				email: userData.email,
+				level: userData.cursus_users[0]?.level || 0,
+				wallet: userData.wallet,
+				campus: userData.campus[0]?.name,
+			},
+		});
+	} catch (error) {
+		res.status(500).json({ error: error.message });
+	}
 });
 
 app.listen(3000, () => {
-  console.log('Server running on http://localhost:3000');
-  console.log('Visit http://localhost:3000/login to start OAuth flow');
+	console.log("Server running on http://localhost:3000");
+	console.log("Visit http://localhost:3000/login to start OAuth flow");
 });
 ```

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 import { inputOptions } from "./types";
+import { FortytwoIntraClientError, isFortytwoIntraClientError } from "./lib/errors";
+import { z } from "zod";
 export interface FortytwoIntraClientConf {
     redirect_uri: string | null;
     base_url: string;
@@ -11,7 +13,6 @@ export interface FortytwoIntraClientConf {
     maxRetry: number;
     logLine: boolean;
     errLogBody: boolean;
-    throwOnError: boolean;
 }
 export declare class FortytwoIntraClient {
     private client_id;
@@ -29,7 +30,6 @@ export declare class FortytwoIntraClient {
     private maxRetry;
     private logLine;
     private errLogBody;
-    private throwOnError;
     private access_token;
     constructor(client_id: string, client_secret: string, conf: Partial<FortytwoIntraClientConf>);
     private generateToken;
@@ -38,19 +38,38 @@ export declare class FortytwoIntraClient {
     private logSuccess;
     private logError;
     get(endpoint: URL | string, options?: Omit<inputOptions, "body" | "perPage" | "maxPage">): Promise<any>;
+    get<S extends z.ZodType>(endpoint: URL | string, options: Omit<inputOptions, "body" | "perPage" | "maxPage"> & {
+        schema: S;
+    }): Promise<z.infer<S>>;
     post(endpoint: URL | string, options?: Omit<inputOptions, "perPage" | "maxPage">): Promise<any>;
+    post<S extends z.ZodType>(endpoint: URL | string, options: Omit<inputOptions, "perPage" | "maxPage"> & {
+        schema: S;
+    }): Promise<z.infer<S>>;
     put(endpoint: URL | string, options?: Omit<inputOptions, "perPage" | "maxPage">): Promise<any>;
+    put<S extends z.ZodType>(endpoint: URL | string, options: Omit<inputOptions, "perPage" | "maxPage"> & {
+        schema: S;
+    }): Promise<z.infer<S>>;
     patch(endpoint: URL | string, options?: Omit<inputOptions, "perPage" | "maxPage">): Promise<any>;
+    patch<S extends z.ZodType>(endpoint: URL | string, options: Omit<inputOptions, "perPage" | "maxPage"> & {
+        schema: S;
+    }): Promise<z.infer<S>>;
     delete(endpoint: URL | string, options?: Omit<inputOptions, "perPage" | "maxPage">): Promise<any>;
+    delete<S extends z.ZodType>(endpoint: URL | string, options: Omit<inputOptions, "perPage" | "maxPage"> & {
+        schema: S;
+    }): Promise<z.infer<S>>;
     getAll(endpoint: URL | string, options?: Omit<inputOptions, "body">): Promise<any>;
+    getAll<S extends z.ZodType>(endpoint: URL | string, options: Omit<inputOptions, "body"> & {
+        schema: S;
+    }): Promise<z.infer<S>>;
     URL(endpoint: string): URL;
     getOAuthUrl(options?: {
         redirect_uri?: string;
         state?: string;
     }): {
         url: string;
-        state: string;
+        state: string | null;
     };
     exchangeOAuthCode(code: string, redirect_uri?: string): Promise<any>;
     tokenInfos(options?: Omit<inputOptions, "body" | "perPage" | "maxPage">): Promise<any>;
 }
+export { FortytwoIntraClientError, isFortytwoIntraClientError };

package/dist/index.js

@@ -1,14 +1,49 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FortytwoIntraClient = void 0;
-const axios_1 = __importDefault(require("axios"));
+exports.isFortytwoIntraClientError = exports.FortytwoIntraClientError = exports.FortytwoIntraClient = void 0;
+const axios_1 = __importStar(require("axios"));
 const axios_rate_limit_1 = __importDefault(require("axios-rate-limit"));
 const pagination_1 = require("./lib/pagination");
 const logs_1 = require("./lib/logs");
-const crypto_1 = __importDefault(require("crypto"));
+const errors_1 = require("./lib/errors");
+Object.defineProperty(exports, "FortytwoIntraClientError", { enumerable: true, get: function () { return errors_1.FortytwoIntraClientError; } });
+Object.defineProperty(exports, "isFortytwoIntraClientError", { enumerable: true, get: function () { return errors_1.isFortytwoIntraClientError; } });
 const defaultConf = {
     redirect_uri: null,
     base_url: "https://api.intra.42.fr/v2/",
@@ -21,7 +56,6 @@ const defaultConf = {
     maxRetry: 5,
     logLine: true,
     errLogBody: true,
-    throwOnError: true,
 };
 class FortytwoIntraClient {
     client_id;
@@ -39,7 +73,6 @@ class FortytwoIntraClient {
     maxRetry;
     logLine;
     errLogBody;
-    throwOnError;
     access_token;
     constructor(client_id, client_secret, conf) {
         this.client_id = client_id;
@@ -63,7 +96,6 @@ class FortytwoIntraClient {
         this.maxRetry = config.maxRetry;
         this.logLine = config.logLine;
         this.errLogBody = config.errLogBody;
-        this.throwOnError = config.throwOnError;
         this.access_token = null;
     }
     async generateToken() {
@@ -112,7 +144,7 @@ class FortytwoIntraClient {
             return res;
         }
         catch (err) {
-            if (err.isAxiosError) {
+            if ((0, axios_1.isAxiosError)(err)) {
                 this.logError(err, options);
                 const { attempt, maxRetry } = options;
                 const status = err.response?.status;
@@ -124,8 +156,7 @@ class FortytwoIntraClient {
                     return this.reqHandler(url, options);
                 }
                 else {
-                    if (this.throwOnError)
-                        throw err;
+                    throw new errors_1.FortytwoIntraClientError(err);
                 }
             }
             else {
@@ -152,7 +183,6 @@ class FortytwoIntraClient {
             console.log(line, logBody ? body : "");
         }
     }
-    // Public methods
     async get(endpoint, options = {}) {
         if (endpoint instanceof URL === false) {
             endpoint = new URL(endpoint, this.base_url);
@@ -165,7 +195,10 @@ class FortytwoIntraClient {
             errLogBody: this.errLogBody,
             ...options,
         });
-        return res?.data;
+        if (options.schema) {
+            return options.schema.parse(res.data);
+        }
+        return res.data;
     }
     async post(endpoint, options = {}) {
         if (endpoint instanceof URL === false) {
@@ -179,7 +212,10 @@ class FortytwoIntraClient {
             errLogBody: this.errLogBody,
             ...options,
         });
-        return res?.data;
+        if (options.schema) {
+            return options.schema.parse(res.data);
+        }
+        return res.data;
     }
     async put(endpoint, options = {}) {
         if (endpoint instanceof URL === false) {
@@ -193,7 +229,10 @@ class FortytwoIntraClient {
             errLogBody: this.errLogBody,
             ...options,
         });
-        return res?.data;
+        if (options.schema) {
+            return options.schema.parse(res.data);
+        }
+        return res.data;
     }
     async patch(endpoint, options = {}) {
         if (endpoint instanceof URL === false) {
@@ -207,7 +246,10 @@ class FortytwoIntraClient {
             errLogBody: this.errLogBody,
             ...options,
         });
-        return res?.data;
+        if (options.schema) {
+            return options.schema.parse(res.data);
+        }
+        return res.data;
     }
     async delete(endpoint, options = {}) {
         if (endpoint instanceof URL === false) {
@@ -221,7 +263,10 @@ class FortytwoIntraClient {
             errLogBody: this.errLogBody,
             ...options,
         });
-        return res?.data;
+        if (options.schema) {
+            return options.schema.parse(res.data);
+        }
+        return res.data;
     }
     async getAll(endpoint, options = {}) {
         if (endpoint instanceof URL === false) {
@@ -229,7 +274,7 @@ class FortytwoIntraClient {
         }
         const perPage = options.perPage || 100;
         let url = new URL(endpoint);
-        const initialRes = await this.reqHandler(url, {
+        const firstPage = await this.reqHandler(url, {
             method: "GET",
             attempt: 0,
             currpage: 1,
@@ -244,50 +289,62 @@ class FortytwoIntraClient {
                 per_page: perPage,
             }
         });
+        if (!Array.isArray(firstPage.data)) {
+            if (options.schema) {
+                return options.schema.parse(firstPage.data);
+            }
+            return firstPage.data;
+        }
         let lastPage;
         try {
-            lastPage = Math.min((0, pagination_1.getLastPage)(initialRes.headers["link"]), options.maxPages || Infinity);
+            lastPage = Math.min((0, pagination_1.getLastPage)(firstPage.headers["link"]), options.maxPages || Infinity);
         }
         catch (err) {
-            return initialRes?.data;
+            if (options.schema) {
+                return options.schema.parse(firstPage.data);
+            }
+            return firstPage.data;
         }
-        const promises = [];
-        for (let i = 2; i <= lastPage; i++) {
-            url = new URL(endpoint);
-            promises.push(this.reqHandler(url, {
-                method: "GET",
-                attempt: 0,
-                currpage: i,
-                lastPage: lastPage,
-                maxRetry: this.maxRetry,
-                logLine: this.logLine,
-                errLogBody: this.errLogBody,
-                ...options,
-                query: {
-                    ...options.query,
-                    page: i,
-                    per_page: perPage,
-                }
-            }));
+        const promises = Array.from({ length: lastPage - 1 }, (_, i) => i + 2)
+            .map(pageNumber => this.reqHandler(url, {
+            method: "GET",
+            attempt: 0,
+            currpage: pageNumber,
+            lastPage: lastPage,
+            maxRetry: this.maxRetry,
+            logLine: this.logLine,
+            errLogBody: this.errLogBody,
+            ...options,
+            query: {
+                ...options.query,
+                page: pageNumber,
+                per_page: perPage,
+            }
+        }));
+        const otherPages = await Promise.all(promises);
+        const allData = [...firstPage.data, ...otherPages.flatMap((res) => res.data)];
+        if (options.schema) {
+            return options.schema.parse(allData);
         }
-        return Promise.all(promises).then((values) => {
-            return initialRes?.data.concat(...values.map((value) => value.data));
-        });
+        return allData;
     }
     URL(endpoint) {
         return new URL(endpoint, this.base_url);
     }
     getOAuthUrl(options = {}) {
         const redirectUri = options.redirect_uri || this.redirect_uri;
-        if (!redirectUri)
+        if (!redirectUri) {
             throw new Error(`Missing redirect_uri parameter`);
-        const state = options.state || crypto_1.default.randomBytes(32).toString('base64url');
+        }
         const url = new URL(this.oauth_url);
         url.searchParams.set("client_id", this.client_id);
         url.searchParams.set("redirect_uri", redirectUri);
         url.searchParams.set("response_type", "code");
         url.searchParams.set("scope", this.scopes.join(" "));
-        url.searchParams.set("state", state);
+        const state = options.state ?? null;
+        if (state !== null) {
+            url.searchParams.set("state", state);
+        }
         return { url: url.toString(), state };
     }
     async exchangeOAuthCode(code, redirect_uri) {
@@ -298,7 +355,7 @@ class FortytwoIntraClient {
             redirect_uri: redirect_uri ? redirect_uri : this.redirect_uri,
             code: code,
         });
-        return res?.data;
+        return res.data;
     }
     async tokenInfos(options = {}) {
         return this.get(this.token_info_url, options);

package/dist/lib/errors.d.ts

@@ -0,0 +1,8 @@
+import { AxiosError } from "axios";
+export declare class FortytwoIntraClientError extends Error {
+    statusCode: number;
+    statusText: string;
+    data: unknown;
+    constructor(error: AxiosError);
+}
+export declare function isFortytwoIntraClientError(error: unknown): error is FortytwoIntraClientError;

package/dist/lib/errors.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FortytwoIntraClientError = void 0;
+exports.isFortytwoIntraClientError = isFortytwoIntraClientError;
+class FortytwoIntraClientError extends Error {
+    statusCode;
+    statusText;
+    data;
+    constructor(error) {
+        const method = error.config?.method?.toUpperCase() ?? null;
+        const route = error.config?.url ?? null;
+        const statusCode = error.response?.status ?? NaN;
+        const statusText = error.response?.statusText ?? "Unknown";
+        const message = method && route
+            ? `${method} ${route} - HTTP ${statusCode} ${statusText}`
+            : error.message;
+        super(message);
+        this.name = "FortytwoIntraClientError";
+        this.statusCode = statusCode;
+        this.statusText = statusText;
+        this.data = error.response?.data;
+    }
+}
+exports.FortytwoIntraClientError = FortytwoIntraClientError;
+function isFortytwoIntraClientError(error) {
+    return error instanceof FortytwoIntraClientError;
+}

package/dist/lib/logs.js

@@ -5,7 +5,6 @@ exports.getErrorLogLine = getErrorLogLine;
 const util_1 = require("util");
 const green = "\x1b[42m";
 const red = "\x1b[41m";
-const yellow = "\x1b[43m";
 const reset = "\x1b[0m";
 function formatQueryParams(params) {
     const { per_page, page, ...filteredParams } = params;

package/package.json

@@ -1,26 +1,31 @@
 {
-  "name": "@ibertran/fortytwo-intra-client",
-  "version": "3.1.4",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "author": {
-    "name": "Ian BERTRAND"
-  },
-  "scripts": {
-    "build": "tsc"
-  },
-  "dependencies": {
-    "axios": "^1.6.2",
-    "axios-rate-limit": "^1.3.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.9.3",
-    "ts-node": "^10.9.2",
-    "dotenv": "^16.6.1",
-    "express": "^4.18.2"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ]
+	"name": "@ibertran/fortytwo-intra-client",
+	"version": "4.0.0",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"author": {
+		"name": "Ian BERTRAND"
+	},
+	"scripts": {
+		"build": "tsc",
+		"format": "prettier --write .",
+		"prettier": "prettier --check ."
+	},
+	"dependencies": {
+		"axios": "^1.15.2",
+		"axios-rate-limit": "^1.9.0",
+		"zod": "^4.3.6"
+	},
+	"devDependencies": {
+		"@types/node": "^25.6.0",
+		"dotenv": "^17.4.2",
+		"express": "^5.2.1",
+		"prettier": "^3.8.3",
+		"ts-node": "^10.9.2",
+		"typescript": "^6.0.3"
+	},
+	"files": [
+		"dist",
+		"README.md"
+	]
 }

package/dist/HttpError.d.ts

@@ -1,9 +0,0 @@
-declare class HttpError extends Error {
-    status: number | null;
-    url: string | null;
-    details: any;
-    constructor(err: any);
-}
-export declare function simplifySuperagentError(err: any): HttpError;
-export declare function isSuperAgentError(err: any): boolean;
-export {};

package/dist/HttpError.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.simplifySuperagentError = simplifySuperagentError;
-exports.isSuperAgentError = isSuperAgentError;
-class HttpError extends Error {
-    status;
-    url;
-    details;
-    constructor(err) {
-        super(err.message || "Unknown API error");
-        this.name = "HttpError";
-        this.status = err.status || null;
-        this.url = err.response?.request?.url || null;
-        this.details = err.response?.body || null;
-    }
-}
-function simplifySuperagentError(err) {
-    if (!err) {
-        return new HttpError({ message: "Unknown error" });
-    }
-    return new HttpError(err);
-}
-function isSuperAgentError(err) {
-    return (err && typeof err === "object" && ("status" in err || "response" in err));
-}

package/dist/utils.d.ts

@@ -1,4 +0,0 @@
-import * as superagent from "superagent";
-import { Method } from "./types";
-export declare function initRequest(method: Method, url: URL): superagent.Request;
-export declare function getLastPage(header: string | undefined): number;

package/dist/utils.js

@@ -1,79 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.initRequest = initRequest;
-exports.getLastPage = getLastPage;
-const superagent = __importStar(require("superagent"));
-function initRequest(method, url) {
-    const endpoint = url.toString();
-    switch (method) {
-        case "GET":
-            return superagent.get(endpoint);
-        case "POST":
-            return superagent.post(endpoint);
-        case "PATCH":
-            return superagent.patch(endpoint);
-        case "DELETE":
-            return superagent.delete(endpoint);
-        default:
-            throw Error("Invalid HTTP method");
-    }
-}
-function getLastPage(header) {
-    if (!header) {
-        throw Error("No pagination link header");
-    }
-    const paginationlinks = header
-        .split(",")
-        .reduce((links, part) => {
-        const match = part.match(/<([^>]+)>\s*;\s*rel="([^"]+)"/);
-        if (match) {
-            const url = match[1];
-            const rel = match[2];
-            links[rel] = url;
-        }
-        return links;
-    }, {});
-    if (!paginationlinks.last) {
-        throw Error("Missing last page link");
-    }
-    const lastPageUrl = new URL(paginationlinks.last);
-    const rawLastPage = lastPageUrl.searchParams.get("page");
-    const lastPage = rawLastPage ? parseInt(rawLastPage, 10) : undefined;
-    if (!lastPage || isNaN(lastPage)) {
-        throw Error("Invalid last page link");
-    }
-    return lastPage;
-}