@djust-b2b/djust-front-sdk 3.0.0-beta.9 → 3.0.0

package/lib/services/auth/__mocks__/auth.mocks.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * Mocks centralisés pour les tests du module auth
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mockHttpErrors = exports.mockErrors = exports.mockResponses = exports.mockParameters = exports.mockAuthResponses = exports.mockUsers = exports.mockTokens = void 0;
+// Mock data pour les tokens
+exports.mockTokens = {
+    validToken: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
+    invalidToken: "invalid_token_123",
+    refreshToken: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
+    resetPasswordToken: "reset_password_token_123",
+};
+// Mock data pour les utilisateurs
+exports.mockUsers = {
+    validUser: {
+        username: "test@example.com",
+        password: "password123",
+    },
+    invalidUser: {
+        username: "invalid@example.com",
+        password: "wrongpassword",
+    },
+};
+// Mock data pour les réponses d'authentification
+exports.mockAuthResponses = {
+    loginSuccess: {
+        token: {
+            accessToken: "new_access_token_123",
+            expireAt: 1735689600000, // 2025-01-01
+            refreshToken: "new_refresh_token_123",
+        },
+        user: {
+            id: "user_123",
+        },
+    },
+    refreshTokenSuccess: {
+        token: {
+            accessToken: "refreshed_access_token_456",
+            expireAt: 1735689600000, // 2025-01-01
+            refreshToken: "new_refresh_token_456",
+        },
+        user: {
+            id: "user_123",
+        },
+    },
+};
+// Mock data pour les paramètres de test
+exports.mockParameters = {
+    isTokenValid: {
+        valid: { token: exports.mockTokens.validToken },
+        invalid: { token: exports.mockTokens.invalidToken },
+    },
+    refreshToken: {
+        valid: { refreshToken: exports.mockTokens.refreshToken },
+    },
+    resetPassword: {
+        valid: {
+            newPassword: "newSecurePassword2025!",
+            resetPasswordToken: exports.mockTokens.resetPasswordToken,
+        },
+    },
+    sendResetPasswordEmail: {
+        valid: { email: "user@example.com" },
+        invalid: { email: "invalid-email" },
+    },
+    login: {
+        valid: {
+            username: exports.mockUsers.validUser.username,
+            password: exports.mockUsers.validUser.password,
+        },
+        withUserFalse: {
+            username: exports.mockUsers.validUser.username,
+            password: exports.mockUsers.validUser.password,
+            withUser: false,
+        },
+        invalid: {
+            username: exports.mockUsers.invalidUser.username,
+            password: exports.mockUsers.invalidUser.password,
+        },
+    },
+    getStore: {
+        valid: { storeId: "store_123" },
+    },
+};
+// Mock Headers pour les tests
+const createMockHeaders = () => {
+    const headers = new Headers();
+    headers.append("Content-Type", "application/json");
+    headers.append("dj-client", "test-client");
+    headers.append("dj-api-key", "test-api-key");
+    return headers;
+};
+// Mock data pour les réponses des endpoints
+exports.mockResponses = {
+    isTokenValid: {
+        success: {
+            data: true,
+            headers: createMockHeaders(),
+            status: 200,
+        },
+        failure: {
+            data: false,
+            headers: createMockHeaders(),
+            status: 200,
+        },
+    },
+    refreshToken: {
+        success: {
+            data: exports.mockAuthResponses.refreshTokenSuccess,
+            headers: createMockHeaders(),
+            status: 200,
+        },
+    },
+    resetPassword: {
+        success: {
+            data: undefined,
+            headers: createMockHeaders(),
+            status: 200,
+        },
+    },
+    sendResetPasswordEmail: {
+        success: {
+            data: undefined,
+            headers: createMockHeaders(),
+            status: 200,
+        },
+    },
+    login: {
+        success: {
+            data: exports.mockAuthResponses.loginSuccess,
+            headers: createMockHeaders(),
+            status: 200,
+        },
+        withUserFalse: {
+            data: exports.mockAuthResponses.loginSuccess,
+            headers: createMockHeaders(),
+            status: 200,
+        },
+    },
+    logout: {
+        success: {
+            data: undefined,
+            headers: createMockHeaders(),
+            status: 200,
+        },
+    },
+    getSettings: {
+        success: {
+            data: {
+                manualAccountCheck: true,
+            },
+            headers: createMockHeaders(),
+            status: 200,
+        },
+    },
+    getStore: {
+        success: {
+            data: {
+                active: true,
+                customFieldValues: [
+                    {
+                        customField: {
+                            externalId: "field_1",
+                            externalSource: "manual",
+                            faceted: false,
+                            id: "cf_1",
+                            indexable: true,
+                            mandatory: false,
+                            name: { fr: "Champ personnalisé", en: "Custom field" },
+                            role: "store",
+                            sealedTarget: "store",
+                            searchable: true,
+                            sortable: true,
+                            status: "active",
+                        },
+                        value: { fr: "Valeur test", en: "Test value" },
+                    },
+                ],
+                description: "Description du magasin",
+                externalId: "store_ext_123",
+                id: "store_123",
+                name: "Mon Magasin",
+                storeLocales: [
+                    {
+                        active: true,
+                        code: "fr",
+                        id: "locale_fr",
+                        label: "Français",
+                        main: true,
+                    },
+                    {
+                        active: true,
+                        code: "en",
+                        id: "locale_en",
+                        label: "English",
+                        main: false,
+                    },
+                ],
+            },
+            headers: createMockHeaders(),
+            status: 200,
+        },
+    },
+};
+// Mock data pour les erreurs
+exports.mockErrors = {
+    networkError: new Error("Network error"),
+    unauthorized: new Error("Unauthorized"),
+    badRequest: new Error("Bad request"),
+    notFound: new Error("Not found"),
+    serverError: new Error("Internal server error"),
+};
+// Mock data pour les cas d'erreur HTTP
+exports.mockHttpErrors = {
+    400: { status: 400, message: "Bad Request" },
+    401: { status: 401, message: "Unauthorized" },
+    404: { status: 404, message: "Not Found" },
+    500: { status: 500, message: "Internal Server Error" },
+};
+//# sourceMappingURL=auth.mocks.js.map

package/lib/services/auth/__mocks__/auth.mocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.mocks.js","sourceRoot":"","sources":["../../../../src/services/auth/__mocks__/auth.mocks.ts"],"names":[],"mappings":"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"}

package/lib/services/auth/auth.service.d.ts

@@ -0,0 +1,286 @@
+/**
+ * # Auth Service
+ *
+ * This module provides all functionalities related to user authentication and authorization.
+ *
+ * ## Features:
+ * - Validate tokens
+ * - Refresh tokens
+ * - Reset user passwords
+ * - Manage user login and logout
+ * - Send password reset emails
+ * - Retrieve shop settings and store information
+ *
+ * Each method is described with its input parameters, output responses, and example usages.
+ *
+ * @module services/auth
+ * @since 2.17.0
+ */
+import { BaseService } from "../base.service";
+import type { RequestContext } from "../../client/transport";
+import type { IsTokenValidParams, RefreshTokenParams, ResetPasswordParams, SendResetPasswordEmailParams, LoginParams, GetStoreParams, RefreshTokenResponse, LoginResponse, SettingsResponse, Store } from "./types";
+/**
+ * Service for authentication and authorization operations.
+ *
+ * Provides methods for:
+ * - 🔐 User login/logout
+ * - 🔄 Token validation and refresh
+ * - 🔑 Password reset
+ * - ⚙️ Shop settings and store information
+ *
+ * @example
+ * ```typescript
+ * import { createDjustClient } from '@djust-b2b/djust-front-sdk';
+ *
+ * const client = createDjustClient({
+ *   baseUrl: 'https://api.djust.io',
+ *   clientId: 'your-client-id',
+ *   apiKey: 'your-api-key',
+ * });
+ *
+ * // Login
+ * const { token, user } = await client.auth.login({
+ *   username: 'user@example.com',
+ *   password: 'password123',
+ * });
+ *
+ * // Validate token
+ * const isValid = await client.auth.isTokenValid({ token: token.accessToken });
+ * ```
+ */
+export declare class AuthService extends BaseService {
+    readonly serviceName = "auth";
+    /**
+     * 🔐 Validates if a token is still active and unexpired.
+     *
+     * This method checks whether the provided token is valid, ensuring it has not expired or been invalidated.
+     *
+     * 🛠 **Endpoint**: `GET /auth/is-token-valid [TOK-200]`
+     *
+     * | Parameter | Type     | Required | Description                         |
+     * |-----------|----------|----------|-------------------------------------|
+     * | `token`   | `string` | ✅       | The token to validate.              |
+     *
+     * 📤 **Returns**:
+     * A `Promise<boolean>` resolving to `true` if the token is valid and active, or `false` otherwise.
+     *
+     * @example
+     * ```typescript
+     * const isValid = await client.auth.isTokenValid({
+     *   token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+     * });
+     * console.log(isValid); // true
+     * ```
+     *
+     * @param params - The parameters for validating the token.
+     * @param context - Optional request context for SSR.
+     * @throws {ValidationError} If the required `token` parameter is missing.
+     * @returns A promise that resolves to a boolean indicating whether the token is valid.
+     */
+    isTokenValid(params: IsTokenValidParams, context?: RequestContext): Promise<boolean>;
+    /**
+     * 🔄 Requests a new access token using a refresh token.
+     *
+     * This method allows you to obtain a new access token by providing a valid refresh token.
+     *
+     * 🛠 **Endpoint**: `POST /auth/refresh-token [AUTH-102]`
+     *
+     * | Parameter       | Type     | Required | Description                                      |
+     * |-----------------|----------|----------|--------------------------------------------------|
+     * | `refreshToken`  | `string` | ✅       | The refresh token used to request a new access token. |
+     *
+     * 📤 **Returns**:
+     * A `Promise<RefreshTokenResponse>` containing the new access token, its expiry time, and a refreshed token.
+     *
+     * @example
+     * ```typescript
+     * const response = await client.auth.refreshToken({
+     *   refreshToken: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+     * });
+     * console.log(response.token.accessToken);
+     * console.log(response.token.expiresAt);
+     * ```
+     *
+     * @param params - The parameters for requesting a new token.
+     * @param context - Optional request context for SSR.
+     * @throws {ValidationError} If the required `refreshToken` parameter is missing.
+     * @returns A promise that resolves to the response containing the new token and user details.
+     */
+    refreshToken(params: RefreshTokenParams, context?: RequestContext): Promise<RefreshTokenResponse>;
+    /**
+     * 🔑 Resets the password of a user.
+     *
+     * This method allows a user to reset their password by providing a new password along with a valid reset token.
+     *
+     * 🛠 **Endpoint**: `POST /auth/reset-password [PWD-102]`
+     *
+     * | Parameter             | Type     | Required | Description                                                  |
+     * |-----------------------|----------|----------|--------------------------------------------------------------|
+     * | `newPassword`         | `string` | ✅       | The new password to set for the user.                        |
+     * | `resetPasswordToken`  | `string` | ✅       | The token required to authenticate the password reset process. |
+     *
+     * 📤 **Returns**:
+     * A `Promise<void>` that resolves when the password is successfully reset.
+     *
+     * @example
+     * ```typescript
+     * await client.auth.resetPassword({
+     *   newPassword: "mySecurePassword2025!",
+     *   resetPasswordToken: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+     * });
+     * ```
+     *
+     * @param params - The parameters required for resetting the password.
+     * @param context - Optional request context for SSR.
+     * @throws {ValidationError} If the required parameters `newPassword` or `resetPasswordToken` are missing.
+     */
+    resetPassword(params: ResetPasswordParams, context?: RequestContext): Promise<void>;
+    /**
+     * 📧 Sends a reset password email to a user.
+     *
+     * This method sends an email containing a reset password link to the specified email address.
+     *
+     * 🛠 **Endpoint**: `POST /auth/send-reset-password-email [PWD-101]`
+     *
+     * | Parameter     | Type     | Required | Description                                        |
+     * |---------------|----------|----------|----------------------------------------------------|
+     * | `email`       | `string` | ✅       | The email address to which the reset link will be sent. |
+     * | `redirectUrl` | `string` | ❌       | Optional URL to redirect after password reset.     |
+     *
+     * 📤 **Returns**:
+     * A `Promise<void>` that resolves when the reset password email is successfully sent.
+     *
+     * @example
+     * ```typescript
+     * await client.auth.sendResetPasswordEmail({
+     *   email: "user@example.com",
+     *   redirectUrl: "https://myapp.com/reset-password",
+     * });
+     * ```
+     *
+     * @param params - The parameters required to send the reset password email.
+     * @param context - Optional request context for SSR.
+     * @throws {ValidationError} If the required parameter `email` is missing.
+     */
+    sendResetPasswordEmail(params: SendResetPasswordEmailParams, context?: RequestContext): Promise<void>;
+    /**
+     * 🔐 Logs in a user.
+     *
+     * This method allows a user to log in by providing their username and password,
+     * and returns their login information, including an access token and user details.
+     *
+     * 🛠 **Endpoint**: `POST /auth/token?withUser=true [AUTH-101]`
+     *
+     * | Parameter   | Type      | Required | Description                          |
+     * |-------------|-----------|----------|--------------------------------------|
+     * | `username`  | `string`  | ✅       | The username of the user to log in.  |
+     * | `password`  | `string`  | ✅       | The password of the user to log in.  |
+     * | `withUser`  | `boolean` | ❌       | Whether to include user details in the response. Default: `true` |
+     *
+     * 📤 **Returns**:
+     * A `Promise<LoginResponse>` that resolves to the user's login information, including:
+     * - `token` (object): Contains the `accessToken`, `refreshToken`, and `expireAt` timestamp.
+     * - `user` (object): Contains the user's `id` and details (if `withUser` is true).
+     *
+     * @example
+     * ```typescript
+     * const loginResponse = await client.auth.login({
+     *   username: "user@example.com",
+     *   password: "password123",
+     * });
+     *
+     * console.log(loginResponse.token.accessToken);
+     * console.log(loginResponse.user.id);
+     * ```
+     *
+     * @param params - The parameters required for logging in the user.
+     * @param context - Optional request context for SSR.
+     * @throws {ValidationError} If the required parameters `username` or `password` are missing.
+     * @throws {AuthError} If credentials are invalid.
+     * @returns Resolves to an object containing the user's login information.
+     */
+    login(params: LoginParams, context?: RequestContext): Promise<LoginResponse>;
+    /**
+     * 🚪 Logs out the user.
+     *
+     * This method logs out the user by revoking their authentication token.
+     *
+     * 🛠 **Endpoint**: `POST /auth/revoke-token [AUTH-103]`
+     *
+     * | Parameter | Type | Required | Description |
+     * |-----------|------|----------|-------------|
+     * | *(none)*  | -    | -        | This method does not require any parameters. |
+     *
+     * 📤 **Returns**:
+     * A `Promise<void>` that resolves when the user is successfully logged out.
+     *
+     * @example
+     * ```typescript
+     * await client.auth.logout();
+     * // User is now logged out, token is revoked
+     * ```
+     *
+     * @param context - Optional request context for SSR.
+     * @throws {NetworkError} If there is an issue with the logout process.
+     */
+    logout(context?: RequestContext): Promise<void>;
+    /**
+     * ⚙️ Retrieves shop settings.
+     *
+     * This method retrieves the global configuration settings for the shop.
+     *
+     * 🛠 **Endpoint**: `GET /v1/shop/settings [SETTINGS-500]`
+     *
+     * 📤 **Returns**:
+     * A `Promise<SettingsResponse>` containing the shop settings, including:
+     * - `manualAccountCheck` (boolean): Indicates if manual account verification is enabled.
+     *
+     * @example
+     * ```typescript
+     * const settings = await client.auth.getSettings();
+     * console.log(settings.manualAccountCheck); // true
+     * ```
+     *
+     * @param context - Optional request context for SSR.
+     * @returns A promise that resolves with the shop settings.
+     */
+    getSettings(context?: RequestContext): Promise<SettingsResponse>;
+    /**
+     * 🏪 Retrieves store information.
+     *
+     * This method retrieves detailed information about a specific store by its identifier.
+     *
+     * 🛠 **Endpoint**: `GET /v1/shop/stores/{storeId} [STORE-500]`
+     *
+     * | Parameter  | Type     | Required | Description                          |
+     * |------------|----------|----------|--------------------------------------|
+     * | `storeId`  | `string` | ✅       | The unique identifier of the store.  |
+     *
+     * 📤 **Returns**:
+     * A `Promise<Store>` containing detailed store information, including:
+     * - `active`: Store activation status
+     * - `customFieldValues`: Custom field values
+     * - `description`: Store description
+     * - `externalId`: External identifier
+     * - `id`: Internal identifier
+     * - `name`: Store name
+     * - `storeLocales`: Localization information
+     *
+     * @example
+     * ```typescript
+     * const store = await client.auth.getStore({
+     *   storeId: "123e4567-e89b-12d3-a456-426614174000"
+     * });
+     * console.log(store.name); // "My Store"
+     * console.log(store.active); // true
+     * ```
+     *
+     * @param params - The parameters to retrieve the store.
+     * @param context - Optional request context for SSR.
+     * @throws {ValidationError} If the `storeId` parameter is missing.
+     * @throws {NotFoundError} If the store is not found.
+     * @returns A promise that resolves with the store information.
+     */
+    getStore(params: GetStoreParams, context?: RequestContext): Promise<Store>;
+}
+//# sourceMappingURL=auth.service.d.ts.map

package/lib/services/auth/auth.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.service.d.ts","sourceRoot":"","sources":["../../../src/services/auth/auth.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,4BAA4B,EAC5B,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,KAAK,EACN,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C,QAAQ,CAAC,WAAW,UAAU;IAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,YAAY,CAChB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAanB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,YAAY,CAChB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,oBAAoB,CAAC;IA2ChC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,aAAa,CACjB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAgBhB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,sBAAsB,CAC1B,MAAM,EAAE,4BAA4B,EACpC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAgBhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,KAAK,CACT,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC;IA0CzB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCrD;;;;;;;;;;;;;;;;;;;OAmBG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,QAAQ,CACZ,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,CAAC;CAWlB"}