@yoryoboy/bi-mcp 1.16.0 → 1.19.0

package/dist/src/config/google-store.js

@@ -87,10 +87,28 @@ async function listProfileGoogleServiceMappings() {
     throw error;
   }
 }
+async function listActiveProfileGtmMappingSummaries() {
+  try {
+    const result = await getDb().query(
+      `select profile_id, count(*) as active_mapping_count
+       from profile_gtm_mappings
+       where status = 'active'
+       group by profile_id`
+    );
+    return result.rows.map((row) => ({
+      profileId: row.profile_id,
+      activeMappingCount: Number(row.active_mapping_count)
+    }));
+  } catch (error) {
+    if (isMissingRelationError(error)) return [];
+    throw error;
+  }
+}
 export {
   getActiveGoogleRefreshTokenFromStore,
   getGoogleOAuthConnection,
   getProfileGoogleServiceMapping,
+  listActiveProfileGtmMappingSummaries,
   listProfileGoogleServiceMappings
 };
 //# sourceMappingURL=google-store.js.map

package/dist/src/config/google-store.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/config/google-store.ts"],
-  "sourcesContent": ["import { getDb } from '../db/client.js';\nimport { decryptSecret } from './vtex-crypto.js';\n\nexport type GoogleServiceStatus = 'active' | 'disabled' | 'expired' | 'error' | 'pending';\n\nexport interface GoogleOAuthConnectionRecord {\n  id: string;\n  encryptedRefreshToken: string | null;\n  scopes: string[];\n  status: GoogleServiceStatus;\n  googleAccountEmail: string | null;\n  lastValidatedAt: Date | null;\n  lastError: string | null;\n}\n\nexport interface ProfileGoogleServiceMappingRecord {\n  profileId: string;\n  googleAdsCustomerId: string | null;\n  googleAdsLabel: string | null;\n  googleAdsStatus: GoogleServiceStatus;\n  googleAdsLastValidatedAt: Date | null;\n  googleAdsLastError: string | null;\n  ga4PropertyId: string | null;\n  ga4PropertyLabel: string | null;\n  ga4Status: GoogleServiceStatus;\n  ga4LastValidatedAt: Date | null;\n  ga4LastError: string | null;\n  searchConsoleSiteUrl: string | null;\n  searchConsoleLabel: string | null;\n  searchConsoleStatus: GoogleServiceStatus;\n  searchConsoleLastValidatedAt: Date | null;\n  searchConsoleLastError: string | null;\n  updatedAt: Date | null;\n}\n\ninterface GoogleOAuthConnectionRow {\n  id: string;\n  encrypted_refresh_token: string | null;\n  scopes: string[] | null;\n  status: GoogleServiceStatus;\n  google_account_email: string | null;\n  last_validated_at: Date | null;\n  last_error: string | null;\n}\n\ninterface ProfileGoogleServiceMappingRow {\n  profile_id: string;\n  google_ads_customer_id: string | null;\n  google_ads_label: string | null;\n  google_ads_status: GoogleServiceStatus;\n  google_ads_last_validated_at: Date | null;\n  google_ads_last_error: string | null;\n  ga4_property_id: string | null;\n  ga4_property_label: string | null;\n  ga4_status: GoogleServiceStatus;\n  ga4_last_validated_at: Date | null;\n  ga4_last_error: string | null;\n  search_console_site_url: string | null;\n  search_console_label: string | null;\n  search_console_status: GoogleServiceStatus;\n  search_console_last_validated_at: Date | null;\n  search_console_last_error: string | null;\n  updated_at: Date | null;\n}\n\nfunction isMissingRelationError(error: unknown): boolean {\n  return error instanceof Error && /does not exist/i.test(error.message);\n}\n\nfunction mapConnection(row: GoogleOAuthConnectionRow): GoogleOAuthConnectionRecord {\n  return {\n    id: row.id,\n    encryptedRefreshToken: row.encrypted_refresh_token,\n    scopes: Array.isArray(row.scopes) ? row.scopes : [],\n    status: row.status,\n    googleAccountEmail: row.google_account_email,\n    lastValidatedAt: row.last_validated_at,\n    lastError: row.last_error,\n  };\n}\n\nfunction mapMapping(row: ProfileGoogleServiceMappingRow): ProfileGoogleServiceMappingRecord {\n  return {\n    profileId: row.profile_id,\n    googleAdsCustomerId: row.google_ads_customer_id,\n    googleAdsLabel: row.google_ads_label,\n    googleAdsStatus: row.google_ads_status,\n    googleAdsLastValidatedAt: row.google_ads_last_validated_at,\n    googleAdsLastError: row.google_ads_last_error,\n    ga4PropertyId: row.ga4_property_id,\n    ga4PropertyLabel: row.ga4_property_label,\n    ga4Status: row.ga4_status,\n    ga4LastValidatedAt: row.ga4_last_validated_at,\n    ga4LastError: row.ga4_last_error,\n    searchConsoleSiteUrl: row.search_console_site_url,\n    searchConsoleLabel: row.search_console_label,\n    searchConsoleStatus: row.search_console_status,\n    searchConsoleLastValidatedAt: row.search_console_last_validated_at,\n    searchConsoleLastError: row.search_console_last_error,\n    updatedAt: row.updated_at,\n  };\n}\n\nexport async function getGoogleOAuthConnection(): Promise<GoogleOAuthConnectionRecord | null> {\n  try {\n    const result = await getDb().query<GoogleOAuthConnectionRow>(\n      `select id, encrypted_refresh_token, scopes, status, google_account_email, last_validated_at, last_error\n       from google_oauth_connections\n       where id = 'global'`\n    );\n    const row = result.rows[0];\n    return row ? mapConnection(row) : null;\n  } catch (error) {\n    if (isMissingRelationError(error)) return null;\n    throw error;\n  }\n}\n\nexport async function getActiveGoogleRefreshTokenFromStore(): Promise<string | null> {\n  const connection = await getGoogleOAuthConnection();\n  if (!connection || connection.status !== 'active' || !connection.encryptedRefreshToken) return null;\n  return decryptSecret(connection.encryptedRefreshToken);\n}\n\nexport async function getProfileGoogleServiceMapping(profileId: string): Promise<ProfileGoogleServiceMappingRecord | null> {\n  try {\n    const result = await getDb().query<ProfileGoogleServiceMappingRow>(\n      `select profile_id, google_ads_customer_id, google_ads_label, google_ads_status, google_ads_last_validated_at, google_ads_last_error,\n              ga4_property_id, ga4_property_label, ga4_status, ga4_last_validated_at, ga4_last_error,\n              search_console_site_url, search_console_label, search_console_status, search_console_last_validated_at, search_console_last_error,\n              updated_at\n       from profile_google_service_mappings\n       where profile_id = $1`,\n      [profileId]\n    );\n    const row = result.rows[0];\n    return row ? mapMapping(row) : null;\n  } catch (error) {\n    if (isMissingRelationError(error)) return null;\n    throw error;\n  }\n}\n\nexport async function listProfileGoogleServiceMappings(): Promise<ProfileGoogleServiceMappingRecord[]> {\n  try {\n    const result = await getDb().query<ProfileGoogleServiceMappingRow>(\n      `select profile_id, google_ads_customer_id, google_ads_label, google_ads_status, google_ads_last_validated_at, google_ads_last_error,\n              ga4_property_id, ga4_property_label, ga4_status, ga4_last_validated_at, ga4_last_error,\n              search_console_site_url, search_console_label, search_console_status, search_console_last_validated_at, search_console_last_error,\n              updated_at\n       from profile_google_service_mappings`\n    );\n    return result.rows.map(mapMapping);\n  } catch (error) {\n    if (isMissingRelationError(error)) return [];\n    throw error;\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,aAAa;AACtB,SAAS,qBAAqB;AAgE9B,SAAS,uBAAuB,OAAyB;AACvD,SAAO,iBAAiB,SAAS,kBAAkB,KAAK,MAAM,OAAO;AACvE;AAEA,SAAS,cAAc,KAA4D;AACjF,SAAO;AAAA,IACL,IAAI,IAAI;AAAA,IACR,uBAAuB,IAAI;AAAA,IAC3B,QAAQ,MAAM,QAAQ,IAAI,MAAM,IAAI,IAAI,SAAS,CAAC;AAAA,IAClD,QAAQ,IAAI;AAAA,IACZ,oBAAoB,IAAI;AAAA,IACxB,iBAAiB,IAAI;AAAA,IACrB,WAAW,IAAI;AAAA,EACjB;AACF;AAEA,SAAS,WAAW,KAAwE;AAC1F,SAAO;AAAA,IACL,WAAW,IAAI;AAAA,IACf,qBAAqB,IAAI;AAAA,IACzB,gBAAgB,IAAI;AAAA,IACpB,iBAAiB,IAAI;AAAA,IACrB,0BAA0B,IAAI;AAAA,IAC9B,oBAAoB,IAAI;AAAA,IACxB,eAAe,IAAI;AAAA,IACnB,kBAAkB,IAAI;AAAA,IACtB,WAAW,IAAI;AAAA,IACf,oBAAoB,IAAI;AAAA,IACxB,cAAc,IAAI;AAAA,IAClB,sBAAsB,IAAI;AAAA,IAC1B,oBAAoB,IAAI;AAAA,IACxB,qBAAqB,IAAI;AAAA,IACzB,8BAA8B,IAAI;AAAA,IAClC,wBAAwB,IAAI;AAAA,IAC5B,WAAW,IAAI;AAAA,EACjB;AACF;AAEA,eAAsB,2BAAwE;AAC5F,MAAI;AACF,UAAM,SAAS,MAAM,MAAM,EAAE;AAAA,MAC3B;AAAA;AAAA;AAAA,IAGF;AACA,UAAM,MAAM,OAAO,KAAK,CAAC;AACzB,WAAO,MAAM,cAAc,GAAG,IAAI;AAAA,EACpC,SAAS,OAAO;AACd,QAAI,uBAAuB,KAAK,EAAG,QAAO;AAC1C,UAAM;AAAA,EACR;AACF;AAEA,eAAsB,uCAA+D;AACnF,QAAM,aAAa,MAAM,yBAAyB;AAClD,MAAI,CAAC,cAAc,WAAW,WAAW,YAAY,CAAC,WAAW,sBAAuB,QAAO;AAC/F,SAAO,cAAc,WAAW,qBAAqB;AACvD;AAEA,eAAsB,+BAA+B,WAAsE;AACzH,MAAI;AACF,UAAM,SAAS,MAAM,MAAM,EAAE;AAAA,MAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMA,CAAC,SAAS;AAAA,IACZ;AACA,UAAM,MAAM,OAAO,KAAK,CAAC;AACzB,WAAO,MAAM,WAAW,GAAG,IAAI;AAAA,EACjC,SAAS,OAAO;AACd,QAAI,uBAAuB,KAAK,EAAG,QAAO;AAC1C,UAAM;AAAA,EACR;AACF;AAEA,eAAsB,mCAAiF;AACrG,MAAI;AACF,UAAM,SAAS,MAAM,MAAM,EAAE;AAAA,MAC3B;AAAA;AAAA;AAAA;AAAA;AAAA,IAKF;AACA,WAAO,OAAO,KAAK,IAAI,UAAU;AAAA,EACnC,SAAS,OAAO;AACd,QAAI,uBAAuB,KAAK,EAAG,QAAO,CAAC;AAC3C,UAAM;AAAA,EACR;AACF;",
+  "sourcesContent": ["import { getDb } from '../db/client.js';\nimport { decryptSecret } from './vtex-crypto.js';\n\nexport type GoogleServiceStatus = 'active' | 'disabled' | 'expired' | 'error' | 'pending';\n\nexport interface GoogleOAuthConnectionRecord {\n  id: string;\n  encryptedRefreshToken: string | null;\n  scopes: string[];\n  status: GoogleServiceStatus;\n  googleAccountEmail: string | null;\n  lastValidatedAt: Date | null;\n  lastError: string | null;\n}\n\nexport interface ProfileGoogleServiceMappingRecord {\n  profileId: string;\n  googleAdsCustomerId: string | null;\n  googleAdsLabel: string | null;\n  googleAdsStatus: GoogleServiceStatus;\n  googleAdsLastValidatedAt: Date | null;\n  googleAdsLastError: string | null;\n  ga4PropertyId: string | null;\n  ga4PropertyLabel: string | null;\n  ga4Status: GoogleServiceStatus;\n  ga4LastValidatedAt: Date | null;\n  ga4LastError: string | null;\n  searchConsoleSiteUrl: string | null;\n  searchConsoleLabel: string | null;\n  searchConsoleStatus: GoogleServiceStatus;\n  searchConsoleLastValidatedAt: Date | null;\n  searchConsoleLastError: string | null;\n  updatedAt: Date | null;\n}\n\nexport interface ProfileGtmMappingSummaryRecord {\n  profileId: string;\n  activeMappingCount: number;\n}\n\ninterface GoogleOAuthConnectionRow {\n  id: string;\n  encrypted_refresh_token: string | null;\n  scopes: string[] | null;\n  status: GoogleServiceStatus;\n  google_account_email: string | null;\n  last_validated_at: Date | null;\n  last_error: string | null;\n}\n\ninterface ProfileGoogleServiceMappingRow {\n  profile_id: string;\n  google_ads_customer_id: string | null;\n  google_ads_label: string | null;\n  google_ads_status: GoogleServiceStatus;\n  google_ads_last_validated_at: Date | null;\n  google_ads_last_error: string | null;\n  ga4_property_id: string | null;\n  ga4_property_label: string | null;\n  ga4_status: GoogleServiceStatus;\n  ga4_last_validated_at: Date | null;\n  ga4_last_error: string | null;\n  search_console_site_url: string | null;\n  search_console_label: string | null;\n  search_console_status: GoogleServiceStatus;\n  search_console_last_validated_at: Date | null;\n  search_console_last_error: string | null;\n  updated_at: Date | null;\n}\n\ninterface ProfileGtmMappingSummaryRow {\n  profile_id: string;\n  active_mapping_count: string | number;\n}\n\nfunction isMissingRelationError(error: unknown): boolean {\n  return error instanceof Error && /does not exist/i.test(error.message);\n}\n\nfunction mapConnection(row: GoogleOAuthConnectionRow): GoogleOAuthConnectionRecord {\n  return {\n    id: row.id,\n    encryptedRefreshToken: row.encrypted_refresh_token,\n    scopes: Array.isArray(row.scopes) ? row.scopes : [],\n    status: row.status,\n    googleAccountEmail: row.google_account_email,\n    lastValidatedAt: row.last_validated_at,\n    lastError: row.last_error,\n  };\n}\n\nfunction mapMapping(row: ProfileGoogleServiceMappingRow): ProfileGoogleServiceMappingRecord {\n  return {\n    profileId: row.profile_id,\n    googleAdsCustomerId: row.google_ads_customer_id,\n    googleAdsLabel: row.google_ads_label,\n    googleAdsStatus: row.google_ads_status,\n    googleAdsLastValidatedAt: row.google_ads_last_validated_at,\n    googleAdsLastError: row.google_ads_last_error,\n    ga4PropertyId: row.ga4_property_id,\n    ga4PropertyLabel: row.ga4_property_label,\n    ga4Status: row.ga4_status,\n    ga4LastValidatedAt: row.ga4_last_validated_at,\n    ga4LastError: row.ga4_last_error,\n    searchConsoleSiteUrl: row.search_console_site_url,\n    searchConsoleLabel: row.search_console_label,\n    searchConsoleStatus: row.search_console_status,\n    searchConsoleLastValidatedAt: row.search_console_last_validated_at,\n    searchConsoleLastError: row.search_console_last_error,\n    updatedAt: row.updated_at,\n  };\n}\n\nexport async function getGoogleOAuthConnection(): Promise<GoogleOAuthConnectionRecord | null> {\n  try {\n    const result = await getDb().query<GoogleOAuthConnectionRow>(\n      `select id, encrypted_refresh_token, scopes, status, google_account_email, last_validated_at, last_error\n       from google_oauth_connections\n       where id = 'global'`\n    );\n    const row = result.rows[0];\n    return row ? mapConnection(row) : null;\n  } catch (error) {\n    if (isMissingRelationError(error)) return null;\n    throw error;\n  }\n}\n\nexport async function getActiveGoogleRefreshTokenFromStore(): Promise<string | null> {\n  const connection = await getGoogleOAuthConnection();\n  if (!connection || connection.status !== 'active' || !connection.encryptedRefreshToken) return null;\n  return decryptSecret(connection.encryptedRefreshToken);\n}\n\nexport async function getProfileGoogleServiceMapping(profileId: string): Promise<ProfileGoogleServiceMappingRecord | null> {\n  try {\n    const result = await getDb().query<ProfileGoogleServiceMappingRow>(\n      `select profile_id, google_ads_customer_id, google_ads_label, google_ads_status, google_ads_last_validated_at, google_ads_last_error,\n              ga4_property_id, ga4_property_label, ga4_status, ga4_last_validated_at, ga4_last_error,\n              search_console_site_url, search_console_label, search_console_status, search_console_last_validated_at, search_console_last_error,\n              updated_at\n       from profile_google_service_mappings\n       where profile_id = $1`,\n      [profileId]\n    );\n    const row = result.rows[0];\n    return row ? mapMapping(row) : null;\n  } catch (error) {\n    if (isMissingRelationError(error)) return null;\n    throw error;\n  }\n}\n\nexport async function listProfileGoogleServiceMappings(): Promise<ProfileGoogleServiceMappingRecord[]> {\n  try {\n    const result = await getDb().query<ProfileGoogleServiceMappingRow>(\n      `select profile_id, google_ads_customer_id, google_ads_label, google_ads_status, google_ads_last_validated_at, google_ads_last_error,\n              ga4_property_id, ga4_property_label, ga4_status, ga4_last_validated_at, ga4_last_error,\n              search_console_site_url, search_console_label, search_console_status, search_console_last_validated_at, search_console_last_error,\n              updated_at\n       from profile_google_service_mappings`\n    );\n    return result.rows.map(mapMapping);\n  } catch (error) {\n    if (isMissingRelationError(error)) return [];\n    throw error;\n  }\n}\n\nexport async function listActiveProfileGtmMappingSummaries(): Promise<\n  ProfileGtmMappingSummaryRecord[]\n> {\n  try {\n    const result = await getDb().query<ProfileGtmMappingSummaryRow>(\n      `select profile_id, count(*) as active_mapping_count\n       from profile_gtm_mappings\n       where status = 'active'\n       group by profile_id`,\n    );\n    return result.rows.map((row) => ({\n      profileId: row.profile_id,\n      activeMappingCount: Number(row.active_mapping_count),\n    }));\n  } catch (error) {\n    if (isMissingRelationError(error)) return [];\n    throw error;\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,aAAa;AACtB,SAAS,qBAAqB;AA0E9B,SAAS,uBAAuB,OAAyB;AACvD,SAAO,iBAAiB,SAAS,kBAAkB,KAAK,MAAM,OAAO;AACvE;AAEA,SAAS,cAAc,KAA4D;AACjF,SAAO;AAAA,IACL,IAAI,IAAI;AAAA,IACR,uBAAuB,IAAI;AAAA,IAC3B,QAAQ,MAAM,QAAQ,IAAI,MAAM,IAAI,IAAI,SAAS,CAAC;AAAA,IAClD,QAAQ,IAAI;AAAA,IACZ,oBAAoB,IAAI;AAAA,IACxB,iBAAiB,IAAI;AAAA,IACrB,WAAW,IAAI;AAAA,EACjB;AACF;AAEA,SAAS,WAAW,KAAwE;AAC1F,SAAO;AAAA,IACL,WAAW,IAAI;AAAA,IACf,qBAAqB,IAAI;AAAA,IACzB,gBAAgB,IAAI;AAAA,IACpB,iBAAiB,IAAI;AAAA,IACrB,0BAA0B,IAAI;AAAA,IAC9B,oBAAoB,IAAI;AAAA,IACxB,eAAe,IAAI;AAAA,IACnB,kBAAkB,IAAI;AAAA,IACtB,WAAW,IAAI;AAAA,IACf,oBAAoB,IAAI;AAAA,IACxB,cAAc,IAAI;AAAA,IAClB,sBAAsB,IAAI;AAAA,IAC1B,oBAAoB,IAAI;AAAA,IACxB,qBAAqB,IAAI;AAAA,IACzB,8BAA8B,IAAI;AAAA,IAClC,wBAAwB,IAAI;AAAA,IAC5B,WAAW,IAAI;AAAA,EACjB;AACF;AAEA,eAAsB,2BAAwE;AAC5F,MAAI;AACF,UAAM,SAAS,MAAM,MAAM,EAAE;AAAA,MAC3B;AAAA;AAAA;AAAA,IAGF;AACA,UAAM,MAAM,OAAO,KAAK,CAAC;AACzB,WAAO,MAAM,cAAc,GAAG,IAAI;AAAA,EACpC,SAAS,OAAO;AACd,QAAI,uBAAuB,KAAK,EAAG,QAAO;AAC1C,UAAM;AAAA,EACR;AACF;AAEA,eAAsB,uCAA+D;AACnF,QAAM,aAAa,MAAM,yBAAyB;AAClD,MAAI,CAAC,cAAc,WAAW,WAAW,YAAY,CAAC,WAAW,sBAAuB,QAAO;AAC/F,SAAO,cAAc,WAAW,qBAAqB;AACvD;AAEA,eAAsB,+BAA+B,WAAsE;AACzH,MAAI;AACF,UAAM,SAAS,MAAM,MAAM,EAAE;AAAA,MAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMA,CAAC,SAAS;AAAA,IACZ;AACA,UAAM,MAAM,OAAO,KAAK,CAAC;AACzB,WAAO,MAAM,WAAW,GAAG,IAAI;AAAA,EACjC,SAAS,OAAO;AACd,QAAI,uBAAuB,KAAK,EAAG,QAAO;AAC1C,UAAM;AAAA,EACR;AACF;AAEA,eAAsB,mCAAiF;AACrG,MAAI;AACF,UAAM,SAAS,MAAM,MAAM,EAAE;AAAA,MAC3B;AAAA;AAAA;AAAA;AAAA;AAAA,IAKF;AACA,WAAO,OAAO,KAAK,IAAI,UAAU;AAAA,EACnC,SAAS,OAAO;AACd,QAAI,uBAAuB,KAAK,EAAG,QAAO,CAAC;AAC3C,UAAM;AAAA,EACR;AACF;AAEA,eAAsB,uCAEpB;AACA,MAAI;AACF,UAAM,SAAS,MAAM,MAAM,EAAE;AAAA,MAC3B;AAAA;AAAA;AAAA;AAAA,IAIF;AACA,WAAO,OAAO,KAAK,IAAI,CAAC,SAAS;AAAA,MAC/B,WAAW,IAAI;AAAA,MACf,oBAAoB,OAAO,IAAI,oBAAoB;AAAA,IACrD,EAAE;AAAA,EACJ,SAAS,OAAO;AACd,QAAI,uBAAuB,KAAK,EAAG,QAAO,CAAC;AAC3C,UAAM;AAAA,EACR;AACF;",
   "names": []
 }

package/dist/src/config/mcp-tool-deadline-context.js

@@ -0,0 +1,34 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const deadlineContext = new AsyncLocalStorage();
+function runWithMcpToolDeadlineContext(signal, callback, deadlineAt) {
+  return deadlineContext.run({ signal, deadlineAt }, callback);
+}
+function getMcpToolDeadlineSignal() {
+  return deadlineContext.getStore()?.signal;
+}
+function getMcpToolDeadlineRemainingMs(now = Date.now()) {
+  const deadlineAt = deadlineContext.getStore()?.deadlineAt;
+  return deadlineAt === void 0 ? void 0 : Math.max(0, deadlineAt - now);
+}
+function composeMcpToolDeadlineSignal(signal) {
+  const deadlineSignal = getMcpToolDeadlineSignal();
+  if (!deadlineSignal) return signal;
+  if (!signal || signal === deadlineSignal) return deadlineSignal;
+  if (!signal.addEventListener) return deadlineSignal;
+  const controller = new AbortController();
+  const abort = () => controller.abort();
+  if (deadlineSignal.aborted || signal.aborted) {
+    controller.abort();
+  } else {
+    deadlineSignal.addEventListener("abort", abort, { once: true });
+    signal.addEventListener("abort", abort, { once: true });
+  }
+  return controller.signal;
+}
+export {
+  composeMcpToolDeadlineSignal,
+  getMcpToolDeadlineRemainingMs,
+  getMcpToolDeadlineSignal,
+  runWithMcpToolDeadlineContext
+};
+//# sourceMappingURL=mcp-tool-deadline-context.js.map

package/dist/src/config/mcp-tool-deadline-context.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/config/mcp-tool-deadline-context.ts"],
+  "sourcesContent": ["import { AsyncLocalStorage } from \"node:async_hooks\";\n\ntype DeadlineContext = { signal: AbortSignal; deadlineAt?: number };\ntype CompatibleAbortSignal = {\n  readonly aborted: boolean;\n  addEventListener?: (...args: any[]) => any;\n};\n\nconst deadlineContext = new AsyncLocalStorage<DeadlineContext>();\n\nexport function runWithMcpToolDeadlineContext<T>(\n  signal: AbortSignal,\n  callback: () => Promise<T>,\n  deadlineAt?: number,\n): Promise<T> {\n  return deadlineContext.run({ signal, deadlineAt }, callback);\n}\n\nexport function getMcpToolDeadlineSignal(): AbortSignal | undefined {\n  return deadlineContext.getStore()?.signal;\n}\n\nexport function getMcpToolDeadlineRemainingMs(now = Date.now()): number | undefined {\n  const deadlineAt = deadlineContext.getStore()?.deadlineAt;\n  return deadlineAt === undefined ? undefined : Math.max(0, deadlineAt - now);\n}\n\nexport function composeMcpToolDeadlineSignal(signal?: CompatibleAbortSignal): CompatibleAbortSignal | undefined {\n  const deadlineSignal = getMcpToolDeadlineSignal();\n  if (!deadlineSignal) return signal;\n  if (!signal || signal === deadlineSignal) return deadlineSignal;\n\n  if (!signal.addEventListener) return deadlineSignal;\n\n  const controller = new AbortController();\n  const abort = () => controller.abort();\n  if (deadlineSignal.aborted || signal.aborted) {\n    controller.abort();\n  } else {\n    deadlineSignal.addEventListener(\"abort\", abort, { once: true });\n    signal.addEventListener(\"abort\", abort, { once: true });\n  }\n  return controller.signal;\n}\n"],
+  "mappings": "AAAA,SAAS,yBAAyB;AAQlC,MAAM,kBAAkB,IAAI,kBAAmC;AAExD,SAAS,8BACd,QACA,UACA,YACY;AACZ,SAAO,gBAAgB,IAAI,EAAE,QAAQ,WAAW,GAAG,QAAQ;AAC7D;AAEO,SAAS,2BAAoD;AAClE,SAAO,gBAAgB,SAAS,GAAG;AACrC;AAEO,SAAS,8BAA8B,MAAM,KAAK,IAAI,GAAuB;AAClF,QAAM,aAAa,gBAAgB,SAAS,GAAG;AAC/C,SAAO,eAAe,SAAY,SAAY,KAAK,IAAI,GAAG,aAAa,GAAG;AAC5E;AAEO,SAAS,6BAA6B,QAAmE;AAC9G,QAAM,iBAAiB,yBAAyB;AAChD,MAAI,CAAC,eAAgB,QAAO;AAC5B,MAAI,CAAC,UAAU,WAAW,eAAgB,QAAO;AAEjD,MAAI,CAAC,OAAO,iBAAkB,QAAO;AAErC,QAAM,aAAa,IAAI,gBAAgB;AACvC,QAAM,QAAQ,MAAM,WAAW,MAAM;AACrC,MAAI,eAAe,WAAW,OAAO,SAAS;AAC5C,eAAW,MAAM;AAAA,EACnB,OAAO;AACL,mBAAe,iBAAiB,SAAS,OAAO,EAAE,MAAM,KAAK,CAAC;AAC9D,WAAO,iBAAiB,SAAS,OAAO,EAAE,MAAM,KAAK,CAAC;AAAA,EACxD;AACA,SAAO,WAAW;AACpB;",
+  "names": []
+}

package/dist/src/config/mcp-tool-deadline.js

@@ -0,0 +1,67 @@
+import { error } from "mcp-use/server";
+import { runWithMcpToolDeadlineContext } from "./mcp-tool-deadline-context.js";
+const DEFAULT_MCP_TOOL_TOTAL_DEADLINE_MS = 3e5;
+const MCP_TOOL_TOTAL_DEADLINE_ENV = "MCP_TOOL_TOTAL_DEADLINE_MS";
+function parsePositiveInteger(value, fallback) {
+  if (value === void 0 || value === "") return fallback;
+  if (!/^\d+$/.test(value)) {
+    throw new Error(`${MCP_TOOL_TOTAL_DEADLINE_ENV} must be a positive integer`);
+  }
+  const parsed = Number(value);
+  if (!Number.isSafeInteger(parsed) || parsed <= 0) {
+    throw new Error(`${MCP_TOOL_TOTAL_DEADLINE_ENV} must be a positive integer`);
+  }
+  return parsed;
+}
+const MCP_TOOL_TOTAL_DEADLINE_MS = parsePositiveInteger(
+  process.env[MCP_TOOL_TOTAL_DEADLINE_ENV],
+  DEFAULT_MCP_TOOL_TOTAL_DEADLINE_MS
+);
+function createMcpToolDeadlineMiddleware(deadlineMs = MCP_TOOL_TOTAL_DEADLINE_MS, options = {}) {
+  if (!Number.isSafeInteger(deadlineMs) || deadlineMs <= 0) {
+    throw new Error("MCP tool deadline must be a positive integer");
+  }
+  return async (ctx, next) => {
+    const startedAt = Date.now();
+    const controller = new AbortController();
+    let timer;
+    let timedOut = false;
+    const operation = runWithMcpToolDeadlineContext(controller.signal, next, startedAt + deadlineMs);
+    void operation.catch(() => void 0);
+    try {
+      return await Promise.race([
+        operation,
+        new Promise((resolve) => {
+          timer = setTimeout(
+            () => {
+              timedOut = true;
+              controller.abort();
+              const event = {
+                tool_name: typeof ctx.params?.name === "string" ? ctx.params.name : "unknown",
+                elapsed_ms: Math.max(0, Date.now() - startedAt),
+                deadline_ms: deadlineMs,
+                outcome: "deadline_exceeded"
+              };
+              (options.onDeadlineExceeded ?? ((deadlineEvent) => {
+                console.warn("[MCP TOOL DEADLINE]", JSON.stringify(deadlineEvent));
+              }))(event);
+              resolve(error(`MCP tool deadline exceeded (deadline_ms=${deadlineMs}; cancellation=cooperative; non_cooperative_boundaries=present)`));
+            },
+            deadlineMs
+          );
+        })
+      ]);
+    } finally {
+      if (timer) clearTimeout(timer);
+      if (!timedOut) controller.abort();
+    }
+  };
+}
+export {
+  DEFAULT_MCP_TOOL_TOTAL_DEADLINE_MS,
+  MCP_TOOL_TOTAL_DEADLINE_ENV,
+  MCP_TOOL_TOTAL_DEADLINE_MS,
+  createMcpToolDeadlineMiddleware,
+  parsePositiveInteger
+};
+//# sourceMappingURL=mcp-tool-deadline.js.map

package/dist/src/config/mcp-tool-deadline.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/config/mcp-tool-deadline.ts"],
+  "sourcesContent": ["import { error } from \"mcp-use/server\";\n\nimport { runWithMcpToolDeadlineContext } from \"./mcp-tool-deadline-context.js\";\n\nexport const DEFAULT_MCP_TOOL_TOTAL_DEADLINE_MS = 300_000;\nexport const MCP_TOOL_TOTAL_DEADLINE_ENV = \"MCP_TOOL_TOTAL_DEADLINE_MS\";\n\nexport function parsePositiveInteger(value: string | undefined, fallback: number): number {\n  if (value === undefined || value === \"\") return fallback;\n  if (!/^\\d+$/.test(value)) {\n    throw new Error(`${MCP_TOOL_TOTAL_DEADLINE_ENV} must be a positive integer`);\n  }\n\n  const parsed = Number(value);\n  if (!Number.isSafeInteger(parsed) || parsed <= 0) {\n    throw new Error(`${MCP_TOOL_TOTAL_DEADLINE_ENV} must be a positive integer`);\n  }\n\n  return parsed;\n}\n\nexport const MCP_TOOL_TOTAL_DEADLINE_MS = parsePositiveInteger(\n  process.env[MCP_TOOL_TOTAL_DEADLINE_ENV],\n  DEFAULT_MCP_TOOL_TOTAL_DEADLINE_MS,\n);\n\nexport interface McpToolDeadlineEvent {\n  tool_name: string;\n  elapsed_ms: number;\n  deadline_ms: number;\n  outcome: \"deadline_exceeded\";\n}\n\nexport interface McpToolDeadlineMiddlewareOptions {\n  onDeadlineExceeded?: (event: McpToolDeadlineEvent) => void;\n}\n\nexport function createMcpToolDeadlineMiddleware(\n  deadlineMs = MCP_TOOL_TOTAL_DEADLINE_MS,\n  options: McpToolDeadlineMiddlewareOptions = {},\n) {\n  if (!Number.isSafeInteger(deadlineMs) || deadlineMs <= 0) {\n    throw new Error(\"MCP tool deadline must be a positive integer\");\n  }\n\n  return async (ctx: { params?: { name?: unknown } }, next: () => Promise<unknown>) => {\n    const startedAt = Date.now();\n    const controller = new AbortController();\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    let timedOut = false;\n    const operation = runWithMcpToolDeadlineContext(controller.signal, next, startedAt + deadlineMs);\n    // A late rejection must be observed after the caller-visible deadline response.\n    void operation.catch(() => undefined);\n    try {\n      return await Promise.race([\n        operation,\n        new Promise<ReturnType<typeof error>>((resolve) => {\n          timer = setTimeout(\n            () => {\n              timedOut = true;\n              controller.abort();\n              const event: McpToolDeadlineEvent = {\n                tool_name: typeof ctx.params?.name === \"string\" ? ctx.params.name : \"unknown\",\n                elapsed_ms: Math.max(0, Date.now() - startedAt),\n                deadline_ms: deadlineMs,\n                outcome: \"deadline_exceeded\",\n              };\n              (options.onDeadlineExceeded ?? ((deadlineEvent: McpToolDeadlineEvent) => {\n                console.warn(\"[MCP TOOL DEADLINE]\", JSON.stringify(deadlineEvent));\n              }))(event);\n              resolve(error(`MCP tool deadline exceeded (deadline_ms=${deadlineMs}; cancellation=cooperative; non_cooperative_boundaries=present)`));\n            },\n            deadlineMs,\n          );\n        }),\n      ]);\n    } finally {\n      if (timer) clearTimeout(timer);\n      if (!timedOut) controller.abort();\n    }\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,aAAa;AAEtB,SAAS,qCAAqC;AAEvC,MAAM,qCAAqC;AAC3C,MAAM,8BAA8B;AAEpC,SAAS,qBAAqB,OAA2B,UAA0B;AACxF,MAAI,UAAU,UAAa,UAAU,GAAI,QAAO;AAChD,MAAI,CAAC,QAAQ,KAAK,KAAK,GAAG;AACxB,UAAM,IAAI,MAAM,GAAG,2BAA2B,6BAA6B;AAAA,EAC7E;AAEA,QAAM,SAAS,OAAO,KAAK;AAC3B,MAAI,CAAC,OAAO,cAAc,MAAM,KAAK,UAAU,GAAG;AAChD,UAAM,IAAI,MAAM,GAAG,2BAA2B,6BAA6B;AAAA,EAC7E;AAEA,SAAO;AACT;AAEO,MAAM,6BAA6B;AAAA,EACxC,QAAQ,IAAI,2BAA2B;AAAA,EACvC;AACF;AAaO,SAAS,gCACd,aAAa,4BACb,UAA4C,CAAC,GAC7C;AACA,MAAI,CAAC,OAAO,cAAc,UAAU,KAAK,cAAc,GAAG;AACxD,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AAEA,SAAO,OAAO,KAAsC,SAAiC;AACnF,UAAM,YAAY,KAAK,IAAI;AAC3B,UAAM,aAAa,IAAI,gBAAgB;AACvC,QAAI;AACJ,QAAI,WAAW;AACf,UAAM,YAAY,8BAA8B,WAAW,QAAQ,MAAM,YAAY,UAAU;AAE/F,SAAK,UAAU,MAAM,MAAM,MAAS;AACpC,QAAI;AACF,aAAO,MAAM,QAAQ,KAAK;AAAA,QACxB;AAAA,QACA,IAAI,QAAkC,CAAC,YAAY;AACjD,kBAAQ;AAAA,YACN,MAAM;AACJ,yBAAW;AACX,yBAAW,MAAM;AACjB,oBAAM,QAA8B;AAAA,gBAClC,WAAW,OAAO,IAAI,QAAQ,SAAS,WAAW,IAAI,OAAO,OAAO;AAAA,gBACpE,YAAY,KAAK,IAAI,GAAG,KAAK,IAAI,IAAI,SAAS;AAAA,gBAC9C,aAAa;AAAA,gBACb,SAAS;AAAA,cACX;AACA,eAAC,QAAQ,uBAAuB,CAAC,kBAAwC;AACvE,wBAAQ,KAAK,uBAAuB,KAAK,UAAU,aAAa,CAAC;AAAA,cACnE,IAAI,KAAK;AACT,sBAAQ,MAAM,2CAA2C,UAAU,iEAAiE,CAAC;AAAA,YACvI;AAAA,YACA;AAAA,UACF;AAAA,QACF,CAAC;AAAA,MACH,CAAC;AAAA,IACH,UAAE;AACA,UAAI,MAAO,cAAa,KAAK;AAC7B,UAAI,CAAC,SAAU,YAAW,MAAM;AAAA,IAClC;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/services/mercadolibre/__tests__/mercadolibre-api.test.js

@@ -1,11 +1,13 @@
 import axios from "axios";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { getMercadoLibreAccessForProfile } from "../../../config/mercadolibre.js";
+import { runWithMcpToolDeadlineContext } from "../../../config/mcp-tool-deadline-context.js";
 import {
   createMercadoLibreClient,
   formatMercadoLibreError,
   getMercadoLibreApiContext,
   getMercadoLibreUsersMe,
+  getMercadoLibreUsersMeWithAccessToken,
   isRetryableMercadoLibreError,
   MercadoLibreApiError,
   buildMercadoLibrePaginationMetadata,
@@ -193,16 +195,17 @@ describe("mercadolibre-api foundations", () => {
     );
   });
   it("creates a client with auth headers and converts axios failures into MercadoLibreApiError", async () => {
+    const requestUse = vi.fn();
     const responseUse = vi.fn();
     const client = {
-      interceptors: { response: { use: responseUse } }
+      interceptors: { request: { use: requestUse }, response: { use: responseUse } }
     };
     vi.spyOn(axios, "create").mockReturnValue(client);
     const consoleSpy = vi.spyOn(console, "error").mockImplementation(() => void 0);
     createMercadoLibreClient("access-token");
     expect(axios.create).toHaveBeenCalledWith({
       baseURL: "https://api.mercadolibre.com",
-      timeout: 3e4,
+      timeout: 9e4,
       headers: {
         Accept: "application/json",
         "Content-Type": "application/json",
@@ -233,11 +236,22 @@ describe("mercadolibre-api foundations", () => {
       "[MERCADOLIBRE API ERROR] GET /orders/search -> 429"
     );
   });
+  it("composes the MCP deadline signal into the shared Axios client", async () => {
+    const requestUse = vi.fn();
+    vi.spyOn(axios, "create").mockReturnValue({
+      interceptors: { request: { use: requestUse }, response: { use: vi.fn() } }
+    });
+    createMercadoLibreClient("access-token");
+    const requestInterceptor = requestUse.mock.calls[0]?.[0];
+    const controller = new AbortController();
+    const request = await runWithMcpToolDeadlineContext(controller.signal, async () => requestInterceptor({}));
+    expect(request.signal).toBe(controller.signal);
+  });
   it("builds api context from the persisted profile access and exposes /users/me", async () => {
     const getMock = vi.fn().mockResolvedValue({ data: { id: 123, nickname: "seller" } });
     const client = {
       get: getMock,
-      interceptors: { response: { use: vi.fn() } }
+      interceptors: { request: { use: vi.fn() }, response: { use: vi.fn() } }
     };
     vi.mocked(getMercadoLibreAccessForProfile).mockResolvedValue({
       sellerId: "seller-1",
@@ -256,6 +270,27 @@ describe("mercadolibre-api foundations", () => {
     expect(getMock).toHaveBeenCalledWith("/users/me");
     expect(me).toEqual({ id: 123, nickname: "seller" });
   });
+  it("probes /users/me with the explicitly supplied access token", async () => {
+    const getMock = vi.fn().mockResolvedValue({ data: { id: 456, nickname: "explicit-seller" } });
+    const client = {
+      get: getMock,
+      interceptors: { request: { use: vi.fn() }, response: { use: vi.fn() } }
+    };
+    vi.spyOn(axios, "create").mockReturnValue(client);
+    const me = await getMercadoLibreUsersMeWithAccessToken("explicit-access-token");
+    expect(axios.create).toHaveBeenCalledWith({
+      baseURL: "https://api.mercadolibre.com",
+      timeout: 9e4,
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+        Authorization: "Bearer explicit-access-token"
+      }
+    });
+    expect(getMock).toHaveBeenCalledWith("/users/me");
+    expect(getMercadoLibreAccessForProfile).not.toHaveBeenCalled();
+    expect(me).toEqual({ id: 456, nickname: "explicit-seller" });
+  });
   it("detects retryable MercadoLibre errors including missing status codes", () => {
     expect(isRetryableMercadoLibreError(new MercadoLibreApiError("network"))).toBe(true);
     expect(isRetryableMercadoLibreError(new MercadoLibreApiError("forbidden", 403))).toBe(false);

package/dist/src/services/mercadolibre/__tests__/mercadolibre-api.test.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/services/mercadolibre/__tests__/mercadolibre-api.test.ts"],
-  "sourcesContent": ["import axios, { AxiosError } from \"axios\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\n\nimport { getMercadoLibreAccessForProfile } from \"../../../config/mercadolibre.js\";\nimport {\n  createMercadoLibreClient,\n  formatMercadoLibreError,\n  getMercadoLibreApiContext,\n  getMercadoLibreUsersMe,\n  isRetryableMercadoLibreError,\n  MercadoLibreApiError,\n  buildMercadoLibrePaginationMetadata,\n  normalizeMercadoLibrePaging,\n  parseMercadoLibreMultiget,\n  runMercadoLibreBatch,\n  sanitizeMercadoLibreText,\n} from \"../mercadolibre-api.js\";\n\nvi.mock(\"../../../config/mercadolibre.js\", () => ({\n  getMercadoLibreAccessForProfile: vi.fn(),\n}));\n\ndescribe(\"mercadolibre-api foundations\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n  });\n\n  afterEach(() => {\n    vi.useRealTimers();\n    vi.restoreAllMocks();\n  });\n\n  it(\"redacts sensitive tokens from MercadoLibre errors\", () => {\n    const sanitized = sanitizeMercadoLibreText(\n      \"Bearer abc.def access_token=secret refresh_token=refresh client_secret=topsecret code=oauth\"\n    );\n\n    expect(sanitized).toContain(\"Bearer [redacted]\");\n    expect(sanitized).toContain(\"access_token=[redacted]\");\n    expect(sanitized).toContain(\"refresh_token=[redacted]\");\n    expect(sanitized).toContain(\"client_secret=[redacted]\");\n    expect(sanitized).toContain(\"code=[redacted]\");\n  });\n\n  it(\"normalizes paging values and builds continuation metadata\", () => {\n    const paging = normalizeMercadoLibrePaging({ total: 25, limit: \"10\", offset: -4 });\n    const metadata = buildMercadoLibrePaginationMetadata({\n      total: paging.total,\n      limit: paging.limit,\n      offset: paging.offset,\n      returned: 10,\n      nextField: \"offset\",\n    });\n\n    expect(paging).toEqual({ total: 25, limit: 10, offset: 0 });\n    expect(metadata).toEqual({\n      total: 25,\n      limit: 10,\n      offset: 0,\n      returned: 10,\n      has_more: true,\n      continuation: \"Reenviar la misma tool con offset=10 para continuar.\",\n    });\n  });\n\n  it(\"normalizes invalid paging values and reports finished pagination when no more pages exist\", () => {\n    const paging = normalizeMercadoLibrePaging({ total: \"oops\", limit: undefined, offset: Number.NaN });\n    const metadata = buildMercadoLibrePaginationMetadata({\n      total: 2,\n      limit: 0,\n      offset: 0,\n      returned: 2,\n      nextField: \"scroll_id\",\n    });\n\n    expect(paging).toEqual({ total: 0, limit: 0, offset: 0 });\n    expect(metadata).toEqual({\n      total: 2,\n      limit: 2,\n      offset: 0,\n      returned: 2,\n      has_more: false,\n      continuation: \"No more pages for this query.\",\n    });\n  });\n\n  it(\"filters multiget responses to successful bodies only\", async () => {\n    const result = await parseMercadoLibreMultiget({\n      data: [\n        { code: 200, body: { id: \"MLA1\" } },\n        { code: 404, body: { id: \"MLA2\" } },\n        { code: 204 },\n        { code: 201, body: { id: \"MLA3\" } },\n      ],\n    } as never);\n\n    expect(result).toEqual([{ id: \"MLA1\" }, { id: \"MLA3\" }]);\n  });\n\n  it(\"returns an empty multiget payload when no successful bodies are present\", async () => {\n    const result = await parseMercadoLibreMultiget({\n      data: [{ code: 404, body: { id: \"missing\" } }, { code: 204 }, { code: 200 }],\n    } as never);\n\n    expect(result).toEqual([]);\n  });\n\n  it(\"retries retryable batch failures and keeps ordering stable\", async () => {\n    vi.useFakeTimers();\n    vi.spyOn(Math, \"random\").mockReturnValue(0);\n\n    const fetcher = vi\n      .fn<(id: string) => Promise<{ id: string; recovered?: boolean }>>()\n      .mockImplementationOnce(async () => {\n        throw new MercadoLibreApiError(\"rate limited\", 429);\n      })\n      .mockResolvedValueOnce({ id: \"one\", recovered: true })\n      .mockResolvedValueOnce({ id: \"two\" });\n\n    const promise = runMercadoLibreBatch([\"one\", \"two\"], fetcher, {\n      maxConcurrency: 1,\n      maxRetries: 1,\n      baseRetryDelayMs: 50,\n    });\n\n    await vi.advanceTimersByTimeAsync(50);\n\n    await expect(promise).resolves.toEqual({\n      successful: [\n        { id: \"one\", document: { id: \"one\", recovered: true } },\n        { id: \"two\", document: { id: \"two\" } },\n      ],\n      failed: [],\n    });\n    expect(fetcher).toHaveBeenCalledTimes(3);\n  });\n\n  it(\"honors retry-after headers for retryable failures\", async () => {\n    vi.useFakeTimers();\n\n    const fetcher = vi\n      .fn<(id: string) => Promise<{ id: string }>>()\n      .mockImplementationOnce(async () => {\n        throw new MercadoLibreApiError(\"wait\", 429, undefined, 120);\n      })\n      .mockResolvedValueOnce({ id: \"one\" });\n\n    const promise = runMercadoLibreBatch([\"one\"], fetcher, {\n      maxRetries: 1,\n      baseRetryDelayMs: 50,\n    });\n\n    await vi.advanceTimersByTimeAsync(119);\n    expect(fetcher).toHaveBeenCalledTimes(1);\n\n    await vi.advanceTimersByTimeAsync(1);\n\n    await expect(promise).resolves.toEqual({\n      successful: [{ id: \"one\", document: { id: \"one\" } }],\n      failed: [],\n    });\n  });\n\n  it(\"classifies non-retryable batch failures with a safe message\", async () => {\n    const result = await runMercadoLibreBatch(\n      [\"broken\"],\n      async () => {\n        throw new Error(\"refresh_token=secret exploded\");\n      },\n      { maxRetries: 2 }\n    );\n\n    expect(result).toEqual({\n      successful: [],\n      failed: [\n        {\n          id: \"broken\",\n          message: \"refresh_token=[redacted] exploded\",\n          statusCode: undefined,\n          attempts: 1,\n          retryable: false,\n        },\n      ],\n    });\n  });\n\n  it(\"treats unknown rejected batch reasons as a single failed attempt\", async () => {\n    const fetcher = vi.fn(async () => {\n      throw \"Bearer abc123\";\n    });\n\n    const result = await runMercadoLibreBatch([\"broken\"], fetcher, { maxRetries: 0 });\n\n    expect(result).toEqual({\n      successful: [],\n      failed: [\n        {\n          id: \"broken\",\n          message: \"Failed to fetch MercadoLibre resource broken\",\n          statusCode: undefined,\n          attempts: 1,\n          retryable: false,\n        },\n      ],\n    });\n  });\n\n  it(\"returns an empty batch result when no ids are provided\", async () => {\n    const fetcher = vi.fn();\n\n    await expect(runMercadoLibreBatch([], fetcher)).resolves.toEqual({\n      successful: [],\n      failed: [],\n    });\n    expect(fetcher).not.toHaveBeenCalled();\n  });\n\n  it(\"formats axios errors with sanitized response details\", () => {\n    const error = {\n      isAxiosError: true,\n      message: \"Request failed with status code 400\",\n      response: {\n        status: 400,\n        data: {\n          error: \"bad_request\",\n          cause: [{ message: \"refresh_token=top-secret\" }],\n        },\n        headers: {},\n      },\n    } as AxiosError;\n\n    expect(formatMercadoLibreError(error)).toBe(\n      \"MercadoLibre API request failed (400): refresh_token=[redacted]\"\n    );\n  });\n\n  it(\"creates a client with auth headers and converts axios failures into MercadoLibreApiError\", async () => {\n    const responseUse = vi.fn();\n    const client = {\n      interceptors: { response: { use: responseUse } },\n    };\n    vi.spyOn(axios, \"create\").mockReturnValue(client as never);\n    const consoleSpy = vi.spyOn(console, \"error\").mockImplementation(() => undefined);\n\n    createMercadoLibreClient(\"access-token\");\n\n    expect(axios.create).toHaveBeenCalledWith({\n      baseURL: \"https://api.mercadolibre.com\",\n      timeout: 30000,\n      headers: {\n        Accept: \"application/json\",\n        \"Content-Type\": \"application/json\",\n        Authorization: \"Bearer access-token\",\n      },\n    });\n\n    const rejectHandler = responseUse.mock.calls[0]?.[1] as (error: AxiosError) => Promise<never>;\n    const retryAt = new Date(Date.now() + 5000).toUTCString();\n\n    await expect(\n      rejectHandler({\n        isAxiosError: true,\n        message: \"boom\",\n        config: { method: \"get\", url: \"/orders/search\" },\n        response: {\n          status: 429,\n          headers: { \"retry-after\": retryAt },\n          data: { error: \"rate_limit\", message: \"access_token=secret\" },\n        },\n      } as unknown as AxiosError)\n    ).rejects.toMatchObject({\n      name: \"MercadoLibreApiError\",\n      status: 429,\n      code: \"rate_limit\",\n      message: \"MercadoLibre API request failed (429): access_token=[redacted]\",\n      retryAfterMs: expect.any(Number),\n    });\n\n    expect(consoleSpy).toHaveBeenCalledWith(\n      \"[MERCADOLIBRE API ERROR] GET /orders/search -> 429\"\n    );\n  });\n\n  it(\"builds api context from the persisted profile access and exposes /users/me\", async () => {\n    const getMock = vi.fn().mockResolvedValue({ data: { id: 123, nickname: \"seller\" } });\n    const client = {\n      get: getMock,\n      interceptors: { response: { use: vi.fn() } },\n    };\n\n    vi.mocked(getMercadoLibreAccessForProfile).mockResolvedValue({\n      sellerId: \"seller-1\",\n      accessToken: \"stored-token\",\n      refreshToken: \"refresh\",\n    } as never);\n    vi.spyOn(axios, \"create\").mockReturnValue(client as never);\n\n    const context = await getMercadoLibreApiContext(\"profile-1\");\n    const me = await getMercadoLibreUsersMe(\"profile-1\");\n\n    expect(context).toMatchObject({\n      sellerId: \"seller-1\",\n      accessToken: \"stored-token\",\n      refreshToken: \"refresh\",\n      api: client,\n    });\n    expect(getMock).toHaveBeenCalledWith(\"/users/me\");\n    expect(me).toEqual({ id: 123, nickname: \"seller\" });\n  });\n\n  it(\"detects retryable MercadoLibre errors including missing status codes\", () => {\n    expect(isRetryableMercadoLibreError(new MercadoLibreApiError(\"network\"))).toBe(true);\n    expect(isRetryableMercadoLibreError(new MercadoLibreApiError(\"forbidden\", 403))).toBe(false);\n    expect(isRetryableMercadoLibreError(new Error(\"plain\"))).toBe(false);\n  });\n});\n"],
-  "mappings": "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",
+  "sourcesContent": ["import axios, { AxiosError } from \"axios\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\n\nimport { getMercadoLibreAccessForProfile } from \"../../../config/mercadolibre.js\";\nimport { runWithMcpToolDeadlineContext } from \"../../../config/mcp-tool-deadline-context.js\";\nimport {\n  createMercadoLibreClient,\n  formatMercadoLibreError,\n  getMercadoLibreApiContext,\n  getMercadoLibreUsersMe,\n  getMercadoLibreUsersMeWithAccessToken,\n  isRetryableMercadoLibreError,\n  MercadoLibreApiError,\n  buildMercadoLibrePaginationMetadata,\n  normalizeMercadoLibrePaging,\n  parseMercadoLibreMultiget,\n  runMercadoLibreBatch,\n  sanitizeMercadoLibreText,\n} from \"../mercadolibre-api.js\";\n\nvi.mock(\"../../../config/mercadolibre.js\", () => ({\n  getMercadoLibreAccessForProfile: vi.fn(),\n}));\n\ndescribe(\"mercadolibre-api foundations\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n  });\n\n  afterEach(() => {\n    vi.useRealTimers();\n    vi.restoreAllMocks();\n  });\n\n  it(\"redacts sensitive tokens from MercadoLibre errors\", () => {\n    const sanitized = sanitizeMercadoLibreText(\n      \"Bearer abc.def access_token=secret refresh_token=refresh client_secret=topsecret code=oauth\"\n    );\n\n    expect(sanitized).toContain(\"Bearer [redacted]\");\n    expect(sanitized).toContain(\"access_token=[redacted]\");\n    expect(sanitized).toContain(\"refresh_token=[redacted]\");\n    expect(sanitized).toContain(\"client_secret=[redacted]\");\n    expect(sanitized).toContain(\"code=[redacted]\");\n  });\n\n  it(\"normalizes paging values and builds continuation metadata\", () => {\n    const paging = normalizeMercadoLibrePaging({ total: 25, limit: \"10\", offset: -4 });\n    const metadata = buildMercadoLibrePaginationMetadata({\n      total: paging.total,\n      limit: paging.limit,\n      offset: paging.offset,\n      returned: 10,\n      nextField: \"offset\",\n    });\n\n    expect(paging).toEqual({ total: 25, limit: 10, offset: 0 });\n    expect(metadata).toEqual({\n      total: 25,\n      limit: 10,\n      offset: 0,\n      returned: 10,\n      has_more: true,\n      continuation: \"Reenviar la misma tool con offset=10 para continuar.\",\n    });\n  });\n\n  it(\"normalizes invalid paging values and reports finished pagination when no more pages exist\", () => {\n    const paging = normalizeMercadoLibrePaging({ total: \"oops\", limit: undefined, offset: Number.NaN });\n    const metadata = buildMercadoLibrePaginationMetadata({\n      total: 2,\n      limit: 0,\n      offset: 0,\n      returned: 2,\n      nextField: \"scroll_id\",\n    });\n\n    expect(paging).toEqual({ total: 0, limit: 0, offset: 0 });\n    expect(metadata).toEqual({\n      total: 2,\n      limit: 2,\n      offset: 0,\n      returned: 2,\n      has_more: false,\n      continuation: \"No more pages for this query.\",\n    });\n  });\n\n  it(\"filters multiget responses to successful bodies only\", async () => {\n    const result = await parseMercadoLibreMultiget({\n      data: [\n        { code: 200, body: { id: \"MLA1\" } },\n        { code: 404, body: { id: \"MLA2\" } },\n        { code: 204 },\n        { code: 201, body: { id: \"MLA3\" } },\n      ],\n    } as never);\n\n    expect(result).toEqual([{ id: \"MLA1\" }, { id: \"MLA3\" }]);\n  });\n\n  it(\"returns an empty multiget payload when no successful bodies are present\", async () => {\n    const result = await parseMercadoLibreMultiget({\n      data: [{ code: 404, body: { id: \"missing\" } }, { code: 204 }, { code: 200 }],\n    } as never);\n\n    expect(result).toEqual([]);\n  });\n\n  it(\"retries retryable batch failures and keeps ordering stable\", async () => {\n    vi.useFakeTimers();\n    vi.spyOn(Math, \"random\").mockReturnValue(0);\n\n    const fetcher = vi\n      .fn<(id: string) => Promise<{ id: string; recovered?: boolean }>>()\n      .mockImplementationOnce(async () => {\n        throw new MercadoLibreApiError(\"rate limited\", 429);\n      })\n      .mockResolvedValueOnce({ id: \"one\", recovered: true })\n      .mockResolvedValueOnce({ id: \"two\" });\n\n    const promise = runMercadoLibreBatch([\"one\", \"two\"], fetcher, {\n      maxConcurrency: 1,\n      maxRetries: 1,\n      baseRetryDelayMs: 50,\n    });\n\n    await vi.advanceTimersByTimeAsync(50);\n\n    await expect(promise).resolves.toEqual({\n      successful: [\n        { id: \"one\", document: { id: \"one\", recovered: true } },\n        { id: \"two\", document: { id: \"two\" } },\n      ],\n      failed: [],\n    });\n    expect(fetcher).toHaveBeenCalledTimes(3);\n  });\n\n  it(\"honors retry-after headers for retryable failures\", async () => {\n    vi.useFakeTimers();\n\n    const fetcher = vi\n      .fn<(id: string) => Promise<{ id: string }>>()\n      .mockImplementationOnce(async () => {\n        throw new MercadoLibreApiError(\"wait\", 429, undefined, 120);\n      })\n      .mockResolvedValueOnce({ id: \"one\" });\n\n    const promise = runMercadoLibreBatch([\"one\"], fetcher, {\n      maxRetries: 1,\n      baseRetryDelayMs: 50,\n    });\n\n    await vi.advanceTimersByTimeAsync(119);\n    expect(fetcher).toHaveBeenCalledTimes(1);\n\n    await vi.advanceTimersByTimeAsync(1);\n\n    await expect(promise).resolves.toEqual({\n      successful: [{ id: \"one\", document: { id: \"one\" } }],\n      failed: [],\n    });\n  });\n\n  it(\"classifies non-retryable batch failures with a safe message\", async () => {\n    const result = await runMercadoLibreBatch(\n      [\"broken\"],\n      async () => {\n        throw new Error(\"refresh_token=secret exploded\");\n      },\n      { maxRetries: 2 }\n    );\n\n    expect(result).toEqual({\n      successful: [],\n      failed: [\n        {\n          id: \"broken\",\n          message: \"refresh_token=[redacted] exploded\",\n          statusCode: undefined,\n          attempts: 1,\n          retryable: false,\n        },\n      ],\n    });\n  });\n\n  it(\"treats unknown rejected batch reasons as a single failed attempt\", async () => {\n    const fetcher = vi.fn(async () => {\n      throw \"Bearer abc123\";\n    });\n\n    const result = await runMercadoLibreBatch([\"broken\"], fetcher, { maxRetries: 0 });\n\n    expect(result).toEqual({\n      successful: [],\n      failed: [\n        {\n          id: \"broken\",\n          message: \"Failed to fetch MercadoLibre resource broken\",\n          statusCode: undefined,\n          attempts: 1,\n          retryable: false,\n        },\n      ],\n    });\n  });\n\n  it(\"returns an empty batch result when no ids are provided\", async () => {\n    const fetcher = vi.fn();\n\n    await expect(runMercadoLibreBatch([], fetcher)).resolves.toEqual({\n      successful: [],\n      failed: [],\n    });\n    expect(fetcher).not.toHaveBeenCalled();\n  });\n\n  it(\"formats axios errors with sanitized response details\", () => {\n    const error = {\n      isAxiosError: true,\n      message: \"Request failed with status code 400\",\n      response: {\n        status: 400,\n        data: {\n          error: \"bad_request\",\n          cause: [{ message: \"refresh_token=top-secret\" }],\n        },\n        headers: {},\n      },\n    } as AxiosError;\n\n    expect(formatMercadoLibreError(error)).toBe(\n      \"MercadoLibre API request failed (400): refresh_token=[redacted]\"\n    );\n  });\n\n  it(\"creates a client with auth headers and converts axios failures into MercadoLibreApiError\", async () => {\n    const requestUse = vi.fn();\n    const responseUse = vi.fn();\n    const client = {\n      interceptors: { request: { use: requestUse }, response: { use: responseUse } },\n    };\n    vi.spyOn(axios, \"create\").mockReturnValue(client as never);\n    const consoleSpy = vi.spyOn(console, \"error\").mockImplementation(() => undefined);\n\n    createMercadoLibreClient(\"access-token\");\n\n    expect(axios.create).toHaveBeenCalledWith({\n      baseURL: \"https://api.mercadolibre.com\",\n      timeout: 90000,\n      headers: {\n        Accept: \"application/json\",\n        \"Content-Type\": \"application/json\",\n        Authorization: \"Bearer access-token\",\n      },\n    });\n\n    const rejectHandler = responseUse.mock.calls[0]?.[1] as (error: AxiosError) => Promise<never>;\n    const retryAt = new Date(Date.now() + 5000).toUTCString();\n\n    await expect(\n      rejectHandler({\n        isAxiosError: true,\n        message: \"boom\",\n        config: { method: \"get\", url: \"/orders/search\" },\n        response: {\n          status: 429,\n          headers: { \"retry-after\": retryAt },\n          data: { error: \"rate_limit\", message: \"access_token=secret\" },\n        },\n      } as unknown as AxiosError)\n    ).rejects.toMatchObject({\n      name: \"MercadoLibreApiError\",\n      status: 429,\n      code: \"rate_limit\",\n      message: \"MercadoLibre API request failed (429): access_token=[redacted]\",\n      retryAfterMs: expect.any(Number),\n    });\n\n    expect(consoleSpy).toHaveBeenCalledWith(\n      \"[MERCADOLIBRE API ERROR] GET /orders/search -> 429\"\n    );\n  });\n\n  it(\"composes the MCP deadline signal into the shared Axios client\", async () => {\n    const requestUse = vi.fn();\n    vi.spyOn(axios, \"create\").mockReturnValue({\n      interceptors: { request: { use: requestUse }, response: { use: vi.fn() } },\n    } as never);\n    createMercadoLibreClient(\"access-token\");\n    const requestInterceptor = requestUse.mock.calls[0]?.[0] as (config: { signal?: AbortSignal }) => { signal?: AbortSignal };\n    const controller = new AbortController();\n    const request = await runWithMcpToolDeadlineContext(controller.signal, async () => requestInterceptor({}));\n    expect(request.signal).toBe(controller.signal);\n  });\n\n  it(\"builds api context from the persisted profile access and exposes /users/me\", async () => {\n    const getMock = vi.fn().mockResolvedValue({ data: { id: 123, nickname: \"seller\" } });\n    const client = {\n      get: getMock,\n      interceptors: { request: { use: vi.fn() }, response: { use: vi.fn() } },\n    };\n\n    vi.mocked(getMercadoLibreAccessForProfile).mockResolvedValue({\n      sellerId: \"seller-1\",\n      accessToken: \"stored-token\",\n      refreshToken: \"refresh\",\n    } as never);\n    vi.spyOn(axios, \"create\").mockReturnValue(client as never);\n\n    const context = await getMercadoLibreApiContext(\"profile-1\");\n    const me = await getMercadoLibreUsersMe(\"profile-1\");\n\n    expect(context).toMatchObject({\n      sellerId: \"seller-1\",\n      accessToken: \"stored-token\",\n      refreshToken: \"refresh\",\n      api: client,\n    });\n    expect(getMock).toHaveBeenCalledWith(\"/users/me\");\n    expect(me).toEqual({ id: 123, nickname: \"seller\" });\n  });\n\n  it(\"probes /users/me with the explicitly supplied access token\", async () => {\n    const getMock = vi.fn().mockResolvedValue({ data: { id: 456, nickname: \"explicit-seller\" } });\n    const client = {\n      get: getMock,\n      interceptors: { request: { use: vi.fn() }, response: { use: vi.fn() } },\n    };\n    vi.spyOn(axios, \"create\").mockReturnValue(client as never);\n\n    const me = await getMercadoLibreUsersMeWithAccessToken(\"explicit-access-token\");\n\n    expect(axios.create).toHaveBeenCalledWith({\n      baseURL: \"https://api.mercadolibre.com\",\n      timeout: 90000,\n      headers: {\n        Accept: \"application/json\",\n        \"Content-Type\": \"application/json\",\n        Authorization: \"Bearer explicit-access-token\",\n      },\n    });\n    expect(getMock).toHaveBeenCalledWith(\"/users/me\");\n    expect(getMercadoLibreAccessForProfile).not.toHaveBeenCalled();\n    expect(me).toEqual({ id: 456, nickname: \"explicit-seller\" });\n  });\n\n  it(\"detects retryable MercadoLibre errors including missing status codes\", () => {\n    expect(isRetryableMercadoLibreError(new MercadoLibreApiError(\"network\"))).toBe(true);\n    expect(isRetryableMercadoLibreError(new MercadoLibreApiError(\"forbidden\", 403))).toBe(false);\n    expect(isRetryableMercadoLibreError(new Error(\"plain\"))).toBe(false);\n  });\n});\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/src/services/mercadolibre/__tests__/mercadolibre-buyer-reconciliation.test.js

@@ -0,0 +1,226 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const { billingMock, orderMock, shipmentMock, ownershipMock } = vi.hoisted(() => ({
+  billingMock: vi.fn(),
+  orderMock: vi.fn(),
+  shipmentMock: vi.fn(),
+  ownershipMock: vi.fn()
+}));
+vi.mock("../mercadolibre-order-billing-info.js", () => ({ getMercadoLibreSaleBillingInfo: billingMock, verifyMercadoLibreOrderOwnership: ownershipMock }));
+vi.mock("../mercadolibre-orders.js", () => ({ getMercadoLibreOrder: orderMock, getMercadoLibreShipment: shipmentMock }));
+import { MercadoLibreApiError } from "../mercadolibre-api.js";
+import { getBuyerReconciliationSafetyMarginMs, reconcileMercadoLibreBuyerData } from "../mercadolibre-buyer-reconciliation.js";
+import { createMcpToolDeadlineMiddleware } from "../../../config/mcp-tool-deadline.js";
+const order = (id, shipment2 = "1001") => ({ id, seller: { id: "seller-1" }, buyer: { nickname: "buyer-nick" }, shipping: { id: shipment2 } });
+const available = (id, type = "DNI", number = "123", shipment2 = "1001") => ({
+  available: true,
+  order: order(id, shipment2),
+  billingInfo: { buyer: { billing_info: {
+    name: "Ada",
+    last_name: "Lovelace",
+    identification: { type, number },
+    address: { street_name: "Main", street_number: 10, city_name: "City", state: { code: "S", name: "State" }, zip_code: "1000", country_id: "AR" },
+    taxes: { taxpayer_type: { id: "CONSUMIDOR_FINAL", description: "Consumidor Final" } }
+  } } }
+});
+const missingFiscal = { available: false, reason: "billing_info_fiscal_fields_missing" };
+const shipment = { destination: { shipping_address: { street_name: "Shipping", street_number: "20", city_name: "Port", state: { name: "Province" }, zip_code: "2000", country_id: "AR" } } };
+describe("reconcileMercadoLibreBuyerData", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    ownershipMock.mockResolvedValue("owned");
+    shipmentMock.mockResolvedValue(shipment);
+  });
+  it("derives a bounded safety margin from the global timeout", () => {
+    expect(getBuyerReconciliationSafetyMarginMs(3e5)).toBe(1e4);
+    expect(getBuyerReconciliationSafetyMarginMs(2e3)).toBe(100);
+    expect(getBuyerReconciliationSafetyMarginMs(1e6)).toBe(1e4);
+  });
+  it("returns a complete direct order with buyer, document, fiscal and shipping addresses", async () => {
+    billingMock.mockResolvedValue({ resolutionKind: "order", orderId: "o-1", result: available("o-1", "DNI", "111") });
+    const result = await reconcileMercadoLibreBuyerData("triplim", ["sale-1"]);
+    const item = result.results[0];
+    expect(item).toMatchObject({ sale_reference: "sale-1", resolution: { kind: "order", status: "resolved" }, data: { completeness: "complete" } });
+    expect(item.data.buyer).toMatchObject({ full_name: "Ada Lovelace", nickname: "buyer-nick", document: { type: "DNI", number: "111" }, fiscal_address: { state: "State" }, shipping_address: { street: "Shipping 20" } });
+    expect(item.data).not.toHaveProperty("sources");
+    expect(item.data).not.toHaveProperty("missing_fields");
+    expect(item.data).not.toHaveProperty("reasons");
+    expect(item).not.toHaveProperty("metadata");
+    expect(result).not.toHaveProperty("metadata");
+    expect(result.summary).toEqual({ requested: 1, complete: 1, partial: 0, unavailable: 0, orders: 1, packs: 0, unknown: 0 });
+  });
+  it("keeps useful order buyer data when fiscal fields are partial", async () => {
+    billingMock.mockResolvedValue({ resolutionKind: "order", orderId: "o-1", result: missingFiscal });
+    orderMock.mockResolvedValue(order("o-1"));
+    const result = await reconcileMercadoLibreBuyerData("triplim", ["sale-1"]);
+    expect(result.results[0].data).toMatchObject({ completeness: "partial", buyer: { nickname: "buyer-nick" } });
+    expect(result.results[0].data.issues).toContainEqual(expect.objectContaining({ field: "fiscal_address", code: "billing_info_fiscal_fields_missing" }));
+  });
+  it.each([["DNI", "DNI"], ["CUIT", "CUIT"]])("normalizes %s documents without changing the number", async (source, expected) => {
+    billingMock.mockResolvedValue({ resolutionKind: "order", orderId: "o-1", result: available("o-1", source, "999") });
+    const result = await reconcileMercadoLibreBuyerData("triplim", ["sale-1"]);
+    expect(result.results[0].data.buyer?.document).toEqual({ type: expected, number: "999" });
+  });
+  it("consolidates a unanimous pack at top-level data and hides member identifiers", async () => {
+    billingMock.mockResolvedValue({ resolutionKind: "pack", packId: "pack-secret", metadata: { memberCount: 2 }, members: [
+      { orderId: "m-1", accessible: true, result: available("m-1", "DNI", "123", "1001") },
+      { orderId: "m-2", accessible: true, result: available("m-2", "DNI", "123", "1002") }
+    ] });
+    const result = await reconcileMercadoLibreBuyerData("triplim", ["pack-sale"]);
+    expect(result.results[0]).toMatchObject({ pack: { agreement: "unanimous" }, data: { completeness: "complete" } });
+    expect(result.results[0].data).not.toHaveProperty("issues");
+    expect(result.results[0]).not.toHaveProperty("metadata");
+    expect(result.results[0].pack).not.toHaveProperty("consolidated");
+    expect(result.results[0].pack).not.toHaveProperty("members");
+    expect(JSON.stringify(result)).not.toMatch(/pack-secret|m-1|m-2/);
+  });
+  it("does not consolidate a pack when shipping destinations differ", async () => {
+    const secondShipment = { destination: { shipping_address: { street_name: "Other", street_number: "20", city_name: "Port", state: { name: "Province" }, zip_code: "2000", country_id: "AR" } } };
+    billingMock.mockResolvedValue({ resolutionKind: "pack", packId: "pack-secret", metadata: { memberCount: 2 }, members: [
+      { orderId: "m-1", accessible: true, result: available("m-1", "DNI", "123", "1001") },
+      { orderId: "m-2", accessible: true, result: available("m-2", "DNI", "123", "1002") }
+    ] });
+    shipmentMock.mockImplementation(async (_profile, shipmentId) => shipmentId === "1002" ? secondShipment : shipment);
+    const result = await reconcileMercadoLibreBuyerData("triplim", ["pack-sale"]);
+    expect(result.results[0].pack?.agreement).toBe("disagreement");
+    expect(result.results[0].data.completeness).toBe("partial");
+    expect(result.results[0].pack).toHaveProperty("members");
+    expect(result.summary).toMatchObject({ complete: 0, partial: 1, unavailable: 0 });
+  });
+  it("returns opaque indexed members for disagreement and partial packs", async () => {
+    billingMock.mockResolvedValue({ resolutionKind: "pack", packId: "pack-secret", metadata: { memberCount: 2 }, members: [
+      { orderId: "m-1", accessible: true, result: available("m-1", "DNI", "1") },
+      { orderId: "m-2", accessible: true, result: available("m-2", "CUIT", "2") }
+    ] });
+    let result = await reconcileMercadoLibreBuyerData("triplim", ["pack-sale"]);
+    expect(result.results[0].pack).toMatchObject({ agreement: "disagreement", members: [{ member_index: 0 }, { member_index: 1 }] });
+    billingMock.mockResolvedValue({ resolutionKind: "pack", packId: "pack-secret", metadata: { memberCount: 2 }, members: [{ orderId: "m-1", accessible: true, result: missingFiscal }, { orderId: "m-2", accessible: false, failureReason: "access_denied" }] });
+    result = await reconcileMercadoLibreBuyerData("triplim", ["pack-sale"]);
+    expect(result.results[0].pack?.agreement).toBe("partial");
+    expect(result.results[0].pack?.members?.[1]).toMatchObject({ member_index: 1, data: { completeness: "unavailable" } });
+    expect(result.results[0].data.issues).toContainEqual(expect.objectContaining({ field: "pack_members", code: "pack_partial_coverage" }));
+    expect(result.summary).toMatchObject({ complete: 0, partial: 1, unavailable: 0 });
+  });
+  it("exposes a safe shipping issue without operational metadata", async () => {
+    billingMock.mockResolvedValue({ resolutionKind: "order", orderId: "o-1", result: available("o-1") });
+    shipmentMock.mockRejectedValue(new MercadoLibreApiError("temporary", 503));
+    const result = await reconcileMercadoLibreBuyerData("triplim", ["sale-1"], { maxRetries: 1, sleep: async () => void 0 });
+    expect(result.results[0].data.issues).toContainEqual(expect.objectContaining({ field: "shipping_address", code: "shipping_source_unavailable" }));
+    expect(result.results[0]).not.toHaveProperty("metadata");
+    expect(result).not.toHaveProperty("metadata");
+  });
+  it("counts only actual shipping retry exhaustion in the degraded event", async () => {
+    billingMock.mockResolvedValue({ resolutionKind: "order", orderId: "o-1", result: available("o-1") });
+    shipmentMock.mockRejectedValue(new MercadoLibreApiError("temporary", 503));
+    const withoutRetry = vi.fn();
+    await reconcileMercadoLibreBuyerData("triplim", ["sale-1"], { maxRetries: 0, onDegradedOutcome: withoutRetry });
+    expect(withoutRetry).toHaveBeenCalledWith(expect.objectContaining({ retry: 0 }));
+    const exhausted = vi.fn();
+    await reconcileMercadoLibreBuyerData("triplim", ["sale-1"], { maxRetries: 1, sleep: async () => void 0, onDegradedOutcome: exhausted });
+    expect(exhausted).toHaveBeenCalledWith(expect.objectContaining({ retry: 1 }));
+    expect(shipmentMock).toHaveBeenCalledTimes(3);
+  });
+  it("reports pack member issues without operational metadata or upstream details", async () => {
+    billingMock.mockResolvedValue({ resolutionKind: "pack", packId: "pack-secret", metadata: { memberCount: 2 }, members: [
+      { orderId: "m-1", accessible: false, failureReason: "operation_deadline_exceeded" },
+      { orderId: "m-2", accessible: false, failureReason: "upstream_unavailable", attempts: 3, retryable: true }
+    ] });
+    const result = await reconcileMercadoLibreBuyerData("triplim", ["pack-sale"]);
+    expect(result.results[0].pack?.members?.[0].data.issues).toContainEqual(expect.objectContaining({ code: "operation_deadline_exceeded" }));
+    expect(result.results[0].pack?.members?.[1].data.issues).toContainEqual(expect.objectContaining({ code: "upstream_unavailable" }));
+    expect(result.results[0]).not.toHaveProperty("metadata");
+    expect(result).not.toHaveProperty("metadata");
+    expect(JSON.stringify(result)).not.toContain("temporary");
+  });
+  it("propagates an unavailable pack deadline as a safe issue", async () => {
+    billingMock.mockResolvedValue({
+      resolutionKind: "pack",
+      packId: "pack-secret",
+      members: [],
+      unavailableReason: "pack_operation_deadline_exceeded",
+      metadata: { memberCount: 0 }
+    });
+    const result = await reconcileMercadoLibreBuyerData("triplim", ["pack-sale"]);
+    expect(result.results[0]).toMatchObject({ resolution: { kind: "pack", status: "unavailable" }, data: { issues: [expect.objectContaining({ code: "operation_deadline_exceeded" })] } });
+    expect(result).not.toHaveProperty("metadata");
+    expect(result.summary).toMatchObject({ requested: 1, unavailable: 1, partial: 0 });
+  });
+  it.each(["mismatch", "unverifiable"])("returns no PII when ownership is %s", async (ownership) => {
+    billingMock.mockResolvedValue({ resolutionKind: "order", orderId: "foreign-order", result: missingFiscal });
+    orderMock.mockResolvedValue({ ...order("foreign-order"), buyer: { nickname: "secret-buyer" } });
+    ownershipMock.mockResolvedValue(ownership);
+    const result = await reconcileMercadoLibreBuyerData("triplim", ["sale-1"]);
+    expect(result.results[0].data.buyer).toBeUndefined();
+    expect(JSON.stringify(result)).not.toContain("secret-buyer");
+    expect(shipmentMock).not.toHaveBeenCalled();
+  });
+  it("does not turn a deadline during order lookup into pack fallback", async () => {
+    billingMock.mockRejectedValue(new MercadoLibreApiError("timeout", void 0));
+    const result = await reconcileMercadoLibreBuyerData("triplim", ["sale-1"], { operationDeadlineMs: 1, now: () => 10 });
+    expect(result.results[0].resolution.kind).toBe("unknown");
+    expect(billingMock).toHaveBeenCalledTimes(1);
+    expect(orderMock).not.toHaveBeenCalled();
+  });
+  it("marks already-expired references as partial processing", async () => {
+    const now = vi.fn().mockReturnValueOnce(10).mockReturnValue(11);
+    const result = await reconcileMercadoLibreBuyerData("triplim", ["sale-1"], { operationDeadlineMs: 1, now });
+    expect(result.results[0]).toMatchObject({ data: { issues: [expect.objectContaining({ code: "operation_deadline_exceeded" })] } });
+    expect(result).not.toHaveProperty("metadata");
+    expect(result.summary).toMatchObject({ requested: 1, unavailable: 1, partial: 0 });
+  });
+  it("returns a structured reference issue before the outer middleware deadline", async () => {
+    vi.useFakeTimers();
+    billingMock.mockImplementation(() => new Promise((_, reject) => {
+      setTimeout(() => reject(new Error("billing source unavailable")), 10);
+    }));
+    const middleware = createMcpToolDeadlineMiddleware(25);
+    const resultPromise = middleware({}, () => reconcileMercadoLibreBuyerData("triplim", ["sale-1"]));
+    await vi.advanceTimersByTimeAsync(10);
+    await expect(resultPromise).resolves.toMatchObject({
+      results: [{ data: { issues: [expect.objectContaining({ code: "operation_deadline_exceeded" })] } }]
+    });
+    vi.useRealTimers();
+  });
+  it.each([
+    ["AbortError", Object.assign(new Error("cancelled"), { name: "AbortError" })],
+    ["timeout sentinel", Object.assign(new Error("request timed out"), { code: "ETIMEDOUT" })]
+  ])("classifies %s as an operation deadline", async (_label, failure) => {
+    billingMock.mockRejectedValue(failure);
+    const result = await reconcileMercadoLibreBuyerData("triplim", ["sale-1"]);
+    expect(result.results[0]).toMatchObject({ data: { issues: [expect.objectContaining({ code: "operation_deadline_exceeded" })] } });
+    expect(result).not.toHaveProperty("metadata");
+  });
+  it("keeps nondeadline resolution failures as reference_unavailable", async () => {
+    billingMock.mockRejectedValue(new Error("billing source unavailable"));
+    const result = await reconcileMercadoLibreBuyerData("triplim", ["sale-1"]);
+    expect(result.results[0]).toMatchObject({ resolution: { kind: "unknown", status: "unavailable" }, data: { issues: [expect.objectContaining({ code: "reference_unavailable" })] } });
+    expect(result).not.toHaveProperty("metadata");
+    expect(result.summary).toMatchObject({ requested: 1, unavailable: 1, partial: 0, unknown: 1 });
+  });
+  it("preserves duplicate occurrences and input order", async () => {
+    billingMock.mockImplementation(async (_profile, reference) => ({ resolutionKind: "order", orderId: reference, result: available(reference) }));
+    const result = await reconcileMercadoLibreBuyerData("triplim", ["second", "first", "second"]);
+    expect(result.results.map((item) => item.sale_reference)).toEqual(["second", "first", "second"]);
+    expect(result.summary.requested).toBe(3);
+  });
+  it("emits only aggregate degraded events and keeps the public response unchanged", async () => {
+    const warn = vi.spyOn(console, "warn").mockImplementation(() => void 0);
+    const error = vi.spyOn(console, "error").mockImplementation(() => void 0);
+    try {
+      billingMock.mockResolvedValue({ resolutionKind: "order", orderId: "o-secret", result: available("o-secret", "CUIT", "secret-doc") });
+      const result = await reconcileMercadoLibreBuyerData("triplim", ["sale-secret"]);
+      expect(warn).not.toHaveBeenCalled();
+      expect(error).not.toHaveBeenCalled();
+      expect(result.results[0].data.buyer?.document?.number).toBe("secret-doc");
+      billingMock.mockResolvedValue({ resolutionKind: "order", orderId: "o-secret", result: missingFiscal });
+      const degraded = await reconcileMercadoLibreBuyerData("triplim", ["sale-secret"], { onDegradedOutcome: (event) => warn(JSON.stringify(event)) });
+      expect(warn).toHaveBeenCalledOnce();
+      expect(warn.mock.calls[0]?.[0]).not.toContain("secret-doc");
+      expect(degraded).not.toHaveProperty("operational_event");
+      expect(degraded).not.toHaveProperty("telemetry");
+    } finally {
+      warn.mockRestore();
+      error.mockRestore();
+    }
+  });
+});
+//# sourceMappingURL=mercadolibre-buyer-reconciliation.test.js.map