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

package/lib/services/payment/payment.service.js

@@ -0,0 +1,288 @@
+"use strict";
+/**
+ * # Payment Service
+ *
+ * Payment processing and management for B2B commerce.
+ *
+ * ## Features
+ * - Payment initialization
+ * - Multiple payment methods
+ * - Stored payment methods
+ * - Purchase card (L3) support
+ *
+ * @module services/payment
+ * @since 2.17.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentService = void 0;
+const base_service_1 = require("../base.service");
+const endpoints_1 = require("./endpoints");
+/**
+ * Service for payment operations.
+ *
+ * Handles payment processing:
+ * - Payment initialization with multiple providers
+ * - Payment method management
+ * - Stored payment methods for returning customers
+ * - B2B-specific features (Purchase Cards)
+ *
+ * @example
+ * ```typescript
+ * import { createDjustClient } from '@djust-b2b/djust-front-sdk';
+ *
+ * const client = createDjustClient({ baseUrl, clientId, apiKey });
+ *
+ * // Get available payment methods
+ * const methods = await client.payment.getPaymentMethods({
+ *   reference: 'order-123',
+ *   countryCode: 'US',
+ * });
+ *
+ * // Initialize payment
+ * const payment = await client.payment.initPayment({
+ *   reference: 'order-123',
+ *   countryCode: 'US',
+ *   returnPath: '/checkout/complete',
+ *   browserInfo: { ... },
+ * });
+ * ```
+ */
+class PaymentService extends base_service_1.BaseService {
+    constructor() {
+        super(...arguments);
+        this.serviceName = "payment";
+    }
+    /**
+     * Initialize a payment session.
+     *
+     * Starts the payment flow with the configured payment provider.
+     *
+     * **Endpoint**: `POST /v1/shop/payments [PAY-100]`
+     *
+     * | Parameter            | Type     | Required | Description                    |
+     * |----------------------|----------|----------|--------------------------------|
+     * | `browserInfo`        | `object` | Yes      | Browser detection info         |
+     * | `countryCode`        | `string` | Yes      | Customer's country             |
+     * | `reference`          | `string` | Yes      | Order reference                |
+     * | `returnPath`         | `string` | Yes      | URL for payment completion     |
+     * | `referenceType`      | `string` | No       | Reference type (order, quote)  |
+     * | `paymentMethodData`  | `object` | No       | Selected payment method        |
+     * | `storePaymentMethod` | `boolean`| No       | Save for future use            |
+     *
+     * @example
+     * ```typescript
+     * const payment = await client.payment.initPayment({
+     *   reference: 'ORD-2024-001',
+     *   countryCode: 'US',
+     *   returnPath: 'https://myapp.com/checkout/complete',
+     *   browserInfo: {
+     *     acceptHeader: navigator.language,
+     *     colorDepth: screen.colorDepth,
+     *     language: navigator.language,
+     *     screenHeight: screen.height,
+     *     screenWidth: screen.width,
+     *     timeZoneOffset: new Date().getTimezoneOffset(),
+     *     userAgent: navigator.userAgent,
+     *   },
+     *   paymentMethodData: { type: 'scheme' },
+     * });
+     *
+     * if (payment.action) {
+     *   // Redirect or handle 3DS
+     *   window.location.href = payment.action.url;
+     * }
+     * ```
+     *
+     * @param params - Payment initialization parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If required parameters are missing
+     * @returns Payment session data with action if required
+     */
+    async initPayment(params, context) {
+        this.required(params, [
+            "browserInfo",
+            "countryCode",
+            "reference",
+            "returnPath",
+        ]);
+        return this.request({
+            method: "POST",
+            path: endpoints_1.PaymentEndpoints.PAYMENTS,
+            body: {
+                browserInfo: params.browserInfo,
+                countryCode: params.countryCode,
+                customerUserIP: params.customerUserIP,
+                paymentMethodData: params.paymentMethodData,
+                reference: params.reference,
+                referenceType: params.referenceType,
+                returnPath: params.returnPath,
+                storePaymentMethod: params.storePaymentMethod,
+            },
+        }, context);
+    }
+    /**
+     * Complete payment after 3DS or redirect.
+     *
+     * Called after customer returns from payment provider redirect.
+     *
+     * **Endpoint**: `POST /v1/shop/payments/details [PAY-101]`
+     *
+     * | Parameter | Type     | Required | Description              |
+     * |-----------|----------|----------|--------------------------|
+     * | `details` | `object` | Yes      | Provider-specific data   |
+     *
+     * @example
+     * ```typescript
+     * // After 3DS redirect back to your site
+     * const urlParams = new URLSearchParams(window.location.search);
+     *
+     * const result = await client.payment.getPaymentDetails({
+     *   details: {
+     *     redirectResult: urlParams.get('redirectResult'),
+     *   },
+     * });
+     *
+     * if (result.resultCode === 'Authorised') {
+     *   // Payment successful
+     * }
+     * ```
+     *
+     * @param params - Payment details from provider
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If details is missing
+     * @returns Payment result
+     */
+    async getPaymentDetails(params, context) {
+        this.required(params, ["details"]);
+        return this.request({
+            method: "POST",
+            path: endpoints_1.PaymentEndpoints.PAYMENT_DETAILS,
+            body: { details: params.details },
+        }, context);
+    }
+    /**
+     * Get available payment methods.
+     *
+     * Returns payment options available for the order/customer.
+     *
+     * **Endpoint**: `GET /v1/shop/payments/methods [PAY-102]`
+     *
+     * | Parameter       | Type     | Required | Description              |
+     * |-----------------|----------|----------|--------------------------|
+     * | `reference`     | `string` | Yes      | Order reference          |
+     * | `countryCode`   | `string` | No       | Customer's country       |
+     * | `referenceType` | `string` | No       | Reference type           |
+     * | `locale`        | `string` | No       | Locale for display       |
+     *
+     * @example
+     * ```typescript
+     * const methods = await client.payment.getPaymentMethods({
+     *   reference: 'ORD-2024-001',
+     *   countryCode: 'US',
+     *   locale: 'en-US',
+     * });
+     *
+     * console.log('Available methods:');
+     * methods.paymentMethods.forEach(m => {
+     *   console.log(`- ${m.name} (${m.type})`);
+     * });
+     *
+     * if (methods.storedPaymentMethods?.length) {
+     *   console.log('Saved cards:', methods.storedPaymentMethods.length);
+     * }
+     * ```
+     *
+     * @param params - Query parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If reference is missing
+     * @returns Available payment methods including stored cards
+     */
+    async getPaymentMethods(params, context) {
+        this.required(params, ["reference"]);
+        return this.request({
+            method: "GET",
+            path: endpoints_1.PaymentEndpoints.PAYMENT_METHODS,
+            params: this.buildParams({
+                reference: params.reference,
+                countryCode: params.countryCode,
+                referenceType: params.referenceType,
+                locale: params.locale,
+            }),
+        }, context);
+    }
+    /**
+     * Delete a stored payment method.
+     *
+     * Removes a saved card/payment method from customer's account.
+     *
+     * **Endpoint**: `DELETE /v1/shop/payments/stored-payment-methods/{id} [PAY-103]`
+     *
+     * | Parameter               | Type     | Required | Description              |
+     * |-------------------------|----------|----------|--------------------------|
+     * | `storedPaymentMethodId` | `string` | Yes      | Stored method ID         |
+     *
+     * @example
+     * ```typescript
+     * await client.payment.deleteStoredPaymentMethod({
+     *   storedPaymentMethodId: 'pm_card_visa_1234',
+     * });
+     *
+     * console.log('Card removed successfully');
+     * ```
+     *
+     * @param params - Stored method identification
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If storedPaymentMethodId is missing
+     * @throws {NotFoundError} If stored method doesn't exist
+     */
+    async deleteStoredPaymentMethod(params, context) {
+        this.required(params, ["storedPaymentMethodId"]);
+        await this.request({
+            method: "DELETE",
+            path: this.buildPath(endpoints_1.PaymentEndpoints.STORED_PAYMENT_METHOD, {
+                storedPaymentMethodId: params.storedPaymentMethodId,
+            }),
+        }, context);
+    }
+    /**
+     * Pre-check for Purchase Card Level 3 data.
+     *
+     * Validates if L3 data is required for B2B purchase cards.
+     *
+     * **Endpoint**: `GET /v1/shop/payments/precheck [PAY-104]`
+     *
+     * | Parameter       | Type     | Required | Description              |
+     * |-----------------|----------|----------|--------------------------|
+     * | `reference`     | `string` | Yes      | Order reference          |
+     * | `referenceType` | `string` | No       | Reference type           |
+     *
+     * @example
+     * ```typescript
+     * const precheck = await client.payment.precheckPurchaseCardL3({
+     *   reference: 'ORD-2024-001',
+     * });
+     *
+     * if (precheck.requiresL3Data) {
+     *   // Collect additional line item data for purchase card
+     * }
+     * ```
+     *
+     * @param params - Order reference
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If reference is missing
+     * @returns L3 requirements check result
+     */
+    async precheckPurchaseCardL3(params, context) {
+        this.required(params, ["reference"]);
+        return this.request({
+            method: "GET",
+            path: endpoints_1.PaymentEndpoints.PRECHECK,
+            params: this.buildParams({
+                reference: params.reference,
+                referenceType: params.referenceType,
+            }),
+        }, context);
+    }
+}
+exports.PaymentService = PaymentService;
+//# sourceMappingURL=payment.service.js.map

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

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

package/lib/services/payment/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * DJUST SDK Payment Service - Types
+ * Type definitions for payment operations.
+ *
+ * @module services/payment/types
+ * @since 2.17.0
+ */
+export interface BrowserInfo {
+    acceptHeader?: string;
+    colorDepth?: number;
+    javaEnabled?: boolean;
+    javaScriptEnabled?: boolean;
+    language?: string;
+    screenHeight?: number;
+    screenWidth?: number;
+    timeZoneOffset?: number;
+    userAgent?: string;
+}
+export interface PaymentMethodData {
+    description?: string;
+    type?: string;
+    storedPaymentMethodId?: string;
+    [key: string]: unknown;
+}
+export interface InitPaymentParams {
+    browserInfo: BrowserInfo;
+    countryCode: string;
+    reference: string;
+    returnPath: string;
+    customerUserIP?: string;
+    paymentMethodData?: PaymentMethodData;
+    referenceType?: string;
+    storePaymentMethod?: boolean;
+}
+export interface GetPaymentDetailsParams {
+    details: Record<string, unknown>;
+}
+export interface GetPaymentMethodsParams {
+    reference: string;
+    countryCode?: string;
+    referenceType?: string;
+    locale?: string;
+}
+export interface DeleteStoredPaymentMethodParams {
+    storedPaymentMethodId: string;
+}
+export interface PrecheckPurchaseCardL3Params {
+    reference: string;
+    referenceType?: string;
+}
+export interface PaymentAction {
+    type: string;
+    url?: string;
+    paymentData?: string;
+    method?: string;
+}
+export interface InitPaymentResponse {
+    resultCode: string;
+    pspReference?: string;
+    action?: PaymentAction;
+    refusalReason?: string;
+    additionalData?: Record<string, unknown>;
+}
+export interface GetPaymentDetailsResponse {
+    resultCode: string;
+    pspReference?: string;
+    action?: PaymentAction;
+    refusalReason?: string;
+}
+export interface PaymentMethod {
+    type: string;
+    name: string;
+    brands?: string[];
+    configuration?: Record<string, unknown>;
+}
+export interface StoredPaymentMethod {
+    id: string;
+    type: string;
+    name: string;
+    brand?: string;
+    lastFour?: string;
+    expiryMonth?: string;
+    expiryYear?: string;
+}
+export interface GetPaymentMethodsResponse {
+    paymentMethods: PaymentMethod[];
+    storedPaymentMethods?: StoredPaymentMethod[];
+}
+export interface PrecheckPurchaseCardL3Response {
+    eligible: boolean;
+    reason?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/services/payment/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/payment/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,+BAA+B;IAC9C,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/lib/services/payment/types.js

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

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

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

package/lib/services/product/definitions.d.ts

@@ -0,0 +1,150 @@
+import { AttributeObject } from "../../interfaces/models/attribute";
+import { OfferResponse, ProductVariantOfferResponse } from "../../interfaces/models/offer";
+import { PageProductVariantResponse, Product, ProductAutocomplete, ProductReviewDto, ProductReviewRatings, ProductReviewsSummary, SearchThumbnailsAndAggregation } from "../../interfaces/models/product";
+import { SearchProduct } from "../../interfaces/models/searchProduct";
+import { SupplierSimpleView } from "../../interfaces/models/supplier";
+import { Order, PageableObject, PageableParameters } from "../../interfaces/models/common";
+/**
+ * Requests parameters type definitions
+ */
+export interface CreateProductReviewParameters {
+    message: string;
+    productSku: string;
+    rating: number;
+}
+export interface UpdateProductReviewParameters {
+    productReviewId: string;
+    message: string;
+    rating: number;
+}
+export declare enum AggregationType {
+    PRODUCT = "PRODUCT",
+    VARIANT = "VARIANT"
+}
+export interface GetProductsListParameters {
+    locale: string;
+    hasOfferPrice?: boolean;
+    filters: {
+        currency: string;
+        categoryIds?: string[];
+        skus?: string[];
+        brand?: string[];
+        query?: string;
+        productTags?: string[];
+        aggregation?: AggregationType;
+        attributes?: string[];
+        suppliers?: string[];
+        customFields?: string[];
+        offerUpdatedTime?: string;
+        productUpdatedTime?: string;
+        withFacets?: string;
+        priceMin?: number;
+        priceMax?: number;
+    };
+    pageable?: PageableParameters;
+}
+export interface GetProductStatReviewsParameters {
+    productIdentifier: string;
+    productIdType: string;
+}
+export interface GetProductReviewsParameters {
+    productIdentifier: string;
+    productIdType: string;
+}
+export interface GetProductParameters {
+    productIdentifier: string;
+    productIdType: string;
+    locale?: string;
+}
+export interface GetProductOffersParameters {
+    productIdentifier: string;
+    productIdType: string;
+    locale?: string;
+    currency?: string;
+    withoutPrice?: boolean;
+}
+export interface GetProductVariantsListParameters {
+    productSku: string;
+    locale?: string;
+    pageable?: PageableParameters;
+}
+export interface GetProductVariantAttributesParameters {
+    productIdentifier: string;
+    productIdType: string;
+    locale?: string;
+}
+export interface AutoCompleteSearchProductsParameters {
+    input: string;
+    locale: string;
+    currency: string;
+    aggregation?: AggregationType;
+    productTags?: string[];
+    pageable?: PageableParameters;
+}
+export interface GetProductVariantSuppliersParameters {
+    productVariantId: string;
+}
+export interface GetProductVariantOffersParameters {
+    productIdentifier: string;
+    productIdType: string;
+    currency?: string;
+    withoutPrice?: boolean;
+}
+export interface GetRelatedProductsParameters {
+    productIdentifier: string;
+    productIdType: string;
+    locale?: string;
+    currency?: string;
+    pageable?: PageableParameters;
+}
+/**
+ * Responses type definitions
+ */
+export interface CreateProductReviewResponse extends ProductReviewsSummary {
+}
+export interface UpdateProductReviewResponse extends ProductReviewDto {
+}
+export interface GetProductsListResponse extends SearchProduct {
+}
+export interface GetProductStatReviewsResponse extends ProductReviewRatings {
+}
+export interface GetProductReviewsResponse extends Array<ProductReviewsSummary> {
+}
+export interface GetProductResponse extends Product {
+}
+export interface GetProductOffersResponse extends Array<OfferResponse> {
+}
+export interface GetProductVariantsListResponse extends PageProductVariantResponse {
+}
+export interface GetProductVariantAttributesResponse extends Array<AttributeObject> {
+}
+export interface SearchProductsResponse extends Array<ProductAutocomplete> {
+}
+export interface GetProductVariantSuppliersResponse extends Array<SupplierSimpleView> {
+}
+export interface GetProductVariantOffersResponse extends Array<ProductVariantOfferResponse> {
+}
+export interface GetRelatedProductsResponse extends SearchThumbnailsAndAggregation {
+}
+export interface GetProductPaginatedOffersParameters {
+    productIdentifier: string;
+    productIdType?: string;
+    locale?: string;
+    currency?: string;
+    withoutPrices?: boolean;
+    pageable?: PageableParameters;
+}
+export interface GetProductPaginatedOffersResponse {
+    content: OfferResponse[];
+    empty: boolean;
+    first: boolean;
+    last: boolean;
+    number: number;
+    numberOfElements: number;
+    pageable: PageableObject;
+    size: number;
+    sort: Order[];
+    totalElements: number;
+    totalPages: number;
+}
+//# sourceMappingURL=definitions.d.ts.map

package/lib/services/product/definitions.d.ts.map

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

package/lib/services/product/definitions.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AggregationType = void 0;
+var AggregationType;
+(function (AggregationType) {
+    AggregationType["PRODUCT"] = "PRODUCT";
+    AggregationType["VARIANT"] = "VARIANT";
+})(AggregationType || (exports.AggregationType = AggregationType = {}));
+//# sourceMappingURL=definitions.js.map

package/lib/services/product/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../src/services/product/definitions.ts"],"names":[],"mappings":";;;AAsCA,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,sCAAmB,CAAA;IACnB,sCAAmB,CAAA;AACrB,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B"}

package/lib/services/product/endpoints.d.ts

@@ -0,0 +1,40 @@
+/**
+ * DJUST SDK Product Service - Endpoints
+ * API endpoint constants for product operations.
+ *
+ * @module services/product/endpoints
+ * @since 2.17.0
+ */
+/**
+ * Product API endpoints.
+ */
+export declare const ProductEndpoints: {
+    /** Autocomplete search */
+    readonly AUTOCOMPLETE: "/v2/shop/autocomplete";
+    /** Product search */
+    readonly SEARCH: "/v2/shop/search";
+    /** Single product [PRODUCT-501] */
+    readonly PRODUCT: "/v1/shop/products/{productIdentifier}";
+    /** Product offers [PRODUCT-502] */
+    readonly PRODUCT_OFFERS: "/v1/shop/products/{productIdentifier}/offers";
+    /** Paginated product offers */
+    readonly PRODUCT_PAGINATED_OFFERS: "/v1/shop/products/{productIdentifier}/paginated-offers";
+    /** Related products */
+    readonly RELATED_PRODUCTS: "/v1/shop/products/{productIdentifier}/related-products";
+    /** Product reviews */
+    readonly PRODUCT_REVIEWS: "/v1/shop/products/{productIdentifier}/reviews";
+    /** Product review statistics */
+    readonly PRODUCT_STAT_REVIEWS: "/v1/shop/products/{productIdentifier}/stat-reviews";
+    /** Product variant attributes */
+    readonly VARIANT_ATTRIBUTES: "/v1/shop/products/{productIdentifier}/variant-attributes";
+    /** Product variant offers */
+    readonly VARIANT_OFFERS: "/v1/shop/product-variants/{productIdentifier}/offers";
+    /** Product variant suppliers */
+    readonly VARIANT_SUPPLIERS: "/v1/shop/product-variants/{productVariantId}/suppliers";
+    /** Reviews management */
+    readonly REVIEWS: "/v1/shop/reviews";
+    /** Single review */
+    readonly REVIEW: "/v1/shop/reviews/{productReviewId}";
+};
+export type ProductEndpoint = (typeof ProductEndpoints)[keyof typeof ProductEndpoints];
+//# sourceMappingURL=endpoints.d.ts.map

package/lib/services/product/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../../src/services/product/endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,0BAA0B;;IAG1B,qBAAqB;;IAGrB,mCAAmC;;IAGnC,mCAAmC;;IAGnC,+BAA+B;;IAI/B,uBAAuB;;IAGvB,sBAAsB;;IAGtB,gCAAgC;;IAGhC,iCAAiC;;IAIjC,6BAA6B;;IAG7B,gCAAgC;;IAGhC,yBAAyB;;IAGzB,oBAAoB;;CAEZ,CAAC;AAEX,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC"}

package/lib/services/product/endpoints.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * DJUST SDK Product Service - Endpoints
+ * API endpoint constants for product operations.
+ *
+ * @module services/product/endpoints
+ * @since 2.17.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductEndpoints = void 0;
+/**
+ * Product API endpoints.
+ */
+exports.ProductEndpoints = {
+    /** Autocomplete search */
+    AUTOCOMPLETE: "/v2/shop/autocomplete",
+    /** Product search */
+    SEARCH: "/v2/shop/search",
+    /** Single product [PRODUCT-501] */
+    PRODUCT: "/v1/shop/products/{productIdentifier}",
+    /** Product offers [PRODUCT-502] */
+    PRODUCT_OFFERS: "/v1/shop/products/{productIdentifier}/offers",
+    /** Paginated product offers */
+    PRODUCT_PAGINATED_OFFERS: "/v1/shop/products/{productIdentifier}/paginated-offers",
+    /** Related products */
+    RELATED_PRODUCTS: "/v1/shop/products/{productIdentifier}/related-products",
+    /** Product reviews */
+    PRODUCT_REVIEWS: "/v1/shop/products/{productIdentifier}/reviews",
+    /** Product review statistics */
+    PRODUCT_STAT_REVIEWS: "/v1/shop/products/{productIdentifier}/stat-reviews",
+    /** Product variant attributes */
+    VARIANT_ATTRIBUTES: "/v1/shop/products/{productIdentifier}/variant-attributes",
+    /** Product variant offers */
+    VARIANT_OFFERS: "/v1/shop/product-variants/{productIdentifier}/offers",
+    /** Product variant suppliers */
+    VARIANT_SUPPLIERS: "/v1/shop/product-variants/{productVariantId}/suppliers",
+    /** Reviews management */
+    REVIEWS: "/v1/shop/reviews",
+    /** Single review */
+    REVIEW: "/v1/shop/reviews/{productReviewId}",
+};
+//# sourceMappingURL=endpoints.js.map

package/lib/services/product/endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../../../src/services/product/endpoints.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;GAEG;AACU,QAAA,gBAAgB,GAAG;IAC9B,0BAA0B;IAC1B,YAAY,EAAE,uBAAuB;IAErC,qBAAqB;IACrB,MAAM,EAAE,iBAAiB;IAEzB,mCAAmC;IACnC,OAAO,EAAE,uCAAuC;IAEhD,mCAAmC;IACnC,cAAc,EAAE,8CAA8C;IAE9D,+BAA+B;IAC/B,wBAAwB,EACtB,wDAAwD;IAE1D,uBAAuB;IACvB,gBAAgB,EAAE,wDAAwD;IAE1E,sBAAsB;IACtB,eAAe,EAAE,+CAA+C;IAEhE,gCAAgC;IAChC,oBAAoB,EAAE,oDAAoD;IAE1E,iCAAiC;IACjC,kBAAkB,EAChB,0DAA0D;IAE5D,6BAA6B;IAC7B,cAAc,EAAE,sDAAsD;IAEtE,gCAAgC;IAChC,iBAAiB,EAAE,wDAAwD;IAE3E,yBAAyB;IACzB,OAAO,EAAE,kBAAkB;IAE3B,oBAAoB;IACpB,MAAM,EAAE,oCAAoC;CACpC,CAAC"}