oneentry 1.0.142 → 1.0.144

package/dist/discounts/discountsApi.d.ts

@@ -0,0 +1,76 @@
+import AsyncModules from '../base/asyncModules';
+import type StateModule from '../base/stateModule';
+import type { IError } from '../base/utils';
+import type { BonusTransactionType, IBonusTransactionEntity, ICouponValidationResult, IDiscountsApi, IDiscountsEntity, IDiscountsResponse } from './discountsInterfaces';
+/**
+ * Controllers for working with events
+ * @handle /api/content/events
+ * @class DiscountsApi
+ * @augments AsyncModules
+ * @implements {IDiscountsApi}
+ * @description This class provides methods to interact with events, including subscribing and unsubscribing to product events, and retrieving all subscriptions.
+ */
+export default class DiscountsApi extends AsyncModules implements IDiscountsApi {
+    protected state: StateModule;
+    protected _url: string;
+    /**
+     * Initializes the Constructor for DiscountsApi class with the provided state module.
+     * @class DiscountsApi
+     * @augments AsyncModules
+     * @implements {DiscountsApi}
+     * @param {StateModule} state - The state module containing the base URL and other configurations.
+     * @description Initializes the DiscountsApi with the provided state module.
+     */
+    constructor(state: StateModule);
+    /**
+     * Return all discounts.
+     * @handleName getAllDiscounts
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {number} [offset] - Optional parameter for pagination. Default: 0.
+     * @param {number} [limit] - Optional parameter for pagination. Default: 30.
+     * @param {string} [type] - Optional parameter to filter discounts by type.
+     * @returns {Promise<IDiscountsResponse | IError>} Returns an object containing all discounts or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Fetches all discounts from the server.
+     */
+    getAllDiscounts(langCode?: string, offset?: number, limit?: number, type?: 'DISCOUNT' | 'BONUS' | 'PERSONAL_DISCOUNT'): Promise<IDiscountsResponse | IError>;
+    /**
+     * Get discount by marker
+     * @handleName getDiscountByMarker
+     * @param {string} marker - Textual identifier of the discount storage object. Example: "discount_storage".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IDiscountsEntity | IError>} Returns an object containing discount by marker or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Fetches a discount by its marker.
+     */
+    getDiscountByMarker(marker: string, langCode?: string): Promise<IDiscountsEntity | IError>;
+    /**
+     * Get bonus balance of the current user.
+     * @handleName getBonusBalance
+     * @returns {Promise<IDiscountsEntity | IError>} Returns bonus balance or an error object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getBonusBalance(): Promise<IDiscountsEntity | IError>;
+    /**
+     * Get bonus transaction history of the current user.
+     * @handleName getBonusHistory
+     * @param {BonusTransactionType} [type] - Transaction type filter.
+     * @param {string} [dateFrom] - Start date filter.
+     * @param {string} [dateTo] - End date filter.
+     * @param {number} [discountId] - Discount id filter.
+     * @param {number} [moduleId] - Module id filter.
+     * @param {boolean} [isAdmin] - Admin filter.
+     * @returns {Promise<IBonusTransactionEntity[] | IError>} Returns array of bonus transactions or an error object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getBonusHistory(type?: BonusTransactionType, dateFrom?: string, dateTo?: string, discountId?: number, moduleId?: number, isAdmin?: boolean): Promise<IBonusTransactionEntity[] | IError>;
+    /**
+     * Validate discounts coupon
+     * @handleName validateDiscountsCoupon
+     * @param {string} code - The coupon code to validate.
+     * @returns {Promise<ICouponValidationResult | IError>} Returns an coupon validation result or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This function validates a coupon code and returns the result.
+     */
+    validateDiscountsCoupon(code: string): Promise<ICouponValidationResult | IError>;
+}

package/dist/discounts/discountsApi.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const asyncModules_1 = __importDefault(require("../base/asyncModules"));
+/**
+ * Controllers for working with events
+ * @handle /api/content/events
+ * @class DiscountsApi
+ * @augments AsyncModules
+ * @implements {IDiscountsApi}
+ * @description This class provides methods to interact with events, including subscribing and unsubscribing to product events, and retrieving all subscriptions.
+ */
+class DiscountsApi extends asyncModules_1.default {
+    /**
+     * Initializes the Constructor for DiscountsApi class with the provided state module.
+     * @class DiscountsApi
+     * @augments AsyncModules
+     * @implements {DiscountsApi}
+     * @param {StateModule} state - The state module containing the base URL and other configurations.
+     * @description Initializes the DiscountsApi with the provided state module.
+     */
+    constructor(state) {
+        super(state);
+        this._url = state.url + '/api/content/discounts';
+    }
+    /**
+     * Return all discounts.
+     * @handleName getAllDiscounts
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {number} [offset] - Optional parameter for pagination. Default: 0.
+     * @param {number} [limit] - Optional parameter for pagination. Default: 30.
+     * @param {string} [type] - Optional parameter to filter discounts by type.
+     * @returns {Promise<IDiscountsResponse | IError>} Returns an object containing all discounts or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Fetches all discounts from the server.
+     */
+    async getAllDiscounts(langCode = this.state.lang, offset = 0, limit = 30, type) {
+        const query = {
+            langCode,
+            offset,
+            limit,
+            type,
+        };
+        const data = await this._fetchGet(`?` + this._queryParamsToString(query));
+        return this._normalizeData(data);
+    }
+    /**
+     * Get discount by marker
+     * @handleName getDiscountByMarker
+     * @param {string} marker - Textual identifier of the discount storage object. Example: "discount_storage".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IDiscountsEntity | IError>} Returns an object containing discount by marker or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Fetches a discount by its marker.
+     */
+    async getDiscountByMarker(marker, langCode = this.state.lang) {
+        const query = {
+            marker: '',
+            langCode,
+        };
+        const data = await this._fetchGet(`/marker/${marker}?` + this._queryParamsToString(query));
+        return this._normalizeData(data);
+    }
+    /**
+     * Get bonus balance of the current user.
+     * @handleName getBonusBalance
+     * @returns {Promise<IDiscountsEntity | IError>} Returns bonus balance or an error object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    async getBonusBalance() {
+        const data = await this._fetchGet(`/bonus-balance`);
+        return this._normalizeData(data);
+    }
+    /**
+     * Get bonus transaction history of the current user.
+     * @handleName getBonusHistory
+     * @param {BonusTransactionType} [type] - Transaction type filter.
+     * @param {string} [dateFrom] - Start date filter.
+     * @param {string} [dateTo] - End date filter.
+     * @param {number} [discountId] - Discount id filter.
+     * @param {number} [moduleId] - Module id filter.
+     * @param {boolean} [isAdmin] - Admin filter.
+     * @returns {Promise<IBonusTransactionEntity[] | IError>} Returns array of bonus transactions or an error object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    async getBonusHistory(type, dateFrom, dateTo, discountId, moduleId, isAdmin) {
+        const query = {
+            type,
+            dateFrom,
+            dateTo,
+            discountId,
+            moduleId,
+            isAdmin,
+        };
+        const data = await this._fetchGet(`/bonus-balance/history?` + this._queryParamsToString(query));
+        return this._normalizeData(data);
+    }
+    /**
+     * Validate discounts coupon
+     * @handleName validateDiscountsCoupon
+     * @param {string} code - The coupon code to validate.
+     * @returns {Promise<ICouponValidationResult | IError>} Returns an coupon validation result or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This function validates a coupon code and returns the result.
+     */
+    async validateDiscountsCoupon(code) {
+        const query = {
+            code,
+        };
+        const data = await this._fetchGet(`/coupons/validate?` + this._queryParamsToString(query));
+        return this._normalizeData(data);
+    }
+}
+exports.default = DiscountsApi;

package/dist/discounts/discountsInterfaces.d.ts

@@ -0,0 +1,217 @@
+import type { IError } from '../base/utils';
+/**
+ * Interface for the Discounts API module.
+ * @interface IDiscountsApi
+ */
+interface IDiscountsApi {
+    /**
+     * Return all discounts.
+     * @handleName getAllSubscriptions
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {number} [offset] - Optional parameter for pagination. Default: 0.
+     * @param {number} [limit] - Optional parameter for pagination. Default: 30.
+     * @param {string} [type] - Optional parameter to filter discounts by type.
+     * @returns {Promise<IDiscountsResponse | IError>} Returns an object containing all discounts or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Fetches all discounts from the server.
+     */
+    getAllDiscounts(langCode?: string, offset?: number, limit?: number, type?: 'DISCOUNT' | 'BONUS' | 'PERSONAL_DISCOUNT'): Promise<IDiscountsResponse | IError>;
+    /**
+     * Get discount by marker
+     * @handleName getDiscountByMarker
+     * @param {string} marker - Textual identifier of the discount storage object. Example: "discount_storage".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IDiscountsEntity | IError>} Returns an object containing discount by marker or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Fetches a discount by its marker.
+     */
+    getDiscountByMarker(marker: string, langCode: string): Promise<IDiscountsEntity | IError>;
+    /**
+     * Validate discounts coupon
+     * @handleName validateDiscountsCoupon
+     * @param {string} code - The coupon code to validate.
+     * @returns {Promise<ICouponValidationResult | IError>} Returns an coupon validation result or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This function validates a coupon code and returns the result.
+     */
+    validateDiscountsCoupon(code: string): Promise<ICouponValidationResult | IError>;
+    /**
+     * Get bonus balance of the current user.
+     * @handleName getBonusBalance
+     * @returns {Promise<IDiscountsEntity | IError>} Returns bonus balance or an error object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getBonusBalance(): Promise<IDiscountsEntity | IError>;
+    /**
+     * Get bonus transaction history of the current user.
+     * @handleName getBonusHistory
+     * @param {string} [type] - Transaction type filter.
+     * @param {string} [dateFrom] - Start date filter.
+     * @param {string} [dateTo] - End date filter.
+     * @param {number} [discountId] - Discount id filter.
+     * @param {number} [moduleId] - Module id filter.
+     * @param {boolean} [isAdmin] - Admin filter.
+     * @returns {Promise<IBonusTransactionEntity[] | IError>} Returns array of bonus transactions or an error object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getBonusHistory(type?: BonusTransactionType, dateFrom?: string, dateTo?: string, discountId?: number, moduleId?: number, isAdmin?: boolean): Promise<IBonusTransactionEntity[] | IError>;
+}
+/**
+ * Query parameters for fetching discounts.
+ * @interface IDiscountsQuery
+ * @property {'DISCOUNT' | 'BONUS' | 'PERSONAL_DISCOUNT'} [type] - Filter discounts by type.
+ * @property {string} langCode - The language code for localization. Example: "en_US".
+ * @property {number} [offset] - Offset for pagination. Default: 0.
+ * @property {number} [limit] - Limit for pagination. Default: 30.
+ */
+interface IDiscountsQuery {
+    type?: 'DISCOUNT' | 'BONUS' | 'PERSONAL_DISCOUNT';
+    langCode: string;
+    offset?: number;
+    limit?: number;
+}
+/**
+ * Represents a discount condition.
+ * @interface IDiscountCondition
+ * @property {string} type - The type of discount condition.
+ * @property {string} [value] - The value associated with the discount condition.
+ */
+interface IDiscountCondition {
+    type: 'PRODUCT' | 'CATEGORY' | 'ATTRIBUTE' | 'PRODUCT_IN_CART' | 'CATEGORY_IN_CART' | 'MIN_CART_AMOUNT' | 'USER_LTV' | 'USER_ATTRIBUTE';
+    value: string;
+}
+/**
+ * Represents a discount entity.
+ * @interface IDiscountsEntity
+ * @property {number} id - The unique identifier of the discount.
+ * @property {number} [attributeSetId] - The identifier of the discount.
+ * @property {object} [localizeInfos] - The name of the discount.
+ * @property {number} [version] - The version of the discount.
+ * @property {string} [identifier] - The identifier of the discount.
+ * @property {string} [type] - The type of the discount.
+ * @property {string} [startDate] - The start date of the discount.
+ * @property {string} [endDate] - The end date of the discount.
+ * @property {Record<string, unknown>} [discountValue] - The value of the discount.
+ * @property {string} [conditionLogic] - The logic of the discount. Possible values are "AND" | "OR".
+ * @property {IDiscountCondition[]} [conditions] - The conditions of the discount.
+ * @property {object} [exclusions] - The exclusions of the discount.
+ * @property {object} [gifts] - The gifts of the discount.
+ * @property {boolean} [giftsReplaceCartItems] - Whether the gifts replace cart items.
+ * @property {object} [userGroups] - The user groups of the discount.
+ * @property {object} [userExclusions] - The user exclusions of the discount.
+ * @property {object} [attributeValues] - The attribute values of the discount.
+ * @property {string} [attributeSetIdentifier] - The identifier of the attribute set.
+ * @property {Record<string, unknown>} [bonusEvent] - Bonus event configuration.
+ */
+interface IDiscountsEntity {
+    id: number;
+    attributeSetId?: number;
+    localizeInfos?: object;
+    version?: number;
+    identifier?: string;
+    type: 'DISCOUNT' | 'BONUS' | 'PERSONAL_DISCOUNT';
+    startDate?: string;
+    endDate?: string;
+    discountValue?: Record<string, unknown>;
+    conditionLogic?: 'AND' | 'OR';
+    conditions?: IDiscountCondition[];
+    exclusions?: object;
+    gifts?: object;
+    giftsReplaceCartItems?: boolean;
+    userGroups?: object;
+    userExclusions?: object;
+    attributeValues?: object;
+    attributeSetIdentifier?: string;
+    bonusEvent?: Record<string, unknown>;
+}
+/**
+ * Paginated response for discounts list.
+ * @interface IDiscountsResponse
+ * @property {IDiscountsEntity[]} items - Array of discount entities.
+ * @property {number} total - Total number of discounts.
+ */
+interface IDiscountsResponse {
+    items: IDiscountsEntity[];
+    total: number;
+}
+/**
+ * Request body for coupon validation.
+ * @interface IDiscountsValidateCoupon
+ * @property {string} code - The coupon code to validate.
+ */
+interface IDiscountsValidateCoupon {
+    code: string;
+}
+/**
+ * Result of coupon validation.
+ * @interface ICouponValidationResult
+ * @property {boolean} valid - Whether the coupon is valid.
+ * @property {unknown} [coupon] - Coupon data if the coupon is valid.
+ * @property {string} [error] - Error message if the coupon is invalid.
+ */
+interface ICouponValidationResult {
+    valid: boolean;
+    coupon?: unknown;
+    error?: string;
+}
+/**
+ * Query parameters for fetching a discount by marker.
+ * @interface IDiscountByMarkerQuery
+ * @property {string} langCode - The language code for localization. Example: "en_US".
+ * @property {string} marker - Textual identifier of the discount. Example: "example_discount".
+ */
+interface IDiscountByMarkerQuery {
+    langCode: string;
+    marker: string;
+}
+/**
+ *
+ */
+type BonusTransactionType = 'ACCRUAL' | 'USAGE' | 'REDUCE' | 'REVERSAL_ACCRUAL' | 'REVERSAL_USAGE' | 'EXPIRATION';
+/**
+ * @interface IBonusHistoryQuery
+ * @property {BonusTransactionType} [type] - Transaction type filter.
+ * @property {string} [dateFrom] - Start date filter.
+ * @property {string} [dateTo] - End date filter.
+ * @property {number} [discountId] - Discount id filter.
+ * @property {number} [moduleId] - Module id filter.
+ * @property {boolean} [isAdmin] - Admin filter.
+ */
+interface IBonusHistoryQuery {
+    type?: BonusTransactionType;
+    dateFrom?: string;
+    dateTo?: string;
+    discountId?: number;
+    moduleId?: number;
+    isAdmin?: boolean;
+}
+/**
+ * @interface IBonusTransactionEntity
+ * @property {number} balanceId - Balance id.
+ * @property {number} amount - Transaction amount.
+ * @property {BonusTransactionType} type - Transaction type.
+ * @property {number} [discountId] - Discount id.
+ * @property {number} [moduleId] - Module id.
+ * @property {string} [entityIdentifier] - Entity identifier.
+ * @property {string} [comment] - Comment.
+ * @property {boolean} isAdmin - Admin flag.
+ * @property {number} [remainingAmount] - Remaining amount.
+ * @property {'EVENT' | 'SCHEDULED'} [triggerType] - Trigger type.
+ * @property {string} [expiresAt] - Expiration date.
+ * @property {string} [createdAt] - Creation date.
+ */
+interface IBonusTransactionEntity {
+    balanceId: number;
+    amount: number;
+    type: BonusTransactionType;
+    discountId?: number;
+    moduleId?: number;
+    entityIdentifier?: string;
+    comment?: string;
+    isAdmin: boolean;
+    remainingAmount?: number;
+    triggerType?: 'EVENT' | 'SCHEDULED';
+    expiresAt?: string;
+    createdAt?: string;
+}
+export type { BonusTransactionType, IBonusHistoryQuery, IBonusTransactionEntity, ICouponValidationResult, IDiscountByMarkerQuery, IDiscountCondition, IDiscountsApi, IDiscountsEntity, IDiscountsQuery, IDiscountsResponse, IDiscountsValidateCoupon, };

package/dist/discounts/discountsInterfaces.js

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

package/dist/events/eventsApi.d.ts

@@ -0,0 +1,60 @@
+import AsyncModules from '../base/asyncModules';
+import type StateModule from '../base/stateModule';
+import type { IError } from '../base/utils';
+import type { IEvents, ISubscriptions } from './eventsInterfaces';
+/**
+ * Controllers for working with events
+ * @handle /api/content/events
+ * @class EventsApi
+ * @augments AsyncModules
+ * @implements {IEvents}
+ * @description This class provides methods to interact with events, including subscribing and unsubscribing to product events, and retrieving all subscriptions.
+ */
+export default class EventsApi extends AsyncModules implements IEvents {
+    protected state: StateModule;
+    protected _url: string;
+    /**
+     * Initializes the EventsApi with the provided state module.
+     * @class EventsApi
+     * @augments AsyncModules
+     * @implements {IEvents}
+     * @param {StateModule} state - The state module containing the base URL and other configurations.
+     * @description Initializes the EventsApi with the provided state module.
+     */
+    constructor(state: StateModule);
+    /**
+     * Return all subscriptions to product.
+     * @handleName getAllSubscriptions
+     * @param {number} [offset] - Optional offset for pagination. Default: 0.
+     * @param {number} [limit] - Optional limit for pagination. Default: 30.
+     * @returns {Promise<ISubscriptions | IError>} Returns an object containing all subscriptions or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization.
+     * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
+     */
+    getAllSubscriptions(offset?: number, limit?: number): Promise<ISubscriptions | IError>;
+    /**
+     * Subscribing to an event on a product.
+     * @handleName subscribeByMarker
+     * @param {string} marker - Event marker. Example: "product_price_change".
+     * @param {number} productId - Product id. Example: 12345.
+     * @param {string} [langCode] - Language code. Default: "en_US".=
+     * @returns {Promise<boolean | IError>} Returns true if subscription was successful, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization.
+     * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
+     */
+    subscribeByMarker(marker: string, productId: number, langCode?: string): Promise<boolean | IError>;
+    /**
+     * Unsubscribing to an event on a product.
+     * @handleName unsubscribeByMarker
+     * @param {string} marker - The marker of the event to unsubscribe from. Example: "product_price_change".
+     * @param {number} productId - The ID of the product to unsubscribe from. Example: 12345.
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<any | IError>} - Returns a promise that resolves to the result of the unsubscription operation or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization.
+     * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
+     */
+    unsubscribeByMarker(marker: string, productId: number, langCode?: string): Promise<boolean | IError>;
+}

package/dist/events/eventsApi.js

@@ -0,0 +1,97 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable jsdoc/reject-any-type */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const asyncModules_1 = __importDefault(require("../base/asyncModules"));
+/**
+ * Controllers for working with events
+ * @handle /api/content/events
+ * @class EventsApi
+ * @augments AsyncModules
+ * @implements {IEvents}
+ * @description This class provides methods to interact with events, including subscribing and unsubscribing to product events, and retrieving all subscriptions.
+ */
+class EventsApi extends asyncModules_1.default {
+    /**
+     * Initializes the EventsApi with the provided state module.
+     * @class EventsApi
+     * @augments AsyncModules
+     * @implements {IEvents}
+     * @param {StateModule} state - The state module containing the base URL and other configurations.
+     * @description Initializes the EventsApi with the provided state module.
+     */
+    constructor(state) {
+        super(state);
+        this._url = state.url + '/api/content/events';
+    }
+    /**
+     * Return all subscriptions to product.
+     * @handleName getAllSubscriptions
+     * @param {number} [offset] - Optional offset for pagination. Default: 0.
+     * @param {number} [limit] - Optional limit for pagination. Default: 30.
+     * @returns {Promise<ISubscriptions | IError>} Returns an object containing all subscriptions or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization.
+     * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
+     */
+    async getAllSubscriptions(offset = 0, limit = 30) {
+        const query = {
+            offset,
+            limit,
+        };
+        const result = await this._fetchGet(`/subscriptions?` + this._queryParamsToString(query));
+        return result;
+    }
+    /**
+     * Subscribing to an event on a product.
+     * @handleName subscribeByMarker
+     * @param {string} marker - Event marker. Example: "product_price_change".
+     * @param {number} productId - Product id. Example: 12345.
+     * @param {string} [langCode] - Language code. Default: "en_US".=
+     * @returns {Promise<boolean | IError>} Returns true if subscription was successful, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization.
+     * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
+     */
+    async subscribeByMarker(marker, productId, langCode = this.state.lang) {
+        const body = {
+            locale: langCode,
+            productId,
+        };
+        try {
+            await this._fetchPost(`/subscribe/marker/${marker}`, body);
+            return true;
+        }
+        catch (e) {
+            return e;
+        }
+    }
+    /**
+     * Unsubscribing to an event on a product.
+     * @handleName unsubscribeByMarker
+     * @param {string} marker - The marker of the event to unsubscribe from. Example: "product_price_change".
+     * @param {number} productId - The ID of the product to unsubscribe from. Example: 12345.
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<any | IError>} - Returns a promise that resolves to the result of the unsubscription operation or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization.
+     * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
+     */
+    async unsubscribeByMarker(marker, productId, langCode = this.state.lang) {
+        const body = {
+            productId: productId,
+            locale: langCode,
+        };
+        try {
+            await this._fetchDelete(`/unsubscribe/marker/${marker}`, body);
+            return true;
+        }
+        catch (e) {
+            return e;
+        }
+    }
+}
+exports.default = EventsApi;

package/dist/events/eventsInterfaces.d.ts

@@ -0,0 +1,87 @@
+import type { IError } from '../base/utils';
+/**
+ * Interface for managing event subscriptions related to products.
+ * @interface IEvents
+ * @description This interface defines methods for managing event subscriptions related to products.
+ */
+interface IEvents {
+    /**
+     * Retrieves all subscriptions to products.
+     * @handleName getAllSubscriptions
+     * @param {number} [offset] - Optional offset for pagination. Default: 0.
+     * @param {number} [limit] - Optional limit for pagination. Default: 30.
+     * @returns {Promise<ISubscriptions | IError>} A promise that resolves to a subscriptions object or an error.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method retrieves all subscriptions to products.
+     */
+    getAllSubscriptions(offset?: number, limit?: number): Promise<ISubscriptions | IError>;
+    /**
+     * Subscribes to an event on a product by its marker.
+     * @handleName subscribeByMarker
+     * @param {string} marker - The marker identifying the event. Example: "product_price_change".
+     * @param {number} productId - The ID of the product to subscribe to. Example: 12345.
+     * @param {string} [langCode] - Optional language code for localization. Default: "en_US".
+     * @returns {Promise<boolean | IError>} A promise that resolves to any type or an error.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method subscribes to an event on a product by its marker.
+     */
+    subscribeByMarker(marker: string, productId: number, langCode?: string): Promise<boolean | IError>;
+    /**
+     * Unsubscribes from an event on a product by its marker.
+     * @handleName unsubscribeByMarker
+     * @param {string} marker - The marker identifying the event. Example: "product_price_change".
+     * @param {number} productId - The ID of the product to unsubscribe from. Example: 12345.
+     * @param {string} [langCode] - Optional language code for localization. Default: "en_US".
+     * @returns {Promise<boolean | IError>} A promise that resolves to any type or an error.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method unsubscribes from an event on a product by its marker.
+     */
+    unsubscribeByMarker(marker: string, productId: number, langCode?: string): Promise<boolean | IError>;
+}
+/**
+ * Represents a response from the events API containing a total count and an array of subscription items.
+ * @interface ISubscriptions
+ * @property {number} total - Total number of found records. Example: 100.
+ * @property {ISubscriptionItem[]} items - Array of subscription items, each containing an event marker and a product ID.
+ * @example
+ [
+   {
+     eventMarker: 'product_price_change',
+     productId: 12345
+   },
+   {
+     eventMarker: 'product_stock_update',
+     productId: 67890
+   }
+ ]
+ * @property { string } items.eventMarker - Event marker.
+ * @property { number } items.productId - Product ID.
+ * @description Represents a response from the events API containing a total count and an array of subscription items.
+ */
+interface ISubscriptions {
+    total: number;
+    items: Array<ISubscriptionItem>;
+}
+/**
+ * Represents item from the events API.
+ * @interface ISubscriptionItem
+ * @property { string } eventMarker -Event marker.
+ * @property { number } productId - Product ID.
+ * @description Represents item from the events API.
+ */
+interface ISubscriptionItem {
+    eventMarker: string;
+    productId: number;
+}
+/**
+ * Interface for the body of the subscribe methods.
+ * @interface ISubscribeBody
+ * @property {string} locale - Locale of the user. Example: "en_US".
+ * @property {number} productId - Product ID. Example: 12345.
+ * @description Represents a body for the subscribe methods, containing the locale and product ID.
+ */
+interface ISubscribeBody {
+    locale: string;
+    productId: number;
+}
+export type { IEvents, ISubscribeBody, ISubscriptions };

package/dist/events/eventsInterfaces.js

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