@djust-b2b/djust-front-sdk 3.0.0-beta.2 → 3.0.0-beta.20

package/dist/services/auth/definitions.d.ts

@@ -0,0 +1,69 @@
+import { AuthenticationResponseDto } from "../../interfaces/models/auth";
+/**
+ * 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;
+}
+export interface SettingsResponse {
+    manualAccountCheck: boolean;
+}
+/**
+ * Response type definitions
+ */
+export interface RefreshTokenResponse extends AuthenticationResponseDto {
+}
+export interface LoginResponse extends AuthenticationResponseDto {
+}
+export interface StoreLocale {
+    active: boolean;
+    code: string;
+    id: string;
+    label: string;
+    main: boolean;
+}
+export interface CustomField {
+    externalId: string;
+    externalSource: string;
+    faceted: boolean;
+    id: string;
+    indexable: boolean;
+    mandatory: boolean;
+    name: {
+        [key: string]: string;
+    };
+    role: string;
+    sealedTarget: string;
+    searchable: boolean;
+    sortable: boolean;
+    status: string;
+}
+export interface CustomFieldValue {
+    customField: CustomField;
+    value: Record<string, unknown>;
+}
+export interface Store {
+    active: boolean;
+    customFieldValues: CustomFieldValue[];
+    description: string;
+    externalId: string;
+    id: string;
+    name: string;
+    storeLocales: StoreLocale[];
+}
+//# sourceMappingURL=definitions.d.ts.map

package/dist/services/auth/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/services/auth/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAEzE;;GAEG;AAEH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AAEH,MAAM,WAAW,oBAAqB,SAAQ,yBAAyB;CAAG;AAE1E,MAAM,WAAW,aAAc,SAAQ,yBAAyB;CAAG;AAEnE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE;QACJ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB,CAAC;IACF,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B"}

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

@@ -0,0 +1,25 @@
+/**
+ * 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;
+}
+export interface LoginParameters {
+    username: string;
+    password: string;
+    withUser?: boolean;
+}
+export interface GetStoreParameters {
+    storeId: string;
+}
+//# sourceMappingURL=definitions.requests.d.ts.map

package/dist/services/auth/definitions.requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.requests.d.ts","sourceRoot":"","sources":["../../../src/services/auth/definitions.requests.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/services/auth/endpoints.d.ts

@@ -0,0 +1,30 @@
+/**
+ * DJUST SDK Auth Service - Endpoints
+ * API endpoint constants for authentication operations.
+ *
+ * @module services/auth/endpoints
+ * @since 2.17.0
+ */
+/**
+ * Auth API endpoints.
+ */
+export declare const AuthEndpoints: {
+    /** Validate token endpoint [TOK-200] */
+    readonly IS_TOKEN_VALID: "/auth/is-token-valid";
+    /** Refresh token endpoint [AUTH-102] */
+    readonly REFRESH_TOKEN: "/auth/refresh-token";
+    /** Reset password endpoint [PWD-102] */
+    readonly RESET_PASSWORD: "/auth/reset-password";
+    /** Send reset password email endpoint [PWD-101] */
+    readonly SEND_RESET_PASSWORD_EMAIL: "/auth/send-reset-password-email";
+    /** Login endpoint [AUTH-101] */
+    readonly TOKEN: "/auth/token";
+    /** Logout endpoint [AUTH-103] */
+    readonly REVOKE_TOKEN: "/auth/revoke-token";
+    /** Shop settings endpoint [SETTINGS-500] */
+    readonly SETTINGS: "/v1/shop/settings";
+    /** Store endpoint [STORE-500] */
+    readonly STORE: "/v1/shop/stores/{storeId}";
+};
+export type AuthEndpoint = (typeof AuthEndpoints)[keyof typeof AuthEndpoints];
+//# sourceMappingURL=endpoints.d.ts.map

package/dist/services/auth/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../../src/services/auth/endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,wCAAwC;;IAGxC,wCAAwC;;IAGxC,wCAAwC;;IAGxC,mDAAmD;;IAGnD,gCAAgC;;IAGhC,iCAAiC;;IAGjC,4CAA4C;;IAG5C,iCAAiC;;CAEzB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC"}

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

@@ -0,0 +1,232 @@
+/**
+ * # 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
+ *
+ * Each function is described with its input parameters, output responses, and example usages.
+ */
+import { LoginResponse, RefreshTokenResponse, SettingsResponse, Store } from "./definitions";
+import { IsTokenValidParameters, LoginParameters, RefreshTokenParameters, ResetPasswordParameters, SendResetPasswordEmailParameters, GetStoreParameters } from "./definitions.requests";
+/**
+ * 🔐 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
+ * ```
+ *
+ * @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>;
+/**
+ * 🔄 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>;
+/**
+ * 🔑 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>;
+/**
+ * 📧 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>;
+/**
+ * 🔐 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.  |
+ * | `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`.
+ *
+ * 🛠 **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, withUser, }: LoginParameters): Promise<LoginResponse>;
+/**
+ * 🚪 Logs out the user.
+ *
+ * This function logs out the user by revoking their authentication token.
+ *
+ * 🛠 **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>;
+/**
+ * ⚙️ Récupère les paramètres globaux du shop.
+ *
+ * Cette fonction permet d'obtenir les paramètres de configuration du shop.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/settings` [SETTINGS-500]
+ *
+ * 📤 **Returns**:
+ * A `Promise<SettingsResponse>` contenant les paramètres du shop, notamment:
+ * - `manualAccountCheck` (boolean): Indique si la vérification manuelle des comptes est activée.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const settings = await getSettings();
+ * console.log(settings.manualAccountCheck); // true
+ * ```
+ *
+ * @returns {Promise<SettingsResponse>} Une promesse qui résout avec les paramètres du shop.
+ */
+export declare function getSettings(): Promise<SettingsResponse>;
+/**
+ * 🏪 Récupère les informations d'un magasin spécifique.
+ *
+ * Cette fonction permet d'obtenir les détails d'un magasin à partir de son identifiant.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/stores/{storeId}` [STORE-500]
+ *
+ * | Parameter  | Type     | Required | Description                          |
+ * |------------|----------|----------|--------------------------------------|
+ * | `storeId`  | `string` | ✅       | L'identifiant unique du magasin.     |
+ *
+ * 📤 **Returns**:
+ * A `Promise<Store>` contenant les informations détaillées du magasin, notamment:
+ * - `active`: État d'activation du magasin
+ * - `customFieldValues`: Valeurs des champs personnalisés
+ * - `description`: Description du magasin
+ * - `externalId`: Identifiant externe
+ * - `id`: Identifiant interne
+ * - `name`: Nom du magasin
+ * - `storeLocales`: Informations de localisation
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const store = await getStore({
+ *   storeId: "123e4567-e89b-12d3-a456-426614174000"
+ * });
+ * console.log(store.name); // "Mon Magasin"
+ * ```
+ *
+ * @param {GetStoreParameters} params - Les paramètres pour récupérer le magasin.
+ * @throws {Error} Si le paramètre `storeId` est manquant.
+ * @returns {Promise<Store>} Une promesse qui résout avec les informations du magasin.
+ */
+export declare function getStore({ storeId, }: GetStoreParameters): Promise<Store>;
+//# sourceMappingURL=index.d.ts.map

package/dist/services/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/auth/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,EACN,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,gCAAgC,EAChC,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,YAAY,CAAC,EACjC,KAAK,GACN,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAY3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,YAAY,CAAC,EACjC,YAAY,GACb,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAYxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,aAAa,CAAC,EAClC,WAAW,EACX,kBAAkB,GACnB,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,KAAK,GACN,EAAE,gCAAgC,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,KAAK,CAAC,EAC1B,QAAQ,EACR,QAAQ,EACR,QAAe,GAChB,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CAY1C;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAK5C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAO7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,QAAQ,CAAC,EAC7B,OAAO,GACR,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,CASrC"}

package/dist/services/auth/module.d.ts

@@ -0,0 +1,11 @@
+/**
+ * DJUST SDK Auth Module
+ * Re-exports all auth-related types and service.
+ *
+ * @module services/auth
+ * @since 2.17.0
+ */
+export type { IsTokenValidParams, RefreshTokenParams, ResetPasswordParams, SendResetPasswordEmailParams, LoginParams, GetStoreParams, RefreshTokenResponse, LoginResponse, SettingsResponse, StoreLocale, CustomField, CustomFieldValue, Store, } from "./types";
+export { AuthEndpoints, type AuthEndpoint } from "./endpoints";
+export { AuthService } from "./auth.service";
+//# sourceMappingURL=module.d.ts.map

package/dist/services/auth/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/services/auth/module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,4BAA4B,EAC5B,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,KAAK,GACN,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAG/D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/services/auth/types.d.ts

@@ -0,0 +1,124 @@
+/**
+ * DJUST SDK Auth Service - Types
+ * Type definitions for authentication operations.
+ *
+ * @module services/auth/types
+ * @since 2.17.0
+ */
+import type { AuthenticationResponseDto } from "../../interfaces/models/auth";
+/**
+ * Parameters for validating a token.
+ */
+export interface IsTokenValidParams {
+    /** The token to validate */
+    token: string;
+}
+/**
+ * Parameters for refreshing an access token.
+ */
+export interface RefreshTokenParams {
+    /** The refresh token */
+    refreshToken: string;
+    /** Whether this is an automatic refresh (vs manual). Used for hooks. */
+    automatic?: boolean;
+}
+/**
+ * Parameters for resetting a password.
+ */
+export interface ResetPasswordParams {
+    /** The new password */
+    newPassword: string;
+    /** The reset password token from email */
+    resetPasswordToken: string;
+}
+/**
+ * Parameters for sending a reset password email.
+ */
+export interface SendResetPasswordEmailParams {
+    /** The user's email address */
+    email: string;
+    /** URL to redirect after password reset */
+    redirectUrl?: string;
+}
+/**
+ * Parameters for user login.
+ */
+export interface LoginParams {
+    /** Username (usually email) */
+    username: string;
+    /** User password */
+    password: string;
+    /** Whether to include user details in response */
+    withUser?: boolean;
+}
+/**
+ * Parameters for getting store information.
+ */
+export interface GetStoreParams {
+    /** The store ID */
+    storeId: string;
+}
+/**
+ * Response from token refresh operation.
+ */
+export interface RefreshTokenResponse extends AuthenticationResponseDto {
+}
+/**
+ * Response from login operation.
+ */
+export interface LoginResponse extends AuthenticationResponseDto {
+}
+/**
+ * Shop settings configuration.
+ */
+export interface SettingsResponse {
+    /** Whether manual account verification is required */
+    manualAccountCheck: boolean;
+}
+/**
+ * Store locale configuration.
+ */
+export interface StoreLocale {
+    active: boolean;
+    code: string;
+    id: string;
+    label: string;
+    main: boolean;
+}
+/**
+ * Custom field definition.
+ */
+export interface CustomField {
+    externalId: string;
+    externalSource: string;
+    faceted: boolean;
+    id: string;
+    indexable: boolean;
+    mandatory: boolean;
+    name: Record<string, string>;
+    role: string;
+    sealedTarget: string;
+    searchable: boolean;
+    sortable: boolean;
+    status: string;
+}
+/**
+ * Custom field value.
+ */
+export interface CustomFieldValue {
+    customField: CustomField;
+    value: Record<string, unknown>;
+}
+/**
+ * Store information.
+ */
+export interface Store {
+    active: boolean;
+    customFieldValues: CustomFieldValue[];
+    description: string;
+    externalId: string;
+    id: string;
+    name: string;
+    storeLocales: StoreLocale[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/auth/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/auth/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAM9E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,yBAAyB;CAAG;AAE1E;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,yBAAyB;CAAG;AAEnE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B"}

package/dist/services/base.service.d.ts

@@ -0,0 +1,83 @@
+/**
+ * DJUST SDK Base Service
+ * Abstract base class for all API services.
+ *
+ * @module services/base
+ * @since 2.17.0
+ */
+import type { Transport, TransportRequest, RequestContext } from "../client/transport";
+/**
+ * Abstract base class for all SDK services.
+ *
+ * Provides common functionality:
+ * - Transport wrapper
+ * - Parameter validation
+ * - Context management
+ *
+ * @example
+ * ```typescript
+ * class CartService extends BaseService {
+ *   readonly serviceName = 'cart';
+ *
+ *   async getCart(params: GetCartParams, context?: RequestContext) {
+ *     this.required(params, ['cartId', 'currency']);
+ *     return this.request<Cart>({
+ *       method: 'GET',
+ *       path: `/v2/shop/carts/${params.cartId}`,
+ *       params: { currency: params.currency },
+ *     }, context);
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class BaseService {
+    protected readonly transport: Transport;
+    /** Service name for logging and debugging */
+    abstract readonly serviceName: string;
+    constructor(transport: Transport);
+    /**
+     * Makes an HTTP request via the transport layer.
+     *
+     * @param request - The request configuration
+     * @param context - Optional request context (auth, headers, etc.)
+     * @returns The response data
+     */
+    protected request<T>(request: TransportRequest, context?: RequestContext): Promise<T>;
+    /**
+     * Validates that required parameters are present.
+     *
+     * @param params - The parameters object to validate
+     * @param requiredFields - Array of field names that are required
+     * @throws ValidationError if any required field is missing
+     *
+     * @example
+     * ```typescript
+     * this.required(params, ['cartId', 'currency']);
+     * ```
+     */
+    protected required<T extends object>(params: T, requiredFields: (keyof T)[]): void;
+    /**
+     * Builds query parameters, filtering out undefined values.
+     * Arrays are kept as arrays so the transport can serialize them
+     * in the format expected by the API (e.g. repeat format for search: &brand=1664&brand=1664+BLANC).
+     *
+     * @param params - Object with potential query parameters
+     * @returns Cleaned object with only defined values
+     */
+    protected buildParams<T extends object>(params: T): Record<string, unknown>;
+    /**
+     * Builds a path with path parameters.
+     *
+     * @param template - Path template with {param} placeholders
+     * @param params - Object with parameter values
+     * @returns Resolved path
+     *
+     * @example
+     * ```typescript
+     * const path = this.buildPath('/carts/{cartId}/lines', { cartId: '123' });
+     * // Returns: '/carts/123/lines'
+     * ```
+     */
+    protected buildPath<T extends object>(template: string, params: T): string;
+}
+//# sourceMappingURL=base.service.d.ts.map

package/dist/services/base.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.service.d.ts","sourceRoot":"","sources":["../../src/services/base.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAChB,cAAc,EACf,MAAM,qBAAqB,CAAC;AAG7B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,8BAAsB,WAAW;IAInB,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS;IAHnD,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEP,SAAS,EAAE,SAAS;IAEnD;;;;;;OAMG;cACa,OAAO,CAAC,CAAC,EACvB,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAcb;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,QAAQ,CAAC,CAAC,SAAS,MAAM,EACjC,MAAM,EAAE,CAAC,EACT,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAC1B,IAAI;IAWP;;;;;;;OAOG;IACH,SAAS,CAAC,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAY3E;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM;CAW3E"}