@reactionary/source 0.0.52 → 0.2.16

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 (293) hide show
  1. package/.env-template +19 -0
  2. package/.github/workflows/pull-request.yml +3 -1
  3. package/.github/workflows/release.yml +9 -0
  4. package/.vscode/extensions.json +0 -2
  5. package/LICENSE +21 -0
  6. package/README.md +175 -23
  7. package/core/package.json +6 -3
  8. package/core/src/cache/cache.interface.ts +1 -0
  9. package/core/src/cache/index.ts +4 -0
  10. package/core/src/cache/memory-cache.ts +30 -2
  11. package/core/src/cache/noop-cache.ts +15 -1
  12. package/core/src/cache/redis-cache.ts +20 -0
  13. package/core/src/client/client-builder.ts +71 -54
  14. package/core/src/client/client.ts +9 -47
  15. package/core/src/client/index.ts +2 -0
  16. package/core/src/decorators/index.ts +1 -0
  17. package/core/src/decorators/reactionary.decorator.ts +203 -34
  18. package/core/src/index.ts +6 -19
  19. package/core/src/initialization.ts +1 -18
  20. package/core/src/metrics/metrics.ts +67 -0
  21. package/core/src/providers/analytics.provider.ts +1 -6
  22. package/core/src/providers/base.provider.ts +5 -69
  23. package/core/src/providers/cart.provider.ts +15 -55
  24. package/core/src/providers/category.provider.ts +7 -11
  25. package/core/src/providers/checkout.provider.ts +17 -15
  26. package/core/src/providers/identity.provider.ts +6 -8
  27. package/core/src/providers/index.ts +2 -1
  28. package/core/src/providers/inventory.provider.ts +15 -5
  29. package/core/src/providers/order-search.provider.ts +29 -0
  30. package/core/src/providers/order.provider.ts +47 -15
  31. package/core/src/providers/price.provider.ts +30 -36
  32. package/core/src/providers/product-search.provider.ts +61 -0
  33. package/core/src/providers/product.provider.ts +71 -12
  34. package/core/src/providers/profile.provider.ts +74 -14
  35. package/core/src/providers/store.provider.ts +3 -5
  36. package/core/src/schemas/capabilities.schema.ts +10 -3
  37. package/core/src/schemas/errors/generic.error.ts +9 -0
  38. package/core/src/schemas/errors/index.ts +4 -0
  39. package/core/src/schemas/errors/invalid-input.error.ts +9 -0
  40. package/core/src/schemas/errors/invalid-output.error.ts +9 -0
  41. package/core/src/schemas/errors/not-found.error.ts +9 -0
  42. package/core/src/schemas/index.ts +7 -0
  43. package/core/src/schemas/models/analytics.model.ts +2 -1
  44. package/core/src/schemas/models/base.model.ts +6 -24
  45. package/core/src/schemas/models/cart.model.ts +5 -8
  46. package/core/src/schemas/models/category.model.ts +4 -9
  47. package/core/src/schemas/models/checkout.model.ts +6 -7
  48. package/core/src/schemas/models/cost.model.ts +4 -3
  49. package/core/src/schemas/models/currency.model.ts +2 -1
  50. package/core/src/schemas/models/identifiers.model.ts +106 -62
  51. package/core/src/schemas/models/identity.model.ts +10 -19
  52. package/core/src/schemas/models/index.ts +2 -1
  53. package/core/src/schemas/models/inventory.model.ts +8 -5
  54. package/core/src/schemas/models/order-search.model.ts +28 -0
  55. package/core/src/schemas/models/order.model.ts +20 -26
  56. package/core/src/schemas/models/payment.model.ts +14 -17
  57. package/core/src/schemas/models/price.model.ts +11 -11
  58. package/core/src/schemas/models/product-search.model.ts +42 -0
  59. package/core/src/schemas/models/product.model.ts +64 -22
  60. package/core/src/schemas/models/profile.model.ts +19 -22
  61. package/core/src/schemas/models/shipping-method.model.ts +24 -29
  62. package/core/src/schemas/models/store.model.ts +9 -5
  63. package/core/src/schemas/mutations/analytics.mutation.ts +8 -7
  64. package/core/src/schemas/mutations/base.mutation.ts +2 -1
  65. package/core/src/schemas/mutations/cart.mutation.ts +33 -33
  66. package/core/src/schemas/mutations/checkout.mutation.ts +23 -30
  67. package/core/src/schemas/mutations/identity.mutation.ts +4 -3
  68. package/core/src/schemas/mutations/profile.mutation.ts +38 -3
  69. package/core/src/schemas/queries/base.query.ts +2 -1
  70. package/core/src/schemas/queries/cart.query.ts +3 -3
  71. package/core/src/schemas/queries/category.query.ts +18 -18
  72. package/core/src/schemas/queries/checkout.query.ts +7 -9
  73. package/core/src/schemas/queries/identity.query.ts +2 -1
  74. package/core/src/schemas/queries/index.ts +2 -1
  75. package/core/src/schemas/queries/inventory.query.ts +5 -5
  76. package/core/src/schemas/queries/order-search.query.ts +10 -0
  77. package/core/src/schemas/queries/order.query.ts +3 -2
  78. package/core/src/schemas/queries/price.query.ts +10 -4
  79. package/core/src/schemas/queries/product-search.query.ts +16 -0
  80. package/core/src/schemas/queries/product.query.ts +13 -6
  81. package/core/src/schemas/queries/profile.query.ts +5 -2
  82. package/core/src/schemas/queries/store.query.ts +6 -5
  83. package/core/src/schemas/result.ts +107 -0
  84. package/core/src/schemas/session.schema.ts +4 -4
  85. package/core/src/test/reactionary.decorator.spec.ts +249 -0
  86. package/core/src/zod-utils.ts +19 -0
  87. package/core/tsconfig.json +1 -1
  88. package/core/tsconfig.spec.json +2 -26
  89. package/core/vitest.config.ts +14 -0
  90. package/documentation/1-purpose.md +114 -0
  91. package/documentation/2-getting-started.md +229 -0
  92. package/documentation/3-querying-and-changing-data.md +74 -0
  93. package/documentation/4-product-data.md +107 -0
  94. package/documentation/5-cart-and-checkout.md +211 -0
  95. package/documentation/6-product-search.md +143 -0
  96. package/documentation/7-marketing.md +3 -0
  97. package/eslint.config.mjs +1 -0
  98. package/examples/node/eslint.config.mjs +1 -4
  99. package/examples/node/package.json +10 -3
  100. package/examples/node/project.json +4 -1
  101. package/examples/node/src/basic/basic-node-provider-model-extension.spec.ts +22 -23
  102. package/examples/node/src/basic/basic-node-provider-query-extension.spec.ts +15 -11
  103. package/examples/node/src/basic/basic-node-setup.spec.ts +44 -28
  104. package/examples/node/src/basic/client-creation.spec.ts +53 -0
  105. package/examples/node/src/capabilities/cart.spec.ts +255 -0
  106. package/examples/node/src/capabilities/category.spec.ts +193 -0
  107. package/examples/node/src/capabilities/checkout.spec.ts +341 -0
  108. package/examples/node/src/capabilities/identity.spec.ts +93 -0
  109. package/examples/node/src/capabilities/inventory.spec.ts +66 -0
  110. package/examples/node/src/capabilities/order-search.spec.ts +265 -0
  111. package/examples/node/src/capabilities/order.spec.ts +91 -0
  112. package/examples/node/src/capabilities/price.spec.ts +51 -0
  113. package/examples/node/src/capabilities/product-search.spec.ts +293 -0
  114. package/examples/node/src/capabilities/product.spec.ts +122 -0
  115. package/examples/node/src/capabilities/profile.spec.ts +316 -0
  116. package/examples/node/src/capabilities/store.spec.ts +26 -0
  117. package/examples/node/src/utils.ts +147 -0
  118. package/examples/node/tsconfig.json +9 -12
  119. package/examples/node/tsconfig.lib.json +1 -2
  120. package/examples/node/tsconfig.spec.json +2 -14
  121. package/examples/node/vitest.config.ts +14 -0
  122. package/migrations.json +22 -5
  123. package/nx.json +8 -47
  124. package/package.json +24 -96
  125. package/providers/algolia/README.md +39 -2
  126. package/providers/algolia/package.json +2 -1
  127. package/providers/algolia/src/core/initialize.ts +7 -14
  128. package/providers/algolia/src/index.ts +2 -4
  129. package/providers/algolia/src/providers/index.ts +1 -0
  130. package/providers/algolia/src/providers/product-search.provider.ts +241 -0
  131. package/providers/algolia/src/schema/capabilities.schema.ts +2 -3
  132. package/providers/algolia/src/schema/index.ts +3 -0
  133. package/providers/algolia/src/schema/search.schema.ts +8 -8
  134. package/providers/algolia/tsconfig.json +1 -1
  135. package/providers/algolia/tsconfig.lib.json +1 -1
  136. package/providers/algolia/tsconfig.spec.json +2 -14
  137. package/providers/algolia/vitest.config.ts +14 -0
  138. package/providers/commercetools/README.md +30 -3
  139. package/providers/commercetools/package.json +2 -1
  140. package/providers/commercetools/src/core/client.ts +178 -99
  141. package/providers/commercetools/src/core/initialize.ts +130 -74
  142. package/providers/commercetools/src/core/token-cache.ts +45 -0
  143. package/providers/commercetools/src/index.ts +3 -2
  144. package/providers/commercetools/src/providers/cart.provider.ts +281 -341
  145. package/providers/commercetools/src/providers/category.provider.ts +223 -138
  146. package/providers/commercetools/src/providers/checkout.provider.ts +631 -449
  147. package/providers/commercetools/src/providers/identity.provider.ts +50 -29
  148. package/providers/commercetools/src/providers/index.ts +2 -2
  149. package/providers/commercetools/src/providers/inventory.provider.ts +76 -74
  150. package/providers/commercetools/src/providers/order-search.provider.ts +220 -0
  151. package/providers/commercetools/src/providers/order.provider.ts +96 -61
  152. package/providers/commercetools/src/providers/price.provider.ts +147 -117
  153. package/providers/commercetools/src/providers/product-search.provider.ts +528 -0
  154. package/providers/commercetools/src/providers/product.provider.ts +249 -74
  155. package/providers/commercetools/src/providers/profile.provider.ts +445 -28
  156. package/providers/commercetools/src/providers/store.provider.ts +54 -40
  157. package/providers/commercetools/src/schema/capabilities.schema.ts +3 -1
  158. package/providers/commercetools/src/schema/commercetools.schema.ts +17 -3
  159. package/providers/commercetools/src/schema/configuration.schema.ts +1 -0
  160. package/providers/commercetools/src/schema/session.schema.ts +7 -0
  161. package/providers/commercetools/src/test/caching.spec.ts +82 -0
  162. package/providers/commercetools/src/test/identity.spec.ts +109 -0
  163. package/providers/commercetools/src/test/test-utils.ts +21 -19
  164. package/providers/commercetools/tsconfig.json +1 -1
  165. package/providers/commercetools/tsconfig.lib.json +1 -1
  166. package/providers/commercetools/tsconfig.spec.json +2 -14
  167. package/providers/commercetools/vitest.config.ts +15 -0
  168. package/providers/fake/README.md +20 -4
  169. package/providers/fake/package.json +2 -1
  170. package/providers/fake/src/core/initialize.ts +47 -49
  171. package/providers/fake/src/providers/analytics.provider.ts +5 -7
  172. package/providers/fake/src/providers/cart.provider.ts +163 -92
  173. package/providers/fake/src/providers/category.provider.ts +78 -50
  174. package/providers/fake/src/providers/checkout.provider.ts +254 -0
  175. package/providers/fake/src/providers/identity.provider.ts +57 -65
  176. package/providers/fake/src/providers/index.ts +6 -2
  177. package/providers/fake/src/providers/inventory.provider.ts +40 -36
  178. package/providers/fake/src/providers/order-search.provider.ts +78 -0
  179. package/providers/fake/src/providers/order.provider.ts +106 -0
  180. package/providers/fake/src/providers/price.provider.ts +93 -41
  181. package/providers/fake/src/providers/product-search.provider.ts +206 -0
  182. package/providers/fake/src/providers/product.provider.ts +56 -41
  183. package/providers/fake/src/providers/profile.provider.ts +147 -0
  184. package/providers/fake/src/providers/store.provider.ts +30 -20
  185. package/providers/fake/src/schema/capabilities.schema.ts +5 -1
  186. package/providers/fake/src/test/cart.provider.spec.ts +59 -80
  187. package/providers/fake/src/test/category.provider.spec.ts +145 -87
  188. package/providers/fake/src/test/checkout.provider.spec.ts +222 -0
  189. package/providers/fake/src/test/order-search.provider.spec.ts +50 -0
  190. package/providers/fake/src/test/order.provider.spec.ts +44 -0
  191. package/providers/fake/src/test/price.provider.spec.ts +50 -45
  192. package/providers/fake/src/test/product.provider.spec.ts +15 -7
  193. package/providers/fake/src/test/profile.provider.spec.ts +167 -0
  194. package/providers/fake/tsconfig.json +1 -1
  195. package/providers/fake/tsconfig.lib.json +1 -1
  196. package/providers/fake/tsconfig.spec.json +2 -12
  197. package/providers/fake/vitest.config.ts +14 -0
  198. package/providers/medusa/README.md +30 -0
  199. package/providers/medusa/TESTING.md +98 -0
  200. package/providers/medusa/eslint.config.mjs +19 -0
  201. package/providers/medusa/package.json +22 -0
  202. package/providers/medusa/project.json +34 -0
  203. package/providers/medusa/src/core/client.ts +370 -0
  204. package/providers/medusa/src/core/initialize.ts +78 -0
  205. package/providers/medusa/src/index.ts +13 -0
  206. package/providers/medusa/src/providers/cart.provider.ts +575 -0
  207. package/providers/medusa/src/providers/category.provider.ts +247 -0
  208. package/providers/medusa/src/providers/checkout.provider.ts +636 -0
  209. package/providers/medusa/src/providers/identity.provider.ts +137 -0
  210. package/providers/medusa/src/providers/inventory.provider.ts +173 -0
  211. package/providers/medusa/src/providers/order-search.provider.ts +202 -0
  212. package/providers/medusa/src/providers/order.provider.ts +226 -0
  213. package/providers/medusa/src/providers/price.provider.ts +140 -0
  214. package/providers/medusa/src/providers/product-search.provider.ts +243 -0
  215. package/providers/medusa/src/providers/product.provider.ts +261 -0
  216. package/providers/medusa/src/providers/profile.provider.ts +392 -0
  217. package/providers/medusa/src/schema/capabilities.schema.ts +18 -0
  218. package/providers/medusa/src/schema/configuration.schema.ts +11 -0
  219. package/providers/medusa/src/schema/medusa.schema.ts +31 -0
  220. package/providers/medusa/src/test/cart.provider.spec.ts +240 -0
  221. package/providers/medusa/src/test/category.provider.spec.ts +231 -0
  222. package/providers/medusa/src/test/checkout.spec.ts +349 -0
  223. package/providers/medusa/src/test/identity.provider.spec.ts +122 -0
  224. package/providers/medusa/src/test/inventory.provider.spec.ts +88 -0
  225. package/providers/medusa/src/test/large-cart.provider.spec.ts +103 -0
  226. package/providers/medusa/src/test/price.provider.spec.ts +104 -0
  227. package/providers/medusa/src/test/product.provider.spec.ts +146 -0
  228. package/providers/medusa/src/test/search.provider.spec.ts +203 -0
  229. package/providers/medusa/src/test/test-utils.ts +13 -0
  230. package/providers/medusa/src/utils/medusa-helpers.ts +89 -0
  231. package/providers/medusa/tsconfig.json +21 -0
  232. package/providers/medusa/tsconfig.lib.json +9 -0
  233. package/providers/medusa/tsconfig.spec.json +4 -0
  234. package/providers/medusa/vitest.config.ts +15 -0
  235. package/providers/meilisearch/README.md +48 -0
  236. package/providers/meilisearch/eslint.config.mjs +22 -0
  237. package/providers/meilisearch/package.json +13 -0
  238. package/providers/meilisearch/project.json +34 -0
  239. package/providers/meilisearch/src/core/initialize.ts +21 -0
  240. package/providers/meilisearch/src/index.ts +6 -0
  241. package/providers/meilisearch/src/providers/index.ts +1 -0
  242. package/providers/meilisearch/src/providers/order-search.provider.ts +222 -0
  243. package/providers/meilisearch/src/providers/product-search.provider.ts +251 -0
  244. package/providers/meilisearch/src/schema/capabilities.schema.ts +10 -0
  245. package/providers/meilisearch/src/schema/configuration.schema.ts +11 -0
  246. package/providers/meilisearch/src/schema/index.ts +3 -0
  247. package/providers/meilisearch/src/schema/search.schema.ts +14 -0
  248. package/providers/meilisearch/tsconfig.json +24 -0
  249. package/providers/meilisearch/tsconfig.lib.json +10 -0
  250. package/providers/meilisearch/tsconfig.spec.json +4 -0
  251. package/providers/meilisearch/vitest.config.ts +14 -0
  252. package/providers/posthog/package.json +2 -1
  253. package/providers/posthog/tsconfig.json +1 -1
  254. package/tsconfig.base.json +5 -0
  255. package/vitest.config.ts +10 -0
  256. package/core/src/providers/search.provider.ts +0 -18
  257. package/core/src/schemas/models/search.model.ts +0 -36
  258. package/core/src/schemas/queries/search.query.ts +0 -9
  259. package/examples/next/.swcrc +0 -30
  260. package/examples/next/eslint.config.mjs +0 -21
  261. package/examples/next/index.d.ts +0 -6
  262. package/examples/next/next-env.d.ts +0 -5
  263. package/examples/next/next.config.js +0 -31
  264. package/examples/next/project.json +0 -9
  265. package/examples/next/public/.gitkeep +0 -0
  266. package/examples/next/public/favicon.ico +0 -0
  267. package/examples/next/src/app/global.css +0 -0
  268. package/examples/next/src/app/layout.tsx +0 -18
  269. package/examples/next/src/app/page.module.scss +0 -2
  270. package/examples/next/src/app/page.tsx +0 -47
  271. package/examples/next/src/instrumentation.ts +0 -9
  272. package/examples/next/tsconfig.json +0 -44
  273. package/examples/node/jest.config.ts +0 -10
  274. package/jest.config.ts +0 -6
  275. package/jest.preset.js +0 -3
  276. package/providers/algolia/jest.config.ts +0 -10
  277. package/providers/algolia/src/providers/product.provider.ts +0 -66
  278. package/providers/algolia/src/providers/search.provider.ts +0 -106
  279. package/providers/algolia/src/test/search.provider.spec.ts +0 -91
  280. package/providers/commercetools/jest.config.cjs +0 -10
  281. package/providers/commercetools/src/providers/search.provider.ts +0 -96
  282. package/providers/commercetools/src/test/cart.provider.spec.ts +0 -199
  283. package/providers/commercetools/src/test/category.provider.spec.ts +0 -168
  284. package/providers/commercetools/src/test/checkout.provider.spec.ts +0 -312
  285. package/providers/commercetools/src/test/identity.provider.spec.ts +0 -88
  286. package/providers/commercetools/src/test/inventory.provider.spec.ts +0 -41
  287. package/providers/commercetools/src/test/price.provider.spec.ts +0 -81
  288. package/providers/commercetools/src/test/product.provider.spec.ts +0 -80
  289. package/providers/commercetools/src/test/profile.provider.spec.ts +0 -49
  290. package/providers/commercetools/src/test/search.provider.spec.ts +0 -61
  291. package/providers/commercetools/src/test/store.provider.spec.ts +0 -37
  292. package/providers/fake/jest.config.cjs +0 -10
  293. package/providers/fake/src/providers/search.provider.ts +0 -132
@@ -0,0 +1,247 @@
1
+ import type {
2
+ StoreProductCategory,
3
+ StoreProductCategoryListResponse,
4
+ } from '@medusajs/types';
5
+ import type { Category, Cache, CategoryPaginatedResult } from '@reactionary/core';
6
+ import {
7
+ CategoryIdentifierSchema,
8
+ CategoryProvider,
9
+ CategorySchema,
10
+ CategoryQueryByIdSchema,
11
+ CategoryQueryBySlugSchema,
12
+ CategoryQueryForBreadcrumbSchema,
13
+ CategoryQueryForChildCategoriesSchema,
14
+ CategoryQueryForTopCategoriesSchema,
15
+ createPaginatedResponseSchema,
16
+ Reactionary,
17
+ success,
18
+ error,
19
+ type Result,
20
+ type NotFoundError,
21
+ type CategoryQueryById,
22
+ type CategoryQueryBySlug,
23
+ type CategoryQueryForBreadcrumb,
24
+ type CategoryQueryForChildCategories,
25
+ type CategoryQueryForTopCategories,
26
+ type RequestContext,
27
+ CategoryPaginatedResultSchema,
28
+ } from '@reactionary/core';
29
+ import type { MedusaAPI, MedusaConfiguration } from '../index.js';
30
+ import z from 'zod';
31
+
32
+ export class MedusaCategoryProvider extends CategoryProvider {
33
+ protected config: MedusaConfiguration;
34
+
35
+ constructor(
36
+ config: MedusaConfiguration,
37
+ cache: Cache,
38
+ context: RequestContext,
39
+ public medusaApi: MedusaAPI
40
+ ) {
41
+ super(cache, context);
42
+ this.config = config;
43
+ }
44
+
45
+ protected async resolveCategoryIdByExternalId(
46
+ externalId: string
47
+ ): Promise<StoreProductCategory | null> {
48
+ const sdk = await this.medusaApi.getClient();
49
+ let offset = 0;
50
+ const limit = 50;
51
+ let candidate: StoreProductCategory | undefined = undefined;
52
+ while (true) {
53
+ try {
54
+ const categoryResult = await sdk.store.category.list({
55
+ offset,
56
+ limit,
57
+ });
58
+
59
+ if (categoryResult.product_categories.length === 0) {
60
+ break;
61
+ }
62
+
63
+ candidate = categoryResult.product_categories.find(
64
+ (cat) => cat.metadata?.['external_id'] === externalId
65
+ );
66
+ if (candidate) {
67
+ break;
68
+ }
69
+ offset += limit;
70
+ } catch (error) {
71
+ throw new Error(
72
+ 'Category not found ' + externalId + ' due to error: ' + error
73
+ );
74
+ break;
75
+ }
76
+ }
77
+ return candidate || null;
78
+ }
79
+
80
+ @Reactionary({
81
+ inputSchema: CategoryQueryByIdSchema,
82
+ outputSchema: CategorySchema,
83
+ })
84
+ public override async getById(payload: CategoryQueryById): Promise<Result<Category, NotFoundError>> {
85
+ const candidate = await this.resolveCategoryIdByExternalId(payload.id.key);
86
+ if (!candidate) {
87
+ return error<NotFoundError>({
88
+ type: 'NotFound',
89
+ identifier: payload
90
+ })
91
+ }
92
+ return success(this.parseSingle(candidate));
93
+ }
94
+
95
+ @Reactionary({
96
+ inputSchema: CategoryQueryBySlugSchema,
97
+ outputSchema: CategorySchema.nullable(),
98
+ })
99
+ public override async getBySlug(
100
+ payload: CategoryQueryBySlug
101
+ ): Promise<Result<Category, NotFoundError>> {
102
+ const sdk = await this.medusaApi.getClient();
103
+
104
+ const categoryResult = await sdk.store.category.list({
105
+ handle: payload.slug,
106
+ limit: 1,
107
+ offset: 0,
108
+ });
109
+ if (categoryResult.count === 0) {
110
+ return error<NotFoundError>({
111
+ type: 'NotFound',
112
+ identifier: payload
113
+ });
114
+ }
115
+ return success(this.parseSingle(categoryResult.product_categories[0]));
116
+ }
117
+
118
+ @Reactionary({
119
+ inputSchema: CategoryQueryForBreadcrumbSchema,
120
+ outputSchema: z.array(CategorySchema),
121
+ })
122
+ public override async getBreadcrumbPathToCategory(
123
+ payload: CategoryQueryForBreadcrumb
124
+ ): Promise<Result<Category[]>> {
125
+ const actualCategoryId = await this.resolveCategoryIdByExternalId(
126
+ payload.id.key
127
+ );
128
+ if (!actualCategoryId) {
129
+ throw new Error('Category not found ' + payload.id.key);
130
+ }
131
+
132
+ const sdk = await this.medusaApi.getClient();
133
+ const path = await sdk.store.category.retrieve(actualCategoryId.id, {
134
+ fields: '+metadata,+parent_category.metadata',
135
+ include_ancestors_tree: true,
136
+ });
137
+
138
+ let results = new Array<Category>();
139
+ let current: StoreProductCategory | null = path.product_category;
140
+ while (current) {
141
+ results.push(this.parseSingle(current));
142
+ current = current.parent_category;
143
+ }
144
+ results = results.reverse();
145
+ return success(results);
146
+ }
147
+
148
+ @Reactionary({
149
+ inputSchema: CategoryQueryForChildCategoriesSchema,
150
+ outputSchema: CategoryPaginatedResultSchema,
151
+ })
152
+ public override async findChildCategories(
153
+ payload: CategoryQueryForChildCategories
154
+ ) {
155
+ const sdk = await this.medusaApi.getClient();
156
+
157
+ const actualParentId = await this.resolveCategoryIdByExternalId(
158
+ payload.parentId.key
159
+ );
160
+ if (!actualParentId) {
161
+ throw new Error('Parent category not found ' + payload.parentId.key);
162
+ }
163
+
164
+ const response = await sdk.store.category.list({
165
+ fields: '+metadata,+parent_category.metadata',
166
+ parent_category_id: actualParentId.id,
167
+ limit: payload.paginationOptions.pageSize,
168
+ offset:
169
+ (payload.paginationOptions.pageNumber - 1) *
170
+ payload.paginationOptions.pageSize,
171
+ });
172
+
173
+ const result = this.parsePaginatedResult(response);
174
+ return success(result);
175
+ }
176
+
177
+ @Reactionary({
178
+ inputSchema: CategoryQueryForTopCategoriesSchema,
179
+ outputSchema: CategoryPaginatedResultSchema,
180
+ })
181
+ public override async findTopCategories(
182
+ payload: CategoryQueryForTopCategories
183
+ ) {
184
+ const sdk = await this.medusaApi.getClient();
185
+
186
+ const response = await sdk.store.category.list({
187
+ fields: '+metadata',
188
+ parent_category_id: 'null',
189
+ limit: payload.paginationOptions.pageSize,
190
+ offset:
191
+ (payload.paginationOptions.pageNumber - 1) *
192
+ payload.paginationOptions.pageSize,
193
+ });
194
+
195
+ const result = this.parsePaginatedResult(response);
196
+
197
+ return success(result);
198
+ }
199
+
200
+ protected parseSingle(_body: StoreProductCategory): Category {
201
+ const identifier = CategoryIdentifierSchema.parse({
202
+ key: _body.metadata?.['external_id'] || '',
203
+ });
204
+
205
+ const name = _body.name;
206
+ const slug = _body.handle;
207
+ const text = _body.description || _body.name || '';
208
+ const parentCategory = _body.parent_category_id
209
+ ? { key: _body.parent_category?.metadata?.['external_id'] + '' || '' }
210
+ : undefined;
211
+
212
+ const result = {
213
+ identifier,
214
+ name,
215
+ slug,
216
+ text,
217
+ parentCategory,
218
+ images: [],
219
+ } satisfies Category;
220
+
221
+ return result;
222
+ }
223
+
224
+ protected parsePaginatedResult(
225
+ body: StoreProductCategoryListResponse
226
+ ) {
227
+ const items = body.product_categories.map((x) => this.parseSingle(x));
228
+
229
+ const totalPages = Math.ceil(
230
+ (body.count ?? 0) / Math.max(body.product_categories.length, 1)
231
+ );
232
+ const pageNumber =
233
+ body.count === 0
234
+ ? 1
235
+ : Math.floor(body.offset / body.product_categories.length) + 1;
236
+
237
+ const result = {
238
+ pageNumber: pageNumber,
239
+ pageSize: Math.max(body.product_categories.length, 1),
240
+ totalCount: body.count,
241
+ totalPages: totalPages,
242
+ items: items,
243
+ } satisfies CategoryPaginatedResult;
244
+
245
+ return result;
246
+ }
247
+ }