@yoryoboy/bi-mcp 1.14.3 → 1.16.0

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/services/mercadolibre/mercadolibre-billing.ts"],
-  "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\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"],
-  "mappings": "AAAA,SAAS,2BAA2B,+BAA+B;AAiCnE,eAAsB,kCACpB,WACA,QACkC;AAClC,QAAM,EAAE,IAAI,IAAI,MAAM,0BAA0B,SAAS;AACzD,QAAM,eAAe,OAAO,gBAAgB;AAC5C,QAAM,QAAQ,OAAO,SAAS;AAC9B,QAAM,QAAQ,KAAK,IAAI,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,SAAS,GAAG,CAAC,CAAC;AACxE,QAAM,SAAS,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,UAAU,CAAC,CAAC;AAEzD,QAAM,WAAW,MAAM,IAAI;AAAA,IACzB,oCAAoC,OAAO,SAAS,UAAU,KAAK;AAAA,IACnE;AAAA,MACE,QAAQ;AAAA,QACN,eAAe;AAAA,QACf;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,QAAQ,OAAO,SAAS,KAAK,UAAU,MAAM;AAAA,IAC7C,OAAO,OAAO,SAAS,KAAK,SAAS,KAAK;AAAA,IAC1C,OAAO,OAAO,SAAS,KAAK,SAAS,CAAC;AAAA,IACtC,SAAS,MAAM,QAAQ,SAAS,KAAK,OAAO,IACvC,SAAS,KAAK,UACf,CAAC;AAAA,EACP;AACF;AAEA,eAAsB,8BACpB,WACA,QACyC;AACzC,QAAM,QAAQ,KAAK,IAAI,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,SAAS,GAAG,CAAC,CAAC;AACxE,QAAM,WAAW,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,YAAY,EAAE,CAAC;AAC9D,QAAM,eAAe,OAAO,gBAAgB;AAC5C,QAAM,QAAQ,OAAO,SAAS;AAC9B,QAAM,OAAkC,CAAC;AACzC,QAAM,WAAuD,CAAC;AAE9D,MAAI,gBAAgB;AACpB,MAAI,iBAAiB;AACrB,MAAI,iBAAiB;AAErB,WAAS,YAAY,GAAG,YAAY,UAAU,aAAa,GAAG;AAC5D,UAAM,SAAS,YAAY;AAC3B,sBAAkB;AAElB,QAAI;AACF,YAAM,OAAO,MAAM,kCAAkC,WAAW;AAAA,QAC9D,GAAG;AAAA,QACH;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AACD,wBAAkB;AAClB,sBAAgB,KAAK,IAAI,eAAe,KAAK,KAAK;AAClD,WAAK,KAAK,GAAG,KAAK,OAAO;AAEzB,UAAI,SAAS,KAAK,QAAQ,UAAU,KAAK,SAAS,KAAK,QAAQ,WAAW,GAAG;AAC3E;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,eAAS,KAAK;AAAA,QACZ;AAAA,QACA;AAAA,QACA,SAAS,wBAAwB,OAAO,8CAA8C;AAAA,MACxF,CAAC;AACD;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,YAAY,OAAO;AAAA,IACnB;AAAA,IACA,eAAe;AAAA,IACf,iBAAiB;AAAA,IACjB,iBAAiB;AAAA,IACjB,cAAc,SAAS;AAAA,IACvB,gBAAgB;AAAA,IAChB;AAAA,IACA;AAAA,EACF;AACF;",
+  "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"],
+  "mappings": "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",
   "names": []
 }

package/dist/src/tools/mercadolibre/get-billing-provisions-summary.js

@@ -0,0 +1,391 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import {
+  getMercadoLibreBillingProvisions
+} from "../../services/mercadolibre/mercadolibre-billing.js";
+import {
+  formatMercadoLibreError
+} from "../../services/mercadolibre/mercadolibre-api.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+import { normalizeString, roundMoney, toNumber, asArray } from "./helpers.js";
+import { resolveMercadoLibreProfileOrSelection } from "./profile-resolution.js";
+import { mercadolibreProfileIdSchemaField } from "./write-helpers.js";
+const meliGetBillingProvisionsSummarySchema = z.object({
+  profileId: mercadolibreProfileIdSchemaField,
+  periodKey: z.string().regex(/^\d{4}-\d{2}-01$/).describe("Billing period key in YYYY-MM-01 format (month start only)."),
+  scope: z.enum(["ml", "mp", "flex", "full", "all"]).describe(
+    "Provision scope: ml (MercadoLibre), mp (MercadoPago), flex (Meli Flex), full (Meli Full), or all (all scopes merged)."
+  ),
+  documentType: z.enum(["BILL", "CREDIT_NOTE"]).default("BILL").optional().describe("Document type: BILL or CREDIT_NOTE. Defaults to BILL."),
+  detailType: z.string().trim().min(1).optional().describe("Optional detail type filter."),
+  detailSubTypes: z.array(z.string().trim().min(1)).optional().describe("Optional detail sub-type filters."),
+  excludeDetailSubTypes: z.array(z.string().trim().min(1)).optional().describe("Optional detail sub-types to exclude."),
+  marketplaceType: z.string().trim().min(1).optional().describe("Optional marketplace type filter."),
+  orderIds: z.array(z.string().trim().min(1)).optional().describe("Optional order ID filters."),
+  itemIds: z.array(z.string().trim().min(1)).optional().describe("Optional item ID filters."),
+  fromIdByScope: z.object({
+    ml: z.string().trim().min(1).optional(),
+    mp: z.string().trim().min(1).optional(),
+    flex: z.string().trim().min(1).optional(),
+    full: z.string().trim().min(1).optional()
+  }).optional().describe(
+    'Optional map from scope to from_id cursor for resuming a partial fetch. Use the same scope keys as the response continuation_by_scope block. Example: { "ml": "abc-123" } resumes the ml scope from cursor abc-123.'
+  )
+});
+const detailsSchema = [
+  "detail_id",
+  "detail_type",
+  "detail_sub_type",
+  "transaction_detail",
+  "detail_amount",
+  "currency_id",
+  "marketplace",
+  "concept_type",
+  "order_id",
+  "operation_id",
+  "item_id",
+  "item_title",
+  "shipping_id",
+  "pack_id",
+  "document_id",
+  "creation_date_time",
+  "sales_info_count",
+  "items_info_count"
+];
+function projectCompactRow(row) {
+  const chargeInfo = row.charge_info ?? {};
+  const currencyInfo = row.currency_info ?? {};
+  const marketplaceInfo = row.marketplace_info ?? {};
+  const salesInfo = asArray(row.sales_info);
+  const itemsInfo = asArray(row.items_info);
+  const firstSale = salesInfo[0];
+  const firstItem = itemsInfo[0];
+  return [
+    normalizeString(chargeInfo.detail_id) || null,
+    // 0:  detail_id
+    normalizeString(chargeInfo.detail_type) || null,
+    // 1:  detail_type
+    normalizeString(chargeInfo.detail_sub_type) || null,
+    // 2:  detail_sub_type
+    normalizeString(chargeInfo.transaction_detail) || null,
+    // 3:  transaction_detail
+    toNumber(chargeInfo.detail_amount),
+    // 4:  detail_amount
+    normalizeString(currencyInfo.currency_id) || null,
+    // 5:  currency_id
+    normalizeString(marketplaceInfo.marketplace) || null,
+    // 6:  marketplace
+    normalizeString(chargeInfo.concept_type) || null,
+    // 7:  concept_type
+    firstSale ? normalizeString(firstSale.order_id) || null : null,
+    // 8:  order_id
+    firstSale ? normalizeString(firstSale.operation_id) || null : null,
+    // 9: operation_id
+    firstItem ? normalizeString(firstItem.item_id) || null : null,
+    // 10: item_id
+    firstItem ? normalizeString(firstItem.item_title) || null : null,
+    // 11: item_title
+    firstSale ? normalizeString(firstSale.shipping_id) || null : null,
+    // 12: shipping_id
+    firstSale ? normalizeString(firstSale.pack_id) || null : null,
+    // 13: pack_id
+    normalizeString(row.document_id) || null,
+    // 14: document_id
+    normalizeString(chargeInfo.creation_date_time ?? row.creation_date_time) || null,
+    // 15: creation_date_time
+    salesInfo.length,
+    // 16: sales_info_count
+    itemsInfo.length
+    // 17: items_info_count
+  ];
+}
+const detailsSalesSchema = [
+  "detail_id",
+  "order_id",
+  "operation_id",
+  "sale_date_time",
+  "payer_nickname",
+  "transaction_amount"
+];
+function projectSalesRow(detailId, sale) {
+  return [
+    detailId,
+    // 0: detail_id
+    normalizeString(sale.order_id) || null,
+    // 1: order_id
+    normalizeString(sale.operation_id) || null,
+    // 2: operation_id
+    normalizeString(sale.sale_date_time) || null,
+    // 3: sale_date_time
+    normalizeString(sale.payer_nickname) || null,
+    // 4: payer_nickname
+    toNumber(sale.transaction_amount)
+    // 5: transaction_amount
+  ];
+}
+const detailsItemsSchema = [
+  "detail_id",
+  "item_id",
+  "item_title",
+  "item_amount",
+  "item_price",
+  "order_id"
+];
+function projectItemsRow(detailId, item) {
+  return [
+    detailId,
+    // 0: detail_id
+    normalizeString(item.item_id) || null,
+    // 1: item_id
+    normalizeString(item.item_title) || null,
+    // 2: item_title
+    toNumber(item.item_amount),
+    // 3: item_amount
+    toNumber(item.item_price),
+    // 4: item_price
+    normalizeString(item.order_id) || null
+    // 5: order_id
+  ];
+}
+function emptyCurrencyBucket() {
+  return {
+    charge_amount_total: 0,
+    bonus_amount_total: 0,
+    discount_amount_total: 0,
+    net_effect_total: 0
+  };
+}
+function classifyChargeType(row) {
+  const chargeInfo = row.charge_info ?? {};
+  const detailSubType = normalizeString(chargeInfo.detail_sub_type, "").trim().toUpperCase();
+  const transactionDetail = normalizeString(chargeInfo.transaction_detail, "").toLowerCase().trim();
+  const conceptType = normalizeString(chargeInfo.concept_type, "").toLowerCase().trim();
+  if (detailSubType.startsWith("B") || detailSubType.toLowerCase().includes("bonus") || detailSubType.toLowerCase().includes("bonificacion") || detailSubType.toLowerCase().includes("bonificaci\xF3n") || transactionDetail.includes("anulaci\xF3n") || transactionDetail.includes("anulacion") || transactionDetail.includes("bonus") || transactionDetail.includes("bonificaci\xF3n") || conceptType.includes("bonus") || conceptType.includes("bonificaci\xF3n")) {
+    return "bonus";
+  }
+  if (detailSubType.startsWith("D") || detailSubType.toLowerCase().includes("discount") || detailSubType.toLowerCase().includes("descuento") || detailSubType.toLowerCase().includes("adjustment") || transactionDetail.includes("descuento") || transactionDetail.includes("discount") || transactionDetail.includes("ajuste") || conceptType.includes("discount") || conceptType.includes("descuento")) {
+    return "discount";
+  }
+  return "charge";
+}
+function aggregateRows(rows) {
+  const currencyTotals = {};
+  const orderIds = /* @__PURE__ */ new Set();
+  const itemIds = /* @__PURE__ */ new Set();
+  const compactRows = [];
+  const detailSubTypesObserved = /* @__PURE__ */ new Set();
+  const marketplacesObserved = /* @__PURE__ */ new Set();
+  const conceptTypesObserved = /* @__PURE__ */ new Set();
+  for (const row of rows) {
+    compactRows.push(projectCompactRow(row));
+    const currencyInfo = row.currency_info;
+    const currency = normalizeString(
+      currencyInfo?.currency_id ?? row.currency_id ?? row.currency,
+      "UNKNOWN"
+    ).toUpperCase();
+    const bucket = currencyTotals[currency] ?? emptyCurrencyBucket();
+    currencyTotals[currency] = bucket;
+    const chargeInfo = row.charge_info ?? {};
+    const amount = toNumber(chargeInfo.detail_amount ?? chargeInfo.amount ?? 0);
+    const chargeType = classifyChargeType(row);
+    if (chargeType === "bonus") {
+      bucket.bonus_amount_total += amount;
+    } else if (chargeType === "discount") {
+      bucket.discount_amount_total += amount;
+    } else {
+      bucket.charge_amount_total += amount;
+    }
+    const detailSubType = normalizeString(chargeInfo.detail_sub_type, "").trim();
+    if (detailSubType) detailSubTypesObserved.add(detailSubType);
+    const marketplaceInfo = row.marketplace_info;
+    const marketplace = normalizeString(marketplaceInfo?.marketplace, "").trim();
+    if (marketplace) marketplacesObserved.add(marketplace);
+    const conceptType = normalizeString(chargeInfo.concept_type, "").trim();
+    if (conceptType) conceptTypesObserved.add(conceptType);
+    const salesInfo = asArray(row.sales_info);
+    for (const si of salesInfo) {
+      const oid = normalizeString(si.order_id);
+      if (oid) orderIds.add(oid);
+    }
+    const itemsInfo = asArray(row.items_info);
+    for (const ii of itemsInfo) {
+      const iid = normalizeString(ii.item_id);
+      if (iid) itemIds.add(iid);
+    }
+  }
+  for (const bucket of Object.values(currencyTotals)) {
+    bucket.net_effect_total = bucket.charge_amount_total + bucket.bonus_amount_total + bucket.discount_amount_total;
+  }
+  for (const bucket of Object.values(currencyTotals)) {
+    bucket.charge_amount_total = roundMoney(bucket.charge_amount_total);
+    bucket.bonus_amount_total = roundMoney(bucket.bonus_amount_total);
+    bucket.discount_amount_total = roundMoney(bucket.discount_amount_total);
+    bucket.net_effect_total = roundMoney(bucket.net_effect_total);
+  }
+  return {
+    compactRows,
+    currencyTotals,
+    detailCount: rows.length,
+    orderCountDetected: orderIds.size,
+    itemCountDetected: itemIds.size,
+    detailSubTypesObserved,
+    marketplacesObserved,
+    conceptTypesObserved
+  };
+}
+const ALL_SCOPES = ["ml", "mp", "flex", "full"];
+async function fetchScope(profileId, scope, params, fromId) {
+  return getMercadoLibreBillingProvisions(profileId, { scope, ...params, fromId });
+}
+async function meliGetBillingProvisionsSummaryHandler(params) {
+  try {
+    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const profileId = profileResolution.value.profileId;
+    const documentType = params.documentType ?? "BILL";
+    const fetchParams = {
+      periodKey: params.periodKey,
+      documentType,
+      detailType: params.detailType,
+      detailSubTypes: params.detailSubTypes,
+      excludeDetailSubTypes: params.excludeDetailSubTypes,
+      marketplaceType: params.marketplaceType,
+      orderIds: params.orderIds,
+      itemIds: params.itemIds
+    };
+    const scopes = params.scope === "all" ? ALL_SCOPES : [params.scope];
+    const fromIdByScope = params.fromIdByScope ?? {};
+    const scopeResults = await Promise.all(
+      scopes.map((scope) => fetchScope(profileId, scope, fetchParams, fromIdByScope[scope] ?? null))
+    );
+    let totalRows = 0;
+    const globalOrderIds = /* @__PURE__ */ new Set();
+    const globalItemIds = /* @__PURE__ */ new Set();
+    const globalCompactRows = [];
+    const globalCurrencyTotals = {};
+    const globalDetailSubTypes = /* @__PURE__ */ new Set();
+    const globalMarketplaces = /* @__PURE__ */ new Set();
+    const globalConceptTypes = /* @__PURE__ */ new Set();
+    const globalSalesRows = [];
+    const globalItemsRows = [];
+    const coverageByScope = {};
+    const continuationByScope = {};
+    let totalSourcesCalled = 0;
+    let totalPagesRequested = 0;
+    let totalPagesSucceeded = 0;
+    let totalPagesFailed = 0;
+    let globalCoverageComplete = true;
+    let allFailures = [];
+    for (const result of scopeResults) {
+      const agg = aggregateRows(result.rows);
+      for (const [currency, bucket] of Object.entries(agg.currencyTotals)) {
+        const global = globalCurrencyTotals[currency] ?? emptyCurrencyBucket();
+        globalCurrencyTotals[currency] = global;
+        global.charge_amount_total = roundMoney(global.charge_amount_total + bucket.charge_amount_total);
+        global.bonus_amount_total = roundMoney(global.bonus_amount_total + bucket.bonus_amount_total);
+        global.discount_amount_total = roundMoney(global.discount_amount_total + bucket.discount_amount_total);
+        global.net_effect_total = roundMoney(global.net_effect_total + bucket.net_effect_total);
+      }
+      globalCompactRows.push(...agg.compactRows);
+      totalRows += agg.detailCount;
+      for (const row of result.rows) {
+        const chargeInfo = row.charge_info ?? {};
+        const detailId = normalizeString(chargeInfo.detail_id) || null;
+        const salesInfo = asArray(row.sales_info);
+        for (const si of salesInfo) {
+          const oid = normalizeString(si.order_id);
+          if (oid) globalOrderIds.add(oid);
+          globalSalesRows.push(projectSalesRow(detailId, si));
+        }
+        const itemsInfo = asArray(row.items_info);
+        for (const ii of itemsInfo) {
+          const iid = normalizeString(ii.item_id);
+          if (iid) globalItemIds.add(iid);
+          globalItemsRows.push(projectItemsRow(detailId, ii));
+        }
+      }
+      for (const s of agg.detailSubTypesObserved) globalDetailSubTypes.add(s);
+      for (const m of agg.marketplacesObserved) globalMarketplaces.add(m);
+      for (const c of agg.conceptTypesObserved) globalConceptTypes.add(c);
+      coverageByScope[result.scope] = {
+        coverage_complete: result.coverage_complete,
+        last_id_seen: result.last_id_seen,
+        pages_requested: result.pages_requested,
+        pages_succeeded: result.pages_succeeded,
+        pages_failed: result.pages_failed,
+        detail_count: agg.detailCount
+      };
+      if (!result.coverage_complete && result.last_id_seen) {
+        continuationByScope[result.scope] = {
+          last_id: result.last_id_seen,
+          hint: `Resume ${result.scope} scope with fromIdByScope: { "${result.scope}": "${result.last_id_seen}" }. ${result.pages_failed} page(s) failed.`
+        };
+      }
+      totalSourcesCalled += 1;
+      totalPagesRequested += result.pages_requested;
+      totalPagesSucceeded += result.pages_succeeded;
+      totalPagesFailed += result.pages_failed;
+      if (!result.coverage_complete) globalCoverageComplete = false;
+      for (const f of result.failures) {
+        allFailures.push({ scope: result.scope, ...f });
+      }
+    }
+    const metadata = {
+      sources_called: totalSourcesCalled,
+      pages_requested: totalPagesRequested,
+      pages_succeeded: totalPagesSucceeded,
+      pages_failed: totalPagesFailed,
+      detail_count_total: totalRows,
+      coverage_complete: globalCoverageComplete,
+      coverage_by_scope: coverageByScope
+    };
+    if (Object.keys(continuationByScope).length > 0) {
+      metadata.continuation_by_scope = continuationByScope;
+    }
+    if (allFailures.length > 0) {
+      metadata.failures = allFailures;
+    }
+    const diagnostics = {
+      detail_sub_types_observed: [...globalDetailSubTypes].sort(),
+      marketplaces_observed: [...globalMarketplaces].sort(),
+      concept_types_observed: [...globalConceptTypes].sort()
+    };
+    const stripped = stripNulls({
+      profile_id: profileId,
+      period_key: params.periodKey,
+      scope: params.scope,
+      document_type: documentType,
+      metadata,
+      summary: {
+        detail_count: totalRows,
+        order_count_detected: globalOrderIds.size,
+        item_count_detected: globalItemIds.size,
+        currency_totals: globalCurrencyTotals
+      }
+    });
+    stripped.details_schema = detailsSchema;
+    stripped.details = globalCompactRows;
+    stripped.diagnostics = diagnostics;
+    stripped.details_sales_schema = detailsSalesSchema;
+    stripped.details_sales = globalSalesRows;
+    stripped.details_items_schema = detailsItemsSchema;
+    stripped.details_items = globalItemsRows;
+    const summary = stripped.summary;
+    summary.currency_totals = globalCurrencyTotals;
+    return object(stripped);
+  } catch (err) {
+    return error(
+      formatMercadoLibreError(err, "Failed to get MercadoLibre billing provisions summary")
+    );
+  }
+}
+export {
+  detailsItemsSchema,
+  detailsSalesSchema,
+  detailsSchema,
+  meliGetBillingProvisionsSummaryHandler,
+  meliGetBillingProvisionsSummarySchema
+};
+//# sourceMappingURL=get-billing-provisions-summary.js.map

package/dist/src/tools/mercadolibre/get-billing-provisions-summary.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/mercadolibre/get-billing-provisions-summary.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  type BillingProvisionFetchResult,\n  type BillingProvisionScope,\n  getMercadoLibreBillingProvisions,\n} from \"../../services/mercadolibre/mercadolibre-billing.js\";\nimport {\n  formatMercadoLibreError,\n} from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { normalizeString, roundMoney, toNumber, asArray } from \"./helpers.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\n\n// \u2500\u2500 Schema \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const meliGetBillingProvisionsSummarySchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  periodKey: z\n    .string()\n    .regex(/^\\d{4}-\\d{2}-01$/)\n    .describe(\"Billing period key in YYYY-MM-01 format (month start only).\"),\n  scope: z.enum([\"ml\", \"mp\", \"flex\", \"full\", \"all\"]).describe(\n    \"Provision scope: ml (MercadoLibre), mp (MercadoPago), flex (Meli Flex), full (Meli Full), or all (all scopes merged).\"\n  ),\n  documentType: z\n    .enum([\"BILL\", \"CREDIT_NOTE\"])\n    .default(\"BILL\")\n    .optional()\n    .describe(\"Document type: BILL or CREDIT_NOTE. Defaults to BILL.\"),\n  detailType: z.string().trim().min(1).optional().describe(\"Optional detail type filter.\"),\n  detailSubTypes: z\n    .array(z.string().trim().min(1))\n    .optional()\n    .describe(\"Optional detail sub-type filters.\"),\n  excludeDetailSubTypes: z\n    .array(z.string().trim().min(1))\n    .optional()\n    .describe(\"Optional detail sub-types to exclude.\"),\n  marketplaceType: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\"Optional marketplace type filter.\"),\n  orderIds: z\n    .array(z.string().trim().min(1))\n    .optional()\n    .describe(\"Optional order ID filters.\"),\n  itemIds: z\n    .array(z.string().trim().min(1))\n    .optional()\n    .describe(\"Optional item ID filters.\"),\n  fromIdByScope: z\n    .object({\n      ml: z.string().trim().min(1).optional(),\n      mp: z.string().trim().min(1).optional(),\n      flex: z.string().trim().min(1).optional(),\n      full: z.string().trim().min(1).optional(),\n    })\n    .optional()\n    .describe(\n      \"Optional map from scope to from_id cursor for resuming a partial fetch. \" +\n      \"Use the same scope keys as the response continuation_by_scope block. \" +\n      'Example: { \"ml\": \"abc-123\" } resumes the ml scope from cursor abc-123.'\n    ),\n});\n\n// \u2500\u2500 Compact schemas (faithful to real MELI payload, flattened) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const detailsSchema = [\n  \"detail_id\",\n  \"detail_type\",\n  \"detail_sub_type\",\n  \"transaction_detail\",\n  \"detail_amount\",\n  \"currency_id\",\n  \"marketplace\",\n  \"concept_type\",\n  \"order_id\",\n  \"operation_id\",\n  \"item_id\",\n  \"item_title\",\n  \"shipping_id\",\n  \"pack_id\",\n  \"document_id\",\n  \"creation_date_time\",\n  \"sales_info_count\",\n  \"items_info_count\",\n] as const;\n\ntype DetailRow = (string | number | null)[];\n\n/**\n * Project a raw MELI billing detail row into a positional compact array.\n * The order matches `detailsSchema`. Fields come from the nested MELI payload shape:\n *   charge_info, currency_info, marketplace_info, sales_info[], items_info[]\n *\n * Positions 16-17 carry multiplicity signals so consumers know to check\n * details_sales/details_items secondary blocks when counts > 1.\n */\nfunction projectCompactRow(row: Record<string, unknown>): DetailRow {\n  const chargeInfo = (row.charge_info as Record<string, unknown>) ?? {};\n  const currencyInfo = (row.currency_info as Record<string, unknown>) ?? {};\n  const marketplaceInfo = (row.marketplace_info as Record<string, unknown>) ?? {};\n  const salesInfo = asArray<Record<string, unknown>>(row.sales_info);\n  const itemsInfo = asArray<Record<string, unknown>>(row.items_info);\n\n  const firstSale = salesInfo[0];\n  const firstItem = itemsInfo[0];\n\n  return [\n    normalizeString(chargeInfo.detail_id) || null,                    // 0:  detail_id\n    normalizeString(chargeInfo.detail_type) || null,                  // 1:  detail_type\n    normalizeString(chargeInfo.detail_sub_type) || null,              // 2:  detail_sub_type\n    normalizeString(chargeInfo.transaction_detail) || null,           // 3:  transaction_detail\n    toNumber(chargeInfo.detail_amount),                                      // 4:  detail_amount\n    normalizeString(currencyInfo.currency_id) || null,                // 5:  currency_id\n    normalizeString(marketplaceInfo.marketplace) || null,             // 6:  marketplace\n    normalizeString(chargeInfo.concept_type) || null,                 // 7:  concept_type\n    firstSale ? normalizeString(firstSale.order_id) || null : null,   // 8:  order_id\n    firstSale ? normalizeString(firstSale.operation_id) || null : null, // 9: operation_id\n    firstItem ? normalizeString(firstItem.item_id) || null : null,    // 10: item_id\n    firstItem ? normalizeString(firstItem.item_title) || null : null, // 11: item_title\n    firstSale ? normalizeString(firstSale.shipping_id) || null : null, // 12: shipping_id\n    firstSale ? normalizeString(firstSale.pack_id) || null : null,     // 13: pack_id\n    normalizeString(row.document_id) || null,                          // 14: document_id\n    normalizeString(chargeInfo.creation_date_time ?? row.creation_date_time) || null, // 15: creation_date_time\n    salesInfo.length,                                                        // 16: sales_info_count\n    itemsInfo.length,                                                        // 17: items_info_count\n  ];\n}\n\n// \u2500\u2500 Secondary compact schemas for sales_info / items_info multiplicity \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * Secondary compact block for sales_info entries.\n * Each row references `detail_id` so consumers can reconstruct the relationship.\n * Populated even when sales_info_count === 1 so the contract is stable.\n */\nexport const detailsSalesSchema = [\n  \"detail_id\",\n  \"order_id\",\n  \"operation_id\",\n  \"sale_date_time\",\n  \"payer_nickname\",\n  \"transaction_amount\",\n] as const;\n\ntype SalesRow = (string | number | null)[];\n\nfunction projectSalesRow(detailId: string | null, sale: Record<string, unknown>): SalesRow {\n  return [\n    detailId,                                                               // 0: detail_id\n    normalizeString(sale.order_id) || null,                           // 1: order_id\n    normalizeString(sale.operation_id) || null,                       // 2: operation_id\n    normalizeString(sale.sale_date_time) || null,                     // 3: sale_date_time\n    normalizeString(sale.payer_nickname) || null,                     // 4: payer_nickname\n    toNumber(sale.transaction_amount),                                       // 5: transaction_amount\n  ];\n}\n\n/**\n * Secondary compact block for items_info entries.\n * Each row references `detail_id` so consumers can reconstruct the relationship.\n */\nexport const detailsItemsSchema = [\n  \"detail_id\",\n  \"item_id\",\n  \"item_title\",\n  \"item_amount\",\n  \"item_price\",\n  \"order_id\",\n] as const;\n\ntype ItemsRow = (string | number | null)[];\n\nfunction projectItemsRow(detailId: string | null, item: Record<string, unknown>): ItemsRow {\n  return [\n    detailId,                                                               // 0: detail_id\n    normalizeString(item.item_id) || null,                            // 1: item_id\n    normalizeString(item.item_title) || null,                         // 2: item_title\n    toNumber(item.item_amount),                                              // 3: item_amount\n    toNumber(item.item_price),                                               // 4: item_price\n    normalizeString(item.order_id) || null,                           // 5: order_id\n  ];\n}\n\n// \u2500\u2500 Aggregation helpers (internal \u2014 compute summary + diagnostics) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\ninterface CurrencyBucket {\n  charge_amount_total: number;\n  bonus_amount_total: number;\n  discount_amount_total: number;\n  net_effect_total: number;\n}\n\nfunction emptyCurrencyBucket(): CurrencyBucket {\n  return {\n    charge_amount_total: 0,\n    bonus_amount_total: 0,\n    discount_amount_total: 0,\n    net_effect_total: 0,\n  };\n}\n\n/**\n * Determine if a billing detail is a charge, bonus, or discount based on\n * detail_sub_type prefix and text heuristics (same logic as before, internal only).\n */\nfunction classifyChargeType(row: Record<string, unknown>): \"charge\" | \"bonus\" | \"discount\" {\n  const chargeInfo = (row.charge_info as Record<string, unknown>) ?? {};\n  const detailSubType = normalizeString(chargeInfo.detail_sub_type, \"\").trim().toUpperCase();\n  const transactionDetail = normalizeString(chargeInfo.transaction_detail, \"\").toLowerCase().trim();\n  const conceptType = normalizeString(chargeInfo.concept_type, \"\").toLowerCase().trim();\n\n  // B* codes are bonuses/annulments\n  if (detailSubType.startsWith(\"B\") ||\n      detailSubType.toLowerCase().includes(\"bonus\") ||\n      detailSubType.toLowerCase().includes(\"bonificacion\") ||\n      detailSubType.toLowerCase().includes(\"bonificaci\u00F3n\") ||\n      transactionDetail.includes(\"anulaci\u00F3n\") ||\n      transactionDetail.includes(\"anulacion\") ||\n      transactionDetail.includes(\"bonus\") ||\n      transactionDetail.includes(\"bonificaci\u00F3n\") ||\n      conceptType.includes(\"bonus\") ||\n      conceptType.includes(\"bonificaci\u00F3n\")) {\n    return \"bonus\";\n  }\n\n  // D* codes are discounts\n  if (detailSubType.startsWith(\"D\") ||\n      detailSubType.toLowerCase().includes(\"discount\") ||\n      detailSubType.toLowerCase().includes(\"descuento\") ||\n      detailSubType.toLowerCase().includes(\"adjustment\") ||\n      transactionDetail.includes(\"descuento\") ||\n      transactionDetail.includes(\"discount\") ||\n      transactionDetail.includes(\"ajuste\") ||\n      conceptType.includes(\"discount\") ||\n      conceptType.includes(\"descuento\")) {\n    return \"discount\";\n  }\n\n  return \"charge\";\n}\n\ninterface AggregatedResult {\n  compactRows: DetailRow[];\n  currencyTotals: Record<string, CurrencyBucket>;\n  detailCount: number;\n  orderCountDetected: number;\n  itemCountDetected: number;\n  detailSubTypesObserved: Set<string>;\n  marketplacesObserved: Set<string>;\n  conceptTypesObserved: Set<string>;\n}\n\nfunction aggregateRows(rows: Record<string, unknown>[]): AggregatedResult {\n  const currencyTotals: Record<string, CurrencyBucket> = {};\n  const orderIds = new Set<string>();\n  const itemIds = new Set<string>();\n  const compactRows: DetailRow[] = [];\n  const detailSubTypesObserved = new Set<string>();\n  const marketplacesObserved = new Set<string>();\n  const conceptTypesObserved = new Set<string>();\n\n  for (const row of rows) {\n    // Project compact row\n    compactRows.push(projectCompactRow(row));\n\n    // Real MELI payout: currency lives under currency_info.currency_id\n    const currencyInfo = row.currency_info as Record<string, unknown> | undefined;\n    const currency = normalizeString(\n      currencyInfo?.currency_id ?? row.currency_id ?? row.currency,\n      \"UNKNOWN\"\n    ).toUpperCase();\n    const bucket = currencyTotals[currency] ?? emptyCurrencyBucket();\n    currencyTotals[currency] = bucket;\n\n    const chargeInfo = (row.charge_info as Record<string, unknown>) ?? {};\n    const amount = toNumber(chargeInfo.detail_amount ?? chargeInfo.amount ?? 0);\n    const chargeType = classifyChargeType(row);\n\n    if (chargeType === \"bonus\") {\n      bucket.bonus_amount_total += amount;\n    } else if (chargeType === \"discount\") {\n      bucket.discount_amount_total += amount;\n    } else {\n      bucket.charge_amount_total += amount;\n    }\n\n    // \u2500\u2500 Diagnostics accumulation \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    const detailSubType = normalizeString(chargeInfo.detail_sub_type, \"\").trim();\n    if (detailSubType) detailSubTypesObserved.add(detailSubType);\n\n    const marketplaceInfo = row.marketplace_info as Record<string, unknown> | undefined;\n    const marketplace = normalizeString(marketplaceInfo?.marketplace, \"\").trim();\n    if (marketplace) marketplacesObserved.add(marketplace);\n\n    const conceptType = normalizeString(chargeInfo.concept_type, \"\").trim();\n    if (conceptType) conceptTypesObserved.add(conceptType);\n\n    // Detect order IDs from sales_info\n    const salesInfo = asArray<Record<string, unknown>>(row.sales_info);\n    for (const si of salesInfo) {\n      const oid = normalizeString(si.order_id);\n      if (oid) orderIds.add(oid);\n    }\n\n    // Detect item IDs from items_info\n    const itemsInfo = asArray<Record<string, unknown>>(row.items_info);\n    for (const ii of itemsInfo) {\n      const iid = normalizeString(ii.item_id);\n      if (iid) itemIds.add(iid);\n    }\n  }\n\n  // net_effect = charge + bonus + discount (algebraic sum of signed amounts)\n  for (const bucket of Object.values(currencyTotals)) {\n    bucket.net_effect_total = bucket.charge_amount_total + bucket.bonus_amount_total + bucket.discount_amount_total;\n  }\n\n  // Round all money values\n  for (const bucket of Object.values(currencyTotals)) {\n    bucket.charge_amount_total = roundMoney(bucket.charge_amount_total);\n    bucket.bonus_amount_total = roundMoney(bucket.bonus_amount_total);\n    bucket.discount_amount_total = roundMoney(bucket.discount_amount_total);\n    bucket.net_effect_total = roundMoney(bucket.net_effect_total);\n  }\n\n  return {\n    compactRows,\n    currencyTotals,\n    detailCount: rows.length,\n    orderCountDetected: orderIds.size,\n    itemCountDetected: itemIds.size,\n    detailSubTypesObserved,\n    marketplacesObserved,\n    conceptTypesObserved,\n  };\n}\n\n// \u2500\u2500 Scope resolution for \"all\" \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\u2500\n\nconst ALL_SCOPES: BillingProvisionScope[] = [\"ml\", \"mp\", \"flex\", \"full\"];\n\ninterface FetchParams {\n  periodKey: string;\n  documentType: \"BILL\" | \"CREDIT_NOTE\";\n  detailType?: string;\n  detailSubTypes?: string[];\n  excludeDetailSubTypes?: string[];\n  marketplaceType?: string;\n  orderIds?: string[];\n  itemIds?: string[];\n}\n\nasync function fetchScope(\n  profileId: string,\n  scope: BillingProvisionScope,\n  params: FetchParams,\n  fromId?: string | null\n): Promise<BillingProvisionFetchResult> {\n  return getMercadoLibreBillingProvisions(profileId, { scope, ...params, fromId });\n}\n\n// \u2500\u2500 Handler \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport async function meliGetBillingProvisionsSummaryHandler(\n  params: z.infer<typeof meliGetBillingProvisionsSummarySchema>\n) {\n  try {\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    const documentType = params.documentType ?? \"BILL\";\n\n    const fetchParams: FetchParams = {\n      periodKey: params.periodKey,\n      documentType,\n      detailType: params.detailType,\n      detailSubTypes: params.detailSubTypes,\n      excludeDetailSubTypes: params.excludeDetailSubTypes,\n      marketplaceType: params.marketplaceType,\n      orderIds: params.orderIds,\n      itemIds: params.itemIds,\n    };\n\n    // Determine scopes to fetch\n    const scopes: BillingProvisionScope[] =\n      params.scope === \"all\" ? ALL_SCOPES : [params.scope];\n\n    const fromIdByScope = params.fromIdByScope ?? {};\n\n    // Fetch all scopes in parallel\n    const scopeResults = await Promise.all(\n      scopes.map((scope) => fetchScope(profileId, scope, fetchParams, fromIdByScope[scope] ?? null))\n    );\n\n    // Aggregate across scopes\n    let totalRows = 0;\n    const globalOrderIds = new Set<string>();\n    const globalItemIds = new Set<string>();\n    const globalCompactRows: DetailRow[] = [];\n    const globalCurrencyTotals: Record<string, CurrencyBucket> = {};\n    const globalDetailSubTypes = new Set<string>();\n    const globalMarketplaces = new Set<string>();\n    const globalConceptTypes = new Set<string>();\n    const globalSalesRows: SalesRow[] = [];\n    const globalItemsRows: ItemsRow[] = [];\n\n    const coverageByScope: Record<string, unknown> = {};\n    const continuationByScope: Record<string, unknown> = {};\n    let totalSourcesCalled = 0;\n    let totalPagesRequested = 0;\n    let totalPagesSucceeded = 0;\n    let totalPagesFailed = 0;\n    let globalCoverageComplete = true;\n    let allFailures: Array<{ scope: string; page: number; from_id: string | null; message: string }> = [];\n\n    for (const result of scopeResults) {\n      const agg = aggregateRows(result.rows);\n\n      // Merge currency totals across scopes\n      for (const [currency, bucket] of Object.entries(agg.currencyTotals)) {\n        const global = globalCurrencyTotals[currency] ?? emptyCurrencyBucket();\n        globalCurrencyTotals[currency] = global;\n        global.charge_amount_total = roundMoney(global.charge_amount_total + bucket.charge_amount_total);\n        global.bonus_amount_total = roundMoney(global.bonus_amount_total + bucket.bonus_amount_total);\n        global.discount_amount_total = roundMoney(global.discount_amount_total + bucket.discount_amount_total);\n        global.net_effect_total = roundMoney(global.net_effect_total + bucket.net_effect_total);\n      }\n\n      globalCompactRows.push(...agg.compactRows);\n      totalRows += agg.detailCount;\n\n      // Global unique order/item counts + secondary multiplicity rows\n      for (const row of result.rows) {\n        const chargeInfo = (row.charge_info as Record<string, unknown>) ?? {};\n        const detailId = normalizeString(chargeInfo.detail_id) || null;\n\n        const salesInfo = asArray<Record<string, unknown>>(row.sales_info);\n        for (const si of salesInfo) {\n          const oid = normalizeString(si.order_id);\n          if (oid) globalOrderIds.add(oid);\n          globalSalesRows.push(projectSalesRow(detailId, si));\n        }\n        const itemsInfo = asArray<Record<string, unknown>>(row.items_info);\n        for (const ii of itemsInfo) {\n          const iid = normalizeString(ii.item_id);\n          if (iid) globalItemIds.add(iid);\n          globalItemsRows.push(projectItemsRow(detailId, ii));\n        }\n      }\n\n      // Merge diagnostics\n      for (const s of agg.detailSubTypesObserved) globalDetailSubTypes.add(s);\n      for (const m of agg.marketplacesObserved) globalMarketplaces.add(m);\n      for (const c of agg.conceptTypesObserved) globalConceptTypes.add(c);\n\n      // Per-scope coverage metadata\n      coverageByScope[result.scope] = {\n        coverage_complete: result.coverage_complete,\n        last_id_seen: result.last_id_seen,\n        pages_requested: result.pages_requested,\n        pages_succeeded: result.pages_succeeded,\n        pages_failed: result.pages_failed,\n        detail_count: agg.detailCount,\n      };\n\n      if (!result.coverage_complete && result.last_id_seen) {\n        continuationByScope[result.scope] = {\n          last_id: result.last_id_seen,\n          hint:\n            `Resume ${result.scope} scope with fromIdByScope: ` +\n            `{ \"${result.scope}\": \"${result.last_id_seen}\" }. ` +\n            `${result.pages_failed} page(s) failed.`,\n        };\n      }\n\n      // Metadata accumulation\n      totalSourcesCalled += 1;\n      totalPagesRequested += result.pages_requested;\n      totalPagesSucceeded += result.pages_succeeded;\n      totalPagesFailed += result.pages_failed;\n      if (!result.coverage_complete) globalCoverageComplete = false;\n\n      for (const f of result.failures) {\n        allFailures.push({ scope: result.scope, ...f });\n      }\n    }\n\n    // Build metadata block\n    const metadata: Record<string, unknown> = {\n      sources_called: totalSourcesCalled,\n      pages_requested: totalPagesRequested,\n      pages_succeeded: totalPagesSucceeded,\n      pages_failed: totalPagesFailed,\n      detail_count_total: totalRows,\n      coverage_complete: globalCoverageComplete,\n      coverage_by_scope: coverageByScope,\n    };\n\n    if (Object.keys(continuationByScope).length > 0) {\n      metadata.continuation_by_scope = continuationByScope;\n    }\n    if (allFailures.length > 0) {\n      metadata.failures = allFailures;\n    }\n\n    // Build diagnostics (simplified \u2014 observations only)\n    const diagnostics = {\n      detail_sub_types_observed: [...globalDetailSubTypes].sort(),\n      marketplaces_observed: [...globalMarketplaces].sort(),\n      concept_types_observed: [...globalConceptTypes].sort(),\n    };\n\n    // Build response in two phases: stripNulls for objects, then add back\n    // compact arrays and diagnostics intact (nulls/diagnostics are positional/always-visible).\n    const stripped = stripNulls({\n      profile_id: profileId,\n      period_key: params.periodKey,\n      scope: params.scope,\n      document_type: documentType,\n      metadata,\n      summary: {\n        detail_count: totalRows,\n        order_count_detected: globalOrderIds.size,\n        item_count_detected: globalItemIds.size,\n        currency_totals: globalCurrencyTotals,\n      },\n    }) as Record<string, unknown>;\n\n    // Always include details, details_schema, diagnostics, and secondary blocks.\n    // stripNulls would remove nulls from compact rows (breaking positional contract),\n    // empty diagnostic arrays, empty currency_totals, and empty secondary blocks\n    // (which must remain visible).\n    stripped.details_schema = detailsSchema;\n    stripped.details = globalCompactRows;\n    stripped.diagnostics = diagnostics;\n\n    // \u2500\u2500 Secondary multiplicity blocks (always present for contract stability) \u2500\u2500\n    stripped.details_sales_schema = detailsSalesSchema;\n    stripped.details_sales = globalSalesRows;\n    stripped.details_items_schema = detailsItemsSchema;\n    stripped.details_items = globalItemsRows;\n\n    // \u2500\u2500 Guarantee currency_totals survives stripNulls (empty {} gets stripped) \u2500\u2500\n    const summary = stripped.summary as Record<string, unknown>;\n    summary.currency_totals = globalCurrencyTotals;\n\n    return object(stripped);\n  } catch (err) {\n    return error(\n      formatMercadoLibreError(err, \"Failed to get MercadoLibre billing provisions summary\")\n    );\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/mercadolibre/get-order-details.js

@@ -3,7 +3,14 @@ import { z } from "zod";
 import { formatMercadoLibreError } from "../../services/mercadolibre/mercadolibre-api.js";
 import { getMercadoLibreOrder, getMercadoLibreOrderDetailsBatch } from "../../services/mercadolibre/mercadolibre-orders.js";
 import { stripNulls } from "../../utils/strip-payload.js";
-import { asArray, asRecord, compactDateTime, normalizeString, toNumber } from "./helpers.js";
+import {
+  asArray,
+  asRecord,
+  compactDateTime,
+  normalizeScalarString,
+  normalizeString,
+  toNumber
+} from "./helpers.js";
 import { resolveMercadoLibreProfileOrSelection } from "./profile-resolution.js";
 import { mercadolibreProfileIdSchemaField } from "./write-helpers.js";
 const MAX_ORDER_IDS = 50;
@@ -12,6 +19,7 @@ const meliGetOrderDetailsSchema = z.object({
   orderIds: z.array(z.string().trim().min(1).describe("MercadoLibre order id.")).min(1).max(MAX_ORDER_IDS).describe("One or more MercadoLibre order ids (up to 50).")
 });
 function formatOrder(order) {
+  const optionalMoney = (value) => value == null || value === "" ? void 0 : toNumber(value);
   return stripNulls({
     order_id: normalizeString(order.id),
     status: normalizeString(order.status),
@@ -22,7 +30,7 @@ function formatOrder(order) {
     total_amount: toNumber(order.total_amount),
     paid_amount: toNumber(order.paid_amount),
     shipping: stripNulls({
-      id: normalizeString(asRecord(order.shipping).id),
+      id: normalizeScalarString(asRecord(order.shipping).id),
       status: normalizeString(asRecord(order.shipping).status),
       substatus: normalizeString(asRecord(order.shipping).substatus),
       mode: normalizeString(asRecord(order.shipping).mode),
@@ -49,11 +57,17 @@ function formatOrder(order) {
     }),
     payments: asArray(order.payments).map(
       (payment) => stripNulls({
-        id: normalizeString(payment.id),
+        id: normalizeScalarString(payment.id),
         status: normalizeString(payment.status),
+        status_detail: normalizeString(payment.status_detail) || void 0,
+        payment_method_id: normalizeString(payment.payment_method_id) || void 0,
         payment_type: normalizeString(payment.payment_type),
         installments: toNumber(payment.installments),
-        total_paid_amount: toNumber(payment.total_paid_amount)
+        total_paid_amount: toNumber(payment.total_paid_amount),
+        transaction_amount: optionalMoney(payment.transaction_amount),
+        transaction_amount_refunded: optionalMoney(payment.transaction_amount_refunded),
+        shipping_cost: optionalMoney(payment.shipping_cost),
+        coupon_amount: optionalMoney(payment.coupon_amount)
       })
     ),
     tags: Array.isArray(order.tags) ? order.tags : void 0

package/dist/src/tools/mercadolibre/get-order-details.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/get-order-details.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatMercadoLibreError } from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport { getMercadoLibreOrder, getMercadoLibreOrderDetailsBatch } from \"../../services/mercadolibre/mercadolibre-orders.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { asArray, asRecord, compactDateTime, normalizeString, toNumber } from \"./helpers.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\n\nconst MAX_ORDER_IDS = 50;\n\nexport const meliGetOrderDetailsSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  orderIds: z\n    .array(z.string().trim().min(1).describe(\"MercadoLibre order id.\"))\n    .min(1)\n    .max(MAX_ORDER_IDS)\n    .describe(\"One or more MercadoLibre order ids (up to 50).\"),\n});\n\nfunction formatOrder(order: Record<string, unknown>) {\n  return stripNulls({\n    order_id: normalizeString(order.id),\n    status: normalizeString(order.status),\n    status_detail: normalizeString(order.status_detail),\n    date_created: compactDateTime(order.date_created),\n    date_closed: compactDateTime(order.date_closed),\n    currency_id: normalizeString(order.currency_id, \"UNKNOWN\"),\n    total_amount: toNumber(order.total_amount),\n    paid_amount: toNumber(order.paid_amount),\n    shipping: stripNulls({\n      id: normalizeString(asRecord(order.shipping).id),\n      status: normalizeString(asRecord(order.shipping).status),\n      substatus: normalizeString(asRecord(order.shipping).substatus),\n      mode: normalizeString(asRecord(order.shipping).mode),\n      logistic_type: normalizeString(asRecord(order.shipping).logistic_type),\n    }),\n    buyer: stripNulls({\n      id: normalizeString(asRecord(order.buyer).id),\n      nickname: normalizeString(asRecord(order.buyer).nickname),\n    }),\n    seller: stripNulls({\n      id: normalizeString(asRecord(order.seller).id),\n      nickname: normalizeString(asRecord(order.seller).nickname),\n    }),\n    items: asArray<Record<string, unknown>>(order.order_items).map((entry) => {\n      const item = asRecord(entry.item);\n      return stripNulls({\n        item_id: normalizeString(item.id),\n        title: normalizeString(item.title),\n        variation_id: normalizeString(item.variation_id),\n        quantity: toNumber(entry.quantity),\n        unit_price: toNumber(entry.unit_price),\n        full_unit_price: toNumber(entry.full_unit_price),\n      });\n    }),\n    payments: asArray<Record<string, unknown>>(order.payments).map((payment) =>\n      stripNulls({\n        id: normalizeString(payment.id),\n        status: normalizeString(payment.status),\n        payment_type: normalizeString(payment.payment_type),\n        installments: toNumber(payment.installments),\n        total_paid_amount: toNumber(payment.total_paid_amount),\n      })\n    ),\n    tags: Array.isArray(order.tags) ? order.tags : undefined,\n  });\n}\n\nexport async function meliGetOrderDetailsHandler(\n  params: z.infer<typeof meliGetOrderDetailsSchema>\n) {\n  try {\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    const uniqueOrderIds = Array.from(new Set(params.orderIds));\n\n    if (uniqueOrderIds.length === 1) {\n      const order = await getMercadoLibreOrder(profileId, uniqueOrderIds[0]);\n      return object(\n        stripNulls({\n          metadata: {\n            profile_id: profileId,\n            requested: 1,\n            successful: 1,\n            failed: 0,\n          },\n          orders: [formatOrder(order)],\n        })\n      );\n    }\n\n    const batch = await getMercadoLibreOrderDetailsBatch(profileId, uniqueOrderIds, {\n      maxConcurrency: 10,\n      maxRetries: 2,\n    });\n\n    return object(\n      stripNulls({\n        metadata: {\n          profile_id: profileId,\n          requested: uniqueOrderIds.length,\n          successful: batch.successful.length,\n          failed: batch.failed.length,\n          has_failures: batch.failed.length > 0,\n        },\n        orders: batch.successful.map((entry) => formatOrder(entry.document)),\n        failures: batch.failed.map((failure) => ({\n          order_id: failure.id,\n          message: failure.message,\n          status_code: failure.statusCode,\n          attempts: failure.attempts,\n          retryable: failure.retryable,\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to fetch MercadoLibre order details\"));\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatMercadoLibreError } from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport { getMercadoLibreOrder, getMercadoLibreOrderDetailsBatch } from \"../../services/mercadolibre/mercadolibre-orders.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport {\n  asArray,\n  asRecord,\n  compactDateTime,\n  normalizeScalarString,\n  normalizeString,\n  toNumber,\n} from \"./helpers.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\n\nconst MAX_ORDER_IDS = 50;\n\nexport const meliGetOrderDetailsSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  orderIds: z\n    .array(z.string().trim().min(1).describe(\"MercadoLibre order id.\"))\n    .min(1)\n    .max(MAX_ORDER_IDS)\n    .describe(\"One or more MercadoLibre order ids (up to 50).\"),\n});\n\nfunction formatOrder(order: Record<string, unknown>) {\n  const optionalMoney = (value: unknown) => (value == null || value === \"\" ? undefined : toNumber(value));\n\n  return stripNulls({\n    order_id: normalizeString(order.id),\n    status: normalizeString(order.status),\n    status_detail: normalizeString(order.status_detail),\n    date_created: compactDateTime(order.date_created),\n    date_closed: compactDateTime(order.date_closed),\n    currency_id: normalizeString(order.currency_id, \"UNKNOWN\"),\n    total_amount: toNumber(order.total_amount),\n    paid_amount: toNumber(order.paid_amount),\n    shipping: stripNulls({\n      id: normalizeScalarString(asRecord(order.shipping).id),\n      status: normalizeString(asRecord(order.shipping).status),\n      substatus: normalizeString(asRecord(order.shipping).substatus),\n      mode: normalizeString(asRecord(order.shipping).mode),\n      logistic_type: normalizeString(asRecord(order.shipping).logistic_type),\n    }),\n    buyer: stripNulls({\n      id: normalizeString(asRecord(order.buyer).id),\n      nickname: normalizeString(asRecord(order.buyer).nickname),\n    }),\n    seller: stripNulls({\n      id: normalizeString(asRecord(order.seller).id),\n      nickname: normalizeString(asRecord(order.seller).nickname),\n    }),\n    items: asArray<Record<string, unknown>>(order.order_items).map((entry) => {\n      const item = asRecord(entry.item);\n      return stripNulls({\n        item_id: normalizeString(item.id),\n        title: normalizeString(item.title),\n        variation_id: normalizeString(item.variation_id),\n        quantity: toNumber(entry.quantity),\n        unit_price: toNumber(entry.unit_price),\n        full_unit_price: toNumber(entry.full_unit_price),\n      });\n    }),\n    payments: asArray<Record<string, unknown>>(order.payments).map((payment) =>\n      stripNulls({\n        id: normalizeScalarString(payment.id),\n        status: normalizeString(payment.status),\n        status_detail: normalizeString(payment.status_detail) || undefined,\n        payment_method_id: normalizeString(payment.payment_method_id) || undefined,\n        payment_type: normalizeString(payment.payment_type),\n        installments: toNumber(payment.installments),\n        total_paid_amount: toNumber(payment.total_paid_amount),\n        transaction_amount: optionalMoney(payment.transaction_amount),\n        transaction_amount_refunded: optionalMoney(payment.transaction_amount_refunded),\n        shipping_cost: optionalMoney(payment.shipping_cost),\n        coupon_amount: optionalMoney(payment.coupon_amount),\n      })\n    ),\n    tags: Array.isArray(order.tags) ? order.tags : undefined,\n  });\n}\n\nexport async function meliGetOrderDetailsHandler(\n  params: z.infer<typeof meliGetOrderDetailsSchema>\n) {\n  try {\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    const uniqueOrderIds = Array.from(new Set(params.orderIds));\n\n    if (uniqueOrderIds.length === 1) {\n      const order = await getMercadoLibreOrder(profileId, uniqueOrderIds[0]);\n      return object(\n        stripNulls({\n          metadata: {\n            profile_id: profileId,\n            requested: 1,\n            successful: 1,\n            failed: 0,\n          },\n          orders: [formatOrder(order)],\n        })\n      );\n    }\n\n    const batch = await getMercadoLibreOrderDetailsBatch(profileId, uniqueOrderIds, {\n      maxConcurrency: 10,\n      maxRetries: 2,\n    });\n\n    return object(\n      stripNulls({\n        metadata: {\n          profile_id: profileId,\n          requested: uniqueOrderIds.length,\n          successful: batch.successful.length,\n          failed: batch.failed.length,\n          has_failures: batch.failed.length > 0,\n        },\n        orders: batch.successful.map((entry) => formatOrder(entry.document)),\n        failures: batch.failed.map((failure) => ({\n          order_id: failure.id,\n          message: failure.message,\n          status_code: failure.statusCode,\n          attempts: failure.attempts,\n          retryable: failure.retryable,\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to fetch MercadoLibre order details\"));\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,+BAA+B;AACxC,SAAS,sBAAsB,wCAAwC;AACvE,SAAS,kBAAkB;AAC3B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,6CAA6C;AACtD,SAAS,wCAAwC;AAEjD,MAAM,gBAAgB;AAEf,MAAM,4BAA4B,EAAE,OAAO;AAAA,EAChD,WAAW;AAAA,EACX,UAAU,EACP,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,wBAAwB,CAAC,EACjE,IAAI,CAAC,EACL,IAAI,aAAa,EACjB,SAAS,gDAAgD;AAC9D,CAAC;AAED,SAAS,YAAY,OAAgC;AACnD,QAAM,gBAAgB,CAAC,UAAoB,SAAS,QAAQ,UAAU,KAAK,SAAY,SAAS,KAAK;AAErG,SAAO,WAAW;AAAA,IAChB,UAAU,gBAAgB,MAAM,EAAE;AAAA,IAClC,QAAQ,gBAAgB,MAAM,MAAM;AAAA,IACpC,eAAe,gBAAgB,MAAM,aAAa;AAAA,IAClD,cAAc,gBAAgB,MAAM,YAAY;AAAA,IAChD,aAAa,gBAAgB,MAAM,WAAW;AAAA,IAC9C,aAAa,gBAAgB,MAAM,aAAa,SAAS;AAAA,IACzD,cAAc,SAAS,MAAM,YAAY;AAAA,IACzC,aAAa,SAAS,MAAM,WAAW;AAAA,IACvC,UAAU,WAAW;AAAA,MACnB,IAAI,sBAAsB,SAAS,MAAM,QAAQ,EAAE,EAAE;AAAA,MACrD,QAAQ,gBAAgB,SAAS,MAAM,QAAQ,EAAE,MAAM;AAAA,MACvD,WAAW,gBAAgB,SAAS,MAAM,QAAQ,EAAE,SAAS;AAAA,MAC7D,MAAM,gBAAgB,SAAS,MAAM,QAAQ,EAAE,IAAI;AAAA,MACnD,eAAe,gBAAgB,SAAS,MAAM,QAAQ,EAAE,aAAa;AAAA,IACvE,CAAC;AAAA,IACD,OAAO,WAAW;AAAA,MAChB,IAAI,gBAAgB,SAAS,MAAM,KAAK,EAAE,EAAE;AAAA,MAC5C,UAAU,gBAAgB,SAAS,MAAM,KAAK,EAAE,QAAQ;AAAA,IAC1D,CAAC;AAAA,IACD,QAAQ,WAAW;AAAA,MACjB,IAAI,gBAAgB,SAAS,MAAM,MAAM,EAAE,EAAE;AAAA,MAC7C,UAAU,gBAAgB,SAAS,MAAM,MAAM,EAAE,QAAQ;AAAA,IAC3D,CAAC;AAAA,IACD,OAAO,QAAiC,MAAM,WAAW,EAAE,IAAI,CAAC,UAAU;AACxE,YAAM,OAAO,SAAS,MAAM,IAAI;AAChC,aAAO,WAAW;AAAA,QAChB,SAAS,gBAAgB,KAAK,EAAE;AAAA,QAChC,OAAO,gBAAgB,KAAK,KAAK;AAAA,QACjC,cAAc,gBAAgB,KAAK,YAAY;AAAA,QAC/C,UAAU,SAAS,MAAM,QAAQ;AAAA,QACjC,YAAY,SAAS,MAAM,UAAU;AAAA,QACrC,iBAAiB,SAAS,MAAM,eAAe;AAAA,MACjD,CAAC;AAAA,IACH,CAAC;AAAA,IACD,UAAU,QAAiC,MAAM,QAAQ,EAAE;AAAA,MAAI,CAAC,YAC9D,WAAW;AAAA,QACT,IAAI,sBAAsB,QAAQ,EAAE;AAAA,QACpC,QAAQ,gBAAgB,QAAQ,MAAM;AAAA,QACtC,eAAe,gBAAgB,QAAQ,aAAa,KAAK;AAAA,QACzD,mBAAmB,gBAAgB,QAAQ,iBAAiB,KAAK;AAAA,QACjE,cAAc,gBAAgB,QAAQ,YAAY;AAAA,QAClD,cAAc,SAAS,QAAQ,YAAY;AAAA,QAC3C,mBAAmB,SAAS,QAAQ,iBAAiB;AAAA,QACrD,oBAAoB,cAAc,QAAQ,kBAAkB;AAAA,QAC5D,6BAA6B,cAAc,QAAQ,2BAA2B;AAAA,QAC9E,eAAe,cAAc,QAAQ,aAAa;AAAA,QAClD,eAAe,cAAc,QAAQ,aAAa;AAAA,MACpD,CAAC;AAAA,IACH;AAAA,IACA,MAAM,MAAM,QAAQ,MAAM,IAAI,IAAI,MAAM,OAAO;AAAA,EACjD,CAAC;AACH;AAEA,eAAsB,2BACpB,QACA;AACA,MAAI;AACF,UAAM,oBAAoB,MAAM,sCAAsC,OAAO,SAAS;AACtF,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,YAAY,kBAAkB,MAAM;AAC1C,UAAM,iBAAiB,MAAM,KAAK,IAAI,IAAI,OAAO,QAAQ,CAAC;AAE1D,QAAI,eAAe,WAAW,GAAG;AAC/B,YAAM,QAAQ,MAAM,qBAAqB,WAAW,eAAe,CAAC,CAAC;AACrE,aAAO;AAAA,QACL,WAAW;AAAA,UACT,UAAU;AAAA,YACR,YAAY;AAAA,YACZ,WAAW;AAAA,YACX,YAAY;AAAA,YACZ,QAAQ;AAAA,UACV;AAAA,UACA,QAAQ,CAAC,YAAY,KAAK,CAAC;AAAA,QAC7B,CAAC;AAAA,MACH;AAAA,IACF;AAEA,UAAM,QAAQ,MAAM,iCAAiC,WAAW,gBAAgB;AAAA,MAC9E,gBAAgB;AAAA,MAChB,YAAY;AAAA,IACd,CAAC;AAED,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,UACR,YAAY;AAAA,UACZ,WAAW,eAAe;AAAA,UAC1B,YAAY,MAAM,WAAW;AAAA,UAC7B,QAAQ,MAAM,OAAO;AAAA,UACrB,cAAc,MAAM,OAAO,SAAS;AAAA,QACtC;AAAA,QACA,QAAQ,MAAM,WAAW,IAAI,CAAC,UAAU,YAAY,MAAM,QAAQ,CAAC;AAAA,QACnE,UAAU,MAAM,OAAO,IAAI,CAAC,aAAa;AAAA,UACvC,UAAU,QAAQ;AAAA,UAClB,SAAS,QAAQ;AAAA,UACjB,aAAa,QAAQ;AAAA,UACrB,UAAU,QAAQ;AAAA,UAClB,WAAW,QAAQ;AAAA,QACrB,EAAE;AAAA,MACJ,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,wBAAwB,KAAK,4CAA4C,CAAC;AAAA,EACzF;AACF;",
   "names": []
 }