@serik_lav/api-fe 0.47.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (279) hide show
  1. package/CHANGELOG.md +906 -0
  2. package/README.md +1100 -0
  3. package/dist/entities/ad/api/adApi.d.ts +6 -0
  4. package/dist/entities/ad/api/adApi.d.ts.map +1 -0
  5. package/dist/entities/ad/api/adApi.js +29 -0
  6. package/dist/entities/ad/api/adApi.js.map +1 -0
  7. package/dist/entities/ad/index.d.ts +3 -0
  8. package/dist/entities/ad/index.d.ts.map +1 -0
  9. package/dist/entities/ad/index.js +3 -0
  10. package/dist/entities/ad/index.js.map +1 -0
  11. package/dist/entities/ad/model/types.d.ts +22 -0
  12. package/dist/entities/ad/model/types.d.ts.map +1 -0
  13. package/dist/entities/ad/model/types.js +1 -0
  14. package/dist/entities/ad/model/types.js.map +1 -0
  15. package/dist/entities/auth/api/authApi.d.ts +9 -0
  16. package/dist/entities/auth/api/authApi.d.ts.map +1 -0
  17. package/dist/entities/auth/api/authApi.js +46 -0
  18. package/dist/entities/auth/api/authApi.js.map +1 -0
  19. package/dist/entities/auth/index.d.ts +3 -0
  20. package/dist/entities/auth/index.d.ts.map +1 -0
  21. package/dist/entities/auth/index.js +3 -0
  22. package/dist/entities/auth/index.js.map +1 -0
  23. package/dist/entities/auth/model/types.d.ts +77 -0
  24. package/dist/entities/auth/model/types.d.ts.map +1 -0
  25. package/dist/entities/auth/model/types.js +1 -0
  26. package/dist/entities/auth/model/types.js.map +1 -0
  27. package/dist/entities/cart/api/cartApi.d.ts +12 -0
  28. package/dist/entities/cart/api/cartApi.d.ts.map +1 -0
  29. package/dist/entities/cart/api/cartApi.js +396 -0
  30. package/dist/entities/cart/api/cartApi.js.map +1 -0
  31. package/dist/entities/cart/index.d.ts +3 -0
  32. package/dist/entities/cart/index.d.ts.map +1 -0
  33. package/dist/entities/cart/index.js +4 -0
  34. package/dist/entities/cart/index.js.map +1 -0
  35. package/dist/entities/cart/model/types.d.ts +91 -0
  36. package/dist/entities/cart/model/types.d.ts.map +1 -0
  37. package/dist/entities/cart/model/types.js +1 -0
  38. package/dist/entities/cart/model/types.js.map +1 -0
  39. package/dist/entities/category/api/categoryApi.d.ts +8 -0
  40. package/dist/entities/category/api/categoryApi.d.ts.map +1 -0
  41. package/dist/entities/category/api/categoryApi.js +33 -0
  42. package/dist/entities/category/api/categoryApi.js.map +1 -0
  43. package/dist/entities/category/index.d.ts +4 -0
  44. package/dist/entities/category/index.d.ts.map +1 -0
  45. package/dist/entities/category/index.js +4 -0
  46. package/dist/entities/category/index.js.map +1 -0
  47. package/dist/entities/category/model/store-category.d.ts +88 -0
  48. package/dist/entities/category/model/store-category.d.ts.map +1 -0
  49. package/dist/entities/category/model/store-category.js +24 -0
  50. package/dist/entities/category/model/store-category.js.map +1 -0
  51. package/dist/entities/category/model/types.d.ts +155 -0
  52. package/dist/entities/category/model/types.d.ts.map +1 -0
  53. package/dist/entities/category/model/types.js +18 -0
  54. package/dist/entities/category/model/types.js.map +1 -0
  55. package/dist/entities/category/model/useCategoryBreadcrumbs.d.ts +30 -0
  56. package/dist/entities/category/model/useCategoryBreadcrumbs.d.ts.map +1 -0
  57. package/dist/entities/category/model/useCategoryBreadcrumbs.js +72 -0
  58. package/dist/entities/category/model/useCategoryBreadcrumbs.js.map +1 -0
  59. package/dist/entities/chat/api/chatApi.d.ts +15 -0
  60. package/dist/entities/chat/api/chatApi.d.ts.map +1 -0
  61. package/dist/entities/chat/api/chatApi.js +400 -0
  62. package/dist/entities/chat/api/chatApi.js.map +1 -0
  63. package/dist/entities/chat/index.d.ts +3 -0
  64. package/dist/entities/chat/index.d.ts.map +1 -0
  65. package/dist/entities/chat/index.js +3 -0
  66. package/dist/entities/chat/index.js.map +1 -0
  67. package/dist/entities/chat/model/types.d.ts +439 -0
  68. package/dist/entities/chat/model/types.d.ts.map +1 -0
  69. package/dist/entities/chat/model/types.js +1 -0
  70. package/dist/entities/chat/model/types.js.map +1 -0
  71. package/dist/entities/country/api/countryApi.d.ts +5 -0
  72. package/dist/entities/country/api/countryApi.d.ts.map +1 -0
  73. package/dist/entities/country/api/countryApi.js +21 -0
  74. package/dist/entities/country/api/countryApi.js.map +1 -0
  75. package/dist/entities/country/index.d.ts +3 -0
  76. package/dist/entities/country/index.d.ts.map +1 -0
  77. package/dist/entities/country/index.js +3 -0
  78. package/dist/entities/country/index.js.map +1 -0
  79. package/dist/entities/country/model/types.d.ts +19 -0
  80. package/dist/entities/country/model/types.d.ts.map +1 -0
  81. package/dist/entities/country/model/types.js +1 -0
  82. package/dist/entities/country/model/types.js.map +1 -0
  83. package/dist/entities/customer/api/customerApi.d.ts +6 -0
  84. package/dist/entities/customer/api/customerApi.d.ts.map +1 -0
  85. package/dist/entities/customer/api/customerApi.js +21 -0
  86. package/dist/entities/customer/api/customerApi.js.map +1 -0
  87. package/dist/entities/customer/index.d.ts +3 -0
  88. package/dist/entities/customer/index.d.ts.map +1 -0
  89. package/dist/entities/customer/index.js +3 -0
  90. package/dist/entities/customer/index.js.map +1 -0
  91. package/dist/entities/customer/model/types.d.ts +237 -0
  92. package/dist/entities/customer/model/types.d.ts.map +1 -0
  93. package/dist/entities/customer/model/types.js +1 -0
  94. package/dist/entities/customer/model/types.js.map +1 -0
  95. package/dist/entities/favorite/api/favoriteApi.d.ts +32 -0
  96. package/dist/entities/favorite/api/favoriteApi.d.ts.map +1 -0
  97. package/dist/entities/favorite/api/favoriteApi.js +344 -0
  98. package/dist/entities/favorite/api/favoriteApi.js.map +1 -0
  99. package/dist/entities/favorite/index.d.ts +3 -0
  100. package/dist/entities/favorite/index.d.ts.map +1 -0
  101. package/dist/entities/favorite/index.js +3 -0
  102. package/dist/entities/favorite/index.js.map +1 -0
  103. package/dist/entities/favorite/model/types.d.ts +39 -0
  104. package/dist/entities/favorite/model/types.d.ts.map +1 -0
  105. package/dist/entities/favorite/model/types.js +1 -0
  106. package/dist/entities/favorite/model/types.js.map +1 -0
  107. package/dist/entities/notification/api/notificationApi.d.ts +12 -0
  108. package/dist/entities/notification/api/notificationApi.d.ts.map +1 -0
  109. package/dist/entities/notification/api/notificationApi.js +109 -0
  110. package/dist/entities/notification/api/notificationApi.js.map +1 -0
  111. package/dist/entities/notification/index.d.ts +3 -0
  112. package/dist/entities/notification/index.d.ts.map +1 -0
  113. package/dist/entities/notification/index.js +3 -0
  114. package/dist/entities/notification/index.js.map +1 -0
  115. package/dist/entities/notification/model/types.d.ts +273 -0
  116. package/dist/entities/notification/model/types.d.ts.map +1 -0
  117. package/dist/entities/notification/model/types.js +1 -0
  118. package/dist/entities/notification/model/types.js.map +1 -0
  119. package/dist/entities/novaposhta/api/novaposhtaApi.d.ts +11 -0
  120. package/dist/entities/novaposhta/api/novaposhtaApi.d.ts.map +1 -0
  121. package/dist/entities/novaposhta/api/novaposhtaApi.js +69 -0
  122. package/dist/entities/novaposhta/api/novaposhtaApi.js.map +1 -0
  123. package/dist/entities/novaposhta/index.d.ts +6 -0
  124. package/dist/entities/novaposhta/index.d.ts.map +1 -0
  125. package/dist/entities/novaposhta/index.js +6 -0
  126. package/dist/entities/novaposhta/index.js.map +1 -0
  127. package/dist/entities/novaposhta/model/novaposhtaCity.d.ts +101 -0
  128. package/dist/entities/novaposhta/model/novaposhtaCity.d.ts.map +1 -0
  129. package/dist/entities/novaposhta/model/novaposhtaCity.js +16 -0
  130. package/dist/entities/novaposhta/model/novaposhtaCity.js.map +1 -0
  131. package/dist/entities/novaposhta/model/novaposhtaSettlement.d.ts +140 -0
  132. package/dist/entities/novaposhta/model/novaposhtaSettlement.d.ts.map +1 -0
  133. package/dist/entities/novaposhta/model/novaposhtaSettlement.js +23 -0
  134. package/dist/entities/novaposhta/model/novaposhtaSettlement.js.map +1 -0
  135. package/dist/entities/novaposhta/model/novaposhtaStreet.d.ts +123 -0
  136. package/dist/entities/novaposhta/model/novaposhtaStreet.d.ts.map +1 -0
  137. package/dist/entities/novaposhta/model/novaposhtaStreet.js +16 -0
  138. package/dist/entities/novaposhta/model/novaposhtaStreet.js.map +1 -0
  139. package/dist/entities/novaposhta/model/novaposhtaWarehouse.d.ts +131 -0
  140. package/dist/entities/novaposhta/model/novaposhtaWarehouse.d.ts.map +1 -0
  141. package/dist/entities/novaposhta/model/novaposhtaWarehouse.js +19 -0
  142. package/dist/entities/novaposhta/model/novaposhtaWarehouse.js.map +1 -0
  143. package/dist/entities/order/api/orderApi.d.ts +18 -0
  144. package/dist/entities/order/api/orderApi.d.ts.map +1 -0
  145. package/dist/entities/order/api/orderApi.js +105 -0
  146. package/dist/entities/order/api/orderApi.js.map +1 -0
  147. package/dist/entities/order/index.d.ts +3 -0
  148. package/dist/entities/order/index.d.ts.map +1 -0
  149. package/dist/entities/order/index.js +3 -0
  150. package/dist/entities/order/index.js.map +1 -0
  151. package/dist/entities/order/model/types.d.ts +630 -0
  152. package/dist/entities/order/model/types.d.ts.map +1 -0
  153. package/dist/entities/order/model/types.js +27 -0
  154. package/dist/entities/order/model/types.js.map +1 -0
  155. package/dist/entities/product/api/productApi.d.ts +27 -0
  156. package/dist/entities/product/api/productApi.d.ts.map +1 -0
  157. package/dist/entities/product/api/productApi.js +252 -0
  158. package/dist/entities/product/api/productApi.js.map +1 -0
  159. package/dist/entities/product/index.d.ts +3 -0
  160. package/dist/entities/product/index.d.ts.map +1 -0
  161. package/dist/entities/product/index.js +3 -0
  162. package/dist/entities/product/index.js.map +1 -0
  163. package/dist/entities/product/model/store-product.d.ts +138 -0
  164. package/dist/entities/product/model/store-product.d.ts.map +1 -0
  165. package/dist/entities/product/model/store-product.js +9 -0
  166. package/dist/entities/product/model/store-product.js.map +1 -0
  167. package/dist/entities/product/model/types.d.ts +898 -0
  168. package/dist/entities/product/model/types.d.ts.map +1 -0
  169. package/dist/entities/product/model/types.js +40 -0
  170. package/dist/entities/product/model/types.js.map +1 -0
  171. package/dist/entities/referral/api/referralApi.d.ts +7 -0
  172. package/dist/entities/referral/api/referralApi.d.ts.map +1 -0
  173. package/dist/entities/referral/api/referralApi.js +41 -0
  174. package/dist/entities/referral/api/referralApi.js.map +1 -0
  175. package/dist/entities/referral/index.d.ts +3 -0
  176. package/dist/entities/referral/index.d.ts.map +1 -0
  177. package/dist/entities/referral/index.js +3 -0
  178. package/dist/entities/referral/index.js.map +1 -0
  179. package/dist/entities/referral/model/types.d.ts +42 -0
  180. package/dist/entities/referral/model/types.d.ts.map +1 -0
  181. package/dist/entities/referral/model/types.js +1 -0
  182. package/dist/entities/referral/model/types.js.map +1 -0
  183. package/dist/entities/store/api/storeApi.d.ts +14 -0
  184. package/dist/entities/store/api/storeApi.d.ts.map +1 -0
  185. package/dist/entities/store/api/storeApi.js +134 -0
  186. package/dist/entities/store/api/storeApi.js.map +1 -0
  187. package/dist/entities/store/index.d.ts +3 -0
  188. package/dist/entities/store/index.d.ts.map +1 -0
  189. package/dist/entities/store/index.js +3 -0
  190. package/dist/entities/store/index.js.map +1 -0
  191. package/dist/entities/store/model/types.d.ts +853 -0
  192. package/dist/entities/store/model/types.d.ts.map +1 -0
  193. package/dist/entities/store/model/types.js +1 -0
  194. package/dist/entities/store/model/types.js.map +1 -0
  195. package/dist/entities/stories/api/storiesApi.d.ts +12 -0
  196. package/dist/entities/stories/api/storiesApi.d.ts.map +1 -0
  197. package/dist/entities/stories/api/storiesApi.js +225 -0
  198. package/dist/entities/stories/api/storiesApi.js.map +1 -0
  199. package/dist/entities/stories/index.d.ts +3 -0
  200. package/dist/entities/stories/index.d.ts.map +1 -0
  201. package/dist/entities/stories/index.js +3 -0
  202. package/dist/entities/stories/index.js.map +1 -0
  203. package/dist/entities/stories/model/types.d.ts +330 -0
  204. package/dist/entities/stories/model/types.d.ts.map +1 -0
  205. package/dist/entities/stories/model/types.js +1 -0
  206. package/dist/entities/stories/model/types.js.map +1 -0
  207. package/dist/entities/supplier/api/supplierApi.d.ts +20 -0
  208. package/dist/entities/supplier/api/supplierApi.d.ts.map +1 -0
  209. package/dist/entities/supplier/api/supplierApi.js +148 -0
  210. package/dist/entities/supplier/api/supplierApi.js.map +1 -0
  211. package/dist/entities/supplier/index.d.ts +3 -0
  212. package/dist/entities/supplier/index.d.ts.map +1 -0
  213. package/dist/entities/supplier/index.js +3 -0
  214. package/dist/entities/supplier/index.js.map +1 -0
  215. package/dist/entities/supplier/model/types.d.ts +295 -0
  216. package/dist/entities/supplier/model/types.d.ts.map +1 -0
  217. package/dist/entities/supplier/model/types.js +1 -0
  218. package/dist/entities/supplier/model/types.js.map +1 -0
  219. package/dist/entities/system/api/systemApi.d.ts +7 -0
  220. package/dist/entities/system/api/systemApi.d.ts.map +1 -0
  221. package/dist/entities/system/api/systemApi.js +60 -0
  222. package/dist/entities/system/api/systemApi.js.map +1 -0
  223. package/dist/entities/system/index.d.ts +3 -0
  224. package/dist/entities/system/index.d.ts.map +1 -0
  225. package/dist/entities/system/index.js +3 -0
  226. package/dist/entities/system/index.js.map +1 -0
  227. package/dist/entities/system/model/types.d.ts +55 -0
  228. package/dist/entities/system/model/types.d.ts.map +1 -0
  229. package/dist/entities/system/model/types.js +1 -0
  230. package/dist/entities/system/model/types.js.map +1 -0
  231. package/dist/index.d.ts +20 -0
  232. package/dist/index.d.ts.map +1 -0
  233. package/dist/index.js +21 -0
  234. package/dist/index.js.map +1 -0
  235. package/dist/shared/api/api.d.ts +18 -0
  236. package/dist/shared/api/api.d.ts.map +1 -0
  237. package/dist/shared/api/api.js +74 -0
  238. package/dist/shared/api/api.js.map +1 -0
  239. package/dist/shared/api/index.d.ts +3 -0
  240. package/dist/shared/api/index.d.ts.map +1 -0
  241. package/dist/shared/api/index.js +3 -0
  242. package/dist/shared/api/index.js.map +1 -0
  243. package/dist/shared/api/validation-error/ValidationError.d.ts +7 -0
  244. package/dist/shared/api/validation-error/ValidationError.d.ts.map +1 -0
  245. package/dist/shared/api/validation-error/ValidationError.js +1 -0
  246. package/dist/shared/api/validation-error/ValidationError.js.map +1 -0
  247. package/dist/shared/api/validation-error/handleValidationError.d.ts +2 -0
  248. package/dist/shared/api/validation-error/handleValidationError.d.ts.map +1 -0
  249. package/dist/shared/api/validation-error/handleValidationError.js +24 -0
  250. package/dist/shared/api/validation-error/handleValidationError.js.map +1 -0
  251. package/dist/shared/api/validation-error/index.d.ts +3 -0
  252. package/dist/shared/api/validation-error/index.d.ts.map +1 -0
  253. package/dist/shared/api/validation-error/index.js +3 -0
  254. package/dist/shared/api/validation-error/index.js.map +1 -0
  255. package/dist/shared/api/validation-error/isValidationError.d.ts +3 -0
  256. package/dist/shared/api/validation-error/isValidationError.d.ts.map +1 -0
  257. package/dist/shared/api/validation-error/isValidationError.js +11 -0
  258. package/dist/shared/api/validation-error/isValidationError.js.map +1 -0
  259. package/dist/shared/lib/getNextPageParam.d.ts +3 -0
  260. package/dist/shared/lib/getNextPageParam.d.ts.map +1 -0
  261. package/dist/shared/lib/getNextPageParam.js +4 -0
  262. package/dist/shared/lib/getNextPageParam.js.map +1 -0
  263. package/dist/shared/lib/index.d.ts +3 -0
  264. package/dist/shared/lib/index.d.ts.map +1 -0
  265. package/dist/shared/lib/index.js +3 -0
  266. package/dist/shared/lib/index.js.map +1 -0
  267. package/dist/shared/lib/objectToFormData.d.ts +2 -0
  268. package/dist/shared/lib/objectToFormData.d.ts.map +1 -0
  269. package/dist/shared/lib/objectToFormData.js +36 -0
  270. package/dist/shared/lib/objectToFormData.js.map +1 -0
  271. package/dist/shared/model/index.d.ts +2 -0
  272. package/dist/shared/model/index.d.ts.map +1 -0
  273. package/dist/shared/model/index.js +2 -0
  274. package/dist/shared/model/index.js.map +1 -0
  275. package/dist/shared/model/types.d.ts +75 -0
  276. package/dist/shared/model/types.d.ts.map +1 -0
  277. package/dist/shared/model/types.js +31 -0
  278. package/dist/shared/model/types.js.map +1 -0
  279. package/package.json +46 -0
package/CHANGELOG.md ADDED
@@ -0,0 +1,906 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [Unreleased]
9
+
10
+ ## [0.47.0] - 2026-04-17
11
+
12
+ ### Added
13
+
14
+ - Add `platform` and `ad_platform` required fields to `SignUpRequest`
15
+ - Add optional `referral_id` field to `SignUpRequest`
16
+
17
+ ### Changed
18
+
19
+ - **BREAKING**: `signUp` endpoint migrated from `v5/auth/register` to `v6/auth/register`
20
+ - **BREAKING**: `SignUpRequest.term` type changed from `1` to `true`
21
+
22
+ ## [0.46.0] - 2026-03-19
23
+
24
+ ### Added
25
+
26
+ - Add `getStoreProducts` endpoint (`POST v1/store/products`) — storefront product list with infinite scroll and filtering
27
+ - Add `GetStoreProductsRequest` and `GetStoreProductsResponse` types
28
+ - Add `download` field to `BaseProduct` — original image URL for download
29
+ - Add Zod response schema validation for `getStoreProducts` endpoint
30
+ - Add `getStoreCategories` endpoint (`GET v1/store/categories`) — storefront category tree
31
+ - Add `StoreCategory` and `GetStoreCategoriesResponse` types
32
+ - Add Zod response schema validation for `getStoreCategories` endpoint
33
+ - Add `video`, `images`, `buyme_category`, `options`, `price_per_unit` fields to `BaseProduct`
34
+ - Add `filter_has_products_with_special` param to `GetCategoriesRequest`
35
+ - Add Zod response schema validation for `getCategories` endpoint
36
+
37
+ ### Fixed
38
+
39
+ - `PaginatedResponseSchema`: `meta.from` and `meta.to` are now nullable (API returns `null` on empty results)
40
+ - `CartMerchantItem`: use `Omit<BaseProduct, 'price_per_unit'>` to resolve type conflict with `CartMerchantSummary`
41
+
42
+ ## [0.45.0] - 2026-03-19
43
+
44
+ ### Changed
45
+
46
+ - **BREAKING**: All `CreateOrderResponse` fields changed from `T | null` to optional (`T | undefined`): `status`, `order_status_id`, `payment`, `payment_transaction_id`, `url`, `ttn`, `order_id`, `products`, `address`, `estimate`, `total`, `total_formatted`, `pre_pay`, `pre_pay_formatted`, `total_pay`, `total_pay_formatted`
47
+
48
+ ## [0.44.0] - 2026-03-19
49
+
50
+ ### Added
51
+
52
+ - Add `getNovaposhtaSettlements` endpoint (`GET v3/novaposhta/settlements`) for searching settlements from KATOTTG registry
53
+ - Add `NovaposhtaSettlement` type
54
+ - Add Zod response validation schemas for all Nova Poshta endpoints
55
+ - Add `zod` as peer dependency
56
+ - Add UTM params to `CreateOrderRequest`: `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`
57
+ - Add courier delivery fields to `CreateOrderRequest`: `settlement_ref`, `settlement_description`, `street_ref`, `street_description`
58
+ - Add `pre_pay`, `pre_pay_formatted`, `total_pay`, `total_pay_formatted` to `CreateOrderResponse`
59
+ - Add Zod response schema validation for `createOrder` endpoint
60
+
61
+ ### Changed
62
+
63
+ - **BREAKING**: Nova Poshta endpoints migrated from v2 to v3 (`v2/novaposhta/*` → `v3/novaposhta/*`)
64
+ - **BREAKING**: `NovaposhtaCity` — remove `id`, `is_branch` fields; all fields are now nullable
65
+ - **BREAKING**: `NovaposhtaStreet` — remove `city_ref`; add `settlement_ref`, `present`, `streets_type_description`; all fields nullable
66
+ - **BREAKING**: `GetNovaposhtaCitiesRequest` — remove `area`, `settlement_type`, `is_branch` fields
67
+ - **BREAKING**: `GetNovaposhtaStreetsRequest` — remove `streets_type`; add `settlement_ref`
68
+ - **BREAKING**: `GetNovaposhtaWarehousesRequest.city_ref` is now required
69
+ - **BREAKING**: `createOrder` endpoint migrated from `v4/order` to `v5/order`
70
+ - **BREAKING**: `CreateOrderRequest.shipping_street_id` removed; use `street_ref` and `street_description` instead
71
+ - **BREAKING**: `CreateOrderRequest.delivery_method_code` narrowed to `'novaposhta.warehouse' | 'novaposhta.courier' | 'novaposhta.international'`
72
+ - **BREAKING**: `CreateOrderResponse.status` type changed from `number` to `string | null`
73
+ - **BREAKING**: `CreateOrderResponse.order_status_id` type changed from `number` to `number | null`
74
+
75
+ ## [0.43.0] - 2026-03-17
76
+
77
+ ### Changed
78
+
79
+ - **BREAKING**: Remove `getChatInfo` endpoint and `GetChatInfoRequest`/`GetChatInfoResponse` types
80
+ - **BREAKING**: Remove `getChatMessage` endpoint and `GetChatMessageRequest`/`GetChatMessageResponse` types
81
+ - **BREAKING**: Remove `deleteChat` endpoint and `DeleteChatRequest`/`DeleteChatResponse` types
82
+ - **BREAKING**: Remove `deleteChatMessage` endpoint and `DeleteChatMessageRequest` type
83
+ - **BREAKING**: `Chat.customer` type changed from `Person | null` to `Customer | null`
84
+ - **BREAKING**: `Chat.supplier` type changed from `Person | null` to `Supplier | null`
85
+ - **BREAKING**: `Chat.creator` type changed from `Person | null` to `(Customer | Supplier) | null`
86
+ - **BREAKING**: `ChatMessage.creator` type changed from `Customer` to `Customer | null`
87
+ - `ChatMessageStatus.code` narrowed from `string` to union type (`new`, `sent`, `received`, `failed`, `moderation`, `rejected`)
88
+ - `sendChatMessage`, `updateChatMessage`, `resendChatMessage` now send requests as `multipart/form-data`
89
+
90
+ ## [0.42.0] - 2026-03-10
91
+
92
+ ### Added
93
+
94
+ - Add `getNewChatMessagesCount` endpoint (`GET v1/customers/chat-threads/count/new`) — total unread messages count across all chat threads
95
+
96
+ ## [0.41.1] - 2026-03-06
97
+
98
+ ### Fixed
99
+
100
+ - `createStore`: now invalidates `Store LIST` tag so `getStores` refetches automatically after store creation
101
+
102
+ ## [0.41.0] - 2026-03-06
103
+
104
+ ### Added
105
+
106
+ - Add `deleteStore` endpoint (`DELETE v1/store/:id`)
107
+
108
+ ## [0.40.0] - 2026-03-04
109
+
110
+ ### Added
111
+
112
+ - Add optional `optimisticUpdate` field to `SaveSupplierStoryStatisticsRequest` (available for `view`, `like`, `unlike`; disallowed for `share`, `reply`)
113
+ - `saveSupplierStoryStatistics` now supports optimistic cache updates for `getSupplierStoryGroupStories` and `getSupplierStories`
114
+
115
+ ### Fixed
116
+
117
+ - `saveSupplierStoryStatistics`: `like`/`unlike` now invalidate only the specific story tag instead of all supplier story lists (avoids unnecessary refetches)
118
+
119
+ ## [0.39.1] - 2026-03-03
120
+
121
+ ### Changed
122
+
123
+ - **BREAKING**: `SupplierWithStoryGroups.avg_general_rating` type changed from `number` to `string | null`
124
+
125
+ ## [0.39.0] - 2026-03-03
126
+
127
+ ### Added
128
+
129
+ - Add `getSupplierStories` endpoint — flat list of all active supplier stories across all groups (`GET suppliers/v1/:customer/stories`)
130
+ - Add `supplier_story_id` field to `SendChatMessageRequest` (optional; for replying to supplier stories)
131
+
132
+ ### Fixed
133
+
134
+ - Fix `SupplierStory.product.special_price` type: `number` → `number | null`
135
+
136
+ ## [0.38.0] - 2026-02-26
137
+
138
+ ### Added
139
+
140
+ - Add `getStores` endpoint — list of current user's stores with infinite scroll (`GET v3/store`)
141
+ - Add `product_type` field to `StoreWizardStep1` (optional; required for dropshippers, must be omitted for suppliers)
142
+ - Add `logo_media_id`, `icon_mobile_media_id`, `favicon_media_id` fields to `Store.main_info`
143
+ - Add `seo_tags`, `tiktok_url`, `whatsapp_phone` fields to `Store.contacts`
144
+ - Add `whatsapp_phone` field to `StoreWizardStep3`
145
+
146
+ ### Changed
147
+
148
+ - **BREAKING**: `Store.banners` changed from `StoreBanner[]` to `{ desktop: StoreBanner[]; mobile: StoreBanner[] }`
149
+ - `StoreWizardStep4.categories`: only `id` is required — `mode`, `products`, `price_markup_type`, `price_markup_value`, `excluded_supplier_ids`, `childrens` are now optional
150
+ - **BREAKING**: Remove `product_type` from `StoreWizardStep4` — moved to `StoreWizardStep1`
151
+ - **BREAKING**: Restructure `StoreBanner` interface (response type)
152
+ - Remove `id`, `image_desktop`, `image_mobile`
153
+ - Add `media_id`, `thumb`, `original`, `path`, `size`, `mime_type`, `video`, `main`
154
+ - **BREAKING**: `StoreWizardStep2.banners` changed from `StoreBanner[]` to a dedicated upload type
155
+ - Fields: `image_desktop?`, `image_mobile?`, `media_id_desktop?`, `media_id_mobile?`, `product_id?`, `product_type?`, `category_id?`, `category_type?`, `h1?`, `description?`, `sort_order?`
156
+ - `banners` is now optional
157
+ - **BREAKING**: `Store.main_info.domain` type changed from `StoreDomain` reference to inline object (`id`, `domain`, `is_custom`)
158
+ - **BREAKING**: Remove `is_default` field from `StoreDomain`
159
+
160
+ ## [0.37.0] - 2026-02-23
161
+
162
+ ### Added
163
+
164
+ - Add `updateStoreAnalytics` endpoint (`PATCH v3/store/:id/analytics`) for updating GTM, pixels, cookie consent and custom loader settings
165
+ - Add `tiktok_url` field to `StoreWizardStep3`
166
+ - Add `excluded_supplier_ids` field to `StoreWizardStep4`
167
+ - Add `gtm_custom_enabled`, `gtm_custom_script_url`, `gtm_custom_noscript_url` fields to `StoreWizardStep5`
168
+
169
+ ### Changed
170
+
171
+ - Make `StoreWizardStep3.seo_tags` optional
172
+ - **BREAKING**: Restructure `StoreCategory` interface
173
+ - Rename `category_id` → `id`
174
+ - Rename `product_ids` → `products`
175
+ - Remove `category_type`, `sort_order`, `name: string | null`
176
+ - Add `name: string`, `icon`, `thumb`, `thumb_small`, `thumb_large`, `price_markup_type`, `price_markup_value`, `excluded_supplier_ids`, `childrens: StoreCategory[]`
177
+ - **BREAKING**: `GetStoreDomainsResponse` changed from `StoreDomain[]` to `{ data: StoreDomain[] }`
178
+ - **BREAKING**: `StoreWizardStep4.categories` Pick updated to new `StoreCategory` fields (`id`, `mode`, `products`, `price_markup_type`, `price_markup_value`, `excluded_supplier_ids`, `childrens`)
179
+
180
+ ### Fixed
181
+
182
+ - Fix file upload in `createStore` and `updateStoreWizard` by sending requests as `multipart/form-data`
183
+
184
+ ## [0.36.0] - 2026-02-17
185
+
186
+ ### Added
187
+
188
+ - Document Store cache invalidation behavior in README
189
+ - Add JSDoc documentation to `CustomerAccount`, `SaveCustomerSettingsRequest`, and `SaveCustomerSettingsResponse`
190
+
191
+ ### Changed
192
+
193
+ - Add RTK Query cache tags for Store API:
194
+ - `getStore` now provides `Store` tags (`{id}` and `LIST`)
195
+ - `payStoreCreation` and `updateStoreWizard` now invalidate store-specific cache by `store` id
196
+ - Make all fields optional in `SaveCustomerSettingsRequest`
197
+
198
+ ## [0.35.0] - 2026-02-17
199
+
200
+ ### Added
201
+
202
+ - Add `margins` and `retail_prices` fields to `GetProductsResponse` for filtering support
203
+ - Add `BaseStore` interface for simple store data
204
+ - Add new Store API v3 endpoints: `getStoreDomains`, `validateStoreDomain`, `getStorePlatforms`, `payStoreCreation`, `createStore`, `updateStoreWizard`
205
+ - Add comprehensive JSDoc documentation to Store types
206
+ - Add wizard step types for store creation flow (StoreWizardStep1-6)
207
+ - Add `StorePlatform`, `StoreDomain`, `StoreTranslation` types
208
+
209
+ ### Changed
210
+
211
+ - **BREAKING**: Store API migrated from v2 to v3 (`v2/store` → `v3/store`)
212
+ - **BREAKING**: Rename `getStoreInfo` query to `getStore`
213
+ - **BREAKING**: Complete restructure of `Store` type with nested objects (`main_info`, `contacts`, `analytics`, `banners`, etc.)
214
+ - **BREAKING**: `StorePhone` structure changed from `{full, code, number}` to `{original, e164, international, national, mobile}`
215
+ - **BREAKING**: `StoreBanner` structure completely changed with new fields (`image_desktop`, `image_mobile`, `product_id`, `product_type`, etc.)
216
+ - **BREAKING**: `StoreTemplate` structure updated with new fields (`placeholder`, `gallery`)
217
+ - **BREAKING**: `Order.store` type changed from `Store` to `BaseStore`
218
+ - **BREAKING**: `ProductDetails.store_template` type changed from `StoreTemplate` to `unknown`
219
+ - Improve `product_type` typing from `string` to `'buyme' | 'supplier'` in `BaseProduct`, `ProductDetails`, `SupplierProductDetails`, `AddToCartRequest`, and `AddFavoriteMerchantItemRequest`
220
+ - Change `SaveCustomerSettingsRequest.avatar` type from `string` to `File`
221
+
222
+ ### Removed
223
+
224
+ - **BREAKING**: Remove `getStoreArticles` endpoint
225
+ - Articles are now included in `Store.informations` from `getStore` endpoint
226
+ - Migration: Use `storeApi.useGetStoreQuery()` and access `data.informations` instead
227
+
228
+ ## [0.34.0] - 2026-02-13
229
+
230
+ ### Added
231
+
232
+ - Add `GetSuppliersWithStoriesRequest` type for filtering suppliers with stories
233
+ - Add comprehensive JSDoc documentation to Stories types
234
+ - Add `status`, `created_at`, `updated_at` fields to `SupplierStory` type
235
+ - Add `SupplierStoryMedia` interface extending `StoryMedia`
236
+
237
+ ### Changed
238
+
239
+ - **BREAKING**: `StoryMedia.duration` is now `number | null` instead of `number`
240
+ - **BREAKING**: `SupplierStory.media` type changed from inline object to `SupplierStoryMedia` interface
241
+ - Improve `getSuppliersWithStories` endpoint to support query parameters
242
+ - Optimize `saveSupplierStoryStatistics` cache invalidation to target specific story
243
+
244
+ ### Fixed
245
+
246
+ - Fix `getStories` endpoint URL (remove leading slash)
247
+
248
+ ## [0.33.0] - 2026-02-10
249
+
250
+ ### Added
251
+
252
+ - Add `contact_method` field to `CreateOrderRequest` for specifying preferred contact method (telegram, viber, or phone)
253
+ - Add `params` parameter to `useCategoryBreadcrumbs` hook for passing additional query filters
254
+ - Support for `GetCategoriesRequest` and `GetSupplierCategoriesRequest` parameters
255
+ - Generic type parameter for better type safety
256
+ - Add `warehouse_id` filter to `GetProductsByQrRequest` for filtering by warehouse
257
+ - Add `show_sizes` flag to `GetProductsByQrRequest` to display all sizes separately
258
+ - Add comprehensive JSDoc documentation to QR product types (`QRProduct`, `GetProductsByQrRequest`, `GetProductsByQrResponse`)
259
+ - Add chat warnings endpoints:
260
+ - `getChatWarnings` - fetch active warnings for a chat thread with real-time Pusher updates
261
+ - `acknowledgeChatWarning` - acknowledge a warning with optimistic cache update
262
+ - Add `ChatWarning` type with JSDoc documentation
263
+
264
+ ### Changed
265
+
266
+ - Optimize Pusher WebSocket subscriptions in `chatApi`, `systemApi`:
267
+ - Use `channelName` variable for subscribe/unsubscribe consistency
268
+ - Await `cacheDataLoaded` in parallel with `getPusher()` using `Promise.all`
269
+ - Simplify cleanup: use only `pusher.unsubscribe()` instead of `channel.unbind()` + `pusher.unsubscribe()`
270
+
271
+ ### Removed
272
+
273
+ - **BREAKING**: Remove deprecated `ListProduct` type
274
+ - Migration: Use `BaseProduct` instead
275
+ - **BREAKING**: Remove `core_filter` from `GetProductsByQrRequest`
276
+ - Use `filter[barcode]` or `filter[product_id]` instead
277
+
278
+ ## [0.32.0] - 2026-02-06
279
+
280
+ ### Added
281
+
282
+ - Add real-time updates to `getChat` endpoint via Pusher WebSocket
283
+ - Subscribe to chat events: created, updated, received, deleted
284
+ - Automatic cache invalidation on real-time updates
285
+ - Add `markAllChatMessagesAsRead` endpoint
286
+ - Add `supplier_story` field to `ChatMessage` type
287
+ - Add `created_at` and `updated_at` fields to `ChatMessage` type
288
+ - Add comprehensive JSDoc documentation to all Chat types
289
+
290
+ ### Changed
291
+
292
+ - Rename `ChatStatus` to `ChatMessageStatus` for consistency
293
+ - Make `supplier_id` and `admin_id` optional in `CreateChatRequest` (one of them is required)
294
+ - Make `medias` optional in `SendChatMessageRequest`
295
+
296
+ ### Fixed
297
+
298
+ - Fix Pusher private channel authentication by adding authorization headers
299
+ - `getPusher` now automatically reinitializes when authorization token changes
300
+
301
+ ## [0.31.0] - 2026-02-05
302
+
303
+ ### Changed
304
+
305
+ - **BREAKING**: Remove direct hook exports from all API modules
306
+ - Hooks are now only accessible via `api.useXxxQuery` pattern (e.g., `productApi.useGetProductsInfiniteQuery`)
307
+ - Migration: Replace `useGetProductsInfiniteQuery` with `productApi.useGetProductsInfiniteQuery`
308
+ - Affected modules: ad, cart, category, chat, country, customer, favorite, notification, novaposhta, order, product, referral, store, supplier
309
+ - Update `useCategoryBreadcrumbs` to use `categoryApi.useXxxQuery` pattern
310
+
311
+ ## [0.30.0] - 2026-02-04
312
+
313
+ ### Added
314
+
315
+ - Add `avg_general_rating` field to `SupplierWithStoryGroups` type
316
+ - Add `special_price` field to `SupplierStory.product` type
317
+
318
+ ### Fixed
319
+
320
+ - Fix `saveSupplierStoryStatistics` endpoint URL (add missing `/stories/` segment)
321
+ - Exclude `supplierStory` from request body in `saveSupplierStoryStatistics`
322
+
323
+ ## [0.29.0] - 2026-02-02
324
+
325
+ ### Fixed
326
+
327
+ - Exclude `optimisticUpdate` from request body in `addFavoriteMerchantItem` and `deleteFavoriteMerchantItem`
328
+
329
+ ### Changed
330
+
331
+ - **BREAKING**: Migrate `getNotifications` endpoint from v1 to v2 API
332
+ - Make `getFavoriteMerchants` request argument optional
333
+ - Add comprehensive JSDoc documentation to `GetNotificationsRequest` and `GetNotificationsResponse`
334
+ - Add comprehensive JSDoc documentation to `Notification`, `GetNotificationRequest`, `GetNotificationsCountResponse`, `GetNewSuppliersCountResponse`, `MarkNotificationAsReadRequest`, `MarkNotificationAsReadResponse`
335
+ - Add comprehensive JSDoc documentation to `Customer` interface
336
+ - Add comprehensive JSDoc documentation to `ProductOptionValue` interface
337
+
338
+ ## [0.28.0] - 2026-02-02
339
+
340
+ ### Added
341
+
342
+ - Add `generateProductDescription` endpoint for AI-powered product descriptions using OpenAI
343
+ - Add `filter_bestseller` parameter to `GetProductsRequest` for filtering products with sales
344
+ - Add comprehensive JSDoc documentation to `GetProductsRequest` interface
345
+ - Add `providesTags` cache configuration for `getProductsByQr` endpoint
346
+
347
+ ### Removed
348
+
349
+ - **BREAKING**: Remove `getBestSellers` endpoint and related types
350
+ - Remove `useGetBestSellersQuery` hook
351
+ - Remove `GetBestsellersRequest` and `GetBestsellersResponse` types
352
+ - Remove `BestsellerProduct` optimistic updates and cache tags from favorite mutations
353
+ - Migration: Use `useGetProductsInfiniteQuery({ filter_bestseller: true })` instead
354
+
355
+ ## [0.27.0] - 2026-02-02
356
+
357
+ ### Fixed
358
+
359
+ - Fix `toggleGiftPackage` cache invalidation to also refresh merchants list
360
+
361
+ ### Changed
362
+
363
+ - Simplify request body spread in toggleGiftPackage
364
+ - **BREAKING**: Remove `merchantId` from `ToggleGiftPackageRequest`
365
+ - This field was only used for client-side optimistic updates
366
+
367
+ ## [0.26.0] - 2026-01-30
368
+
369
+ ### Added
370
+
371
+ - Add supplier stories endpoints:
372
+ - `getSuppliersWithStories` - list of suppliers with active story groups (infinite scroll)
373
+ - `getPaginatedSuppliersWithStories` - list of suppliers with active story groups (pagination)
374
+ - `getSupplierStoryGroups` - story groups for specific supplier
375
+ - `getSupplierStoryGroupStories` - stories within a group
376
+ - `saveSupplierStoryStatistics` - track story interactions (view/like/unlike/share/reply)
377
+ - Add supplier stories types with JSDoc documentation
378
+
379
+ ### Fixed
380
+
381
+ - Fix `increaseStoryViews` cache invalidation to refresh entire stories list
382
+
383
+ ### Changed
384
+
385
+ - **BREAKING**: Remove individual hook exports from storiesApi
386
+ - Migration: Use `storiesApi.useGetStoriesInfiniteQuery()` instead of `useGetStoriesInfiniteQuery()`
387
+
388
+ ### Removed
389
+
390
+ - **BREAKING**: Remove `getBuymeCategories` endpoint and related types
391
+ - Remove `useGetBuymeCategoriesInfiniteQuery` hook
392
+ - Remove `GetBuymeCategoriesRequest` and `GetBuymeCategoriesResponse` types
393
+ - Migration: Use `categoryApi.useGetCategoriesQuery({ filter_with_supplier_products: true })` instead
394
+
395
+ ## [0.25.0] - 2026-01-29
396
+
397
+ ### Fixed
398
+
399
+ - Fix logout endpoint URL (`v1/auth/logout` → `v1/logout`)
400
+
401
+ ### Changed
402
+
403
+ - Simplify request body spread in auth mutations
404
+ - **BREAKING**: Remove individual hook exports from authApi
405
+ - Migration: Replace `useSignInMutation()` with `authApi.useSignInMutation()`
406
+
407
+ ## [0.24.0] - 2026-01-29
408
+
409
+ ### Added
410
+
411
+ - Add Pusher integration with `getPusher()` function for real-time functionality
412
+ - Add `pusher-js` as peer dependency
413
+ - Export `ApiConfig` interface
414
+ - Add System API with endpoints:
415
+ - `getMaintenanceStatus` - system availability with real-time Pusher updates
416
+ - `getVersionCheck` - iOS/Android app versions with real-time Pusher updates
417
+ - `checkTelegramUser` - verify Telegram username existence
418
+ - Add System types with JSDoc documentation
419
+
420
+ ### Changed
421
+
422
+ - **BREAKING**: `ApiConfig` now requires `pusher` configuration (`appKey`, `cluster`)
423
+
424
+ ## [0.23.4] - 2026-01-26
425
+
426
+ ### Fixed
427
+
428
+ - Fix "Cannot read property 'per_page' of undefined" error in getSuppliers when called without parameters
429
+
430
+ ## [0.23.3] - 2026-01-20
431
+
432
+ ### Fixed
433
+
434
+ - Fix typo in Supplier interface field name: `is_verified_supplier_by_payouts` → `is_verified_supplier_by_payout`
435
+
436
+ ## [0.23.2] - 2026-01-19
437
+
438
+ ### Fixed
439
+
440
+ - Fix getSupplierCategories endpoint URL to correct path `suppliers/v3/categories` (was returning 404 with `/search` suffix)
441
+
442
+ ## [0.23.1] - 2026-01-16
443
+
444
+ ### Changed
445
+
446
+ - Remove `keepUnusedDataFor: Infinity` from getCategories endpoint to use default RTK Query cache behavior (60 seconds)
447
+
448
+ ### Fixed
449
+
450
+ - Add explicit `method: 'POST'` to getSupplierCategories endpoint
451
+
452
+ ## [0.23.0] - 2026-01-15
453
+
454
+ ### Added
455
+
456
+ - Add getPaginatedSupplierProducts endpoint for standard pagination (alternative to infinite scroll)
457
+ - Add useGetPaginatedSupplierProductsQuery hook for paginated supplier products
458
+ - Add GetPaginatedSupplierProductsRequest type extending GetSupplierProductsRequest with page parameter
459
+ - Add comprehensive JSDoc documentation to GetSupplierProductsRequest with detailed field descriptions and examples
460
+ - Add JSDoc documentation to GetSupplierProductsResponse with examples for price range fields
461
+ - Add JSDoc documentation to GetProductsRequest.option_value_filter fields (option_value_ids, warehouse_ids)
462
+
463
+ ## [0.22.0] - 2026-01-14
464
+
465
+ ### Added
466
+
467
+ - Add JSDoc documentation to GetSupplierCategoriesRequest with detailed field descriptions and examples
468
+ - Add void support to getSupplierCategories and getBuymeCategories for optional parameters
469
+ - Add supplier categories support to useCategoryBreadcrumbs hook via optional supplierId parameter
470
+ - Add RatingStatistic interface with comprehensive JSDoc documentation
471
+ - Add new fields to Supplier interface: rating_statistic, is_verified_supplier_by_payouts, balance, balance_formatted
472
+ - Add JSDoc documentation to all Supplier interface fields with examples
473
+ - Add JSDoc documentation to useCategoryBreadcrumbs hook with usage examples
474
+
475
+ ### Changed
476
+
477
+ - **BREAKING**: Replace getSupplierCategories infinite query with regular query
478
+ - Changed from useGetSupplierCategoriesInfiniteQuery to useGetSupplierCategoriesQuery
479
+ - Update endpoint to v3 API (suppliers/v3/categories/search)
480
+ - Change request method from path params to body params
481
+ - Migration: Replace useGetSupplierCategoriesInfiniteQuery() with useGetSupplierCategoriesQuery()
482
+ - **BREAKING**: Update GetSupplierCategoriesRequest interface
483
+ - Remove required customer field (replaced with optional filter_customer_id)
484
+ - Remove parent_id and per_page fields
485
+ - Add new optional fields: search, filter_parent_id, filter_customer_id, filter_has_products, filter_status
486
+ - Migration: Replace `customer: id` with `filter_customer_id: id` in request parameters
487
+ - **BREAKING**: Update GetSupplierCategoriesResponse structure
488
+ - Response now returns TreeCategory[] instead of SupplierCategory[]
489
+ - Returns hierarchical tree structure instead of flat list
490
+ - Migration: Update code to handle nested category structure with childrens property
491
+ - Update GetBuymeCategoriesResponse to use TreeCategory[] for consistency
492
+ - Enhance useCategoryBreadcrumbs to conditionally use supplier or regular categories based on supplierId parameter
493
+ - Mark SupplierRating interface as deprecated
494
+ - Update @reduxjs/toolkit peer dependency to 2.11.2 (from 2.9.1)
495
+
496
+ ### Removed
497
+
498
+ - Remove SupplierCategory interface (replaced with TreeCategory for consistency)
499
+ - **BREAKING**: Remove getSupplierRating endpoint (deprecated, use Supplier.rating_statistic instead)
500
+ - Remove useGetSupplierRatingQuery hook
501
+ - Remove GetSupplierRatingRequest and GetSupplierRatingResponse types
502
+ - Migration: Use getSupplierInfo endpoint and access rating_statistic field from Supplier object
503
+
504
+ ## [0.21.0] - 2025-12-31
505
+
506
+ ### Added
507
+
508
+ - Add getPaginatedProducts endpoint for fetching products with standard pagination
509
+ - Add GetPaginatedProductsRequest type extending GetProductsRequest with page parameter
510
+
511
+ ## [0.20.0] - 2025-12-30
512
+
513
+ ### Added
514
+
515
+ - Add getOrders endpoint for fetching customer orders
516
+ - Add Order, OrderProduct, OrderProductOption types
517
+ - Add GetOrdersRequest and GetOrdersResponse types
518
+
519
+ ### Changed
520
+
521
+ - **BREAKING**: Update CreateOrderResponse types
522
+ - Change payment type from number to string | null
523
+ - Change ttn type from string to string | null
524
+ - Add payment_transaction_id field for online payments tracking
525
+ - Add url field for payment redirect
526
+ - Add order_id field for store orders
527
+ - Add products array with order items details
528
+ - Add address field with full delivery address
529
+ - Add estimate field with delivery timeframe
530
+ - Add total and total_formatted fields with order amount
531
+ - **BREAKING**: Update PaymentMethod type to include description field (changed from type alias to interface)
532
+ - Add JSDoc documentation with examples for order types
533
+ - Fix attribute_filter type in GetProductsRequest (remove template literal type)
534
+ - Fix filter_order_status_id field name in GetOrdersRequest (remove brackets from field name)
535
+
536
+ ## [0.19.3] - 2025-12-22
537
+
538
+ ### Changed
539
+
540
+ - Rename cache tag from Count to CartCount for clarity and consistency
541
+ - Change orderApi to extend from cartApi instead of buymeuaApi
542
+ - Add eslint-disable comments for void type parameters in cartApi
543
+
544
+ ### Fixed
545
+
546
+ - Add cart cache invalidation to createOrder mutation to clear cart after successful order creation
547
+
548
+ ## [0.19.2] - 2025-12-21
549
+
550
+ ### Changed
551
+
552
+ - Enhance cache tag system with productId for precise cache invalidation
553
+ - Add productId to CartMerchantItem tags in cartApi
554
+ - Add productId to FavoriteMerchantItem tags in favoriteApi
555
+ - Use favorite_item_id instead of product id for FavoriteMerchantItem tag id
556
+
557
+ ### Fixed
558
+
559
+ - Fix cart cache invalidation when favorite status changes
560
+ - Invalidate CartMerchantItem by productId in addFavoriteMerchantItem mutation
561
+ - Invalidate CartMerchantItem by productId in deleteFavoriteMerchantItem mutation
562
+ - Ensures cart items immediately reflect updated favorite status
563
+
564
+ ## [0.19.1] - 2025-12-19
565
+
566
+ ### Changed
567
+
568
+ - Add Table of Contents to README for easier navigation between API sections
569
+
570
+ ## [0.19.0] - 2025-12-19
571
+
572
+ ### Changed
573
+
574
+ - Enhance onUnauthorized callback to receive request context parameters (args, api, extraOptions) for advanced error handling scenarios
575
+ - Add void support to fully optional request types for improved type safety
576
+ - GetChatsRequest in chatApi.getChats
577
+ - GetNovaposhtaCitiesRequest in novaposhtaApi.getNovaposhtaCities
578
+ - GetNovaposhtaStreetsRequest in novaposhtaApi.getNovaposhtaStreets
579
+ - GetNovaposhtaWarehousesRequest in novaposhtaApi.getNovaposhtaWarehouses
580
+ - GetNotificationsRequest in notificationApi.getNotifications
581
+ - Standardize RTK Query tag callback signatures across all APIs (chat, favorite, notification, product, stories, supplier)
582
+ - Replace inconsistent parameter naming with explicit unused parameters (\_result, \_error, \_arg, \_meta)
583
+ - Improve code readability and follow TypeScript best practices
584
+ - Clean up cart request types by removing client-side only fields
585
+ - Remove merchantId and quantity from RemoveItemFromCartRequest
586
+ - Remove type, merchantId, and optionIndex from UpdateCartItemQuantityRequest
587
+
588
+ ## [0.18.0] - 2025-12-15
589
+
590
+ ### Added
591
+
592
+ - Add filter_exclude_product_ids to GetProductsRequest for excluding products by ID
593
+ - Add retail_price_from and retail_price_to parameters to GetProductsRequest
594
+ - Add margin_from and margin_to parameters to GetProductsRequest
595
+ - Add filter_prepared_for_site parameter to GetCategoriesRequest
596
+ - Add providesTags configuration to getCartMerchantItems endpoint
597
+ - Add new fields to Supplier interface: status, email, telephone, is_confirm_telephone, has_products, last_modified_product_at, buyme_all_category_ids, storefront_url, is_new_supplier
598
+
599
+ ### Changed
600
+
601
+ - Update order_by in GetProductsRequest to accept string or string array for multiple sorting
602
+ - Make GetCartMerchantsRequest optional (allows calling useGetCartMerchantsInfiniteQuery without arguments)
603
+ - Refactor CartMerchantItem to extend BaseProduct interface (removes duplicated fields)
604
+ - Standardize tag callback signatures with explicit unused parameters (\_result, \_error, \_arg, \_meta)
605
+ - **BREAKING**: Update getSuppliers endpoint to use v3 API (suppliers/v3/customers/list)
606
+ - Mark Supplier.reviews field as deprecated
607
+
608
+ ### Fixed
609
+
610
+ - Fix params order in getProducts query body (queryArg now spread before page param)
611
+ - Fix incorrect tag type in getCartMerchants providesTags (CartMerchantItem → CartMerchant)
612
+
613
+ ## [0.17.0] - 2025-12-10
614
+
615
+ ### Added
616
+
617
+ - Add filter_with_supplier_products parameter to GetCategoriesRequest
618
+ - Add id field to ProductAttributeGroup interface
619
+ - Add attribute_value_id field to ProductAttribute interface
620
+
621
+ ### Changed
622
+
623
+ - Make request parameter optional for getBuymeCategories (allows calling without arguments)
624
+ - **BREAKING**: Update ProductAttribute interface structure
625
+ - Remove id and product_id fields
626
+ - Change attribute.status to attribute.sort_order
627
+ - Migration: Update code that accesses ProductAttribute fields to use new structure
628
+
629
+ ## [0.16.0] - 2025-12-09
630
+
631
+ ### Added
632
+
633
+ - Add attributes field to ProductDetails interface
634
+
635
+ ## [0.15.1] - 2025-12-04
636
+
637
+ ### Changed
638
+
639
+ - Add newly favorited items to beginning of list in optimistic updates (unshift instead of push)
640
+
641
+ ## [0.15.0] - 2025-12-04
642
+
643
+ ### Added
644
+
645
+ - Add optimistic updates for favorite mutations (add/delete)
646
+ - Add cache tags for BestsellerProduct, ProductDetails, SupplierProduct, SupplierProductDetails
647
+
648
+ ### Changed
649
+
650
+ - Revert getBestSellers params simplification to properly handle void argument
651
+ - Refactor FavoriteMerchantItem to extend BaseProduct interface
652
+ - Update AddFavoriteMerchantItemRequest to include optional optimisticUpdate parameter
653
+ - Add conditional tag invalidation based on optimisticUpdate presence
654
+ - Standardize params order in infinite queries: queryArg spread before page param
655
+ - Simplify getBestSellers query params (remove unnecessary spread)
656
+
657
+ ### Removed
658
+
659
+ - Remove deprecated getProductById endpoint (use getProduct instead)
660
+ - Remove GetProductByIdRequest and GetProductByIdResponse types
661
+
662
+ ## [0.14.0] - 2025-12-04
663
+
664
+ ### Added
665
+
666
+ - Add useCategoryBreadcrumbs hook for building category breadcrumbs navigation
667
+ - Export useCategoryBreadcrumbs from category module
668
+
669
+ ### Changed
670
+
671
+ - **BREAKING**: Replace getCategories infinite query with regular query
672
+ - Changed from useGetCategoriesInfiniteQuery to useGetCategoriesQuery
673
+ - Update endpoint from v1 to v2 API with POST method
674
+ - Response no longer paginated, returns full category tree
675
+ - Migration: Replace useGetCategoriesInfiniteQuery() with useGetCategoriesQuery()
676
+ - **BREAKING**: Update GetCategoriesRequest interface
677
+ - Make search parameter optional
678
+ - Remove per_page parameter (no longer paginated)
679
+ - **BREAKING**: Update TreeCategory interface
680
+ - Make parent_id, icon, thumb fields non-nullable
681
+ - Add keepUnusedDataFor: Infinity to getCategories for persistent caching
682
+ - **BREAKING**: Remove attribute_ids field from GetProductsRequest.attribute_filter
683
+ - attribute_filter now only contains attribute_values field
684
+ - Migration: Remove attribute_ids from filter objects, use only attribute_values
685
+ - Refactor GetProductsRequest from Partial type alias to interface with optional properties
686
+ - Add type reuse: GetProductAttributesRequest, GetProductOptionsRequest, and GetSupplierProductsRequest now reuse GetProductsRequest types for option_value_filter and attribute_filter
687
+ - Fix GetProductAttributesResponse field naming (values → value) for consistency
688
+
689
+ ## [0.13.0] - 2025-12-01
690
+
691
+ ### Added
692
+
693
+ - Add createOrder mutation for creating orders
694
+ - Add CreateOrderRequest/Response types with full order creation support
695
+
696
+ ### Changed
697
+
698
+ - Make request parameters optional (void) for queries without required params:
699
+ - getProducts, getProductsByQr, getBestSellers, getSupplierProducts
700
+ - Allows calling hooks without arguments: `useGetProductsInfiniteQuery()`
701
+
702
+ ## [0.12.0] - 2025-11-28
703
+
704
+ ### Added
705
+
706
+ - Add Order API endpoints:
707
+ - checkTelephone - Validate phone number (blacklist, duplicates)
708
+ - getDeliveryMethods - Get available delivery methods for merchant
709
+ - getPaymentMethods - Get available payment methods for merchant
710
+ - Add Order API types (CheckTelephoneRequest/Response, DeliveryMethod, PaymentMethod, GetDeliveryMethodsRequest/Response, GetPaymentMethodsRequest/Response)
711
+ - Export Order API from main package entry point
712
+ - Add Product filtering endpoints:
713
+ - getProductAttributes - Search product attributes with filtering
714
+ - getProductOptions - Search product options with filtering
715
+ - Add Product filtering types (GetProductAttributesRequest/Response, GetProductOptionsRequest/Response)
716
+
717
+ ## [0.11.0] - 2025-11-27
718
+
719
+ ### Changed
720
+
721
+ - **BREAKING**: Update StoreInfo.banners structure
722
+ - Changed from flat array to object with desktop and mobile arrays
723
+ - Migration: Use `banners.desktop` or `banners.mobile` instead of `banners`
724
+ - **BREAKING**: Update StorePhone interface structure
725
+ - Changed fields: full, code, number (instead of original, el64, international, national, mobile)
726
+ - Migration: Adapt code to use new field names
727
+ - Update getStoreInfo endpoint to use v2 API
728
+ - Change StoreTemplate.type from union type to string for flexibility
729
+ - Make StoreTemplate.product_id nullable
730
+
731
+ ## [0.10.1] - 2025-11-26
732
+
733
+ ### Added
734
+
735
+ - Include CHANGELOG.md in published npm package
736
+
737
+ ## [0.10.0] - 2025-11-26
738
+
739
+ ### Added
740
+
741
+ - Add supplier products endpoints (getSupplierProducts, getSupplierProductDetails)
742
+ - Add supplier product types (GetSupplierProductsRequest, SupplierProductDetails, ProductAttribute)
743
+ - Add TODO markers for duplicate endpoints (getProduct/getProductById)
744
+ - Add Countries API documentation to README (useGetCountriesInfiniteQuery)
745
+
746
+ ### Changed
747
+
748
+ - Improve GetProductsRequest type - specify exact price_type values
749
+ - Add TODO for GetProductDetailsRequest refactoring
750
+ - Exclude dist directory from ESLint linting
751
+ - **BREAKING**: Replace undefined with void in RTK Query request parameters
752
+ - Affected endpoints: registerGuest, logout, deleteCustomerAccount, getCartCount,
753
+ getFavoriteCount, getNotificationsCount, getNewSuppliersCount,
754
+ markAllNotificationsAsRead, deleteAllNotifications
755
+ - Affected optional parameters: getAdPlatforms, getReferralStatistics, getStories
756
+ - Migration: Remove explicit undefined arguments from hook calls
757
+ - Example: `useGetCartCountQuery()` instead of `useGetCartCountQuery(undefined)`
758
+ - Remove useless undefined type aliases across multiple modules
759
+ - auth: LogoutRequest, LogoutResponse, RegisterGuestRequest
760
+ - customer: DeleteCustomerAccountRequest, DeleteCustomerAccountResponse
761
+ - cart: GetCartCountRequest, RemoveItemFromCartResponse, RemoveMerchantFromCartResponse
762
+ - supplier: MarkSupplierAsOldResponse
763
+ - notification: GetNotificationsCountRequest, GetNewSuppliersCountRequest,
764
+ MarkAllNotificationsAsReadRequest, DeleteAllNotificationsRequest
765
+ - favorite: GetFavoriteCountRequest, DeleteFavoriteMerchantItemResponse
766
+ - chat: DeleteChatMessageResponse
767
+ - All replaced with inline undefined in RTK Query endpoints
768
+ - Replace `Partial<{}>` type aliases with interface definitions using optional properties
769
+ - ad: GetAdPlatformsRequest
770
+ - cart: GetCartMerchantsRequest
771
+ - novaposhta: GetNovaposhtaCitiesRequest, GetNovaposhtaStreetsRequest, GetNovaposhtaWarehousesRequest
772
+ - product: GetProductsByQrRequest, GetBestsellersRequest
773
+ - stories: GetStoriesRequest
774
+
775
+ ## [0.9.3] - 2025-11-24
776
+
777
+ ### Added
778
+
779
+ - Enhance Store interfaces with additional properties and types
780
+
781
+ ## [0.9.2] - 2025-11-20
782
+
783
+ ### Fixed
784
+
785
+ - Missing build
786
+
787
+ ## [0.9.1] - 2025-11-20
788
+
789
+ ### Fixed
790
+
791
+ - Correct URL for bestsellers endpoint
792
+
793
+ ## [0.9.0] - 2025-11-20
794
+
795
+ ### Added
796
+
797
+ - Add registerGuest mutation and types for guest registration
798
+ - Extend GetProductsRequest with attribute_filter and filter_product_ids
799
+
800
+ ### Changed
801
+
802
+ - Update CHANGELOG.md
803
+ - Update README.md
804
+
805
+ ## [0.8.0] - 2025-11-18
806
+
807
+ ### Added
808
+
809
+ - Add customer api, account management endpoints and types
810
+
811
+ ### Changed
812
+
813
+ - Update CHANGELOG.md
814
+ - Update README.md
815
+
816
+ ## [0.7.0] - 2025-11-18
817
+
818
+ ### Added
819
+
820
+ - Add getStoreArticles endpoint and related types
821
+
822
+ ### Changed
823
+
824
+ - Update CHANGELOG.md
825
+ - Update README.md
826
+
827
+ ## [0.6.0] - 2025-11-17
828
+
829
+ ### Changed
830
+
831
+ - Update CHANGELOG.md
832
+ - Update StorePhone interface
833
+
834
+ ## [0.5.0] - 2025-11-14
835
+
836
+ ### Added
837
+
838
+ - Implement getStoreInfo endpoint and related types
839
+
840
+ ### Changed
841
+
842
+ - Update README.md
843
+ - Update CHANGELOG.md
844
+
845
+ ## [0.4.0] - 2025-11-14
846
+
847
+ ### Added
848
+
849
+ - Add logout endpoint
850
+
851
+ ### Changed
852
+
853
+ - Update README.md
854
+ - Update CHANGELOG.md
855
+ - Update ESLint and TypeScript dependencies to latest versions
856
+
857
+ ## [0.3.0] - 2025-11-07
858
+
859
+ ### Added
860
+
861
+ - Add country API
862
+
863
+ ### Changed
864
+
865
+ - Add ESLint rule for unused variables
866
+ - Update CHANGELOG.md
867
+
868
+ ## [0.2.0] - 2025-11-06
869
+
870
+ ### Changed
871
+
872
+ - Move @reduxjs/toolkit to peerDependencies. @reduxjs/toolkit is now a peer dependency and must be installed separately by the user
873
+
874
+ ## [0.1.1] - 2025-11-05
875
+
876
+ ### Changed
877
+
878
+ - Bump version
879
+ - Update README
880
+
881
+ ### Fixed
882
+
883
+ - Add missing export isValidationError and ValidationError type from shared/api
884
+
885
+ ## [0.1.0] - 2025-11-05
886
+
887
+ ### Added
888
+
889
+ - Create CHANGELOG.md to document project updates
890
+ - Add ValidationError interface and related utility functions
891
+ - Extract getNextPageParam function for reusable pagination logic across APIs
892
+ - Replace PaginationLinks and PaginationMeta with PaginatedResponse in various entities
893
+
894
+ ### Changed
895
+
896
+ - Bump version
897
+ - Update README
898
+
899
+ ## [0.0.1] - 2025-11-04
900
+
901
+ ### Added
902
+
903
+ -
904
+
905
+ [unreleased]: https://github.com/olivierlacan/keep-a-changelog/compare/[latest version / v1.1.1]...HEAD
906
+ [0.0.1]: https://github.com/[username]/[repository]/releases/tag/v0.0.1