@yoryoboy/bi-mcp 1.11.0 → 1.13.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 (237) hide show
  1. package/README.md +4 -5
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/index.js +398 -8
  4. package/dist/index.js.map +2 -2
  5. package/dist/mcp-use.json +2 -2
  6. package/dist/src/config/__tests__/meta.test.js +35 -0
  7. package/dist/src/config/__tests__/meta.test.js.map +7 -0
  8. package/dist/src/config/meta-store.js +109 -0
  9. package/dist/src/config/meta-store.js.map +7 -0
  10. package/dist/src/config/meta.js +0 -2
  11. package/dist/src/config/meta.js.map +2 -2
  12. package/dist/src/meta/__tests__/meta-utils.test.js +155 -0
  13. package/dist/src/meta/__tests__/meta-utils.test.js.map +7 -0
  14. package/dist/src/services/mercadolibre/__tests__/mercadolibre-api.test.js +265 -0
  15. package/dist/src/services/mercadolibre/__tests__/mercadolibre-api.test.js.map +7 -0
  16. package/dist/src/services/mercadolibre/__tests__/mercadolibre-items.test.js +311 -0
  17. package/dist/src/services/mercadolibre/__tests__/mercadolibre-items.test.js.map +7 -0
  18. package/dist/src/services/mercadolibre/__tests__/mercadolibre-orders.test.js +220 -0
  19. package/dist/src/services/mercadolibre/__tests__/mercadolibre-orders.test.js.map +7 -0
  20. package/dist/src/services/meta/__tests__/meta-ads.test.js +126 -0
  21. package/dist/src/services/meta/__tests__/meta-ads.test.js.map +7 -0
  22. package/dist/src/services/meta/__tests__/meta-api.test.js +70 -0
  23. package/dist/src/services/meta/__tests__/meta-api.test.js.map +7 -0
  24. package/dist/src/services/meta/meta-ads.js +94 -40
  25. package/dist/src/services/meta/meta-ads.js.map +2 -2
  26. package/dist/src/services/meta/meta-api.js +8 -6
  27. package/dist/src/services/meta/meta-api.js.map +2 -2
  28. package/dist/src/services/vtex/__tests__/vtex-catalog-write-batch.test.js +165 -0
  29. package/dist/src/services/vtex/__tests__/vtex-catalog-write-batch.test.js.map +7 -0
  30. package/dist/src/services/vtex/__tests__/vtex-catalog-write-eans.test.js +92 -0
  31. package/dist/src/services/vtex/__tests__/vtex-catalog-write-eans.test.js.map +7 -0
  32. package/dist/src/services/vtex/__tests__/vtex-catalog-write-products.test.js +41 -0
  33. package/dist/src/services/vtex/__tests__/vtex-catalog-write-products.test.js.map +7 -0
  34. package/dist/src/services/vtex/__tests__/vtex-catalog.test.js +80 -0
  35. package/dist/src/services/vtex/__tests__/vtex-catalog.test.js.map +7 -0
  36. package/dist/src/services/vtex/__tests__/vtex-orders-write-http.test.js +85 -0
  37. package/dist/src/services/vtex/__tests__/vtex-orders-write-http.test.js.map +7 -0
  38. package/dist/src/services/vtex/__tests__/vtex-orders-write-state-validation.test.js +251 -0
  39. package/dist/src/services/vtex/__tests__/vtex-orders-write-state-validation.test.js.map +7 -0
  40. package/dist/src/services/vtex/__tests__/vtex-write.test.js +111 -0
  41. package/dist/src/services/vtex/__tests__/vtex-write.test.js.map +7 -0
  42. package/dist/src/services/vtex/vtex-catalog-write.js +194 -1
  43. package/dist/src/services/vtex/vtex-catalog-write.js.map +2 -2
  44. package/dist/src/services/vtex/vtex-catalog.js +118 -1
  45. package/dist/src/services/vtex/vtex-catalog.js.map +2 -2
  46. package/dist/src/services/vtex/vtex-pricing-write.js +5 -0
  47. package/dist/src/services/vtex/vtex-pricing-write.js.map +2 -2
  48. package/dist/src/services/vtex/vtex-write.js +67 -1
  49. package/dist/src/services/vtex/vtex-write.js.map +2 -2
  50. package/dist/src/tools/config/list-profiles.js +37 -6
  51. package/dist/src/tools/config/list-profiles.js.map +2 -2
  52. package/dist/src/tools/index.js.map +2 -2
  53. package/dist/src/tools/mercadolibre/__tests__/helpers.test.js +37 -0
  54. package/dist/src/tools/mercadolibre/__tests__/helpers.test.js.map +7 -0
  55. package/dist/src/tools/mercadolibre/__tests__/profile-resolution.test.js +30 -0
  56. package/dist/src/tools/mercadolibre/__tests__/profile-resolution.test.js.map +7 -0
  57. package/dist/src/tools/mercadolibre/profile-resolution.js +4 -50
  58. package/dist/src/tools/mercadolibre/profile-resolution.js.map +2 -2
  59. package/dist/src/tools/meta/__tests__/pagination.test.js +133 -0
  60. package/dist/src/tools/meta/__tests__/pagination.test.js.map +7 -0
  61. package/dist/src/tools/meta/__tests__/profile-access.test.js +262 -0
  62. package/dist/src/tools/meta/__tests__/profile-access.test.js.map +7 -0
  63. package/dist/src/tools/meta/__tests__/read-tools.test.js +722 -0
  64. package/dist/src/tools/meta/__tests__/read-tools.test.js.map +7 -0
  65. package/dist/src/tools/meta/__tests__/schemas.test.js +103 -0
  66. package/dist/src/tools/meta/__tests__/schemas.test.js.map +7 -0
  67. package/dist/src/tools/meta/account-overview.js +37 -19
  68. package/dist/src/tools/meta/account-overview.js.map +2 -2
  69. package/dist/src/tools/meta/ad-account-info.js +31 -6
  70. package/dist/src/tools/meta/ad-account-info.js.map +2 -2
  71. package/dist/src/tools/meta/ads-performance.js +35 -21
  72. package/dist/src/tools/meta/ads-performance.js.map +2 -2
  73. package/dist/src/tools/meta/campaign-performance.js +35 -18
  74. package/dist/src/tools/meta/campaign-performance.js.map +2 -2
  75. package/dist/src/tools/meta/list-accessible-ad-accounts.js +39 -10
  76. package/dist/src/tools/meta/list-accessible-ad-accounts.js.map +2 -2
  77. package/dist/src/tools/meta/list-accessible-businesses.js +37 -13
  78. package/dist/src/tools/meta/list-accessible-businesses.js.map +2 -2
  79. package/dist/src/tools/meta/placement-mix.js +37 -22
  80. package/dist/src/tools/meta/placement-mix.js.map +2 -2
  81. package/dist/src/tools/meta/profile-access.js +215 -0
  82. package/dist/src/tools/meta/profile-access.js.map +7 -0
  83. package/dist/src/tools/meta/schema-helpers.js +19 -0
  84. package/dist/src/tools/meta/schema-helpers.js.map +7 -0
  85. package/dist/src/tools/meta/time-series.js +40 -23
  86. package/dist/src/tools/meta/time-series.js.map +2 -2
  87. package/dist/src/tools/vtex/__tests__/catalog-admin-batch.test.js +233 -0
  88. package/dist/src/tools/vtex/__tests__/catalog-admin-batch.test.js.map +7 -0
  89. package/dist/src/tools/vtex/__tests__/catalog-admin-categories.test.js +649 -0
  90. package/dist/src/tools/vtex/__tests__/catalog-admin-categories.test.js.map +7 -0
  91. package/dist/src/tools/vtex/__tests__/catalog-admin-product-specifications.test.js +339 -0
  92. package/dist/src/tools/vtex/__tests__/catalog-admin-product-specifications.test.js.map +7 -0
  93. package/dist/src/tools/vtex/__tests__/catalog-admin-products-skus.test.js +235 -0
  94. package/dist/src/tools/vtex/__tests__/catalog-admin-products-skus.test.js.map +7 -0
  95. package/dist/src/tools/vtex/__tests__/catalog-navigation-reads.test.js +372 -0
  96. package/dist/src/tools/vtex/__tests__/catalog-navigation-reads.test.js.map +7 -0
  97. package/dist/src/tools/vtex/__tests__/catalog-navigation-surface.test.js +57 -0
  98. package/dist/src/tools/vtex/__tests__/catalog-navigation-surface.test.js.map +7 -0
  99. package/dist/src/tools/vtex/__tests__/write-helpers.test.js +97 -0
  100. package/dist/src/tools/vtex/__tests__/write-helpers.test.js.map +7 -0
  101. package/dist/src/tools/vtex/activate-sku.js +1 -48
  102. package/dist/src/tools/vtex/activate-sku.js.map +2 -2
  103. package/dist/src/tools/vtex/associate-specification.js +3 -54
  104. package/dist/src/tools/vtex/associate-specification.js.map +2 -2
  105. package/dist/src/tools/vtex/attach-catalog-image.js +3 -57
  106. package/dist/src/tools/vtex/attach-catalog-image.js.map +2 -2
  107. package/dist/src/tools/vtex/catalog-admin-batch.js +298 -0
  108. package/dist/src/tools/vtex/catalog-admin-batch.js.map +7 -0
  109. package/dist/src/tools/vtex/catalog-admin-categories.js +542 -0
  110. package/dist/src/tools/vtex/catalog-admin-categories.js.map +7 -0
  111. package/dist/src/tools/vtex/catalog-admin-product-specifications.js +275 -0
  112. package/dist/src/tools/vtex/catalog-admin-product-specifications.js.map +7 -0
  113. package/dist/src/tools/vtex/catalog-admin-products-skus.js +475 -0
  114. package/dist/src/tools/vtex/catalog-admin-products-skus.js.map +7 -0
  115. package/dist/src/tools/vtex/catalog-navigation-reads.js +430 -0
  116. package/dist/src/tools/vtex/catalog-navigation-reads.js.map +7 -0
  117. package/dist/src/tools/vtex/create-brand.js +1 -64
  118. package/dist/src/tools/vtex/create-brand.js.map +2 -2
  119. package/dist/src/tools/vtex/create-category.js +1 -76
  120. package/dist/src/tools/vtex/create-category.js.map +2 -2
  121. package/dist/src/tools/vtex/create-product-with-sku.js +3 -114
  122. package/dist/src/tools/vtex/create-product-with-sku.js.map +2 -2
  123. package/dist/src/tools/vtex/create-specification-value.js +3 -47
  124. package/dist/src/tools/vtex/create-specification-value.js.map +2 -2
  125. package/dist/src/tools/vtex/create-specification.js +1 -80
  126. package/dist/src/tools/vtex/create-specification.js.map +2 -2
  127. package/dist/src/tools/vtex/deactivate-sku.js +1 -48
  128. package/dist/src/tools/vtex/deactivate-sku.js.map +2 -2
  129. package/dist/src/tools/vtex/delete-all-product-specifications.js +9 -0
  130. package/dist/src/tools/vtex/delete-all-product-specifications.js.map +7 -0
  131. package/dist/src/tools/vtex/delete-all-sku-specifications.js +9 -0
  132. package/dist/src/tools/vtex/delete-all-sku-specifications.js.map +7 -0
  133. package/dist/src/tools/vtex/delete-brand.js +9 -0
  134. package/dist/src/tools/vtex/delete-brand.js.map +7 -0
  135. package/dist/src/tools/vtex/delete-catalog-image.js +9 -0
  136. package/dist/src/tools/vtex/delete-catalog-image.js.map +7 -0
  137. package/dist/src/tools/vtex/delete-product-specification.js +9 -0
  138. package/dist/src/tools/vtex/delete-product-specification.js.map +7 -0
  139. package/dist/src/tools/vtex/delete-sku-price.js +55 -0
  140. package/dist/src/tools/vtex/delete-sku-price.js.map +7 -0
  141. package/dist/src/tools/vtex/delete-sku-specification.js +9 -0
  142. package/dist/src/tools/vtex/delete-sku-specification.js.map +7 -0
  143. package/dist/src/tools/vtex/get-brand.js +6 -0
  144. package/dist/src/tools/vtex/get-brand.js.map +7 -0
  145. package/dist/src/tools/vtex/get-category-tree.js +6 -0
  146. package/dist/src/tools/vtex/get-category-tree.js.map +7 -0
  147. package/dist/src/tools/vtex/get-category.js +6 -0
  148. package/dist/src/tools/vtex/get-category.js.map +7 -0
  149. package/dist/src/tools/vtex/get-product-specifications.js +9 -0
  150. package/dist/src/tools/vtex/get-product-specifications.js.map +7 -0
  151. package/dist/src/tools/vtex/get-product.js +6 -0
  152. package/dist/src/tools/vtex/get-product.js.map +7 -0
  153. package/dist/src/tools/vtex/get-sku.js +6 -0
  154. package/dist/src/tools/vtex/get-sku.js.map +7 -0
  155. package/dist/src/tools/vtex/index.js +23 -1
  156. package/dist/src/tools/vtex/index.js.map +2 -2
  157. package/dist/src/tools/vtex/list-brands.js +6 -0
  158. package/dist/src/tools/vtex/list-brands.js.map +7 -0
  159. package/dist/src/tools/vtex/list-categories.js +6 -0
  160. package/dist/src/tools/vtex/list-categories.js.map +7 -0
  161. package/dist/src/tools/vtex/list-products-by-category.js +6 -0
  162. package/dist/src/tools/vtex/list-products-by-category.js.map +7 -0
  163. package/dist/src/tools/vtex/list-products.js +6 -0
  164. package/dist/src/tools/vtex/list-products.js.map +7 -0
  165. package/dist/src/tools/vtex/list-skus-by-product.js +6 -0
  166. package/dist/src/tools/vtex/list-skus-by-product.js.map +7 -0
  167. package/dist/src/tools/vtex/list-specification-groups.js +9 -0
  168. package/dist/src/tools/vtex/list-specification-groups.js.map +7 -0
  169. package/dist/src/tools/vtex/move-category.js +6 -0
  170. package/dist/src/tools/vtex/move-category.js.map +7 -0
  171. package/dist/src/tools/vtex/profile-resolution.js +4 -51
  172. package/dist/src/tools/vtex/profile-resolution.js.map +2 -2
  173. package/dist/src/tools/vtex/update-brand.js +6 -0
  174. package/dist/src/tools/vtex/update-brand.js.map +7 -0
  175. package/dist/src/tools/vtex/update-category.js +6 -0
  176. package/dist/src/tools/vtex/update-category.js.map +7 -0
  177. package/dist/src/tools/vtex/update-product-basic-fields.js +3 -65
  178. package/dist/src/tools/vtex/update-product-basic-fields.js.map +2 -2
  179. package/dist/src/tools/vtex/update-sku-basic-fields.js +1 -87
  180. package/dist/src/tools/vtex/update-sku-basic-fields.js.map +2 -2
  181. package/dist/src/tools/vtex/update-sku-price.js +21 -1
  182. package/dist/src/tools/vtex/update-sku-price.js.map +2 -2
  183. package/dist/src/tools/vtex/write-helpers.js +104 -14
  184. package/dist/src/tools/vtex/write-helpers.js.map +2 -2
  185. package/dist/src/utils/provider-profile-selection.js +117 -0
  186. package/dist/src/utils/provider-profile-selection.js.map +7 -0
  187. package/dist/tests/meli/mercadolibre-tool-handlers-medium-batch4.test.js +678 -0
  188. package/dist/tests/meli/mercadolibre-tool-handlers-medium-batch4.test.js.map +7 -0
  189. package/dist/tests/meli/mercadolibre-tool-handlers-monster-batch5.test.js +564 -0
  190. package/dist/tests/meli/mercadolibre-tool-handlers-monster-batch5.test.js.map +7 -0
  191. package/dist/tests/meli/mercadolibre-tool-handlers-monster-batch6.test.js +387 -0
  192. package/dist/tests/meli/mercadolibre-tool-handlers-monster-batch6.test.js.map +7 -0
  193. package/dist/tests/meli/mercadolibre-tool-handlers-monster-batch7.test.js +368 -0
  194. package/dist/tests/meli/mercadolibre-tool-handlers-monster-batch7.test.js.map +7 -0
  195. package/dist/tests/meli/mercadolibre-tool-handlers-small.test.js +626 -0
  196. package/dist/tests/meli/mercadolibre-tool-handlers-small.test.js.map +7 -0
  197. package/dist/tests/meli/mercadolibre-tool-handlers-write-batch8.test.js +480 -0
  198. package/dist/tests/meli/mercadolibre-tool-handlers-write-batch8.test.js.map +7 -0
  199. package/dist/tests/setup.js +2 -0
  200. package/dist/tests/setup.js.map +7 -0
  201. package/dist/tests/smoke/test-harness.test.js +7 -0
  202. package/dist/tests/smoke/test-harness.test.js.map +7 -0
  203. package/dist/tests/vtex/read-only-utils.test.js +161 -0
  204. package/dist/tests/vtex/read-only-utils.test.js.map +7 -0
  205. package/dist/tests/vtex/vtex-catalog-admin-docs.test.js +24 -0
  206. package/dist/tests/vtex/vtex-catalog-admin-docs.test.js.map +7 -0
  207. package/dist/tests/vtex/vtex-catalog-admin-surface.test.js +30 -0
  208. package/dist/tests/vtex/vtex-catalog-admin-surface.test.js.map +7 -0
  209. package/dist/tests/vtex/vtex-catalog-write-tools.test.js +712 -0
  210. package/dist/tests/vtex/vtex-catalog-write-tools.test.js.map +7 -0
  211. package/dist/tests/vtex/vtex-catalog.service.test.js +51 -0
  212. package/dist/tests/vtex/vtex-catalog.service.test.js.map +7 -0
  213. package/dist/tests/vtex/vtex-inventory-tools.test.js +201 -0
  214. package/dist/tests/vtex/vtex-inventory-tools.test.js.map +7 -0
  215. package/dist/tests/vtex/vtex-logistics.service.test.js +134 -0
  216. package/dist/tests/vtex/vtex-logistics.service.test.js.map +7 -0
  217. package/dist/tests/vtex/vtex-order-details.tool.test.js +141 -0
  218. package/dist/tests/vtex/vtex-order-details.tool.test.js.map +7 -0
  219. package/dist/tests/vtex/vtex-order-write-tools.test.js +483 -0
  220. package/dist/tests/vtex/vtex-order-write-tools.test.js.map +7 -0
  221. package/dist/tests/vtex/vtex-orders-summary.tool.test.js +185 -0
  222. package/dist/tests/vtex/vtex-orders-summary.tool.test.js.map +7 -0
  223. package/dist/tests/vtex/vtex-orders.service.test.js +120 -0
  224. package/dist/tests/vtex/vtex-orders.service.test.js.map +7 -0
  225. package/dist/tests/vtex/vtex-pricing-write-tools.test.js +202 -0
  226. package/dist/tests/vtex/vtex-pricing-write-tools.test.js.map +7 -0
  227. package/dist/tests/vtex/vtex-pricing-write.service.test.js +106 -0
  228. package/dist/tests/vtex/vtex-pricing-write.service.test.js.map +7 -0
  229. package/dist/tests/vtex/vtex-pricing.service.test.js +88 -0
  230. package/dist/tests/vtex/vtex-pricing.service.test.js.map +7 -0
  231. package/dist/tests/vtex/vtex-small-tools.test.js +190 -0
  232. package/dist/tests/vtex/vtex-small-tools.test.js.map +7 -0
  233. package/dist/tests/vtex/vtex-write-simple-tools.test.js +647 -0
  234. package/dist/tests/vtex/vtex-write-simple-tools.test.js.map +7 -0
  235. package/dist/vitest.config.js +15 -0
  236. package/dist/vitest.config.js.map +7 -0
  237. package/package.json +6 -2
package/README.md CHANGED
@@ -15,7 +15,7 @@ Hoy el MCP cubre estas areas:
15
15
  - **Meta Ads:** discovery de cuentas publicitarias, performance de campanas y ads, series temporales y placements.
16
16
  - **Config / Benchmarks Argentina:** referencias locales para IIBB, cuotas, pasarelas, logistica y calendario comercial.
17
17
 
18
- La documentacion completa de capacidades esta en [docs/CAPACIDADES_MCP.md](/home/yoryo/apps/bi-mcp/docs/CAPACIDADES_MCP.md).
18
+ La documentacion completa de capacidades esta en [/home/yoryo/apps/bi-mcp-dashboard/docs/content/CAPACIDADES_MCP.md](/home/yoryo/apps/bi-mcp-dashboard/docs/content/CAPACIDADES_MCP.md).
19
19
 
20
20
  ## Como se usa
21
21
 
@@ -49,7 +49,6 @@ Despues de publicar o instalar el paquete, una configuracion tipica por `npx` us
49
49
  "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "your_google_ads_login_customer_id",
50
50
  "META_APP_ID": "your_meta_app_id",
51
51
  "META_APP_SECRET": "your_meta_app_secret",
52
- "META_ACCESS_TOKEN": "your_meta_access_token",
53
52
  "META_API_VERSION": "v25.0",
54
53
  "DATABASE_URL": "your_postgres_connection_string",
55
54
  "DB_ENCRYPTION_KEY": "your_64_hex_char_encryption_key"
@@ -59,7 +58,7 @@ Despues de publicar o instalar el paquete, una configuracion tipica por `npx` us
59
58
  }
60
59
  ```
61
60
 
62
- Si no vas a usar una integracion, sus credenciales pueden no ser necesarias para ese flujo. VTEX usa perfiles y conexiones persistidas en Postgres; sus credenciales por cliente no se configuran directo en `.env`.
61
+ Si no vas a usar una integracion, sus credenciales pueden no ser necesarias para ese flujo. VTEX usa perfiles y conexiones persistidas en Postgres; sus credenciales por cliente no se configuran directo en `.env`. Meta Ads ahora tambien resuelve el access token desde Postgres y deja en `.env` solo `META_APP_ID`, `META_APP_SECRET` y `META_API_VERSION`.
63
62
 
64
63
  ## Variables principales
65
64
 
@@ -70,13 +69,13 @@ El servidor lee infraestructura y secretos desde variables de entorno:
70
69
  - `GOOGLE_OAUTH_CLIENT_ID`, `GOOGLE_OAUTH_CLIENT_SECRET`
71
70
  - `GA4_PROPERTY_ID`
72
71
  - `GOOGLE_ADS_DEVELOPER_TOKEN`, `GOOGLE_ADS_LOGIN_CUSTOMER_ID`
73
- - `META_APP_ID`, `META_APP_SECRET`, `META_ACCESS_TOKEN`, `META_API_VERSION`
72
+ - `META_APP_ID`, `META_APP_SECRET`, `META_API_VERSION`
74
73
 
75
74
  La configuracion de negocio no deberia vivir en `.env`.
76
75
 
77
76
  ## Documentacion util
78
77
 
79
- - [Capacidades del MCP](/home/yoryo/apps/bi-mcp/docs/CAPACIDADES_MCP.md): que puede responder cada modulo.
78
+ - [Capacidades del MCP](/home/yoryo/apps/bi-mcp-dashboard/docs/content/CAPACIDADES_MCP.md): que puede responder cada modulo.
80
79
  - [Fuentes de datos](/home/yoryo/apps/bi-mcp/docs/FUENTES_DE_DATOS.md): de donde salen los datos y que limitaciones tienen.
81
80
  - [Glosario financiero](/home/yoryo/apps/bi-mcp/docs/GLOSARIO_FINANCIERO.md): terminos de negocio y finanzas usados por el sistema.
82
81
  - [Estado del proyecto](/home/yoryo/apps/bi-mcp/docs/PROJECT_STATUS.md): modulos implementados, pendientes y roadmap.