@crvouga/mockingbird-service-google-ads 1.2.0 → 1.3.0

package/dist/{chunk-DDJPMCRI.js → chunk-NU66LXUZ.js}

@@ -2188,7 +2188,7 @@ var stateAdminRoutes = (routes2) => {
 };
 
 // ../core/dist/version.js
-var PACKAGE_VERSION = true ? "1.2.0" : UNRELEASED_VERSION;
+var PACKAGE_VERSION = true ? "1.3.0" : UNRELEASED_VERSION;
 
 // ../core/dist/webhooks.js
 var json4 = (status, body) => new Response(JSON.stringify(body), {
@@ -3080,8 +3080,14 @@ var Rejection = class extends Error {
   }
   status;
   detail;
+  /** A Google Ads failure: google.rpc.Status wrapping a GoogleAdsFailure detail. */
   response(requestId) {
-    return rpcError(this.status, this.message, [adsFailure([this.detail], requestId)]);
+    const message = this.status === 400 ? "Request contains an invalid argument." : this.message;
+    return rpcError(this.status, message, [adsFailure([this.detail], requestId)]);
+  }
+  /** Any other Google API (Analytics Data): a plain google.rpc.Status with no Ads detail. */
+  plain() {
+    return rpcError(this.status, this.message);
   }
 };
 function reject(code, message, kind = "requestError", status = 400, field) {
@@ -3135,6 +3141,7 @@ var fingerprint = (v) => Array.from(
   sha256(new TextEncoder().encode(JSON.stringify(v))),
   (b) => b.toString(16).padStart(2, "0")
 ).join("");
+var publicSettings = ["reportingLagMs", "pageTokenTtlMs", "futureToleranceMs", "searchPageSize"];
 var DEFAULT_CUSTOMERS = [
   {
     id: DEFAULT_CUSTOMER,
@@ -3267,19 +3274,44 @@ var GoogleAdsState = class {
     return this.vault.open(value, JSON.stringify([this.publicNamespace, kind, id]));
   }
   configure(value) {
-    if (Object.keys(value).some(
-      (k) => !["reportingLagMs", "pageTokenTtlMs", "futureToleranceMs"].includes(k)
-    ))
-      invalid("Unknown setting");
+    if (Object.keys(value).some((k) => !publicSettings.includes(k))) invalid("Unknown setting");
     const current = present(this.settings.get("settings"));
-    if (value.reportingLagMs !== void 0) integer(value.reportingLagMs, "reportingLagMs");
-    if (value.pageTokenTtlMs !== void 0) integer(value.pageTokenTtlMs, "pageTokenTtlMs", 1);
+    const whole = (v, field, min = 0, max) => {
+      if (typeof v !== "number") invalid(`Invalid ${field}`, field);
+      integer(v, field, min, max);
+    };
+    if (value.reportingLagMs !== void 0) whole(value.reportingLagMs, "reportingLagMs");
+    if (value.pageTokenTtlMs !== void 0) whole(value.pageTokenTtlMs, "pageTokenTtlMs", 1);
     if (value.futureToleranceMs !== void 0 && value.futureToleranceMs !== null)
-      integer(value.futureToleranceMs, "futureToleranceMs");
+      whole(value.futureToleranceMs, "futureToleranceMs");
+    if (value.searchPageSize !== void 0) whole(value.searchPageSize, "searchPageSize", 1, 1e4);
     const next = { ...current, ...value };
     this.settings.update("settings", next);
     return next;
   }
+  view() {
+    const { reportingLagMs, pageTokenTtlMs, futureToleranceMs, searchPageSize } = present(
+      this.settings.get("settings")
+    );
+    return { reportingLagMs, pageTokenTtlMs, futureToleranceMs, searchPageSize };
+  }
+  /** Carry an ambiguous-write fault over to the next executed mutation. */
+  deferAmbiguousWrite() {
+    const current = present(this.settings.get("settings"));
+    this.settings.update("settings", {
+      ...current,
+      pendingAmbiguousWrites: (current.pendingAmbiguousWrites ?? 0) + 1
+    });
+  }
+  takeAmbiguousWrite() {
+    const current = present(this.settings.get("settings"));
+    if (!current.pendingAmbiguousWrites) return false;
+    this.settings.update("settings", {
+      ...current,
+      pendingAmbiguousWrites: current.pendingAmbiguousWrites - 1
+    });
+    return true;
+  }
 };
 
 // src/gaql.ts
@@ -3355,7 +3387,7 @@ function parseGAQL(input) {
       queryError("BAD_VALUE", "Expected a literal value");
     return t.value;
   };
-  require2("SELECT");
+  if (!eat("SELECT")) queryError("EXPECTED_SELECT", "SELECT is missing at the beginning of query");
   const fields = [field()];
   while (eat(",")) fields.push(field());
   if (new Set(fields).size !== fields.length)
@@ -3715,6 +3747,7 @@ var AdsEngine = class {
       data = this.state.open(snapshot.sealed, "snapshot", snapshot.id);
     } else data = executeGAQL(this.state, customerId, query, this.now());
     if (validateOnly) return {};
+    const pageSize = present(this.state.settings.get("settings")).searchPageSize ?? PAGE_SIZE;
     if (stream) {
       if (body.summaryRowSetting !== void 0 && !["NO_SUMMARY_ROW", "SUMMARY_ROW_WITH_RESULTS", "SUMMARY_ROW_ONLY", "UNSPECIFIED"].includes(
         String(body.summaryRowSetting)
@@ -3736,11 +3769,11 @@ var AdsEngine = class {
     }
     const result = {
       fieldMask: data.fieldMask,
-      ...omit ? {} : { results: data.results.slice(offset, offset + PAGE_SIZE) },
+      ...omit ? {} : { results: data.results.slice(offset, offset + pageSize) },
       ...total ? { totalResultsCount: String(data.results.length) } : {},
       ...summary ? { summaryRow: data.summaryRow } : {}
     };
-    if (!omit && offset + PAGE_SIZE < data.results.length) {
+    if (!omit && offset + pageSize < data.results.length) {
       if (!snapshotId) {
         snapshotId = this.state.ids.next("snapshot_");
         this.state.snapshots.insert(snapshotId, {
@@ -3752,11 +3785,10 @@ var AdsEngine = class {
         });
       }
       const previous = this.state.pageTokens.list({
-        where: (p) => p.snapshotId === snapshotId && p.offset === offset + PAGE_SIZE
+        where: (p) => p.snapshotId === snapshotId && p.offset === offset + pageSize
       })[0]?.value;
       const id = previous?.id ?? this.state.ids.next("page_", 32);
-      if (!previous)
-        this.state.pageTokens.insert(id, { id, snapshotId, offset: offset + PAGE_SIZE });
+      if (!previous) this.state.pageTokens.insert(id, { id, snapshotId, offset: offset + pageSize });
       result.nextPageToken = id;
     }
     return result;
@@ -3810,6 +3842,14 @@ var AdsEngine = class {
               reject("CAMPAIGN_BUDGET_IN_USE", "Campaign budget is in use", "campaignBudgetError");
             after = { ...before, status: "REMOVED" };
           } else {
+            if (op.updateMask === void 0 || op.updateMask === "")
+              reject(
+                "FIELD_MASK_MISSING",
+                "The field mask must be provided for update operations",
+                "fieldMaskError",
+                400,
+                "updateMask"
+              );
             const mask = text(op.updateMask, "updateMask").split(",").map((s) => s.trim().replace(/_([a-z])/g, (_, c) => c.toUpperCase()));
             if (mask.some(
               (f) => ![
@@ -4422,7 +4462,7 @@ function compileFilter(input, permitted) {
 }
 
 // src/generated/openapi.ts
-var document = JSON.parse(`{"openapi":"3.1.0","info":{"title":"Google Ads v25 and GA4 local API subset","version":"0.1.0","x-mockingbird-upstream":{"note":"Bounded subset of official googleapis/googleapis proto SHA03a91044136a014466d4293eb1fe91f2b02075d2, Google Ads REST and GA4 Measurement Protocol/Data API documentation. Developer tokens are ignored under the September2026 policy."}},"servers":[{"url":"https://googleads.googleapis.com"}],"paths":{"/v25/customers/{customerId}/googleAds:search":{"post":{"operationId":"SearchGoogleAds","summary":"SearchGoogleAds","parameters":[{"name":"customerId","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]+$","example":"1000000001"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"400":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"401":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"403":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"404":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"429":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"500":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"503":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}}}}},"/v25/customers/{customerId}/googleAds:searchStream":{"post":{"operationId":"SearchStreamGoogleAds","summary":"SearchStreamGoogleAds","parameters":[{"name":"customerId","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]+$","example":"1000000001"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchStreamRequest"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StreamBatch"}}}}},"400":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"401":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"403":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"404":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"429":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"500":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"503":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}}}}},"/v25/customers/{customerId}/campaignBudgets:mutate":{"post":{"operationId":"MutateCampaignBudgets","summary":"MutateCampaignBudgets","parameters":[{"name":"customerId","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]+$","example":"1000000001"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetMutationRequest"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetMutationResponse"}}}},"400":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"401":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"403":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"404":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"429":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"500":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"503":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}}},"x-mockingbird":{"parity":{"safe":false}}}},"/v25/customers/{customerId}:uploadClickConversions":{"post":{"operationId":"UploadClickConversions","summary":"UploadClickConversions","parameters":[{"name":"customerId","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]+$","example":"1000000001"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversionRequest"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversionResponse"}}}},"400":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"401":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"403":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"404":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"429":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"500":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"503":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}}},"x-mockingbird":{"parity":{"safe":false}}}},"/mp/collect":{"post":{"operationId":"CollectAnalyticsEvents","summary":"CollectAnalyticsEvents","parameters":[{"name":"measurement_id","in":"query","required":true,"schema":{"type":"string","example":"G-FIXTURE"}},{"name":"api_secret","in":"query","required":false,"schema":{"type":"string","example":"fixture-ga4-secret"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectRequest"}}}},"responses":{"204":{"description":"Success"}},"x-mockingbird":{"parity":{"safe":false}}}},"/debug/mp/collect":{"post":{"operationId":"ValidateAnalyticsEvents","summary":"ValidateAnalyticsEvents","parameters":[{"name":"measurement_id","in":"query","required":true,"schema":{"type":"string","example":"G-FIXTURE"}},{"name":"api_secret","in":"query","required":false,"schema":{"type":"string","example":"fixture-ga4-secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectRequest"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationResponse"}}}},"400":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"401":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"403":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"404":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"429":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"500":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"503":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}}}}},"/v1beta/properties/{propertyId}:runReport":{"post":{"operationId":"RunAnalyticsReport","summary":"RunAnalyticsReport","parameters":[{"name":"propertyId","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]+$","example":"1000000001"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportRequest"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"400":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"401":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"403":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"404":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"429":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"500":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"503":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}}}}},"/v1beta/properties/{propertyId}:batchRunReports":{"post":{"operationId":"BatchRunAnalyticsReports","summary":"BatchRunAnalyticsReports","parameters":[{"name":"propertyId","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]+$","example":"1000000001"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchReportRequest"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchReportResponse"}}}},"400":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"401":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"403":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"404":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"429":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"500":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"503":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}}}}}},"components":{"schemas":{"AdsError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"status":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"errorCode":{"type":"object","properties":{},"additionalProperties":{"type":"string"}},"message":{"type":"string"},"location":{"type":"object","properties":{"fieldPathElements":{"type":"array","items":{"type":"object","properties":{"fieldName":{"type":"string"},"index":{"type":"integer","minimum":0}},"additionalProperties":false,"required":["fieldName"]}}},"additionalProperties":false}},"additionalProperties":false,"required":["errorCode","message"]}},"requestId":{"type":"string","x-mockingbird-volatile":{"kind":"id"}}},"additionalProperties":true}}},"additionalProperties":false,"required":["code","message","status"]}},"additionalProperties":false,"required":["error"]},"PartialFailure":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}},"additionalProperties":false,"required":["code","message","details"]},"Budget":{"type":"object","properties":{"resourceName":{"type":"string"},"id":{"type":"string","pattern":"^-?[0-9]+$"},"name":{"type":"string"},"amountMicros":{"type":"string","pattern":"^-?[0-9]+$"},"totalAmountMicros":{"type":"string","pattern":"^-?[0-9]+$"},"period":{"type":"string","enum":["DAILY","CUSTOM_PERIOD","UNSPECIFIED"]},"deliveryMethod":{"type":"string","enum":["STANDARD","UNSPECIFIED"]},"explicitlyShared":{"type":"boolean"},"status":{"type":"string"},"referenceCount":{"type":"string","pattern":"^-?[0-9]+$"}},"additionalProperties":true},"AdsRow":{"type":"object","properties":{"campaign":{"type":"object","properties":{"id":{"type":"string","pattern":"^-?[0-9]+$"},"resourceName":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"campaignBudget":{"type":"string"}},"additionalProperties":true},"campaignBudget":{"$ref":"#/components/schemas/Budget"},"conversionAction":{"type":"object","properties":{"id":{"type":"string","pattern":"^-?[0-9]+$"},"resourceName":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"customer":{"type":"object","properties":{"id":{"type":"string","pattern":"^-?[0-9]+$"},"resourceName":{"type":"string"},"descriptiveName":{"type":"string"},"currencyCode":{"type":"string"},"timeZone":{"type":"string"}},"additionalProperties":true},"metrics":{"type":"object","properties":{"costMicros":{"type":"string","pattern":"^-?[0-9]+$"},"clicks":{"type":"string","pattern":"^-?[0-9]+$"},"impressions":{"type":"string","pattern":"^-?[0-9]+$"},"conversions":{"type":"number"},"conversionsValue":{"type":"number"}},"additionalProperties":true},"segments":{"type":"object","properties":{"date":{"type":"string"},"conversionAction":{"type":"string"},"conversionActionCategory":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"SearchRequest":{"type":"object","properties":{"query":{"type":"string","minLength":1,"example":"SELECT campaign.id, campaign.name, metrics.cost_micros, metrics.clicks, metrics.impressions, metrics.conversions, metrics.conversions_value, segments.date FROM campaign ORDER BY campaign.id"},"pageToken":{"type":"string"},"pageSize":{"type":"integer","minimum":0},"validateOnly":{"type":"boolean"},"searchSettings":{"type":"object","properties":{"omitResults":{"type":"boolean"},"returnSummaryRow":{"type":"boolean"},"returnTotalResultsCount":{"type":"boolean"}},"additionalProperties":false}},"additionalProperties":false,"required":["query"]},"SearchResponse":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/AdsRow"}},"nextPageToken":{"type":"string","x-mockingbird-volatile":{"kind":"token"}},"fieldMask":{"type":"string"},"totalResultsCount":{"type":"string","pattern":"^-?[0-9]+$"},"summaryRow":{"$ref":"#/components/schemas/AdsRow"}},"additionalProperties":false},"SearchStreamRequest":{"type":"object","properties":{"query":{"type":"string","minLength":1},"summaryRowSetting":{"type":"string","enum":["NO_SUMMARY_ROW","SUMMARY_ROW_WITH_RESULTS","SUMMARY_ROW_ONLY","UNSPECIFIED"]}},"additionalProperties":false,"required":["query"]},"StreamBatch":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/AdsRow"}},"fieldMask":{"type":"string"},"requestId":{"type":"string","x-mockingbird-volatile":{"kind":"id"}},"summaryRow":{"$ref":"#/components/schemas/AdsRow"}},"additionalProperties":false},"BudgetOperation":{"type":"object","properties":{"create":{"$ref":"#/components/schemas/Budget"},"update":{"$ref":"#/components/schemas/Budget"},"remove":{"type":"string"},"updateMask":{"type":"string"}},"additionalProperties":false},"BudgetMutationRequest":{"type":"object","properties":{"operations":{"type":"array","items":{"$ref":"#/components/schemas/BudgetOperation"},"minItems":1},"partialFailure":{"type":"boolean"},"validateOnly":{"type":"boolean"},"responseContentType":{"type":"string","enum":["RESOURCE_NAME_ONLY","MUTABLE_RESOURCE","UNSPECIFIED"]}},"additionalProperties":false,"required":["operations"]},"BudgetMutationResponse":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"resourceName":{"type":"string","x-mockingbird-resource":{"type":"google_campaign_budget","identity":true}},"campaignBudget":{"$ref":"#/components/schemas/Budget"}},"additionalProperties":false}},"partialFailureError":{"$ref":"#/components/schemas/PartialFailure"}},"additionalProperties":false},"Conversion":{"type":"object","properties":{"gclid":{"type":"string"},"gbraid":{"type":"string"},"wbraid":{"type":"string"},"conversionAction":{"type":"string"},"conversionDateTime":{"type":"string"},"conversionValue":{"type":"number"},"currencyCode":{"type":"string"},"orderId":{"type":"string"},"consent":{"type":"object","properties":{},"additionalProperties":true},"customVariables":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"userIdentifiers":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}},"additionalProperties":true,"required":["conversionAction","conversionDateTime"]},"ConversionRequest":{"type":"object","properties":{"conversions":{"type":"array","items":{"$ref":"#/components/schemas/Conversion"},"minItems":1},"partialFailure":{"type":"boolean"},"validateOnly":{"type":"boolean"},"jobId":{"type":"integer","minimum":0,"maximum":2147483647}},"additionalProperties":false,"required":["conversions","partialFailure"]},"ConversionResponse":{"type":"object","properties":{"jobId":{"type":"string","pattern":"^-?[0-9]+$","x-mockingbird-volatile":{"kind":"id"}},"partialFailureError":{"$ref":"#/components/schemas/PartialFailure"},"results":{"type":"array","items":{"type":"object","properties":{"gclid":{"type":"string"},"gbraid":{"type":"string"},"wbraid":{"type":"string"},"conversionAction":{"type":"string"},"conversionDateTime":{"type":"string"},"userIdentifiers":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}},"additionalProperties":false}}},"additionalProperties":false,"required":["jobId"]},"Event":{"type":"object","properties":{"name":{"type":"string"},"params":{"type":"object","properties":{},"additionalProperties":true},"timestamp_micros":{"type":"integer"}},"additionalProperties":true,"required":["name"]},"CollectRequest":{"type":"object","properties":{"client_id":{"type":"string"},"user_id":{"type":"string"},"timestamp_micros":{"type":"integer"},"events":{"type":"array","items":{"$ref":"#/components/schemas/Event"}},"validation_behavior":{"type":"string","enum":["RELAXED","ENFORCE_RECOMMENDATIONS"]},"user_properties":{"type":"object","properties":{},"additionalProperties":true},"consent":{"type":"object","properties":{},"additionalProperties":true},"non_personalized_ads":{"type":"boolean"}},"additionalProperties":true},"ValidationResponse":{"type":"object","properties":{"validationMessages":{"type":"array","items":{"type":"object","properties":{"fieldPath":{"type":"string"},"description":{"type":"string"},"validationCode":{"type":"string","enum":["VALUE_INVALID","VALUE_REQUIRED","NAME_INVALID","NAME_RESERVED","VALUE_OUT_OF_BOUNDS","EXCEEDED_MAX_ENTITIES","NAME_DUPLICATED"]}},"additionalProperties":false,"required":["fieldPath","description","validationCode"]}}},"additionalProperties":false,"required":["validationMessages"]},"ReportRequest":{"type":"object","properties":{"property":{"type":"string"},"dimensions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"additionalProperties":false,"required":["name"]}},"metrics":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"additionalProperties":false,"required":["name"]},"minItems":1},"dateRanges":{"type":"array","items":{"type":"object","properties":{"startDate":{"type":"string"},"endDate":{"type":"string"},"name":{"type":"string"}},"additionalProperties":false,"required":["startDate","endDate"]}},"dimensionFilter":{"type":"object","properties":{},"additionalProperties":true},"metricFilter":{"type":"object","properties":{},"additionalProperties":true},"offset":{"type":"string","pattern":"^-?[0-9]+$"},"limit":{"type":"string","pattern":"^-?[0-9]+$"},"orderBys":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"currencyCode":{"type":"string"},"keepEmptyRows":{"type":"boolean"},"returnPropertyQuota":{"type":"boolean"},"metricAggregations":{"type":"array","items":{"type":"string"}},"comparisons":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"cohortSpec":{"type":"object","properties":{},"additionalProperties":true}},"additionalProperties":false,"required":["metrics"]},"ReportResponse":{"type":"object","properties":{"dimensionHeaders":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"additionalProperties":false,"required":["name"]}},"metricHeaders":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"}},"additionalProperties":false,"required":["name","type"]}},"rows":{"type":"array","items":{"type":"object","properties":{"dimensionValues":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"additionalProperties":false,"required":["value"]}},"metricValues":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"additionalProperties":false,"required":["value"]}}},"additionalProperties":false,"required":["dimensionValues","metricValues"]}},"rowCount":{"type":"integer","minimum":0},"metadata":{"type":"object","properties":{"currencyCode":{"type":"string"},"timeZone":{"type":"string"}},"additionalProperties":false,"required":["currencyCode","timeZone"]},"kind":{"type":"string"}},"additionalProperties":false,"required":["dimensionHeaders","metricHeaders","rows","rowCount","metadata","kind"]},"BatchReportRequest":{"type":"object","properties":{"requests":{"type":"array","items":{"$ref":"#/components/schemas/ReportRequest"},"minItems":1,"maxItems":5}},"additionalProperties":false,"required":["requests"]},"BatchReportResponse":{"type":"object","properties":{"reports":{"type":"array","items":{"$ref":"#/components/schemas/ReportResponse"}},"kind":{"type":"string"}},"additionalProperties":false,"required":["reports","kind"]}}}}`);
+var document = JSON.parse(`{"openapi":"3.1.0","info":{"title":"Google Ads v25 and GA4 local API subset","version":"0.1.0","x-mockingbird-upstream":{"note":"Bounded subset of official googleapis/googleapis proto SHA03a91044136a014466d4293eb1fe91f2b02075d2, Google Ads REST and GA4 Measurement Protocol/Data API documentation. Developer tokens are ignored under the September2026 policy."}},"servers":[{"url":"https://googleads.googleapis.com"}],"paths":{"/v25/customers/{customerId}/googleAds:search":{"post":{"operationId":"SearchGoogleAds","summary":"SearchGoogleAds","parameters":[{"name":"customerId","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]+$","example":"1000000001"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"400":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"401":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"403":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"404":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"429":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"500":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"503":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}}}}},"/v25/customers/{customerId}/googleAds:searchStream":{"post":{"operationId":"SearchStreamGoogleAds","summary":"SearchStreamGoogleAds","parameters":[{"name":"customerId","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]+$","example":"1000000001"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchStreamRequest"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StreamBatch"}}}}},"400":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"401":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"403":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"404":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"429":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"500":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"503":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}}}}},"/v25/customers/{customerId}/campaignBudgets:mutate":{"post":{"operationId":"MutateCampaignBudgets","summary":"MutateCampaignBudgets","parameters":[{"name":"customerId","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]+$","example":"1000000001"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetMutationRequest"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetMutationResponse"}}}},"400":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"401":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"403":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"404":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"429":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"500":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"503":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}}},"x-mockingbird":{"parity":{"safe":false}}}},"/v25/customers/{customerId}:uploadClickConversions":{"post":{"operationId":"UploadClickConversions","summary":"UploadClickConversions","parameters":[{"name":"customerId","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]+$","example":"1000000001"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversionRequest"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversionResponse"}}}},"400":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"401":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"403":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"404":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"429":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"500":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"503":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}}},"x-mockingbird":{"parity":{"safe":false}}}},"/mp/collect":{"post":{"operationId":"CollectAnalyticsEvents","summary":"CollectAnalyticsEvents","parameters":[{"name":"measurement_id","in":"query","required":true,"schema":{"type":"string","example":"G-FIXTURE"}},{"name":"api_secret","in":"query","required":false,"schema":{"type":"string","example":"fixture-ga4-secret"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectRequest"}}}},"responses":{"204":{"description":"Success"}},"x-mockingbird":{"parity":{"safe":false}}}},"/debug/mp/collect":{"post":{"operationId":"ValidateAnalyticsEvents","summary":"ValidateAnalyticsEvents","parameters":[{"name":"measurement_id","in":"query","required":true,"schema":{"type":"string","example":"G-FIXTURE"}},{"name":"api_secret","in":"query","required":false,"schema":{"type":"string","example":"fixture-ga4-secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectRequest"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationResponse"}}}},"400":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"401":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"403":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"404":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"429":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"500":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"503":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}}}}},"/v1beta/properties/{propertyId}:runReport":{"post":{"operationId":"RunAnalyticsReport","summary":"RunAnalyticsReport","parameters":[{"name":"propertyId","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]+$","example":"1000000001"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportRequest"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"400":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"401":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"403":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"404":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"429":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"500":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"503":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}}}}},"/v1beta/properties/{propertyId}:batchRunReports":{"post":{"operationId":"BatchRunAnalyticsReports","summary":"BatchRunAnalyticsReports","parameters":[{"name":"propertyId","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]+$","example":"1000000001"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchReportRequest"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchReportResponse"}}}},"400":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"401":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"403":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"404":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"429":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"500":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}},"503":{"description":"Google RPC error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsError"}}}}}}}},"components":{"schemas":{"AdsError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"status":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"errorCode":{"type":"object","properties":{},"additionalProperties":{"type":"string"}},"message":{"type":"string"},"location":{"type":"object","properties":{"fieldPathElements":{"type":"array","items":{"type":"object","properties":{"fieldName":{"type":"string"},"index":{"type":"integer","minimum":0}},"additionalProperties":false,"required":["fieldName"]}}},"additionalProperties":false},"details":{"type":"object","properties":{"quotaErrorDetails":{"type":"object","properties":{"rateScope":{"type":"string","enum":["ACCOUNT","DEVELOPER","UNSPECIFIED","UNKNOWN"]},"rateName":{"type":"string"},"retryDelay":{"type":"string","pattern":"^[0-9]+(\\\\.[0-9]+)?s$"}},"additionalProperties":false}},"additionalProperties":true}},"additionalProperties":false,"required":["errorCode","message"]}},"requestId":{"type":"string","x-mockingbird-volatile":{"kind":"id"}}},"additionalProperties":true}}},"additionalProperties":false,"required":["code","message","status"]}},"additionalProperties":false,"required":["error"]},"PartialFailure":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}},"additionalProperties":false,"required":["code","message","details"]},"Budget":{"type":"object","properties":{"resourceName":{"type":"string"},"id":{"type":"string","pattern":"^-?[0-9]+$"},"name":{"type":"string"},"amountMicros":{"type":"string","pattern":"^-?[0-9]+$"},"totalAmountMicros":{"type":"string","pattern":"^-?[0-9]+$"},"period":{"type":"string","enum":["DAILY","CUSTOM_PERIOD","UNSPECIFIED"]},"deliveryMethod":{"type":"string","enum":["STANDARD","UNSPECIFIED"]},"explicitlyShared":{"type":"boolean"},"status":{"type":"string"},"referenceCount":{"type":"string","pattern":"^-?[0-9]+$"}},"additionalProperties":true},"AdsRow":{"type":"object","properties":{"campaign":{"type":"object","properties":{"id":{"type":"string","pattern":"^-?[0-9]+$"},"resourceName":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"campaignBudget":{"type":"string"}},"additionalProperties":true},"campaignBudget":{"$ref":"#/components/schemas/Budget"},"conversionAction":{"type":"object","properties":{"id":{"type":"string","pattern":"^-?[0-9]+$"},"resourceName":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"customer":{"type":"object","properties":{"id":{"type":"string","pattern":"^-?[0-9]+$"},"resourceName":{"type":"string"},"descriptiveName":{"type":"string"},"currencyCode":{"type":"string"},"timeZone":{"type":"string"}},"additionalProperties":true},"metrics":{"type":"object","properties":{"costMicros":{"type":"string","pattern":"^-?[0-9]+$"},"clicks":{"type":"string","pattern":"^-?[0-9]+$"},"impressions":{"type":"string","pattern":"^-?[0-9]+$"},"conversions":{"type":"number"},"conversionsValue":{"type":"number"}},"additionalProperties":true},"segments":{"type":"object","properties":{"date":{"type":"string"},"conversionAction":{"type":"string"},"conversionActionCategory":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"SearchRequest":{"type":"object","properties":{"query":{"type":"string","minLength":1,"example":"SELECT campaign.id, campaign.name, metrics.cost_micros, metrics.clicks, metrics.impressions, metrics.conversions, metrics.conversions_value, segments.date FROM campaign ORDER BY campaign.id"},"pageToken":{"type":"string"},"pageSize":{"type":"integer","minimum":0},"validateOnly":{"type":"boolean"},"searchSettings":{"type":"object","properties":{"omitResults":{"type":"boolean"},"returnSummaryRow":{"type":"boolean"},"returnTotalResultsCount":{"type":"boolean"}},"additionalProperties":false}},"additionalProperties":false,"required":["query"]},"SearchResponse":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/AdsRow"}},"nextPageToken":{"type":"string","x-mockingbird-volatile":{"kind":"token"}},"fieldMask":{"type":"string"},"totalResultsCount":{"type":"string","pattern":"^-?[0-9]+$"},"summaryRow":{"$ref":"#/components/schemas/AdsRow"}},"additionalProperties":false},"SearchStreamRequest":{"type":"object","properties":{"query":{"type":"string","minLength":1},"summaryRowSetting":{"type":"string","enum":["NO_SUMMARY_ROW","SUMMARY_ROW_WITH_RESULTS","SUMMARY_ROW_ONLY","UNSPECIFIED"]}},"additionalProperties":false,"required":["query"]},"StreamBatch":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/AdsRow"}},"fieldMask":{"type":"string"},"requestId":{"type":"string","x-mockingbird-volatile":{"kind":"id"}},"summaryRow":{"$ref":"#/components/schemas/AdsRow"}},"additionalProperties":false},"BudgetOperation":{"type":"object","properties":{"create":{"$ref":"#/components/schemas/Budget"},"update":{"$ref":"#/components/schemas/Budget"},"remove":{"type":"string"},"updateMask":{"type":"string"}},"additionalProperties":false},"BudgetMutationRequest":{"type":"object","properties":{"operations":{"type":"array","items":{"$ref":"#/components/schemas/BudgetOperation"},"minItems":1},"partialFailure":{"type":"boolean"},"validateOnly":{"type":"boolean"},"responseContentType":{"type":"string","enum":["RESOURCE_NAME_ONLY","MUTABLE_RESOURCE","UNSPECIFIED"]}},"additionalProperties":false,"required":["operations"]},"BudgetMutationResponse":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"resourceName":{"type":"string","x-mockingbird-resource":{"type":"google_campaign_budget","identity":true}},"campaignBudget":{"$ref":"#/components/schemas/Budget"}},"additionalProperties":false}},"partialFailureError":{"$ref":"#/components/schemas/PartialFailure"}},"additionalProperties":false},"Conversion":{"type":"object","properties":{"gclid":{"type":"string"},"gbraid":{"type":"string"},"wbraid":{"type":"string"},"conversionAction":{"type":"string"},"conversionDateTime":{"type":"string"},"conversionValue":{"type":"number"},"currencyCode":{"type":"string"},"orderId":{"type":"string"},"consent":{"type":"object","properties":{},"additionalProperties":true},"customVariables":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"userIdentifiers":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}},"additionalProperties":true,"required":["conversionAction","conversionDateTime"]},"ConversionRequest":{"type":"object","properties":{"conversions":{"type":"array","items":{"$ref":"#/components/schemas/Conversion"},"minItems":1},"partialFailure":{"type":"boolean"},"validateOnly":{"type":"boolean"},"jobId":{"type":"integer","minimum":0,"maximum":2147483647}},"additionalProperties":false,"required":["conversions","partialFailure"]},"ConversionResponse":{"type":"object","properties":{"jobId":{"type":"string","pattern":"^-?[0-9]+$","x-mockingbird-volatile":{"kind":"id"}},"partialFailureError":{"$ref":"#/components/schemas/PartialFailure"},"results":{"type":"array","items":{"type":"object","properties":{"gclid":{"type":"string"},"gbraid":{"type":"string"},"wbraid":{"type":"string"},"conversionAction":{"type":"string"},"conversionDateTime":{"type":"string"},"userIdentifiers":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}},"additionalProperties":false}}},"additionalProperties":false,"required":["jobId"]},"Event":{"type":"object","properties":{"name":{"type":"string"},"params":{"type":"object","properties":{},"additionalProperties":true},"timestamp_micros":{"type":"integer"}},"additionalProperties":true,"required":["name"]},"CollectRequest":{"type":"object","properties":{"client_id":{"type":"string"},"user_id":{"type":"string"},"timestamp_micros":{"type":"integer"},"events":{"type":"array","items":{"$ref":"#/components/schemas/Event"}},"validation_behavior":{"type":"string","enum":["RELAXED","ENFORCE_RECOMMENDATIONS"]},"user_properties":{"type":"object","properties":{},"additionalProperties":true},"consent":{"type":"object","properties":{},"additionalProperties":true},"non_personalized_ads":{"type":"boolean"}},"additionalProperties":true},"ValidationResponse":{"type":"object","properties":{"validationMessages":{"type":"array","items":{"type":"object","properties":{"fieldPath":{"type":"string"},"description":{"type":"string"},"validationCode":{"type":"string","enum":["VALUE_INVALID","VALUE_REQUIRED","NAME_INVALID","NAME_RESERVED","VALUE_OUT_OF_BOUNDS","EXCEEDED_MAX_ENTITIES","NAME_DUPLICATED"]}},"additionalProperties":false,"required":["fieldPath","description","validationCode"]}}},"additionalProperties":false,"required":["validationMessages"]},"ReportRequest":{"type":"object","properties":{"property":{"type":"string"},"dimensions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"additionalProperties":false,"required":["name"]}},"metrics":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"additionalProperties":false,"required":["name"]},"minItems":1},"dateRanges":{"type":"array","items":{"type":"object","properties":{"startDate":{"type":"string"},"endDate":{"type":"string"},"name":{"type":"string"}},"additionalProperties":false,"required":["startDate","endDate"]}},"dimensionFilter":{"type":"object","properties":{},"additionalProperties":true},"metricFilter":{"type":"object","properties":{},"additionalProperties":true},"offset":{"type":"string","pattern":"^-?[0-9]+$"},"limit":{"type":"string","pattern":"^-?[0-9]+$"},"orderBys":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"currencyCode":{"type":"string"},"keepEmptyRows":{"type":"boolean"},"returnPropertyQuota":{"type":"boolean"},"metricAggregations":{"type":"array","items":{"type":"string"}},"comparisons":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"cohortSpec":{"type":"object","properties":{},"additionalProperties":true}},"additionalProperties":false,"required":["metrics"]},"ReportResponse":{"type":"object","properties":{"dimensionHeaders":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"additionalProperties":false,"required":["name"]}},"metricHeaders":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"}},"additionalProperties":false,"required":["name","type"]}},"rows":{"type":"array","items":{"type":"object","properties":{"dimensionValues":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"additionalProperties":false,"required":["value"]}},"metricValues":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"additionalProperties":false,"required":["value"]}}},"additionalProperties":false,"required":["dimensionValues","metricValues"]}},"rowCount":{"type":"integer","minimum":0},"metadata":{"type":"object","properties":{"currencyCode":{"type":"string"},"timeZone":{"type":"string"}},"additionalProperties":false,"required":["currencyCode","timeZone"]},"kind":{"type":"string"}},"additionalProperties":false,"required":["dimensionHeaders","metricHeaders","rows","rowCount","metadata","kind"]},"BatchReportRequest":{"type":"object","properties":{"requests":{"type":"array","items":{"$ref":"#/components/schemas/ReportRequest"},"minItems":1,"maxItems":5}},"additionalProperties":false,"required":["requests"]},"BatchReportResponse":{"type":"object","properties":{"reports":{"type":"array","items":{"$ref":"#/components/schemas/ReportResponse"}},"kind":{"type":"string"}},"additionalProperties":false,"required":["reports","kind"]}}}}`);
 var supportedOperationIds = ["SearchGoogleAds", "SearchStreamGoogleAds", "MutateCampaignBudgets", "UploadClickConversions", "CollectAnalyticsEvents", "ValidateAnalyticsEvents", "RunAnalyticsReport", "BatchRunAnalyticsReports"];
 
 // src/vault.ts
@@ -4457,24 +4497,36 @@ var Vault = class {
 };
 
 // src/runtime.ts
-var faultBody = (status, name, kind, code) => ({
+var faultBody = (status, name, kind, code, message, details) => ({
   error: {
     code: status,
-    message: name,
+    message,
     status: code,
-    details: [adsFailure([{ errorCode: { [kind]: name }, message: name }], "fixture-request")]
+    details: [
+      adsFailure(
+        [{ errorCode: { [kind]: name }, message, ...details ? { details } : {} }],
+        "fixture-request"
+      )
+    ]
   }
 });
+var quotaFault = (name, message) => ({
+  count: 1,
+  status: 429,
+  headers: { "request-id": "fixture-request" },
+  body: faultBody(429, name, "quotaError", "RESOURCE_EXHAUSTED", message, {
+    quotaErrorDetails: { rateScope: "ACCOUNT", rateName: "Requests per account", retryDelay: "1s" }
+  })
+});
 var GOOGLE_ADS_PRESETS = {
   quota_exhausted: {
     description: "Reject one request before mutation with Google RPC quota exhaustion",
+    rules: [quotaFault("RESOURCE_EXHAUSTED", "Too many requests.")]
+  },
+  rate_limited: {
+    description: "Reject one request before mutation with Google's short-term rate limit",
     rules: [
-      {
-        count: 1,
-        status: 429,
-        headers: { "retry-after": "1", "request-id": "fixture-request" },
-        body: faultBody(429, "RESOURCE_EXHAUSTED", "quotaError", "RESOURCE_EXHAUSTED")
-      }
+      quotaFault("RESOURCE_TEMPORARILY_EXHAUSTED", "Too many requests in a short amount of time.")
     ]
   },
   server_error: {
@@ -4483,7 +4535,8 @@ var GOOGLE_ADS_PRESETS = {
       {
         count: 1,
         status: 500,
-        body: faultBody(500, "INTERNAL_ERROR", "internalError", "INTERNAL")
+        headers: { "request-id": "fixture-request" },
+        body: faultBody(500, "INTERNAL_ERROR", "internalError", "INTERNAL", "INTERNAL_ERROR")
       }
     ]
   },
@@ -4496,7 +4549,7 @@ var GOOGLE_ADS_PRESETS = {
     rules: [{ count: 1, delayMs: 50 }]
   },
   ambiguous_budget_write: {
-    description: "Commit one budget mutation then return 503; inspect before replaying",
+    description: "Commit the next executed budget mutation then return 503; inspect before replaying",
     rules: [{ count: 1, operationId: "MutateCampaignBudgets", effect: "ambiguous_mutation" }]
   },
   partial_budget_failure: {
@@ -4532,15 +4585,11 @@ var routes = (runtime) => {
       () => Response.json({ inserted: runtime.instance(namespace).seedMetrics(body) }, { status: 201 })
     ),
     "POST /page-tokens/expire": ({ namespace }) => Response.json({ expired: runtime.instance(namespace).expirePageTokens() }),
-    "GET /settings": ({ namespace }) => {
-      const { reportingLagMs, pageTokenTtlMs, futureToleranceMs } = present(
-        runtime.instance(namespace).state.settings.get("settings")
-      );
-      return Response.json({ reportingLagMs, pageTokenTtlMs, futureToleranceMs });
-    },
+    "GET /settings": ({ namespace }) => Response.json(runtime.instance(namespace).state.view()),
     "PUT /settings": ({ namespace, body }) => guarded(() => {
-      const { reportingLagMs, pageTokenTtlMs, futureToleranceMs } = runtime.instance(namespace).configure(record(body));
-      return Response.json({ reportingLagMs, pageTokenTtlMs, futureToleranceMs });
+      const api = runtime.instance(namespace);
+      api.configure(record(body));
+      return Response.json(api.state.view());
     })
   };
 };
@@ -4575,6 +4624,7 @@ var createRuntime2 = (options = {}) => {
 var GOOGLE_ADS_NAMESPACE = "google-ads";
 var DEFAULT_ADMIN_KEY = "fixture-google-ads-admin";
 var isMP = (path) => path === "/mp/collect" || path === "/debug/mp/collect";
+var isAds = (path) => path.startsWith("/v25/");
 var GoogleAdsAPI = class {
   sqlite;
   state;
@@ -4628,7 +4678,9 @@ var GoogleAdsAPI = class {
       nextBudgetId: "9000000001",
       nextJobId: "2147483648",
       reportingLagMs: integer(options.reportingLagMs ?? 0, "reportingLagMs"),
-      pageTokenTtlMs: integer(options.pageTokenTtlMs ?? 36e5, "pageTokenTtlMs", 1),
+      pageTokenTtlMs: integer(options.pageTokenTtlMs ?? 72e5, "pageTokenTtlMs", 1),
+      searchPageSize: integer(options.searchPageSize ?? PAGE_SIZE, "searchPageSize", 1, PAGE_SIZE),
+      pendingAmbiguousWrites: 0,
       futureToleranceMs: options.futureToleranceMs === null ? null : integer(options.futureToleranceMs ?? 6e4, "futureToleranceMs")
     };
     this.state = new GoogleAdsState(
@@ -4643,9 +4695,11 @@ var GoogleAdsAPI = class {
     const wrap = (fn) => (c) => {
       try {
         if (c.request.signal.aborted) throw c.request.signal.reason;
+        if (c.body.kind === "invalid" && !isMP(c.url.pathname))
+          return rpcError(400, "Invalid JSON payload received.");
         return fn(c);
       } catch (e) {
-        if (e instanceof Rejection) return e.response(this.id(c.request));
+        if (e instanceof Rejection) return this.rejected(e, c.request);
         throw e;
       }
     };
@@ -4676,13 +4730,22 @@ var GoogleAdsAPI = class {
           )
         ),
         MutateCampaignBudgets: wrap((c) => {
-          const body = record(c.body.kind === "json" ? c.body.value : void 0), result = this.ads.mutate(
-            present(c.params.customerId),
-            body,
-            this.id(c.request),
-            !!faultEffect(c.request, "partial_failure")
-          );
-          if (!body.validateOnly && faultEffect(c.request, "ambiguous_mutation"))
+          const body = record(c.body.kind === "json" ? c.body.value : void 0), ambiguous = !!faultEffect(c.request, "ambiguous_mutation");
+          let result;
+          try {
+            result = this.ads.mutate(
+              present(c.params.customerId),
+              body,
+              this.id(c.request),
+              !!faultEffect(c.request, "partial_failure")
+            );
+          } catch (e) {
+            if (ambiguous) this.state.deferAmbiguousWrite();
+            throw e;
+          }
+          if (body.validateOnly === true) {
+            if (ambiguous) this.state.deferAmbiguousWrite();
+          } else if (ambiguous || this.state.takeAmbiguousWrite())
             return rpcError(
               503,
               "Response unavailable after the budget mutation; reconcile before retrying"
@@ -4739,8 +4802,8 @@ var GoogleAdsAPI = class {
         const url = new URL(request.url);
         if (isMP(url.pathname))
           return this.collect(request, url, void 0, true, url.pathname.startsWith("/debug/"));
-        if (e instanceof Rejection) return e.response(this.id(request));
-        return rpcError(400, "Invalid JSON request body");
+        if (e instanceof Rejection) return this.rejected(e, request);
+        return rpcError(400, "Invalid JSON payload received.");
       }
     });
     this.app = this.service.app;
@@ -4753,6 +4816,10 @@ var GoogleAdsAPI = class {
     }
     return id;
   }
+  /** Only Google Ads wraps a GoogleAdsFailure; the Analytics Data API answers a bare status. */
+  rejected(e, request) {
+    return isAds(new URL(request.url).pathname) ? e.response(this.id(request)) : e.plain();
+  }
   authenticate(request) {
     const path = new URL(request.url).pathname;
     if (isMP(path)) return;
@@ -4823,10 +4890,10 @@ var GoogleAdsAPI = class {
       this.authenticate(request);
       response = await this.service.fetch(request);
     } catch (e) {
-      if (e instanceof Rejection) response = e.response(id);
+      if (e instanceof Rejection) response = this.rejected(e, request);
       else throw e;
     }
-    if (url.pathname.startsWith("/v25/")) response.headers.set("request-id", id);
+    if (isAds(url.pathname)) response.headers.set("request-id", id);
     return response;
   }
   collect(request, url, input, malformed = false, debug = false) {
@@ -4955,4 +5022,4 @@ export {
   DEFAULT_ADMIN_KEY,
   GoogleAdsAPI
 };
-//# sourceMappingURL=chunk-DDJPMCRI.js.map
+//# sourceMappingURL=chunk-NU66LXUZ.js.map