oneentry 1.0.149 → 1.0.151

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, };

package/dist/users/usersSchemas.d.ts

@@ -30,3 +30,43 @@ export declare const DeleteUserResponseSchema: z.ZodObject<{
     success: z.ZodBoolean;
     message: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * Cart item schema
+ * @description Schema for a single cart item
+ */
+export declare const CartItemSchema: z.ZodObject<{
+    productId: z.ZodNumber;
+    qty: z.ZodNumber;
+    addedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Cart response schema
+ * @description Schema for the user's or guest's cart
+ */
+export declare const CartResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        productId: z.ZodNumber;
+        qty: z.ZodNumber;
+        addedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Wishlist item schema
+ * @description Schema for a single wishlist item
+ */
+export declare const WishlistItemSchema: z.ZodObject<{
+    productId: z.ZodNumber;
+    addedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Wishlist response schema
+ * @description Schema for the user's or guest's wishlist
+ */
+export declare const WishlistResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        productId: z.ZodNumber;
+        addedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;

package/dist/users/usersSchemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DeleteUserResponseSchema = exports.UpdateUserResponseSchema = exports.UserResponseSchema = void 0;
+exports.WishlistResponseSchema = exports.WishlistItemSchema = exports.CartResponseSchema = exports.CartItemSchema = exports.DeleteUserResponseSchema = exports.UpdateUserResponseSchema = exports.UserResponseSchema = void 0;
 /**
  * Validation schemas for Users module
  * @description Zod schemas for validating users-related API responses
@@ -23,3 +23,36 @@ exports.DeleteUserResponseSchema = zod_1.z.object({
     success: zod_1.z.boolean(),
     message: zod_1.z.string().optional(),
 });
+/**
+ * Cart item schema
+ * @description Schema for a single cart item
+ */
+exports.CartItemSchema = zod_1.z.object({
+    productId: zod_1.z.number(),
+    qty: zod_1.z.number(),
+    addedAt: zod_1.z.string().optional(),
+});
+/**
+ * Cart response schema
+ * @description Schema for the user's or guest's cart
+ */
+exports.CartResponseSchema = zod_1.z.object({
+    items: zod_1.z.array(exports.CartItemSchema),
+    total: zod_1.z.number(),
+});
+/**
+ * Wishlist item schema
+ * @description Schema for a single wishlist item
+ */
+exports.WishlistItemSchema = zod_1.z.object({
+    productId: zod_1.z.number(),
+    addedAt: zod_1.z.string().optional(),
+});
+/**
+ * Wishlist response schema
+ * @description Schema for the user's or guest's wishlist
+ */
+exports.WishlistResponseSchema = zod_1.z.object({
+    items: zod_1.z.array(exports.WishlistItemSchema),
+    total: zod_1.z.number(),
+});

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "oneentry",
-  "version": "1.0.149",
+  "version": "1.0.151",
   "description": "OneEntry NPM package",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
-    "/dist"
+    "/dist",
+    "/changelog.md"
   ],
   "bin": {
     "oneentry": "./configure.js"