@yoryoboy/bi-mcp 1.16.0 → 1.19.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.
- package/README.md +12 -0
- package/dist/.tsbuildinfo +1 -1
- package/dist/index.js +179 -6
- package/dist/index.js.map +2 -2
- package/dist/mcp-use.json +3 -6
- package/dist/src/config/__tests__/google-store.test.js +30 -0
- package/dist/src/config/__tests__/google-store.test.js.map +7 -0
- package/dist/src/config/__tests__/mcp-tool-deadline.test.js +64 -0
- package/dist/src/config/__tests__/mcp-tool-deadline.test.js.map +7 -0
- package/dist/src/config/google-store.js +18 -0
- package/dist/src/config/google-store.js.map +2 -2
- package/dist/src/config/mcp-tool-deadline-context.js +34 -0
- package/dist/src/config/mcp-tool-deadline-context.js.map +7 -0
- package/dist/src/config/mcp-tool-deadline.js +67 -0
- package/dist/src/config/mcp-tool-deadline.js.map +7 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-api.test.js +38 -3
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-api.test.js.map +2 -2
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-buyer-reconciliation.test.js +226 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-buyer-reconciliation.test.js.map +7 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-claim-reconciliation.test.js +127 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-claim-reconciliation.test.js.map +7 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-kits.test.js +103 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-kits.test.js.map +7 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-order-billing-info.test.js +582 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-order-billing-info.test.js.map +7 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-orders.test.js +10 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-orders.test.js.map +2 -2
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-packs.test.js +36 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-packs.test.js.map +7 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-payments.test.js +137 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-payments.test.js.map +7 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-product-ads-ad-group-ads.test.js +105 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-product-ads-ad-group-ads.test.js.map +7 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-product-ads-ad-groups.test.js +143 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-product-ads-ad-groups.test.js.map +7 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-product-ads-campaigns.test.js +100 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-product-ads-campaigns.test.js.map +7 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-product-ads.test.js +350 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-product-ads.test.js.map +7 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-return-reconciliation.test.js +228 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-return-reconciliation.test.js.map +7 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-shipping.test.js +58 -0
- package/dist/src/services/mercadolibre/__tests__/mercadolibre-shipping.test.js.map +7 -0
- package/dist/src/services/mercadolibre/mercadolibre-api.js +15 -3
- package/dist/src/services/mercadolibre/mercadolibre-api.js.map +2 -2
- package/dist/src/services/mercadolibre/mercadolibre-billing.js +110 -3
- package/dist/src/services/mercadolibre/mercadolibre-billing.js.map +2 -2
- package/dist/src/services/mercadolibre/mercadolibre-buyer-reconciliation.js +368 -0
- package/dist/src/services/mercadolibre/mercadolibre-buyer-reconciliation.js.map +7 -0
- package/dist/src/services/mercadolibre/mercadolibre-claim-reconciliation.js +399 -0
- package/dist/src/services/mercadolibre/mercadolibre-claim-reconciliation.js.map +7 -0
- package/dist/src/services/mercadolibre/mercadolibre-kits.js +55 -0
- package/dist/src/services/mercadolibre/mercadolibre-kits.js.map +7 -0
- package/dist/src/services/mercadolibre/mercadolibre-order-billing-info.js +392 -0
- package/dist/src/services/mercadolibre/mercadolibre-order-billing-info.js.map +7 -0
- package/dist/src/services/mercadolibre/mercadolibre-orders.js +8 -8
- package/dist/src/services/mercadolibre/mercadolibre-orders.js.map +2 -2
- package/dist/src/services/mercadolibre/mercadolibre-packs.js +21 -0
- package/dist/src/services/mercadolibre/mercadolibre-packs.js.map +7 -0
- package/dist/src/services/mercadolibre/mercadolibre-payments.js +60 -0
- package/dist/src/services/mercadolibre/mercadolibre-payments.js.map +7 -0
- package/dist/src/services/mercadolibre/mercadolibre-product-ads.js +429 -0
- package/dist/src/services/mercadolibre/mercadolibre-product-ads.js.map +7 -0
- package/dist/src/services/mercadolibre/mercadolibre-return-reconciliation.js +436 -0
- package/dist/src/services/mercadolibre/mercadolibre-return-reconciliation.js.map +7 -0
- package/dist/src/services/mercadolibre/mercadolibre-shipping.js +35 -0
- package/dist/src/services/mercadolibre/mercadolibre-shipping.js.map +7 -0
- package/dist/src/services/vtex/__tests__/vtex-api.test.js +67 -0
- package/dist/src/services/vtex/__tests__/vtex-api.test.js.map +7 -0
- package/dist/src/services/vtex/vtex-api.js +6 -0
- package/dist/src/services/vtex/vtex-api.js.map +2 -2
- package/dist/src/tools/config/__tests__/list-profiles.test.js +154 -0
- package/dist/src/tools/config/__tests__/list-profiles.test.js.map +7 -0
- package/dist/src/tools/config/list-profiles.js +39 -3
- package/dist/src/tools/config/list-profiles.js.map +2 -2
- package/dist/src/tools/mercadolibre/__tests__/get-order-billing-info.test.js +339 -0
- package/dist/src/tools/mercadolibre/__tests__/get-order-billing-info.test.js.map +7 -0
- package/dist/src/tools/mercadolibre/__tests__/product-ads-ad-group-ads.test.js +225 -0
- package/dist/src/tools/mercadolibre/__tests__/product-ads-ad-group-ads.test.js.map +7 -0
- package/dist/src/tools/mercadolibre/__tests__/product-ads-ad-groups.test.js +148 -0
- package/dist/src/tools/mercadolibre/__tests__/product-ads-ad-groups.test.js.map +7 -0
- package/dist/src/tools/mercadolibre/__tests__/product-ads-campaigns.test.js +60 -0
- package/dist/src/tools/mercadolibre/__tests__/product-ads-campaigns.test.js.map +7 -0
- package/dist/src/tools/mercadolibre/__tests__/product-ads-helpers.test.js +128 -0
- package/dist/src/tools/mercadolibre/__tests__/product-ads-helpers.test.js.map +7 -0
- package/dist/src/tools/mercadolibre/__tests__/product-ads-tools.test.js +435 -0
- package/dist/src/tools/mercadolibre/__tests__/product-ads-tools.test.js.map +7 -0
- package/dist/src/tools/mercadolibre/__tests__/reconcile-buyer-data.test.js +31 -0
- package/dist/src/tools/mercadolibre/__tests__/reconcile-buyer-data.test.js.map +7 -0
- package/dist/src/tools/mercadolibre/__tests__/reconcile-claim-data.test.js +36 -0
- package/dist/src/tools/mercadolibre/__tests__/reconcile-claim-data.test.js.map +7 -0
- package/dist/src/tools/mercadolibre/__tests__/validate-connection.test.js +205 -0
- package/dist/src/tools/mercadolibre/__tests__/validate-connection.test.js.map +7 -0
- package/dist/src/tools/mercadolibre/get-billing-provisions-by-order.js +313 -0
- package/dist/src/tools/mercadolibre/get-billing-provisions-by-order.js.map +7 -0
- package/dist/src/tools/mercadolibre/get-bundle-context-by-item.js +176 -0
- package/dist/src/tools/mercadolibre/get-bundle-context-by-item.js.map +7 -0
- package/dist/src/tools/mercadolibre/get-full-storage-charges.js +183 -0
- package/dist/src/tools/mercadolibre/get-full-storage-charges.js.map +7 -0
- package/dist/src/tools/mercadolibre/get-order-billing-info.js +189 -0
- package/dist/src/tools/mercadolibre/get-order-billing-info.js.map +7 -0
- package/dist/src/tools/mercadolibre/get-pack-context-by-order.js +150 -0
- package/dist/src/tools/mercadolibre/get-pack-context-by-order.js.map +7 -0
- package/dist/src/tools/mercadolibre/get-payment-details.js +322 -0
- package/dist/src/tools/mercadolibre/get-payment-details.js.map +7 -0
- package/dist/src/tools/mercadolibre/get-product-ads-ad-group-ads.js +144 -0
- package/dist/src/tools/mercadolibre/get-product-ads-ad-group-ads.js.map +7 -0
- package/dist/src/tools/mercadolibre/get-product-ads-advertisers.js +59 -0
- package/dist/src/tools/mercadolibre/get-product-ads-advertisers.js.map +7 -0
- package/dist/src/tools/mercadolibre/get-shipping-quote-by-declared-dimensions.js +104 -0
- package/dist/src/tools/mercadolibre/get-shipping-quote-by-declared-dimensions.js.map +7 -0
- package/dist/src/tools/mercadolibre/index.js +32 -0
- package/dist/src/tools/mercadolibre/index.js.map +2 -2
- package/dist/src/tools/mercadolibre/product-ads-helpers.js +130 -0
- package/dist/src/tools/mercadolibre/product-ads-helpers.js.map +7 -0
- package/dist/src/tools/mercadolibre/reconcile-buyer-data.js +27 -0
- package/dist/src/tools/mercadolibre/reconcile-buyer-data.js.map +7 -0
- package/dist/src/tools/mercadolibre/reconcile-claim-data.js +46 -0
- package/dist/src/tools/mercadolibre/reconcile-claim-data.js.map +7 -0
- package/dist/src/tools/mercadolibre/reconcile-return-data.js +25 -0
- package/dist/src/tools/mercadolibre/reconcile-return-data.js.map +7 -0
- package/dist/src/tools/mercadolibre/search-product-ads-ad-groups.js +162 -0
- package/dist/src/tools/mercadolibre/search-product-ads-ad-groups.js.map +7 -0
- package/dist/src/tools/mercadolibre/search-product-ads-ads.js +216 -0
- package/dist/src/tools/mercadolibre/search-product-ads-ads.js.map +7 -0
- package/dist/src/tools/mercadolibre/search-product-ads-campaigns.js +116 -0
- package/dist/src/tools/mercadolibre/search-product-ads-campaigns.js.map +7 -0
- package/dist/src/tools/mercadolibre/validate-connection.js +40 -12
- package/dist/src/tools/mercadolibre/validate-connection.js.map +2 -2
- package/dist/tests/meli/mercadolibre-billing-provisions.test.js +378 -0
- package/dist/tests/meli/mercadolibre-billing-provisions.test.js.map +2 -2
- package/dist/tests/meli/mercadolibre-order-billing-info-surface.test.js +123 -0
- package/dist/tests/meli/mercadolibre-order-billing-info-surface.test.js.map +7 -0
- package/dist/tests/meli/mercadolibre-payment-details.test.js +356 -0
- package/dist/tests/meli/mercadolibre-payment-details.test.js.map +7 -0
- package/dist/tests/meli/mercadolibre-payments.test.js +62 -0
- package/dist/tests/meli/mercadolibre-payments.test.js.map +7 -0
- package/dist/tests/meli/mercadolibre-product-ads-ad-groups-surface.test.js +90 -0
- package/dist/tests/meli/mercadolibre-product-ads-ad-groups-surface.test.js.map +7 -0
- package/dist/tests/meli/mercadolibre-product-ads-campaigns-surface.test.js +72 -0
- package/dist/tests/meli/mercadolibre-product-ads-campaigns-surface.test.js.map +7 -0
- package/dist/tests/meli/mercadolibre-tool-handlers-pack-kit-shipping.test.js +400 -0
- package/dist/tests/meli/mercadolibre-tool-handlers-pack-kit-shipping.test.js.map +7 -0
- package/dist/tests/meli/mercadolibre-tool-handlers-small.test.js +31 -12
- package/dist/tests/meli/mercadolibre-tool-handlers-small.test.js.map +2 -2
- package/dist/tests/vtex/vtex-commercial-conditions-docs.test.js +1 -1
- package/dist/tests/vtex/vtex-commercial-conditions-docs.test.js.map +1 -1
- package/package.json +1 -1
- package/dist/src/google-ads/report-utils.js +0 -78
- package/dist/src/google-ads/report-utils.js.map +0 -7
- package/dist/src/search-console/search-console-utils.js +0 -275
- package/dist/src/search-console/search-console-utils.js.map +0 -7
- package/dist/src/services/vtex/__tests__/vtex-catalog-write-batch.test.js +0 -165
- package/dist/src/services/vtex/__tests__/vtex-catalog-write-batch.test.js.map +0 -7
- package/dist/src/tools/vtex/__tests__/catalog-admin-batch.test.js +0 -233
- package/dist/src/tools/vtex/__tests__/catalog-admin-batch.test.js.map +0 -7
- package/dist/src/tools/vtex/catalog-admin-batch.js +0 -298
- package/dist/src/tools/vtex/catalog-admin-batch.js.map +0 -7
|
@@ -1,9 +1,24 @@
|
|
|
1
1
|
import { getMercadoLibreApiContext, formatMercadoLibreError } from "./mercadolibre-api.js";
|
|
2
|
+
import { asArray, asRecord, normalizeScalarString } from "../../tools/mercadolibre/helpers.js";
|
|
3
|
+
const MERCADO_LIBRE_BILLING_ORDER_DETAILS_PATH = "/billing/integration/group/ML/order/details";
|
|
4
|
+
const MERCADO_LIBRE_BILLING_ORDER_IDS_MAX_PER_REQUEST = 60;
|
|
2
5
|
function scopeToGroupPath(scope) {
|
|
3
6
|
if (scope === "flex") return "ML/flex";
|
|
4
7
|
if (scope === "full") return "ML/full";
|
|
5
8
|
return scope.toUpperCase();
|
|
6
9
|
}
|
|
10
|
+
function buildMercadoLibreBillingPeriodDetailsPath(periodKey, scope) {
|
|
11
|
+
return `/billing/integration/periods/key/${periodKey}/group/${scopeToGroupPath(scope)}/details`;
|
|
12
|
+
}
|
|
13
|
+
function buildMercadoLibreBillingOrderDetailsPath() {
|
|
14
|
+
return MERCADO_LIBRE_BILLING_ORDER_DETAILS_PATH;
|
|
15
|
+
}
|
|
16
|
+
function clampMercadoLibreBillingOrderIdsBatchSize(batchSize) {
|
|
17
|
+
return Math.min(
|
|
18
|
+
MERCADO_LIBRE_BILLING_ORDER_IDS_MAX_PER_REQUEST,
|
|
19
|
+
Math.max(1, Math.floor(batchSize))
|
|
20
|
+
);
|
|
21
|
+
}
|
|
7
22
|
async function getMercadoLibreBillingProvisionPage(profileId, params) {
|
|
8
23
|
const { api } = await getMercadoLibreApiContext(profileId);
|
|
9
24
|
const queryParams = {
|
|
@@ -17,14 +32,14 @@ async function getMercadoLibreBillingProvisionPage(profileId, params) {
|
|
|
17
32
|
if (params.marketplaceType) queryParams.marketplace_type = params.marketplaceType;
|
|
18
33
|
if (params.orderIds?.length) queryParams.order_ids = params.orderIds.join(",");
|
|
19
34
|
if (params.itemIds?.length) queryParams.item_ids = params.itemIds.join(",");
|
|
20
|
-
const groupPath = scopeToGroupPath(params.scope);
|
|
21
35
|
const response = await api.get(
|
|
22
|
-
|
|
36
|
+
buildMercadoLibreBillingPeriodDetailsPath(params.periodKey, params.scope),
|
|
23
37
|
{ params: queryParams }
|
|
24
38
|
);
|
|
25
39
|
const data = response.data;
|
|
26
40
|
const results = Array.isArray(data.results) ? data.results : [];
|
|
27
|
-
const
|
|
41
|
+
const rawLastId = data.last_id;
|
|
42
|
+
const lastId = rawLastId != null && rawLastId !== 0 && rawLastId !== "0" ? String(rawLastId) : null;
|
|
28
43
|
const pageTotal = Number(data.total ?? 0);
|
|
29
44
|
const pageLimit = Number(data.limit ?? params.limit);
|
|
30
45
|
return {
|
|
@@ -165,11 +180,103 @@ async function getMercadoLibreBillingDetails(profileId, params) {
|
|
|
165
180
|
failures
|
|
166
181
|
};
|
|
167
182
|
}
|
|
183
|
+
const BY_ORDER_CHUNK_SIZE = MERCADO_LIBRE_BILLING_ORDER_IDS_MAX_PER_REQUEST;
|
|
184
|
+
const BY_ORDER_CONCURRENCY = 5;
|
|
185
|
+
function extractOrderIdFromBillingOrder(row) {
|
|
186
|
+
const topLevelOrderId = normalizeScalarString(row.order_id);
|
|
187
|
+
if (topLevelOrderId) return topLevelOrderId;
|
|
188
|
+
const paymentInfo = asRecord(row.payment_info);
|
|
189
|
+
const paymentOrderId = normalizeScalarString(paymentInfo.order_id);
|
|
190
|
+
if (paymentOrderId) return paymentOrderId;
|
|
191
|
+
const details = asArray(row.details);
|
|
192
|
+
for (const detail of details) {
|
|
193
|
+
const detailOrderId = normalizeScalarString(detail.order_id);
|
|
194
|
+
if (detailOrderId) return detailOrderId;
|
|
195
|
+
const detailSales = asArray(detail.sales_info ?? detail.details_sales);
|
|
196
|
+
for (const sale of detailSales) {
|
|
197
|
+
const saleOrderId = normalizeScalarString(sale.order_id);
|
|
198
|
+
if (saleOrderId) return saleOrderId;
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
return null;
|
|
202
|
+
}
|
|
203
|
+
async function getMercadoLibreBillingByOrderChunk(profileId, orderIds) {
|
|
204
|
+
const { api } = await getMercadoLibreApiContext(profileId);
|
|
205
|
+
const response = await api.get(buildMercadoLibreBillingOrderDetailsPath(), {
|
|
206
|
+
params: {
|
|
207
|
+
order_ids: orderIds.join(",")
|
|
208
|
+
}
|
|
209
|
+
});
|
|
210
|
+
const data = response.data;
|
|
211
|
+
const results = Array.isArray(data.results) ? data.results : Array.isArray(data) ? data : [];
|
|
212
|
+
return {
|
|
213
|
+
results,
|
|
214
|
+
order_ids_requested: orderIds
|
|
215
|
+
};
|
|
216
|
+
}
|
|
217
|
+
async function getMercadoLibreBillingProvisionsByOrder(profileId, params) {
|
|
218
|
+
const uniqueIds = Array.from(new Set(params.orderIds));
|
|
219
|
+
const chunks = [];
|
|
220
|
+
for (let i = 0; i < uniqueIds.length; i += BY_ORDER_CHUNK_SIZE) {
|
|
221
|
+
chunks.push(uniqueIds.slice(i, i + BY_ORDER_CHUNK_SIZE));
|
|
222
|
+
}
|
|
223
|
+
const allResults = [];
|
|
224
|
+
const failures = [];
|
|
225
|
+
let chunksSucceeded = 0;
|
|
226
|
+
let chunksFailed = 0;
|
|
227
|
+
for (let chunkIdx = 0; chunkIdx < chunks.length; chunkIdx += BY_ORDER_CONCURRENCY) {
|
|
228
|
+
const batch = chunks.slice(chunkIdx, chunkIdx + BY_ORDER_CONCURRENCY);
|
|
229
|
+
const settled = await Promise.allSettled(
|
|
230
|
+
batch.map((chunk) => getMercadoLibreBillingByOrderChunk(profileId, chunk))
|
|
231
|
+
);
|
|
232
|
+
for (let i = 0; i < settled.length; i++) {
|
|
233
|
+
const result = settled[i];
|
|
234
|
+
if (result.status === "fulfilled") {
|
|
235
|
+
chunksSucceeded += 1;
|
|
236
|
+
allResults.push(...result.value.results);
|
|
237
|
+
continue;
|
|
238
|
+
}
|
|
239
|
+
chunksFailed += 1;
|
|
240
|
+
const chunkOrderIds = batch[i];
|
|
241
|
+
failures.push({
|
|
242
|
+
chunk_index: chunkIdx + i,
|
|
243
|
+
order_ids: chunkOrderIds,
|
|
244
|
+
message: formatMercadoLibreError(
|
|
245
|
+
result.reason,
|
|
246
|
+
"Failed to fetch billing provisions by order chunk"
|
|
247
|
+
)
|
|
248
|
+
});
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
const foundOrderIds = /* @__PURE__ */ new Set();
|
|
252
|
+
for (const row of allResults) {
|
|
253
|
+
const orderId = extractOrderIdFromBillingOrder(row);
|
|
254
|
+
if (orderId) foundOrderIds.add(orderId);
|
|
255
|
+
}
|
|
256
|
+
const notFoundOrderIds = uniqueIds.filter((id) => !foundOrderIds.has(id));
|
|
257
|
+
return {
|
|
258
|
+
results: allResults,
|
|
259
|
+
order_ids_requested: uniqueIds,
|
|
260
|
+
order_ids_found: [...foundOrderIds],
|
|
261
|
+
order_ids_not_found: notFoundOrderIds,
|
|
262
|
+
chunks_total: chunks.length,
|
|
263
|
+
chunks_succeeded: chunksSucceeded,
|
|
264
|
+
chunks_failed: chunksFailed,
|
|
265
|
+
coverage_complete: chunksFailed === 0,
|
|
266
|
+
failures
|
|
267
|
+
};
|
|
268
|
+
}
|
|
168
269
|
export {
|
|
270
|
+
MERCADO_LIBRE_BILLING_ORDER_DETAILS_PATH,
|
|
271
|
+
MERCADO_LIBRE_BILLING_ORDER_IDS_MAX_PER_REQUEST,
|
|
272
|
+
buildMercadoLibreBillingOrderDetailsPath,
|
|
273
|
+
buildMercadoLibreBillingPeriodDetailsPath,
|
|
274
|
+
clampMercadoLibreBillingOrderIdsBatchSize,
|
|
169
275
|
getMercadoLibreBillingDetails,
|
|
170
276
|
getMercadoLibreBillingDetailsPage,
|
|
171
277
|
getMercadoLibreBillingProvisionPage,
|
|
172
278
|
getMercadoLibreBillingProvisions,
|
|
279
|
+
getMercadoLibreBillingProvisionsByOrder,
|
|
173
280
|
scopeToGroupPath
|
|
174
281
|
};
|
|
175
282
|
//# sourceMappingURL=mercadolibre-billing.js.map
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../../../src/services/mercadolibre/mercadolibre-billing.ts"],
|
|
4
|
-
"sourcesContent": ["import { getMercadoLibreApiContext, formatMercadoLibreError } from \"./mercadolibre-api.js\";\n\nexport interface MercadoLibreBillingDetailsParams {\n periodKey: string;\n documentType?: \"BILL\" | \"CREDIT_NOTE\";\n group?: \"ML\" | \"MP\" | \"flex\";\n limit?: number;\n offset?: number;\n}\n\nexport interface MercadoLibreBillingPage {\n offset: number;\n limit: number;\n total: number;\n results: Record<string, unknown>[];\n}\n\nexport interface MercadoLibreBillingFetchResult {\n period_key: string;\n group: string;\n document_type: string;\n pages_requested: number;\n pages_succeeded: number;\n pages_failed: number;\n total_reported: number;\n rows: Record<string, unknown>[];\n failures: Array<{\n offset: number;\n limit: number;\n message: string;\n }>;\n}\n\n// \u2500\u2500 Provisions (from_id cursor) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport type BillingProvisionScope = \"ml\" | \"mp\" | \"flex\" | \"full\";\n\nexport interface BillingProvisionPage {\n results: Record<string, unknown>[];\n last_id: string | null;\n total: number;\n limit: number;\n}\n\nexport interface BillingProvisionFetchResult {\n scope: BillingProvisionScope;\n period_key: string;\n document_type: string;\n pages_requested: number;\n pages_succeeded: number;\n pages_failed: number;\n detail_count_total: number;\n last_id_seen: string | null;\n coverage_complete: boolean;\n rows: Record<string, unknown>[];\n failures: Array<{ page: number; from_id: string | null; message: string }>;\n}\n\n/**\n * Resolves the URL path segment for a given scope.\n * ml \u2192 group/ML/details\n * mp \u2192 group/MP/details\n * flex \u2192 group/ML/flex/details\n * full \u2192 group/ML/full/details\n */\nexport function scopeToGroupPath(scope: BillingProvisionScope): string {\n if (scope === \"flex\") return \"ML/flex\";\n if (scope === \"full\") return \"ML/full\";\n return scope.toUpperCase(); // \"ml\" \u2192 \"ML\", \"mp\" \u2192 \"MP\"\n}\n\n/**\n * Fetch one page of billing provisions using from_id cursor.\n */\nexport async function getMercadoLibreBillingProvisionPage(\n profileId: string,\n params: {\n periodKey: string;\n scope: BillingProvisionScope;\n documentType: \"BILL\" | \"CREDIT_NOTE\";\n limit: number;\n fromId?: string | null;\n detailType?: string;\n detailSubTypes?: string[];\n excludeDetailSubTypes?: string[];\n marketplaceType?: string;\n orderIds?: string[];\n itemIds?: string[];\n }\n): Promise<BillingProvisionPage> {\n const { api } = await getMercadoLibreApiContext(profileId);\n\n const queryParams: Record<string, unknown> = {\n document_type: params.documentType,\n limit: params.limit,\n };\n if (params.fromId) queryParams.from_id = params.fromId;\n if (params.detailType) queryParams.detail_type = params.detailType;\n if (params.detailSubTypes?.length) queryParams.detail_sub_types = params.detailSubTypes.join(\",\");\n if (params.excludeDetailSubTypes?.length) queryParams.exclude_detail_sub_types = params.excludeDetailSubTypes.join(\",\");\n if (params.marketplaceType) queryParams.marketplace_type = params.marketplaceType;\n if (params.orderIds?.length) queryParams.order_ids = params.orderIds.join(\",\");\n if (params.itemIds?.length) queryParams.item_ids = params.itemIds.join(\",\");\n\n const groupPath = scopeToGroupPath(params.scope);\n const response = await api.get<Record<string, unknown>>(\n `/billing/integration/periods/key/${params.periodKey}/group/${groupPath}/details`,\n { params: queryParams }\n );\n\n const data = response.data;\n const results = Array.isArray(data.results) ? (data.results as Record<string, unknown>[]) : [];\n const lastId = typeof data.last_id === \"string\" && data.last_id ? data.last_id : null;\n const pageTotal = Number(data.total ?? 0);\n const pageLimit = Number(data.limit ?? params.limit);\n\n return {\n results,\n last_id: lastId,\n total: isFinite(pageTotal) ? Math.max(0, pageTotal) : 0,\n limit: isFinite(pageLimit) ? Math.max(0, pageLimit) : params.limit,\n };\n}\n\nconst PROVISIONS_PAGE_LIMIT = 1000;\nconst PROVISIONS_MAX_PAGES = 200;\n\n/**\n * Fetch all billing provisions for one scope by walking from_id cursor.\n * Deduplicates by detail_id. Stops if last_id doesn't advance.\n * Returns partial coverage when pages fail.\n */\nexport async function getMercadoLibreBillingProvisions(\n profileId: string,\n params: {\n periodKey: string;\n scope: BillingProvisionScope;\n documentType: \"BILL\" | \"CREDIT_NOTE\";\n detailType?: string;\n detailSubTypes?: string[];\n excludeDetailSubTypes?: string[];\n marketplaceType?: string;\n orderIds?: string[];\n itemIds?: string[];\n /** Resume cursor: start fetching from this from_id instead of the first page. */\n fromId?: string | null;\n }\n): Promise<BillingProvisionFetchResult> {\n const seen = new Set<string>();\n const rows: Record<string, unknown>[] = [];\n const failures: BillingProvisionFetchResult[\"failures\"] = [];\n let lastId: string | null = params.fromId ?? null;\n let pagesRequested = 0;\n let pagesSucceeded = 0;\n let lastIdSeen: string | null = null;\n\n for (let page = 0; page < PROVISIONS_MAX_PAGES; page++) {\n pagesRequested += 1;\n let pageResult: BillingProvisionPage;\n\n try {\n pageResult = await getMercadoLibreBillingProvisionPage(profileId, {\n ...params,\n documentType: params.documentType,\n limit: PROVISIONS_PAGE_LIMIT,\n fromId: lastId,\n });\n pagesSucceeded += 1;\n } catch (error) {\n failures.push({\n page: page + 1,\n from_id: lastId,\n message: formatMercadoLibreError(error, \"Failed to fetch billing provisions page\"),\n });\n break;\n }\n\n const newRows: Record<string, unknown>[] = [];\n for (const row of pageResult.results) {\n // Real MELI payload nests detail fields under charge_info\n const chargeInfo = (row.charge_info as Record<string, unknown>) ?? row;\n const detailId = typeof chargeInfo.detail_id === \"string\"\n ? chargeInfo.detail_id\n : String(chargeInfo.detail_id ?? \"\");\n if (!detailId || seen.has(detailId)) continue;\n seen.add(detailId);\n newRows.push(row);\n }\n rows.push(...newRows);\n lastIdSeen = pageResult.last_id;\n\n // Stop conditions\n if (!pageResult.last_id) break;\n if (pageResult.last_id === lastId) break; // cursor not advancing\n if (pageResult.results.length === 0) break;\n\n lastId = pageResult.last_id;\n }\n\n const pagesFailed = pagesRequested - pagesSucceeded;\n const coverageComplete = pagesFailed === 0 && lastIdSeen === null;\n\n return {\n scope: params.scope,\n period_key: params.periodKey,\n document_type: params.documentType,\n pages_requested: pagesRequested,\n pages_succeeded: pagesSucceeded,\n pages_failed: pagesFailed,\n detail_count_total: rows.length,\n last_id_seen: lastIdSeen,\n coverage_complete: coverageComplete,\n rows,\n failures,\n };\n}\n\n// \u2500\u2500 Existing offset-based billing (preserved for backward compat) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport async function getMercadoLibreBillingDetailsPage(\n profileId: string,\n params: MercadoLibreBillingDetailsParams\n): Promise<MercadoLibreBillingPage> {\n const { api } = await getMercadoLibreApiContext(profileId);\n const documentType = params.documentType ?? \"BILL\";\n const group = params.group ?? \"ML\";\n const limit = Math.min(150, Math.max(1, Math.floor(params.limit ?? 150)));\n const offset = Math.max(0, Math.floor(params.offset ?? 0));\n\n const response = await api.get<Record<string, unknown>>(\n `/billing/integration/periods/key/${params.periodKey}/group/${group}/details`,\n {\n params: {\n document_type: documentType,\n limit,\n offset,\n },\n }\n );\n\n return {\n offset: Number(response.data.offset ?? offset),\n limit: Number(response.data.limit ?? limit),\n total: Number(response.data.total ?? 0),\n results: Array.isArray(response.data.results)\n ? (response.data.results as Record<string, unknown>[])\n : [],\n };\n}\n\nexport async function getMercadoLibreBillingDetails(\n profileId: string,\n params: Omit<MercadoLibreBillingDetailsParams, \"offset\"> & { maxPages?: number }\n): Promise<MercadoLibreBillingFetchResult> {\n const limit = Math.min(150, Math.max(1, Math.floor(params.limit ?? 150)));\n const maxPages = Math.max(1, Math.floor(params.maxPages ?? 20));\n const documentType = params.documentType ?? \"BILL\";\n const group = params.group ?? \"ML\";\n const rows: Record<string, unknown>[] = [];\n const failures: MercadoLibreBillingFetchResult[\"failures\"] = [];\n\n let totalReported = 0;\n let pagesRequested = 0;\n let pagesSucceeded = 0;\n\n for (let pageIndex = 0; pageIndex < maxPages; pageIndex += 1) {\n const offset = pageIndex * limit;\n pagesRequested += 1;\n\n try {\n const page = await getMercadoLibreBillingDetailsPage(profileId, {\n ...params,\n group,\n documentType,\n limit,\n offset,\n });\n pagesSucceeded += 1;\n totalReported = Math.max(totalReported, page.total);\n rows.push(...page.results);\n\n if (offset + page.results.length >= page.total || page.results.length === 0) {\n break;\n }\n } catch (error) {\n failures.push({\n offset,\n limit,\n message: formatMercadoLibreError(error, \"Failed to fetch MercadoLibre billing details\"),\n });\n break;\n }\n }\n\n return {\n period_key: params.periodKey,\n group,\n document_type: documentType,\n pages_requested: pagesRequested,\n pages_succeeded: pagesSucceeded,\n pages_failed: failures.length,\n total_reported: totalReported,\n rows,\n failures,\n };\n}\n"],
|
|
5
|
-
"mappings": "AAAA,SAAS,2BAA2B,+BAA+B;
|
|
4
|
+
"sourcesContent": ["import { getMercadoLibreApiContext, formatMercadoLibreError } from \"./mercadolibre-api.js\";\nimport { asArray, asRecord, normalizeScalarString, normalizeString } from \"../../tools/mercadolibre/helpers.js\";\n\nexport interface MercadoLibreBillingDetailsParams {\n periodKey: string;\n documentType?: \"BILL\" | \"CREDIT_NOTE\";\n group?: \"ML\" | \"MP\" | \"flex\";\n limit?: number;\n offset?: number;\n}\n\nexport interface MercadoLibreBillingPage {\n offset: number;\n limit: number;\n total: number;\n results: Record<string, unknown>[];\n}\n\nexport interface MercadoLibreBillingFetchResult {\n period_key: string;\n group: string;\n document_type: string;\n pages_requested: number;\n pages_succeeded: number;\n pages_failed: number;\n total_reported: number;\n rows: Record<string, unknown>[];\n failures: Array<{\n offset: number;\n limit: number;\n message: string;\n }>;\n}\n\n// \u2500\u2500 Provisions (from_id cursor) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport type BillingProvisionScope = \"ml\" | \"mp\" | \"flex\" | \"full\";\n\nexport const MERCADO_LIBRE_BILLING_ORDER_DETAILS_PATH = \"/billing/integration/group/ML/order/details\" as const;\nexport const MERCADO_LIBRE_BILLING_ORDER_IDS_MAX_PER_REQUEST = 60;\n\nexport interface BillingProvisionPage {\n results: Record<string, unknown>[];\n last_id: string | null;\n total: number;\n limit: number;\n}\n\nexport interface BillingProvisionFetchResult {\n scope: BillingProvisionScope;\n period_key: string;\n document_type: string;\n pages_requested: number;\n pages_succeeded: number;\n pages_failed: number;\n detail_count_total: number;\n last_id_seen: string | null;\n coverage_complete: boolean;\n rows: Record<string, unknown>[];\n failures: Array<{ page: number; from_id: string | null; message: string }>;\n}\n\n/**\n * Resolves the URL path segment for a given scope.\n * ml \u2192 group/ML/details\n * mp \u2192 group/MP/details\n * flex \u2192 group/ML/flex/details\n * full \u2192 group/ML/full/details\n */\nexport function scopeToGroupPath(scope: BillingProvisionScope): string {\n if (scope === \"flex\") return \"ML/flex\";\n if (scope === \"full\") return \"ML/full\";\n return scope.toUpperCase(); // \"ml\" \u2192 \"ML\", \"mp\" \u2192 \"MP\"\n}\n\nexport function buildMercadoLibreBillingPeriodDetailsPath(\n periodKey: string,\n scope: BillingProvisionScope\n): string {\n return `/billing/integration/periods/key/${periodKey}/group/${scopeToGroupPath(scope)}/details`;\n}\n\nexport function buildMercadoLibreBillingOrderDetailsPath(): string {\n return MERCADO_LIBRE_BILLING_ORDER_DETAILS_PATH;\n}\n\nexport function clampMercadoLibreBillingOrderIdsBatchSize(batchSize: number): number {\n return Math.min(\n MERCADO_LIBRE_BILLING_ORDER_IDS_MAX_PER_REQUEST,\n Math.max(1, Math.floor(batchSize))\n );\n}\n\n/**\n * Fetch one page of billing provisions using from_id cursor.\n */\nexport async function getMercadoLibreBillingProvisionPage(\n profileId: string,\n params: {\n periodKey: string;\n scope: BillingProvisionScope;\n documentType: \"BILL\" | \"CREDIT_NOTE\";\n limit: number;\n fromId?: string | null;\n detailType?: string;\n detailSubTypes?: string[];\n excludeDetailSubTypes?: string[];\n marketplaceType?: string;\n orderIds?: string[];\n itemIds?: string[];\n }\n): Promise<BillingProvisionPage> {\n const { api } = await getMercadoLibreApiContext(profileId);\n\n const queryParams: Record<string, unknown> = {\n document_type: params.documentType,\n limit: params.limit,\n };\n if (params.fromId) queryParams.from_id = params.fromId;\n if (params.detailType) queryParams.detail_type = params.detailType;\n if (params.detailSubTypes?.length) queryParams.detail_sub_types = params.detailSubTypes.join(\",\");\n if (params.excludeDetailSubTypes?.length) queryParams.exclude_detail_sub_types = params.excludeDetailSubTypes.join(\",\");\n if (params.marketplaceType) queryParams.marketplace_type = params.marketplaceType;\n if (params.orderIds?.length) queryParams.order_ids = params.orderIds.join(\",\");\n if (params.itemIds?.length) queryParams.item_ids = params.itemIds.join(\",\");\n\n const response = await api.get<Record<string, unknown>>(\n buildMercadoLibreBillingPeriodDetailsPath(params.periodKey, params.scope),\n { params: queryParams }\n );\n\n const data = response.data;\n const results = Array.isArray(data.results) ? (data.results as Record<string, unknown>[]) : [];\n // last_id can be numeric (MELI sends number, not string) \u2014 handle both safely.\n // MELI uses 0 (or \"0\") as a terminal cursor meaning \"no more pages\".\n // Normalize terminal sentinels to null so pagination stops correctly.\n const rawLastId = data.last_id;\n const lastId = rawLastId != null && rawLastId !== 0 && rawLastId !== \"0\"\n ? String(rawLastId)\n : null;\n const pageTotal = Number(data.total ?? 0);\n const pageLimit = Number(data.limit ?? params.limit);\n\n return {\n results,\n last_id: lastId,\n total: isFinite(pageTotal) ? Math.max(0, pageTotal) : 0,\n limit: isFinite(pageLimit) ? Math.max(0, pageLimit) : params.limit,\n };\n}\n\nconst PROVISIONS_PAGE_LIMIT = 1000;\nconst PROVISIONS_MAX_PAGES = 200;\n\n/**\n * Fetch all billing provisions for one scope by walking from_id cursor.\n * Deduplicates by detail_id. Stops if last_id doesn't advance.\n * Returns partial coverage when pages fail.\n */\nexport async function getMercadoLibreBillingProvisions(\n profileId: string,\n params: {\n periodKey: string;\n scope: BillingProvisionScope;\n documentType: \"BILL\" | \"CREDIT_NOTE\";\n detailType?: string;\n detailSubTypes?: string[];\n excludeDetailSubTypes?: string[];\n marketplaceType?: string;\n orderIds?: string[];\n itemIds?: string[];\n /** Resume cursor: start fetching from this from_id instead of the first page. */\n fromId?: string | null;\n }\n): Promise<BillingProvisionFetchResult> {\n const seen = new Set<string>();\n const rows: Record<string, unknown>[] = [];\n const failures: BillingProvisionFetchResult[\"failures\"] = [];\n let lastId: string | null = params.fromId ?? null;\n let pagesRequested = 0;\n let pagesSucceeded = 0;\n let lastIdSeen: string | null = null;\n\n for (let page = 0; page < PROVISIONS_MAX_PAGES; page++) {\n pagesRequested += 1;\n let pageResult: BillingProvisionPage;\n\n try {\n pageResult = await getMercadoLibreBillingProvisionPage(profileId, {\n ...params,\n documentType: params.documentType,\n limit: PROVISIONS_PAGE_LIMIT,\n fromId: lastId,\n });\n pagesSucceeded += 1;\n } catch (error) {\n failures.push({\n page: page + 1,\n from_id: lastId,\n message: formatMercadoLibreError(error, \"Failed to fetch billing provisions page\"),\n });\n break;\n }\n\n const newRows: Record<string, unknown>[] = [];\n for (const row of pageResult.results) {\n // Real MELI payload nests detail fields under charge_info\n const chargeInfo = (row.charge_info as Record<string, unknown>) ?? row;\n const detailId = typeof chargeInfo.detail_id === \"string\"\n ? chargeInfo.detail_id\n : String(chargeInfo.detail_id ?? \"\");\n if (!detailId || seen.has(detailId)) continue;\n seen.add(detailId);\n newRows.push(row);\n }\n rows.push(...newRows);\n lastIdSeen = pageResult.last_id;\n\n // Stop conditions\n if (!pageResult.last_id) break;\n if (pageResult.last_id === lastId) break; // cursor not advancing\n if (pageResult.results.length === 0) break;\n\n lastId = pageResult.last_id;\n }\n\n const pagesFailed = pagesRequested - pagesSucceeded;\n const coverageComplete = pagesFailed === 0 && lastIdSeen === null;\n\n return {\n scope: params.scope,\n period_key: params.periodKey,\n document_type: params.documentType,\n pages_requested: pagesRequested,\n pages_succeeded: pagesSucceeded,\n pages_failed: pagesFailed,\n detail_count_total: rows.length,\n last_id_seen: lastIdSeen,\n coverage_complete: coverageComplete,\n rows,\n failures,\n };\n}\n\n// \u2500\u2500 Existing offset-based billing (preserved for backward compat) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport async function getMercadoLibreBillingDetailsPage(\n profileId: string,\n params: MercadoLibreBillingDetailsParams\n): Promise<MercadoLibreBillingPage> {\n const { api } = await getMercadoLibreApiContext(profileId);\n const documentType = params.documentType ?? \"BILL\";\n const group = params.group ?? \"ML\";\n const limit = Math.min(150, Math.max(1, Math.floor(params.limit ?? 150)));\n const offset = Math.max(0, Math.floor(params.offset ?? 0));\n\n const response = await api.get<Record<string, unknown>>(\n `/billing/integration/periods/key/${params.periodKey}/group/${group}/details`,\n {\n params: {\n document_type: documentType,\n limit,\n offset,\n },\n }\n );\n\n return {\n offset: Number(response.data.offset ?? offset),\n limit: Number(response.data.limit ?? limit),\n total: Number(response.data.total ?? 0),\n results: Array.isArray(response.data.results)\n ? (response.data.results as Record<string, unknown>[])\n : [],\n };\n}\n\nexport async function getMercadoLibreBillingDetails(\n profileId: string,\n params: Omit<MercadoLibreBillingDetailsParams, \"offset\"> & { maxPages?: number }\n): Promise<MercadoLibreBillingFetchResult> {\n const limit = Math.min(150, Math.max(1, Math.floor(params.limit ?? 150)));\n const maxPages = Math.max(1, Math.floor(params.maxPages ?? 20));\n const documentType = params.documentType ?? \"BILL\";\n const group = params.group ?? \"ML\";\n const rows: Record<string, unknown>[] = [];\n const failures: MercadoLibreBillingFetchResult[\"failures\"] = [];\n\n let totalReported = 0;\n let pagesRequested = 0;\n let pagesSucceeded = 0;\n\n for (let pageIndex = 0; pageIndex < maxPages; pageIndex += 1) {\n const offset = pageIndex * limit;\n pagesRequested += 1;\n\n try {\n const page = await getMercadoLibreBillingDetailsPage(profileId, {\n ...params,\n group,\n documentType,\n limit,\n offset,\n });\n pagesSucceeded += 1;\n totalReported = Math.max(totalReported, page.total);\n rows.push(...page.results);\n\n if (offset + page.results.length >= page.total || page.results.length === 0) {\n break;\n }\n } catch (error) {\n failures.push({\n offset,\n limit,\n message: formatMercadoLibreError(error, \"Failed to fetch MercadoLibre billing details\"),\n });\n break;\n }\n }\n\n return {\n period_key: params.periodKey,\n group,\n document_type: documentType,\n pages_requested: pagesRequested,\n pages_succeeded: pagesSucceeded,\n pages_failed: failures.length,\n total_reported: totalReported,\n rows,\n failures,\n };\n}\n\n// \u2500\u2500 Billing provisions by order (official order-centric endpoint) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nconst BY_ORDER_CHUNK_SIZE = MERCADO_LIBRE_BILLING_ORDER_IDS_MAX_PER_REQUEST;\nconst BY_ORDER_CONCURRENCY = 5;\n\nexport interface BillingProvisionByOrderChunkResult {\n results: Record<string, unknown>[];\n order_ids_requested: string[];\n}\n\nexport interface BillingProvisionByOrderResult {\n results: Record<string, unknown>[];\n order_ids_requested: string[];\n order_ids_found: string[];\n order_ids_not_found: string[];\n chunks_total: number;\n chunks_succeeded: number;\n chunks_failed: number;\n coverage_complete: boolean;\n failures: Array<{ chunk_index: number; order_ids: string[]; message: string }>;\n}\n\nfunction extractOrderIdFromBillingOrder(row: Record<string, unknown>): string | null {\n const topLevelOrderId = normalizeScalarString(row.order_id);\n if (topLevelOrderId) return topLevelOrderId;\n\n const paymentInfo = asRecord(row.payment_info);\n const paymentOrderId = normalizeScalarString(paymentInfo.order_id);\n if (paymentOrderId) return paymentOrderId;\n\n const details = asArray<Record<string, unknown>>(row.details);\n for (const detail of details) {\n const detailOrderId = normalizeScalarString(detail.order_id);\n if (detailOrderId) return detailOrderId;\n\n const detailSales = asArray<Record<string, unknown>>(detail.sales_info ?? detail.details_sales);\n for (const sale of detailSales) {\n const saleOrderId = normalizeScalarString(sale.order_id);\n if (saleOrderId) return saleOrderId;\n }\n }\n\n return null;\n}\n\n/**\n * Fetch billing provisions for a single chunk of order IDs using the official\n * documented Mercado Libre order-centric billing endpoint.\n */\nasync function getMercadoLibreBillingByOrderChunk(\n profileId: string,\n orderIds: string[]\n): Promise<BillingProvisionByOrderChunkResult> {\n const { api } = await getMercadoLibreApiContext(profileId);\n\n const response = await api.get<Record<string, unknown>>(buildMercadoLibreBillingOrderDetailsPath(), {\n params: {\n order_ids: orderIds.join(\",\"),\n },\n });\n\n const data = response.data;\n const results = Array.isArray(data.results)\n ? (data.results as Record<string, unknown>[])\n : Array.isArray(data)\n ? (data as Record<string, unknown>[])\n : [];\n\n return {\n results,\n order_ids_requested: orderIds,\n };\n}\n\n/**\n * Fetch billing provisions by order across multiple order IDs, chunked in\n * groups of up to 60 orders per request. Consolidates results and tracks\n * which orders were found vs. not found.\n */\nexport async function getMercadoLibreBillingProvisionsByOrder(\n profileId: string,\n params: {\n orderIds: string[];\n }\n): Promise<BillingProvisionByOrderResult> {\n const uniqueIds = Array.from(new Set(params.orderIds));\n const chunks: string[][] = [];\n\n for (let i = 0; i < uniqueIds.length; i += BY_ORDER_CHUNK_SIZE) {\n chunks.push(uniqueIds.slice(i, i + BY_ORDER_CHUNK_SIZE));\n }\n\n const allResults: Record<string, unknown>[] = [];\n const failures: BillingProvisionByOrderResult[\"failures\"] = [];\n let chunksSucceeded = 0;\n let chunksFailed = 0;\n\n for (let chunkIdx = 0; chunkIdx < chunks.length; chunkIdx += BY_ORDER_CONCURRENCY) {\n const batch = chunks.slice(chunkIdx, chunkIdx + BY_ORDER_CONCURRENCY);\n const settled = await Promise.allSettled(\n batch.map((chunk) => getMercadoLibreBillingByOrderChunk(profileId, chunk))\n );\n\n for (let i = 0; i < settled.length; i++) {\n const result = settled[i];\n if (result.status === \"fulfilled\") {\n chunksSucceeded += 1;\n allResults.push(...result.value.results);\n continue;\n }\n\n chunksFailed += 1;\n const chunkOrderIds = batch[i];\n failures.push({\n chunk_index: chunkIdx + i,\n order_ids: chunkOrderIds,\n message: formatMercadoLibreError(\n result.reason,\n \"Failed to fetch billing provisions by order chunk\"\n ),\n });\n }\n }\n\n const foundOrderIds = new Set<string>();\n for (const row of allResults) {\n const orderId = extractOrderIdFromBillingOrder(row);\n if (orderId) foundOrderIds.add(orderId);\n }\n\n const notFoundOrderIds = uniqueIds.filter((id) => !foundOrderIds.has(id));\n\n return {\n results: allResults,\n order_ids_requested: uniqueIds,\n order_ids_found: [...foundOrderIds],\n order_ids_not_found: notFoundOrderIds,\n chunks_total: chunks.length,\n chunks_succeeded: chunksSucceeded,\n chunks_failed: chunksFailed,\n coverage_complete: chunksFailed === 0,\n failures,\n };\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
|
@@ -0,0 +1,368 @@
|
|
|
1
|
+
import { MCP_TOOL_TOTAL_DEADLINE_MS } from "../../config/mcp-tool-deadline.js";
|
|
2
|
+
import { getMcpToolDeadlineRemainingMs } from "../../config/mcp-tool-deadline-context.js";
|
|
3
|
+
import { isRetryableMercadoLibreError } from "./mercadolibre-api.js";
|
|
4
|
+
import { getMercadoLibreOrder, getMercadoLibreShipment } from "./mercadolibre-orders.js";
|
|
5
|
+
import {
|
|
6
|
+
getMercadoLibreSaleBillingInfo,
|
|
7
|
+
verifyMercadoLibreOrderOwnership
|
|
8
|
+
} from "./mercadolibre-order-billing-info.js";
|
|
9
|
+
const MAX_SHIPMENT_CONCURRENCY = 4;
|
|
10
|
+
const MAX_SHIPMENT_RETRIES = 2;
|
|
11
|
+
const DEFAULT_RETRY_DELAY_MS = 250;
|
|
12
|
+
const BUYER_RECONCILIATION_SAFETY_MARGIN_RATIO = 0.05;
|
|
13
|
+
const BUYER_RECONCILIATION_MIN_SAFETY_MARGIN_MS = 100;
|
|
14
|
+
const BUYER_RECONCILIATION_MAX_SAFETY_MARGIN_MS = 1e4;
|
|
15
|
+
const DOCUMENT_TYPES = /* @__PURE__ */ new Map([
|
|
16
|
+
["CUIT", "CUIT"],
|
|
17
|
+
["CUIL", "CUIL"],
|
|
18
|
+
["DNI", "DNI"],
|
|
19
|
+
["CDI", "CDI"],
|
|
20
|
+
["PASSPORT", "PASSPORT"],
|
|
21
|
+
["PASAPORTE", "PASSPORT"]
|
|
22
|
+
]);
|
|
23
|
+
function getBuyerReconciliationSafetyMarginMs(globalTimeoutMs) {
|
|
24
|
+
if (!Number.isFinite(globalTimeoutMs) || globalTimeoutMs <= 0) return BUYER_RECONCILIATION_MIN_SAFETY_MARGIN_MS;
|
|
25
|
+
return Math.min(
|
|
26
|
+
BUYER_RECONCILIATION_MAX_SAFETY_MARGIN_MS,
|
|
27
|
+
Math.max(BUYER_RECONCILIATION_MIN_SAFETY_MARGIN_MS, Math.floor(globalTimeoutMs * BUYER_RECONCILIATION_SAFETY_MARGIN_RATIO))
|
|
28
|
+
);
|
|
29
|
+
}
|
|
30
|
+
function defaultDegradedOutcomeLogger(event) {
|
|
31
|
+
console.warn("[MELI BUYER RECONCILIATION DEGRADED]", JSON.stringify(event));
|
|
32
|
+
}
|
|
33
|
+
function isRecord(value) {
|
|
34
|
+
return value !== null && typeof value === "object" && !Array.isArray(value);
|
|
35
|
+
}
|
|
36
|
+
function record(value) {
|
|
37
|
+
return isRecord(value) ? value : {};
|
|
38
|
+
}
|
|
39
|
+
function scalar(value) {
|
|
40
|
+
if (typeof value === "string" && value.trim()) return value.trim();
|
|
41
|
+
if (typeof value === "number" && Number.isFinite(value)) return String(value);
|
|
42
|
+
return void 0;
|
|
43
|
+
}
|
|
44
|
+
function nestedScalar(value) {
|
|
45
|
+
if (typeof value === "string" || typeof value === "number") return scalar(value);
|
|
46
|
+
return scalar(record(value).name ?? record(value).id ?? record(value).description);
|
|
47
|
+
}
|
|
48
|
+
function nonEmpty(value) {
|
|
49
|
+
return Object.keys(value).length ? value : void 0;
|
|
50
|
+
}
|
|
51
|
+
function addressFrom(value) {
|
|
52
|
+
const input = record(value);
|
|
53
|
+
const address = {
|
|
54
|
+
street: [scalar(input.street_name), scalar(input.street_number)].filter(Boolean).join(" ") || void 0,
|
|
55
|
+
city: nestedScalar(input.city_name ?? input.city),
|
|
56
|
+
state: nestedScalar(input.state),
|
|
57
|
+
postal_code: scalar(input.zip_code ?? input.postal_code),
|
|
58
|
+
country: nestedScalar(input.country_id ?? input.country)
|
|
59
|
+
};
|
|
60
|
+
return nonEmpty(address);
|
|
61
|
+
}
|
|
62
|
+
function fullName(first, last) {
|
|
63
|
+
return [first, last].filter(Boolean).join(" ") || void 0;
|
|
64
|
+
}
|
|
65
|
+
function newData() {
|
|
66
|
+
return { completeness: "unavailable" };
|
|
67
|
+
}
|
|
68
|
+
function issueField(code) {
|
|
69
|
+
if (code.includes("fiscal") || code.includes("billing")) return "fiscal_address";
|
|
70
|
+
if (code.includes("shipping")) return "shipping_address";
|
|
71
|
+
if (code.includes("pack")) return "pack_members";
|
|
72
|
+
if (code.includes("ownership")) return "buyer";
|
|
73
|
+
return void 0;
|
|
74
|
+
}
|
|
75
|
+
function addIssue(data, code, field = issueField(code), message = reasonMessage(code)) {
|
|
76
|
+
const issues = data.issues ?? (data.issues = []);
|
|
77
|
+
if (!issues.some((issue) => issue.code === code && issue.field === field)) issues.push({ ...field ? { field } : {}, code, message });
|
|
78
|
+
}
|
|
79
|
+
function reasonMessage(code) {
|
|
80
|
+
const messages = {
|
|
81
|
+
order_seller_ownership_mismatch: "The sale belongs to a different seller, so buyer data was not returned.",
|
|
82
|
+
order_seller_ownership_unverifiable: "Seller ownership could not be verified, so buyer data was not returned.",
|
|
83
|
+
order_not_found: "The reference was not found as an order and pack resolution was unavailable.",
|
|
84
|
+
access_denied: "MercadoLibre denied access to this pack member; no buyer data was returned.",
|
|
85
|
+
upstream_unavailable: "MercadoLibre did not return this pack member before the bounded retry budget ended.",
|
|
86
|
+
request_failed: "This pack member could not be verified because MercadoLibre returned an unsuccessful response.",
|
|
87
|
+
invalid_member: "MercadoLibre reported a pack member without a valid order reference.",
|
|
88
|
+
billing_info_fiscal_fields_missing: "Fiscal billing information exists but required fields are missing.",
|
|
89
|
+
billing_info_fiscal_fields_malformed: "Fiscal billing information has an invalid shape.",
|
|
90
|
+
shipping_receiver_unavailable: "MercadoLibre did not provide a documented destination shipping address.",
|
|
91
|
+
shipping_source_unavailable: "The shipping detail could not be read from MercadoLibre.",
|
|
92
|
+
shipping_deadline_exceeded: "The shipping lookup exceeded the operation deadline.",
|
|
93
|
+
operation_deadline_exceeded: "The operation deadline expired before this data could be verified.",
|
|
94
|
+
pack_member_metadata_missing: "A pack member declared by MercadoLibre could not be resolved.",
|
|
95
|
+
pack_operation_deadline_exceeded: "The pack operation deadline expired before all members could be verified.",
|
|
96
|
+
pack_members_disagree: "Pack members expose different buyer, document or address data; no consolidated buyer was returned.",
|
|
97
|
+
pack_partial_coverage: "Some pack members could not be verified; consolidated buyer data is incomplete."
|
|
98
|
+
};
|
|
99
|
+
return messages[code] ?? "The requested source was unavailable or could not be verified.";
|
|
100
|
+
}
|
|
101
|
+
function isOperationDeadlineError(error, now, deadlineAt) {
|
|
102
|
+
if (now() >= deadlineAt) return true;
|
|
103
|
+
const candidate = isRecord(error) ? error : void 0;
|
|
104
|
+
const name = error instanceof Error ? error.name : scalar(candidate?.name);
|
|
105
|
+
const code = error instanceof Error && "code" in error ? String(error.code) : scalar(candidate?.code);
|
|
106
|
+
if (["AbortError", "TimeoutError"].includes(name ?? "") || ["ABORT_ERR", "ERR_ABORTED", "ETIMEDOUT"].includes(code ?? "")) return true;
|
|
107
|
+
const message = error instanceof Error ? error.message : scalar(candidate?.message) ?? (typeof error === "string" ? error : "");
|
|
108
|
+
const normalizedMessage = message.toLowerCase();
|
|
109
|
+
if (normalizedMessage.includes("deadline") || normalizedMessage.includes("timed out") || normalizedMessage === "timeout" || normalizedMessage === "aborted") return true;
|
|
110
|
+
return false;
|
|
111
|
+
}
|
|
112
|
+
function reasonForBilling(result) {
|
|
113
|
+
return result.available ? "" : result.reason;
|
|
114
|
+
}
|
|
115
|
+
function fiscalFrom(result) {
|
|
116
|
+
if (!result.available) return {};
|
|
117
|
+
const billing = record(record(result.billingInfo).buyer).billing_info;
|
|
118
|
+
const info = record(billing);
|
|
119
|
+
const identification = record(info.identification);
|
|
120
|
+
const first = scalar(info.name);
|
|
121
|
+
const last = scalar(info.last_name);
|
|
122
|
+
const type = scalar(identification.type)?.toUpperCase();
|
|
123
|
+
return {
|
|
124
|
+
first_name: first,
|
|
125
|
+
last_name: last,
|
|
126
|
+
full_name: fullName(first, last),
|
|
127
|
+
document: { type: (type && DOCUMENT_TYPES.get(type)) ?? "unknown", number: scalar(identification.number) },
|
|
128
|
+
fiscal_address: addressFrom(info.address)
|
|
129
|
+
};
|
|
130
|
+
}
|
|
131
|
+
function orderBuyerFrom(order) {
|
|
132
|
+
const buyer = record(record(order).buyer);
|
|
133
|
+
return { nickname: scalar(buyer.nickname) };
|
|
134
|
+
}
|
|
135
|
+
function shippingFrom(detail) {
|
|
136
|
+
return addressFrom(record(record(detail).destination).shipping_address);
|
|
137
|
+
}
|
|
138
|
+
function copyData(data, retryExhausted) {
|
|
139
|
+
const copy = { ...data, buyer: data.buyer ? { ...data.buyer, document: data.buyer.document ? { ...data.buyer.document } : void 0, fiscal_address: data.buyer.fiscal_address ? { ...data.buyer.fiscal_address } : void 0, shipping_address: data.buyer.shipping_address ? { ...data.buyer.shipping_address } : void 0 } : void 0, ...data.issues?.length ? { issues: data.issues.map((issue) => ({ ...issue })) } : {} };
|
|
140
|
+
if (retryExhausted.has(data)) retryExhausted.add(copy);
|
|
141
|
+
return copy;
|
|
142
|
+
}
|
|
143
|
+
function finish(data) {
|
|
144
|
+
const buyer = data.buyer;
|
|
145
|
+
const required = ["full_name_or_nickname", "document", "fiscal_address", "shipping_address"];
|
|
146
|
+
const missing = required.filter((field) => {
|
|
147
|
+
if (!buyer) return true;
|
|
148
|
+
if (field === "full_name_or_nickname") return !(buyer.full_name || buyer.nickname || buyer.first_name || buyer.last_name);
|
|
149
|
+
return !buyer[field];
|
|
150
|
+
});
|
|
151
|
+
data.completeness = !data.buyer ? "unavailable" : missing.length ? "partial" : "complete";
|
|
152
|
+
if (data.completeness !== "complete" && buyer) {
|
|
153
|
+
for (const field of missing) {
|
|
154
|
+
const issueFieldName = field === "full_name_or_nickname" ? "buyer" : field;
|
|
155
|
+
addIssue(data, `missing_${field}`, issueFieldName, `Buyer ${field.replaceAll("_", " ")} data was not available.`);
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
if (data.completeness === "complete") {
|
|
159
|
+
delete data.issues;
|
|
160
|
+
}
|
|
161
|
+
}
|
|
162
|
+
class Limiter {
|
|
163
|
+
active = 0;
|
|
164
|
+
waiters = [];
|
|
165
|
+
async run(operation) {
|
|
166
|
+
if (this.active >= MAX_SHIPMENT_CONCURRENCY) await new Promise((resolve) => this.waiters.push(resolve));
|
|
167
|
+
this.active += 1;
|
|
168
|
+
try {
|
|
169
|
+
return await operation();
|
|
170
|
+
} finally {
|
|
171
|
+
this.active -= 1;
|
|
172
|
+
this.waiters.shift()?.();
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
async function shipmentData(profileId, order, deadlineAt, options, cache, limiter) {
|
|
177
|
+
const id = scalar(record(record(order).shipping).id);
|
|
178
|
+
if (!id) return { code: "shipping_receiver_unavailable" };
|
|
179
|
+
const existing = cache.get(id);
|
|
180
|
+
if (existing) return existing;
|
|
181
|
+
const now = options.now ?? Date.now;
|
|
182
|
+
const request = limiter.run(async () => {
|
|
183
|
+
for (let attempt = 0; attempt <= (options.maxRetries ?? MAX_SHIPMENT_RETRIES); attempt += 1) {
|
|
184
|
+
const remaining = deadlineAt - now();
|
|
185
|
+
if (remaining <= 0) return { code: "shipping_deadline_exceeded" };
|
|
186
|
+
const controller = new AbortController();
|
|
187
|
+
let timer;
|
|
188
|
+
try {
|
|
189
|
+
const detail = await Promise.race([
|
|
190
|
+
getMercadoLibreShipment(profileId, id, { signal: controller.signal, headers: { "x-format-new": "true" } }),
|
|
191
|
+
new Promise((_, reject) => {
|
|
192
|
+
timer = setTimeout(() => {
|
|
193
|
+
controller.abort();
|
|
194
|
+
reject(new Error("shipping_deadline_exceeded"));
|
|
195
|
+
}, remaining);
|
|
196
|
+
})
|
|
197
|
+
]);
|
|
198
|
+
return { address: shippingFrom(detail) };
|
|
199
|
+
} catch (error) {
|
|
200
|
+
if (isOperationDeadlineError(error, now, deadlineAt)) return { code: "shipping_deadline_exceeded" };
|
|
201
|
+
if (!isRetryableMercadoLibreError(error) || attempt >= (options.maxRetries ?? MAX_SHIPMENT_RETRIES)) return { code: "shipping_source_unavailable", retriesExhausted: isRetryableMercadoLibreError(error) && (options.maxRetries ?? MAX_SHIPMENT_RETRIES) > 0 };
|
|
202
|
+
const delay = (options.baseRetryDelayMs ?? DEFAULT_RETRY_DELAY_MS) * 2 ** attempt;
|
|
203
|
+
if (now() + delay >= deadlineAt) return { code: "shipping_deadline_exceeded" };
|
|
204
|
+
await (options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms))))(delay);
|
|
205
|
+
} finally {
|
|
206
|
+
if (timer) clearTimeout(timer);
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
return { code: "shipping_source_unavailable" };
|
|
210
|
+
});
|
|
211
|
+
cache.set(id, request);
|
|
212
|
+
return request;
|
|
213
|
+
}
|
|
214
|
+
async function inspectOrder(profileId, orderId, billing, deadlineAt, options, cache, limiter, retryExhausted) {
|
|
215
|
+
const data = newData();
|
|
216
|
+
if (!billing.available && billing.reason === "order_seller_ownership_mismatch") {
|
|
217
|
+
addIssue(data, "order_seller_ownership_mismatch");
|
|
218
|
+
finish(data);
|
|
219
|
+
return data;
|
|
220
|
+
}
|
|
221
|
+
let order = billing.available ? billing.order : void 0;
|
|
222
|
+
if (!order) {
|
|
223
|
+
if ((options.now ?? Date.now)() >= deadlineAt) {
|
|
224
|
+
addIssue(data, "operation_deadline_exceeded");
|
|
225
|
+
finish(data);
|
|
226
|
+
return data;
|
|
227
|
+
}
|
|
228
|
+
try {
|
|
229
|
+
order = await getMercadoLibreOrder(profileId, orderId, { signal: AbortSignal.timeout(Math.max(1, deadlineAt - (options.now ?? Date.now)())) });
|
|
230
|
+
} catch (error) {
|
|
231
|
+
const deadline = isOperationDeadlineError(error, options.now ?? Date.now, deadlineAt);
|
|
232
|
+
addIssue(data, deadline ? "operation_deadline_exceeded" : "order_seller_ownership_unverifiable");
|
|
233
|
+
finish(data);
|
|
234
|
+
return data;
|
|
235
|
+
}
|
|
236
|
+
let ownership = "unverifiable";
|
|
237
|
+
try {
|
|
238
|
+
ownership = await verifyMercadoLibreOrderOwnership(profileId, order);
|
|
239
|
+
} catch {
|
|
240
|
+
}
|
|
241
|
+
if (ownership !== "owned") {
|
|
242
|
+
addIssue(data, ownership === "mismatch" ? "order_seller_ownership_mismatch" : "order_seller_ownership_unverifiable");
|
|
243
|
+
finish(data);
|
|
244
|
+
return data;
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
const buyer = { ...orderBuyerFrom(order), ...fiscalFrom(billing) };
|
|
248
|
+
data.buyer = buyer;
|
|
249
|
+
if (!billing.available) addIssue(data, reasonForBilling(billing));
|
|
250
|
+
const shipping = await shipmentData(profileId, order, deadlineAt, options, cache, limiter);
|
|
251
|
+
if (shipping.retriesExhausted) retryExhausted.add(data);
|
|
252
|
+
if (shipping.address) data.buyer.shipping_address = shipping.address;
|
|
253
|
+
else addIssue(data, shipping.code ?? "shipping_receiver_unavailable");
|
|
254
|
+
finish(data);
|
|
255
|
+
return data;
|
|
256
|
+
}
|
|
257
|
+
function normalized(value) {
|
|
258
|
+
if (typeof value === "string") return value.trim().replace(/\s+/g, " ").toLocaleLowerCase();
|
|
259
|
+
if (Array.isArray(value)) return value.map(normalized);
|
|
260
|
+
if (isRecord(value)) return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, item]) => [key, normalized(item)]));
|
|
261
|
+
return value;
|
|
262
|
+
}
|
|
263
|
+
function sameIdentity(data) {
|
|
264
|
+
const buyer = data.buyer;
|
|
265
|
+
return JSON.stringify(normalized({ name: buyer?.full_name, first: buyer?.first_name, last: buyer?.last_name, nickname: buyer?.nickname, document: buyer?.document, fiscal: buyer?.fiscal_address, shipping: buyer?.shipping_address }));
|
|
266
|
+
}
|
|
267
|
+
function packStatus(members, expected) {
|
|
268
|
+
if (!members.length) return "unavailable";
|
|
269
|
+
if (members.length < expected || members.some((member) => member.data.completeness === "unavailable")) return "partial";
|
|
270
|
+
if (members.some((member) => member.data.completeness !== "complete")) return "partial";
|
|
271
|
+
return new Set(members.map((member) => sameIdentity(member.data))).size === 1 ? "unanimous" : "disagreement";
|
|
272
|
+
}
|
|
273
|
+
function issuesFor(item) {
|
|
274
|
+
return [
|
|
275
|
+
...item.data.issues ?? [],
|
|
276
|
+
...item.pack?.members?.flatMap((member) => member.data.issues ?? []) ?? []
|
|
277
|
+
];
|
|
278
|
+
}
|
|
279
|
+
async function reconcileMercadoLibreBuyerData(profileId, saleReferences, options = {}) {
|
|
280
|
+
const startedAt = (options.now ?? Date.now)();
|
|
281
|
+
const globalTimeoutMs = options.operationDeadlineMs ?? getMcpToolDeadlineRemainingMs(startedAt) ?? MCP_TOOL_TOTAL_DEADLINE_MS;
|
|
282
|
+
const deadlineMs = Math.max(1, globalTimeoutMs - getBuyerReconciliationSafetyMarginMs(globalTimeoutMs));
|
|
283
|
+
const deadlineAt = startedAt + deadlineMs;
|
|
284
|
+
const cache = /* @__PURE__ */ new Map();
|
|
285
|
+
const limiter = new Limiter();
|
|
286
|
+
const retryExhausted = /* @__PURE__ */ new WeakSet();
|
|
287
|
+
const results = [];
|
|
288
|
+
for (const saleReference of saleReferences) {
|
|
289
|
+
const base = {
|
|
290
|
+
sale_reference: saleReference,
|
|
291
|
+
resolution: { kind: "unknown", status: "unavailable" },
|
|
292
|
+
data: newData()
|
|
293
|
+
};
|
|
294
|
+
if ((options.now ?? Date.now)() >= deadlineAt) {
|
|
295
|
+
addIssue(base.data, "operation_deadline_exceeded");
|
|
296
|
+
finish(base.data);
|
|
297
|
+
results.push(base);
|
|
298
|
+
continue;
|
|
299
|
+
}
|
|
300
|
+
try {
|
|
301
|
+
const resolution = await getMercadoLibreSaleBillingInfo(profileId, saleReference, { deadlineAt, maxRetries: options.maxRetries, baseRetryDelayMs: options.baseRetryDelayMs, sleep: options.sleep, now: options.now });
|
|
302
|
+
if (resolution.resolutionKind === "order") {
|
|
303
|
+
base.resolution = { kind: "order", status: "resolved" };
|
|
304
|
+
const inspected = await inspectOrder(profileId, resolution.orderId, resolution.result, deadlineAt, options, cache, limiter, retryExhausted);
|
|
305
|
+
base.data = inspected;
|
|
306
|
+
results.push(base);
|
|
307
|
+
continue;
|
|
308
|
+
}
|
|
309
|
+
const packUnavailable = "unavailableReason" in resolution;
|
|
310
|
+
base.resolution = { kind: "pack", status: packUnavailable ? "unavailable" : "resolved" };
|
|
311
|
+
const members = [];
|
|
312
|
+
const expected = Math.max(resolution.metadata.memberCount, resolution.members.length);
|
|
313
|
+
for (let index = 0; index < resolution.members.length; index += 1) {
|
|
314
|
+
const member = resolution.members[index];
|
|
315
|
+
if (!member.accessible) {
|
|
316
|
+
const data = newData();
|
|
317
|
+
const deadline2 = member.failureReason === "operation_deadline_exceeded";
|
|
318
|
+
if (member.failureReason === "upstream_unavailable" && "attempts" in member && (member.attempts ?? 0) > 1) retryExhausted.add(data);
|
|
319
|
+
addIssue(data, deadline2 ? "operation_deadline_exceeded" : member.failureReason);
|
|
320
|
+
finish(data);
|
|
321
|
+
members.push({ member_index: index, data });
|
|
322
|
+
continue;
|
|
323
|
+
}
|
|
324
|
+
const inspected = await inspectOrder(profileId, member.orderId, member.result, deadlineAt, options, cache, limiter, retryExhausted);
|
|
325
|
+
members.push({ member_index: index, data: inspected });
|
|
326
|
+
}
|
|
327
|
+
for (let index = resolution.members.length; index < expected; index += 1) {
|
|
328
|
+
const data = newData();
|
|
329
|
+
addIssue(data, "pack_member_metadata_missing");
|
|
330
|
+
finish(data);
|
|
331
|
+
members.push({ member_index: index, data });
|
|
332
|
+
}
|
|
333
|
+
const agreement = packUnavailable ? "unavailable" : packStatus(members, expected);
|
|
334
|
+
base.pack = { agreement, ...agreement === "unanimous" ? {} : { members } };
|
|
335
|
+
if (agreement === "unanimous") base.data = copyData(members[0].data, retryExhausted);
|
|
336
|
+
else {
|
|
337
|
+
const data = newData();
|
|
338
|
+
const deadline2 = packUnavailable && resolution.unavailableReason === "pack_operation_deadline_exceeded";
|
|
339
|
+
data.completeness = agreement === "disagreement" || agreement === "partial" ? "partial" : "unavailable";
|
|
340
|
+
addIssue(data, agreement === "disagreement" ? "pack_members_disagree" : agreement === "partial" ? "pack_partial_coverage" : deadline2 ? "operation_deadline_exceeded" : "reference_unavailable");
|
|
341
|
+
base.data = data;
|
|
342
|
+
}
|
|
343
|
+
} catch (error) {
|
|
344
|
+
const deadline2 = isOperationDeadlineError(error, options.now ?? Date.now, deadlineAt);
|
|
345
|
+
addIssue(base.data, deadline2 ? "operation_deadline_exceeded" : "reference_unavailable");
|
|
346
|
+
base.resolution = { kind: "unknown", status: "unavailable" };
|
|
347
|
+
finish(base.data);
|
|
348
|
+
}
|
|
349
|
+
results.push(base);
|
|
350
|
+
}
|
|
351
|
+
const counts = { complete: 0, partial: 0, unavailable: 0 };
|
|
352
|
+
for (const item of results) counts[item.data.completeness] += 1;
|
|
353
|
+
const summary = { requested: saleReferences.length, ...counts, orders: results.filter((item) => item.resolution.kind === "order").length, packs: results.filter((item) => item.resolution.kind === "pack").length, unknown: results.filter((item) => item.resolution.kind === "unknown").length };
|
|
354
|
+
const deadline = results.reduce((count, item) => count + (issuesFor(item).some((issue) => issue.code.includes("deadline")) ? 1 : 0), 0);
|
|
355
|
+
const retry = results.reduce((count, item) => count + (retryExhausted.has(item.data) || (item.pack?.members?.some((member) => retryExhausted.has(member.data)) ?? false) ? 1 : 0), 0);
|
|
356
|
+
if (summary.partial > 0 || summary.unavailable > 0 || deadline > 0 || retry > 0) {
|
|
357
|
+
(options.onDegradedOutcome ?? defaultDegradedOutcomeLogger)({ event: "buyer_reconciliation_degraded", requested: summary.requested, complete: summary.complete, partial: summary.partial, unavailable: summary.unavailable, deadline, retry });
|
|
358
|
+
}
|
|
359
|
+
return {
|
|
360
|
+
results,
|
|
361
|
+
summary
|
|
362
|
+
};
|
|
363
|
+
}
|
|
364
|
+
export {
|
|
365
|
+
getBuyerReconciliationSafetyMarginMs,
|
|
366
|
+
reconcileMercadoLibreBuyerData
|
|
367
|
+
};
|
|
368
|
+
//# sourceMappingURL=mercadolibre-buyer-reconciliation.js.map
|