@squadbase/vite-server 0.1.9-dev.f236b23 → 0.1.10-dev.5b0c0a8

package/dist/connectors/google-ads.js

@@ -42,6 +42,39 @@ var ParameterDefinition = class {
   }
 };
 
+// ../connectors/src/connectors/google-ads/constants.ts
+var VERSION_FALLBACK_ORDER = ["v22", "v23", "v24"];
+var cachedWorkingVersion = VERSION_FALLBACK_ORDER[0];
+var looksSunset = (contentType) => {
+  return contentType != null && contentType.toLowerCase().includes("text/html");
+};
+async function fetchGoogleAdsWithVersionFallback(attempt) {
+  const order = [
+    cachedWorkingVersion,
+    ...VERSION_FALLBACK_ORDER.filter((v) => v !== cachedWorkingVersion)
+  ];
+  let lastResponse = null;
+  for (let i = 0; i < order.length; i++) {
+    const version = order[i];
+    const baseUrl = `https://googleads.googleapis.com/${version}/`;
+    const response = await attempt(baseUrl);
+    const contentType = response.headers.get("content-type");
+    if (looksSunset(contentType) && i < order.length - 1) {
+      console.warn(
+        `[google-ads] version ${version} returned a sunset/HTML response (status ${response.status}); retrying with newer version`
+      );
+      lastResponse = response;
+      continue;
+    }
+    cachedWorkingVersion = version;
+    return response;
+  }
+  return lastResponse ?? new Response(null, {
+    status: 502,
+    statusText: "All Google Ads API versions returned sunset responses"
+  });
+}
+
 // ../connectors/src/connectors/google-ads/parameters.ts
 var parameters = {
   customerId: new ParameterDefinition({
@@ -52,29 +85,13 @@ var parameters = {
     type: "text",
     secret: false,
     required: false
-  }),
-  developerToken: new ParameterDefinition({
-    slug: "developer-token",
-    name: "Google Ads Developer Token",
-    description: "The developer token for accessing the Google Ads API. Required for all API requests.",
-    envVarBaseKey: "GOOGLE_ADS_DEVELOPER_TOKEN",
-    type: "text",
-    secret: true,
-    required: true
   })
 };
 
 // ../connectors/src/connectors/google-ads/sdk/index.ts
-var BASE_URL = "https://googleads.googleapis.com/v18/";
 function createClient(params, fetchFn = fetch) {
   const rawCustomerId = params[parameters.customerId.slug];
   const defaultCustomerId = rawCustomerId?.replace(/-/g, "") ?? "";
-  const developerToken = params[parameters.developerToken.slug];
-  if (!developerToken) {
-    throw new Error(
-      `google-ads: missing required parameter: ${parameters.developerToken.slug}`
-    );
-  }
   function resolveCustomerId(override) {
     const id = override?.replace(/-/g, "") ?? defaultCustomerId;
     if (!id) {
@@ -86,26 +103,26 @@ function createClient(params, fetchFn = fetch) {
   }
   function request(path2, init) {
     const resolvedPath = defaultCustomerId ? path2.replace(/\{customerId\}/g, defaultCustomerId) : path2;
-    const url = `${BASE_URL}${resolvedPath}`;
     const headers = new Headers(init?.headers);
-    headers.set("developer-token", developerToken);
     if (defaultCustomerId) {
       headers.set("login-customer-id", defaultCustomerId);
     }
-    return fetchFn(url, { ...init, headers });
+    return fetchGoogleAdsWithVersionFallback(
+      (baseUrl) => fetchFn(`${baseUrl}${resolvedPath}`, { ...init, headers })
+    );
   }
   async function search(query, customerId) {
     const cid = resolveCustomerId(customerId);
-    const url = `${BASE_URL}customers/${cid}/googleAds:searchStream`;
     const headers = new Headers();
     headers.set("Content-Type", "application/json");
-    headers.set("developer-token", developerToken);
     headers.set("login-customer-id", cid);
-    const response = await fetchFn(url, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({ query })
-    });
+    const response = await fetchGoogleAdsWithVersionFallback(
+      (baseUrl) => fetchFn(`${baseUrl}customers/${cid}/googleAds:searchStream`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ query })
+      })
+    );
     if (!response.ok) {
       const body = await response.text();
       throw new Error(
@@ -116,10 +133,9 @@ function createClient(params, fetchFn = fetch) {
     return data.flatMap((chunk) => chunk.results ?? []);
   }
   async function listAccessibleCustomers() {
-    const url = `${BASE_URL}customers:listAccessibleCustomers`;
-    const headers = new Headers();
-    headers.set("developer-token", developerToken);
-    const response = await fetchFn(url, { method: "GET", headers });
+    const response = await fetchGoogleAdsWithVersionFallback(
+      (baseUrl) => fetchFn(`${baseUrl}customers:listAccessibleCustomers`, { method: "GET" })
+    );
     if (!response.ok) {
       const body = await response.text();
       throw new Error(
@@ -289,7 +305,65 @@ var AUTH_TYPES = {
 
 // ../connectors/src/connectors/google-ads/tools/list-customers.ts
 import { z } from "zod";
-var BASE_URL2 = "https://googleads.googleapis.com/v18/";
+
+// ../connectors/src/connectors/google-ads/error.ts
+var parseJsonOrNull = (text) => {
+  if (text.length === 0) return null;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+};
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var collectGoogleAdsErrorCodes = (details) => {
+  if (!Array.isArray(details)) return [];
+  const codes = [];
+  for (const detail of details) {
+    if (!isRecord(detail)) continue;
+    const errors = detail.errors;
+    if (!Array.isArray(errors)) continue;
+    for (const e of errors) {
+      if (!isRecord(e)) continue;
+      const errorCode = e.errorCode;
+      if (!isRecord(errorCode)) continue;
+      for (const [k, v] of Object.entries(errorCode)) {
+        if (typeof v === "string") codes.push(`${k}=${v}`);
+      }
+    }
+  }
+  return codes;
+};
+var extractGoogleAdsErrorMessage = (status, statusText, parsedBody, rawText) => {
+  const fallback = `HTTP ${status} ${statusText}`;
+  if (isRecord(parsedBody)) {
+    const errorField = parsedBody.error;
+    if (typeof errorField === "string") return errorField;
+    if (isRecord(errorField)) {
+      const message = typeof errorField.message === "string" ? errorField.message : null;
+      const errorStatus = typeof errorField.status === "string" ? errorField.status : null;
+      const codes = collectGoogleAdsErrorCodes(errorField.details);
+      const parts = [
+        fallback,
+        errorStatus,
+        message,
+        codes.length > 0 ? `[${codes.join(", ")}]` : null
+      ].filter((p) => p != null && p.length > 0);
+      if (parts.length > 1) return parts.join(": ");
+    }
+    if (typeof parsedBody.message === "string") {
+      return `${fallback}: ${parsedBody.message}`;
+    }
+  }
+  if (rawText.length > 0) {
+    const trimmed = rawText.trim();
+    const preview = trimmed.length > 500 ? `${trimmed.slice(0, 500)}\u2026` : trimmed;
+    return `${fallback}: ${preview}`;
+  }
+  return fallback;
+};
+
+// ../connectors/src/connectors/google-ads/tools/list-customers.ts
 var REQUEST_TIMEOUT_MS = 6e4;
 var cachedToken = null;
 async function getProxyToken(config) {
@@ -360,58 +434,65 @@ var listCustomersTool = new ConnectorTool({
       `[connector-request] google-ads/${connection2.name}: listCustomers`
     );
     try {
-      const developerToken = parameters.developerToken.getValue(connection2);
       const token = await getProxyToken(config.oauthProxy);
       const proxyUrl = `https://${config.oauthProxy.sandboxId}.${config.oauthProxy.previewBaseDomain}/_sqcore/connections/${connectionId}/request`;
       const controller = new AbortController();
       const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
       try {
-        const response = await fetch(proxyUrl, {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-            Authorization: `Bearer ${token}`
-          },
-          body: JSON.stringify({
-            url: `${BASE_URL2}customers:listAccessibleCustomers`,
-            method: "GET",
+        const response = await fetchGoogleAdsWithVersionFallback(
+          (baseUrl) => fetch(proxyUrl, {
+            method: "POST",
             headers: {
-              "developer-token": developerToken
-            }
-          }),
-          signal: controller.signal
-        });
-        const data = await response.json();
+              "Content-Type": "application/json",
+              Authorization: `Bearer ${token}`
+            },
+            body: JSON.stringify({
+              url: `${baseUrl}customers:listAccessibleCustomers`,
+              method: "GET"
+            }),
+            signal: controller.signal
+          })
+        );
+        const rawText = await response.text();
+        const data = parseJsonOrNull(rawText);
         if (!response.ok) {
-          const errorMessage = typeof data?.error === "string" ? data.error : typeof data?.message === "string" ? data.message : `HTTP ${response.status} ${response.statusText}`;
-          return { success: false, error: errorMessage };
+          return {
+            success: false,
+            error: extractGoogleAdsErrorMessage(
+              response.status,
+              response.statusText,
+              data,
+              rawText
+            )
+          };
         }
-        const customerIds = (data.resourceNames ?? []).map(
+        const customerIds = (data?.resourceNames ?? []).map(
           (rn) => rn.replace(/^customers\//, "")
         );
         const customers = [];
         for (const cid of customerIds) {
           try {
-            const detailResponse = await fetch(proxyUrl, {
-              method: "POST",
-              headers: {
-                "Content-Type": "application/json",
-                Authorization: `Bearer ${token}`
-              },
-              body: JSON.stringify({
-                url: `${BASE_URL2}customers/${cid}/googleAds:searchStream`,
+            const detailResponse = await fetchGoogleAdsWithVersionFallback(
+              (baseUrl) => fetch(proxyUrl, {
                 method: "POST",
                 headers: {
                   "Content-Type": "application/json",
-                  "developer-token": developerToken,
-                  "login-customer-id": cid
+                  Authorization: `Bearer ${token}`
                 },
                 body: JSON.stringify({
-                  query: "SELECT customer.id, customer.descriptive_name FROM customer LIMIT 1"
-                })
-              }),
-              signal: controller.signal
-            });
+                  url: `${baseUrl}customers/${cid}/googleAds:searchStream`,
+                  method: "POST",
+                  headers: {
+                    "Content-Type": "application/json",
+                    "login-customer-id": cid
+                  },
+                  body: JSON.stringify({
+                    query: "SELECT customer.id, customer.descriptive_name FROM customer LIMIT 1"
+                  })
+                }),
+                signal: controller.signal
+              })
+            );
             if (detailResponse.ok) {
               const detailData = await detailResponse.json();
               const customer = detailData?.[0]?.results?.[0]?.customer;
@@ -449,30 +530,24 @@ var googleAdsOnboarding = new ConnectorOnboarding({
   connectionSetupInstructions: {
     ja: `\u4EE5\u4E0B\u306E\u624B\u9806\u3067Google Ads (OAuth) \u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3092\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
 
-1. \u30E6\u30FC\u30B6\u30FC\u306B\u300CGoogle Ads API \u306E Developer Token \u3092\u5165\u529B\u3057\u3066\u304F\u3060\u3055\u3044\uFF08Google Ads \u7BA1\u7406\u753B\u9762 > \u30C4\u30FC\u30EB\u3068\u8A2D\u5B9A > API \u30BB\u30F3\u30BF\u30FC\u3067\u53D6\u5F97\u3067\u304D\u307E\u3059\uFF09\u300D\u3068\u4F1D\u3048\u308B
+1. \`${listCustomersToolName}\` \u3092\u547C\u3073\u51FA\u3057\u3066\u3001OAuth\u3067\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306AGoogle Ads\u30AB\u30B9\u30BF\u30DE\u30FC\u30A2\u30AB\u30A6\u30F3\u30C8\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B
 2. \`updateConnectionParameters\` \u3092\u547C\u3073\u51FA\u3059:
-   - \`parameterSlug\`: \`"developer-token"\`
-   - \`value\`: \u30E6\u30FC\u30B6\u30FC\u304C\u63D0\u4F9B\u3057\u305F Developer Token
-3. \`${listCustomersToolName}\` \u3092\u547C\u3073\u51FA\u3057\u3066\u3001OAuth\u3067\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306AGoogle Ads\u30AB\u30B9\u30BF\u30DE\u30FC\u30A2\u30AB\u30A6\u30F3\u30C8\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B
-4. \`updateConnectionParameters\` \u3092\u547C\u3073\u51FA\u3059:
    - \`parameterSlug\`: \`"customer-id"\`
    - \`options\`: \u30AB\u30B9\u30BF\u30DE\u30FC\u4E00\u89A7\u3002\u5404 option \u306E \`label\` \u306F \`\u30A2\u30AB\u30A6\u30F3\u30C8\u540D (id: \u30AB\u30B9\u30BF\u30DE\u30FCID)\` \u306E\u5F62\u5F0F\u3001\`value\` \u306F\u30AB\u30B9\u30BF\u30DE\u30FCID
-5. \u30E6\u30FC\u30B6\u30FC\u304C\u9078\u629E\u3057\u305F\u30AB\u30B9\u30BF\u30DE\u30FC\u306E \`label\` \u304C\u30E1\u30C3\u30BB\u30FC\u30B8\u3068\u3057\u3066\u5C4A\u304F\u306E\u3067\u3001\u6B21\u306E\u30B9\u30C6\u30C3\u30D7\u306B\u9032\u3080
+   - \u30AB\u30B9\u30BF\u30DE\u30FC\u304C **0\u4EF6** \u306E\u5834\u5408\u306F\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3092\u4E2D\u65AD\u3057\u3001\u30E6\u30FC\u30B6\u30FC\u306B\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u30A2\u30AB\u30A6\u30F3\u30C8\u304C\u306A\u3044\u65E8\u3092\u4F1D\u3048\u308B
+3. \u30E6\u30FC\u30B6\u30FC\u304C\u9078\u629E\u3057\u305F\u30AB\u30B9\u30BF\u30DE\u30FC\u306E \`label\` \u304C\u30E1\u30C3\u30BB\u30FC\u30B8\u3068\u3057\u3066\u5C4A\u304F\u306E\u3067\u3001\u6B21\u306E\u30B9\u30C6\u30C3\u30D7\u306B\u9032\u3080
 
 #### \u5236\u7D04
 - **\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u4E2D\u306B\u30EC\u30DD\u30FC\u30C8\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\u3057\u306A\u3044\u3053\u3068**\u3002\u5B9F\u884C\u3057\u3066\u3088\u3044\u306E\u306F\u4E0A\u8A18\u624B\u9806\u3067\u6307\u5B9A\u3055\u308C\u305F\u30E1\u30BF\u30C7\u30FC\u30BF\u53D6\u5F97\u306E\u307F
 - \u30C4\u30FC\u30EB\u9593\u306F1\u6587\u3060\u3051\u66F8\u3044\u3066\u5373\u6B21\u306E\u30C4\u30FC\u30EB\u547C\u3073\u51FA\u3057\u3002\u4E0D\u8981\u306A\u8AAC\u660E\u306F\u7701\u7565\u3057\u3001\u52B9\u7387\u7684\u306B\u9032\u3081\u308B`,
     en: `Follow these steps to set up the Google Ads (OAuth) connection.
 
-1. Ask the user to provide their Google Ads API Developer Token (available in Google Ads UI > Tools & Settings > API Center)
+1. Call \`${listCustomersToolName}\` to get the list of Google Ads customer accounts accessible with the OAuth credentials
 2. Call \`updateConnectionParameters\`:
-   - \`parameterSlug\`: \`"developer-token"\`
-   - \`value\`: The Developer Token provided by the user
-3. Call \`${listCustomersToolName}\` to get the list of Google Ads customer accounts accessible with the OAuth credentials
-4. Call \`updateConnectionParameters\`:
    - \`parameterSlug\`: \`"customer-id"\`
    - \`options\`: The customer list. Each option's \`label\` should be \`Account Name (id: customerId)\`, \`value\` should be the customer ID
-5. The \`label\` of the user's selected customer will arrive as a message. Proceed to the next step
+   - If **0 customers** are returned, abort setup and inform the user that no accessible accounts are available
+3. The \`label\` of the user's selected customer will arrive as a message. Proceed to the next step
 
 #### Constraints
 - **Do NOT fetch report data during setup**. Only the metadata requests specified in the steps above are allowed
@@ -488,7 +563,6 @@ var googleAdsOnboarding = new ConnectorOnboarding({
 
 // ../connectors/src/connectors/google-ads/tools/request.ts
 import { z as z2 } from "zod";
-var BASE_URL3 = "https://googleads.googleapis.com/v18/";
 var REQUEST_TIMEOUT_MS2 = 6e4;
 var cachedToken2 = null;
 async function getProxyToken2(config) {
@@ -528,7 +602,7 @@ var inputSchema2 = z2.object({
   connectionId: z2.string().describe("ID of the Google Ads OAuth connection to use"),
   method: z2.enum(["GET", "POST"]).describe("HTTP method"),
   path: z2.string().describe(
-    "API path appended to https://googleads.googleapis.com/v18/ (e.g., 'customers/{customerId}/googleAds:searchStream'). {customerId} is automatically replaced."
+    "API path appended to https://googleads.googleapis.com/<version>/ (e.g., 'customers/{customerId}/googleAds:searchStream'). The API version is auto-managed and {customerId} is automatically replaced."
   ),
   body: z2.record(z2.string(), z2.unknown()).optional().describe("POST request body (JSON)")
 });
@@ -545,7 +619,7 @@ var outputSchema2 = z2.discriminatedUnion("success", [
 ]);
 var requestTool = new ConnectorTool({
   name: "request",
-  description: `Send authenticated requests to the Google Ads API v18.
+  description: `Send authenticated requests to the Google Ads API.
 Authentication is handled automatically via OAuth proxy.
 {customerId} in the path is automatically replaced with the connection's customer ID (hyphens removed).`,
   inputSchema: inputSchema2,
@@ -565,36 +639,42 @@ Authentication is handled automatically via OAuth proxy.
       const rawCustomerId = parameters.customerId.tryGetValue(connection2);
       const customerId = rawCustomerId?.replace(/-/g, "") ?? "";
       const resolvedPath = customerId ? path2.replace(/\{customerId\}/g, customerId) : path2;
-      const url = `${BASE_URL3}${resolvedPath}`;
       const token = await getProxyToken2(config.oauthProxy);
       const proxyUrl = `https://${config.oauthProxy.sandboxId}.${config.oauthProxy.previewBaseDomain}/_sqcore/connections/${connectionId}/request`;
       const controller = new AbortController();
       const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS2);
       try {
-        const developerToken = parameters.developerToken.getValue(connection2);
-        const response = await fetch(proxyUrl, {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-            Authorization: `Bearer ${token}`
-          },
-          body: JSON.stringify({
-            url,
-            method,
+        const response = await fetchGoogleAdsWithVersionFallback(
+          (baseUrl) => fetch(proxyUrl, {
+            method: "POST",
             headers: {
               "Content-Type": "application/json",
-              "developer-token": developerToken,
-              ...customerId ? { "login-customer-id": customerId } : {}
+              Authorization: `Bearer ${token}`
             },
-            ...method === "POST" && body ? { body: JSON.stringify(body) } : {}
-          }),
-          signal: controller.signal
-        });
-        const data = await response.json();
+            body: JSON.stringify({
+              url: `${baseUrl}${resolvedPath}`,
+              method,
+              headers: {
+                "Content-Type": "application/json",
+                ...customerId ? { "login-customer-id": customerId } : {}
+              },
+              ...method === "POST" && body ? { body: JSON.stringify(body) } : {}
+            }),
+            signal: controller.signal
+          })
+        );
+        const rawText = await response.text();
+        const data = parseJsonOrNull(rawText);
         if (!response.ok) {
-          const dataObj = data;
-          const errorMessage = typeof dataObj?.error === "string" ? dataObj.error : typeof dataObj?.message === "string" ? dataObj.message : `HTTP ${response.status} ${response.statusText}`;
-          return { success: false, error: errorMessage };
+          return {
+            success: false,
+            error: extractGoogleAdsErrorMessage(
+              response.status,
+              response.statusText,
+              data,
+              rawText
+            )
+          };
         }
         return { success: true, status: response.status, data };
       } finally {
@@ -764,26 +844,22 @@ const customerIds = await ads.listAccessibleCustomers();
     if (!customerId) {
       return { success: true };
     }
-    const developerToken = params[parameters.developerToken.slug];
-    if (!developerToken) {
-      return {
-        success: false,
-        error: "Developer token is required"
-      };
-    }
-    const url = `https://googleads.googleapis.com/v18/customers/${customerId}/googleAds:searchStream`;
     try {
-      const res = await proxyFetch(url, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "developer-token": developerToken,
-          "login-customer-id": customerId
-        },
-        body: JSON.stringify({
-          query: "SELECT customer.id FROM customer LIMIT 1"
-        })
-      });
+      const res = await fetchGoogleAdsWithVersionFallback(
+        (baseUrl) => proxyFetch(
+          `${baseUrl}customers/${customerId}/googleAds:searchStream`,
+          {
+            method: "POST",
+            headers: {
+              "Content-Type": "application/json",
+              "login-customer-id": customerId
+            },
+            body: JSON.stringify({
+              query: "SELECT customer.id FROM customer LIMIT 1"
+            })
+          }
+        )
+      );
       if (!res.ok) {
         const errorText = await res.text().catch(() => res.statusText);
         return {