@djust-b2b/djust-front-sdk 1.15.0 → 1.16.0

package/lib/index.d.ts

@@ -88,13 +88,13 @@ export declare const DjustSDK: {
     getProductVariantSuppliers({ productVariantId, }: import("./interfaces").GetProductVariantSuppliersParameters): Promise<import("./interfaces").GetProductVariantSuppliersResponse>;
     getProduct({ productIdentifier, productIdType, locale, }: import("./interfaces").GetProductParameters): Promise<import("./interfaces").GetProductsListResponse>;
     getProductOffers({ productIdentifier, productIdType, locale, currency, }: import("./interfaces").GetProductOffersParameters): Promise<import("./interfaces").GetProductOffersResponse>;
-    getProductPaginatedOffers({ productIdentifier, productIdType, currency, locale, withoutPrices, pageable, }: import("./interfaces").GetProductPaginatedOffersParameters): Promise<import("./interfaces").GetProductPaginatedOffersResponse>;
-    getRelatedProducts({ productIdentifier, productIdType, locale, currency, pageable, }: import("./interfaces").GetRelatedProductsParameters): Promise<import("./interfaces").GetRelatedProductsResponse>;
+    getRelatedProducts({ productIdentifier, productIdType, locale, currency, pageable, }: import("./interfaces").GetRelatedProductsParameters): Promise<import("./interfaces").GetRelatedProductsParameters>;
     getProductReviews({ productIdentifier, productIdType, }: import("./interfaces").GetProductReviewsParameters): Promise<import("./interfaces").GetProductReviewsResponse>;
     getProductStatReviews({ productIdentifier, productIdType, }: import("./interfaces").GetProductStatReviewsParameters): Promise<import("./interfaces").GetProductStatReviewsResponse>;
     getProductVariantAttributes({ productIdentifier, productIdType, locale, }: import("./interfaces").GetProductVariantAttributesParameters): Promise<import("./interfaces").GetProductVariantAttributesResponse>;
     createProductReview({ message, productSku, rating, }: import("./interfaces").CreateProductReviewParameters): Promise<import("./interfaces").CreateProductReviewResponse>;
     updateProductReview({ productReviewId, message, rating, }: import("./interfaces").UpdateProductReviewParameters): Promise<import("./interfaces").UpdateProductReviewResponse>;
+    getProductPaginatedOffers({ productIdentifier, productIdType, currency, locale, withoutPrices, pageable, }: import("./interfaces").GetProductPaginatedOffersParameters): Promise<import("./interfaces").GetProductPaginatedOffersResponse>;
     getNavigationCategories({ locale, }: import("./interfaces").GetNavigationCategoriesParameters): Promise<import("./interfaces").GetNavigationCategoriesResponse>;
     getNavigationCategory({ locale, idType, navigationCategoryId, }: import("./interfaces").GetNavigationCategoryParameters): Promise<import("./interfaces").GetNavigationCategoryResponse>;
     getNavigationCategoryBreadcrumbs({ locale, idType, navigationCategoryId, }: import("./interfaces").GetNavigationCategoryBreadcrumbsParameters): Promise<import("./interfaces").GetNavigationCategoryBreadcrumbsResponse>;
@@ -142,11 +142,11 @@ export declare const DjustSDK: {
     deleteBuyingList({ buyingListId, }: import("./interfaces").DeleteBuyingListParameters): Promise<void>;
     deleteBuyingListItems({ buyingListId, itemIds, }: import("./interfaces").DeleteBuyingListItemsParameters): Promise<void>;
     updateBuyingListOwner({ buyingListId, newOwnerEmail, }: import("./interfaces").UpdateBuyingListOwnerParameters): Promise<void>;
-    isTokenValid({ token, }: import("./interfaces").IsTokenValidParameters): Promise<boolean>;
-    refreshToken({ refreshToken, }: import("./interfaces").RefreshTokenParameters): Promise<import("./interfaces").RefreshTokenResponse>;
-    resetPassword({ newPassword, resetPasswordToken, }: import("./interfaces").ResetPasswordParameters): Promise<void>;
-    sendResetPasswordEmail({ email, }: import("./interfaces").SendResetPasswordEmailParameters): Promise<void>;
-    login({ username, password, }: import("./interfaces").LoginParameters): Promise<import("./interfaces").LoginResponse>;
+    isTokenValid({ token, }: import("./services/auth/definitions.requests").IsTokenValidParameters): Promise<boolean>;
+    refreshToken({ refreshToken, }: import("./services/auth/definitions.requests").RefreshTokenParameters): Promise<import("./interfaces").RefreshTokenResponse>;
+    resetPassword({ newPassword, resetPasswordToken, }: import("./services/auth/definitions.requests").ResetPasswordParameters): Promise<void>;
+    sendResetPasswordEmail({ email, }: import("./services/auth/definitions.requests").SendResetPasswordEmailParameters): Promise<void>;
+    login({ username, password, }: import("./services/auth/definitions.requests").LoginParameters): Promise<import("./interfaces").LoginResponse>;
     logout(): Promise<void>;
 };
 export * from "./interfaces";

package/lib/services/auth/definitions.requests.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Request parameters type definitions
+ */
+export interface IsTokenValidParameters {
+    token: string;
+}
+export interface RefreshTokenParameters {
+    refreshToken: string;
+}
+export interface ResetPasswordParameters {
+    newPassword: string;
+    resetPasswordToken: string;
+}
+export interface SendResetPasswordEmailParameters {
+    email: string;
+    redirectUrl: string;
+}
+export interface LoginParameters {
+    username: string;
+    password: string;
+}

package/lib/services/auth/definitions.requests.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,150 +1,176 @@
 /**
- * @packageDocumentation
+ * # Auth Service
  *
- * @document documents/auth.md
- */
-import { IsTokenValidParameters, LoginParameters, LoginResponse, RefreshTokenParameters, RefreshTokenResponse, ResetPasswordParameters, SendResetPasswordEmailParameters } from "./definitions";
-/**
- * CART ENDPOINT
+ * 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
+ *
+ * Each function is described with its input parameters, output responses, and example usages.
  */
+import { LoginResponse, RefreshTokenResponse } from "./definitions";
+import { IsTokenValidParameters, LoginParameters, RefreshTokenParameters, ResetPasswordParameters, SendResetPasswordEmailParameters } from "./definitions.requests";
 /**
- * ##R eturns true if the token is valid and not expired, false otherwise
- * ### APICODE(TOK-200)
- * @param {IsTokenValidParameters} params - The parameters for the function
- * #### token - `string` | <strong style={{ color: 'red' }}>required</strong>
- * The token to validate.
- *
- * @returns {Promise<boolean>} - A promise that resolves to a boolean indicating whether the token is valid or not
- *
- * @example
- * #### input
- * ```typescript
- * const isValidToken = await isTokenValid({
- *  token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
+ * 🔐 Validates if a token is still active and unexpired.
+ *
+ * This function 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 usage**:
+ * ```ts
+ * const isValid = await isTokenValid({
+ *   token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
  * });
+ * console.log(isValid); // true
  * ```
- * #### output
- * ```json
- * true
- * ```
+ *
+ * @param {IsTokenValidParameters} params - The parameters for validating the token.
+ * @throws {Error} If the required `token` parameter is missing.
+ * @returns {Promise<boolean>} A promise that resolves to a boolean indicating whether the token is valid.
  */
 export declare function isTokenValid({ token, }: IsTokenValidParameters): Promise<boolean>;
 /**
- * ## Ask for a new token from a refresh token
- * ### APICODE(AUTH-102)
- * @param {RefreshTokenParameters} params - The parameters for the function, including:
- * #### refreshToken - `string` | <strong style={{ color: 'red' }}>required</strong>
- * The refresh token to request a new access token (required)
- *
- * @returns {Promise<RefreshTokenResponse>} - A promise that resolves to the response containing the new token
- *
- * @example
- * #### input
- * ```typescript
- * const response = await refreshToken({ refreshToken: 'string' });
- * ```
- * #### output
- * ```json
- *   {
- *     "token": {
- *       "accessToken": "string",
- *       "expireAt": 0,
- *       "refreshToken": "string"
- *     },
- *     "user": {
- *       "id": "userID"
- *     }
- *   }
+ * 🔄 Requests a new access token using a refresh token.
+ *
+ * This function 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 usage**:
+ * ```ts
+ * const response = await refreshToken({
+ *   refreshToken: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+ * });
  * ```
+ *
+ * @param {RefreshTokenParameters} params - The parameters for requesting a new token.
+ * @throws {Error} If the required `refreshToken` parameter is missing.
+ * @returns {Promise<RefreshTokenResponse>} A promise that resolves to the response containing the new token and user details.
  */
 export declare function refreshToken({ refreshToken, }: RefreshTokenParameters): Promise<RefreshTokenResponse>;
 /**
- * ## Reset the password of a user
- * ### APICODE(PWD-102)
- * @param {ResetPasswordParameters} params - The parameters for the function
- * #### newPassword - `string` | <strong style={{ color: 'red' }}>required</strong>
- * The new password to set for the user.
- * #### resetPasswordToken - `string` | <strong style={{ color: 'red' }}>required</strong>
- * The token required to authenticate the password reset process.
- *
- * @returns {Promise<void>} - Resolves to a success message `"OK"` when the password is successfully reset
- *
- * @example
- * #### input
- * ```typescript
- *    await resetPassword({ newPassword: 'string', resetPasswordToken: 'string' });
- * ```
- * #### output
- * ```json
- *    "OK" (No output, resolves on success)
+ * 🔑 Resets the password of a user.
+ *
+ * This function 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 with a success message `"OK"` if the password is successfully reset.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * await resetPassword({
+ *   newPassword: "mySecurePassword2025!",
+ *   resetPasswordToken: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+ * });
  * ```
+ *
+ * @param {ResetPasswordParameters} params - The parameters required for resetting the password.
+ * @throws {Error} If the required parameters `newPassword` or `resetPasswordToken` are missing.
+ * @returns {Promise<void>} Resolves to `"OK"` if the password reset is successful.
  */
 export declare function resetPassword({ newPassword, resetPasswordToken, }: ResetPasswordParameters): Promise<void>;
 /**
- * ## Send an email to the user with a reset password link
- * ### APICODE(PWD-101)
- * @param {SendResetPasswordEmailParameters} params - The parameters for the function, including:
- * #### email - `string` | <strong style={{ color: 'red' }}>required</strong>
- * The email address to send the reset link to.
- *
- * @returns {Promise<void>} - A promise that resolves when the email is sent
- *
- * @example
- * #### input
- * ```typescript
- *    await sendResetPasswordEmail({ email: 'user@example.com' });
- * ```
- * #### output
- * ```json
- *    "OK" (No output, resolves on success)
+ * 📧 Sends a reset password email to a user.
+ *
+ * This function 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. |
+ *
+ * 📤 **Returns**:
+ * A `Promise<void>` that resolves when the reset password email is successfully sent.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * await sendResetPasswordEmail({
+ *   email: "user@example.com",
+ * });
  * ```
+ *
+ * @param {SendResetPasswordEmailParameters} params - The parameters required to send the reset password email.
+ * @throws {Error} If the required parameter `email` is missing.
+ * @returns {Promise<void>} Resolves when the reset email is successfully sent.
  */
 export declare function sendResetPasswordEmail({ email, }: SendResetPasswordEmailParameters): Promise<void>;
 /**
- * ##Login a user
- * ### APICODE(AUTH-101)
- * @param {LoginParameters} params - The parameters for the function, including:
- * #### username - `string` | <strong style={{ color: 'red' }}>required</strong>
- * The username of the user to log in.
- * #### password - `string` | <strong style={{ color: 'red' }}>required</strong>
- * The password of the user to log in.
- *
- * @returns {Promise<LoginResponse>} - A promise that resolves to the response containing the user's login information
- *
- * @example
- * #### input
- * ```typescript
- *    const loginResponse = await login({ username: 'user@example.com', password: 'password123' });
- * ```
- * #### output
- * ```json
- *    {
- *      "token": {
- *        "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
- *        "expireAt": 1679022000,
- *        "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
- *      },
- *      "user": {
- *        "id": "userID"
- *      }
- *    }
+ * 🔐 Logs in a user.
+ *
+ * This function 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.  |
+ *
+ * 📤 **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`.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const loginResponse = await login({
+ *   username: "user@example.com",
+ *   password: "password123",
+ * });
  * ```
+ *
+ * @param {LoginParameters} params - The parameters required for logging in the user.
+ * @throws {Error} If the required parameters `username` or `password` are missing.
+ * @returns {Promise<LoginResponse>} Resolves to an object containing the user's login information.
  */
 export declare function login({ username, password, }: LoginParameters): Promise<LoginResponse>;
 /**
- * ### Logout the user
- * ### APICODE(AUTH-103)
+ * 🚪 Logs out the user.
  *
- * @returns {Promise<void>} - A promise that resolves when the user is logged out
+ * This function logs out the user by revoking their authentication token.
  *
- * @example
- * #### input
- * ```typescript
- *    await logout();
- * ```
- * #### output
- * ```json
- *    "OK" (No output, resolves on success)
+ * 🛠 **Endpoint**: `POST /auth/revoke-token [AUTH-103]`
+ *
+ * | Parameter | Type | Required | Description |
+ * |-----------|------|----------|-------------|
+ * | *(none)*  | -    | -        | This function does not require any parameters. |
+ *
+ * 📤 **Returns**:
+ * A `Promise<void>` that resolves when the user is successfully logged out. No additional data is returned.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * await logout();
  * ```
+ *
+ * @throws {Error} If there is an issue with the logout process (e.g., network error).
+ * @returns {Promise<void>} Resolves when the logout is successful.
  */
 export declare function logout(): Promise<void>;