@yoryoboy/bi-mcp 1.19.0 → 1.20.0

package/dist/src/services/mercadolibre/mercadolibre-observability.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/services/mercadolibre/mercadolibre-observability.ts"],
+  "sourcesContent": ["export type MercadoLibreBuyerReconciliationTelemetry = {\n  event: \"buyer_reconciliation_completed\";\n  outcome: \"complete\" | \"partial\" | \"unavailable\" | \"deadline_exceeded\";\n  latency_ms: number;\n  references_with_partial_coverage: number;\n  references_unavailable: number;\n  deadline_exceeded: number;\n  retry_exhausted: number;\n  privacy: {\n    pii_included: false;\n    identifiers_included: false;\n    raw_payloads_included: false;\n  };\n};\n\nexport type MercadoLibreBuyerReconciliationTelemetrySink = {\n  emit: (event: MercadoLibreBuyerReconciliationTelemetry) => void;\n};\n\nconst defaultTelemetrySink: MercadoLibreBuyerReconciliationTelemetrySink = {\n  emit(event) {\n    console.info(\"[meli_reconcile_buyer_data]\", JSON.stringify(event));\n  },\n};\n\nexport function getDefaultMercadoLibreBuyerReconciliationTelemetrySink(): MercadoLibreBuyerReconciliationTelemetrySink {\n  return defaultTelemetrySink;\n}\n"],
+  "mappings": "AAmBA,MAAM,uBAAqE;AAAA,EACzE,KAAK,OAAO;AACV,YAAQ,KAAK,+BAA+B,KAAK,UAAU,KAAK,CAAC;AAAA,EACnE;AACF;AAEO,SAAS,yDAAuG;AACrH,SAAO;AACT;",
+  "names": []
+}

package/dist/src/services/mercadolibre/mercadolibre-sale-reference.js

@@ -0,0 +1,7 @@
+function normalizeMercadoLibreSaleReference(input) {
+  return typeof input === "string" ? { reference: input } : input;
+}
+export {
+  normalizeMercadoLibreSaleReference
+};
+//# sourceMappingURL=mercadolibre-sale-reference.js.map

package/dist/src/services/mercadolibre/mercadolibre-sale-reference.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/services/mercadolibre/mercadolibre-sale-reference.ts"],
+  "sourcesContent": ["export type MercadoLibreSaleReference =\n  | string\n  | { reference: string; kind: \"order\" | \"pack\" };\n\nexport function normalizeMercadoLibreSaleReference(input: MercadoLibreSaleReference): {\n  reference: string;\n  kind?: \"order\" | \"pack\";\n} {\n  return typeof input === \"string\" ? { reference: input } : input;\n}\n"],
+  "mappings": "AAIO,SAAS,mCAAmC,OAGjD;AACA,SAAO,OAAO,UAAU,WAAW,EAAE,WAAW,MAAM,IAAI;AAC5D;",
+  "names": []
+}

package/dist/src/services/mercadolibre/mercadolibre-sales-report.js

@@ -0,0 +1,553 @@
+import {
+  normalizeMercadoLibrePaging,
+  runMercadoLibreBatch
+} from "./mercadolibre-api.js";
+import {
+  searchMercadoLibreOrders,
+  searchMercadoLibreOrdersBatch,
+  getMercadoLibreOrderDetailsBatch,
+  getMercadoLibreOrderShipments
+} from "./mercadolibre-orders.js";
+import { getMercadoLibrePackBatch } from "./mercadolibre-packs.js";
+import {
+  getMercadoLibreSaleBillingInfo
+} from "./mercadolibre-order-billing-info.js";
+const VENTAS_CODES = /* @__PURE__ */ new Set(["CVFV", "CVFN", "CVFF", "CDSD"]);
+const record = (value2) => value2 !== null && typeof value2 === "object" && !Array.isArray(value2) ? value2 : {};
+const records = (value2) => Array.isArray(value2) ? value2.filter((item) => item && typeof item === "object" && !Array.isArray(item)) : value2 !== null && typeof value2 === "object" ? [value2] : [];
+const numberValue = (value2) => typeof value2 === "number" && Number.isFinite(value2) ? value2 : null;
+const text = (value2) => typeof value2 === "string" && value2.trim() ? value2.trim() : null;
+function orderSellerId(order) {
+  const seller = record(order.seller);
+  const id = seller.id;
+  return typeof id === "string" && id.trim() ? id.trim() : typeof id === "number" && Number.isFinite(id) ? String(id) : null;
+}
+function packMemberIds(pack) {
+  const members = Array.isArray(pack.orders) ? pack.orders : [];
+  return [...new Set(members.map((member) => {
+    const value2 = record(member).id ?? member;
+    return typeof value2 === "string" && value2.trim() ? value2.trim() : typeof value2 === "number" && Number.isFinite(value2) ? String(value2) : null;
+  }).filter((id) => id !== null))];
+}
+async function selectMercadoLibreOrdersById(profileId, sellerId, orderIds) {
+  const direct = await getMercadoLibreOrderDetailsBatch(profileId, orderIds, { maxConcurrency: 10 });
+  const ownedDirect = direct.successful.filter(({ document }) => orderSellerId(document) === sellerId);
+  const ownedDirectIds = new Set(ownedDirect.map(({ id }) => id));
+  const directFailures = new Map(direct.failed.map((failure) => [failure.id, failure]));
+  const unavailableRequestedIds = orderIds.filter((id) => !ownedDirectIds.has(id));
+  const packIds = [...new Set(ownedDirect.map(({ document }) => text(document.pack_id)).filter((id) => id !== null))];
+  const packs = packIds.length > 0 ? await getMercadoLibrePackBatch(profileId, packIds, { maxConcurrency: 10 }) : { successful: [], failed: [] };
+  const selected = new Map(ownedDirect.map(({ id, document }) => [id, document]));
+  const missingMemberIds = [...new Set(packs.successful.flatMap(({ document }) => packMemberIds(document)))].filter((id) => !selected.has(id));
+  const expanded = missingMemberIds.length > 0 ? await getMercadoLibreOrderDetailsBatch(profileId, missingMemberIds, { maxConcurrency: 10 }) : { successful: [], failed: [] };
+  for (const { id, document } of expanded.successful) {
+    if (orderSellerId(document) === sellerId) selected.set(id, document);
+  }
+  return {
+    orders: [...selected.values()],
+    requestedIds: orderIds,
+    unavailableRequestedIds,
+    incidents: [
+      ...unavailableRequestedIds.map((id) => {
+        const failure = directFailures.get(id);
+        return {
+          fuente: "orders",
+          alcance: "order_selection",
+          identificadores: [id],
+          mensaje: failure ? "The requested order could not be retrieved." : "The requested order is not available for this seller profile.",
+          reintentable: failure?.retryable ?? false,
+          estado_http: failure?.statusCode ?? null
+        };
+      }),
+      ...packs.failed.map((failure) => ({
+        fuente: "packs",
+        alcance: "pack_expansion",
+        identificadores: [failure.id],
+        mensaje: "The complete pack could not be retrieved.",
+        reintentable: failure.retryable,
+        estado_http: failure.statusCode ?? null
+      })),
+      ...expanded.failed.map(() => ({
+        fuente: "orders",
+        alcance: "pack_expansion",
+        identificadores: [],
+        mensaje: "A pack member could not be retrieved and was excluded.",
+        reintentable: true
+      })),
+      ...expanded.successful.filter(({ document }) => orderSellerId(document) !== sellerId).map(() => ({
+        fuente: "orders",
+        alcance: "pack_expansion",
+        identificadores: [],
+        mensaje: "A pack member is not available for this seller profile and was excluded.",
+        reintentable: false
+      }))
+    ]
+  };
+}
+const SALES_REPORT_BUYER_EVIDENCE = /* @__PURE__ */ Symbol("sales-report-buyer-evidence");
+const emptyReturns = () => ({ unidades: null, forma_de_entrega: null, fecha_en_camino: null, fecha_entregado: null, transportista: null, numero_de_seguimiento: null, url_de_seguimiento: null, revisado_por_mercado_libre: null, fecha_de_revision: null, dinero_a_favor: null, resultado: null, destino: null, motivo_del_resultado: null });
+const emptyClaims = () => ({ unidades: null, reclamo_abierto: null, reclamo_cerrado: null, con_mediacion: null });
+function memberContext(result, reference, orderId, key) {
+  const entry = result?.results?.find((item) => item.sale_reference === reference);
+  if (!entry) return void 0;
+  const member = entry.members?.find((item) => item.order_id === orderId || record(item[key]).order_id === orderId);
+  const context = member?.[key] ?? (entry.members ? void 0 : entry[key]);
+  const issues = member?.issues ?? entry.issues ?? [];
+  return context || issues.length ? { ...record(context), order_id: record(context).order_id ?? member?.order_id ?? entry.order_id ?? orderId, __memberIssues: issues } : void 0;
+}
+function buildSalesReportPostPurchaseIncident(source, error) {
+  const rawStatus = record(error).status;
+  const status = typeof rawStatus === "number" ? rawStatus : null;
+  const retryable = status === null ? true : status === 408 || status === 429 || status >= 500 && status <= 599;
+  return { fuente: source, alcance: "source", identificadores: [], mensaje: `Mercado Libre ${source} evidence was unavailable${status === null ? " (transport)" : ` (HTTP ${status})`}.`, reintentable: retryable, estado_http: status };
+}
+function enrichSalesReportDevolucionesReclamos(operations, evidence) {
+  const incidents = [];
+  const returnFields = ["unidades", "revisado_por_mercado_libre", "fecha_de_revision", "resultado", "destino", "motivo_del_resultado"];
+  const claimFields = ["unidades", "reclamo_abierto", "reclamo_cerrado", "con_mediacion"];
+  const coverage = Object.fromEntries([...returnFields.map((field) => [`devoluciones.${field}`, { solicitados: 0, obtenidos: 0 }]), ...claimFields.map((field) => [`reclamos.${field}`, { solicitados: 0, obtenidos: 0 }])]);
+  let returnContexts = 0;
+  let claimContexts = 0;
+  const mapped = operations.map((operation2) => ({ ...operation2, ordenes: operation2.ordenes.map((order, memberIndex) => {
+    const returns = memberContext(evidence.returns, operation2.pack_id ?? order.order_id, order.order_id, "return_context");
+    const claims = memberContext(evidence.claims, operation2.pack_id ?? order.order_id, order.order_id, "claim_context");
+    if (returns) returnContexts++;
+    if (claims) claimContexts++;
+    const returnRows = returns?.return_status === "with_return" && returns.return ? [returns] : [];
+    const review = record(returnRows[0]?.review);
+    const destination = record(review.product_destination);
+    const reason = record(review.reason);
+    const devoluciones = { ...emptyReturns(), ...returnRows.length ? { unidades: numberValue(record(returnRows[0].return).quantities), revisado_por_mercado_libre: typeof review.status === "string" ? review.status === "success" : null, fecha_de_revision: text(review.date_created), resultado: text(review.status), destino: text(destination.code ?? destination.meaning), motivo_del_resultado: text(reason.code ?? reason.description) } : {} };
+    const claimRows = Array.isArray(claims?.claims) ? claims.claims.map(record) : [];
+    const quantities = claimRows.map((claim) => numberValue(claim.claimed_quantity)).filter((value2) => value2 !== null);
+    const reclamos = { ...emptyClaims(), ...claimRows.length ? { unidades: quantities.length ? quantities.reduce((sum, value2) => sum + value2, 0) : null, reclamo_abierto: claimRows.some((claim) => claim.status === "opened"), reclamo_cerrado: claimRows.some((claim) => claim.status === "closed"), con_mediacion: claimRows.some((claim) => claim.type === "mediations") } : {} };
+    for (const field of returnFields) {
+      const key = `devoluciones.${field}`;
+      coverage[key].solicitados++;
+      if (devoluciones[field] !== null) coverage[key].obtenidos++;
+    }
+    for (const field of claimFields) {
+      const key = `reclamos.${field}`;
+      coverage[key].solicitados++;
+      if (reclamos[field] !== null) coverage[key].obtenidos++;
+    }
+    if (returns?.__memberIssues?.length || returns?.issues?.length) incidents.push({ fuente: "returns", alcance: "order", identificadores: [order.order_id], mensaje: "Return evidence is partial; member-level reconciliation issues were preserved.", reintentable: true });
+    if (claims?.__memberIssues?.length || claims?.issues?.length) incidents.push({ fuente: "claims", alcance: "order", identificadores: [order.order_id], mensaje: "Claim evidence is partial; member-level reconciliation issues were preserved.", reintentable: true });
+    return { ...order, devoluciones, reclamos };
+  }) }));
+  if (evidence.returnFailure) incidents.push(buildSalesReportPostPurchaseIncident("returns", evidence.returnFailure));
+  if (evidence.claimFailure) incidents.push(buildSalesReportPostPurchaseIncident("claims", evidence.claimFailure));
+  return { operations: mapped, incidents, coverage, returnContexts, claimContexts };
+}
+const SALES_REPORT_ENVIOS_FIELDS = [
+  "forma_de_entrega",
+  "fecha_en_camino",
+  "fecha_entregado",
+  "transportista",
+  "numero_de_seguimiento",
+  "url_de_seguimiento"
+];
+const SALES_REPORT_FACTURACION_FIELDS = [
+  "factura_adjunta",
+  "datos_personales_o_de_empresa",
+  "tipo_y_numero_de_documento",
+  "direccion",
+  "condicion_fiscal_iva",
+  "numero_iibb"
+];
+function fiscalResultEntries(orderId, result) {
+  if (result.resolutionKind === "order") return [{ orderId, result: result.result }];
+  return result.members.flatMap((member) => {
+    if (!("orderId" in member)) return [];
+    return [member.accessible ? { orderId: member.orderId, result: member.result } : { orderId: member.orderId, unavailableReason: member.failureReason, statusCode: member.statusCode, retryable: member.retryable }];
+  });
+}
+function buildSalesReportFiscalIncident(orderId, statusCode, retryable, reason = "Fiscal billing-info request failed.") {
+  const statusText = statusCode === void 0 ? "transport" : `HTTP ${statusCode}`;
+  const statusRetryable = statusCode !== void 0 && [401, 403, 404].includes(statusCode) ? false : retryable;
+  return {
+    fuente: "billing_info",
+    alcance: "order",
+    identificadores: [orderId],
+    mensaje: `${reason} (${statusText}).`,
+    reintentable: statusRetryable,
+    estado_http: statusCode ?? null
+  };
+}
+async function fetchMercadoLibreFiscalEvidence(profileId, orderIds) {
+  const batch = await runMercadoLibreBatch(
+    [...new Set(orderIds)],
+    (orderId) => getMercadoLibreSaleBillingInfo(profileId, orderId)
+  );
+  return {
+    successful: batch.successful.flatMap(({ id, document }) => fiscalResultEntries(id, document)),
+    failed: batch.failed.map((failure) => ({ orderId: failure.id, statusCode: failure.statusCode, retryable: failure.retryable, reason: "Fiscal billing-info request failed." }))
+  };
+}
+function fiscalField(value2) {
+  if (typeof value2 === "string" && value2.trim()) return value2.trim();
+  if (typeof value2 === "number" && Number.isFinite(value2)) return String(value2);
+  return null;
+}
+function fiscalAddress(value2) {
+  const address = record(value2);
+  const street = [fiscalField(address.street_name), fiscalField(address.street_number)].filter((part) => part !== null).join(" ");
+  const parts = [street || null, fiscalField(address.city_name), fiscalField(address.state), fiscalField(address.zip_code), fiscalField(address.country_id)].filter((part) => part !== null);
+  return parts.length ? parts.join(", ") : null;
+}
+function enrichSalesReportFacturacion(operations, evidence, failedOrderIds = []) {
+  const byOrder = new Map(evidence.map((entry) => [entry.orderId, entry]));
+  const incidents = failedOrderIds.map(({ orderId, statusCode, retryable, reason }) => buildSalesReportFiscalIncident(orderId, statusCode, retryable, reason));
+  const fieldCoverage = Object.fromEntries(SALES_REPORT_FACTURACION_FIELDS.map((field) => [field, { solicitados: 0, obtenidos: 0 }]));
+  const mapped = operations.map((operation2) => ({
+    ...operation2,
+    ordenes: operation2.ordenes.map((order) => {
+      const entry = byOrder.get(order.order_id);
+      const billing = entry?.result?.available ? record(record(entry.result.billingInfo).buyer).billing_info : null;
+      const info = record(billing);
+      const identification = record(info.identification);
+      const taxpayer = record(record(info.taxes).taxpayer_type);
+      const fields = {
+        factura_adjunta: null,
+        datos_personales_o_de_empresa: [fiscalField(info.name), fiscalField(info.last_name)].filter((part) => part !== null).join(" ") || null,
+        tipo_y_numero_de_documento: [fiscalField(identification.type), fiscalField(identification.number)].filter((part) => part !== null).join(" ") || null,
+        direccion: fiscalAddress(info.address),
+        condicion_fiscal_iva: fiscalField(taxpayer.description),
+        numero_iibb: null
+      };
+      for (const field of SALES_REPORT_FACTURACION_FIELDS) {
+        fieldCoverage[field].solicitados++;
+        if (fields[field] !== null) fieldCoverage[field].obtenidos++;
+        if (fields[field] === null && field !== "factura_adjunta" && field !== "numero_iibb") {
+          incidents.push({ ...buildSalesReportFiscalIncident(order.order_id, entry?.statusCode, entry?.retryable ?? false, entry?.unavailableReason ?? "Fiscal field evidence was unavailable for this order."), alcance: `order.${field}` });
+        }
+      }
+      return { ...order, facturacion_al_comprador: fields };
+    })
+  }));
+  return { operations: mapped, incidents, fieldCoverage };
+}
+function enrichSalesReportCompradores(operations, expectedSellerId) {
+  const incidents = [];
+  const empty = { comprador: null, negocio: null, dni: null, domicilio: null, ciudad: null, estado: null, codigo_postal: null, pais: null };
+  const mapped = operations.map((operation2) => ({
+    ...operation2,
+    ordenes: operation2.ordenes.map((order) => {
+      const evidence = order[SALES_REPORT_BUYER_EVIDENCE];
+      if (!evidence || evidence.sellerId !== expectedSellerId) {
+        incidents.push({ fuente: "orders", alcance: "order", identificadores: [order.order_id], mensaje: "Buyer disclosure was blocked because seller ownership could not be verified.", reintentable: false });
+        return { ...order, compradores: empty };
+      }
+      if (!evidence.nickname) {
+        incidents.push({ fuente: "orders", alcance: "order", identificadores: [order.order_id], mensaje: "Buyer nickname was missing or malformed; buyer disclosure was blocked.", reintentable: false });
+        return { ...order, compradores: empty };
+      }
+      return { ...order, compradores: { ...empty, comprador: evidence.nickname } };
+    })
+  }));
+  return { operations: mapped, incidents };
+}
+function enrichSalesReportEnvios(operations, evidence) {
+  const byOrder = new Map(evidence.map((entry) => [entry.order_id, entry.shipment]));
+  const incidents = [];
+  const fieldCoverage = Object.fromEntries(SALES_REPORT_ENVIOS_FIELDS.map((field) => [field, { solicitados: operations.reduce((total, operation2) => total + operation2.ordenes.length, 0), obtenidos: 0 }]));
+  const fields = (orderId) => {
+    const shipment = record(byOrder.get(orderId));
+    const shipmentOrderId = text(shipment.order_id);
+    if (!Object.keys(shipment).length || shipmentOrderId !== orderId) {
+      incidents.push({ fuente: "shipments", alcance: "order", identificadores: [orderId], mensaje: shipmentOrderId ? "Shipment evidence belongs to a different order." : "No shipment evidence was returned for this order.", reintentable: false });
+      return { forma_de_entrega: null, fecha_en_camino: null, fecha_entregado: null, transportista: null, numero_de_seguimiento: null, url_de_seguimiento: null };
+    }
+    const statusHistory = record(shipment.status_history);
+    const shippingOption = record(shipment.shipping_option);
+    const carrier = record(shipment.carrier_info);
+    const mapped = {
+      forma_de_entrega: text(shippingOption.name) ?? text(shipment.mode),
+      fecha_en_camino: text(statusHistory.date_shipped),
+      fecha_entregado: text(statusHistory.date_delivered),
+      transportista: text(carrier.name),
+      numero_de_seguimiento: text(shipment.tracking_number),
+      url_de_seguimiento: text(carrier.url)
+    };
+    for (const field of SALES_REPORT_ENVIOS_FIELDS) {
+      if (mapped[field] !== null) fieldCoverage[field].obtenidos++;
+      else incidents.push({ fuente: "shipments", alcance: `order.${field}`, identificadores: [orderId], mensaje: "Shipment field evidence was unavailable for this order.", reintentable: false });
+    }
+    return mapped;
+  };
+  return {
+    operations: operations.map((operation2) => ({
+      ...operation2,
+      ordenes: operation2.ordenes.map((order) => ({ ...order, envios: fields(order.order_id) }))
+    })),
+    incidents,
+    fieldCoverage
+  };
+}
+async function fetchMercadoLibreShipmentEvidence(profileId, orderIds) {
+  return runMercadoLibreBatch(
+    [...new Set(orderIds)],
+    (orderId) => getMercadoLibreOrderShipments(profileId, orderId)
+  );
+}
+function formatVariation(item) {
+  const attributes = records(item.variation_attributes);
+  const values = attributes.map((attribute) => {
+    const name = text(attribute.name);
+    const value2 = text(attribute.value_name);
+    return name && value2 ? `${name}: ${value2}` : null;
+  }).filter((value2) => value2 !== null);
+  return values.length ? values.join(", ") : null;
+}
+function enrichSalesReportVentas(operations, billing) {
+  const byOrder = /* @__PURE__ */ new Map();
+  const unknownConcepts = /* @__PURE__ */ new Set();
+  const currencies = /* @__PURE__ */ new Set();
+  for (const row of billing.results) {
+    const fallback = String(row.order_id ?? "");
+    for (const detail of records(row.details)) {
+      const charge = record(detail.charge_info);
+      const code = String(charge.detail_sub_type ?? detail.detail_sub_type ?? "");
+      const currency = String(record(detail.currency_info).currency_id ?? row.currency_id ?? "");
+      if (currency) currencies.add(currency);
+      if (!VENTAS_CODES.has(code)) {
+        if (code) unknownConcepts.add(code);
+        continue;
+      }
+      const amount = numberValue(charge.detail_amount ?? detail.detail_amount);
+      if (currency !== "ARS" || amount === null || String(charge.detail_type ?? detail.detail_type ?? "") !== "CHARGE") continue;
+      const sales = records(detail.sales_info ?? detail.details_sales);
+      const orderIds = sales.map((sale) => String(sale.order_id ?? "")).filter(Boolean);
+      for (const orderId of orderIds.length ? orderIds : [fallback]) {
+        const list = byOrder.get(orderId) ?? [];
+        list.push({ code, amount, date: String(charge.creation_date_time ?? detail.creation_date_time ?? "") });
+        byOrder.set(orderId, list);
+      }
+    }
+  }
+  const result = operations.map((operation2) => {
+    const entries = operation2.ordenes.flatMap((order) => byOrder.get(order.order_id) ?? []);
+    const sum = (code) => entries.filter((entry) => entry.code === code).reduce((total, entry) => total - Number(entry.amount), 0);
+    const value2 = (code) => entries.some((entry) => entry.code === code) ? sum(code) : null;
+    const periods = [...new Set(entries.map((entry) => String(entry.date).slice(0, 7)).filter((period) => /^\d{4}-\d{2}$/.test(period)))].sort();
+    const known = entries.reduce((total, entry) => total - Number(entry.amount), 0);
+    return { ...operation2, ventas: { ...operation2.ventas, cargo_por_venta: value2("CVFV"), costo_fijo: value2("CVFF"), costo_por_ofrecer_cuotas: value2("CVFN"), anulaciones_y_reembolsos_ars: value2("CDSD"), total_ars: entries.length ? known : null, cargo_por_diferencias_en_medidas_y_peso_del_paquete: null, periodos_de_facturacion: periods } };
+  });
+  return {
+    operations: result,
+    unknownConcepts: [...unknownConcepts].sort(),
+    currencies: [...currencies].sort(),
+    incidents: billing.order_ids_not_found.map((orderId) => ({ fuente: "billing", alcance: "order", identificadores: [orderId], mensaje: "Billing-by-order returned no result for this order.", reintentable: false })),
+    failures: billing.failures
+  };
+}
+function buildOrderUniversePagePlan(paging, target, maxPages = 20) {
+  const effectiveLimit = paging.limit > 0 ? paging.limit : target;
+  const end = Math.min(
+    paging.total,
+    paging.offset + Math.max(0, target) + effectiveLimit
+  );
+  const offsets = [];
+  for (let offset = paging.offset + effectiveLimit; offset < end && offsets.length < maxPages; offset += effectiveLimit) {
+    offsets.push(offset);
+  }
+  return offsets;
+}
+function value(record2, key) {
+  return Object.prototype.hasOwnProperty.call(record2, key) ? record2[key] ?? null : null;
+}
+function normalizeMercadoLibreOrder(input) {
+  const id = String(input.id ?? "");
+  const date = String(input.date_created ?? input.date_closed ?? "");
+  const items = Array.isArray(input.order_items) ? input.order_items : [];
+  const firstItem = items[0] ?? {};
+  const item = firstItem.item ?? {};
+  const total = typeof input.total_amount === "number" ? input.total_amount : null;
+  const normalized = {
+    order_id: id,
+    ventas: {
+      fecha_de_venta: date,
+      estado: value(input, "status"),
+      descripcion_del_estado: value(input, "status_detail"),
+      pertenece_a_un_kit: null,
+      unidades: typeof firstItem.quantity === "number" ? firstItem.quantity : null,
+      ingresos_por_productos_ars: null,
+      orden_de_compra: null
+    },
+    publicidad: { venta_por_publicidad: null },
+    publicaciones: {
+      sku: value(item, "seller_sku"),
+      numero_de_publicacion: value(item, "id"),
+      canal_de_venta: null,
+      titulo_de_la_publicacion: value(item, "title"),
+      variante: formatVariation(item),
+      precio_unitario_de_venta_de_la_publicacion_ars: typeof firstItem.unit_price === "number" ? firstItem.unit_price : null,
+      tiene_cuotas_agregadas: null
+    },
+    facturacion_al_comprador: {
+      factura_adjunta: null,
+      datos_personales_o_de_empresa: null,
+      tipo_y_numero_de_documento: null,
+      direccion: null,
+      condicion_fiscal_iva: null,
+      numero_iibb: null
+    },
+    compradores: {
+      comprador: null,
+      negocio: null,
+      dni: null,
+      domicilio: null,
+      ciudad: null,
+      estado: null,
+      codigo_postal: null,
+      pais: null
+    },
+    envios: {
+      forma_de_entrega: null,
+      fecha_en_camino: null,
+      fecha_entregado: null,
+      transportista: null,
+      numero_de_seguimiento: null,
+      url_de_seguimiento: null
+    },
+    devoluciones: {
+      unidades: null,
+      forma_de_entrega: null,
+      fecha_en_camino: null,
+      fecha_entregado: null,
+      transportista: null,
+      numero_de_seguimiento: null,
+      url_de_seguimiento: null,
+      revisado_por_mercado_libre: null,
+      fecha_de_revision: null,
+      dinero_a_favor: null,
+      resultado: null,
+      destino: null,
+      motivo_del_resultado: null
+    },
+    reclamos: { unidades: null, reclamo_abierto: null, reclamo_cerrado: null, con_mediacion: null }
+  };
+  const seller = record(input.seller);
+  const buyer = record(input.buyer);
+  normalized[SALES_REPORT_BUYER_EVIDENCE] = { sellerId: text(seller.id), nickname: text(buyer.nickname) };
+  return normalized;
+}
+function enrichSalesReportPublicaciones(operations, billing) {
+  const byOrder = /* @__PURE__ */ new Map();
+  for (const row of billing.results) {
+    const fallback = String(row.order_id ?? "");
+    for (const detail of records(row.details)) {
+      const sales = records(detail.sales_info ?? detail.details_sales);
+      const items = records(detail.items_info ?? detail.details_items);
+      const orderIds = sales.map((sale) => text(sale.order_id)).filter((id) => id !== null);
+      for (const orderId of (orderIds.length ? orderIds : [fallback]).filter(Boolean)) {
+        const channel = text(sales.find((sale) => text(sale.order_id) === orderId)?.sales_channel);
+        const list = byOrder.get(orderId) ?? [];
+        list.push(...items.map((item) => ({ channel, item })));
+        byOrder.set(orderId, list);
+      }
+    }
+  }
+  const result = operations.map((operation2) => ({
+    ...operation2,
+    ordenes: operation2.ordenes.map((order) => {
+      const item = record(order.publicaciones);
+      const orderEvidence = byOrder.get(order.order_id) ?? [];
+      const evidence = orderEvidence.find(({ item: candidate }) => text(candidate.item_id) === item.numero_de_publicacion) ?? orderEvidence[0];
+      const billingItem = evidence?.item;
+      const hasFees = billingItem && Object.prototype.hasOwnProperty.call(billingItem, "fees_added_in_publication");
+      const feeValue = hasFees && (billingItem.fees_added_in_publication === "Si" || billingItem.fees_added_in_publication === "No") ? billingItem.fees_added_in_publication === "Si" : null;
+      const kitId = billingItem && Object.prototype.hasOwnProperty.call(billingItem, "item_kit_id") ? text(billingItem.item_kit_id) : null;
+      return {
+        ...order,
+        ventas: { ...order.ventas, pertenece_a_un_kit: billingItem && Object.prototype.hasOwnProperty.call(billingItem, "item_kit_id") ? kitId !== null : null },
+        publicaciones: {
+          ...order.publicaciones,
+          canal_de_venta: evidence?.channel ?? null,
+          titulo_de_la_publicacion: order.publicaciones.titulo_de_la_publicacion ?? text(billingItem?.item_title),
+          precio_unitario_de_venta_de_la_publicacion_ars: order.publicaciones.precio_unitario_de_venta_de_la_publicacion_ars ?? numberValue(billingItem?.item_price),
+          tiene_cuotas_agregadas: feeValue
+        }
+      };
+    })
+  }));
+  return { operations: result, incidents: billing.order_ids_not_found.map((orderId) => ({ fuente: "billing", alcance: "order", identificadores: [orderId], mensaje: "Billing-by-order returned no result for this order.", reintentable: false })) };
+}
+function operation(packId, orders) {
+  return {
+    pack_id: packId,
+    ventas: {
+      paquete_de_varios_productos: packId !== null,
+      cargo_por_venta: null,
+      costo_fijo: null,
+      costo_por_ofrecer_cuotas: null,
+      ingresos_por_envio_ars: null,
+      costos_de_envio_ars: null,
+      costo_de_envio_por_cambio_de_producto: null,
+      costo_de_envio_basado_en_medidas_y_peso_declarados: null,
+      cargo_por_diferencias_en_medidas_y_peso_del_paquete: null,
+      impuestos: null,
+      descuentos_y_bonificaciones: null,
+      anulaciones_y_reembolsos_ars: null,
+      total_ars: null,
+      periodos_de_facturacion: []
+    },
+    ordenes: orders
+  };
+}
+function groupMercadoLibreOrders(records2) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const record2 of records2) {
+    const normalized = normalizeMercadoLibreOrder(record2);
+    const packId = record2.pack_id == null ? null : String(record2.pack_id);
+    const key = packId ?? `order:${normalized.order_id}`;
+    const group = groups.get(key) ?? [];
+    group.push(normalized);
+    groups.set(key, group);
+  }
+  return [...groups.entries()].map(
+    ([key, orders]) => operation(
+      key.startsWith("order:") ? null : key,
+      orders
+    )
+  ).sort((left, right) => {
+    const leftDate = left.ordenes.reduce((latest, order) => order.ventas.fecha_de_venta > latest ? order.ventas.fecha_de_venta : latest, left.ordenes[0].ventas.fecha_de_venta);
+    const rightDate = right.ordenes.reduce((latest, order) => order.ventas.fecha_de_venta > latest ? order.ventas.fecha_de_venta : latest, right.ordenes[0].ventas.fecha_de_venta);
+    return Date.parse(rightDate) - Date.parse(leftDate) || (right.pack_id ?? right.ordenes[0].order_id).localeCompare(left.pack_id ?? left.ordenes[0].order_id);
+  });
+}
+async function fetchMercadoLibreOrderUniverse(profileId, from, to, target) {
+  const seed = await searchMercadoLibreOrders(profileId, { seller: "", from, to, sort: "date_desc", limit: 50, offset: 0 });
+  const paging = normalizeMercadoLibrePaging(seed.paging);
+  const seedOrders = Array.isArray(seed.results) ? seed.results : Array.isArray(seed.orders) ? seed.orders : [];
+  const offsets = buildOrderUniversePagePlan(paging, target);
+  const remaining = offsets.length ? await searchMercadoLibreOrdersBatch(profileId, { seller: "", from, to, sort: "date_desc", limit: paging.limit }, offsets) : { successful: [], failed: [] };
+  return {
+    orders: [...seedOrders, ...remaining.successful.flatMap((page) => {
+      const data = page.document;
+      return Array.isArray(data.results) ? data.results : Array.isArray(data.orders) ? data.orders : [];
+    })],
+    paging,
+    failedPages: remaining.failed.map((failure) => failure.id)
+  };
+}
+export {
+  SALES_REPORT_ENVIOS_FIELDS,
+  SALES_REPORT_FACTURACION_FIELDS,
+  buildOrderUniversePagePlan,
+  buildSalesReportFiscalIncident,
+  buildSalesReportPostPurchaseIncident,
+  enrichSalesReportCompradores,
+  enrichSalesReportDevolucionesReclamos,
+  enrichSalesReportEnvios,
+  enrichSalesReportFacturacion,
+  enrichSalesReportPublicaciones,
+  enrichSalesReportVentas,
+  fetchMercadoLibreFiscalEvidence,
+  fetchMercadoLibreOrderUniverse,
+  fetchMercadoLibreShipmentEvidence,
+  groupMercadoLibreOrders,
+  normalizeMercadoLibreOrder,
+  selectMercadoLibreOrdersById
+};
+//# sourceMappingURL=mercadolibre-sales-report.js.map