npm - @yoryoboy/bi-mcp - Versions diffs - 1.6.0 → 1.7.0 - Mend

@yoryoboy/bi-mcp 1.6.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (178) hide show

package/dist/src/tools/google-ads/campaign-performance.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/google-ads/campaign-performance.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\r\nimport { z } from \"zod\";\r\n\r\nimport {\r\n  dateRegex,\r\n  getFieldValue,\r\n  microsToCurrency,\r\n  parseGoogleAdsMetricValue,\r\n  resolveGoogleAdsCustomerId,\r\n  resolveGoogleAdsDeveloperToken,\r\n  resolveGoogleAdsLoginCustomerId,\r\n  round,\r\n  toPercent,\r\n} from \"../../utils/google-ads.js\";\r\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\r\nimport { stripNulls } from \"../../utils/strip-payload.js\";\r\n\r\nconst campaignStatusEnum = z.enum([\"ENABLED\", \"PAUSED\", \"REMOVED\"]);\r\n\r\nexport const googleAdsCampaignPerformanceSchema = z.object({\r\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\r\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\r\n  customerId: z.string().optional().describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\r\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\r\n  loginCustomerId: z\r\n    .string()\r\n    .optional()\r\n    .describe(\r\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\r\n    ),\r\n  enabledOnly: z\r\n    .boolean()\r\n    .optional()\r\n    .default(true)\r\n    .describe(\"If true, only returns enabled campaigns unless statusFilter is explicitly provided.\"),\r\n  statusFilter: z\r\n    .array(campaignStatusEnum)\r\n    .optional()\r\n    .describe(\"Optional list of campaign statuses to include. Overrides enabledOnly when provided.\"),\r\n});\r\n\r\nexport async function googleAdsCampaignPerformanceHandler(\r\n  params: z.infer<typeof googleAdsCampaignPerformanceSchema>\r\n) {\r\n  try {\r\n    const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\r\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\r\n    const developerToken = resolveGoogleAdsDeveloperToken();\r\n    const effectiveStatuses =\r\n      params.statusFilter && params.statusFilter.length > 0\r\n        ? params.statusFilter\r\n        : params.enabledOnly !== false\r\n          ? [\"ENABLED\"]\r\n          : undefined;\r\n    const whereClauses = [`segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`];\r\n\r\n    if (effectiveStatuses?.length) {\r\n      whereClauses.push(\r\n        `campaign.status IN (${effectiveStatuses.map((status) => `'${status}'`).join(\", \")})`\r\n      );\r\n    }\r\n\r\n    const result = await searchGoogleAds(\r\n      customerId,\r\n      [\r\n        \"SELECT\",\r\n        \"customer.descriptive_name,\",\r\n        \"customer.currency_code,\",\r\n        \"campaign.id,\",\r\n        \"campaign.name,\",\r\n        \"campaign.status,\",\r\n        \"campaign.advertising_channel_type,\",\r\n        \"metrics.impressions,\",\r\n        \"metrics.clicks,\",\r\n        \"metrics.cost_micros,\",\r\n        \"metrics.conversions,\",\r\n        \"metrics.conversions_value,\",\r\n        \"metrics.ctr,\",\r\n        \"metrics.average_cpc\",\r\n        \"FROM campaign\",\r\n        `WHERE ${whereClauses.join(\" AND \")}`,\r\n        \"ORDER BY metrics.cost_micros DESC\",\r\n      ].join(\" \"),\r\n      developerToken,\r\n      loginCustomerId\r\n    );\r\n\r\n    const campaigns = result.rows.map((row) => {\r\n      const impressions = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.impressions\"));\r\n      const clicks = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\r\n      const cost = microsToCurrency(getFieldValue(row, \"metrics.costMicros\"));\r\n      const conversions = round(\r\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))\r\n      );\r\n      const conversionValue = round(\r\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\r\n      );\r\n\r\n      return {\r\n        campaign_id: getFieldValue(row, \"campaign.id\"),\r\n        campaign_name: getFieldValue(row, \"campaign.name\"),\r\n        status: getFieldValue(row, \"campaign.status\"),\r\n        channel_type: getFieldValue(row, \"campaign.advertisingChannelType\"),\r\n        impressions,\r\n        clicks,\r\n        cost,\r\n        conversions,\r\n        conversion_value: conversionValue,\r\n        ctr_percent: round(parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.ctr\")) * 100),\r\n        average_cpc: microsToCurrency(getFieldValue(row, \"metrics.averageCpc\")),\r\n        cpa: round(cost / conversions),\r\n        roas: round(conversionValue / cost),\r\n        conversion_rate_percent: round(toPercent(conversions, clicks)),\r\n        cost_share_percent: 0,\r\n      };\r\n    });\r\n\r\n    const totals = campaigns.reduce(\r\n      (acc, campaign) => {\r\n        acc.impressions += campaign.impressions;\r\n        acc.clicks += campaign.clicks;\r\n        acc.cost += campaign.cost;\r\n        acc.conversions += campaign.conversions;\r\n        acc.conversion_value += campaign.conversion_value;\r\n        return acc;\r\n      },\r\n      {\r\n        impressions: 0,\r\n        clicks: 0,\r\n        cost: 0,\r\n        conversions: 0,\r\n        conversion_value: 0,\r\n      }\r\n    );\r\n    const campaignsWithShare = campaigns.map((campaign) => ({\r\n      ...campaign,\r\n      cost_share_percent: round(toPercent(campaign.cost, totals.cost)),\r\n    }));\r\n\r\n    return object(\r\n      stripNulls({\r\n        customer_id: customerId,\r\n        login_customer_id: loginCustomerId,\r\n        date_range: {\r\n          start_date: params.startDate,\r\n          end_date: params.endDate,\r\n        },\r\n        customer_name: getFieldValue(result.rows[0] ?? {}, \"customer.descriptiveName\"),\r\n        currency_code: getFieldValue(result.rows[0] ?? {}, \"customer.currencyCode\"),\r\n        applied_filters: {\r\n          enabled_only: params.enabledOnly !== false,\r\n          statuses: effectiveStatuses,\r\n        },\r\n        overview: {\r\n          total_campaigns: campaignsWithShare.length,\r\n          impressions: totals.impressions,\r\n          clicks: totals.clicks,\r\n          cost: round(totals.cost),\r\n          conversions: round(totals.conversions),\r\n          conversion_value: round(totals.conversion_value),\r\n          ctr_percent: round(toPercent(totals.clicks, totals.impressions)),\r\n          average_cpc: round(totals.cost / totals.clicks),\r\n          cpa: round(totals.cost / totals.conversions),\r\n          roas: round(totals.conversion_value / totals.cost),\r\n          conversion_rate_percent: round(toPercent(totals.conversions, totals.clicks)),\r\n          top_campaign_by_cost: campaignsWithShare[0]?.campaign_name,\r\n        },\r\n        campaigns: campaignsWithShare,\r\n        metadata: {\r\n          row_count: result.rows.length,\r\n          request_id: result.requestId,\r\n        },\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(\r\n      err instanceof Error ? err.message : \"Failed to fetch Google Ads campaign performance\"\r\n    );\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  dateRegex,\n  getFieldValue,\n  microsToCurrency,\n  parseGoogleAdsMetricValue,\n  resolveGoogleAdsCustomerId,\n  resolveGoogleAdsDeveloperToken,\n  resolveGoogleAdsLoginCustomerId,\n  round,\n  toPercent,\n} from \"../../utils/google-ads.js\";\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nconst campaignStatusEnum = z.enum([\"ENABLED\", \"PAUSED\", \"REMOVED\"]);\n\nexport const googleAdsCampaignPerformanceSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\n  customerId: z.string().optional().describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\n  loginCustomerId: z\n    .string()\n    .optional()\n    .describe(\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\n    ),\n  enabledOnly: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe(\"If true, only returns enabled campaigns unless statusFilter is explicitly provided.\"),\n  statusFilter: z\n    .array(campaignStatusEnum)\n    .optional()\n    .describe(\"Optional list of campaign statuses to include. Overrides enabledOnly when provided.\"),\n});\n\nexport async function googleAdsCampaignPerformanceHandler(\n  params: z.infer<typeof googleAdsCampaignPerformanceSchema>\n) {\n  try {\n    const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n    const developerToken = resolveGoogleAdsDeveloperToken();\n    const effectiveStatuses =\n      params.statusFilter && params.statusFilter.length > 0\n        ? params.statusFilter\n        : params.enabledOnly !== false\n          ? [\"ENABLED\"]\n          : undefined;\n    const whereClauses = [`segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`];\n\n    if (effectiveStatuses?.length) {\n      whereClauses.push(\n        `campaign.status IN (${effectiveStatuses.map((status) => `'${status}'`).join(\", \")})`\n      );\n    }\n\n    const result = await searchGoogleAds(\n      customerId,\n      [\n        \"SELECT\",\n        \"customer.descriptive_name,\",\n        \"customer.currency_code,\",\n        \"campaign.id,\",\n        \"campaign.name,\",\n        \"campaign.status,\",\n        \"campaign.advertising_channel_type,\",\n        \"metrics.impressions,\",\n        \"metrics.clicks,\",\n        \"metrics.cost_micros,\",\n        \"metrics.conversions,\",\n        \"metrics.conversions_value,\",\n        \"metrics.ctr,\",\n        \"metrics.average_cpc\",\n        \"FROM campaign\",\n        `WHERE ${whereClauses.join(\" AND \")}`,\n        \"ORDER BY metrics.cost_micros DESC\",\n      ].join(\" \"),\n      developerToken,\n      loginCustomerId\n    );\n\n    const campaigns = result.rows.map((row) => {\n      const impressions = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.impressions\"));\n      const clicks = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\n      const cost = microsToCurrency(getFieldValue(row, \"metrics.costMicros\"));\n      const conversions = round(\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))\n      );\n      const conversionValue = round(\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\n      );\n\n      return {\n        campaign_id: getFieldValue(row, \"campaign.id\"),\n        campaign_name: getFieldValue(row, \"campaign.name\"),\n        status: getFieldValue(row, \"campaign.status\"),\n        channel_type: getFieldValue(row, \"campaign.advertisingChannelType\"),\n        impressions,\n        clicks,\n        cost,\n        conversions,\n        conversion_value: conversionValue,\n        ctr_percent: round(parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.ctr\")) * 100),\n        average_cpc: microsToCurrency(getFieldValue(row, \"metrics.averageCpc\")),\n        cpa: round(cost / conversions),\n        roas: round(conversionValue / cost),\n        conversion_rate_percent: round(toPercent(conversions, clicks)),\n        cost_share_percent: 0,\n      };\n    });\n\n    const totals = campaigns.reduce(\n      (acc, campaign) => {\n        acc.impressions += campaign.impressions;\n        acc.clicks += campaign.clicks;\n        acc.cost += campaign.cost;\n        acc.conversions += campaign.conversions;\n        acc.conversion_value += campaign.conversion_value;\n        return acc;\n      },\n      {\n        impressions: 0,\n        clicks: 0,\n        cost: 0,\n        conversions: 0,\n        conversion_value: 0,\n      }\n    );\n    const campaignsWithShare = campaigns.map((campaign) => ({\n      ...campaign,\n      cost_share_percent: round(toPercent(campaign.cost, totals.cost)),\n    }));\n\n    return object(\n      stripNulls({\n        customer_id: customerId,\n        login_customer_id: loginCustomerId,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        customer_name: getFieldValue(result.rows[0] ?? {}, \"customer.descriptiveName\"),\n        currency_code: getFieldValue(result.rows[0] ?? {}, \"customer.currencyCode\"),\n        applied_filters: {\n          enabled_only: params.enabledOnly !== false,\n          statuses: effectiveStatuses,\n        },\n        overview: {\n          total_campaigns: campaignsWithShare.length,\n          impressions: totals.impressions,\n          clicks: totals.clicks,\n          cost: round(totals.cost),\n          conversions: round(totals.conversions),\n          conversion_value: round(totals.conversion_value),\n          ctr_percent: round(toPercent(totals.clicks, totals.impressions)),\n          average_cpc: round(totals.cost / totals.clicks),\n          cpa: round(totals.cost / totals.conversions),\n          roas: round(totals.conversion_value / totals.cost),\n          conversion_rate_percent: round(toPercent(totals.conversions, totals.clicks)),\n          top_campaign_by_cost: campaignsWithShare[0]?.campaign_name,\n        },\n        campaigns: campaignsWithShare,\n        metadata: {\n          row_count: result.rows.length,\n          request_id: result.requestId,\n        },\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to fetch Google Ads campaign performance\"\n    );\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/src/tools/google-ads/channel-mix.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/google-ads/channel-mix.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\r\nimport { z } from \"zod\";\r\n\r\nimport {\r\n  dateRegex,\r\n  getFieldValue,\r\n  microsToCurrency,\r\n  parseGoogleAdsMetricValue,\r\n  resolveGoogleAdsCustomerId,\r\n  resolveGoogleAdsDeveloperToken,\r\n  resolveGoogleAdsLoginCustomerId,\r\n  round,\r\n  toPercent,\r\n} from \"../../utils/google-ads.js\";\r\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\r\nimport { stripNulls } from \"../../utils/strip-payload.js\";\r\n\r\nexport const googleAdsChannelMixSchema = z.object({\r\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\r\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\r\n  customerId: z\r\n    .string()\r\n    .optional()\r\n    .describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\r\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\r\n  loginCustomerId: z\r\n    .string()\r\n    .optional()\r\n    .describe(\r\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\r\n    ),\r\n});\r\n\r\nexport async function googleAdsChannelMixHandler(\r\n  params: z.infer<typeof googleAdsChannelMixSchema>\r\n) {\r\n  try {\r\n    const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\r\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\r\n    const developerToken = resolveGoogleAdsDeveloperToken();\r\n\r\n    const result = await searchGoogleAds(\r\n      customerId,\r\n      [\r\n        \"SELECT\",\r\n        \"customer.descriptive_name,\",\r\n        \"customer.currency_code,\",\r\n        \"campaign.advertising_channel_type,\",\r\n        \"metrics.impressions,\",\r\n        \"metrics.clicks,\",\r\n        \"metrics.cost_micros,\",\r\n        \"metrics.conversions,\",\r\n        \"metrics.conversions_value\",\r\n        \"FROM campaign\",\r\n        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\r\n        \"AND campaign.status = 'ENABLED'\",\r\n        \"ORDER BY metrics.cost_micros DESC\",\r\n      ].join(\" \"),\r\n      developerToken,\r\n      loginCustomerId\r\n    );\r\n\r\n    const grouped = new Map<\r\n      string,\r\n      {\r\n        channel_type: string;\r\n        impressions: number;\r\n        clicks: number;\r\n        cost: number;\r\n        conversions: number;\r\n        conversion_value: number;\r\n      }\r\n    >();\r\n\r\n    for (const row of result.rows) {\r\n      const channelType = String(\r\n        getFieldValue(row, \"campaign.advertisingChannelType\", \"UNKNOWN\") ?? \"UNKNOWN\"\r\n      );\r\n      const current = grouped.get(channelType) ?? {\r\n        channel_type: channelType,\r\n        impressions: 0,\r\n        clicks: 0,\r\n        cost: 0,\r\n        conversions: 0,\r\n        conversion_value: 0,\r\n      };\r\n\r\n      current.impressions += parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.impressions\"));\r\n      current.clicks += parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\r\n      current.cost += microsToCurrency(getFieldValue(row, \"metrics.costMicros\"));\r\n      current.conversions += round(\r\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))\r\n      );\r\n      current.conversion_value += round(\r\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\r\n      );\r\n\r\n      grouped.set(channelType, current);\r\n    }\r\n\r\n    const totals = Array.from(grouped.values()).reduce(\r\n      (acc, channel) => {\r\n        acc.impressions += channel.impressions;\r\n        acc.clicks += channel.clicks;\r\n        acc.cost += channel.cost;\r\n        acc.conversions += channel.conversions;\r\n        acc.conversion_value += channel.conversion_value;\r\n        return acc;\r\n      },\r\n      { impressions: 0, clicks: 0, cost: 0, conversions: 0, conversion_value: 0 }\r\n    );\r\n\r\n    const channels = Array.from(grouped.values())\r\n      .map((channel) => ({\r\n        ...channel,\r\n        cost: round(channel.cost),\r\n        conversions: round(channel.conversions),\r\n        conversion_value: round(channel.conversion_value),\r\n        ctr_percent: round(toPercent(channel.clicks, channel.impressions)),\r\n        cost_share_percent: round(toPercent(channel.cost, totals.cost)),\r\n        cpa: round(channel.cost / channel.conversions),\r\n        roas: round(channel.conversion_value / channel.cost),\r\n      }))\r\n      .sort((a, b) => b.cost - a.cost);\r\n\r\n    return object(\r\n      stripNulls({\r\n        customer_id: customerId,\r\n        login_customer_id: loginCustomerId,\r\n        customer_name: getFieldValue(result.rows[0] ?? {}, \"customer.descriptiveName\"),\r\n        currency_code: getFieldValue(result.rows[0] ?? {}, \"customer.currencyCode\"),\r\n        date_range: {\r\n          start_date: params.startDate,\r\n          end_date: params.endDate,\r\n        },\r\n        overview: {\r\n          total_channels: channels.length,\r\n          impressions: totals.impressions,\r\n          clicks: totals.clicks,\r\n          cost: round(totals.cost),\r\n          conversions: round(totals.conversions),\r\n          conversion_value: round(totals.conversion_value),\r\n          dominant_channel: channels[0]?.channel_type,\r\n          dominant_channel_cost_share_percent: channels[0]?.cost_share_percent,\r\n        },\r\n        channels,\r\n        metadata: {\r\n          row_count: result.rows.length,\r\n          request_id: result.requestId,\r\n        },\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(err instanceof Error ? err.message : \"Failed to fetch Google Ads channel mix\");\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  dateRegex,\n  getFieldValue,\n  microsToCurrency,\n  parseGoogleAdsMetricValue,\n  resolveGoogleAdsCustomerId,\n  resolveGoogleAdsDeveloperToken,\n  resolveGoogleAdsLoginCustomerId,\n  round,\n  toPercent,\n} from \"../../utils/google-ads.js\";\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const googleAdsChannelMixSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\n  customerId: z\n    .string()\n    .optional()\n    .describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\n  loginCustomerId: z\n    .string()\n    .optional()\n    .describe(\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\n    ),\n});\n\nexport async function googleAdsChannelMixHandler(\n  params: z.infer<typeof googleAdsChannelMixSchema>\n) {\n  try {\n    const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n    const developerToken = resolveGoogleAdsDeveloperToken();\n\n    const result = await searchGoogleAds(\n      customerId,\n      [\n        \"SELECT\",\n        \"customer.descriptive_name,\",\n        \"customer.currency_code,\",\n        \"campaign.advertising_channel_type,\",\n        \"metrics.impressions,\",\n        \"metrics.clicks,\",\n        \"metrics.cost_micros,\",\n        \"metrics.conversions,\",\n        \"metrics.conversions_value\",\n        \"FROM campaign\",\n        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\n        \"AND campaign.status = 'ENABLED'\",\n        \"ORDER BY metrics.cost_micros DESC\",\n      ].join(\" \"),\n      developerToken,\n      loginCustomerId\n    );\n\n    const grouped = new Map<\n      string,\n      {\n        channel_type: string;\n        impressions: number;\n        clicks: number;\n        cost: number;\n        conversions: number;\n        conversion_value: number;\n      }\n    >();\n\n    for (const row of result.rows) {\n      const channelType = String(\n        getFieldValue(row, \"campaign.advertisingChannelType\", \"UNKNOWN\") ?? \"UNKNOWN\"\n      );\n      const current = grouped.get(channelType) ?? {\n        channel_type: channelType,\n        impressions: 0,\n        clicks: 0,\n        cost: 0,\n        conversions: 0,\n        conversion_value: 0,\n      };\n\n      current.impressions += parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.impressions\"));\n      current.clicks += parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\n      current.cost += microsToCurrency(getFieldValue(row, \"metrics.costMicros\"));\n      current.conversions += round(\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))\n      );\n      current.conversion_value += round(\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\n      );\n\n      grouped.set(channelType, current);\n    }\n\n    const totals = Array.from(grouped.values()).reduce(\n      (acc, channel) => {\n        acc.impressions += channel.impressions;\n        acc.clicks += channel.clicks;\n        acc.cost += channel.cost;\n        acc.conversions += channel.conversions;\n        acc.conversion_value += channel.conversion_value;\n        return acc;\n      },\n      { impressions: 0, clicks: 0, cost: 0, conversions: 0, conversion_value: 0 }\n    );\n\n    const channels = Array.from(grouped.values())\n      .map((channel) => ({\n        ...channel,\n        cost: round(channel.cost),\n        conversions: round(channel.conversions),\n        conversion_value: round(channel.conversion_value),\n        ctr_percent: round(toPercent(channel.clicks, channel.impressions)),\n        cost_share_percent: round(toPercent(channel.cost, totals.cost)),\n        cpa: round(channel.cost / channel.conversions),\n        roas: round(channel.conversion_value / channel.cost),\n      }))\n      .sort((a, b) => b.cost - a.cost);\n\n    return object(\n      stripNulls({\n        customer_id: customerId,\n        login_customer_id: loginCustomerId,\n        customer_name: getFieldValue(result.rows[0] ?? {}, \"customer.descriptiveName\"),\n        currency_code: getFieldValue(result.rows[0] ?? {}, \"customer.currencyCode\"),\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        overview: {\n          total_channels: channels.length,\n          impressions: totals.impressions,\n          clicks: totals.clicks,\n          cost: round(totals.cost),\n          conversions: round(totals.conversions),\n          conversion_value: round(totals.conversion_value),\n          dominant_channel: channels[0]?.channel_type,\n          dominant_channel_cost_share_percent: channels[0]?.cost_share_percent,\n        },\n        channels,\n        metadata: {\n          row_count: result.rows.length,\n          request_id: result.requestId,\n        },\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to fetch Google Ads channel mix\");\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/src/tools/google-ads/compare-accounts.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/google-ads/compare-accounts.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\r\nimport { z } from \"zod\";\r\n\r\nimport {\r\n  dateRegex,\r\n  getFieldValue,\r\n  microsToCurrency,\r\n  parseGoogleAdsMetricValue,\r\n  resolveGoogleAdsCustomerId,\r\n  resolveGoogleAdsDeveloperToken,\r\n  resolveGoogleAdsLoginCustomerId,\r\n  round,\r\n  toPercent,\r\n} from \"../../utils/google-ads.js\";\r\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\r\nimport { stripNulls } from \"../../utils/strip-payload.js\";\r\n\r\nexport const googleAdsCompareAccountsSchema = z.object({\r\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\r\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\r\n  customerIds: z\r\n    .array(z.string())\r\n    .min(2)\r\n    .max(10)\r\n    .describe(\"Google Ads customer IDs to compare. Accepts digits with or without hyphens.\"),\r\n  loginCustomerId: z\r\n    .string()\r\n    .optional()\r\n    .describe(\r\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\r\n    ),\r\n});\r\n\r\nexport async function googleAdsCompareAccountsHandler(\r\n  params: z.infer<typeof googleAdsCompareAccountsSchema>\r\n) {\r\n  try {\r\n    const customerIds = await Promise.all(params.customerIds.map((id) => resolveGoogleAdsCustomerId(id)));\r\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\r\n    const developerToken = resolveGoogleAdsDeveloperToken();\r\n\r\n    const accountResults = await Promise.all(\r\n      customerIds.map(async (customerId) => {\r\n        const [overviewResult, campaignResult] = await Promise.all([\r\n          searchGoogleAds(\r\n            customerId,\r\n            [\r\n              \"SELECT\",\r\n              \"customer.descriptive_name,\",\r\n              \"customer.currency_code,\",\r\n              \"metrics.clicks,\",\r\n              \"metrics.cost_micros,\",\r\n              \"metrics.conversions,\",\r\n              \"metrics.conversions_value\",\r\n              \"FROM customer\",\r\n              `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\r\n            ].join(\" \"),\r\n            developerToken,\r\n            loginCustomerId\r\n          ),\r\n          searchGoogleAds(\r\n            customerId,\r\n            [\r\n              \"SELECT\",\r\n              \"metrics.cost_micros\",\r\n              \"FROM campaign\",\r\n              `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\r\n              \"AND campaign.status = 'ENABLED'\",\r\n              \"ORDER BY metrics.cost_micros DESC\",\r\n            ].join(\" \"),\r\n            developerToken,\r\n            loginCustomerId\r\n          ),\r\n        ]);\r\n\r\n        const row = overviewResult.rows[0] ?? {};\r\n        const cost = microsToCurrency(getFieldValue(row, \"metrics.costMicros\"));\r\n        const conversions = round(\r\n          parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))\r\n        );\r\n        const conversionValue = round(\r\n          parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\r\n        );\r\n        const clicks = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\r\n        const roas = round(conversionValue / cost);\r\n        const cpa = round(cost / conversions);\r\n        const topCampaignCost = microsToCurrency(\r\n          getFieldValue(campaignResult.rows[0] ?? {}, \"metrics.costMicros\")\r\n        );\r\n        const topCampaignCostSharePercent = round(toPercent(topCampaignCost, cost));\r\n\r\n        const riskScore =\r\n          (roas < 1 ? 40 : roas < 1.5 ? 20 : 0) +\r\n          (conversions < 5 ? 25 : 0) +\r\n          (topCampaignCostSharePercent >= 70 ? 25 : topCampaignCostSharePercent >= 50 ? 10 : 0) +\r\n          (cost <= 0 ? 10 : 0);\r\n\r\n        return {\r\n          customer_id: customerId,\r\n          customer_name: getFieldValue(row, \"customer.descriptiveName\"),\r\n          currency_code: getFieldValue(row, \"customer.currencyCode\"),\r\n          cost,\r\n          clicks,\r\n          conversions,\r\n          conversion_value: conversionValue,\r\n          roas,\r\n          cpa,\r\n          top_campaign_cost_share_percent: topCampaignCostSharePercent,\r\n          risk_score: riskScore,\r\n        };\r\n      })\r\n    );\r\n\r\n    const rankedAccounts = accountResults.sort((a, b) => b.risk_score - a.risk_score);\r\n\r\n    return object(\r\n      stripNulls({\r\n        login_customer_id: loginCustomerId,\r\n        date_range: {\r\n          start_date: params.startDate,\r\n          end_date: params.endDate,\r\n        },\r\n        overview: {\r\n          compared_accounts: rankedAccounts.length,\r\n          highest_risk_customer_id: rankedAccounts[0]?.customer_id,\r\n          highest_risk_customer_name: rankedAccounts[0]?.customer_name,\r\n          lowest_risk_customer_id: rankedAccounts.at(-1)?.customer_id,\r\n          lowest_risk_customer_name: rankedAccounts.at(-1)?.customer_name,\r\n        },\r\n        accounts: rankedAccounts,\r\n        interpretation: {\r\n          worst_account: rankedAccounts[0]\r\n            ? `${rankedAccounts[0].customer_name} appears to be the weakest account, mainly driven by ROAS ${rankedAccounts[0].roas}, ${rankedAccounts[0].conversions} conversions, and ${rankedAccounts[0].top_campaign_cost_share_percent}% spend concentration in the top campaign.`\r\n            : undefined,\r\n        },\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(err instanceof Error ? err.message : \"Failed to compare Google Ads accounts\");\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  dateRegex,\n  getFieldValue,\n  microsToCurrency,\n  parseGoogleAdsMetricValue,\n  resolveGoogleAdsCustomerId,\n  resolveGoogleAdsDeveloperToken,\n  resolveGoogleAdsLoginCustomerId,\n  round,\n  toPercent,\n} from \"../../utils/google-ads.js\";\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const googleAdsCompareAccountsSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\n  customerIds: z\n    .array(z.string())\n    .min(2)\n    .max(10)\n    .describe(\"Google Ads customer IDs to compare. Accepts digits with or without hyphens.\"),\n  loginCustomerId: z\n    .string()\n    .optional()\n    .describe(\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\n    ),\n});\n\nexport async function googleAdsCompareAccountsHandler(\n  params: z.infer<typeof googleAdsCompareAccountsSchema>\n) {\n  try {\n    const customerIds = await Promise.all(params.customerIds.map((id) => resolveGoogleAdsCustomerId(id)));\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n    const developerToken = resolveGoogleAdsDeveloperToken();\n\n    const accountResults = await Promise.all(\n      customerIds.map(async (customerId) => {\n        const [overviewResult, campaignResult] = await Promise.all([\n          searchGoogleAds(\n            customerId,\n            [\n              \"SELECT\",\n              \"customer.descriptive_name,\",\n              \"customer.currency_code,\",\n              \"metrics.clicks,\",\n              \"metrics.cost_micros,\",\n              \"metrics.conversions,\",\n              \"metrics.conversions_value\",\n              \"FROM customer\",\n              `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\n            ].join(\" \"),\n            developerToken,\n            loginCustomerId\n          ),\n          searchGoogleAds(\n            customerId,\n            [\n              \"SELECT\",\n              \"metrics.cost_micros\",\n              \"FROM campaign\",\n              `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\n              \"AND campaign.status = 'ENABLED'\",\n              \"ORDER BY metrics.cost_micros DESC\",\n            ].join(\" \"),\n            developerToken,\n            loginCustomerId\n          ),\n        ]);\n\n        const row = overviewResult.rows[0] ?? {};\n        const cost = microsToCurrency(getFieldValue(row, \"metrics.costMicros\"));\n        const conversions = round(\n          parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))\n        );\n        const conversionValue = round(\n          parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\n        );\n        const clicks = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\n        const roas = round(conversionValue / cost);\n        const cpa = round(cost / conversions);\n        const topCampaignCost = microsToCurrency(\n          getFieldValue(campaignResult.rows[0] ?? {}, \"metrics.costMicros\")\n        );\n        const topCampaignCostSharePercent = round(toPercent(topCampaignCost, cost));\n\n        const riskScore =\n          (roas < 1 ? 40 : roas < 1.5 ? 20 : 0) +\n          (conversions < 5 ? 25 : 0) +\n          (topCampaignCostSharePercent >= 70 ? 25 : topCampaignCostSharePercent >= 50 ? 10 : 0) +\n          (cost <= 0 ? 10 : 0);\n\n        return {\n          customer_id: customerId,\n          customer_name: getFieldValue(row, \"customer.descriptiveName\"),\n          currency_code: getFieldValue(row, \"customer.currencyCode\"),\n          cost,\n          clicks,\n          conversions,\n          conversion_value: conversionValue,\n          roas,\n          cpa,\n          top_campaign_cost_share_percent: topCampaignCostSharePercent,\n          risk_score: riskScore,\n        };\n      })\n    );\n\n    const rankedAccounts = accountResults.sort((a, b) => b.risk_score - a.risk_score);\n\n    return object(\n      stripNulls({\n        login_customer_id: loginCustomerId,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        overview: {\n          compared_accounts: rankedAccounts.length,\n          highest_risk_customer_id: rankedAccounts[0]?.customer_id,\n          highest_risk_customer_name: rankedAccounts[0]?.customer_name,\n          lowest_risk_customer_id: rankedAccounts.at(-1)?.customer_id,\n          lowest_risk_customer_name: rankedAccounts.at(-1)?.customer_name,\n        },\n        accounts: rankedAccounts,\n        interpretation: {\n          worst_account: rankedAccounts[0]\n            ? `${rankedAccounts[0].customer_name} appears to be the weakest account, mainly driven by ROAS ${rankedAccounts[0].roas}, ${rankedAccounts[0].conversions} conversions, and ${rankedAccounts[0].top_campaign_cost_share_percent}% spend concentration in the top campaign.`\n            : undefined,\n        },\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to compare Google Ads accounts\");\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/src/tools/google-ads/customer-clients.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/google-ads/customer-clients.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\r\nimport { z } from \"zod\";\r\n\r\nimport {\r\n  getFieldValue,\r\n  resolveGoogleAdsCustomerId,\r\n  resolveGoogleAdsDeveloperToken,\r\n  resolveGoogleAdsLoginCustomerId,\r\n} from \"../../utils/google-ads.js\";\r\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\r\nimport { stripNulls } from \"../../utils/strip-payload.js\";\r\n\r\nexport const googleAdsCustomerClientsSchema = z.object({\r\n  customerId: z\r\n    .string()\r\n    .optional()\r\n    .describe(\"Google Ads customer ID to inspect for visible child accounts. If omitted, resolves the profileId mapping.\"),\r\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\r\n  loginCustomerId: z\r\n    .string()\r\n    .optional()\r\n    .describe(\r\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\r\n    ),\r\n});\r\n\r\nexport async function googleAdsCustomerClientsHandler(\r\n  params: z.infer<typeof googleAdsCustomerClientsSchema>\r\n) {\r\n  try {\r\n    const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\r\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\r\n    const developerToken = resolveGoogleAdsDeveloperToken();\r\n\r\n    const result = await searchGoogleAds(\r\n      customerId,\r\n      [\r\n        \"SELECT\",\r\n        \"customer_client.client_customer,\",\r\n        \"customer_client.descriptive_name,\",\r\n        \"customer_client.currency_code,\",\r\n        \"customer_client.time_zone,\",\r\n        \"customer_client.manager,\",\r\n        \"customer_client.test_account,\",\r\n        \"customer_client.status\",\r\n        \"FROM customer_client\",\r\n        \"ORDER BY customer_client.descriptive_name\",\r\n      ].join(\" \"),\r\n      developerToken,\r\n      loginCustomerId\r\n    );\r\n\r\n    const customers = result.rows.map((row) => ({\r\n      customer_id: String(getFieldValue(row, \"customerClient.clientCustomer\") ?? \"\").replace(\r\n        \"customers/\",\r\n        \"\"\r\n      ),\r\n      descriptive_name: getFieldValue(row, \"customerClient.descriptiveName\"),\r\n      currency_code: getFieldValue(row, \"customerClient.currencyCode\"),\r\n      time_zone: getFieldValue(row, \"customerClient.timeZone\"),\r\n      is_manager: getFieldValue<boolean>(row, \"customerClient.manager\"),\r\n      is_test_account: getFieldValue<boolean>(row, \"customerClient.testAccount\"),\r\n      status: getFieldValue(row, \"customerClient.status\"),\r\n    }));\r\n\r\n    return object(\r\n      stripNulls({\r\n        customer_id: customerId,\r\n        login_customer_id: loginCustomerId,\r\n        overview: {\r\n          total_visible_customers: customers.length,\r\n          manager_customers: customers.filter((customer) => customer.is_manager).length,\r\n          client_customers: customers.filter((customer) => customer.is_manager === false).length,\r\n        },\r\n        customers,\r\n        metadata: {\r\n          row_count: result.rows.length,\r\n          request_id: result.requestId,\r\n        },\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(\r\n      err instanceof Error ? err.message : \"Failed to list visible Google Ads customer clients\"\r\n    );\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  getFieldValue,\n  resolveGoogleAdsCustomerId,\n  resolveGoogleAdsDeveloperToken,\n  resolveGoogleAdsLoginCustomerId,\n} from \"../../utils/google-ads.js\";\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const googleAdsCustomerClientsSchema = z.object({\n  customerId: z\n    .string()\n    .optional()\n    .describe(\"Google Ads customer ID to inspect for visible child accounts. If omitted, resolves the profileId mapping.\"),\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\n  loginCustomerId: z\n    .string()\n    .optional()\n    .describe(\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\n    ),\n});\n\nexport async function googleAdsCustomerClientsHandler(\n  params: z.infer<typeof googleAdsCustomerClientsSchema>\n) {\n  try {\n    const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n    const developerToken = resolveGoogleAdsDeveloperToken();\n\n    const result = await searchGoogleAds(\n      customerId,\n      [\n        \"SELECT\",\n        \"customer_client.client_customer,\",\n        \"customer_client.descriptive_name,\",\n        \"customer_client.currency_code,\",\n        \"customer_client.time_zone,\",\n        \"customer_client.manager,\",\n        \"customer_client.test_account,\",\n        \"customer_client.status\",\n        \"FROM customer_client\",\n        \"ORDER BY customer_client.descriptive_name\",\n      ].join(\" \"),\n      developerToken,\n      loginCustomerId\n    );\n\n    const customers = result.rows.map((row) => ({\n      customer_id: String(getFieldValue(row, \"customerClient.clientCustomer\") ?? \"\").replace(\n        \"customers/\",\n        \"\"\n      ),\n      descriptive_name: getFieldValue(row, \"customerClient.descriptiveName\"),\n      currency_code: getFieldValue(row, \"customerClient.currencyCode\"),\n      time_zone: getFieldValue(row, \"customerClient.timeZone\"),\n      is_manager: getFieldValue<boolean>(row, \"customerClient.manager\"),\n      is_test_account: getFieldValue<boolean>(row, \"customerClient.testAccount\"),\n      status: getFieldValue(row, \"customerClient.status\"),\n    }));\n\n    return object(\n      stripNulls({\n        customer_id: customerId,\n        login_customer_id: loginCustomerId,\n        overview: {\n          total_visible_customers: customers.length,\n          manager_customers: customers.filter((customer) => customer.is_manager).length,\n          client_customers: customers.filter((customer) => customer.is_manager === false).length,\n        },\n        customers,\n        metadata: {\n          row_count: result.rows.length,\n          request_id: result.requestId,\n        },\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to list visible Google Ads customer clients\"\n    );\n  }\n}\n"],
   "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAEpB,MAAM,iCAAiC,EAAE,OAAO;AAAA,EACrD,YAAY,EACT,OAAO,EACP,SAAS,EACT,SAAS,2GAA2G;AAAA,EACvH,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,iFAAiF;AAAA,EAC3H,iBAAiB,EACd,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AACJ,CAAC;AAED,eAAsB,gCACpB,QACA;AACA,MAAI;AACF,UAAM,aAAa,MAAM,2BAA2B,OAAO,YAAY,OAAO,SAAS;AACvF,UAAM,kBAAkB,gCAAgC,OAAO,eAAe;AAC9E,UAAM,iBAAiB,+BAA+B;AAEtD,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,EAAE,KAAK,GAAG;AAAA,MACV;AAAA,MACA;AAAA,IACF;AAEA,UAAM,YAAY,OAAO,KAAK,IAAI,CAAC,SAAS;AAAA,MAC1C,aAAa,OAAO,cAAc,KAAK,+BAA+B,KAAK,EAAE,EAAE;AAAA,QAC7E;AAAA,QACA;AAAA,MACF;AAAA,MACA,kBAAkB,cAAc,KAAK,gCAAgC;AAAA,MACrE,eAAe,cAAc,KAAK,6BAA6B;AAAA,MAC/D,WAAW,cAAc,KAAK,yBAAyB;AAAA,MACvD,YAAY,cAAuB,KAAK,wBAAwB;AAAA,MAChE,iBAAiB,cAAuB,KAAK,4BAA4B;AAAA,MACzE,QAAQ,cAAc,KAAK,uBAAuB;AAAA,IACpD,EAAE;AAEF,WAAO;AAAA,MACL,WAAW;AAAA,QACT,aAAa;AAAA,QACb,mBAAmB;AAAA,QACnB,UAAU;AAAA,UACR,yBAAyB,UAAU;AAAA,UACnC,mBAAmB,UAAU,OAAO,CAAC,aAAa,SAAS,UAAU,EAAE;AAAA,UACvE,kBAAkB,UAAU,OAAO,CAAC,aAAa,SAAS,eAAe,KAAK,EAAE;AAAA,QAClF;AAAA,QACA;AAAA,QACA,UAAU;AAAA,UACR,WAAW,OAAO,KAAK;AAAA,UACvB,YAAY,OAAO;AAAA,QACrB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/src/tools/google-ads/customer-info.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/google-ads/customer-info.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\r\nimport { z } from \"zod\";\r\n\r\nimport {\r\n  getFieldValue,\r\n  resolveGoogleAdsCustomerId,\r\n  resolveGoogleAdsDeveloperToken,\r\n  resolveGoogleAdsLoginCustomerId,\r\n} from \"../../utils/google-ads.js\";\r\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\r\nimport { stripNulls } from \"../../utils/strip-payload.js\";\r\n\r\nexport const googleAdsCustomerInfoSchema = z.object({\r\n  customerId: z.string().optional().describe(\"Google Ads customer ID to inspect. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\r\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\r\n  loginCustomerId: z\r\n    .string()\r\n    .optional()\r\n    .describe(\r\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\r\n    ),\r\n});\r\n\r\nexport async function googleAdsCustomerInfoHandler(\r\n  params: z.infer<typeof googleAdsCustomerInfoSchema>\r\n) {\r\n  try {\r\n    const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\r\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\r\n    const developerToken = resolveGoogleAdsDeveloperToken();\r\n\r\n    const result = await searchGoogleAds(\r\n      customerId,\r\n      [\r\n        \"SELECT\",\r\n        \"customer.id,\",\r\n        \"customer.descriptive_name,\",\r\n        \"customer.currency_code,\",\r\n        \"customer.time_zone,\",\r\n        \"customer.manager,\",\r\n        \"customer.test_account\",\r\n        \"FROM customer\",\r\n      ].join(\" \"),\r\n      developerToken,\r\n      loginCustomerId\r\n    );\r\n\r\n    const row = result.rows[0] ?? {};\r\n\r\n    return object(\r\n      stripNulls({\r\n        customer_id: customerId,\r\n        login_customer_id: loginCustomerId,\r\n        customer: {\r\n          id: getFieldValue(row, \"customer.id\"),\r\n          descriptive_name: getFieldValue(row, \"customer.descriptiveName\"),\r\n          currency_code: getFieldValue(row, \"customer.currencyCode\"),\r\n          time_zone: getFieldValue(row, \"customer.timeZone\"),\r\n          is_manager: getFieldValue(row, \"customer.manager\"),\r\n          is_test_account: getFieldValue(row, \"customer.testAccount\"),\r\n        },\r\n        metadata: {\r\n          row_count: result.rows.length,\r\n          request_id: result.requestId,\r\n        },\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(err instanceof Error ? err.message : \"Failed to fetch Google Ads customer info\");\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  getFieldValue,\n  resolveGoogleAdsCustomerId,\n  resolveGoogleAdsDeveloperToken,\n  resolveGoogleAdsLoginCustomerId,\n} from \"../../utils/google-ads.js\";\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const googleAdsCustomerInfoSchema = z.object({\n  customerId: z.string().optional().describe(\"Google Ads customer ID to inspect. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\n  loginCustomerId: z\n    .string()\n    .optional()\n    .describe(\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\n    ),\n});\n\nexport async function googleAdsCustomerInfoHandler(\n  params: z.infer<typeof googleAdsCustomerInfoSchema>\n) {\n  try {\n    const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n    const developerToken = resolveGoogleAdsDeveloperToken();\n\n    const result = await searchGoogleAds(\n      customerId,\n      [\n        \"SELECT\",\n        \"customer.id,\",\n        \"customer.descriptive_name,\",\n        \"customer.currency_code,\",\n        \"customer.time_zone,\",\n        \"customer.manager,\",\n        \"customer.test_account\",\n        \"FROM customer\",\n      ].join(\" \"),\n      developerToken,\n      loginCustomerId\n    );\n\n    const row = result.rows[0] ?? {};\n\n    return object(\n      stripNulls({\n        customer_id: customerId,\n        login_customer_id: loginCustomerId,\n        customer: {\n          id: getFieldValue(row, \"customer.id\"),\n          descriptive_name: getFieldValue(row, \"customer.descriptiveName\"),\n          currency_code: getFieldValue(row, \"customer.currencyCode\"),\n          time_zone: getFieldValue(row, \"customer.timeZone\"),\n          is_manager: getFieldValue(row, \"customer.manager\"),\n          is_test_account: getFieldValue(row, \"customer.testAccount\"),\n        },\n        metadata: {\n          row_count: result.rows.length,\n          request_id: result.requestId,\n        },\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to fetch Google Ads customer info\");\n  }\n}\n"],
   "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAEpB,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAClD,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,wHAAwH;AAAA,EACnK,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,iFAAiF;AAAA,EAC3H,iBAAiB,EACd,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AACJ,CAAC;AAED,eAAsB,6BACpB,QACA;AACA,MAAI;AACF,UAAM,aAAa,MAAM,2BAA2B,OAAO,YAAY,OAAO,SAAS;AACvF,UAAM,kBAAkB,gCAAgC,OAAO,eAAe;AAC9E,UAAM,iBAAiB,+BAA+B;AAEtD,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,EAAE,KAAK,GAAG;AAAA,MACV;AAAA,MACA;AAAA,IACF;AAEA,UAAM,MAAM,OAAO,KAAK,CAAC,KAAK,CAAC;AAE/B,WAAO;AAAA,MACL,WAAW;AAAA,QACT,aAAa;AAAA,QACb,mBAAmB;AAAA,QACnB,UAAU;AAAA,UACR,IAAI,cAAc,KAAK,aAAa;AAAA,UACpC,kBAAkB,cAAc,KAAK,0BAA0B;AAAA,UAC/D,eAAe,cAAc,KAAK,uBAAuB;AAAA,UACzD,WAAW,cAAc,KAAK,mBAAmB;AAAA,UACjD,YAAY,cAAc,KAAK,kBAAkB;AAAA,UACjD,iBAAiB,cAAc,KAAK,sBAAsB;AAAA,QAC5D;AAAA,QACA,UAAU;AAAA,UACR,WAAW,OAAO,KAAK;AAAA,UACvB,YAAY,OAAO;AAAA,QACrB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,0CAA0C;AAAA,EAC9F;AACF;",
   "names": []
 }

package/dist/src/tools/google-ads/index.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/google-ads/index.ts"],
-  "sourcesContent": ["export * from \"./customer-info.js\";\r\nexport * from \"./customer-clients.js\";\r\nexport * from \"./account-overview.js\";\r\nexport * from \"./campaign-performance.js\";\r\nexport * from \"./time-series.js\";\r\nexport * from \"./search-terms-summary.js\";\r\nexport * from \"./channel-mix.js\";\r\nexport * from \"./account-risks.js\";\r\nexport * from \"./break-even-analysis.js\";\r\nexport * from \"./scaling-health.js\";\r\nexport * from \"./compare-accounts.js\";\r\n"],
+  "sourcesContent": ["export * from \"./customer-info.js\";\nexport * from \"./customer-clients.js\";\nexport * from \"./account-overview.js\";\nexport * from \"./campaign-performance.js\";\nexport * from \"./time-series.js\";\nexport * from \"./search-terms-summary.js\";\nexport * from \"./channel-mix.js\";\nexport * from \"./account-risks.js\";\nexport * from \"./break-even-analysis.js\";\nexport * from \"./scaling-health.js\";\nexport * from \"./compare-accounts.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;",
   "names": []
 }

package/dist/src/tools/google-ads/scaling-health.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/google-ads/scaling-health.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\r\nimport { z } from \"zod\";\r\n\r\nimport {\r\n  dateRegex,\r\n  getFieldValue,\r\n  microsToCurrency,\r\n  parseGoogleAdsMetricValue,\r\n  resolveGoogleAdsCustomerId,\r\n  resolveGoogleAdsDeveloperToken,\r\n  resolveGoogleAdsLoginCustomerId,\r\n  round,\r\n  toPercent,\r\n} from \"../../utils/google-ads.js\";\r\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\r\nimport { stripNulls } from \"../../utils/strip-payload.js\";\r\n\r\nexport const googleAdsScalingHealthSchema = z.object({\r\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\r\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\r\n  customerId: z\r\n    .string()\r\n    .optional()\r\n    .describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\r\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\r\n  loginCustomerId: z\r\n    .string()\r\n    .optional()\r\n    .describe(\r\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\r\n    ),\r\n  breakEvenRoas: z\r\n    .number()\r\n    .positive()\r\n    .describe(\"Break-even ROAS for the business.\"),\r\n  targetCpa: z\r\n    .number()\r\n    .positive()\r\n    .optional()\r\n    .describe(\"Optional maximum acceptable CPA for the business.\"),\r\n});\r\n\r\nexport async function googleAdsScalingHealthHandler(\r\n  params: z.infer<typeof googleAdsScalingHealthSchema>\r\n) {\r\n  try {\r\n    const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\r\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\r\n    const developerToken = resolveGoogleAdsDeveloperToken();\r\n\r\n    const overviewResult = await searchGoogleAds(\r\n      customerId,\r\n      [\r\n        \"SELECT\",\r\n        \"customer.descriptive_name,\",\r\n        \"customer.currency_code,\",\r\n        \"metrics.clicks,\",\r\n        \"metrics.cost_micros,\",\r\n        \"metrics.conversions,\",\r\n        \"metrics.conversions_value\",\r\n        \"FROM customer\",\r\n        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\r\n      ].join(\" \"),\r\n      developerToken,\r\n      loginCustomerId\r\n    );\r\n    const campaignsResult = await searchGoogleAds(\r\n      customerId,\r\n      [\r\n        \"SELECT\",\r\n        \"campaign.name,\",\r\n        \"metrics.cost_micros,\",\r\n        \"metrics.conversions_value,\",\r\n        \"metrics.conversions\",\r\n        \"FROM campaign\",\r\n        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\r\n        \"AND campaign.status = 'ENABLED'\",\r\n        \"ORDER BY metrics.cost_micros DESC\",\r\n      ].join(\" \"),\r\n      developerToken,\r\n      loginCustomerId\r\n    );\r\n    const seriesResult = await searchGoogleAds(\r\n      customerId,\r\n      [\r\n        \"SELECT\",\r\n        \"segments.date,\",\r\n        \"metrics.cost_micros,\",\r\n        \"metrics.conversions_value,\",\r\n        \"metrics.conversions\",\r\n        \"FROM customer\",\r\n        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\r\n        \"ORDER BY segments.date\",\r\n      ].join(\" \"),\r\n      developerToken,\r\n      loginCustomerId\r\n    );\r\n\r\n    const overviewRow = overviewResult.rows[0] ?? {};\r\n    const cost = microsToCurrency(getFieldValue(overviewRow, \"metrics.costMicros\"));\r\n    const conversions = round(\r\n      parseGoogleAdsMetricValue(getFieldValue(overviewRow, \"metrics.conversions\"))\r\n    );\r\n    const conversionValue = round(\r\n      parseGoogleAdsMetricValue(getFieldValue(overviewRow, \"metrics.conversionsValue\"))\r\n    );\r\n    const clicks = parseGoogleAdsMetricValue(getFieldValue(overviewRow, \"metrics.clicks\"));\r\n    const currentRoas = round(conversionValue / cost);\r\n    const currentCpa = round(cost / conversions);\r\n\r\n    const campaignCosts = campaignsResult.rows.map((row) =>\r\n      microsToCurrency(getFieldValue(row, \"metrics.costMicros\"))\r\n    );\r\n    const topCampaignCostShare = round(toPercent(campaignCosts[0] ?? 0, cost));\r\n\r\n    const series = seriesResult.rows.map((row) => ({\r\n      cost: microsToCurrency(getFieldValue(row, \"metrics.costMicros\")),\r\n      conversion_value: round(\r\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\r\n      ),\r\n      conversions: round(parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))),\r\n    }));\r\n    const midpoint = Math.ceil(series.length / 2);\r\n    const firstHalf = series.slice(0, midpoint);\r\n    const secondHalf = series.slice(midpoint);\r\n    const firstHalfRoas = round(\r\n      firstHalf.reduce((sum, item) => sum + item.conversion_value, 0) /\r\n        firstHalf.reduce((sum, item) => sum + item.cost, 0)\r\n    );\r\n    const secondHalfRoas = round(\r\n      secondHalf.reduce((sum, item) => sum + item.conversion_value, 0) /\r\n        secondHalf.reduce((sum, item) => sum + item.cost, 0)\r\n    );\r\n\r\n    let score = 0;\r\n    if (currentRoas >= params.breakEvenRoas) score += 35;\r\n    else if (currentRoas >= params.breakEvenRoas * 0.8) score += 20;\r\n\r\n    if (!params.targetCpa || (currentCpa > 0 && currentCpa <= params.targetCpa)) score += 20;\r\n    else if (params.targetCpa && currentCpa <= params.targetCpa * 1.2) score += 10;\r\n\r\n    if (topCampaignCostShare < 50) score += 20;\r\n    else if (topCampaignCostShare < 70) score += 10;\r\n\r\n    if (secondHalfRoas >= firstHalfRoas * 0.9) score += 15;\r\n    else if (secondHalfRoas >= firstHalfRoas * 0.75) score += 8;\r\n\r\n    if (conversions >= 10) score += 10;\r\n    else if (conversions >= 5) score += 5;\r\n\r\n    const status =\r\n      score >= 75 ? \"ready_to_scale\" : score >= 50 ? \"scale_with_caution\" : \"not_ready\";\r\n\r\n    return object(\r\n      stripNulls({\r\n        customer_id: customerId,\r\n        login_customer_id: loginCustomerId,\r\n        customer_name: getFieldValue(overviewRow, \"customer.descriptiveName\"),\r\n        currency_code: getFieldValue(overviewRow, \"customer.currencyCode\"),\r\n        date_range: {\r\n          start_date: params.startDate,\r\n          end_date: params.endDate,\r\n        },\r\n        inputs: {\r\n          break_even_roas: params.breakEvenRoas,\r\n          target_cpa: params.targetCpa,\r\n        },\r\n        overview: {\r\n          cost,\r\n          clicks,\r\n          conversions,\r\n          conversion_value: conversionValue,\r\n          current_roas: currentRoas,\r\n          current_cpa: currentCpa,\r\n          top_campaign_cost_share_percent: topCampaignCostShare,\r\n          first_half_roas: firstHalfRoas,\r\n          second_half_roas: secondHalfRoas,\r\n          scaling_health_score: score,\r\n          scaling_health_status: status,\r\n        },\r\n        checks: {\r\n          above_break_even: currentRoas >= params.breakEvenRoas,\r\n          cpa_within_target: params.targetCpa ? currentCpa <= params.targetCpa : undefined,\r\n          concentration_acceptable: topCampaignCostShare < 70,\r\n          recent_efficiency_stable: secondHalfRoas >= firstHalfRoas * 0.9,\r\n          conversion_volume_acceptable: conversions >= 5,\r\n        },\r\n        interpretation: {\r\n          status,\r\n          message:\r\n            status === \"ready_to_scale\"\r\n              ? \"The account shows enough efficiency and stability to test scaling.\"\r\n              : status === \"scale_with_caution\"\r\n                ? \"The account has mixed signals. Scale only with tight monitoring.\"\r\n                : \"The account is not ready to scale without increasing risk.\",\r\n        },\r\n        metadata: {\r\n          request_ids: [overviewResult.requestId, campaignsResult.requestId, seriesResult.requestId],\r\n        },\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(\r\n      err instanceof Error ? err.message : \"Failed to evaluate Google Ads scaling health\"\r\n    );\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  dateRegex,\n  getFieldValue,\n  microsToCurrency,\n  parseGoogleAdsMetricValue,\n  resolveGoogleAdsCustomerId,\n  resolveGoogleAdsDeveloperToken,\n  resolveGoogleAdsLoginCustomerId,\n  round,\n  toPercent,\n} from \"../../utils/google-ads.js\";\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const googleAdsScalingHealthSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\n  customerId: z\n    .string()\n    .optional()\n    .describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\n  loginCustomerId: z\n    .string()\n    .optional()\n    .describe(\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\n    ),\n  breakEvenRoas: z\n    .number()\n    .positive()\n    .describe(\"Break-even ROAS for the business.\"),\n  targetCpa: z\n    .number()\n    .positive()\n    .optional()\n    .describe(\"Optional maximum acceptable CPA for the business.\"),\n});\n\nexport async function googleAdsScalingHealthHandler(\n  params: z.infer<typeof googleAdsScalingHealthSchema>\n) {\n  try {\n    const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n    const developerToken = resolveGoogleAdsDeveloperToken();\n\n    const overviewResult = await searchGoogleAds(\n      customerId,\n      [\n        \"SELECT\",\n        \"customer.descriptive_name,\",\n        \"customer.currency_code,\",\n        \"metrics.clicks,\",\n        \"metrics.cost_micros,\",\n        \"metrics.conversions,\",\n        \"metrics.conversions_value\",\n        \"FROM customer\",\n        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\n      ].join(\" \"),\n      developerToken,\n      loginCustomerId\n    );\n    const campaignsResult = await searchGoogleAds(\n      customerId,\n      [\n        \"SELECT\",\n        \"campaign.name,\",\n        \"metrics.cost_micros,\",\n        \"metrics.conversions_value,\",\n        \"metrics.conversions\",\n        \"FROM campaign\",\n        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\n        \"AND campaign.status = 'ENABLED'\",\n        \"ORDER BY metrics.cost_micros DESC\",\n      ].join(\" \"),\n      developerToken,\n      loginCustomerId\n    );\n    const seriesResult = await searchGoogleAds(\n      customerId,\n      [\n        \"SELECT\",\n        \"segments.date,\",\n        \"metrics.cost_micros,\",\n        \"metrics.conversions_value,\",\n        \"metrics.conversions\",\n        \"FROM customer\",\n        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\n        \"ORDER BY segments.date\",\n      ].join(\" \"),\n      developerToken,\n      loginCustomerId\n    );\n\n    const overviewRow = overviewResult.rows[0] ?? {};\n    const cost = microsToCurrency(getFieldValue(overviewRow, \"metrics.costMicros\"));\n    const conversions = round(\n      parseGoogleAdsMetricValue(getFieldValue(overviewRow, \"metrics.conversions\"))\n    );\n    const conversionValue = round(\n      parseGoogleAdsMetricValue(getFieldValue(overviewRow, \"metrics.conversionsValue\"))\n    );\n    const clicks = parseGoogleAdsMetricValue(getFieldValue(overviewRow, \"metrics.clicks\"));\n    const currentRoas = round(conversionValue / cost);\n    const currentCpa = round(cost / conversions);\n\n    const campaignCosts = campaignsResult.rows.map((row) =>\n      microsToCurrency(getFieldValue(row, \"metrics.costMicros\"))\n    );\n    const topCampaignCostShare = round(toPercent(campaignCosts[0] ?? 0, cost));\n\n    const series = seriesResult.rows.map((row) => ({\n      cost: microsToCurrency(getFieldValue(row, \"metrics.costMicros\")),\n      conversion_value: round(\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\n      ),\n      conversions: round(parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))),\n    }));\n    const midpoint = Math.ceil(series.length / 2);\n    const firstHalf = series.slice(0, midpoint);\n    const secondHalf = series.slice(midpoint);\n    const firstHalfRoas = round(\n      firstHalf.reduce((sum, item) => sum + item.conversion_value, 0) /\n        firstHalf.reduce((sum, item) => sum + item.cost, 0)\n    );\n    const secondHalfRoas = round(\n      secondHalf.reduce((sum, item) => sum + item.conversion_value, 0) /\n        secondHalf.reduce((sum, item) => sum + item.cost, 0)\n    );\n\n    let score = 0;\n    if (currentRoas >= params.breakEvenRoas) score += 35;\n    else if (currentRoas >= params.breakEvenRoas * 0.8) score += 20;\n\n    if (!params.targetCpa || (currentCpa > 0 && currentCpa <= params.targetCpa)) score += 20;\n    else if (params.targetCpa && currentCpa <= params.targetCpa * 1.2) score += 10;\n\n    if (topCampaignCostShare < 50) score += 20;\n    else if (topCampaignCostShare < 70) score += 10;\n\n    if (secondHalfRoas >= firstHalfRoas * 0.9) score += 15;\n    else if (secondHalfRoas >= firstHalfRoas * 0.75) score += 8;\n\n    if (conversions >= 10) score += 10;\n    else if (conversions >= 5) score += 5;\n\n    const status =\n      score >= 75 ? \"ready_to_scale\" : score >= 50 ? \"scale_with_caution\" : \"not_ready\";\n\n    return object(\n      stripNulls({\n        customer_id: customerId,\n        login_customer_id: loginCustomerId,\n        customer_name: getFieldValue(overviewRow, \"customer.descriptiveName\"),\n        currency_code: getFieldValue(overviewRow, \"customer.currencyCode\"),\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        inputs: {\n          break_even_roas: params.breakEvenRoas,\n          target_cpa: params.targetCpa,\n        },\n        overview: {\n          cost,\n          clicks,\n          conversions,\n          conversion_value: conversionValue,\n          current_roas: currentRoas,\n          current_cpa: currentCpa,\n          top_campaign_cost_share_percent: topCampaignCostShare,\n          first_half_roas: firstHalfRoas,\n          second_half_roas: secondHalfRoas,\n          scaling_health_score: score,\n          scaling_health_status: status,\n        },\n        checks: {\n          above_break_even: currentRoas >= params.breakEvenRoas,\n          cpa_within_target: params.targetCpa ? currentCpa <= params.targetCpa : undefined,\n          concentration_acceptable: topCampaignCostShare < 70,\n          recent_efficiency_stable: secondHalfRoas >= firstHalfRoas * 0.9,\n          conversion_volume_acceptable: conversions >= 5,\n        },\n        interpretation: {\n          status,\n          message:\n            status === \"ready_to_scale\"\n              ? \"The account shows enough efficiency and stability to test scaling.\"\n              : status === \"scale_with_caution\"\n                ? \"The account has mixed signals. Scale only with tight monitoring.\"\n                : \"The account is not ready to scale without increasing risk.\",\n        },\n        metadata: {\n          request_ids: [overviewResult.requestId, campaignsResult.requestId, seriesResult.requestId],\n        },\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to evaluate Google Ads scaling health\"\n    );\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/src/tools/google-ads/search-terms-summary.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/google-ads/search-terms-summary.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\r\nimport { z } from \"zod\";\r\n\r\nimport {\r\n  dateRegex,\r\n  getFieldValue,\r\n  microsToCurrency,\r\n  parseGoogleAdsMetricValue,\r\n  resolveGoogleAdsCustomerId,\r\n  resolveGoogleAdsDeveloperToken,\r\n  resolveGoogleAdsLoginCustomerId,\r\n  round,\r\n  toPercent,\r\n} from \"../../utils/google-ads.js\";\r\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\r\nimport { stripNulls } from \"../../utils/strip-payload.js\";\r\n\r\nexport const googleAdsSearchTermsSummarySchema = z.object({\r\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\r\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\r\n  customerId: z.string().optional().describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\r\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\r\n  loginCustomerId: z\r\n    .string()\r\n    .optional()\r\n    .describe(\r\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\r\n    ),\r\n  limit: z\r\n    .number()\r\n    .int()\r\n    .min(1)\r\n    .max(50)\r\n    .optional()\r\n    .default(20)\r\n    .describe(\"Maximum number of search terms to return, ordered by spend descending.\"),\r\n});\r\n\r\nexport async function googleAdsSearchTermsSummaryHandler(\r\n  params: z.infer<typeof googleAdsSearchTermsSummarySchema>\r\n) {\r\n  try {\r\n    const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\r\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\r\n    const developerToken = resolveGoogleAdsDeveloperToken();\r\n\r\n    const result = await searchGoogleAds(\r\n      customerId,\r\n      [\r\n        \"SELECT\",\r\n        \"customer.descriptive_name,\",\r\n        \"customer.currency_code,\",\r\n        \"search_term_view.search_term,\",\r\n        \"campaign.id,\",\r\n        \"campaign.name,\",\r\n        \"ad_group.id,\",\r\n        \"ad_group.name,\",\r\n        \"metrics.impressions,\",\r\n        \"metrics.clicks,\",\r\n        \"metrics.cost_micros,\",\r\n        \"metrics.conversions,\",\r\n        \"metrics.conversions_value\",\r\n        \"FROM search_term_view\",\r\n        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\r\n        \"AND metrics.impressions > 0\",\r\n        \"ORDER BY metrics.cost_micros DESC\",\r\n        `LIMIT ${params.limit}`,\r\n      ].join(\" \"),\r\n      developerToken,\r\n      loginCustomerId\r\n    );\r\n\r\n    const searchTerms = result.rows.map((row) => {\r\n      const impressions = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.impressions\"));\r\n      const clicks = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\r\n      const cost = microsToCurrency(getFieldValue(row, \"metrics.costMicros\"));\r\n      const conversions = round(\r\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))\r\n      );\r\n      const conversionValue = round(\r\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\r\n      );\r\n\r\n      return {\r\n        search_term: getFieldValue(row, \"searchTermView.searchTerm\"),\r\n        campaign_id: getFieldValue(row, \"campaign.id\"),\r\n        campaign_name: getFieldValue(row, \"campaign.name\"),\r\n        ad_group_id: getFieldValue(row, \"adGroup.id\"),\r\n        ad_group_name: getFieldValue(row, \"adGroup.name\"),\r\n        impressions,\r\n        clicks,\r\n        cost,\r\n        conversions,\r\n        conversion_value: conversionValue,\r\n        ctr_percent: round(toPercent(clicks, impressions)),\r\n        cpa: round(cost / conversions),\r\n        roas: round(conversionValue / cost),\r\n      };\r\n    });\r\n\r\n    const totals = searchTerms.reduce(\r\n      (acc, item) => {\r\n        acc.impressions += item.impressions;\r\n        acc.clicks += item.clicks;\r\n        acc.cost += item.cost;\r\n        acc.conversions += item.conversions;\r\n        acc.conversion_value += item.conversion_value;\r\n        return acc;\r\n      },\r\n      { impressions: 0, clicks: 0, cost: 0, conversions: 0, conversion_value: 0 }\r\n    );\r\n\r\n    return object(\r\n      stripNulls({\r\n        customer_id: customerId,\r\n        login_customer_id: loginCustomerId,\r\n        customer_name: getFieldValue(result.rows[0] ?? {}, \"customer.descriptiveName\"),\r\n        currency_code: getFieldValue(result.rows[0] ?? {}, \"customer.currencyCode\"),\r\n        date_range: {\r\n          start_date: params.startDate,\r\n          end_date: params.endDate,\r\n        },\r\n        overview: {\r\n          returned_terms: searchTerms.length,\r\n          impressions: totals.impressions,\r\n          clicks: totals.clicks,\r\n          cost: round(totals.cost),\r\n          conversions: round(totals.conversions),\r\n          conversion_value: round(totals.conversion_value),\r\n          ctr_percent: round(toPercent(totals.clicks, totals.impressions)),\r\n          cpa: round(totals.cost / totals.conversions),\r\n          roas: round(totals.conversion_value / totals.cost),\r\n          top_term_by_cost: searchTerms[0]?.search_term,\r\n        },\r\n        search_terms: searchTerms,\r\n        metadata: {\r\n          row_count: result.rows.length,\r\n          request_id: result.requestId,\r\n        },\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(\r\n      err instanceof Error ? err.message : \"Failed to fetch Google Ads search terms summary\"\r\n    );\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  dateRegex,\n  getFieldValue,\n  microsToCurrency,\n  parseGoogleAdsMetricValue,\n  resolveGoogleAdsCustomerId,\n  resolveGoogleAdsDeveloperToken,\n  resolveGoogleAdsLoginCustomerId,\n  round,\n  toPercent,\n} from \"../../utils/google-ads.js\";\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const googleAdsSearchTermsSummarySchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\n  customerId: z.string().optional().describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\n  loginCustomerId: z\n    .string()\n    .optional()\n    .describe(\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\n    ),\n  limit: z\n    .number()\n    .int()\n    .min(1)\n    .max(50)\n    .optional()\n    .default(20)\n    .describe(\"Maximum number of search terms to return, ordered by spend descending.\"),\n});\n\nexport async function googleAdsSearchTermsSummaryHandler(\n  params: z.infer<typeof googleAdsSearchTermsSummarySchema>\n) {\n  try {\n    const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n    const developerToken = resolveGoogleAdsDeveloperToken();\n\n    const result = await searchGoogleAds(\n      customerId,\n      [\n        \"SELECT\",\n        \"customer.descriptive_name,\",\n        \"customer.currency_code,\",\n        \"search_term_view.search_term,\",\n        \"campaign.id,\",\n        \"campaign.name,\",\n        \"ad_group.id,\",\n        \"ad_group.name,\",\n        \"metrics.impressions,\",\n        \"metrics.clicks,\",\n        \"metrics.cost_micros,\",\n        \"metrics.conversions,\",\n        \"metrics.conversions_value\",\n        \"FROM search_term_view\",\n        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\n        \"AND metrics.impressions > 0\",\n        \"ORDER BY metrics.cost_micros DESC\",\n        `LIMIT ${params.limit}`,\n      ].join(\" \"),\n      developerToken,\n      loginCustomerId\n    );\n\n    const searchTerms = result.rows.map((row) => {\n      const impressions = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.impressions\"));\n      const clicks = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\n      const cost = microsToCurrency(getFieldValue(row, \"metrics.costMicros\"));\n      const conversions = round(\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))\n      );\n      const conversionValue = round(\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\n      );\n\n      return {\n        search_term: getFieldValue(row, \"searchTermView.searchTerm\"),\n        campaign_id: getFieldValue(row, \"campaign.id\"),\n        campaign_name: getFieldValue(row, \"campaign.name\"),\n        ad_group_id: getFieldValue(row, \"adGroup.id\"),\n        ad_group_name: getFieldValue(row, \"adGroup.name\"),\n        impressions,\n        clicks,\n        cost,\n        conversions,\n        conversion_value: conversionValue,\n        ctr_percent: round(toPercent(clicks, impressions)),\n        cpa: round(cost / conversions),\n        roas: round(conversionValue / cost),\n      };\n    });\n\n    const totals = searchTerms.reduce(\n      (acc, item) => {\n        acc.impressions += item.impressions;\n        acc.clicks += item.clicks;\n        acc.cost += item.cost;\n        acc.conversions += item.conversions;\n        acc.conversion_value += item.conversion_value;\n        return acc;\n      },\n      { impressions: 0, clicks: 0, cost: 0, conversions: 0, conversion_value: 0 }\n    );\n\n    return object(\n      stripNulls({\n        customer_id: customerId,\n        login_customer_id: loginCustomerId,\n        customer_name: getFieldValue(result.rows[0] ?? {}, \"customer.descriptiveName\"),\n        currency_code: getFieldValue(result.rows[0] ?? {}, \"customer.currencyCode\"),\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        overview: {\n          returned_terms: searchTerms.length,\n          impressions: totals.impressions,\n          clicks: totals.clicks,\n          cost: round(totals.cost),\n          conversions: round(totals.conversions),\n          conversion_value: round(totals.conversion_value),\n          ctr_percent: round(toPercent(totals.clicks, totals.impressions)),\n          cpa: round(totals.cost / totals.conversions),\n          roas: round(totals.conversion_value / totals.cost),\n          top_term_by_cost: searchTerms[0]?.search_term,\n        },\n        search_terms: searchTerms,\n        metadata: {\n          row_count: result.rows.length,\n          request_id: result.requestId,\n        },\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to fetch Google Ads search terms summary\"\n    );\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/src/tools/google-ads/time-series.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/google-ads/time-series.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\r\nimport { z } from \"zod\";\r\n\r\nimport {\r\n  dateRegex,\r\n  getFieldValue,\r\n  microsToCurrency,\r\n  parseGoogleAdsMetricValue,\r\n  resolveGoogleAdsCustomerId,\r\n  resolveGoogleAdsDeveloperToken,\r\n  resolveGoogleAdsLoginCustomerId,\r\n  round,\r\n  toPercent,\r\n} from \"../../utils/google-ads.js\";\r\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\r\nimport { stripNulls } from \"../../utils/strip-payload.js\";\r\n\r\nconst googleAdsTimeSeriesGranularityEnum = z.enum([\"daily\", \"weekly\"]);\r\n\r\nexport const googleAdsTimeSeriesSchema = z.object({\r\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\r\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\r\n  customerId: z.string().optional().describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\r\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\r\n  loginCustomerId: z\r\n    .string()\r\n    .optional()\r\n    .describe(\r\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\r\n    ),\r\n  granularity: googleAdsTimeSeriesGranularityEnum\r\n    .optional()\r\n    .default(\"daily\")\r\n    .describe(\"Time series granularity: daily or weekly.\"),\r\n});\r\n\r\nexport async function googleAdsTimeSeriesHandler(\r\n  params: z.infer<typeof googleAdsTimeSeriesSchema>\r\n) {\r\n  try {\r\n    const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\r\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\r\n    const developerToken = resolveGoogleAdsDeveloperToken();\r\n    const segmentField = params.granularity === \"weekly\" ? \"segments.week\" : \"segments.date\";\r\n\r\n    const result = await searchGoogleAds(\r\n      customerId,\r\n      [\r\n        \"SELECT\",\r\n        \"customer.descriptive_name,\",\r\n        \"customer.currency_code,\",\r\n        `${segmentField},`,\r\n        \"metrics.impressions,\",\r\n        \"metrics.clicks,\",\r\n        \"metrics.cost_micros,\",\r\n        \"metrics.conversions,\",\r\n        \"metrics.conversions_value\",\r\n        \"FROM customer\",\r\n        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\r\n        `ORDER BY ${segmentField}`,\r\n      ].join(\" \"),\r\n      developerToken,\r\n      loginCustomerId\r\n    );\r\n\r\n    const series = result.rows.map((row) => {\r\n      const impressions = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.impressions\"));\r\n      const clicks = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\r\n      const cost = microsToCurrency(getFieldValue(row, \"metrics.costMicros\"));\r\n      const conversions = round(\r\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))\r\n      );\r\n      const conversionValue = round(\r\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\r\n      );\r\n\r\n      return {\r\n        period_start: String(\r\n          getFieldValue(\r\n            row,\r\n            params.granularity === \"weekly\" ? \"segments.week\" : \"segments.date\"\r\n          ) ?? \"\"\r\n        ),\r\n        impressions,\r\n        clicks,\r\n        cost,\r\n        conversions,\r\n        conversion_value: conversionValue,\r\n        ctr_percent: round(toPercent(clicks, impressions)),\r\n        cpa: round(cost / conversions),\r\n        roas: round(conversionValue / cost),\r\n      };\r\n    });\r\n\r\n    const totals = series.reduce(\r\n      (acc, item) => {\r\n        acc.impressions += item.impressions;\r\n        acc.clicks += item.clicks;\r\n        acc.cost += item.cost;\r\n        acc.conversions += item.conversions;\r\n        acc.conversion_value += item.conversion_value;\r\n        return acc;\r\n      },\r\n      { impressions: 0, clicks: 0, cost: 0, conversions: 0, conversion_value: 0 }\r\n    );\r\n\r\n    return object(\r\n      stripNulls({\r\n        customer_id: customerId,\r\n        login_customer_id: loginCustomerId,\r\n        customer_name: getFieldValue(result.rows[0] ?? {}, \"customer.descriptiveName\"),\r\n        currency_code: getFieldValue(result.rows[0] ?? {}, \"customer.currencyCode\"),\r\n        date_range: {\r\n          start_date: params.startDate,\r\n          end_date: params.endDate,\r\n        },\r\n        granularity: params.granularity,\r\n        overview: {\r\n          periods: series.length,\r\n          impressions: totals.impressions,\r\n          clicks: totals.clicks,\r\n          cost: round(totals.cost),\r\n          conversions: round(totals.conversions),\r\n          conversion_value: round(totals.conversion_value),\r\n          ctr_percent: round(toPercent(totals.clicks, totals.impressions)),\r\n          cpa: round(totals.cost / totals.conversions),\r\n          roas: round(totals.conversion_value / totals.cost),\r\n        },\r\n        series,\r\n        metadata: {\r\n          row_count: result.rows.length,\r\n          request_id: result.requestId,\r\n        },\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(err instanceof Error ? err.message : \"Failed to fetch Google Ads time series\");\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  dateRegex,\n  getFieldValue,\n  microsToCurrency,\n  parseGoogleAdsMetricValue,\n  resolveGoogleAdsCustomerId,\n  resolveGoogleAdsDeveloperToken,\n  resolveGoogleAdsLoginCustomerId,\n  round,\n  toPercent,\n} from \"../../utils/google-ads.js\";\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nconst googleAdsTimeSeriesGranularityEnum = z.enum([\"daily\", \"weekly\"]);\n\nexport const googleAdsTimeSeriesSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\n  customerId: z.string().optional().describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\n  loginCustomerId: z\n    .string()\n    .optional()\n    .describe(\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\n    ),\n  granularity: googleAdsTimeSeriesGranularityEnum\n    .optional()\n    .default(\"daily\")\n    .describe(\"Time series granularity: daily or weekly.\"),\n});\n\nexport async function googleAdsTimeSeriesHandler(\n  params: z.infer<typeof googleAdsTimeSeriesSchema>\n) {\n  try {\n    const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n    const developerToken = resolveGoogleAdsDeveloperToken();\n    const segmentField = params.granularity === \"weekly\" ? \"segments.week\" : \"segments.date\";\n\n    const result = await searchGoogleAds(\n      customerId,\n      [\n        \"SELECT\",\n        \"customer.descriptive_name,\",\n        \"customer.currency_code,\",\n        `${segmentField},`,\n        \"metrics.impressions,\",\n        \"metrics.clicks,\",\n        \"metrics.cost_micros,\",\n        \"metrics.conversions,\",\n        \"metrics.conversions_value\",\n        \"FROM customer\",\n        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\n        `ORDER BY ${segmentField}`,\n      ].join(\" \"),\n      developerToken,\n      loginCustomerId\n    );\n\n    const series = result.rows.map((row) => {\n      const impressions = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.impressions\"));\n      const clicks = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\n      const cost = microsToCurrency(getFieldValue(row, \"metrics.costMicros\"));\n      const conversions = round(\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))\n      );\n      const conversionValue = round(\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\n      );\n\n      return {\n        period_start: String(\n          getFieldValue(\n            row,\n            params.granularity === \"weekly\" ? \"segments.week\" : \"segments.date\"\n          ) ?? \"\"\n        ),\n        impressions,\n        clicks,\n        cost,\n        conversions,\n        conversion_value: conversionValue,\n        ctr_percent: round(toPercent(clicks, impressions)),\n        cpa: round(cost / conversions),\n        roas: round(conversionValue / cost),\n      };\n    });\n\n    const totals = series.reduce(\n      (acc, item) => {\n        acc.impressions += item.impressions;\n        acc.clicks += item.clicks;\n        acc.cost += item.cost;\n        acc.conversions += item.conversions;\n        acc.conversion_value += item.conversion_value;\n        return acc;\n      },\n      { impressions: 0, clicks: 0, cost: 0, conversions: 0, conversion_value: 0 }\n    );\n\n    return object(\n      stripNulls({\n        customer_id: customerId,\n        login_customer_id: loginCustomerId,\n        customer_name: getFieldValue(result.rows[0] ?? {}, \"customer.descriptiveName\"),\n        currency_code: getFieldValue(result.rows[0] ?? {}, \"customer.currencyCode\"),\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        granularity: params.granularity,\n        overview: {\n          periods: series.length,\n          impressions: totals.impressions,\n          clicks: totals.clicks,\n          cost: round(totals.cost),\n          conversions: round(totals.conversions),\n          conversion_value: round(totals.conversion_value),\n          ctr_percent: round(toPercent(totals.clicks, totals.impressions)),\n          cpa: round(totals.cost / totals.conversions),\n          roas: round(totals.conversion_value / totals.cost),\n        },\n        series,\n        metadata: {\n          row_count: result.rows.length,\n          request_id: result.requestId,\n        },\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to fetch Google Ads time series\");\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/src/tools/index.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/tools/index.ts"],
-  "sourcesContent": ["export * from \"./config/index.js\";\r\nexport * from \"./vtex/index.js\";\r\nexport * from \"./analytics/index.js\";\r\nexport * from \"./google-ads/index.js\";\r\nexport * from \"./meta/index.js\";\r\nexport * from \"./search-console/index.js\";\r\nexport * from \"./mercadolibre/index.js\";\r\n"],
+  "sourcesContent": ["export * from \"./config/index.js\";\nexport * from \"./vtex/index.js\";\nexport * from \"./analytics/index.js\";\nexport * from \"./google-ads/index.js\";\nexport * from \"./meta/index.js\";\nexport * from \"./search-console/index.js\";\nexport * from \"./mercadolibre/index.js\";\n"],
   "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/dist/src/tools/mercadolibre/answer-question.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/answer-question.ts"],
-  "sourcesContent": ["import { z } from \"zod\";\r\n\r\nimport { answerMercadoLibreQuestion } from \"../../services/mercadolibre/mercadolibre-questions.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 meliAnswerQuestionSchema = z.object({\r\n  profileId: mercadolibreProfileIdSchemaField,\r\n  questionId: z.number().int().positive().describe(\"MercadoLibre question id.\"),\r\n  text: z.string().trim().min(1).max(2000).describe(\"Answer text to publish.\"),\r\n});\r\n\r\nexport async function meliAnswerQuestionHandler(\r\n  params: z.infer<typeof meliAnswerQuestionSchema>\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 result = await answerMercadoLibreQuestion(profileId, params.questionId, params.text);\r\n\r\n    return buildMercadoLibreWriteSuccessResponse({\r\n      profileId,\r\n      operation: \"answer_question\",\r\n      resourceId: String(params.questionId),\r\n      message: \"MercadoLibre question answered successfully.\",\r\n      after: result,\r\n    });\r\n  } catch (err) {\r\n    return handleMercadoLibreWriteError(err, `Failed to answer MercadoLibre question ${params.questionId}`);\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport { answerMercadoLibreQuestion } from \"../../services/mercadolibre/mercadolibre-questions.js\";\nimport {\n  buildMercadoLibreWriteSuccessResponse,\n  handleMercadoLibreWriteError,\n  mercadolibreProfileIdSchemaField,\n  resolveMercadoLibreWriteProfile,\n} from \"./write-helpers.js\";\n\nexport const meliAnswerQuestionSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  questionId: z.number().int().positive().describe(\"MercadoLibre question id.\"),\n  text: z.string().trim().min(1).max(2000).describe(\"Answer text to publish.\"),\n});\n\nexport async function meliAnswerQuestionHandler(\n  params: z.infer<typeof meliAnswerQuestionSchema>\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 result = await answerMercadoLibreQuestion(profileId, params.questionId, params.text);\n\n    return buildMercadoLibreWriteSuccessResponse({\n      profileId,\n      operation: \"answer_question\",\n      resourceId: String(params.questionId),\n      message: \"MercadoLibre question answered successfully.\",\n      after: result,\n    });\n  } catch (err) {\n    return handleMercadoLibreWriteError(err, `Failed to answer MercadoLibre question ${params.questionId}`);\n  }\n}\n"],
   "mappings": "AAAA,SAAS,SAAS;AAElB,SAAS,kCAAkC;AAC3C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,2BAA2B,EAAE,OAAO;AAAA,EAC/C,WAAW;AAAA,EACX,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,2BAA2B;AAAA,EAC5E,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAI,EAAE,SAAS,yBAAyB;AAC7E,CAAC;AAED,eAAsB,0BACpB,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,2BAA2B,WAAW,OAAO,YAAY,OAAO,IAAI;AAEzF,WAAO,sCAAsC;AAAA,MAC3C;AAAA,MACA,WAAW;AAAA,MACX,YAAY,OAAO,OAAO,UAAU;AAAA,MACpC,SAAS;AAAA,MACT,OAAO;AAAA,IACT,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,6BAA6B,KAAK,0CAA0C,OAAO,UAAU,EAAE;AAAA,EACxG;AACF;",
   "names": []
 }

package/dist/src/tools/mercadolibre/create-item.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/create-item.ts"],
-  "sourcesContent": ["import { z } from \"zod\";\r\n\r\nimport {\r\n  createMercadoLibreItem,\r\n  createMercadoLibreItemDescription,\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\nconst pictureSchema = z.object({\r\n  source: z.string().trim().url().describe(\"Public image URL to attach to the item.\"),\r\n});\r\n\r\nexport const meliCreateItemSchema = z.object({\r\n  profileId: mercadolibreProfileIdSchemaField,\r\n  siteId: z.string().trim().min(3).optional().describe(\"MercadoLibre site id. Defaults to MLA.\"),\r\n  title: z.string().trim().min(3).describe(\"Listing title.\"),\r\n  categoryId: z.string().trim().min(1).describe(\"MercadoLibre category id.\"),\r\n  price: z.number().positive().describe(\"Listing price.\"),\r\n  currencyId: z.string().trim().min(1).optional().describe(\"Currency id. Defaults to ARS.\"),\r\n  buyingMode: z.string().trim().min(1).optional().describe(\"Buying mode. Defaults to buy_it_now.\"),\r\n  listingTypeId: z.string().trim().min(1).describe(\"MercadoLibre listing type id.\"),\r\n  condition: z.enum([\"new\", \"used\", \"not_specified\"]).describe(\"Item condition.\"),\r\n  availableQuantity: z.number().int().min(0).describe(\"Available quantity to list.\"),\r\n  attributes: z.array(attributeSchema).optional().describe(\"MercadoLibre attributes for the listing.\"),\r\n  pictures: z.array(pictureSchema).optional().describe(\"Pictures to include in the listing.\"),\r\n  shipping: z.record(z.string(), z.unknown()).optional().describe(\"Shipping payload compatible with MercadoLibre items API.\"),\r\n  saleTerms: z.array(z.record(z.string(), z.unknown())).optional().describe(\"Sale terms array for the listing.\"),\r\n  channels: z.array(z.string().trim().min(1)).optional().describe(\"Optional channels array if supported by the account.\"),\r\n  description: z.string().trim().min(1).optional().describe(\"Optional plain-text description to publish after item creation.\"),\r\n});\r\n\r\nexport async function meliCreateItemHandler(params: z.infer<typeof meliCreateItemSchema>) {\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 created = await createMercadoLibreItem(profileId, {\r\n      site_id: params.siteId ?? \"MLA\",\r\n      title: params.title,\r\n      category_id: params.categoryId,\r\n      price: params.price,\r\n      currency_id: params.currencyId ?? \"ARS\",\r\n      buying_mode: params.buyingMode ?? \"buy_it_now\",\r\n      listing_type_id: params.listingTypeId,\r\n      condition: params.condition,\r\n      available_quantity: params.availableQuantity,\r\n      attributes: params.attributes,\r\n      pictures: params.pictures,\r\n      shipping: params.shipping,\r\n      sale_terms: params.saleTerms,\r\n      channels: params.channels,\r\n    });\r\n\r\n    if (params.description && typeof created.id === \"string\") {\r\n      await createMercadoLibreItemDescription(profileId, created.id, params.description);\r\n    }\r\n\r\n    return buildMercadoLibreWriteSuccessResponse({\r\n      profileId,\r\n      operation: \"create_item\",\r\n      resourceId: typeof created.id === \"string\" ? created.id : undefined,\r\n      message: \"MercadoLibre item created successfully.\",\r\n      after: created,\r\n      details: {\r\n        description_created: Boolean(params.description),\r\n      },\r\n    });\r\n  } catch (err) {\r\n    return handleMercadoLibreWriteError(err, \"Failed to create MercadoLibre item\");\r\n  }\r\n}\r\n"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  createMercadoLibreItem,\n  createMercadoLibreItemDescription,\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\nconst pictureSchema = z.object({\n  source: z.string().trim().url().describe(\"Public image URL to attach to the item.\"),\n});\n\nexport const meliCreateItemSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  siteId: z.string().trim().min(3).optional().describe(\"MercadoLibre site id. Defaults to MLA.\"),\n  title: z.string().trim().min(3).describe(\"Listing title.\"),\n  categoryId: z.string().trim().min(1).describe(\"MercadoLibre category id.\"),\n  price: z.number().positive().describe(\"Listing price.\"),\n  currencyId: z.string().trim().min(1).optional().describe(\"Currency id. Defaults to ARS.\"),\n  buyingMode: z.string().trim().min(1).optional().describe(\"Buying mode. Defaults to buy_it_now.\"),\n  listingTypeId: z.string().trim().min(1).describe(\"MercadoLibre listing type id.\"),\n  condition: z.enum([\"new\", \"used\", \"not_specified\"]).describe(\"Item condition.\"),\n  availableQuantity: z.number().int().min(0).describe(\"Available quantity to list.\"),\n  attributes: z.array(attributeSchema).optional().describe(\"MercadoLibre attributes for the listing.\"),\n  pictures: z.array(pictureSchema).optional().describe(\"Pictures to include in the listing.\"),\n  shipping: z.record(z.string(), z.unknown()).optional().describe(\"Shipping payload compatible with MercadoLibre items API.\"),\n  saleTerms: z.array(z.record(z.string(), z.unknown())).optional().describe(\"Sale terms array for the listing.\"),\n  channels: z.array(z.string().trim().min(1)).optional().describe(\"Optional channels array if supported by the account.\"),\n  description: z.string().trim().min(1).optional().describe(\"Optional plain-text description to publish after item creation.\"),\n});\n\nexport async function meliCreateItemHandler(params: z.infer<typeof meliCreateItemSchema>) {\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 created = await createMercadoLibreItem(profileId, {\n      site_id: params.siteId ?? \"MLA\",\n      title: params.title,\n      category_id: params.categoryId,\n      price: params.price,\n      currency_id: params.currencyId ?? \"ARS\",\n      buying_mode: params.buyingMode ?? \"buy_it_now\",\n      listing_type_id: params.listingTypeId,\n      condition: params.condition,\n      available_quantity: params.availableQuantity,\n      attributes: params.attributes,\n      pictures: params.pictures,\n      shipping: params.shipping,\n      sale_terms: params.saleTerms,\n      channels: params.channels,\n    });\n\n    if (params.description && typeof created.id === \"string\") {\n      await createMercadoLibreItemDescription(profileId, created.id, params.description);\n    }\n\n    return buildMercadoLibreWriteSuccessResponse({\n      profileId,\n      operation: \"create_item\",\n      resourceId: typeof created.id === \"string\" ? created.id : undefined,\n      message: \"MercadoLibre item created successfully.\",\n      after: created,\n      details: {\n        description_created: Boolean(params.description),\n      },\n    });\n  } catch (err) {\n    return handleMercadoLibreWriteError(err, \"Failed to create MercadoLibre item\");\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/src/tools/mercadolibre/estimate-listing-fee.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/estimate-listing-fee.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 { estimateMercadoLibreListingPrice } 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 meliEstimateListingFeeSchema = z.object({\r\n  profileId: mercadolibreProfileIdSchemaField,\r\n  price: z.number().positive().describe(\"Listing price for the product.\"),\r\n  currencyId: z.string().trim().min(1).optional().describe(\"Currency id. Defaults to ARS.\"),\r\n  categoryId: z.string().trim().min(1).describe(\"MercadoLibre category id.\"),\r\n  listingTypeId: z.string().trim().min(1).describe(\"MercadoLibre listing type id.\"),\r\n  logisticType: z.string().trim().min(1).optional().describe(\"Optional logistic type.\"),\r\n  shippingMode: z.string().trim().min(1).optional().describe(\"Optional shipping mode.\"),\r\n  billableWeight: z.number().positive().optional().describe(\"Optional billable weight for shipping-sensitive fee quotes.\"),\r\n  tags: z.array(z.string().trim().min(1)).optional().describe(\"Optional MercadoLibre pricing tags.\"),\r\n});\r\n\r\nexport async function meliEstimateListingFeeHandler(\r\n  params: z.infer<typeof meliEstimateListingFeeSchema>\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 quotes = await estimateMercadoLibreListingPrice(profileResolution.value.profileId, {\r\n      price: params.price,\r\n      currency_id: params.currencyId ?? \"ARS\",\r\n      category_id: params.categoryId,\r\n      listing_type_id: params.listingTypeId,\r\n      logistic_type: params.logisticType,\r\n      shipping_mode: params.shippingMode,\r\n      billable_weight: params.billableWeight,\r\n      tags: params.tags?.join(\",\"),\r\n    });\r\n\r\n    return object(\r\n      stripNulls({\r\n        profile_id: profileResolution.value.profileId,\r\n        quotes: asArray<Record<string, unknown>>(quotes).map((quote) => ({\r\n          listing_type_id: normalizeString(quote.listing_type_id),\r\n          listing_type_name: normalizeString(quote.listing_type_name),\r\n          currency_id: normalizeString(quote.currency_id, params.currencyId ?? \"ARS\"),\r\n          sale_fee_amount: toNumber(quote.sale_fee_amount),\r\n          sale_fee_percent: toNumber(quote.sale_fee_percent),\r\n          fixed_fee: toNumber(quote.fixed_fee),\r\n          gross_amount: toNumber(quote.gross_amount ?? params.price),\r\n          net_amount: toNumber(quote.net_amount),\r\n          free_relist: quote.free_relist,\r\n        })),\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(formatMercadoLibreError(err, \"Failed to estimate MercadoLibre listing fee\"));\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 { estimateMercadoLibreListingPrice } 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 meliEstimateListingFeeSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  price: z.number().positive().describe(\"Listing price for the product.\"),\n  currencyId: z.string().trim().min(1).optional().describe(\"Currency id. Defaults to ARS.\"),\n  categoryId: z.string().trim().min(1).describe(\"MercadoLibre category id.\"),\n  listingTypeId: z.string().trim().min(1).describe(\"MercadoLibre listing type id.\"),\n  logisticType: z.string().trim().min(1).optional().describe(\"Optional logistic type.\"),\n  shippingMode: z.string().trim().min(1).optional().describe(\"Optional shipping mode.\"),\n  billableWeight: z.number().positive().optional().describe(\"Optional billable weight for shipping-sensitive fee quotes.\"),\n  tags: z.array(z.string().trim().min(1)).optional().describe(\"Optional MercadoLibre pricing tags.\"),\n});\n\nexport async function meliEstimateListingFeeHandler(\n  params: z.infer<typeof meliEstimateListingFeeSchema>\n) {\n  try {\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const quotes = await estimateMercadoLibreListingPrice(profileResolution.value.profileId, {\n      price: params.price,\n      currency_id: params.currencyId ?? \"ARS\",\n      category_id: params.categoryId,\n      listing_type_id: params.listingTypeId,\n      logistic_type: params.logisticType,\n      shipping_mode: params.shippingMode,\n      billable_weight: params.billableWeight,\n      tags: params.tags?.join(\",\"),\n    });\n\n    return object(\n      stripNulls({\n        profile_id: profileResolution.value.profileId,\n        quotes: asArray<Record<string, unknown>>(quotes).map((quote) => ({\n          listing_type_id: normalizeString(quote.listing_type_id),\n          listing_type_name: normalizeString(quote.listing_type_name),\n          currency_id: normalizeString(quote.currency_id, params.currencyId ?? \"ARS\"),\n          sale_fee_amount: toNumber(quote.sale_fee_amount),\n          sale_fee_percent: toNumber(quote.sale_fee_percent),\n          fixed_fee: toNumber(quote.fixed_fee),\n          gross_amount: toNumber(quote.gross_amount ?? params.price),\n          net_amount: toNumber(quote.net_amount),\n          free_relist: quote.free_relist,\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to estimate MercadoLibre listing fee\"));\n  }\n}\n"],
   "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,+BAA+B;AACxC,SAAS,wCAAwC;AACjD,SAAS,kBAAkB;AAC3B,SAAS,SAAS,iBAAiB,gBAAgB;AACnD,SAAS,6CAA6C;AACtD,SAAS,wCAAwC;AAE1C,MAAM,+BAA+B,EAAE,OAAO;AAAA,EACnD,WAAW;AAAA,EACX,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,gCAAgC;AAAA,EACtE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,+BAA+B;AAAA,EACxF,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,2BAA2B;AAAA,EACzE,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,+BAA+B;AAAA,EAChF,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,yBAAyB;AAAA,EACpF,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,yBAAyB;AAAA,EACpF,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,6DAA6D;AAAA,EACvH,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,qCAAqC;AACnG,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,SAAS,MAAM,iCAAiC,kBAAkB,MAAM,WAAW;AAAA,MACvF,OAAO,OAAO;AAAA,MACd,aAAa,OAAO,cAAc;AAAA,MAClC,aAAa,OAAO;AAAA,MACpB,iBAAiB,OAAO;AAAA,MACxB,eAAe,OAAO;AAAA,MACtB,eAAe,OAAO;AAAA,MACtB,iBAAiB,OAAO;AAAA,MACxB,MAAM,OAAO,MAAM,KAAK,GAAG;AAAA,IAC7B,CAAC;AAED,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY,kBAAkB,MAAM;AAAA,QACpC,QAAQ,QAAiC,MAAM,EAAE,IAAI,CAAC,WAAW;AAAA,UAC/D,iBAAiB,gBAAgB,MAAM,eAAe;AAAA,UACtD,mBAAmB,gBAAgB,MAAM,iBAAiB;AAAA,UAC1D,aAAa,gBAAgB,MAAM,aAAa,OAAO,cAAc,KAAK;AAAA,UAC1E,iBAAiB,SAAS,MAAM,eAAe;AAAA,UAC/C,kBAAkB,SAAS,MAAM,gBAAgB;AAAA,UACjD,WAAW,SAAS,MAAM,SAAS;AAAA,UACnC,cAAc,SAAS,MAAM,gBAAgB,OAAO,KAAK;AAAA,UACzD,YAAY,SAAS,MAAM,UAAU;AAAA,UACrC,aAAa,MAAM;AAAA,QACrB,EAAE;AAAA,MACJ,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,wBAAwB,KAAK,6CAA6C,CAAC;AAAA,EAC1F;AACF;",
   "names": []
 }

package/dist/src/tools/mercadolibre/get-account-context.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/get-account-context.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 { 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 meliGetAccountContextSchema = z.object({\r\n  profileId: mercadolibreProfileIdSchemaField,\r\n});\r\n\r\nexport async function meliGetAccountContextHandler(\r\n  params: z.infer<typeof meliGetAccountContextSchema>\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 account = await getMercadoLibreUsersMe(profileId);\r\n\r\n    return object(\r\n      stripNulls({\r\n        profile_id: profileId,\r\n        seller_id: access.sellerId,\r\n        nickname: typeof account.nickname === \"string\" ? account.nickname : null,\r\n        account_id: account.id,\r\n        scopes: access.scopes,\r\n        expires_at: access.expiresAt,\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(formatMercadoLibreError(err, \"Failed to fetch MercadoLibre account context\"));\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 { 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 meliGetAccountContextSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n});\n\nexport async function meliGetAccountContextHandler(\n  params: z.infer<typeof meliGetAccountContextSchema>\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 account = await getMercadoLibreUsersMe(profileId);\n\n    return object(\n      stripNulls({\n        profile_id: profileId,\n        seller_id: access.sellerId,\n        nickname: typeof account.nickname === \"string\" ? account.nickname : null,\n        account_id: account.id,\n        scopes: access.scopes,\n        expires_at: access.expiresAt,\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to fetch MercadoLibre account context\"));\n  }\n}\n"],
   "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uCAAuC;AAChD,SAAS,wBAAwB,+BAA+B;AAChE,SAAS,kBAAkB;AAC3B,SAAS,6CAA6C;AACtD,SAAS,wCAAwC;AAE1C,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAClD,WAAW;AACb,CAAC;AAED,eAAsB,6BACpB,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,UAAU,MAAM,uBAAuB,SAAS;AAEtD,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,QACZ,WAAW,OAAO;AAAA,QAClB,UAAU,OAAO,QAAQ,aAAa,WAAW,QAAQ,WAAW;AAAA,QACpE,YAAY,QAAQ;AAAA,QACpB,QAAQ,OAAO;AAAA,QACf,YAAY,OAAO;AAAA,MACrB,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,wBAAwB,KAAK,8CAA8C,CAAC;AAAA,EAC3F;AACF;",
   "names": []
 }

package/dist/src/tools/mercadolibre/get-category-requirements.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/get-category-requirements.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 {\r\n  getMercadoLibreCategoryAttributes,\r\n  getMercadoLibreCategoryShippingPreferences,\r\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\r\nimport { stripNulls } from \"../../utils/strip-payload.js\";\r\nimport { asArray, asRecord, normalizeString } from \"./helpers.js\";\r\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\r\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\r\n\r\nexport const meliGetCategoryRequirementsSchema = z.object({\r\n  profileId: mercadolibreProfileIdSchemaField,\r\n  categoryId: z.string().trim().min(1).describe(\"MercadoLibre category id.\"),\r\n});\r\n\r\nexport async function meliGetCategoryRequirementsHandler(\r\n  params: z.infer<typeof meliGetCategoryRequirementsSchema>\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 [attributes, shippingPreferences] = await Promise.all([\r\n      getMercadoLibreCategoryAttributes(profileId, params.categoryId),\r\n      getMercadoLibreCategoryShippingPreferences(profileId, params.categoryId),\r\n    ]);\r\n\r\n    return object(\r\n      stripNulls({\r\n        profile_id: profileId,\r\n        category_id: params.categoryId,\r\n        required_attributes: asArray<Record<string, unknown>>(attributes)\r\n          .filter((attribute) => attribute.tags && typeof attribute.tags === \"object\" && Boolean(asRecord(attribute.tags).required))\r\n          .map((attribute) => ({\r\n            id: normalizeString(attribute.id),\r\n            name: normalizeString(attribute.name),\r\n            value_type: normalizeString(attribute.value_type),\r\n            value_max_length: attribute.value_max_length,\r\n          })),\r\n        recommended_attributes: asArray<Record<string, unknown>>(attributes)\r\n          .filter((attribute) => !(attribute.tags && typeof attribute.tags === \"object\" && Boolean(asRecord(attribute.tags).required)))\r\n          .slice(0, 15)\r\n          .map((attribute) => ({\r\n            id: normalizeString(attribute.id),\r\n            name: normalizeString(attribute.name),\r\n            value_type: normalizeString(attribute.value_type),\r\n          })),\r\n        shipping_preferences: stripNulls({\r\n          mode: normalizeString(shippingPreferences.mode),\r\n          logistics: Array.isArray(shippingPreferences.logistics)\r\n            ? shippingPreferences.logistics\r\n            : shippingPreferences.logistic_types,\r\n          tags: Array.isArray(shippingPreferences.tags) ? shippingPreferences.tags : undefined,\r\n        }),\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(formatMercadoLibreError(err, `Failed to fetch category requirements for ${params.categoryId}`));\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 {\n  getMercadoLibreCategoryAttributes,\n  getMercadoLibreCategoryShippingPreferences,\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { asArray, asRecord, normalizeString } from \"./helpers.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\n\nexport const meliGetCategoryRequirementsSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  categoryId: z.string().trim().min(1).describe(\"MercadoLibre category id.\"),\n});\n\nexport async function meliGetCategoryRequirementsHandler(\n  params: z.infer<typeof meliGetCategoryRequirementsSchema>\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 [attributes, shippingPreferences] = await Promise.all([\n      getMercadoLibreCategoryAttributes(profileId, params.categoryId),\n      getMercadoLibreCategoryShippingPreferences(profileId, params.categoryId),\n    ]);\n\n    return object(\n      stripNulls({\n        profile_id: profileId,\n        category_id: params.categoryId,\n        required_attributes: asArray<Record<string, unknown>>(attributes)\n          .filter((attribute) => attribute.tags && typeof attribute.tags === \"object\" && Boolean(asRecord(attribute.tags).required))\n          .map((attribute) => ({\n            id: normalizeString(attribute.id),\n            name: normalizeString(attribute.name),\n            value_type: normalizeString(attribute.value_type),\n            value_max_length: attribute.value_max_length,\n          })),\n        recommended_attributes: asArray<Record<string, unknown>>(attributes)\n          .filter((attribute) => !(attribute.tags && typeof attribute.tags === \"object\" && Boolean(asRecord(attribute.tags).required)))\n          .slice(0, 15)\n          .map((attribute) => ({\n            id: normalizeString(attribute.id),\n            name: normalizeString(attribute.name),\n            value_type: normalizeString(attribute.value_type),\n          })),\n        shipping_preferences: stripNulls({\n          mode: normalizeString(shippingPreferences.mode),\n          logistics: Array.isArray(shippingPreferences.logistics)\n            ? shippingPreferences.logistics\n            : shippingPreferences.logistic_types,\n          tags: Array.isArray(shippingPreferences.tags) ? shippingPreferences.tags : undefined,\n        }),\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, `Failed to fetch category requirements for ${params.categoryId}`));\n  }\n}\n"],
   "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,+BAA+B;AACxC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAC3B,SAAS,SAAS,UAAU,uBAAuB;AACnD,SAAS,6CAA6C;AACtD,SAAS,wCAAwC;AAE1C,MAAM,oCAAoC,EAAE,OAAO;AAAA,EACxD,WAAW;AAAA,EACX,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,2BAA2B;AAC3E,CAAC;AAED,eAAsB,mCACpB,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,CAAC,YAAY,mBAAmB,IAAI,MAAM,QAAQ,IAAI;AAAA,MAC1D,kCAAkC,WAAW,OAAO,UAAU;AAAA,MAC9D,2CAA2C,WAAW,OAAO,UAAU;AAAA,IACzE,CAAC;AAED,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,QACZ,aAAa,OAAO;AAAA,QACpB,qBAAqB,QAAiC,UAAU,EAC7D,OAAO,CAAC,cAAc,UAAU,QAAQ,OAAO,UAAU,SAAS,YAAY,QAAQ,SAAS,UAAU,IAAI,EAAE,QAAQ,CAAC,EACxH,IAAI,CAAC,eAAe;AAAA,UACnB,IAAI,gBAAgB,UAAU,EAAE;AAAA,UAChC,MAAM,gBAAgB,UAAU,IAAI;AAAA,UACpC,YAAY,gBAAgB,UAAU,UAAU;AAAA,UAChD,kBAAkB,UAAU;AAAA,QAC9B,EAAE;AAAA,QACJ,wBAAwB,QAAiC,UAAU,EAChE,OAAO,CAAC,cAAc,EAAE,UAAU,QAAQ,OAAO,UAAU,SAAS,YAAY,QAAQ,SAAS,UAAU,IAAI,EAAE,QAAQ,EAAE,EAC3H,MAAM,GAAG,EAAE,EACX,IAAI,CAAC,eAAe;AAAA,UACnB,IAAI,gBAAgB,UAAU,EAAE;AAAA,UAChC,MAAM,gBAAgB,UAAU,IAAI;AAAA,UACpC,YAAY,gBAAgB,UAAU,UAAU;AAAA,QAClD,EAAE;AAAA,QACJ,sBAAsB,WAAW;AAAA,UAC/B,MAAM,gBAAgB,oBAAoB,IAAI;AAAA,UAC9C,WAAW,MAAM,QAAQ,oBAAoB,SAAS,IAClD,oBAAoB,YACpB,oBAAoB;AAAA,UACxB,MAAM,MAAM,QAAQ,oBAAoB,IAAI,IAAI,oBAAoB,OAAO;AAAA,QAC7E,CAAC;AAAA,MACH,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,wBAAwB,KAAK,6CAA6C,OAAO,UAAU,EAAE,CAAC;AAAA,EAC7G;AACF;",
   "names": []
 }

package/dist/src/tools/mercadolibre/get-item-details.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/get-item-details.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 {\r\n  getMercadoLibreItemDetailsBatch,\r\n  getMercadoLibreItemDetailsWithFallbackBatch,\r\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\r\nimport { stripNulls } from \"../../utils/strip-payload.js\";\r\nimport { asArray, asRecord, normalizeString, toNumber } from \"./helpers.js\";\r\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\r\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\r\n\r\nconst MAX_ITEM_IDS = 50;\r\n\r\nfunction formatItem(item: Record<string, unknown>) {\r\n  return stripNulls({\r\n    item_id: normalizeString(item.id),\r\n    title: normalizeString(item.title),\r\n    status: normalizeString(item.status),\r\n    sub_status: Array.isArray(item.sub_status) ? item.sub_status : undefined,\r\n    category_id: normalizeString(item.category_id),\r\n    listing_type_id: normalizeString(item.listing_type_id),\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    condition: normalizeString(item.condition),\r\n    permalink: normalizeString(item.permalink),\r\n    pictures: asArray<Record<string, unknown>>(item.pictures).map((picture) => ({\r\n      id: normalizeString(picture.id),\r\n      url: normalizeString(picture.url ?? picture.secure_url),\r\n    })),\r\n    shipping: stripNulls({\r\n      mode: normalizeString(asRecord(item.shipping).mode),\r\n      logistic_type: normalizeString(asRecord(item.shipping).logistic_type),\r\n      free_shipping: asRecord(item.shipping).free_shipping,\r\n    }),\r\n  });\r\n}\r\n\r\nexport const meliGetItemDetailsSchema = z.object({\r\n  profileId: mercadolibreProfileIdSchemaField,\r\n  itemIds: z\r\n    .array(z.string().trim().min(1).describe(\"MercadoLibre item id.\"))\r\n    .min(1)\r\n    .max(MAX_ITEM_IDS)\r\n    .describe(\"One or more MercadoLibre item ids (up to 50).\"),\r\n});\r\n\r\nexport async function meliGetItemDetailsHandler(params: z.infer<typeof meliGetItemDetailsSchema>) {\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 uniqueItemIds = Array.from(new Set(params.itemIds));\r\n\r\n    const multigetItems = await getMercadoLibreItemDetailsBatch(profileId, uniqueItemIds);\r\n    if (multigetItems.length === uniqueItemIds.length) {\r\n      return object(\r\n        stripNulls({\r\n          metadata: {\r\n            profile_id: profileId,\r\n            requested: uniqueItemIds.length,\r\n            successful: multigetItems.length,\r\n            failed: 0,\r\n            source: \"items_multiget\",\r\n          },\r\n          items: multigetItems.map(formatItem),\r\n        })\r\n      );\r\n    }\r\n\r\n    const batch = await getMercadoLibreItemDetailsWithFallbackBatch(profileId, uniqueItemIds, {\r\n      maxConcurrency: 10,\r\n      maxRetries: 2,\r\n    });\r\n\r\n    return object(\r\n      stripNulls({\r\n        metadata: {\r\n          profile_id: profileId,\r\n          requested: uniqueItemIds.length,\r\n          successful: batch.successful.length,\r\n          failed: batch.failed.length,\r\n          has_failures: batch.failed.length > 0,\r\n          source: \"item_by_item_fallback\",\r\n        },\r\n        items: batch.successful.map((entry) => formatItem(entry.document)),\r\n        failures: batch.failed.map((failure) => ({\r\n          item_id: failure.id,\r\n          message: failure.message,\r\n          status_code: failure.statusCode,\r\n          attempts: failure.attempts,\r\n          retryable: failure.retryable,\r\n        })),\r\n      })\r\n    );\r\n  } catch (err) {\r\n    return error(formatMercadoLibreError(err, \"Failed to fetch MercadoLibre item details\"));\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 {\n  getMercadoLibreItemDetailsBatch,\n  getMercadoLibreItemDetailsWithFallbackBatch,\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 MAX_ITEM_IDS = 50;\n\nfunction formatItem(item: Record<string, unknown>) {\n  return stripNulls({\n    item_id: normalizeString(item.id),\n    title: normalizeString(item.title),\n    status: normalizeString(item.status),\n    sub_status: Array.isArray(item.sub_status) ? item.sub_status : undefined,\n    category_id: normalizeString(item.category_id),\n    listing_type_id: normalizeString(item.listing_type_id),\n    price: toNumber(item.price),\n    currency_id: normalizeString(item.currency_id, \"UNKNOWN\"),\n    available_quantity: toNumber(item.available_quantity),\n    sold_quantity: toNumber(item.sold_quantity),\n    condition: normalizeString(item.condition),\n    permalink: normalizeString(item.permalink),\n    pictures: asArray<Record<string, unknown>>(item.pictures).map((picture) => ({\n      id: normalizeString(picture.id),\n      url: normalizeString(picture.url ?? picture.secure_url),\n    })),\n    shipping: stripNulls({\n      mode: normalizeString(asRecord(item.shipping).mode),\n      logistic_type: normalizeString(asRecord(item.shipping).logistic_type),\n      free_shipping: asRecord(item.shipping).free_shipping,\n    }),\n  });\n}\n\nexport const meliGetItemDetailsSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  itemIds: z\n    .array(z.string().trim().min(1).describe(\"MercadoLibre item id.\"))\n    .min(1)\n    .max(MAX_ITEM_IDS)\n    .describe(\"One or more MercadoLibre item ids (up to 50).\"),\n});\n\nexport async function meliGetItemDetailsHandler(params: z.infer<typeof meliGetItemDetailsSchema>) {\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 uniqueItemIds = Array.from(new Set(params.itemIds));\n\n    const multigetItems = await getMercadoLibreItemDetailsBatch(profileId, uniqueItemIds);\n    if (multigetItems.length === uniqueItemIds.length) {\n      return object(\n        stripNulls({\n          metadata: {\n            profile_id: profileId,\n            requested: uniqueItemIds.length,\n            successful: multigetItems.length,\n            failed: 0,\n            source: \"items_multiget\",\n          },\n          items: multigetItems.map(formatItem),\n        })\n      );\n    }\n\n    const batch = await getMercadoLibreItemDetailsWithFallbackBatch(profileId, uniqueItemIds, {\n      maxConcurrency: 10,\n      maxRetries: 2,\n    });\n\n    return object(\n      stripNulls({\n        metadata: {\n          profile_id: profileId,\n          requested: uniqueItemIds.length,\n          successful: batch.successful.length,\n          failed: batch.failed.length,\n          has_failures: batch.failed.length > 0,\n          source: \"item_by_item_fallback\",\n        },\n        items: batch.successful.map((entry) => formatItem(entry.document)),\n        failures: batch.failed.map((failure) => ({\n          item_id: failure.id,\n          message: failure.message,\n          status_code: failure.statusCode,\n          attempts: failure.attempts,\n          retryable: failure.retryable,\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to fetch MercadoLibre item details\"));\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }