@yoryoboy/bi-mcp 1.16.0 → 1.17.0

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

@@ -0,0 +1,284 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import {
+  formatMercadoLibreError
+} from "../../services/mercadolibre/mercadolibre-api.js";
+import {
+  getMercadoLibreBillingProvisionsByOrder
+} from "../../services/mercadolibre/mercadolibre-billing.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+import {
+  asRecord,
+  normalizeScalarString,
+  toNumber
+} from "./helpers.js";
+import { resolveMercadoLibreProfileOrSelection } from "./profile-resolution.js";
+const meliGetBillingProvisionsByOrderSchema = z.object({
+  profileId: z.string().trim().min(1).describe("Explicit MercadoLibre profile id to use."),
+  orderIds: z.array(z.string().trim().min(1).describe("MercadoLibre order id.")).min(1).describe("One or more MercadoLibre order IDs to fetch billing provisions for.")
+});
+const ordersSchema = [
+  "order_id",
+  "sale_fee",
+  "payment_info_count",
+  "detail_count",
+  "document_id",
+  "currency_id",
+  "marketplace"
+];
+const paymentInfoSchema = [
+  "order_id",
+  "payment_id",
+  "payment_type",
+  "payment_method_id",
+  "installments",
+  "transaction_amount",
+  "total_paid_amount",
+  "shipping_cost",
+  "coupon_amount",
+  "status",
+  "status_detail"
+];
+const detailsSchema = [
+  "order_id",
+  "detail_id",
+  "detail_type",
+  "detail_sub_type",
+  "transaction_detail",
+  "detail_amount",
+  "currency_id",
+  "concept_type",
+  "operation_id",
+  "shipping_id",
+  "pack_id",
+  "inventory_id"
+];
+const detailsSalesSchema = [
+  "detail_id",
+  "order_id",
+  "operation_id",
+  "sale_date_time",
+  "payer_nickname",
+  "transaction_amount"
+];
+const detailsItemsSchema = [
+  "detail_id",
+  "item_id",
+  "item_title",
+  "item_amount",
+  "item_price",
+  "item_kit_id",
+  "store_id",
+  "order_id"
+];
+function asRecordArray(value) {
+  if (Array.isArray(value)) {
+    return value.filter(
+      (entry) => entry != null && typeof entry === "object" && !Array.isArray(entry)
+    );
+  }
+  const record = asRecord(value);
+  return Object.keys(record).length > 0 ? [record] : [];
+}
+function projectOrderRow(row) {
+  const paymentInfo = asRecordArray(row.payment_info);
+  const details = asRecordArray(row.details);
+  const firstDetail = details[0] ?? {};
+  const orderId = normalizeScalarString(row.order_id) || normalizeScalarString(asRecord(row.payment_info).order_id) || normalizeScalarString(firstDetail.order_id) || null;
+  const documentInfo = asRecord(row.document_info);
+  const currencyInfo = asRecord(row.currency_info);
+  const marketplaceInfo = asRecord(row.marketplace_info);
+  return [
+    orderId,
+    // 0: order_id
+    row.sale_fee == null ? null : toNumber(row.sale_fee),
+    // 1: sale_fee
+    paymentInfo.length,
+    // 2: payment_info_count
+    details.length,
+    // 3: detail_count
+    normalizeScalarString(documentInfo.document_id ?? row.document_id) || null,
+    // 4: document_id
+    normalizeScalarString(currencyInfo.currency_id ?? row.currency_id) || null,
+    // 5: currency_id
+    normalizeScalarString(marketplaceInfo.marketplace ?? row.marketplace) || null
+    // 6: marketplace
+  ];
+}
+function projectPaymentRow(orderId, payment) {
+  return [
+    orderId,
+    // 0: order_id
+    normalizeScalarString(payment.payment_id ?? payment.id) || null,
+    // 1: payment_id
+    normalizeScalarString(payment.payment_type) || null,
+    // 2: payment_type
+    normalizeScalarString(payment.payment_method_id) || null,
+    // 3: payment_method_id
+    toNumber(payment.installments),
+    // 4: installments
+    toNumber(payment.transaction_amount),
+    // 5: transaction_amount
+    toNumber(payment.total_paid_amount),
+    // 6: total_paid_amount
+    toNumber(payment.shipping_cost),
+    // 7: shipping_cost
+    toNumber(payment.coupon_amount),
+    // 8: coupon_amount
+    normalizeScalarString(payment.status) || null,
+    // 9: status
+    normalizeScalarString(payment.status_detail) || null
+    // 10: status_detail
+  ];
+}
+function projectDetailRow(orderId, detail) {
+  return [
+    orderId,
+    // 0: order_id
+    normalizeScalarString(detail.detail_id) || null,
+    // 1: detail_id
+    normalizeScalarString(detail.detail_type) || null,
+    // 2: detail_type
+    normalizeScalarString(detail.detail_sub_type) || null,
+    // 3: detail_sub_type
+    normalizeScalarString(detail.transaction_detail) || null,
+    // 4: transaction_detail
+    toNumber(detail.detail_amount),
+    // 5: detail_amount
+    normalizeScalarString(detail.currency_id) || null,
+    // 6: currency_id
+    normalizeScalarString(detail.concept_type) || null,
+    // 7: concept_type
+    normalizeScalarString(detail.operation_id) || null,
+    // 8: operation_id
+    normalizeScalarString(detail.shipping_id) || null,
+    // 9: shipping_id
+    normalizeScalarString(detail.pack_id) || null,
+    // 10: pack_id
+    normalizeScalarString(detail.inventory_id) || null
+    // 11: inventory_id
+  ];
+}
+function projectSalesRow(detailId, sale) {
+  return [
+    detailId,
+    // 0: detail_id
+    normalizeScalarString(sale.order_id) || null,
+    // 1: order_id
+    normalizeScalarString(sale.operation_id) || null,
+    // 2: operation_id
+    normalizeScalarString(sale.sale_date_time) || null,
+    // 3: sale_date_time
+    normalizeScalarString(sale.payer_nickname) || null,
+    // 4: payer_nickname
+    toNumber(sale.transaction_amount)
+    // 5: transaction_amount
+  ];
+}
+function projectItemsRow(detailId, item) {
+  return [
+    detailId,
+    // 0: detail_id
+    normalizeScalarString(item.item_id) || null,
+    // 1: item_id
+    normalizeScalarString(item.item_title) || null,
+    // 2: item_title
+    toNumber(item.item_amount),
+    // 3: item_amount
+    toNumber(item.item_price),
+    // 4: item_price
+    normalizeScalarString(item.item_kit_id) || null,
+    // 5: item_kit_id
+    normalizeScalarString(item.store_id) || null,
+    // 6: store_id
+    normalizeScalarString(item.order_id) || null
+    // 7: order_id
+  ];
+}
+async function meliGetBillingProvisionsByOrderHandler(params) {
+  try {
+    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const profileId = profileResolution.value.profileId;
+    const result = await getMercadoLibreBillingProvisionsByOrder(profileId, {
+      orderIds: params.orderIds
+    });
+    const orderRows = [];
+    const paymentRows = [];
+    const detailRows = [];
+    const salesRows = [];
+    const itemsRows = [];
+    for (const row of result.results) {
+      const orderId = normalizeScalarString(row.order_id) || null;
+      orderRows.push(projectOrderRow(row));
+      const paymentInfoRows = asRecordArray(row.payment_info);
+      for (const paymentInfo of paymentInfoRows) {
+        paymentRows.push(projectPaymentRow(orderId, paymentInfo));
+      }
+      const details = asRecordArray(row.details);
+      for (const detail of details) {
+        const detailId = normalizeScalarString(detail.detail_id) || null;
+        detailRows.push(projectDetailRow(orderId, detail));
+        const detailSales = asRecordArray(detail.sales_info ?? detail.details_sales);
+        for (const ds of detailSales) {
+          salesRows.push(projectSalesRow(detailId, ds));
+        }
+        const detailItems = asRecordArray(detail.items_info ?? detail.details_items);
+        for (const di of detailItems) {
+          itemsRows.push(projectItemsRow(detailId, di));
+        }
+      }
+    }
+    const saleFeeNote = "sale_fee may be null for some orders depending on how Mercado Libre settles the billing provision. Preserve it as nullable in downstream analysis.";
+    const metadata = {
+      order_ids_requested: result.order_ids_requested,
+      order_ids_found: result.order_ids_found,
+      order_ids_not_found: result.order_ids_not_found,
+      request_chunks_total: result.chunks_total,
+      request_chunks_succeeded: result.chunks_succeeded,
+      request_chunks_failed: result.chunks_failed,
+      coverage_complete: result.coverage_complete,
+      endpoint: "/billing/integration/group/ML/order/details",
+      sale_fee_note: saleFeeNote
+    };
+    if (result.failures.length > 0) {
+      metadata.failures = result.failures;
+    }
+    const stripped = stripNulls({
+      profile_id: profileId,
+      endpoint: "/billing/integration/group/ML/order/details",
+      metadata
+    });
+    stripped.orders_schema = ordersSchema;
+    stripped.orders = orderRows;
+    stripped.payment_info_schema = paymentInfoSchema;
+    stripped.payment_info = paymentRows;
+    stripped.details_schema = detailsSchema;
+    stripped.details = detailRows;
+    stripped.details_sales_schema = detailsSalesSchema;
+    stripped.details_sales = salesRows;
+    stripped.details_items_schema = detailsItemsSchema;
+    stripped.details_items = itemsRows;
+    const meta = stripped.metadata;
+    meta.order_ids_requested = result.order_ids_requested;
+    meta.order_ids_found = result.order_ids_found;
+    meta.order_ids_not_found = result.order_ids_not_found;
+    return object(stripped);
+  } catch (err) {
+    return error(
+      formatMercadoLibreError(err, "Failed to get MercadoLibre billing provisions by order")
+    );
+  }
+}
+export {
+  detailsItemsSchema,
+  detailsSalesSchema,
+  detailsSchema,
+  meliGetBillingProvisionsByOrderHandler,
+  meliGetBillingProvisionsByOrderSchema,
+  ordersSchema,
+  paymentInfoSchema
+};
+//# sourceMappingURL=get-billing-provisions-by-order.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/mercadolibre/get-billing-provisions-by-order.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  formatMercadoLibreError,\n} from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport {\n  getMercadoLibreBillingProvisionsByOrder,\n} from \"../../services/mercadolibre/mercadolibre-billing.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport {\n  asRecord,\n  normalizeScalarString,\n  toNumber,\n} from \"./helpers.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.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 meliGetBillingProvisionsByOrderSchema = z.object({\n  profileId: z.string().trim().min(1).describe(\"Explicit MercadoLibre profile id to use.\"),\n  orderIds: z\n    .array(z.string().trim().min(1).describe(\"MercadoLibre order id.\"))\n    .min(1)\n    .describe(\"One or more MercadoLibre order IDs to fetch billing provisions for.\"),\n});\n\n// \u2500\u2500 Compact schemas \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\n/** Top-level order info returned by the official by-order endpoint. */\nexport const ordersSchema = [\n  \"order_id\",\n  \"sale_fee\",\n  \"payment_info_count\",\n  \"detail_count\",\n  \"document_id\",\n  \"currency_id\",\n  \"marketplace\",\n] as const;\n\n/** Payment info per order. */\nexport const paymentInfoSchema = [\n  \"order_id\",\n  \"payment_id\",\n  \"payment_type\",\n  \"payment_method_id\",\n  \"installments\",\n  \"transaction_amount\",\n  \"total_paid_amount\",\n  \"shipping_cost\",\n  \"coupon_amount\",\n  \"status\",\n  \"status_detail\",\n] as const;\n\n/** Detail-level charges within an order. */\nexport const detailsSchema = [\n  \"order_id\",\n  \"detail_id\",\n  \"detail_type\",\n  \"detail_sub_type\",\n  \"transaction_detail\",\n  \"detail_amount\",\n  \"currency_id\",\n  \"concept_type\",\n  \"operation_id\",\n  \"shipping_id\",\n  \"pack_id\",\n  \"inventory_id\",\n] as const;\n\n/** Sales info within details (multiplicity). */\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\n/** Items info within details (multiplicity). */\nexport const detailsItemsSchema = [\n  \"detail_id\",\n  \"item_id\",\n  \"item_title\",\n  \"item_amount\",\n  \"item_price\",\n  \"item_kit_id\",\n  \"store_id\",\n  \"order_id\",\n] as const;\n\n// \u2500\u2500 Row projectors \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\ntype OrderRow = (string | number | null)[];\ntype PaymentRow = (string | number | null)[];\ntype DetailRow = (string | number | null)[];\ntype SalesRow = (string | number | null)[];\ntype ItemsRow = (string | number | null)[];\n\nfunction asRecordArray(value: unknown): Record<string, unknown>[] {\n  if (Array.isArray(value)) {\n    return value.filter(\n      (entry): entry is Record<string, unknown> =>\n        entry != null && typeof entry === \"object\" && !Array.isArray(entry)\n    ) as Record<string, unknown>[];\n  }\n\n  const record = asRecord(value);\n  return Object.keys(record).length > 0 ? [record] : [];\n}\n\nfunction projectOrderRow(row: Record<string, unknown>): OrderRow {\n  const paymentInfo = asRecordArray(row.payment_info);\n  const details = asRecordArray(row.details);\n  const firstDetail = details[0] ?? {};\n  const orderId =\n    normalizeScalarString(row.order_id) ||\n    normalizeScalarString(asRecord(row.payment_info).order_id) ||\n    normalizeScalarString(firstDetail.order_id) ||\n    null;\n  const documentInfo = asRecord(row.document_info);\n  const currencyInfo = asRecord(row.currency_info);\n  const marketplaceInfo = asRecord(row.marketplace_info);\n\n  return [\n    orderId,                                               // 0: order_id\n    row.sale_fee == null ? null : toNumber(row.sale_fee),  // 1: sale_fee\n    paymentInfo.length,                                    // 2: payment_info_count\n    details.length,                                        // 3: detail_count\n    normalizeScalarString(documentInfo.document_id ?? row.document_id) || null, // 4: document_id\n    normalizeScalarString(currencyInfo.currency_id ?? row.currency_id) || null,  // 5: currency_id\n    normalizeScalarString(marketplaceInfo.marketplace ?? row.marketplace) || null, // 6: marketplace\n  ];\n}\n\nfunction projectPaymentRow(orderId: string | null, payment: Record<string, unknown>): PaymentRow {\n  return [\n    orderId,                                                                       // 0: order_id\n    normalizeScalarString(payment.payment_id ?? payment.id) || null,               // 1: payment_id\n    normalizeScalarString(payment.payment_type) || null,                           // 2: payment_type\n    normalizeScalarString(payment.payment_method_id) || null,                      // 3: payment_method_id\n    toNumber(payment.installments),                                                // 4: installments\n    toNumber(payment.transaction_amount),                                          // 5: transaction_amount\n    toNumber(payment.total_paid_amount),                                           // 6: total_paid_amount\n    toNumber(payment.shipping_cost),                                               // 7: shipping_cost\n    toNumber(payment.coupon_amount),                                               // 8: coupon_amount\n    normalizeScalarString(payment.status) || null,                                 // 9: status\n    normalizeScalarString(payment.status_detail) || null,                          // 10: status_detail\n  ];\n}\n\nfunction projectDetailRow(orderId: string | null, detail: Record<string, unknown>): DetailRow {\n  return [\n    orderId,                                                                       // 0: order_id\n    normalizeScalarString(detail.detail_id) || null,                               // 1: detail_id\n    normalizeScalarString(detail.detail_type) || null,                             // 2: detail_type\n    normalizeScalarString(detail.detail_sub_type) || null,                         // 3: detail_sub_type\n    normalizeScalarString(detail.transaction_detail) || null,                      // 4: transaction_detail\n    toNumber(detail.detail_amount),                                                // 5: detail_amount\n    normalizeScalarString(detail.currency_id) || null,                             // 6: currency_id\n    normalizeScalarString(detail.concept_type) || null,                            // 7: concept_type\n    normalizeScalarString(detail.operation_id) || null,                            // 8: operation_id\n    normalizeScalarString(detail.shipping_id) || null,                             // 9: shipping_id\n    normalizeScalarString(detail.pack_id) || null,                                 // 10: pack_id\n    normalizeScalarString(detail.inventory_id) || null,                            // 11: inventory_id\n  ];\n}\n\nfunction projectSalesRow(detailId: string | null, sale: Record<string, unknown>): SalesRow {\n  return [\n    detailId,                                                                      // 0: detail_id\n    normalizeScalarString(sale.order_id) || null,                                  // 1: order_id\n    normalizeScalarString(sale.operation_id) || null,                              // 2: operation_id\n    normalizeScalarString(sale.sale_date_time) || null,                            // 3: sale_date_time\n    normalizeScalarString(sale.payer_nickname) || null,                            // 4: payer_nickname\n    toNumber(sale.transaction_amount),                                             // 5: transaction_amount\n  ];\n}\n\nfunction projectItemsRow(detailId: string | null, item: Record<string, unknown>): ItemsRow {\n  return [\n    detailId,                                                                      // 0: detail_id\n    normalizeScalarString(item.item_id) || null,                                   // 1: item_id\n    normalizeScalarString(item.item_title) || null,                                // 2: item_title\n    toNumber(item.item_amount),                                                    // 3: item_amount\n    toNumber(item.item_price),                                                     // 4: item_price\n    normalizeScalarString(item.item_kit_id) || null,                               // 5: item_kit_id\n    normalizeScalarString(item.store_id) || null,                                  // 6: store_id\n    normalizeScalarString(item.order_id) || null,                                  // 7: order_id\n  ];\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 meliGetBillingProvisionsByOrderHandler(\n  params: z.infer<typeof meliGetBillingProvisionsByOrderSchema>\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\n    const result = await getMercadoLibreBillingProvisionsByOrder(profileId, {\n      orderIds: params.orderIds,\n    });\n\n    // \u2500\u2500 Accumulate compact rows \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\n    const orderRows: OrderRow[] = [];\n    const paymentRows: PaymentRow[] = [];\n    const detailRows: DetailRow[] = [];\n    const salesRows: SalesRow[] = [];\n    const itemsRows: ItemsRow[] = [];\n\n    for (const row of result.results) {\n      const orderId = normalizeScalarString(row.order_id) || null;\n\n      // \u2500\u2500 Order row \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      orderRows.push(projectOrderRow(row));\n\n      // \u2500\u2500 Payment info rows \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      const paymentInfoRows = asRecordArray(row.payment_info);\n      for (const paymentInfo of paymentInfoRows) {\n        paymentRows.push(projectPaymentRow(orderId, paymentInfo));\n      }\n\n      // \u2500\u2500 Details + secondary blocks \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 details = asRecordArray(row.details);\n      for (const detail of details) {\n        const detailId = normalizeScalarString(detail.detail_id) || null;\n        detailRows.push(projectDetailRow(orderId, detail));\n\n        // \u2500\u2500 Details sales \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        const detailSales = asRecordArray(detail.sales_info ?? detail.details_sales);\n        for (const ds of detailSales) {\n          salesRows.push(projectSalesRow(detailId, ds));\n        }\n\n        // \u2500\u2500 Details items \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        const detailItems = asRecordArray(detail.items_info ?? detail.details_items);\n        for (const di of detailItems) {\n          itemsRows.push(projectItemsRow(detailId, di));\n        }\n      }\n    }\n\n    // \u2500\u2500 Build metadata \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\n    const saleFeeNote =\n      \"sale_fee may be null for some orders depending on how Mercado Libre settles the billing provision. \" +\n      \"Preserve it as nullable in downstream analysis.\";\n\n    const metadata: Record<string, unknown> = {\n      order_ids_requested: result.order_ids_requested,\n      order_ids_found: result.order_ids_found,\n      order_ids_not_found: result.order_ids_not_found,\n      request_chunks_total: result.chunks_total,\n      request_chunks_succeeded: result.chunks_succeeded,\n      request_chunks_failed: result.chunks_failed,\n      coverage_complete: result.coverage_complete,\n      endpoint: \"/billing/integration/group/ML/order/details\",\n      sale_fee_note: saleFeeNote,\n    };\n\n    if (result.failures.length > 0) {\n      metadata.failures = result.failures;\n    }\n\n    // Build response \u2014 stripNulls top-level, then add back compact arrays\n    const stripped = stripNulls({\n      profile_id: profileId,\n      endpoint: \"/billing/integration/group/ML/order/details\",\n      metadata,\n    }) as Record<string, unknown>;\n\n    // Always attach compact blocks (preserve positional contract)\n    stripped.orders_schema = ordersSchema;\n    stripped.orders = orderRows;\n    stripped.payment_info_schema = paymentInfoSchema;\n    stripped.payment_info = paymentRows;\n    stripped.details_schema = detailsSchema;\n    stripped.details = detailRows;\n    stripped.details_sales_schema = detailsSalesSchema;\n    stripped.details_sales = salesRows;\n    stripped.details_items_schema = detailsItemsSchema;\n    stripped.details_items = itemsRows;\n\n    // Ensure metadata arrays survive stripNulls\n    const meta = stripped.metadata as Record<string, unknown>;\n    meta.order_ids_requested = result.order_ids_requested;\n    meta.order_ids_found = result.order_ids_found;\n    meta.order_ids_not_found = result.order_ids_not_found;\n\n    return object(stripped);\n  } catch (err) {\n    return error(\n      formatMercadoLibreError(err, \"Failed to get MercadoLibre billing provisions by order\")\n    );\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/mercadolibre/get-full-storage-charges.js

@@ -0,0 +1,183 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import {
+  formatMercadoLibreError
+} from "../../services/mercadolibre/mercadolibre-api.js";
+import {
+  getMercadoLibreBillingProvisions
+} from "../../services/mercadolibre/mercadolibre-billing.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+import {
+  normalizeString,
+  toNumber
+} from "./helpers.js";
+import { resolveMercadoLibreProfileOrSelection } from "./profile-resolution.js";
+import { mercadolibreProfileIdSchemaField } from "./write-helpers.js";
+const meliGetFullStorageChargesSchema = 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)."),
+  documentType: z.enum(["BILL", "CREDIT_NOTE"]).default("BILL").optional().describe("Document type: BILL or CREDIT_NOTE. Defaults to BILL.")
+});
+const detailsFullSchema = [
+  // ── charge_info (12 columns) ──
+  "detail_id",
+  // 0
+  "creation_date_time",
+  // 1
+  "detail_type",
+  // 2
+  "detail_sub_type",
+  // 3
+  "concept_type",
+  // 4
+  "transaction_detail",
+  // 5
+  "detail_amount",
+  // 6
+  "payment_id",
+  // 7
+  "charge_bonified_id",
+  // 8
+  "legal_document_number",
+  // 9
+  "legal_document_status",
+  // 10
+  "legal_document_status_description",
+  // 11
+  // ── document_info (1 column) ──
+  "document_id",
+  // 12
+  // ── fulfillment_info (14 columns) ──
+  "ff_type",
+  // 13
+  "ff_amount",
+  // 14
+  "ff_amount_per_unit",
+  // 15
+  "ff_sku",
+  // 16
+  "ff_ean",
+  // 17
+  "ff_item_id",
+  // 18
+  "ff_item_title",
+  // 19
+  "ff_variation",
+  // 20
+  "ff_quantity",
+  // 21
+  "ff_item_quantity",
+  // 22
+  "ff_inventory_id",
+  // 23
+  "ff_warehouse_id",
+  // 24
+  "ff_source_id",
+  // 25
+  "ff_volume_type"
+  // 26
+];
+function projectFullDetailRow(row) {
+  const chargeInfo = row.charge_info ?? {};
+  const docInfo = row.document_info ?? {};
+  const ffInfo = row.fulfillment_info ?? {};
+  return [
+    // ── charge_info ──
+    normalizeString(chargeInfo.detail_id) || null,
+    normalizeString(chargeInfo.creation_date_time) || null,
+    normalizeString(chargeInfo.detail_type) || null,
+    normalizeString(chargeInfo.detail_sub_type) || null,
+    normalizeString(chargeInfo.concept_type) || null,
+    normalizeString(chargeInfo.transaction_detail) || null,
+    toNumber(chargeInfo.detail_amount),
+    normalizeString(chargeInfo.payment_id) || null,
+    normalizeString(chargeInfo.charge_bonified_id) || null,
+    normalizeString(chargeInfo.legal_document_number) || null,
+    normalizeString(chargeInfo.legal_document_status) || null,
+    normalizeString(chargeInfo.legal_document_status_description) || null,
+    // ── document_info ──
+    normalizeString(docInfo.document_id) || null,
+    // ── fulfillment_info ──
+    normalizeString(ffInfo.type) || null,
+    toNumber(ffInfo.amount),
+    toNumber(ffInfo.amount_per_unit),
+    normalizeString(ffInfo.sku) || null,
+    normalizeString(ffInfo.ean) || null,
+    normalizeString(ffInfo.item_id) || null,
+    normalizeString(ffInfo.item_title) || null,
+    normalizeString(ffInfo.variation) || null,
+    toNumber(ffInfo.quantity),
+    toNumber(ffInfo.item_quantity),
+    normalizeString(ffInfo.inventory_id) || null,
+    normalizeString(ffInfo.warehouse_id) || null,
+    normalizeString(ffInfo.source_id) || null,
+    normalizeString(ffInfo.volume_type) || null
+  ];
+}
+const RATE_LIMIT_NOTE = "MELI billing Full endpoint has a rate limit of approximately 5 requests per minute. This tool fetches all pages with from_id cursor at limit=1000. If coverage is incomplete, use the continuation_from_id to resume via meli_get_billing_provisions_summary.";
+async function meliGetFullStorageChargesHandler(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 result = await getMercadoLibreBillingProvisions(profileId, {
+      periodKey: params.periodKey,
+      scope: "full",
+      documentType
+    });
+    const compactRows = [];
+    for (const row of result.rows) {
+      compactRows.push(projectFullDetailRow(row));
+    }
+    const metadata = {
+      total_reported: result.detail_count_total,
+      pages_requested: result.pages_requested,
+      pages_succeeded: result.pages_succeeded,
+      pages_failed: result.pages_failed,
+      coverage_complete: result.coverage_complete,
+      rate_limit_note: RATE_LIMIT_NOTE
+    };
+    if (!result.coverage_complete && result.last_id_seen) {
+      metadata.continuation_from_id = result.last_id_seen;
+    }
+    if (result.failures.length > 0) {
+      metadata.failures = result.failures;
+    }
+    const stripped = stripNulls({
+      profile_id: profileId,
+      period_key: params.periodKey,
+      scope: "full",
+      document_type: documentType,
+      metadata
+    });
+    stripped.details_schema = detailsFullSchema;
+    stripped.details = compactRows;
+    const meta = stripped.metadata;
+    meta.total_reported = result.detail_count_total;
+    meta.pages_requested = result.pages_requested;
+    meta.pages_succeeded = result.pages_succeeded;
+    meta.pages_failed = result.pages_failed;
+    meta.coverage_complete = result.coverage_complete;
+    meta.rate_limit_note = RATE_LIMIT_NOTE;
+    if (!result.coverage_complete && result.last_id_seen) {
+      meta.continuation_from_id = result.last_id_seen;
+    }
+    if (result.failures.length > 0) {
+      meta.failures = result.failures;
+    }
+    return object(stripped);
+  } catch (err) {
+    return error(
+      formatMercadoLibreError(err, "Failed to get MercadoLibre Full storage charges")
+    );
+  }
+}
+export {
+  detailsFullSchema,
+  meliGetFullStorageChargesHandler,
+  meliGetFullStorageChargesSchema
+};
+//# sourceMappingURL=get-full-storage-charges.js.map

package/dist/src/tools/mercadolibre/get-full-storage-charges.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/mercadolibre/get-full-storage-charges.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  formatMercadoLibreError,\n} from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport {\n  getMercadoLibreBillingProvisions,\n} from \"../../services/mercadolibre/mercadolibre-billing.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport {\n  normalizeString,\n  toNumber,\n} 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 meliGetFullStorageChargesSchema = 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  documentType: z\n    .enum([\"BILL\", \"CREDIT_NOTE\"])\n    .default(\"BILL\")\n    .optional()\n    .describe(\"Document type: BILL or CREDIT_NOTE. Defaults to BILL.\"),\n});\n\n// \u2500\u2500 Compact schema for Full storage charges \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//\n// The Full endpoint returns a different payload shape from standard billing\n// provisions: charge_info, fulfillment_info, document_info\n// (no sales_info, items_info, currency_info, marketplace_info).\n//\n// Column order is stable and positional \u2014 consumers reconstruct rows from\n// details_schema + details arrays.\n\nexport const detailsFullSchema = [\n  // \u2500\u2500 charge_info (12 columns) \u2500\u2500\n  \"detail_id\",                             // 0\n  \"creation_date_time\",                    // 1\n  \"detail_type\",                           // 2\n  \"detail_sub_type\",                       // 3\n  \"concept_type\",                          // 4\n  \"transaction_detail\",                    // 5\n  \"detail_amount\",                         // 6\n  \"payment_id\",                            // 7\n  \"charge_bonified_id\",                    // 8\n  \"legal_document_number\",                 // 9\n  \"legal_document_status\",                 // 10\n  \"legal_document_status_description\",     // 11\n  // \u2500\u2500 document_info (1 column) \u2500\u2500\n  \"document_id\",                           // 12\n  // \u2500\u2500 fulfillment_info (14 columns) \u2500\u2500\n  \"ff_type\",                               // 13\n  \"ff_amount\",                             // 14\n  \"ff_amount_per_unit\",                    // 15\n  \"ff_sku\",                                // 16\n  \"ff_ean\",                                // 17\n  \"ff_item_id\",                            // 18\n  \"ff_item_title\",                         // 19\n  \"ff_variation\",                          // 20\n  \"ff_quantity\",                           // 21\n  \"ff_item_quantity\",                      // 22\n  \"ff_inventory_id\",                       // 23\n  \"ff_warehouse_id\",                       // 24\n  \"ff_source_id\",                          // 25\n  \"ff_volume_type\",                        // 26\n] as const;\n\ntype FullDetailRow = (string | number | null)[];\n\n/**\n * Project a raw MELI Full billing detail row into a positional compact array.\n * The order matches `detailsFullSchema`.\n *\n * Fields come from:\n *   - charge_info: detail_id, creation_date_time, detail_type, detail_sub_type,\n *     concept_type, transaction_detail, detail_amount, payment_id,\n *     charge_bonified_id, legal_document_number, legal_document_status,\n *     legal_document_status_description\n *   - document_info: document_id\n *   - fulfillment_info: type, amount, amount_per_unit, sku, ean, item_id,\n *     item_title, variation, quantity, item_quantity, inventory_id,\n *     warehouse_id, source_id, volume_type\n */\nfunction projectFullDetailRow(row: Record<string, unknown>): FullDetailRow {\n  const chargeInfo = (row.charge_info as Record<string, unknown>) ?? {};\n  const docInfo = (row.document_info as Record<string, unknown>) ?? {};\n  const ffInfo = (row.fulfillment_info as Record<string, unknown>) ?? {};\n\n  return [\n    // \u2500\u2500 charge_info \u2500\u2500\n    normalizeString(chargeInfo.detail_id) || null,\n    normalizeString(chargeInfo.creation_date_time) || null,\n    normalizeString(chargeInfo.detail_type) || null,\n    normalizeString(chargeInfo.detail_sub_type) || null,\n    normalizeString(chargeInfo.concept_type) || null,\n    normalizeString(chargeInfo.transaction_detail) || null,\n    toNumber(chargeInfo.detail_amount),\n    normalizeString(chargeInfo.payment_id) || null,\n    normalizeString(chargeInfo.charge_bonified_id) || null,\n    normalizeString(chargeInfo.legal_document_number) || null,\n    normalizeString(chargeInfo.legal_document_status) || null,\n    normalizeString(chargeInfo.legal_document_status_description) || null,\n    // \u2500\u2500 document_info \u2500\u2500\n    normalizeString(docInfo.document_id) || null,\n    // \u2500\u2500 fulfillment_info \u2500\u2500\n    normalizeString(ffInfo.type) || null,\n    toNumber(ffInfo.amount),\n    toNumber(ffInfo.amount_per_unit),\n    normalizeString(ffInfo.sku) || null,\n    normalizeString(ffInfo.ean) || null,\n    normalizeString(ffInfo.item_id) || null,\n    normalizeString(ffInfo.item_title) || null,\n    normalizeString(ffInfo.variation) || null,\n    toNumber(ffInfo.quantity),\n    toNumber(ffInfo.item_quantity),\n    normalizeString(ffInfo.inventory_id) || null,\n    normalizeString(ffInfo.warehouse_id) || null,\n    normalizeString(ffInfo.source_id) || null,\n    normalizeString(ffInfo.volume_type) || null,\n  ];\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\nconst RATE_LIMIT_NOTE =\n  \"MELI billing Full endpoint has a rate limit of approximately 5 requests per minute. \" +\n  \"This tool fetches all pages with from_id cursor at limit=1000. \" +\n  \"If coverage is incomplete, use the continuation_from_id to resume via meli_get_billing_provisions_summary.\";\n\nexport async function meliGetFullStorageChargesHandler(\n  params: z.infer<typeof meliGetFullStorageChargesSchema>\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 result = await getMercadoLibreBillingProvisions(profileId, {\n      periodKey: params.periodKey,\n      scope: \"full\",\n      documentType,\n    });\n\n    // \u2500\u2500 Project compact rows \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    const compactRows: FullDetailRow[] = [];\n    for (const row of result.rows) {\n      compactRows.push(projectFullDetailRow(row));\n    }\n\n    // \u2500\u2500 Build metadata \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    const metadata: Record<string, unknown> = {\n      total_reported: result.detail_count_total,\n      pages_requested: result.pages_requested,\n      pages_succeeded: result.pages_succeeded,\n      pages_failed: result.pages_failed,\n      coverage_complete: result.coverage_complete,\n      rate_limit_note: RATE_LIMIT_NOTE,\n    };\n\n    if (!result.coverage_complete && result.last_id_seen) {\n      metadata.continuation_from_id = result.last_id_seen;\n    }\n\n    if (result.failures.length > 0) {\n      metadata.failures = result.failures;\n    }\n\n    // \u2500\u2500 Build response \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    const stripped = stripNulls({\n      profile_id: profileId,\n      period_key: params.periodKey,\n      scope: \"full\",\n      document_type: documentType,\n      metadata,\n    }) as Record<string, unknown>;\n\n    // Always attach compact blocks (preserve positional contract)\n    stripped.details_schema = detailsFullSchema;\n    stripped.details = compactRows;\n\n    // Ensure metadata arrays survive stripNulls\n    const meta = stripped.metadata as Record<string, unknown>;\n    meta.total_reported = result.detail_count_total;\n    meta.pages_requested = result.pages_requested;\n    meta.pages_succeeded = result.pages_succeeded;\n    meta.pages_failed = result.pages_failed;\n    meta.coverage_complete = result.coverage_complete;\n    meta.rate_limit_note = RATE_LIMIT_NOTE;\n    if (!result.coverage_complete && result.last_id_seen) {\n      meta.continuation_from_id = result.last_id_seen;\n    }\n    if (result.failures.length > 0) {\n      meta.failures = result.failures;\n    }\n\n    return object(stripped);\n  } catch (err) {\n    return error(\n      formatMercadoLibreError(err, \"Failed to get MercadoLibre Full storage charges\")\n    );\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}