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

package/lib/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/lib/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/lib/services/auth/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * DJUST SDK Auth Service - Types
+ * Type definitions for authentication operations.
+ *
+ * @module services/auth/types
+ * @since 2.17.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/services/auth/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/auth/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/lib/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/lib/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"}

package/lib/services/base.service.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * DJUST SDK Base Service
+ * Abstract base class for all API services.
+ *
+ * @module services/base
+ * @since 2.17.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseService = void 0;
+const validation_error_1 = require("../errors/classes/validation.error");
+/**
+ * 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);
+ *   }
+ * }
+ * ```
+ */
+class BaseService {
+    constructor(transport) {
+        this.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
+     */
+    async request(request, context) {
+        const enrichedContext = {
+            ...context,
+            service: this.serviceName,
+        };
+        const response = await this.transport.request(request, enrichedContext);
+        // Payload is in response.data. For 204 No Content the transport may set data to "".
+        const data = response.data;
+        const out = (data === "" ? undefined : data);
+        return out;
+    }
+    /**
+     * 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']);
+     * ```
+     */
+    required(params, requiredFields) {
+        for (const field of requiredFields) {
+            const value = params[field];
+            if (value === undefined || value === null || value === "") {
+                throw validation_error_1.ValidationError.missingParameter(String(field), {
+                    service: this.serviceName,
+                });
+            }
+        }
+    }
+    /**
+     * 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
+     */
+    buildParams(params) {
+        const result = {};
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined && value !== null) {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    /**
+     * 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'
+     * ```
+     */
+    buildPath(template, params) {
+        let path = template;
+        for (const [key, value] of Object.entries(params)) {
+            if (typeof value === "string" || typeof value === "number") {
+                path = path.replace(`{${key}}`, encodeURIComponent(String(value)));
+            }
+        }
+        return path;
+    }
+}
+exports.BaseService = BaseService;
+//# sourceMappingURL=base.service.js.map

package/lib/services/base.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.service.js","sourceRoot":"","sources":["../../src/services/base.service.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAOH,yEAAqE;AAErE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAsB,WAAW;IAI/B,YAA+B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAEvD;;;;;;OAMG;IACO,KAAK,CAAC,OAAO,CACrB,OAAyB,EACzB,OAAwB;QAExB,MAAM,eAAe,GAAmB;YACtC,GAAG,OAAO;YACV,OAAO,EAAE,IAAI,CAAC,WAAW;SAC1B,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAI,OAAO,EAAE,eAAe,CAAC,CAAC;QAE3E,oFAAoF;QACpF,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC3B,MAAM,GAAG,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAM,CAAC;QAClD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;;;;;;OAWG;IACO,QAAQ,CAChB,MAAS,EACT,cAA2B;QAE3B,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;gBAC1D,MAAM,kCAAe,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;oBACpD,OAAO,EAAE,IAAI,CAAC,WAAW;iBAC1B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACO,WAAW,CAAmB,MAAS;QAC/C,MAAM,MAAM,GAA4B,EAAE,CAAC;QAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;OAYG;IACO,SAAS,CAAmB,QAAgB,EAAE,MAAS;QAC/D,IAAI,IAAI,GAAG,QAAQ,CAAC;QAEpB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC3D,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AApGD,kCAoGC"}