oneentry 1.0.149 → 1.0.150

package/dist/subscriptions/subscriptionsInterfaces.d.ts

@@ -0,0 +1,90 @@
+import type { IError } from '../base/utils';
+/**
+ * Interface for the Subscriptions API module.
+ * @interface ISubscriptionsApi
+ * @description This interface defines methods for managing paid subscriptions: creating, cancelling, recovering, and listing available/active subscriptions.
+ */
+interface ISubscriptionsApi {
+    /**
+     * Create a new subscription and get a payment session for it.
+     * @handleName subscribe
+     * @param {ISubscribe} body - Subscription body. Example: `{ marker: "premium" }`.
+     * @returns {Promise<ICreatedSubscription | IError>} Returns the created payment session for the subscription.
+     * @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}.
+     */
+    subscribe(body: ISubscribe): Promise<ICreatedSubscription | IError>;
+    /**
+     * Cancel a subscription.
+     * @handleName cancelSubscription
+     * @param {ICancelSubscription} body - Subscription body. Example: `{ marker: "premium" }`.
+     * @returns {Promise<boolean | IError>} Returns true if the subscription was cancelled, 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}.
+     */
+    cancelSubscription(body: ICancelSubscription): Promise<boolean | IError>;
+    /**
+     * Get all available subscription markers.
+     * @handleName getAllSubscriptions
+     * @returns {Promise<string[] | IError>} Returns an array of available subscription markers.
+     * @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(): Promise<string[] | IError>;
+    /**
+     * Get markers of the user's active subscriptions.
+     * @handleName getActiveSubscriptions
+     * @returns {Promise<string[] | IError>} Returns an array of active subscription markers.
+     * @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}.
+     */
+    getActiveSubscriptions(): Promise<string[] | IError>;
+    /**
+     * Recover a subscription through the Stripe Billing Portal.
+     * @handleName recoverSubscriptions
+     * @param {ICancelSubscription} body - Subscription body. Example: `{ marker: "premium" }`.
+     * @returns {Promise<boolean | IError>} Returns true if the recovery request was accepted, 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}.
+     */
+    recoverSubscriptions(body: ICancelSubscription): Promise<boolean | IError>;
+}
+/**
+ * Body for creating a subscription.
+ * @interface ISubscribe
+ * @property {string} marker - Subscription marker. Example: "premium".
+ * @description Body for creating a subscription.
+ */
+interface ISubscribe {
+    marker: string;
+}
+/**
+ * Body for cancelling or recovering a subscription.
+ * @interface ICancelSubscription
+ * @property {string} marker - Subscription marker. Example: "premium".
+ * @description Body for cancelling or recovering a subscription.
+ */
+interface ICancelSubscription {
+    marker: string;
+}
+/**
+ * Created subscription payment session.
+ * @interface ICreatedSubscription
+ * @property {number} id - Payment session identifier. Example: 1.
+ * @property {number} amount - Amount to be paid. Example: 100.
+ * @property {string} paymentUrl - Payment page URL. Example: "https://checkout.stripe.com/c/pay/...".
+ * @property {string} status - Payment session status. Example: "waiting".
+ * @description Created subscription payment session returned after subscribing.
+ */
+interface ICreatedSubscription {
+    id: number;
+    amount: number;
+    paymentUrl: string;
+    status: string;
+}
+export type { ICancelSubscription, ICreatedSubscription, ISubscribe, ISubscriptionsApi, };

package/dist/subscriptions/subscriptionsInterfaces.js

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

package/dist/subscriptions/subscriptionsSchemas.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Validation schemas for Subscriptions module
+ * @description Zod schemas for validating subscriptions-related API responses
+ */
+import { z } from 'zod';
+/**
+ * Created subscription schema
+ * @description Schema for the payment session returned after creating a subscription
+ */
+export declare const CreatedSubscriptionSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    amount: z.ZodNumber;
+    paymentUrl: z.ZodString;
+    status: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Subscription markers schema
+ * @description Schema for arrays of subscription markers (available and active subscriptions)
+ */
+export declare const SubscriptionMarkersSchema: z.ZodArray<z.ZodString>;

package/dist/subscriptions/subscriptionsSchemas.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscriptionMarkersSchema = exports.CreatedSubscriptionSchema = void 0;
+/**
+ * Validation schemas for Subscriptions module
+ * @description Zod schemas for validating subscriptions-related API responses
+ */
+const zod_1 = require("zod");
+/**
+ * Created subscription schema
+ * @description Schema for the payment session returned after creating a subscription
+ */
+exports.CreatedSubscriptionSchema = zod_1.z.object({
+    id: zod_1.z.number(),
+    amount: zod_1.z.number(),
+    paymentUrl: zod_1.z.string(),
+    status: zod_1.z.string(),
+});
+/**
+ * Subscription markers schema
+ * @description Schema for arrays of subscription markers (available and active subscriptions)
+ */
+exports.SubscriptionMarkersSchema = zod_1.z.array(zod_1.z.string());

package/dist/user-activity/userActivityApi.d.ts

@@ -0,0 +1,30 @@
+import AsyncModules from '../base/asyncModules';
+import type StateModule from '../base/stateModule';
+import type { IError } from '../base/utils';
+import type { ITrackActivity, IUserActivityApi } from './userActivityInterfaces';
+/**
+ * Controllers for working with user activity.
+ * @handle /api/content/user-activity
+ * @class UserActivityApi
+ * @augments AsyncModules
+ * @implements {IUserActivityApi}
+ * @description This class provides methods to track user/guest activity events.
+ */
+export default class UserActivityApi extends AsyncModules implements IUserActivityApi {
+    protected state: StateModule;
+    protected _url: string;
+    /**
+     * Constructor for UserActivityApi class.
+     * @param {StateModule} state - The state module.
+     */
+    constructor(state: StateModule);
+    /**
+     * Track a user or guest activity event.
+     * @handleName trackUserActivity
+     * @param {ITrackActivity} body - Activity event body. Example: `{ type: "product_view", productId: 12345 }`.
+     * @returns {Promise<boolean | IError>} Returns true if the event was recorded, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Records an activity event for the current authorized user or guest.
+     */
+    trackUserActivity(body: ITrackActivity): Promise<boolean | IError>;
+}

package/dist/user-activity/userActivityApi.js

@@ -0,0 +1,42 @@
+"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 user activity.
+ * @handle /api/content/user-activity
+ * @class UserActivityApi
+ * @augments AsyncModules
+ * @implements {IUserActivityApi}
+ * @description This class provides methods to track user/guest activity events.
+ */
+class UserActivityApi extends asyncModules_1.default {
+    /**
+     * Constructor for UserActivityApi class.
+     * @param {StateModule} state - The state module.
+     */
+    constructor(state) {
+        super(state);
+        this._url = state.url + '/api/content/user-activity';
+    }
+    /**
+     * Track a user or guest activity event.
+     * @handleName trackUserActivity
+     * @param {ITrackActivity} body - Activity event body. Example: `{ type: "product_view", productId: 12345 }`.
+     * @returns {Promise<boolean | IError>} Returns true if the event was recorded, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Records an activity event for the current authorized user or guest.
+     */
+    async trackUserActivity(body) {
+        try {
+            await this._fetchPost(`/track`, body);
+            return true;
+        }
+        catch (e) {
+            return e;
+        }
+    }
+}
+exports.default = UserActivityApi;

package/dist/user-activity/userActivityInterfaces.d.ts

@@ -0,0 +1,42 @@
+import type { IError } from '../base/utils';
+/**
+ * Interface for the UserActivity API module.
+ * @interface IUserActivityApi
+ * @description This interface defines methods for tracking user/guest activity events.
+ */
+interface IUserActivityApi {
+    /**
+     * Track a user or guest activity event.
+     * @handleName trackUserActivity
+     * @param {ITrackActivity} body - Activity event body. Example: `{ type: "product_view", productId: 12345 }`.
+     * @returns {Promise<boolean | IError>} Returns true if the event was recorded, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Records an activity event for the current authorized user or guest.
+     */
+    trackUserActivity(body: ITrackActivity): Promise<boolean | IError>;
+}
+/**
+ * User activity event type.
+ * @description Type of the tracked user activity event.
+ */
+type TUserActivityType = 'product_view' | 'page_view' | 'category_view' | 'search' | 'product_add_to_cart' | 'product_remove_from_cart' | 'product_add_to_wishlist' | 'product_remove_from_wishlist' | 'product_purchase' | 'product_rating';
+/**
+ * Body for tracking a user activity event.
+ * @interface ITrackActivity
+ * @property {TUserActivityType} type - Activity event type. Example: "product_view".
+ * @property {number} [productId] - Product identifier. Example: 12345.
+ * @property {number} [pageId] - Page identifier (for page_view, category_view). Example: 7.
+ * @property {number} [categoryId] - Legacy category identifier. Example: 67.
+ * @property {string} [query] - Search query (for type=search). Example: "iphone case".
+ * @property {Record<string, unknown>} [meta] - Arbitrary meta information (source block, A/B variant, scroll-depth).
+ * @description Body for tracking a user activity event.
+ */
+interface ITrackActivity {
+    type: TUserActivityType;
+    productId?: number;
+    pageId?: number;
+    categoryId?: number;
+    query?: string;
+    meta?: Record<string, unknown>;
+}
+export type { ITrackActivity, IUserActivityApi, TUserActivityType };

package/dist/user-activity/userActivityInterfaces.js

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

package/dist/users/usersApi.d.ts

@@ -1,7 +1,7 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
 import type { IError } from '../base/utils';
-import type { IUserBody, IUserEntity, IUsersApi } from './usersInterfaces';
+import type { ICartAddItem, ICartResponse, ICartSet, IUserBody, IUserEntity, IUsersApi, IWishlistAddItem, IWishlistResponse, IWishlistSet } from './usersInterfaces';
 /**
  * Controllers for working with users
  * @handle /api/content/users
@@ -140,4 +140,82 @@ export default class UsersApi extends AsyncModules implements IUsersApi {
      * @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}.
      */
     deleteFCMToken(token: string): Promise<boolean | IError>;
+    /**
+     * Get the current user's or guest's cart.
+     * @handleName getCart
+     * @returns {Promise<ICartResponse | IError>} Returns the cart with its items and total.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    getCart(): Promise<ICartResponse | IError>;
+    /**
+     * Replace the current user's or guest's cart.
+     * @handleName setCart
+     * @param {ICartSet} body - New cart contents. Example: `{ items: [{ productId: 1, qty: 2 }] }`.
+     * @returns {Promise<ICartResponse | IError>} Returns the updated cart.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    setCart(body: ICartSet): Promise<ICartResponse | IError>;
+    /**
+     * Add an item to the cart (or update qty of an existing one).
+     * @handleName addCartItem
+     * @param {ICartAddItem} body - Item to add. Example: `{ productId: 1, qty: 2 }`.
+     * @returns {Promise<ICartResponse | IError>} Returns the updated cart.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    addCartItem(body: ICartAddItem): Promise<ICartResponse | IError>;
+    /**
+     * Remove an item from the cart.
+     * @handleName removeCartItem
+     * @param {number} productId - Product identifier. Example: 12345.
+     * @returns {Promise<ICartResponse | IError>} Returns the updated cart.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    removeCartItem(productId: number): Promise<ICartResponse | IError>;
+    /**
+     * Get the current user's or guest's wishlist.
+     * @handleName getWishlist
+     * @returns {Promise<IWishlistResponse | IError>} Returns the wishlist with its items and total.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    getWishlist(): Promise<IWishlistResponse | IError>;
+    /**
+     * Replace the current user's or guest's wishlist.
+     * @handleName setWishlist
+     * @param {IWishlistSet} body - New wishlist contents. Example: `{ items: [{ productId: 1 }] }`.
+     * @returns {Promise<IWishlistResponse | IError>} Returns the updated wishlist.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    setWishlist(body: IWishlistSet): Promise<IWishlistResponse | IError>;
+    /**
+     * Add an item to the wishlist.
+     * @handleName addWishlistItem
+     * @param {IWishlistAddItem} body - Item to add. Example: `{ productId: 1 }`.
+     * @returns {Promise<IWishlistResponse | IError>} Returns the updated wishlist.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    addWishlistItem(body: IWishlistAddItem): Promise<IWishlistResponse | IError>;
+    /**
+     * Remove an item from the wishlist.
+     * @handleName removeWishlistItem
+     * @param {number} productId - Product identifier. Example: 12345.
+     * @returns {Promise<IWishlistResponse | IError>} Returns the updated wishlist.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    removeWishlistItem(productId: number): Promise<IWishlistResponse | IError>;
 }

package/dist/users/usersApi.js

@@ -167,5 +167,115 @@ class UsersApi extends asyncModules_1.default {
         const result = await this._fetchDelete(`/me/fcm-token/${token}`);
         return result;
     }
+    /**
+     * Get the current user's or guest's cart.
+     * @handleName getCart
+     * @returns {Promise<ICartResponse | IError>} Returns the cart with its items and total.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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 getCart() {
+        const result = await this._fetchGet('/me/cart');
+        const validated = this._validateResponse(result, usersSchemas_1.CartResponseSchema);
+        return this._normalizeData(validated);
+    }
+    /**
+     * Replace the current user's or guest's cart.
+     * @handleName setCart
+     * @param {ICartSet} body - New cart contents. Example: `{ items: [{ productId: 1, qty: 2 }] }`.
+     * @returns {Promise<ICartResponse | IError>} Returns the updated cart.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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 setCart(body) {
+        const result = await this._fetchPut('/me/cart', body);
+        const validated = this._validateResponse(result, usersSchemas_1.CartResponseSchema);
+        return this._normalizeData(validated);
+    }
+    /**
+     * Add an item to the cart (or update qty of an existing one).
+     * @handleName addCartItem
+     * @param {ICartAddItem} body - Item to add. Example: `{ productId: 1, qty: 2 }`.
+     * @returns {Promise<ICartResponse | IError>} Returns the updated cart.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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 addCartItem(body) {
+        const result = await this._fetchPost('/me/cart/items', body);
+        const validated = this._validateResponse(result, usersSchemas_1.CartResponseSchema);
+        return this._normalizeData(validated);
+    }
+    /**
+     * Remove an item from the cart.
+     * @handleName removeCartItem
+     * @param {number} productId - Product identifier. Example: 12345.
+     * @returns {Promise<ICartResponse | IError>} Returns the updated cart.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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 removeCartItem(productId) {
+        const result = await this._fetchDelete(`/me/cart/items/${productId}`);
+        const validated = this._validateResponse(result, usersSchemas_1.CartResponseSchema);
+        return this._normalizeData(validated);
+    }
+    /**
+     * Get the current user's or guest's wishlist.
+     * @handleName getWishlist
+     * @returns {Promise<IWishlistResponse | IError>} Returns the wishlist with its items and total.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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 getWishlist() {
+        const result = await this._fetchGet('/me/wishlist');
+        const validated = this._validateResponse(result, usersSchemas_1.WishlistResponseSchema);
+        return this._normalizeData(validated);
+    }
+    /**
+     * Replace the current user's or guest's wishlist.
+     * @handleName setWishlist
+     * @param {IWishlistSet} body - New wishlist contents. Example: `{ items: [{ productId: 1 }] }`.
+     * @returns {Promise<IWishlistResponse | IError>} Returns the updated wishlist.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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 setWishlist(body) {
+        const result = await this._fetchPut('/me/wishlist', body);
+        const validated = this._validateResponse(result, usersSchemas_1.WishlistResponseSchema);
+        return this._normalizeData(validated);
+    }
+    /**
+     * Add an item to the wishlist.
+     * @handleName addWishlistItem
+     * @param {IWishlistAddItem} body - Item to add. Example: `{ productId: 1 }`.
+     * @returns {Promise<IWishlistResponse | IError>} Returns the updated wishlist.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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 addWishlistItem(body) {
+        const result = await this._fetchPost('/me/wishlist/items', body);
+        const validated = this._validateResponse(result, usersSchemas_1.WishlistResponseSchema);
+        return this._normalizeData(validated);
+    }
+    /**
+     * Remove an item from the wishlist.
+     * @handleName removeWishlistItem
+     * @param {number} productId - Product identifier. Example: 12345.
+     * @returns {Promise<IWishlistResponse | IError>} Returns the updated wishlist.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization (or a guest context).
+     * @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 removeWishlistItem(productId) {
+        const result = await this._fetchDelete(`/me/wishlist/items/${productId}`);
+        const validated = this._validateResponse(result, usersSchemas_1.WishlistResponseSchema);
+        return this._normalizeData(validated);
+    }
 }
 exports.default = UsersApi;

package/dist/users/usersInterfaces.d.ts

@@ -132,6 +132,84 @@ interface IUsersApi {
      * @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}.
      */
     deleteFCMToken(token: string): Promise<boolean | IError>;
+    /**
+     * Get the current user's or guest's cart.
+     * @handleName getCart
+     * @returns {Promise<ICartResponse | IError>} A promise resolving to the cart with its items and total, or an error.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    getCart(): Promise<ICartResponse | IError>;
+    /**
+     * Replace the current user's or guest's cart.
+     * @handleName setCart
+     * @param {ICartSet} body - New cart contents. Example: `{ items: [{ productId: 1, qty: 2 }] }`.
+     * @returns {Promise<ICartResponse | IError>} A promise resolving to the updated cart, or an error.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    setCart(body: ICartSet): Promise<ICartResponse | IError>;
+    /**
+     * Add an item to the cart (or update qty of an existing one).
+     * @handleName addCartItem
+     * @param {ICartAddItem} body - Item to add. Example: `{ productId: 1, qty: 2 }`.
+     * @returns {Promise<ICartResponse | IError>} A promise resolving to the updated cart, or an error.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    addCartItem(body: ICartAddItem): Promise<ICartResponse | IError>;
+    /**
+     * Remove an item from the cart.
+     * @handleName removeCartItem
+     * @param {number} productId - Product identifier. Example: 12345.
+     * @returns {Promise<ICartResponse | IError>} A promise resolving to the updated cart, or an error.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    removeCartItem(productId: number): Promise<ICartResponse | IError>;
+    /**
+     * Get the current user's or guest's wishlist.
+     * @handleName getWishlist
+     * @returns {Promise<IWishlistResponse | IError>} A promise resolving to the wishlist with its items and total, or an error.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    getWishlist(): Promise<IWishlistResponse | IError>;
+    /**
+     * Replace the current user's or guest's wishlist.
+     * @handleName setWishlist
+     * @param {IWishlistSet} body - New wishlist contents. Example: `{ items: [{ productId: 1 }] }`.
+     * @returns {Promise<IWishlistResponse | IError>} A promise resolving to the updated wishlist, or an error.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    setWishlist(body: IWishlistSet): Promise<IWishlistResponse | IError>;
+    /**
+     * Add an item to the wishlist.
+     * @handleName addWishlistItem
+     * @param {IWishlistAddItem} body - Item to add. Example: `{ productId: 1 }`.
+     * @returns {Promise<IWishlistResponse | IError>} A promise resolving to the updated wishlist, or an error.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    addWishlistItem(body: IWishlistAddItem): Promise<IWishlistResponse | IError>;
+    /**
+     * Remove an item from the wishlist.
+     * @handleName removeWishlistItem
+     * @param {number} productId - Product identifier. Example: 12345.
+     * @returns {Promise<IWishlistResponse | IError>} A promise resolving to the updated wishlist, or an error.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization (or a guest context).
+     * @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}.
+     */
+    removeWishlistItem(productId: number): Promise<IWishlistResponse | IError>;
 }
 /**
  * @interface IUserEntity
@@ -224,4 +302,80 @@ interface IUserBody {
     notificationData?: INotificationData;
     state?: Record<string, unknown>;
 }
-export type { IUserBody, IUserEntity, IUsersApi };
+/**
+ * @interface ICartItem
+ * @property {number} productId - Product identifier. Example: 1.
+ * @property {number} qty - Quantity of the product in the cart. Example: 2.
+ * @property {string} [addedAt] - ISO date when the item was added. Example: "2026-05-30T10:00:00.000Z".
+ * @description A single cart item.
+ */
+interface ICartItem {
+    productId: number;
+    qty: number;
+    addedAt?: string;
+}
+/**
+ * @interface ICartResponse
+ * @property {ICartItem[]} items - Cart items.
+ * @property {number} total - Total number of items in the cart. Example: 3.
+ * @description The user's or guest's cart.
+ */
+interface ICartResponse {
+    items: ICartItem[];
+    total: number;
+}
+/**
+ * @interface ICartSet
+ * @property {ICartItem[]} items - New cart items. Example: `[{ productId: 1, qty: 2 }]`.
+ * @description Body for replacing the whole cart.
+ */
+interface ICartSet {
+    items: ICartItem[];
+}
+/**
+ * @interface ICartAddItem
+ * @property {number} productId - Product identifier. Example: 1.
+ * @property {number} qty - Quantity to add. Example: 2.
+ * @description Body for adding a single item to the cart.
+ */
+interface ICartAddItem {
+    productId: number;
+    qty: number;
+}
+/**
+ * @interface IWishlistItem
+ * @property {number} productId - Product identifier. Example: 1.
+ * @property {string} [addedAt] - ISO date when the item was added. Example: "2026-05-30T10:00:00.000Z".
+ * @description A single wishlist item.
+ */
+interface IWishlistItem {
+    productId: number;
+    addedAt?: string;
+}
+/**
+ * @interface IWishlistResponse
+ * @property {IWishlistItem[]} items - Wishlist items.
+ * @property {number} total - Total number of items in the wishlist. Example: 3.
+ * @description The user's or guest's wishlist.
+ */
+interface IWishlistResponse {
+    items: IWishlistItem[];
+    total: number;
+}
+/**
+ * @interface IWishlistSet
+ * @property {IWishlistItem[]} items - New wishlist items. Example: `[{ productId: 1 }]`.
+ * @description Body for replacing the whole wishlist.
+ */
+interface IWishlistSet {
+    items: IWishlistItem[];
+}
+/**
+ * @interface IWishlistAddItem
+ * @property {number} productId - Product identifier. Example: 1.
+ * @description Body for adding a single item to the wishlist.
+ */
+interface IWishlistAddItem {
+    productId: number;
+}
+export type { ICartAddItem, ICartItem, ICartResponse, ICartSet, IUserBody, IUserEntity, IUsersApi, IWishlistAddItem, IWishlistItem, IWishlistResponse, IWishlistSet, };