@yoryoboy/bi-mcp 1.6.0 → 1.8.0

package/dist/src/tools/mercadolibre/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/index.ts"],
-  "sourcesContent": ["export * from \"./get-account-context.js\";\r\nexport * from \"./validate-connection.js\";\r\nexport * from \"./get-orders-summary.js\";\r\nexport * from \"./get-order-details.js\";\r\nexport * from \"./get-sales-by-item.js\";\r\nexport * from \"./get-sales-trend.js\";\r\nexport * from \"./get-shipping-summary.js\";\r\nexport * from \"./get-item-visits.js\";\r\nexport * from \"./get-store-performance.js\";\r\nexport * from \"./search-items.js\";\r\nexport * from \"./get-item-details.js\";\r\nexport * from \"./get-listing-quality.js\";\r\nexport * from \"./predict-category.js\";\r\nexport * from \"./get-category-requirements.js\";\r\nexport * from \"./estimate-listing-fee.js\";\r\nexport * from \"./create-item.js\";\r\nexport * from \"./update-item-basic-fields.js\";\r\nexport * from \"./update-item-description.js\";\r\nexport * from \"./update-item-pictures.js\";\r\nexport * from \"./pause-or-reactivate-item.js\";\r\nexport * from \"./search-questions.js\";\r\nexport * from \"./answer-question.js\";\r\nexport * from \"./profile-resolution.js\";\r\n"],
-  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export * from \"./get-account-context.js\";\nexport * from \"./validate-connection.js\";\nexport * from \"./get-orders-summary.js\";\nexport * from \"./get-order-details.js\";\nexport * from \"./get-sales-by-item.js\";\nexport * from \"./get-sales-trend.js\";\nexport * from \"./get-shipping-summary.js\";\nexport * from \"./get-item-visits.js\";\nexport * from \"./get-store-performance.js\";\nexport * from \"./search-items.js\";\nexport * from \"./get-item-details.js\";\nexport * from \"./get-listing-quality.js\";\nexport * from \"./predict-category.js\";\nexport * from \"./get-category-requirements.js\";\nexport * from \"./estimate-listing-fee.js\";\nexport * from \"./create-item.js\";\nexport * from \"./update-item-basic-fields.js\";\nexport * from \"./update-item-description.js\";\nexport * from \"./update-item-pictures.js\";\nexport * from \"./pause-or-reactivate-item.js\";\nexport * from \"./search-questions.js\";\nexport * from \"./answer-question.js\";\nexport * from \"./profile-resolution.js\";\nexport * from \"./get-site-categories-and-listing-types.js\";\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/dist/src/tools/mercadolibre/pause-or-reactivate-item.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/pause-or-reactivate-item.ts"],
-  "sourcesContent": ["import { z } from \"zod\";\r\n\r\nimport {\r\n  getMercadoLibreItem,\r\n  updateMercadoLibreItem,\r\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\r\nimport {\r\n  buildMercadoLibreWriteSuccessResponse,\r\n  handleMercadoLibreWriteError,\r\n  mercadolibreProfileIdSchemaField,\r\n  resolveMercadoLibreWriteProfile,\r\n} from \"./write-helpers.js\";\r\n\r\nexport const meliPauseOrReactivateItemSchema = z.object({\r\n  profileId: mercadolibreProfileIdSchemaField,\r\n  itemId: z.string().trim().min(1).describe(\"MercadoLibre item id.\"),\r\n  status: z.enum([\"active\", \"paused\"]).describe(\"Target status for the item.\"),\r\n});\r\n\r\nexport async function meliPauseOrReactivateItemHandler(\r\n  params: z.infer<typeof meliPauseOrReactivateItemSchema>\r\n) {\r\n  try {\r\n    const profileResolution = await resolveMercadoLibreWriteProfile(params.profileId);\r\n    if (!profileResolution.ok) {\r\n      return profileResolution.response;\r\n    }\r\n\r\n    const profileId = profileResolution.value.profileId;\r\n    const before = await getMercadoLibreItem(profileId, params.itemId);\r\n    const after = await updateMercadoLibreItem(profileId, params.itemId, {\r\n      status: params.status,\r\n    });\r\n\r\n    return buildMercadoLibreWriteSuccessResponse({\r\n      profileId,\r\n      operation: \"pause_or_reactivate_item\",\r\n      resourceId: params.itemId,\r\n      message: `MercadoLibre item status changed to ${params.status}.`,\r\n      before,\r\n      after,\r\n    });\r\n  } catch (err) {\r\n    return handleMercadoLibreWriteError(err, `Failed to change status for ${params.itemId}`);\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  getMercadoLibreItem,\n  updateMercadoLibreItem,\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\nimport {\n  buildMercadoLibreWriteSuccessResponse,\n  handleMercadoLibreWriteError,\n  mercadolibreProfileIdSchemaField,\n  resolveMercadoLibreWriteProfile,\n} from \"./write-helpers.js\";\n\nexport const meliPauseOrReactivateItemSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  itemId: z.string().trim().min(1).describe(\"MercadoLibre item id.\"),\n  status: z.enum([\"active\", \"paused\"]).describe(\"Target status for the item.\"),\n});\n\nexport async function meliPauseOrReactivateItemHandler(\n  params: z.infer<typeof meliPauseOrReactivateItemSchema>\n) {\n  try {\n    const profileResolution = await resolveMercadoLibreWriteProfile(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    const before = await getMercadoLibreItem(profileId, params.itemId);\n    const after = await updateMercadoLibreItem(profileId, params.itemId, {\n      status: params.status,\n    });\n\n    return buildMercadoLibreWriteSuccessResponse({\n      profileId,\n      operation: \"pause_or_reactivate_item\",\n      resourceId: params.itemId,\n      message: `MercadoLibre item status changed to ${params.status}.`,\n      before,\n      after,\n    });\n  } catch (err) {\n    return handleMercadoLibreWriteError(err, `Failed to change status for ${params.itemId}`);\n  }\n}\n"],
   "mappings": "AAAA,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,kCAAkC,EAAE,OAAO;AAAA,EACtD,WAAW;AAAA,EACX,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,uBAAuB;AAAA,EACjE,QAAQ,EAAE,KAAK,CAAC,UAAU,QAAQ,CAAC,EAAE,SAAS,6BAA6B;AAC7E,CAAC;AAED,eAAsB,iCACpB,QACA;AACA,MAAI;AACF,UAAM,oBAAoB,MAAM,gCAAgC,OAAO,SAAS;AAChF,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,YAAY,kBAAkB,MAAM;AAC1C,UAAM,SAAS,MAAM,oBAAoB,WAAW,OAAO,MAAM;AACjE,UAAM,QAAQ,MAAM,uBAAuB,WAAW,OAAO,QAAQ;AAAA,MACnE,QAAQ,OAAO;AAAA,IACjB,CAAC;AAED,WAAO,sCAAsC;AAAA,MAC3C;AAAA,MACA,WAAW;AAAA,MACX,YAAY,OAAO;AAAA,MACnB,SAAS,uCAAuC,OAAO,MAAM;AAAA,MAC7D;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,6BAA6B,KAAK,+BAA+B,OAAO,MAAM,EAAE;AAAA,EACzF;AACF;",
   "names": []
 }

package/dist/src/tools/mercadolibre/predict-category.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/predict-category.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\r\nimport { z } from \"zod\";\r\n\r\nimport { formatMercadoLibreError } from \"../../services/mercadolibre/mercadolibre-api.js\";\r\nimport { searchMercadoLibreDomainDiscovery } from \"../../services/mercadolibre/mercadolibre-items.js\";\r\nimport { stripNulls } from \"../../utils/strip-payload.js\";\r\nimport { asArray, normalizeString, toNumber } from \"./helpers.js\";\r\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\r\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\r\n\r\nexport const meliPredictCategorySchema = z.object({\r\n  profileId: mercadolibreProfileIdSchemaField,\r\n  query: z.string().trim().min(2).describe(\"Search phrase describing the product to categorize.\"),\r\n  siteId: z.string().trim().min(3).optional().describe(\"MercadoLibre site id. Defaults to MLA.\"),\r\n  limit: z.number().int().min(1).max(8).optional().describe(\"Maximum candidate categories to return. Defaults to 5.\"),\r\n});\r\n\r\nexport async function meliPredictCategoryHandler(params: z.infer<typeof meliPredictCategorySchema>) {\r\n  try {\r\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\r\n    if (!profileResolution.ok) {\r\n      return profileResolution.response;\r\n    }\r\n\r\n    const candidates = await searchMercadoLibreDomainDiscovery(\r\n      profileResolution.value.profileId,\r\n      params.query,\r\n      params.limit ?? 5,\r\n      params.siteId ?? \"MLA\"\r\n    );\r\n\r\n    return object(\r\n      stripNulls({\r\n        profile_id: profileResolution.value.profileId,\r\n        query: params.query,\r\n        site_id: params.siteId ?? \"MLA\",\r\n        candidates: asArray<Record<string, unknown>>(candidates).map((candidate) => ({\r\n          category_id: normalizeString(candidate.category_id),\r\n          category_name: normalizeString(candidate.category_name),\r\n          domain_id: normalizeString(candidate.domain_id),\r\n          domain_name: normalizeString(candidate.domain_name),\r\n          attributes_matched: toNumber(candidate.attributes_matched),\r\n        })),\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(formatMercadoLibreError(err, \"Failed to predict MercadoLibre category\"));\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatMercadoLibreError } from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport { searchMercadoLibreDomainDiscovery } from \"../../services/mercadolibre/mercadolibre-items.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { asArray, normalizeString, toNumber } from \"./helpers.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\n\nexport const meliPredictCategorySchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  query: z.string().trim().min(2).describe(\"Search phrase describing the product to categorize.\"),\n  siteId: z.string().trim().min(3).optional().describe(\"MercadoLibre site id. Defaults to MLA.\"),\n  limit: z.number().int().min(1).max(8).optional().describe(\"Maximum candidate categories to return. Defaults to 5.\"),\n});\n\nexport async function meliPredictCategoryHandler(params: z.infer<typeof meliPredictCategorySchema>) {\n  try {\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const candidates = await searchMercadoLibreDomainDiscovery(\n      profileResolution.value.profileId,\n      params.query,\n      params.limit ?? 5,\n      params.siteId ?? \"MLA\"\n    );\n\n    return object(\n      stripNulls({\n        profile_id: profileResolution.value.profileId,\n        query: params.query,\n        site_id: params.siteId ?? \"MLA\",\n        candidates: asArray<Record<string, unknown>>(candidates).map((candidate) => ({\n          category_id: normalizeString(candidate.category_id),\n          category_name: normalizeString(candidate.category_name),\n          domain_id: normalizeString(candidate.domain_id),\n          domain_name: normalizeString(candidate.domain_name),\n          attributes_matched: toNumber(candidate.attributes_matched),\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to predict MercadoLibre category\"));\n  }\n}\n"],
   "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,+BAA+B;AACxC,SAAS,yCAAyC;AAClD,SAAS,kBAAkB;AAC3B,SAAS,SAAS,iBAAiB,gBAAgB;AACnD,SAAS,6CAA6C;AACtD,SAAS,wCAAwC;AAE1C,MAAM,4BAA4B,EAAE,OAAO;AAAA,EAChD,WAAW;AAAA,EACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,qDAAqD;AAAA,EAC9F,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,wCAAwC;AAAA,EAC7F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,wDAAwD;AACpH,CAAC;AAED,eAAsB,2BAA2B,QAAmD;AAClG,MAAI;AACF,UAAM,oBAAoB,MAAM,sCAAsC,OAAO,SAAS;AACtF,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,aAAa,MAAM;AAAA,MACvB,kBAAkB,MAAM;AAAA,MACxB,OAAO;AAAA,MACP,OAAO,SAAS;AAAA,MAChB,OAAO,UAAU;AAAA,IACnB;AAEA,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY,kBAAkB,MAAM;AAAA,QACpC,OAAO,OAAO;AAAA,QACd,SAAS,OAAO,UAAU;AAAA,QAC1B,YAAY,QAAiC,UAAU,EAAE,IAAI,CAAC,eAAe;AAAA,UAC3E,aAAa,gBAAgB,UAAU,WAAW;AAAA,UAClD,eAAe,gBAAgB,UAAU,aAAa;AAAA,UACtD,WAAW,gBAAgB,UAAU,SAAS;AAAA,UAC9C,aAAa,gBAAgB,UAAU,WAAW;AAAA,UAClD,oBAAoB,SAAS,UAAU,kBAAkB;AAAA,QAC3D,EAAE;AAAA,MACJ,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,wBAAwB,KAAK,yCAAyC,CAAC;AAAA,EACtF;AACF;",
   "names": []
 }

package/dist/src/tools/mercadolibre/profile-resolution.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/profile-resolution.ts"],
-  "sourcesContent": ["import { object } from \"mcp-use/server\";\r\n\r\nimport { getProfile, listProfiles } from \"../../config/profile-store.js\";\r\n\r\nexport type MercadoLibreProfileSelectionReason =\r\n  | \"missing_profile\"\r\n  | \"profile_not_found\"\r\n  | \"profile_inactive\";\r\n\r\nexport interface ResolvedMercadoLibreProfile {\r\n  profileId: string;\r\n}\r\n\r\nfunction buildSelectionMessage(\r\n  reason: MercadoLibreProfileSelectionReason,\r\n  profileId?: string\r\n): string {\r\n  switch (reason) {\r\n    case \"missing_profile\":\r\n      return \"MercadoLibre requiere seleccion explicita de profileId. Reenviar la misma tool con uno de los perfiles activos disponibles.\";\r\n    case \"profile_not_found\":\r\n      return `El profileId \"${profileId}\" no existe. Reenviar la misma tool con uno de los perfiles activos disponibles.`;\r\n    case \"profile_inactive\":\r\n      return `El profileId \"${profileId}\" esta inactivo. Reenviar la misma tool con uno de los perfiles activos disponibles.`;\r\n  }\r\n}\r\n\r\nasync function buildSelectionResponse(\r\n  reason: MercadoLibreProfileSelectionReason,\r\n  profileId?: string\r\n) {\r\n  const profiles = await listProfiles({ activeOnly: true });\r\n  return object({\r\n    selection_required: true,\r\n    reason,\r\n    message: buildSelectionMessage(reason, profileId),\r\n    available_profiles: profiles.map((profile) => ({\r\n      profile_id: profile.id,\r\n      name: profile.name,\r\n    })),\r\n  });\r\n}\r\n\r\nexport async function resolveMercadoLibreProfileOrSelection(\r\n  profileId?: string\r\n): Promise<\r\n  | { ok: true; value: ResolvedMercadoLibreProfile }\r\n  | { ok: false; response: ReturnType<typeof object<Record<string, unknown>>> }\r\n> {\r\n  const requestedProfileId = profileId?.trim();\r\n\r\n  if (!requestedProfileId) {\r\n    return {\r\n      ok: false,\r\n      response: await buildSelectionResponse(\"missing_profile\"),\r\n    };\r\n  }\r\n\r\n  const profile = await getProfile(requestedProfileId);\r\n  if (!profile) {\r\n    return {\r\n      ok: false,\r\n      response: await buildSelectionResponse(\"profile_not_found\", requestedProfileId),\r\n    };\r\n  }\r\n\r\n  if (!profile.isActive) {\r\n    return {\r\n      ok: false,\r\n      response: await buildSelectionResponse(\"profile_inactive\", requestedProfileId),\r\n    };\r\n  }\r\n\r\n  return {\r\n    ok: true,\r\n    value: {\r\n      profileId: profile.id,\r\n    },\r\n  };\r\n}\r\n"],
+  "sourcesContent": ["import { object } from \"mcp-use/server\";\n\nimport { getProfile, listProfiles } from \"../../config/profile-store.js\";\n\nexport type MercadoLibreProfileSelectionReason =\n  | \"missing_profile\"\n  | \"profile_not_found\"\n  | \"profile_inactive\";\n\nexport interface ResolvedMercadoLibreProfile {\n  profileId: string;\n}\n\nfunction buildSelectionMessage(\n  reason: MercadoLibreProfileSelectionReason,\n  profileId?: string\n): string {\n  switch (reason) {\n    case \"missing_profile\":\n      return \"MercadoLibre requiere seleccion explicita de profileId. Reenviar la misma tool con uno de los perfiles activos disponibles.\";\n    case \"profile_not_found\":\n      return `El profileId \"${profileId}\" no existe. Reenviar la misma tool con uno de los perfiles activos disponibles.`;\n    case \"profile_inactive\":\n      return `El profileId \"${profileId}\" esta inactivo. Reenviar la misma tool con uno de los perfiles activos disponibles.`;\n  }\n}\n\nasync function buildSelectionResponse(\n  reason: MercadoLibreProfileSelectionReason,\n  profileId?: string\n) {\n  const profiles = await listProfiles({ activeOnly: true });\n  return object({\n    selection_required: true,\n    reason,\n    message: buildSelectionMessage(reason, profileId),\n    available_profiles: profiles.map((profile) => ({\n      profile_id: profile.id,\n      name: profile.name,\n    })),\n  });\n}\n\nexport async function resolveMercadoLibreProfileOrSelection(\n  profileId?: string\n): Promise<\n  | { ok: true; value: ResolvedMercadoLibreProfile }\n  | { ok: false; response: ReturnType<typeof object<Record<string, unknown>>> }\n> {\n  const requestedProfileId = profileId?.trim();\n\n  if (!requestedProfileId) {\n    return {\n      ok: false,\n      response: await buildSelectionResponse(\"missing_profile\"),\n    };\n  }\n\n  const profile = await getProfile(requestedProfileId);\n  if (!profile) {\n    return {\n      ok: false,\n      response: await buildSelectionResponse(\"profile_not_found\", requestedProfileId),\n    };\n  }\n\n  if (!profile.isActive) {\n    return {\n      ok: false,\n      response: await buildSelectionResponse(\"profile_inactive\", requestedProfileId),\n    };\n  }\n\n  return {\n    ok: true,\n    value: {\n      profileId: profile.id,\n    },\n  };\n}\n"],
   "mappings": "AAAA,SAAS,cAAc;AAEvB,SAAS,YAAY,oBAAoB;AAWzC,SAAS,sBACP,QACA,WACQ;AACR,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,iBAAiB,SAAS;AAAA,IACnC,KAAK;AACH,aAAO,iBAAiB,SAAS;AAAA,EACrC;AACF;AAEA,eAAe,uBACb,QACA,WACA;AACA,QAAM,WAAW,MAAM,aAAa,EAAE,YAAY,KAAK,CAAC;AACxD,SAAO,OAAO;AAAA,IACZ,oBAAoB;AAAA,IACpB;AAAA,IACA,SAAS,sBAAsB,QAAQ,SAAS;AAAA,IAChD,oBAAoB,SAAS,IAAI,CAAC,aAAa;AAAA,MAC7C,YAAY,QAAQ;AAAA,MACpB,MAAM,QAAQ;AAAA,IAChB,EAAE;AAAA,EACJ,CAAC;AACH;AAEA,eAAsB,sCACpB,WAIA;AACA,QAAM,qBAAqB,WAAW,KAAK;AAE3C,MAAI,CAAC,oBAAoB;AACvB,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,UAAU,MAAM,uBAAuB,iBAAiB;AAAA,IAC1D;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,WAAW,kBAAkB;AACnD,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,UAAU,MAAM,uBAAuB,qBAAqB,kBAAkB;AAAA,IAChF;AAAA,EACF;AAEA,MAAI,CAAC,QAAQ,UAAU;AACrB,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,UAAU,MAAM,uBAAuB,oBAAoB,kBAAkB;AAAA,IAC/E;AAAA,EACF;AAEA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,MACL,WAAW,QAAQ;AAAA,IACrB;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/src/tools/mercadolibre/search-items.js

@@ -1,48 +1,167 @@
 import { error, object } from "mcp-use/server";
 import { z } from "zod";
 import { getMercadoLibreAccessForProfile } from "../../config/mercadolibre.js";
-import {
-  buildMercadoLibrePaginationMetadata,
-  formatMercadoLibreError,
-  normalizeMercadoLibrePaging
-} from "../../services/mercadolibre/mercadolibre-api.js";
+import { formatMercadoLibreError, normalizeMercadoLibrePaging } from "../../services/mercadolibre/mercadolibre-api.js";
 import {
   getMercadoLibreItemDetailsBatch,
-  searchMercadoLibreItems
+  getMercadoLibreItemDetailsWithFallbackBatch,
+  searchMercadoLibreItems,
+  searchMercadoLibreItemsBatch
 } from "../../services/mercadolibre/mercadolibre-items.js";
 import { stripNulls } from "../../utils/strip-payload.js";
-import { asArray, normalizeString, toNumber } from "./helpers.js";
+import { asArray, asRecord, normalizeString, toNumber } from "./helpers.js";
 import { resolveMercadoLibreProfileOrSelection } from "./profile-resolution.js";
 import { mercadolibreProfileIdSchemaField } from "./write-helpers.js";
+const DEFAULT_STATUS = "active";
+const SEARCH_PAGE_LIMIT = 50;
+const DETAIL_BATCH_SIZE = 20;
+const PAGE_FETCH_CONCURRENCY = 15;
+const PAGE_FETCH_MAX_RETRIES = 2;
+const AVAILABLE_STATUS_FILTERS = [
+  "active",
+  "paused",
+  "closed",
+  "under_review",
+  "inactive",
+  "not_yet_active",
+  "payment_required",
+  "deleted"
+];
+const itemsSchema = [
+  "item_id",
+  "title",
+  "status",
+  "price",
+  "currency_id",
+  "available_quantity",
+  "sold_quantity",
+  "listing_type_id",
+  "category_id"
+];
 const meliSearchItemsSchema = z.object({
   profileId: mercadolibreProfileIdSchemaField,
-  status: z.string().trim().min(1).optional().describe("Optional item status filter."),
+  status: z.string().trim().min(1).optional().describe("Optional item status filter. Defaults to active when omitted."),
+  title: z.string().trim().min(1).optional().describe("Optional item title or text query. Maps to MercadoLibre q search."),
   category: z.string().trim().min(1).optional().describe("Optional category id filter."),
   listingTypeId: z.string().trim().min(1).optional().describe("Optional listing type filter."),
   orders: z.string().trim().min(1).optional().describe("Optional MercadoLibre sort expression for items search."),
-  includeDetails: z.boolean().optional().describe("Whether to multiget compact item details for returned item ids."),
-  limit: z.number().int().min(1).max(50).optional().describe("Results per page (1-50)."),
-  offset: z.number().int().min(0).max(5e3).optional().describe("Pagination offset.")
+  limit: z.number().int().min(1).max(50).optional().describe("Optional maximum detailed items to return. If omitted, returns the full matching universe from offset onward."),
+  offset: z.number().int().min(0).max(5e3).optional().describe("Pagination offset over the matching MercadoLibre items universe.")
 });
-async function meliSearchItemsHandler(params) {
-  try {
-    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);
-    if (!profileResolution.ok) {
-      return profileResolution.response;
+function formatCompactItem(item) {
+  return [
+    normalizeString(item.id),
+    normalizeString(item.title),
+    normalizeString(item.status),
+    toNumber(item.price),
+    normalizeString(item.currency_id, "UNKNOWN"),
+    toNumber(item.available_quantity),
+    toNumber(item.sold_quantity),
+    normalizeString(item.listing_type_id),
+    normalizeString(item.category_id)
+  ];
+}
+function buildItemsMetadata(params) {
+  const nextOffset = params.offset + params.returned;
+  const hasMore = nextOffset < params.total;
+  let continuation = "No more pages for this query.";
+  if (params.pagesFailed > 0 || params.detailFailures > 0) {
+    continuation = hasMore ? `Se recuper\xF3 cobertura parcial. Reintentar la misma tool con offset=${params.offset} y limit=${params.limitWasExplicit ? params.effectiveLimit : 50}. Luego continuar con offset=${nextOffset} si hace falta.` : "Se recuper\xF3 cobertura parcial. Reintentar la misma tool con los mismos filtros si hace falta completar la cobertura.";
+  } else if (params.limitWasExplicit && hasMore) {
+    continuation = `Para continuar trayendo items, volver a invocar meli_search_items con los mismos filtros, offset=${nextOffset} y limit=${params.effectiveLimit}. Repetir hasta has_more=false.`;
+  }
+  return stripNulls({
+    total: params.total,
+    limit: params.effectiveLimit,
+    offset: params.offset,
+    returned: params.returned,
+    has_more: params.limitWasExplicit ? hasMore || params.pagesFailed > 0 || params.detailFailures > 0 : params.pagesFailed > 0 || params.detailFailures > 0,
+    next_offset: params.limitWasExplicit && hasMore ? nextOffset : void 0,
+    continuation,
+    applied_status: params.appliedStatus,
+    default_status_notice: params.usedDefaultStatus ? "Solo se devolvieron publicaciones active por default. Tambi\xE9n se puede pedir status expl\xEDcito como paused, closed, under_review, inactive, not_yet_active, payment_required o deleted." : void 0,
+    available_status_filters: AVAILABLE_STATUS_FILTERS,
+    detail_coverage: {
+      detail_failures: params.detailFailures,
+      details_complete: params.detailFailures === 0
+    },
+    pages_requested: params.pagesRequested,
+    pages_succeeded: params.pagesSucceeded,
+    pages_failed: params.pagesFailed,
+    universe_fully_fetched: params.universeFullyFetched
+  });
+}
+async function fetchAllMatchingItemIds(profileId, sellerId, params) {
+  const appliedStatus = params.status ?? DEFAULT_STATUS;
+  const firstResponse = await searchMercadoLibreItems(profileId, {
+    sellerId,
+    status: appliedStatus,
+    q: params.title,
+    category: params.category,
+    listingTypeId: params.listingTypeId,
+    orders: params.orders,
+    limit: SEARCH_PAGE_LIMIT,
+    offset: 0
+  });
+  const firstPaging = normalizeMercadoLibrePaging(asRecord(firstResponse.paging));
+  const total = firstPaging.total;
+  const effectiveLimit = firstPaging.limit || SEARCH_PAGE_LIMIT;
+  const ids = asArray(firstResponse.results).map((value) => normalizeString(value)).filter(Boolean);
+  const failedOffsets = [];
+  let pagesRequested = 1;
+  let pagesSucceeded = 1;
+  if (effectiveLimit > 0 && total > ids.length) {
+    const nextOffsets = [];
+    for (let nextOffset = effectiveLimit; nextOffset < total; nextOffset += effectiveLimit) {
+      nextOffsets.push(nextOffset);
     }
-    const profileId = profileResolution.value.profileId;
-    const access = await getMercadoLibreAccessForProfile(profileId);
-    const searchResponse = await searchMercadoLibreItems(profileId, {
-      sellerId: access.sellerId,
-      status: params.status,
-      category: params.category,
-      listingTypeId: params.listingTypeId,
-      orders: params.orders,
-      limit: params.limit ?? 20,
-      offset: params.offset ?? 0
-    });
-    const itemIds = asArray(searchResponse.results).map((value) => normalizeString(value)).filter(Boolean);
-    const compactItems = params.includeDetails ? await getMercadoLibreItemDetailsBatch(profileId, itemIds.slice(0, 20), [
+    pagesRequested += nextOffsets.length;
+    if (nextOffsets.length > 0) {
+      const batch = await searchMercadoLibreItemsBatch(
+        profileId,
+        {
+          sellerId,
+          status: appliedStatus,
+          q: params.title,
+          category: params.category,
+          listingTypeId: params.listingTypeId,
+          orders: params.orders,
+          limit: effectiveLimit
+        },
+        nextOffsets,
+        {
+          maxConcurrency: PAGE_FETCH_CONCURRENCY,
+          maxRetries: PAGE_FETCH_MAX_RETRIES
+        }
+      );
+      pagesSucceeded += batch.successful.length;
+      batch.successful.forEach((entry) => {
+        ids.push(...asArray(entry.document.results).map((value) => normalizeString(value)).filter(Boolean));
+      });
+      batch.failed.forEach((failure) => {
+        failedOffsets.push(Number(failure.id));
+      });
+    }
+  }
+  return {
+    ids,
+    total,
+    appliedStatus,
+    pagesRequested,
+    pagesSucceeded,
+    pagesFailed: failedOffsets.length,
+    universeFullyFetched: failedOffsets.length === 0 && ids.length >= total
+  };
+}
+async function fetchDetailedItems(profileId, itemIds) {
+  const details = {};
+  let detailFailures = 0;
+  for (let index = 0; index < itemIds.length; index += DETAIL_BATCH_SIZE) {
+    const chunk = itemIds.slice(index, index + DETAIL_BATCH_SIZE);
+    if (chunk.length === 0) {
+      continue;
+    }
+    const batch = await getMercadoLibreItemDetailsBatch(profileId, chunk, [
       "id",
       "title",
       "status",
@@ -51,33 +170,69 @@ async function meliSearchItemsHandler(params) {
       "available_quantity",
       "sold_quantity",
       "listing_type_id",
-      "permalink",
-      "thumbnail"
-    ]) : [];
-    const paging = normalizeMercadoLibrePaging(searchResponse.paging);
+      "category_id"
+    ]);
+    const foundIds = /* @__PURE__ */ new Set();
+    for (const item of batch) {
+      const itemId = normalizeString(item.id);
+      if (!itemId) {
+        continue;
+      }
+      foundIds.add(itemId);
+      details[itemId] = item;
+    }
+    const missingIds = chunk.filter((itemId) => !foundIds.has(itemId));
+    if (missingIds.length > 0) {
+      const fallback = await getMercadoLibreItemDetailsWithFallbackBatch(profileId, missingIds, {
+        maxConcurrency: 10,
+        maxRetries: 1
+      });
+      fallback.successful.forEach((entry) => {
+        details[entry.id] = entry.document;
+      });
+      detailFailures += fallback.failed.length;
+    }
+  }
+  return {
+    orderedItems: itemIds.map((itemId) => details[itemId]).filter(Boolean),
+    detailFailures
+  };
+}
+async function meliSearchItemsHandler(params) {
+  try {
+    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const profileId = profileResolution.value.profileId;
+    const access = await getMercadoLibreAccessForProfile(profileId);
+    const requestedOffset = params.offset ?? 0;
+    const limitWasExplicit = typeof params.limit === "number";
+    const usedDefaultStatus = !params.status;
+    const { ids, total, appliedStatus, pagesRequested, pagesSucceeded, pagesFailed, universeFullyFetched } = await fetchAllMatchingItemIds(profileId, access.sellerId, params);
+    const pageIds = limitWasExplicit ? ids.slice(requestedOffset, requestedOffset + (params.limit ?? 0)) : ids.slice(requestedOffset);
+    const effectiveLimit = limitWasExplicit ? params.limit ?? pageIds.length : Math.max(pageIds.length, 0);
+    const { orderedItems, detailFailures } = await fetchDetailedItems(profileId, pageIds);
+    const compactItems = orderedItems.map((item) => formatCompactItem(item));
     return object(
       stripNulls({
         profile_id: profileId,
-        metadata: buildMercadoLibrePaginationMetadata({
-          total: paging.total,
-          limit: paging.limit || params.limit || itemIds.length,
-          offset: paging.offset || params.offset || 0,
-          returned: itemIds.length,
-          nextField: "offset"
+        metadata: buildItemsMetadata({
+          total,
+          effectiveLimit,
+          offset: requestedOffset,
+          returned: compactItems.length,
+          appliedStatus,
+          usedDefaultStatus,
+          detailFailures,
+          pagesRequested,
+          pagesSucceeded,
+          pagesFailed,
+          universeFullyFetched,
+          limitWasExplicit
         }),
-        item_ids: itemIds,
-        items: compactItems.map((item) => ({
-          item_id: normalizeString(item.id),
-          title: normalizeString(item.title),
-          status: normalizeString(item.status),
-          price: toNumber(item.price),
-          currency_id: normalizeString(item.currency_id, "UNKNOWN"),
-          available_quantity: toNumber(item.available_quantity),
-          sold_quantity: toNumber(item.sold_quantity),
-          listing_type_id: normalizeString(item.listing_type_id),
-          permalink: normalizeString(item.permalink),
-          thumbnail: normalizeString(item.thumbnail)
-        }))
+        items_schema: itemsSchema,
+        items: compactItems
       })
     );
   } catch (err) {

package/dist/src/tools/mercadolibre/search-items.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/search-items.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\r\nimport { z } from \"zod\";\r\n\r\nimport { getMercadoLibreAccessForProfile } from \"../../config/mercadolibre.js\";\r\nimport {\r\n  buildMercadoLibrePaginationMetadata,\r\n  formatMercadoLibreError,\r\n  normalizeMercadoLibrePaging,\r\n} from \"../../services/mercadolibre/mercadolibre-api.js\";\r\nimport {\r\n  getMercadoLibreItemDetailsBatch,\r\n  searchMercadoLibreItems,\r\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\r\nimport { stripNulls } from \"../../utils/strip-payload.js\";\r\nimport { asArray, normalizeString, toNumber } from \"./helpers.js\";\r\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\r\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\r\n\r\nexport const meliSearchItemsSchema = z.object({\r\n  profileId: mercadolibreProfileIdSchemaField,\r\n  status: z.string().trim().min(1).optional().describe(\"Optional item status filter.\"),\r\n  category: z.string().trim().min(1).optional().describe(\"Optional category id filter.\"),\r\n  listingTypeId: z.string().trim().min(1).optional().describe(\"Optional listing type filter.\"),\r\n  orders: z.string().trim().min(1).optional().describe(\"Optional MercadoLibre sort expression for items search.\"),\r\n  includeDetails: z.boolean().optional().describe(\"Whether to multiget compact item details for returned item ids.\"),\r\n  limit: z.number().int().min(1).max(50).optional().describe(\"Results per page (1-50).\"),\r\n  offset: z.number().int().min(0).max(5000).optional().describe(\"Pagination offset.\"),\r\n});\r\n\r\nexport async function meliSearchItemsHandler(params: z.infer<typeof meliSearchItemsSchema>) {\r\n  try {\r\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\r\n    if (!profileResolution.ok) {\r\n      return profileResolution.response;\r\n    }\r\n\r\n    const profileId = profileResolution.value.profileId;\r\n    const access = await getMercadoLibreAccessForProfile(profileId);\r\n    const searchResponse = await searchMercadoLibreItems(profileId, {\r\n      sellerId: access.sellerId,\r\n      status: params.status,\r\n      category: params.category,\r\n      listingTypeId: params.listingTypeId,\r\n      orders: params.orders,\r\n      limit: params.limit ?? 20,\r\n      offset: params.offset ?? 0,\r\n    });\r\n\r\n    const itemIds = asArray<string>(searchResponse.results).map((value) => normalizeString(value)).filter(Boolean);\r\n    const compactItems = params.includeDetails\r\n      ? await getMercadoLibreItemDetailsBatch(profileId, itemIds.slice(0, 20), [\r\n          \"id\",\r\n          \"title\",\r\n          \"status\",\r\n          \"price\",\r\n          \"currency_id\",\r\n          \"available_quantity\",\r\n          \"sold_quantity\",\r\n          \"listing_type_id\",\r\n          \"permalink\",\r\n          \"thumbnail\",\r\n        ])\r\n      : [];\r\n\r\n    const paging = normalizeMercadoLibrePaging(searchResponse.paging as Record<string, unknown>);\r\n\r\n    return object(\r\n      stripNulls({\r\n        profile_id: profileId,\r\n        metadata: buildMercadoLibrePaginationMetadata({\r\n          total: paging.total,\r\n          limit: paging.limit || params.limit || itemIds.length,\r\n          offset: paging.offset || params.offset || 0,\r\n          returned: itemIds.length,\r\n          nextField: \"offset\",\r\n        }),\r\n        item_ids: itemIds,\r\n        items: compactItems.map((item) => ({\r\n          item_id: normalizeString(item.id),\r\n          title: normalizeString(item.title),\r\n          status: normalizeString(item.status),\r\n          price: toNumber(item.price),\r\n          currency_id: normalizeString(item.currency_id, \"UNKNOWN\"),\r\n          available_quantity: toNumber(item.available_quantity),\r\n          sold_quantity: toNumber(item.sold_quantity),\r\n          listing_type_id: normalizeString(item.listing_type_id),\r\n          permalink: normalizeString(item.permalink),\r\n          thumbnail: normalizeString(item.thumbnail),\r\n        })),\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(formatMercadoLibreError(err, \"Failed to search MercadoLibre items\"));\r\n  }\r\n}\r\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { getMercadoLibreAccessForProfile } from \"../../config/mercadolibre.js\";\nimport { formatMercadoLibreError, normalizeMercadoLibrePaging } from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport {\n  getMercadoLibreItemDetailsBatch,\n  getMercadoLibreItemDetailsWithFallbackBatch,\n  searchMercadoLibreItems,\n  searchMercadoLibreItemsBatch,\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { asArray, asRecord, normalizeString, toNumber } from \"./helpers.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\n\nconst DEFAULT_STATUS = \"active\";\nconst SEARCH_PAGE_LIMIT = 50;\nconst DETAIL_BATCH_SIZE = 20;\nconst PAGE_FETCH_CONCURRENCY = 15;\nconst PAGE_FETCH_MAX_RETRIES = 2;\nconst AVAILABLE_STATUS_FILTERS = [\n  \"active\",\n  \"paused\",\n  \"closed\",\n  \"under_review\",\n  \"inactive\",\n  \"not_yet_active\",\n  \"payment_required\",\n  \"deleted\",\n];\n\nconst itemsSchema = [\n  \"item_id\",\n  \"title\",\n  \"status\",\n  \"price\",\n  \"currency_id\",\n  \"available_quantity\",\n  \"sold_quantity\",\n  \"listing_type_id\",\n  \"category_id\",\n] as const;\n\nexport const meliSearchItemsSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  status: z.string().trim().min(1).optional().describe(\"Optional item status filter. Defaults to active when omitted.\"),\n  title: z.string().trim().min(1).optional().describe(\"Optional item title or text query. Maps to MercadoLibre q search.\"),\n  category: z.string().trim().min(1).optional().describe(\"Optional category id filter.\"),\n  listingTypeId: z.string().trim().min(1).optional().describe(\"Optional listing type filter.\"),\n  orders: z.string().trim().min(1).optional().describe(\"Optional MercadoLibre sort expression for items search.\"),\n  limit: z.number().int().min(1).max(50).optional().describe(\"Optional maximum detailed items to return. If omitted, returns the full matching universe from offset onward.\"),\n  offset: z.number().int().min(0).max(5000).optional().describe(\"Pagination offset over the matching MercadoLibre items universe.\"),\n});\n\nfunction formatCompactItem(item: Record<string, unknown>) {\n  return [\n    normalizeString(item.id),\n    normalizeString(item.title),\n    normalizeString(item.status),\n    toNumber(item.price),\n    normalizeString(item.currency_id, \"UNKNOWN\"),\n    toNumber(item.available_quantity),\n    toNumber(item.sold_quantity),\n    normalizeString(item.listing_type_id),\n    normalizeString(item.category_id),\n  ];\n}\n\nfunction buildItemsMetadata(params: {\n  total: number;\n  effectiveLimit: number;\n  offset: number;\n  returned: number;\n  appliedStatus: string;\n  usedDefaultStatus: boolean;\n  detailFailures: number;\n  pagesRequested: number;\n  pagesSucceeded: number;\n  pagesFailed: number;\n  universeFullyFetched: boolean;\n  limitWasExplicit: boolean;\n}) {\n  const nextOffset = params.offset + params.returned;\n  const hasMore = nextOffset < params.total;\n\n  let continuation = \"No more pages for this query.\";\n  if (params.pagesFailed > 0 || params.detailFailures > 0) {\n    continuation = hasMore\n      ? `Se recuper\u00F3 cobertura parcial. Reintentar la misma tool con offset=${params.offset} y limit=${params.limitWasExplicit ? params.effectiveLimit : 50}. Luego continuar con offset=${nextOffset} si hace falta.`\n      : \"Se recuper\u00F3 cobertura parcial. Reintentar la misma tool con los mismos filtros si hace falta completar la cobertura.\";\n  } else if (params.limitWasExplicit && hasMore) {\n    continuation = `Para continuar trayendo items, volver a invocar meli_search_items con los mismos filtros, offset=${nextOffset} y limit=${params.effectiveLimit}. Repetir hasta has_more=false.`;\n  }\n\n  return stripNulls({\n    total: params.total,\n    limit: params.effectiveLimit,\n    offset: params.offset,\n    returned: params.returned,\n    has_more: params.limitWasExplicit ? hasMore || params.pagesFailed > 0 || params.detailFailures > 0 : params.pagesFailed > 0 || params.detailFailures > 0,\n    next_offset: params.limitWasExplicit && hasMore ? nextOffset : undefined,\n    continuation,\n    applied_status: params.appliedStatus,\n    default_status_notice: params.usedDefaultStatus\n      ? 'Solo se devolvieron publicaciones active por default. Tambi\u00E9n se puede pedir status expl\u00EDcito como paused, closed, under_review, inactive, not_yet_active, payment_required o deleted.'\n      : undefined,\n    available_status_filters: AVAILABLE_STATUS_FILTERS,\n    detail_coverage: {\n      detail_failures: params.detailFailures,\n      details_complete: params.detailFailures === 0,\n    },\n    pages_requested: params.pagesRequested,\n    pages_succeeded: params.pagesSucceeded,\n    pages_failed: params.pagesFailed,\n    universe_fully_fetched: params.universeFullyFetched,\n  });\n}\n\nasync function fetchAllMatchingItemIds(profileId: string, sellerId: string, params: z.infer<typeof meliSearchItemsSchema>) {\n  const appliedStatus = params.status ?? DEFAULT_STATUS;\n  const firstResponse = await searchMercadoLibreItems(profileId, {\n    sellerId,\n    status: appliedStatus,\n    q: params.title,\n    category: params.category,\n    listingTypeId: params.listingTypeId,\n    orders: params.orders,\n    limit: SEARCH_PAGE_LIMIT,\n    offset: 0,\n  });\n\n  const firstPaging = normalizeMercadoLibrePaging(asRecord(firstResponse.paging));\n  const total = firstPaging.total;\n  const effectiveLimit = firstPaging.limit || SEARCH_PAGE_LIMIT;\n  const ids = asArray<string>(firstResponse.results).map((value) => normalizeString(value)).filter(Boolean);\n  const failedOffsets: number[] = [];\n  let pagesRequested = 1;\n  let pagesSucceeded = 1;\n\n  if (effectiveLimit > 0 && total > ids.length) {\n    const nextOffsets: number[] = [];\n    for (let nextOffset = effectiveLimit; nextOffset < total; nextOffset += effectiveLimit) {\n      nextOffsets.push(nextOffset);\n    }\n\n    pagesRequested += nextOffsets.length;\n\n    if (nextOffsets.length > 0) {\n      const batch = await searchMercadoLibreItemsBatch(\n        profileId,\n        {\n          sellerId,\n          status: appliedStatus,\n          q: params.title,\n          category: params.category,\n          listingTypeId: params.listingTypeId,\n          orders: params.orders,\n          limit: effectiveLimit,\n        },\n        nextOffsets,\n        {\n          maxConcurrency: PAGE_FETCH_CONCURRENCY,\n          maxRetries: PAGE_FETCH_MAX_RETRIES,\n        }\n      );\n\n      pagesSucceeded += batch.successful.length;\n      batch.successful.forEach((entry) => {\n        ids.push(...asArray<string>(entry.document.results).map((value) => normalizeString(value)).filter(Boolean));\n      });\n      batch.failed.forEach((failure) => {\n        failedOffsets.push(Number(failure.id));\n      });\n    }\n  }\n\n  return {\n    ids,\n    total,\n    appliedStatus,\n    pagesRequested,\n    pagesSucceeded,\n    pagesFailed: failedOffsets.length,\n    universeFullyFetched: failedOffsets.length === 0 && ids.length >= total,\n  };\n}\n\nasync function fetchDetailedItems(profileId: string, itemIds: string[]) {\n  const details: Record<string, Record<string, unknown>> = {};\n  let detailFailures = 0;\n\n  for (let index = 0; index < itemIds.length; index += DETAIL_BATCH_SIZE) {\n    const chunk = itemIds.slice(index, index + DETAIL_BATCH_SIZE);\n    if (chunk.length === 0) {\n      continue;\n    }\n\n    const batch = await getMercadoLibreItemDetailsBatch(profileId, chunk, [\n      \"id\",\n      \"title\",\n      \"status\",\n      \"price\",\n      \"currency_id\",\n      \"available_quantity\",\n      \"sold_quantity\",\n      \"listing_type_id\",\n      \"category_id\",\n    ]);\n\n    const foundIds = new Set<string>();\n    for (const item of batch) {\n      const itemId = normalizeString(item.id);\n      if (!itemId) {\n        continue;\n      }\n      foundIds.add(itemId);\n      details[itemId] = item;\n    }\n\n    const missingIds = chunk.filter((itemId) => !foundIds.has(itemId));\n    if (missingIds.length > 0) {\n      const fallback = await getMercadoLibreItemDetailsWithFallbackBatch(profileId, missingIds, {\n        maxConcurrency: 10,\n        maxRetries: 1,\n      });\n      fallback.successful.forEach((entry) => {\n        details[entry.id] = entry.document;\n      });\n      detailFailures += fallback.failed.length;\n    }\n  }\n\n  return {\n    orderedItems: itemIds.map((itemId) => details[itemId]).filter(Boolean),\n    detailFailures,\n  };\n}\n\nexport async function meliSearchItemsHandler(params: z.infer<typeof meliSearchItemsSchema>) {\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 access = await getMercadoLibreAccessForProfile(profileId);\n    const requestedOffset = params.offset ?? 0;\n    const limitWasExplicit = typeof params.limit === \"number\";\n    const usedDefaultStatus = !params.status;\n\n    const { ids, total, appliedStatus, pagesRequested, pagesSucceeded, pagesFailed, universeFullyFetched } = await fetchAllMatchingItemIds(profileId, access.sellerId, params);\n\n    const pageIds = limitWasExplicit\n      ? ids.slice(requestedOffset, requestedOffset + (params.limit ?? 0))\n      : ids.slice(requestedOffset);\n    const effectiveLimit = limitWasExplicit ? params.limit ?? pageIds.length : Math.max(pageIds.length, 0);\n\n    const { orderedItems, detailFailures } = await fetchDetailedItems(profileId, pageIds);\n    const compactItems = orderedItems.map((item) => formatCompactItem(item));\n\n    return object(\n      stripNulls({\n        profile_id: profileId,\n        metadata: buildItemsMetadata({\n          total,\n          effectiveLimit,\n          offset: requestedOffset,\n          returned: compactItems.length,\n          appliedStatus,\n          usedDefaultStatus,\n          detailFailures,\n          pagesRequested,\n          pagesSucceeded,\n          pagesFailed,\n          universeFullyFetched,\n          limitWasExplicit,\n        }),\n        items_schema: itemsSchema,\n        items: compactItems,\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to search MercadoLibre items\"));\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/src/tools/mercadolibre/search-questions.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/search-questions.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\r\nimport { z } from \"zod\";\r\n\r\nimport { getMercadoLibreAccessForProfile } from \"../../config/mercadolibre.js\";\r\nimport {\r\n  buildMercadoLibrePaginationMetadata,\r\n  formatMercadoLibreError,\r\n  normalizeMercadoLibrePaging,\r\n} from \"../../services/mercadolibre/mercadolibre-api.js\";\r\nimport { searchMercadoLibreQuestions } from \"../../services/mercadolibre/mercadolibre-questions.js\";\r\nimport { stripNulls } from \"../../utils/strip-payload.js\";\r\nimport { asArray, asRecord, compactDateTime, normalizeString } from \"./helpers.js\";\r\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\r\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\r\n\r\nexport const meliSearchQuestionsSchema = z.object({\r\n  profileId: mercadolibreProfileIdSchemaField,\r\n  itemId: z.string().trim().min(1).optional().describe(\"Optional MercadoLibre item id filter.\"),\r\n  status: z.string().trim().min(1).optional().describe(\"Optional question status filter.\"),\r\n  limit: z.number().int().min(1).max(50).optional().describe(\"Results per page (1-50).\"),\r\n  offset: z.number().int().min(0).max(5000).optional().describe(\"Pagination offset.\"),\r\n});\r\n\r\nexport async function meliSearchQuestionsHandler(\r\n  params: z.infer<typeof meliSearchQuestionsSchema>\r\n) {\r\n  try {\r\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\r\n    if (!profileResolution.ok) {\r\n      return profileResolution.response;\r\n    }\r\n\r\n    const profileId = profileResolution.value.profileId;\r\n    const access = await getMercadoLibreAccessForProfile(profileId);\r\n    const response = await searchMercadoLibreQuestions(profileId, {\r\n      sellerId: access.sellerId,\r\n      itemId: params.itemId,\r\n      status: params.status,\r\n      limit: params.limit ?? 20,\r\n      offset: params.offset ?? 0,\r\n    });\r\n\r\n    const questions = asArray<Record<string, unknown>>(response.questions ?? response.results);\r\n    const paging = normalizeMercadoLibrePaging(asRecord(response.paging));\r\n\r\n    return object(\r\n      stripNulls({\r\n        profile_id: profileId,\r\n        metadata: buildMercadoLibrePaginationMetadata({\r\n          total: paging.total || questions.length,\r\n          limit: paging.limit || params.limit || questions.length,\r\n          offset: paging.offset || params.offset || 0,\r\n          returned: questions.length,\r\n          nextField: \"offset\",\r\n        }),\r\n        questions: questions.map((question) => ({\r\n          question_id: question.id,\r\n          item_id: normalizeString(question.item_id),\r\n          item_title: normalizeString(asRecord(question.item).title),\r\n          status: normalizeString(question.status),\r\n          text: normalizeString(question.text),\r\n          date_created: compactDateTime(question.date_created),\r\n          from: stripNulls({\r\n            id: normalizeString(asRecord(question.from).id),\r\n            nickname: normalizeString(asRecord(question.from).nickname),\r\n          }),\r\n          answer_status: normalizeString(asRecord(question.answer).status),\r\n        })),\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(formatMercadoLibreError(err, \"Failed to search MercadoLibre questions\"));\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { getMercadoLibreAccessForProfile } from \"../../config/mercadolibre.js\";\nimport {\n  buildMercadoLibrePaginationMetadata,\n  formatMercadoLibreError,\n  normalizeMercadoLibrePaging,\n} from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport { searchMercadoLibreQuestions } from \"../../services/mercadolibre/mercadolibre-questions.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { asArray, asRecord, compactDateTime, normalizeString } from \"./helpers.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\n\nexport const meliSearchQuestionsSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  itemId: z.string().trim().min(1).optional().describe(\"Optional MercadoLibre item id filter.\"),\n  status: z.string().trim().min(1).optional().describe(\"Optional question status filter.\"),\n  limit: z.number().int().min(1).max(50).optional().describe(\"Results per page (1-50).\"),\n  offset: z.number().int().min(0).max(5000).optional().describe(\"Pagination offset.\"),\n});\n\nexport async function meliSearchQuestionsHandler(\n  params: z.infer<typeof meliSearchQuestionsSchema>\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 access = await getMercadoLibreAccessForProfile(profileId);\n    const response = await searchMercadoLibreQuestions(profileId, {\n      sellerId: access.sellerId,\n      itemId: params.itemId,\n      status: params.status,\n      limit: params.limit ?? 20,\n      offset: params.offset ?? 0,\n    });\n\n    const questions = asArray<Record<string, unknown>>(response.questions ?? response.results);\n    const paging = normalizeMercadoLibrePaging(asRecord(response.paging));\n\n    return object(\n      stripNulls({\n        profile_id: profileId,\n        metadata: buildMercadoLibrePaginationMetadata({\n          total: paging.total || questions.length,\n          limit: paging.limit || params.limit || questions.length,\n          offset: paging.offset || params.offset || 0,\n          returned: questions.length,\n          nextField: \"offset\",\n        }),\n        questions: questions.map((question) => ({\n          question_id: question.id,\n          item_id: normalizeString(question.item_id),\n          item_title: normalizeString(asRecord(question.item).title),\n          status: normalizeString(question.status),\n          text: normalizeString(question.text),\n          date_created: compactDateTime(question.date_created),\n          from: stripNulls({\n            id: normalizeString(asRecord(question.from).id),\n            nickname: normalizeString(asRecord(question.from).nickname),\n          }),\n          answer_status: normalizeString(asRecord(question.answer).status),\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to search MercadoLibre questions\"));\n  }\n}\n"],
   "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uCAAuC;AAChD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,mCAAmC;AAC5C,SAAS,kBAAkB;AAC3B,SAAS,SAAS,UAAU,iBAAiB,uBAAuB;AACpE,SAAS,6CAA6C;AACtD,SAAS,wCAAwC;AAE1C,MAAM,4BAA4B,EAAE,OAAO;AAAA,EAChD,WAAW;AAAA,EACX,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,uCAAuC;AAAA,EAC5F,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,kCAAkC;AAAA,EACvF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,0BAA0B;AAAA,EACrF,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAI,EAAE,SAAS,EAAE,SAAS,oBAAoB;AACpF,CAAC;AAED,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,SAAS,MAAM,gCAAgC,SAAS;AAC9D,UAAM,WAAW,MAAM,4BAA4B,WAAW;AAAA,MAC5D,UAAU,OAAO;AAAA,MACjB,QAAQ,OAAO;AAAA,MACf,QAAQ,OAAO;AAAA,MACf,OAAO,OAAO,SAAS;AAAA,MACvB,QAAQ,OAAO,UAAU;AAAA,IAC3B,CAAC;AAED,UAAM,YAAY,QAAiC,SAAS,aAAa,SAAS,OAAO;AACzF,UAAM,SAAS,4BAA4B,SAAS,SAAS,MAAM,CAAC;AAEpE,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,QACZ,UAAU,oCAAoC;AAAA,UAC5C,OAAO,OAAO,SAAS,UAAU;AAAA,UACjC,OAAO,OAAO,SAAS,OAAO,SAAS,UAAU;AAAA,UACjD,QAAQ,OAAO,UAAU,OAAO,UAAU;AAAA,UAC1C,UAAU,UAAU;AAAA,UACpB,WAAW;AAAA,QACb,CAAC;AAAA,QACD,WAAW,UAAU,IAAI,CAAC,cAAc;AAAA,UACtC,aAAa,SAAS;AAAA,UACtB,SAAS,gBAAgB,SAAS,OAAO;AAAA,UACzC,YAAY,gBAAgB,SAAS,SAAS,IAAI,EAAE,KAAK;AAAA,UACzD,QAAQ,gBAAgB,SAAS,MAAM;AAAA,UACvC,MAAM,gBAAgB,SAAS,IAAI;AAAA,UACnC,cAAc,gBAAgB,SAAS,YAAY;AAAA,UACnD,MAAM,WAAW;AAAA,YACf,IAAI,gBAAgB,SAAS,SAAS,IAAI,EAAE,EAAE;AAAA,YAC9C,UAAU,gBAAgB,SAAS,SAAS,IAAI,EAAE,QAAQ;AAAA,UAC5D,CAAC;AAAA,UACD,eAAe,gBAAgB,SAAS,SAAS,MAAM,EAAE,MAAM;AAAA,QACjE,EAAE;AAAA,MACJ,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,wBAAwB,KAAK,yCAAyC,CAAC;AAAA,EACtF;AACF;",
   "names": []
 }

package/dist/src/tools/mercadolibre/update-item-basic-fields.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/update-item-basic-fields.ts"],
-  "sourcesContent": ["import { z } from \"zod\";\r\n\r\nimport {\r\n  getMercadoLibreItem,\r\n  updateMercadoLibreItem,\r\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\r\nimport {\r\n  buildMercadoLibreWriteSuccessResponse,\r\n  handleMercadoLibreWriteError,\r\n  mercadolibreProfileIdSchemaField,\r\n  resolveMercadoLibreWriteProfile,\r\n} from \"./write-helpers.js\";\r\n\r\nconst attributeSchema = z.object({\r\n  id: z.string().trim().min(1).describe(\"MercadoLibre attribute id.\"),\r\n  value_name: z.string().trim().min(1).optional().describe(\"Human-readable attribute value.\"),\r\n  value_id: z.string().trim().min(1).optional().describe(\"MercadoLibre attribute value id when known.\"),\r\n});\r\n\r\nexport const meliUpdateItemBasicFieldsSchema = z\r\n  .object({\r\n    profileId: mercadolibreProfileIdSchemaField,\r\n    itemId: z.string().trim().min(1).describe(\"MercadoLibre item id.\"),\r\n    title: z.string().trim().min(3).optional().describe(\"New listing title.\"),\r\n    price: z.number().positive().optional().describe(\"New listing price.\"),\r\n    availableQuantity: z.number().int().min(0).optional().describe(\"New available quantity.\"),\r\n    attributes: z.array(attributeSchema).optional().describe(\"Updated attributes array.\"),\r\n    saleTerms: z.array(z.record(z.string(), z.unknown())).optional().describe(\"Updated sale terms array.\"),\r\n    shipping: z.record(z.string(), z.unknown()).optional().describe(\"Updated shipping payload.\"),\r\n    status: z.enum([\"active\", \"paused\", \"closed\", \"under_review\"]).optional().describe(\"New listing status.\"),\r\n    listingTypeId: z.string().trim().min(1).optional().describe(\"Optional new listing type id if supported by MercadoLibre for the item.\"),\r\n    channels: z.array(z.string().trim().min(1)).optional().describe(\"Optional replacement channels array if supported.\"),\r\n  })\r\n  .refine(\r\n    (value) =>\r\n      value.title !== undefined ||\r\n      value.price !== undefined ||\r\n      value.availableQuantity !== undefined ||\r\n      value.attributes !== undefined ||\r\n      value.saleTerms !== undefined ||\r\n      value.shipping !== undefined ||\r\n      value.status !== undefined ||\r\n      value.listingTypeId !== undefined ||\r\n      value.channels !== undefined,\r\n    {\r\n      message: \"At least one item field must be provided.\",\r\n      path: [\"title\"],\r\n    }\r\n  );\r\n\r\nexport async function meliUpdateItemBasicFieldsHandler(\r\n  params: z.infer<typeof meliUpdateItemBasicFieldsSchema>\r\n) {\r\n  try {\r\n    const profileResolution = await resolveMercadoLibreWriteProfile(params.profileId);\r\n    if (!profileResolution.ok) {\r\n      return profileResolution.response;\r\n    }\r\n\r\n    const profileId = profileResolution.value.profileId;\r\n    const before = await getMercadoLibreItem(profileId, params.itemId);\r\n    const after = await updateMercadoLibreItem(profileId, params.itemId, {\r\n      title: params.title,\r\n      price: params.price,\r\n      available_quantity: params.availableQuantity,\r\n      attributes: params.attributes,\r\n      sale_terms: params.saleTerms,\r\n      shipping: params.shipping,\r\n      status: params.status,\r\n      listing_type_id: params.listingTypeId,\r\n      channels: params.channels,\r\n    });\r\n\r\n    return buildMercadoLibreWriteSuccessResponse({\r\n      profileId,\r\n      operation: \"update_item_basic_fields\",\r\n      resourceId: params.itemId,\r\n      message: \"MercadoLibre item updated successfully.\",\r\n      before,\r\n      after,\r\n    });\r\n  } catch (err) {\r\n    return handleMercadoLibreWriteError(err, `Failed to update MercadoLibre item ${params.itemId}`);\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  getMercadoLibreItem,\n  updateMercadoLibreItem,\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\nimport {\n  buildMercadoLibreWriteSuccessResponse,\n  handleMercadoLibreWriteError,\n  mercadolibreProfileIdSchemaField,\n  resolveMercadoLibreWriteProfile,\n} from \"./write-helpers.js\";\n\nconst attributeSchema = z.object({\n  id: z.string().trim().min(1).describe(\"MercadoLibre attribute id.\"),\n  value_name: z.string().trim().min(1).optional().describe(\"Human-readable attribute value.\"),\n  value_id: z.string().trim().min(1).optional().describe(\"MercadoLibre attribute value id when known.\"),\n});\n\nexport const meliUpdateItemBasicFieldsSchema = z\n  .object({\n    profileId: mercadolibreProfileIdSchemaField,\n    itemId: z.string().trim().min(1).describe(\"MercadoLibre item id.\"),\n    title: z.string().trim().min(3).optional().describe(\"New listing title.\"),\n    price: z.number().positive().optional().describe(\"New listing price.\"),\n    availableQuantity: z.number().int().min(0).optional().describe(\"New available quantity.\"),\n    attributes: z.array(attributeSchema).optional().describe(\"Updated attributes array.\"),\n    saleTerms: z.array(z.record(z.string(), z.unknown())).optional().describe(\"Updated sale terms array.\"),\n    shipping: z.record(z.string(), z.unknown()).optional().describe(\"Updated shipping payload.\"),\n    status: z.enum([\"active\", \"paused\", \"closed\", \"under_review\"]).optional().describe(\"New listing status.\"),\n    listingTypeId: z.string().trim().min(1).optional().describe(\"Optional new listing type id if supported by MercadoLibre for the item.\"),\n    channels: z.array(z.string().trim().min(1)).optional().describe(\"Optional replacement channels array if supported.\"),\n  })\n  .refine(\n    (value) =>\n      value.title !== undefined ||\n      value.price !== undefined ||\n      value.availableQuantity !== undefined ||\n      value.attributes !== undefined ||\n      value.saleTerms !== undefined ||\n      value.shipping !== undefined ||\n      value.status !== undefined ||\n      value.listingTypeId !== undefined ||\n      value.channels !== undefined,\n    {\n      message: \"At least one item field must be provided.\",\n      path: [\"title\"],\n    }\n  );\n\nexport async function meliUpdateItemBasicFieldsHandler(\n  params: z.infer<typeof meliUpdateItemBasicFieldsSchema>\n) {\n  try {\n    const profileResolution = await resolveMercadoLibreWriteProfile(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    const before = await getMercadoLibreItem(profileId, params.itemId);\n    const after = await updateMercadoLibreItem(profileId, params.itemId, {\n      title: params.title,\n      price: params.price,\n      available_quantity: params.availableQuantity,\n      attributes: params.attributes,\n      sale_terms: params.saleTerms,\n      shipping: params.shipping,\n      status: params.status,\n      listing_type_id: params.listingTypeId,\n      channels: params.channels,\n    });\n\n    return buildMercadoLibreWriteSuccessResponse({\n      profileId,\n      operation: \"update_item_basic_fields\",\n      resourceId: params.itemId,\n      message: \"MercadoLibre item updated successfully.\",\n      before,\n      after,\n    });\n  } catch (err) {\n    return handleMercadoLibreWriteError(err, `Failed to update MercadoLibre item ${params.itemId}`);\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/src/tools/mercadolibre/update-item-description.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/update-item-description.ts"],
-  "sourcesContent": ["import { z } from \"zod\";\r\n\r\nimport {\r\n  createMercadoLibreItemDescription,\r\n  getMercadoLibreItemDescription,\r\n  replaceMercadoLibreItemDescription,\r\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\r\nimport {\r\n  buildMercadoLibreWriteSuccessResponse,\r\n  handleMercadoLibreWriteError,\r\n  mercadolibreProfileIdSchemaField,\r\n  resolveMercadoLibreWriteProfile,\r\n} from \"./write-helpers.js\";\r\n\r\nexport const meliUpdateItemDescriptionSchema = z.object({\r\n  profileId: mercadolibreProfileIdSchemaField,\r\n  itemId: z.string().trim().min(1).describe(\"MercadoLibre item id.\"),\r\n  plainText: z.string().trim().min(1).describe(\"Plain-text description to publish.\"),\r\n});\r\n\r\nexport async function meliUpdateItemDescriptionHandler(\r\n  params: z.infer<typeof meliUpdateItemDescriptionSchema>\r\n) {\r\n  try {\r\n    const profileResolution = await resolveMercadoLibreWriteProfile(params.profileId);\r\n    if (!profileResolution.ok) {\r\n      return profileResolution.response;\r\n    }\r\n\r\n    const profileId = profileResolution.value.profileId;\r\n    let before: Record<string, unknown> | null = null;\r\n    let after: Record<string, unknown>;\r\n\r\n    try {\r\n      before = await getMercadoLibreItemDescription(profileId, params.itemId);\r\n      after = await replaceMercadoLibreItemDescription(profileId, params.itemId, params.plainText);\r\n    } catch {\r\n      after = await createMercadoLibreItemDescription(profileId, params.itemId, params.plainText);\r\n    }\r\n\r\n    return buildMercadoLibreWriteSuccessResponse({\r\n      profileId,\r\n      operation: \"update_item_description\",\r\n      resourceId: params.itemId,\r\n      message: \"MercadoLibre item description updated successfully.\",\r\n      before,\r\n      after,\r\n    });\r\n  } catch (err) {\r\n    return handleMercadoLibreWriteError(err, `Failed to update description for ${params.itemId}`);\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  createMercadoLibreItemDescription,\n  getMercadoLibreItemDescription,\n  replaceMercadoLibreItemDescription,\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\nimport {\n  buildMercadoLibreWriteSuccessResponse,\n  handleMercadoLibreWriteError,\n  mercadolibreProfileIdSchemaField,\n  resolveMercadoLibreWriteProfile,\n} from \"./write-helpers.js\";\n\nexport const meliUpdateItemDescriptionSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  itemId: z.string().trim().min(1).describe(\"MercadoLibre item id.\"),\n  plainText: z.string().trim().min(1).describe(\"Plain-text description to publish.\"),\n});\n\nexport async function meliUpdateItemDescriptionHandler(\n  params: z.infer<typeof meliUpdateItemDescriptionSchema>\n) {\n  try {\n    const profileResolution = await resolveMercadoLibreWriteProfile(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    let before: Record<string, unknown> | null = null;\n    let after: Record<string, unknown>;\n\n    try {\n      before = await getMercadoLibreItemDescription(profileId, params.itemId);\n      after = await replaceMercadoLibreItemDescription(profileId, params.itemId, params.plainText);\n    } catch {\n      after = await createMercadoLibreItemDescription(profileId, params.itemId, params.plainText);\n    }\n\n    return buildMercadoLibreWriteSuccessResponse({\n      profileId,\n      operation: \"update_item_description\",\n      resourceId: params.itemId,\n      message: \"MercadoLibre item description updated successfully.\",\n      before,\n      after,\n    });\n  } catch (err) {\n    return handleMercadoLibreWriteError(err, `Failed to update description for ${params.itemId}`);\n  }\n}\n"],
   "mappings": "AAAA,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,kCAAkC,EAAE,OAAO;AAAA,EACtD,WAAW;AAAA,EACX,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,uBAAuB;AAAA,EACjE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,oCAAoC;AACnF,CAAC;AAED,eAAsB,iCACpB,QACA;AACA,MAAI;AACF,UAAM,oBAAoB,MAAM,gCAAgC,OAAO,SAAS;AAChF,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,YAAY,kBAAkB,MAAM;AAC1C,QAAI,SAAyC;AAC7C,QAAI;AAEJ,QAAI;AACF,eAAS,MAAM,+BAA+B,WAAW,OAAO,MAAM;AACtE,cAAQ,MAAM,mCAAmC,WAAW,OAAO,QAAQ,OAAO,SAAS;AAAA,IAC7F,QAAQ;AACN,cAAQ,MAAM,kCAAkC,WAAW,OAAO,QAAQ,OAAO,SAAS;AAAA,IAC5F;AAEA,WAAO,sCAAsC;AAAA,MAC3C;AAAA,MACA,WAAW;AAAA,MACX,YAAY,OAAO;AAAA,MACnB,SAAS;AAAA,MACT;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,6BAA6B,KAAK,oCAAoC,OAAO,MAAM,EAAE;AAAA,EAC9F;AACF;",
   "names": []
 }

package/dist/src/tools/mercadolibre/update-item-pictures.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/update-item-pictures.ts"],
-  "sourcesContent": ["import { z } from \"zod\";\r\n\r\nimport {\r\n  addMercadoLibreItemPicture,\r\n  getMercadoLibreItem,\r\n  updateMercadoLibreItem,\r\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\r\nimport {\r\n  buildMercadoLibreWriteSuccessResponse,\r\n  handleMercadoLibreWriteError,\r\n  mercadolibreProfileIdSchemaField,\r\n  resolveMercadoLibreWriteProfile,\r\n} from \"./write-helpers.js\";\r\n\r\nexport const meliUpdateItemPicturesSchema = z.object({\r\n  profileId: mercadolibreProfileIdSchemaField,\r\n  itemId: z.string().trim().min(1).describe(\"MercadoLibre item id.\"),\r\n  mode: z.enum([\"add\", \"replace\"]).describe(\"Whether to add new pictures or replace the full pictures array.\"),\r\n  pictures: z\r\n    .array(z.object({ source: z.string().trim().url().describe(\"Public image URL.\") }))\r\n    .min(1)\r\n    .max(12)\r\n    .describe(\"One or more public image URLs to attach.\"),\r\n});\r\n\r\nexport async function meliUpdateItemPicturesHandler(\r\n  params: z.infer<typeof meliUpdateItemPicturesSchema>\r\n) {\r\n  try {\r\n    const profileResolution = await resolveMercadoLibreWriteProfile(params.profileId);\r\n    if (!profileResolution.ok) {\r\n      return profileResolution.response;\r\n    }\r\n\r\n    const profileId = profileResolution.value.profileId;\r\n    const before = await getMercadoLibreItem(profileId, params.itemId);\r\n\r\n    let after: Record<string, unknown>;\r\n    if (params.mode === \"replace\") {\r\n      after = await updateMercadoLibreItem(profileId, params.itemId, {\r\n        pictures: params.pictures,\r\n      });\r\n    } else {\r\n      for (const picture of params.pictures) {\r\n        await addMercadoLibreItemPicture(profileId, params.itemId, picture.source);\r\n      }\r\n      after = await getMercadoLibreItem(profileId, params.itemId);\r\n    }\r\n\r\n    return buildMercadoLibreWriteSuccessResponse({\r\n      profileId,\r\n      operation: \"update_item_pictures\",\r\n      resourceId: params.itemId,\r\n      message: `MercadoLibre item pictures ${params.mode === \"replace\" ? \"replaced\" : \"updated\"} successfully.`,\r\n      before,\r\n      after,\r\n      details: {\r\n        mode: params.mode,\r\n        pictures_count: params.pictures.length,\r\n      },\r\n    });\r\n  } catch (err) {\r\n    return handleMercadoLibreWriteError(err, `Failed to update pictures for ${params.itemId}`);\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  addMercadoLibreItemPicture,\n  getMercadoLibreItem,\n  updateMercadoLibreItem,\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\nimport {\n  buildMercadoLibreWriteSuccessResponse,\n  handleMercadoLibreWriteError,\n  mercadolibreProfileIdSchemaField,\n  resolveMercadoLibreWriteProfile,\n} from \"./write-helpers.js\";\n\nexport const meliUpdateItemPicturesSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  itemId: z.string().trim().min(1).describe(\"MercadoLibre item id.\"),\n  mode: z.enum([\"add\", \"replace\"]).describe(\"Whether to add new pictures or replace the full pictures array.\"),\n  pictures: z\n    .array(z.object({ source: z.string().trim().url().describe(\"Public image URL.\") }))\n    .min(1)\n    .max(12)\n    .describe(\"One or more public image URLs to attach.\"),\n});\n\nexport async function meliUpdateItemPicturesHandler(\n  params: z.infer<typeof meliUpdateItemPicturesSchema>\n) {\n  try {\n    const profileResolution = await resolveMercadoLibreWriteProfile(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    const before = await getMercadoLibreItem(profileId, params.itemId);\n\n    let after: Record<string, unknown>;\n    if (params.mode === \"replace\") {\n      after = await updateMercadoLibreItem(profileId, params.itemId, {\n        pictures: params.pictures,\n      });\n    } else {\n      for (const picture of params.pictures) {\n        await addMercadoLibreItemPicture(profileId, params.itemId, picture.source);\n      }\n      after = await getMercadoLibreItem(profileId, params.itemId);\n    }\n\n    return buildMercadoLibreWriteSuccessResponse({\n      profileId,\n      operation: \"update_item_pictures\",\n      resourceId: params.itemId,\n      message: `MercadoLibre item pictures ${params.mode === \"replace\" ? \"replaced\" : \"updated\"} successfully.`,\n      before,\n      after,\n      details: {\n        mode: params.mode,\n        pictures_count: params.pictures.length,\n      },\n    });\n  } catch (err) {\n    return handleMercadoLibreWriteError(err, `Failed to update pictures for ${params.itemId}`);\n  }\n}\n"],
   "mappings": "AAAA,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,+BAA+B,EAAE,OAAO;AAAA,EACnD,WAAW;AAAA,EACX,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,uBAAuB;AAAA,EACjE,MAAM,EAAE,KAAK,CAAC,OAAO,SAAS,CAAC,EAAE,SAAS,iEAAiE;AAAA,EAC3G,UAAU,EACP,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,mBAAmB,EAAE,CAAC,CAAC,EACjF,IAAI,CAAC,EACL,IAAI,EAAE,EACN,SAAS,0CAA0C;AACxD,CAAC;AAED,eAAsB,8BACpB,QACA;AACA,MAAI;AACF,UAAM,oBAAoB,MAAM,gCAAgC,OAAO,SAAS;AAChF,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,YAAY,kBAAkB,MAAM;AAC1C,UAAM,SAAS,MAAM,oBAAoB,WAAW,OAAO,MAAM;AAEjE,QAAI;AACJ,QAAI,OAAO,SAAS,WAAW;AAC7B,cAAQ,MAAM,uBAAuB,WAAW,OAAO,QAAQ;AAAA,QAC7D,UAAU,OAAO;AAAA,MACnB,CAAC;AAAA,IACH,OAAO;AACL,iBAAW,WAAW,OAAO,UAAU;AACrC,cAAM,2BAA2B,WAAW,OAAO,QAAQ,QAAQ,MAAM;AAAA,MAC3E;AACA,cAAQ,MAAM,oBAAoB,WAAW,OAAO,MAAM;AAAA,IAC5D;AAEA,WAAO,sCAAsC;AAAA,MAC3C;AAAA,MACA,WAAW;AAAA,MACX,YAAY,OAAO;AAAA,MACnB,SAAS,8BAA8B,OAAO,SAAS,YAAY,aAAa,SAAS;AAAA,MACzF;AAAA,MACA;AAAA,MACA,SAAS;AAAA,QACP,MAAM,OAAO;AAAA,QACb,gBAAgB,OAAO,SAAS;AAAA,MAClC;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,6BAA6B,KAAK,iCAAiC,OAAO,MAAM,EAAE;AAAA,EAC3F;AACF;",
   "names": []
 }

package/dist/src/tools/mercadolibre/validate-connection.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/validate-connection.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\r\nimport { z } from \"zod\";\r\n\r\nimport { getMercadoLibreConnectionRow } from \"../../config/mercadolibre-profile-store.js\";\r\nimport { getMercadoLibreAccessForProfile } from \"../../config/mercadolibre.js\";\r\nimport { getMercadoLibreUsersMe, formatMercadoLibreError } from \"../../services/mercadolibre/mercadolibre-api.js\";\r\nimport { stripNulls } from \"../../utils/strip-payload.js\";\r\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\r\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\r\n\r\nexport const meliValidateConnectionSchema = z.object({\r\n  profileId: mercadolibreProfileIdSchemaField,\r\n});\r\n\r\nexport async function meliValidateConnectionHandler(\r\n  params: z.infer<typeof meliValidateConnectionSchema>\r\n) {\r\n  try {\r\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\r\n    if (!profileResolution.ok) {\r\n      return profileResolution.response;\r\n    }\r\n\r\n    const profileId = profileResolution.value.profileId;\r\n    const before = await getMercadoLibreConnectionRow(profileId);\r\n    const access = await getMercadoLibreAccessForProfile(profileId);\r\n    const account = await getMercadoLibreUsersMe(profileId);\r\n    const after = await getMercadoLibreConnectionRow(profileId);\r\n\r\n    const refreshed =\r\n      before?.expiresAt?.toISOString() !== after?.expiresAt?.toISOString() ||\r\n      before?.encryptedAccessToken !== after?.encryptedAccessToken;\r\n\r\n    return object(\r\n      stripNulls({\r\n        profile_id: profileId,\r\n        validation_status: after?.status ?? \"active\",\r\n        refreshed,\r\n        seller_id: access.sellerId,\r\n        account_id: account.id,\r\n        nickname: account.nickname,\r\n        expires_at: access.expiresAt,\r\n        scopes: access.scopes,\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(formatMercadoLibreError(err, \"Failed to validate MercadoLibre connection\"));\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { getMercadoLibreConnectionRow } from \"../../config/mercadolibre-profile-store.js\";\nimport { getMercadoLibreAccessForProfile } from \"../../config/mercadolibre.js\";\nimport { getMercadoLibreUsersMe, formatMercadoLibreError } from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\n\nexport const meliValidateConnectionSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n});\n\nexport async function meliValidateConnectionHandler(\n  params: z.infer<typeof meliValidateConnectionSchema>\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 before = await getMercadoLibreConnectionRow(profileId);\n    const access = await getMercadoLibreAccessForProfile(profileId);\n    const account = await getMercadoLibreUsersMe(profileId);\n    const after = await getMercadoLibreConnectionRow(profileId);\n\n    const refreshed =\n      before?.expiresAt?.toISOString() !== after?.expiresAt?.toISOString() ||\n      before?.encryptedAccessToken !== after?.encryptedAccessToken;\n\n    return object(\n      stripNulls({\n        profile_id: profileId,\n        validation_status: after?.status ?? \"active\",\n        refreshed,\n        seller_id: access.sellerId,\n        account_id: account.id,\n        nickname: account.nickname,\n        expires_at: access.expiresAt,\n        scopes: access.scopes,\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to validate MercadoLibre connection\"));\n  }\n}\n"],
   "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,oCAAoC;AAC7C,SAAS,uCAAuC;AAChD,SAAS,wBAAwB,+BAA+B;AAChE,SAAS,kBAAkB;AAC3B,SAAS,6CAA6C;AACtD,SAAS,wCAAwC;AAE1C,MAAM,+BAA+B,EAAE,OAAO;AAAA,EACnD,WAAW;AACb,CAAC;AAED,eAAsB,8BACpB,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,SAAS,MAAM,6BAA6B,SAAS;AAC3D,UAAM,SAAS,MAAM,gCAAgC,SAAS;AAC9D,UAAM,UAAU,MAAM,uBAAuB,SAAS;AACtD,UAAM,QAAQ,MAAM,6BAA6B,SAAS;AAE1D,UAAM,YACJ,QAAQ,WAAW,YAAY,MAAM,OAAO,WAAW,YAAY,KACnE,QAAQ,yBAAyB,OAAO;AAE1C,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,QACZ,mBAAmB,OAAO,UAAU;AAAA,QACpC;AAAA,QACA,WAAW,OAAO;AAAA,QAClB,YAAY,QAAQ;AAAA,QACpB,UAAU,QAAQ;AAAA,QAClB,YAAY,OAAO;AAAA,QACnB,QAAQ,OAAO;AAAA,MACjB,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,wBAAwB,KAAK,4CAA4C,CAAC;AAAA,EACzF;AACF;",
   "names": []
 }

package/dist/src/tools/mercadolibre/write-helpers.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/write-helpers.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\r\nimport { z } from \"zod\";\r\n\r\nimport { formatMercadoLibreError } from \"../../services/mercadolibre/mercadolibre-api.js\";\r\nimport { stripNulls } from \"../../utils/strip-payload.js\";\r\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\r\n\r\nexport const mercadolibreProfileIdSchemaField = z\r\n  .string()\r\n  .trim()\r\n  .min(1)\r\n  .optional()\r\n  .describe(\r\n    \"Explicit MercadoLibre profile id to use. If omitted, the tool returns a guided selection payload with available active profiles.\"\r\n  );\r\n\r\nexport async function resolveMercadoLibreWriteProfile(profileId?: string) {\r\n  const profileResolution = await resolveMercadoLibreProfileOrSelection(profileId);\r\n  if (!profileResolution.ok) {\r\n    return profileResolution;\r\n  }\r\n\r\n  return {\r\n    ok: true as const,\r\n    value: {\r\n      profileId: profileResolution.value.profileId,\r\n    },\r\n  };\r\n}\r\n\r\nexport function buildMercadoLibreWriteSuccessResponse(params: {\r\n  profileId: string;\r\n  operation: string;\r\n  resourceId?: string;\r\n  message: string;\r\n  before?: Record<string, unknown> | null;\r\n  after?: Record<string, unknown> | null;\r\n  details?: Record<string, unknown>;\r\n}) {\r\n  return object(\r\n    stripNulls({\r\n      ok: true,\r\n      profile_id: params.profileId,\r\n      operation: params.operation,\r\n      resource_id: params.resourceId,\r\n      message: params.message,\r\n      summary: {\r\n        before: params.before,\r\n        after: params.after,\r\n      },\r\n      details: params.details,\r\n    })\r\n  );\r\n}\r\n\r\nexport function handleMercadoLibreWriteError(err: unknown, fallback: string) {\r\n  return error(formatMercadoLibreError(err, fallback));\r\n}\r\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatMercadoLibreError } from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\n\nexport const mercadolibreProfileIdSchemaField = z\n  .string()\n  .trim()\n  .min(1)\n  .optional()\n  .describe(\n    \"Explicit MercadoLibre profile id to use. If omitted, the tool returns a guided selection payload with available active profiles.\"\n  );\n\nexport async function resolveMercadoLibreWriteProfile(profileId?: string) {\n  const profileResolution = await resolveMercadoLibreProfileOrSelection(profileId);\n  if (!profileResolution.ok) {\n    return profileResolution;\n  }\n\n  return {\n    ok: true as const,\n    value: {\n      profileId: profileResolution.value.profileId,\n    },\n  };\n}\n\nexport function buildMercadoLibreWriteSuccessResponse(params: {\n  profileId: string;\n  operation: string;\n  resourceId?: string;\n  message: string;\n  before?: Record<string, unknown> | null;\n  after?: Record<string, unknown> | null;\n  details?: Record<string, unknown>;\n}) {\n  return object(\n    stripNulls({\n      ok: true,\n      profile_id: params.profileId,\n      operation: params.operation,\n      resource_id: params.resourceId,\n      message: params.message,\n      summary: {\n        before: params.before,\n        after: params.after,\n      },\n      details: params.details,\n    })\n  );\n}\n\nexport function handleMercadoLibreWriteError(err: unknown, fallback: string) {\n  return error(formatMercadoLibreError(err, fallback));\n}\n"],
   "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,+BAA+B;AACxC,SAAS,kBAAkB;AAC3B,SAAS,6CAA6C;AAE/C,MAAM,mCAAmC,EAC7C,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT;AAAA,EACC;AACF;AAEF,eAAsB,gCAAgC,WAAoB;AACxE,QAAM,oBAAoB,MAAM,sCAAsC,SAAS;AAC/E,MAAI,CAAC,kBAAkB,IAAI;AACzB,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,MACL,WAAW,kBAAkB,MAAM;AAAA,IACrC;AAAA,EACF;AACF;AAEO,SAAS,sCAAsC,QAQnD;AACD,SAAO;AAAA,IACL,WAAW;AAAA,MACT,IAAI;AAAA,MACJ,YAAY,OAAO;AAAA,MACnB,WAAW,OAAO;AAAA,MAClB,aAAa,OAAO;AAAA,MACpB,SAAS,OAAO;AAAA,MAChB,SAAS;AAAA,QACP,QAAQ,OAAO;AAAA,QACf,OAAO,OAAO;AAAA,MAChB;AAAA,MACA,SAAS,OAAO;AAAA,IAClB,CAAC;AAAA,EACH;AACF;AAEO,SAAS,6BAA6B,KAAc,UAAkB;AAC3E,SAAO,MAAM,wBAAwB,KAAK,QAAQ,CAAC;AACrD;",
   "names": []
 }