npm - @gscdump/contracts - Versions diffs - 1.0.3 → 1.0.4 - Mend

@gscdump/contracts 1.0.3 → 1.0.4

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 (3) hide show

package/dist/v1/index.d.mts CHANGED Viewed

@@ -5723,6 +5723,997 @@ declare function createGscdumpV1Protocol(): {
           };
         };
       };
+      readonly getCanonicalMismatches: {
+        readonly id: "partner.sites.canonical.mismatches.get";
+        readonly method: "GET";
+        readonly path: "/sites/{siteId}/canonical-mismatches";
+        readonly visibility: "public";
+        readonly semantics: {
+          readonly kind: "query";
+          readonly sideEffects: "none";
+          readonly idempotent: true;
+          readonly retry: "idempotent";
+          readonly readConsistency: "primary";
+        };
+        readonly auth: {
+          readonly credentials: readonly ["user_key", "partner_key"];
+          readonly scopes: readonly ["indexing:read"];
+          readonly ownership: readonly [{
+            readonly credential: "user_key";
+            readonly rule: "authorized_site";
+          }, {
+            readonly credential: "partner_key";
+            readonly rule: "authorized_site";
+          }];
+        };
+        readonly request: {
+          readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+          }, z.core.$strict>;
+          readonly query: null;
+          readonly headers: z.ZodObject<{
+            'x-request-id': z.ZodOptional<z.ZodString>;
+          }, z.core.$strict>;
+          readonly body: null;
+        };
+        readonly responses: {
+          readonly 200: CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+              mismatches: z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                userCanonical: z.ZodString;
+                googleCanonical: z.ZodString;
+                verdict: z.ZodNullable<z.ZodString>;
+                coverageState: z.ZodNullable<z.ZodString>;
+                lastCrawlTime: z.ZodNullable<z.ZodString>;
+                lastCheckedAt: z.ZodNullable<z.ZodString>;
+              }, z.core.$loose>>;
+              totalCount: z.ZodNumber;
+              consolidationTargets: z.ZodArray<z.ZodObject<{
+                google_canonical: z.ZodString;
+                count: z.ZodNumber;
+              }, z.core.$loose>>;
+              trend: z.ZodArray<z.ZodObject<{
+                date: z.ZodString;
+                count: z.ZodNumber;
+              }, z.core.$loose>>;
+              meta: z.ZodObject<{
+                siteUrl: z.ZodString;
+                syncStatus: z.ZodNullable<z.ZodString>;
+              }, z.core.$loose>;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+              readonly requestId: z.ZodString;
+              readonly surface: z.ZodLiteral<"partner">;
+              readonly version: z.ZodLiteral<"1.0">;
+            }, z.core.$strip>;
+          }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodObject<{
+              mismatches: z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                userCanonical: z.ZodString;
+                googleCanonical: z.ZodString;
+                verdict: z.ZodNullable<z.ZodString>;
+                coverageState: z.ZodNullable<z.ZodString>;
+                lastCrawlTime: z.ZodNullable<z.ZodString>;
+                lastCheckedAt: z.ZodNullable<z.ZodString>;
+              }, z.core.$loose>>;
+              totalCount: z.ZodNumber;
+              consolidationTargets: z.ZodArray<z.ZodObject<{
+                google_canonical: z.ZodString;
+                count: z.ZodNumber;
+              }, z.core.$loose>>;
+              trend: z.ZodArray<z.ZodObject<{
+                date: z.ZodString;
+                count: z.ZodNumber;
+              }, z.core.$loose>>;
+              meta: z.ZodObject<{
+                siteUrl: z.ZodString;
+                syncStatus: z.ZodNullable<z.ZodString>;
+              }, z.core.$loose>;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+              readonly requestId: z.ZodString;
+              readonly surface: z.ZodLiteral<"partner">;
+              readonly version: z.ZodLiteral<"1.0">;
+            }, z.core.$strip>;
+          }, z.core.$strip>>;
+        };
+        readonly errors: readonly ["invalid_request", "unauthorized", "forbidden", "site_not_found", "rate_limited", "internal_error", "contract_violation"];
+        readonly errorResponse: CompatibleResponseSchema<z.ZodObject<{
+          readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+              internal_error: "internal_error";
+              invalid_request: "invalid_request";
+              unauthorized: "unauthorized";
+              forbidden: "forbidden";
+              site_not_found: "site_not_found";
+              rate_limited: "rate_limited";
+              contract_violation: "contract_violation";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+          }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+          readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+              internal_error: "internal_error";
+              invalid_request: "invalid_request";
+              unauthorized: "unauthorized";
+              forbidden: "forbidden";
+              site_not_found: "site_not_found";
+              rate_limited: "rate_limited";
+              contract_violation: "contract_violation";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+          }, z.core.$loose>;
+        }, z.core.$strip>>;
+        readonly resources: {
+          readonly reads: readonly [{
+            readonly type: "site.indexing";
+            readonly idFrom: "params.siteId";
+          }];
+          readonly changes: readonly [];
+        };
+        readonly lifecycle: {
+          readonly introduced: "1.1.0";
+        };
+        readonly docs: {
+          readonly summary: "List canonical mismatches";
+          readonly description: "Returns sitemap-scoped URLs whose Google-chosen canonical diverges from the declared canonical, with consolidation targets and trend.";
+          readonly tags: readonly ["Indexing"];
+          readonly examples: {
+            readonly request: {
+              readonly params: {
+                readonly siteId: "s_01";
+              };
+            };
+            readonly response: {
+              readonly data: {
+                readonly mismatches: readonly [];
+                readonly totalCount: 0;
+                readonly consolidationTargets: readonly [];
+                readonly trend: readonly [];
+                readonly meta: {
+                  readonly siteUrl: "sc-domain:example.com";
+                  readonly syncStatus: "synced";
+                };
+              };
+              readonly meta: {
+                readonly requestId: "req_01";
+                readonly surface: "partner";
+                readonly version: "1.0";
+              };
+            };
+          };
+        };
+      };
+      readonly inspectSiteUrls: {
+        readonly id: "partner.sites.indexing.inspect.create";
+        readonly method: "POST";
+        readonly path: "/sites/{siteId}/indexing/inspect";
+        readonly visibility: "public";
+        readonly semantics: {
+          readonly kind: "mutation";
+          readonly sideEffects: "state";
+          readonly idempotent: false;
+          readonly retry: "never";
+          readonly readConsistency: null;
+        };
+        readonly auth: {
+          readonly credentials: readonly ["user_key", "partner_key"];
+          readonly scopes: readonly ["indexing:write"];
+          readonly ownership: readonly [{
+            readonly credential: "user_key";
+            readonly rule: "authorized_site";
+          }, {
+            readonly credential: "partner_key";
+            readonly rule: "authorized_site";
+          }];
+        };
+        readonly request: {
+          readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+          }, z.core.$strict>;
+          readonly query: null;
+          readonly headers: z.ZodObject<{
+            'x-request-id': z.ZodOptional<z.ZodString>;
+          }, z.core.$strict>;
+          readonly body: z.ZodObject<{
+            urls: z.ZodArray<z.ZodString>;
+          }, z.core.$strict>;
+        };
+        readonly responses: {
+          readonly 200: CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+              readonly siteId: z.ZodString;
+              readonly rateLimit: z.ZodObject<{
+                reserved: z.ZodNumber;
+                remaining: z.ZodNumber;
+                limit: z.ZodNumber;
+              }, z.core.$strict>;
+              readonly results: z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                verdict: z.ZodNullable<z.ZodString>;
+                coverageState: z.ZodNullable<z.ZodString>;
+                indexingState: z.ZodNullable<z.ZodString>;
+                robotsTxtState: z.ZodNullable<z.ZodString>;
+                pageFetchState: z.ZodNullable<z.ZodString>;
+                lastCrawlTime: z.ZodNullable<z.ZodString>;
+                crawlingUserAgent: z.ZodNullable<z.ZodString>;
+                userCanonical: z.ZodNullable<z.ZodString>;
+                googleCanonical: z.ZodNullable<z.ZodString>;
+                sitemaps: z.ZodNullable<z.ZodString>;
+                referringUrls: z.ZodNullable<z.ZodString>;
+                mobileVerdict: z.ZodNullable<z.ZodString>;
+                mobileIssues: z.ZodNullable<z.ZodString>;
+                richResultsVerdict: z.ZodNullable<z.ZodString>;
+                richResultsItems: z.ZodNullable<z.ZodString>;
+                ampVerdict: z.ZodNullable<z.ZodString>;
+                ampUrl: z.ZodNullable<z.ZodString>;
+                ampIndexingState: z.ZodNullable<z.ZodString>;
+                ampIndexStatusVerdict: z.ZodNullable<z.ZodString>;
+                ampRobotsTxtState: z.ZodNullable<z.ZodString>;
+                ampPageFetchState: z.ZodNullable<z.ZodString>;
+                ampLastCrawlTime: z.ZodNullable<z.ZodString>;
+                ampIssues: z.ZodNullable<z.ZodString>;
+                inspectionResultLink: z.ZodNullable<z.ZodString>;
+              }, z.core.$strip>>;
+              readonly errors: z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                error: z.ZodString;
+              }, z.core.$strict>>;
+              readonly skipped: z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                reason: z.ZodEnum<{
+                  rate_limited: "rate_limited";
+                  domain_mismatch: "domain_mismatch";
+                }>;
+              }, z.core.$strict>>;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+              readonly requestId: z.ZodString;
+              readonly surface: z.ZodLiteral<"partner">;
+              readonly version: z.ZodLiteral<"1.0">;
+            }, z.core.$strip>;
+          }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodObject<{
+              readonly siteId: z.ZodString;
+              readonly rateLimit: z.ZodObject<{
+                reserved: z.ZodNumber;
+                remaining: z.ZodNumber;
+                limit: z.ZodNumber;
+              }, z.core.$strict>;
+              readonly results: z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                verdict: z.ZodNullable<z.ZodString>;
+                coverageState: z.ZodNullable<z.ZodString>;
+                indexingState: z.ZodNullable<z.ZodString>;
+                robotsTxtState: z.ZodNullable<z.ZodString>;
+                pageFetchState: z.ZodNullable<z.ZodString>;
+                lastCrawlTime: z.ZodNullable<z.ZodString>;
+                crawlingUserAgent: z.ZodNullable<z.ZodString>;
+                userCanonical: z.ZodNullable<z.ZodString>;
+                googleCanonical: z.ZodNullable<z.ZodString>;
+                sitemaps: z.ZodNullable<z.ZodString>;
+                referringUrls: z.ZodNullable<z.ZodString>;
+                mobileVerdict: z.ZodNullable<z.ZodString>;
+                mobileIssues: z.ZodNullable<z.ZodString>;
+                richResultsVerdict: z.ZodNullable<z.ZodString>;
+                richResultsItems: z.ZodNullable<z.ZodString>;
+                ampVerdict: z.ZodNullable<z.ZodString>;
+                ampUrl: z.ZodNullable<z.ZodString>;
+                ampIndexingState: z.ZodNullable<z.ZodString>;
+                ampIndexStatusVerdict: z.ZodNullable<z.ZodString>;
+                ampRobotsTxtState: z.ZodNullable<z.ZodString>;
+                ampPageFetchState: z.ZodNullable<z.ZodString>;
+                ampLastCrawlTime: z.ZodNullable<z.ZodString>;
+                ampIssues: z.ZodNullable<z.ZodString>;
+                inspectionResultLink: z.ZodNullable<z.ZodString>;
+              }, z.core.$strip>>;
+              readonly errors: z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                error: z.ZodString;
+              }, z.core.$strict>>;
+              readonly skipped: z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                reason: z.ZodEnum<{
+                  rate_limited: "rate_limited";
+                  domain_mismatch: "domain_mismatch";
+                }>;
+              }, z.core.$strict>>;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+              readonly requestId: z.ZodString;
+              readonly surface: z.ZodLiteral<"partner">;
+              readonly version: z.ZodLiteral<"1.0">;
+            }, z.core.$strip>;
+          }, z.core.$strip>>;
+        };
+        readonly errors: readonly ["invalid_request", "unauthorized", "forbidden", "site_not_found", "rate_limited", "internal_error", "contract_violation"];
+        readonly errorResponse: CompatibleResponseSchema<z.ZodObject<{
+          readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+              internal_error: "internal_error";
+              invalid_request: "invalid_request";
+              unauthorized: "unauthorized";
+              forbidden: "forbidden";
+              site_not_found: "site_not_found";
+              rate_limited: "rate_limited";
+              contract_violation: "contract_violation";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+          }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+          readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+              internal_error: "internal_error";
+              invalid_request: "invalid_request";
+              unauthorized: "unauthorized";
+              forbidden: "forbidden";
+              site_not_found: "site_not_found";
+              rate_limited: "rate_limited";
+              contract_violation: "contract_violation";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+          }, z.core.$loose>;
+        }, z.core.$strip>>;
+        readonly resources: {
+          readonly reads: readonly [{
+            readonly type: "site.indexing";
+            readonly idFrom: "params.siteId";
+          }];
+          readonly changes: readonly [{
+            readonly type: "site.indexing";
+            readonly idFrom: "params.siteId";
+          }];
+        };
+        readonly lifecycle: {
+          readonly introduced: "1.1.0";
+        };
+        readonly docs: {
+          readonly summary: "Inspect URLs on demand";
+          readonly description: "Runs live URL inspections against the daily per-site quota; URLs outside the site domain and over-quota URLs are reported as skipped. Exhausted quota fails with rate_limited.";
+          readonly tags: readonly ["Indexing"];
+          readonly examples: {
+            readonly request: {
+              readonly params: {
+                readonly siteId: "s_01";
+              };
+              readonly body: {
+                readonly urls: readonly ["https://example.com/"];
+              };
+            };
+            readonly response: {
+              readonly data: {
+                readonly siteId: "s_01";
+                readonly rateLimit: {
+                  readonly reserved: 1;
+                  readonly remaining: 199;
+                  readonly limit: 200;
+                };
+                readonly results: readonly [];
+                readonly errors: readonly [];
+                readonly skipped: readonly [];
+              };
+              readonly meta: {
+                readonly requestId: "req_01";
+                readonly surface: "partner";
+                readonly version: "1.0";
+              };
+            };
+          };
+        };
+      };
+      readonly recoverSitePermission: {
+        readonly id: "partner.sites.permission.recover";
+        readonly method: "POST";
+        readonly path: "/sites/{siteId}/permission/recover";
+        readonly visibility: "public";
+        readonly semantics: {
+          readonly kind: "mutation";
+          readonly sideEffects: "state";
+          readonly idempotent: true;
+          readonly retry: "idempotent";
+          readonly readConsistency: null;
+        };
+        readonly auth: {
+          readonly credentials: readonly ["user_key", "partner_key"];
+          readonly scopes: readonly ["sites:write"];
+          readonly ownership: readonly [{
+            readonly credential: "user_key";
+            readonly rule: "authorized_site";
+          }, {
+            readonly credential: "partner_key";
+            readonly rule: "authorized_site";
+          }];
+        };
+        readonly request: {
+          readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+          }, z.core.$strict>;
+          readonly query: null;
+          readonly headers: z.ZodObject<{
+            'x-request-id': z.ZodOptional<z.ZodString>;
+          }, z.core.$strict>;
+          readonly body: null;
+        };
+        readonly responses: {
+          readonly 200: CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+              readonly success: z.ZodBoolean;
+              readonly permissionLevel: z.ZodNullable<z.ZodString>;
+              readonly jobsQueued: z.ZodNumber;
+              readonly message: z.ZodString;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+              readonly requestId: z.ZodString;
+              readonly surface: z.ZodLiteral<"partner">;
+              readonly version: z.ZodLiteral<"1.0">;
+            }, z.core.$strip>;
+          }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodObject<{
+              readonly success: z.ZodBoolean;
+              readonly permissionLevel: z.ZodNullable<z.ZodString>;
+              readonly jobsQueued: z.ZodNumber;
+              readonly message: z.ZodString;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+              readonly requestId: z.ZodString;
+              readonly surface: z.ZodLiteral<"partner">;
+              readonly version: z.ZodLiteral<"1.0">;
+            }, z.core.$strip>;
+          }, z.core.$strip>>;
+        };
+        readonly errors: readonly ["invalid_request", "unauthorized", "forbidden", "site_not_found", "rate_limited", "internal_error", "contract_violation"];
+        readonly errorResponse: CompatibleResponseSchema<z.ZodObject<{
+          readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+              internal_error: "internal_error";
+              invalid_request: "invalid_request";
+              unauthorized: "unauthorized";
+              forbidden: "forbidden";
+              site_not_found: "site_not_found";
+              rate_limited: "rate_limited";
+              contract_violation: "contract_violation";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+          }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+          readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+              internal_error: "internal_error";
+              invalid_request: "invalid_request";
+              unauthorized: "unauthorized";
+              forbidden: "forbidden";
+              site_not_found: "site_not_found";
+              rate_limited: "rate_limited";
+              contract_violation: "contract_violation";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+          }, z.core.$loose>;
+        }, z.core.$strip>>;
+        readonly resources: {
+          readonly reads: readonly [{
+            readonly type: "site.auth";
+            readonly idFrom: "params.siteId";
+          }];
+          readonly changes: readonly [{
+            readonly type: "site.auth";
+            readonly idFrom: "params.siteId";
+          }, {
+            readonly type: "site.lifecycle";
+            readonly idFrom: "params.siteId";
+          }];
+        };
+        readonly lifecycle: {
+          readonly introduced: "1.1.0";
+        };
+        readonly docs: {
+          readonly summary: "Re-check and recover site permission";
+          readonly description: "Force-rechecks Google Search Console access for a permission-lost site; on recovery resets sync state and queues fresh sync jobs.";
+          readonly tags: readonly ["Sites"];
+          readonly examples: {
+            readonly request: {
+              readonly params: {
+                readonly siteId: "s_01";
+              };
+            };
+            readonly response: {
+              readonly data: {
+                readonly success: true;
+                readonly permissionLevel: "siteFullUser";
+                readonly jobsQueued: 3;
+                readonly message: "Permission restored (siteFullUser). Queued 3 sync jobs.";
+              };
+              readonly meta: {
+                readonly requestId: "req_01";
+                readonly surface: "partner";
+                readonly version: "1.0";
+              };
+            };
+          };
+        };
+      };
+      readonly queryKeywordSparklines: {
+        readonly id: "partner.sites.keyword.sparklines.query";
+        readonly method: "POST";
+        readonly path: "/sites/{siteId}/keyword-sparklines";
+        readonly visibility: "public";
+        readonly semantics: {
+          readonly kind: "query";
+          readonly sideEffects: "none";
+          readonly idempotent: true;
+          readonly retry: "idempotent";
+          readonly readConsistency: "primary";
+        };
+        readonly auth: {
+          readonly credentials: readonly ["user_key", "partner_key"];
+          readonly scopes: readonly ["analytics:read"];
+          readonly ownership: readonly [{
+            readonly credential: "user_key";
+            readonly rule: "authorized_site";
+          }, {
+            readonly credential: "partner_key";
+            readonly rule: "authorized_site";
+          }];
+        };
+        readonly request: {
+          readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+          }, z.core.$strict>;
+          readonly query: null;
+          readonly headers: z.ZodObject<{
+            'x-request-id': z.ZodOptional<z.ZodString>;
+          }, z.core.$strict>;
+          readonly body: z.ZodObject<{
+            keywords: z.ZodArray<z.ZodString>;
+            startDate: z.ZodString;
+            endDate: z.ZodString;
+            searchType: z.ZodOptional<z.ZodEnum<{
+              web: "web";
+              image: "image";
+              video: "video";
+              news: "news";
+              discover: "discover";
+              googleNews: "googleNews";
+            }>>;
+          }, z.core.$strict>;
+        };
+        readonly responses: {
+          readonly 200: CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+              sparklines: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodNumber>>;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+              readonly requestId: z.ZodString;
+              readonly surface: z.ZodLiteral<"partner">;
+              readonly version: z.ZodLiteral<"1.0">;
+            }, z.core.$strip>;
+          }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodObject<{
+              sparklines: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodNumber>>;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+              readonly requestId: z.ZodString;
+              readonly surface: z.ZodLiteral<"partner">;
+              readonly version: z.ZodLiteral<"1.0">;
+            }, z.core.$strip>;
+          }, z.core.$strip>>;
+        };
+        readonly errors: readonly ["invalid_request", "unauthorized", "forbidden", "site_not_found", "rate_limited", "internal_error", "contract_violation"];
+        readonly errorResponse: CompatibleResponseSchema<z.ZodObject<{
+          readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+              internal_error: "internal_error";
+              invalid_request: "invalid_request";
+              unauthorized: "unauthorized";
+              forbidden: "forbidden";
+              site_not_found: "site_not_found";
+              rate_limited: "rate_limited";
+              contract_violation: "contract_violation";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+          }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+          readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+              internal_error: "internal_error";
+              invalid_request: "invalid_request";
+              unauthorized: "unauthorized";
+              forbidden: "forbidden";
+              site_not_found: "site_not_found";
+              rate_limited: "rate_limited";
+              contract_violation: "contract_violation";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+          }, z.core.$loose>;
+        }, z.core.$strip>>;
+        readonly resources: {
+          readonly reads: readonly [{
+            readonly type: "site.analytics";
+            readonly idFrom: "params.siteId";
+          }];
+          readonly changes: readonly [];
+        };
+        readonly lifecycle: {
+          readonly introduced: "1.1.0";
+        };
+        readonly docs: {
+          readonly summary: "Query keyword sparklines";
+          readonly description: "Returns per-keyword daily click series for up to 20 keywords over the requested window.";
+          readonly tags: readonly ["Analytics"];
+          readonly examples: {
+            readonly request: {
+              readonly params: {
+                readonly siteId: "s_01";
+              };
+              readonly body: {
+                readonly keywords: readonly ["nuxt seo"];
+                readonly startDate: "2026-06-01";
+                readonly endDate: "2026-06-28";
+              };
+            };
+            readonly response: {
+              readonly data: {
+                readonly sparklines: {
+                  readonly 'nuxt seo': readonly [0, 1, 2];
+                };
+              };
+              readonly meta: {
+                readonly requestId: "req_01";
+                readonly surface: "partner";
+                readonly version: "1.0";
+              };
+            };
+          };
+        };
+      };
+      readonly getQueryTrend: {
+        readonly id: "partner.sites.query.trend.get";
+        readonly method: "GET";
+        readonly path: "/sites/{siteId}/query-trend";
+        readonly visibility: "public";
+        readonly semantics: {
+          readonly kind: "query";
+          readonly sideEffects: "none";
+          readonly idempotent: true;
+          readonly retry: "idempotent";
+          readonly readConsistency: "primary";
+        };
+        readonly auth: {
+          readonly credentials: readonly ["user_key", "partner_key"];
+          readonly scopes: readonly ["analytics:read"];
+          readonly ownership: readonly [{
+            readonly credential: "user_key";
+            readonly rule: "authorized_site";
+          }, {
+            readonly credential: "partner_key";
+            readonly rule: "authorized_site";
+          }];
+        };
+        readonly request: {
+          readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+          }, z.core.$strict>;
+          readonly query: z.ZodObject<{
+            startDate: z.ZodString;
+            endDate: z.ZodString;
+            searchType: z.ZodOptional<z.ZodEnum<{
+              web: "web";
+              image: "image";
+              video: "video";
+              news: "news";
+              discover: "discover";
+              googleNews: "googleNews";
+            }>>;
+            prevStartDate: z.ZodOptional<z.ZodString>;
+            prevEndDate: z.ZodOptional<z.ZodString>;
+          }, z.core.$strict>;
+          readonly headers: z.ZodObject<{
+            'x-request-id': z.ZodOptional<z.ZodString>;
+          }, z.core.$strict>;
+          readonly body: null;
+        };
+        readonly responses: {
+          readonly 200: CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+              daily: z.ZodArray<z.ZodObject<{
+                date: z.ZodString;
+                queryCount: z.ZodNumber;
+              }, z.core.$loose>>;
+              total: z.ZodNumber;
+              previousTotal: z.ZodOptional<z.ZodNumber>;
+              meta: z.ZodObject<{
+                siteUrl: z.ZodString;
+                syncStatus: z.ZodNullable<z.ZodString>;
+              }, z.core.$loose>;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+              readonly requestId: z.ZodString;
+              readonly surface: z.ZodLiteral<"partner">;
+              readonly version: z.ZodLiteral<"1.0">;
+            }, z.core.$strip>;
+          }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodObject<{
+              daily: z.ZodArray<z.ZodObject<{
+                date: z.ZodString;
+                queryCount: z.ZodNumber;
+              }, z.core.$loose>>;
+              total: z.ZodNumber;
+              previousTotal: z.ZodOptional<z.ZodNumber>;
+              meta: z.ZodObject<{
+                siteUrl: z.ZodString;
+                syncStatus: z.ZodNullable<z.ZodString>;
+              }, z.core.$loose>;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+              readonly requestId: z.ZodString;
+              readonly surface: z.ZodLiteral<"partner">;
+              readonly version: z.ZodLiteral<"1.0">;
+            }, z.core.$strip>;
+          }, z.core.$strip>>;
+        };
+        readonly errors: readonly ["invalid_request", "unauthorized", "forbidden", "site_not_found", "rate_limited", "internal_error", "contract_violation"];
+        readonly errorResponse: CompatibleResponseSchema<z.ZodObject<{
+          readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+              internal_error: "internal_error";
+              invalid_request: "invalid_request";
+              unauthorized: "unauthorized";
+              forbidden: "forbidden";
+              site_not_found: "site_not_found";
+              rate_limited: "rate_limited";
+              contract_violation: "contract_violation";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+          }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+          readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+              internal_error: "internal_error";
+              invalid_request: "invalid_request";
+              unauthorized: "unauthorized";
+              forbidden: "forbidden";
+              site_not_found: "site_not_found";
+              rate_limited: "rate_limited";
+              contract_violation: "contract_violation";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+          }, z.core.$loose>;
+        }, z.core.$strip>>;
+        readonly resources: {
+          readonly reads: readonly [{
+            readonly type: "site.analytics";
+            readonly idFrom: "params.siteId";
+          }];
+          readonly changes: readonly [];
+        };
+        readonly lifecycle: {
+          readonly introduced: "1.1.0";
+        };
+        readonly docs: {
+          readonly summary: "Get unique-query trend";
+          readonly description: "Returns the daily unique-query count series for a window, with an optional previous-period total for comparison.";
+          readonly tags: readonly ["Analytics"];
+          readonly examples: {
+            readonly request: {
+              readonly params: {
+                readonly siteId: "s_01";
+              };
+              readonly query: {
+                readonly startDate: "2026-06-01";
+                readonly endDate: "2026-06-28";
+              };
+            };
+            readonly response: {
+              readonly data: {
+                readonly daily: readonly [];
+                readonly total: 0;
+                readonly meta: {
+                  readonly siteUrl: "sc-domain:example.com";
+                  readonly syncStatus: "synced";
+                };
+              };
+              readonly meta: {
+                readonly requestId: "req_01";
+                readonly surface: "partner";
+                readonly version: "1.0";
+              };
+            };
+          };
+        };
+      };
+      readonly getPageTrend: {
+        readonly id: "partner.sites.page.trend.get";
+        readonly method: "GET";
+        readonly path: "/sites/{siteId}/page-trend";
+        readonly visibility: "public";
+        readonly semantics: {
+          readonly kind: "query";
+          readonly sideEffects: "none";
+          readonly idempotent: true;
+          readonly retry: "idempotent";
+          readonly readConsistency: "primary";
+        };
+        readonly auth: {
+          readonly credentials: readonly ["user_key", "partner_key"];
+          readonly scopes: readonly ["analytics:read"];
+          readonly ownership: readonly [{
+            readonly credential: "user_key";
+            readonly rule: "authorized_site";
+          }, {
+            readonly credential: "partner_key";
+            readonly rule: "authorized_site";
+          }];
+        };
+        readonly request: {
+          readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+          }, z.core.$strict>;
+          readonly query: z.ZodObject<{
+            startDate: z.ZodString;
+            endDate: z.ZodString;
+            searchType: z.ZodOptional<z.ZodEnum<{
+              web: "web";
+              image: "image";
+              video: "video";
+              news: "news";
+              discover: "discover";
+              googleNews: "googleNews";
+            }>>;
+            prevStartDate: z.ZodOptional<z.ZodString>;
+            prevEndDate: z.ZodOptional<z.ZodString>;
+          }, z.core.$strict>;
+          readonly headers: z.ZodObject<{
+            'x-request-id': z.ZodOptional<z.ZodString>;
+          }, z.core.$strict>;
+          readonly body: null;
+        };
+        readonly responses: {
+          readonly 200: CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+              daily: z.ZodArray<z.ZodObject<{
+                date: z.ZodString;
+                pageCount: z.ZodNumber;
+              }, z.core.$loose>>;
+              total: z.ZodNumber;
+              previousTotal: z.ZodOptional<z.ZodNumber>;
+              meta: z.ZodObject<{
+                siteUrl: z.ZodString;
+                syncStatus: z.ZodNullable<z.ZodString>;
+              }, z.core.$loose>;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+              readonly requestId: z.ZodString;
+              readonly surface: z.ZodLiteral<"partner">;
+              readonly version: z.ZodLiteral<"1.0">;
+            }, z.core.$strip>;
+          }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodObject<{
+              daily: z.ZodArray<z.ZodObject<{
+                date: z.ZodString;
+                pageCount: z.ZodNumber;
+              }, z.core.$loose>>;
+              total: z.ZodNumber;
+              previousTotal: z.ZodOptional<z.ZodNumber>;
+              meta: z.ZodObject<{
+                siteUrl: z.ZodString;
+                syncStatus: z.ZodNullable<z.ZodString>;
+              }, z.core.$loose>;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+              readonly requestId: z.ZodString;
+              readonly surface: z.ZodLiteral<"partner">;
+              readonly version: z.ZodLiteral<"1.0">;
+            }, z.core.$strip>;
+          }, z.core.$strip>>;
+        };
+        readonly errors: readonly ["invalid_request", "unauthorized", "forbidden", "site_not_found", "rate_limited", "internal_error", "contract_violation"];
+        readonly errorResponse: CompatibleResponseSchema<z.ZodObject<{
+          readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+              internal_error: "internal_error";
+              invalid_request: "invalid_request";
+              unauthorized: "unauthorized";
+              forbidden: "forbidden";
+              site_not_found: "site_not_found";
+              rate_limited: "rate_limited";
+              contract_violation: "contract_violation";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+          }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+          readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+              internal_error: "internal_error";
+              invalid_request: "invalid_request";
+              unauthorized: "unauthorized";
+              forbidden: "forbidden";
+              site_not_found: "site_not_found";
+              rate_limited: "rate_limited";
+              contract_violation: "contract_violation";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+          }, z.core.$loose>;
+        }, z.core.$strip>>;
+        readonly resources: {
+          readonly reads: readonly [{
+            readonly type: "site.analytics";
+            readonly idFrom: "params.siteId";
+          }];
+          readonly changes: readonly [];
+        };
+        readonly lifecycle: {
+          readonly introduced: "1.1.0";
+        };
+        readonly docs: {
+          readonly summary: "Get unique-page trend";
+          readonly description: "Returns the daily unique-page count series for a window, with an optional previous-period total for comparison.";
+          readonly tags: readonly ["Analytics"];
+          readonly examples: {
+            readonly request: {
+              readonly params: {
+                readonly siteId: "s_01";
+              };
+              readonly query: {
+                readonly startDate: "2026-06-01";
+                readonly endDate: "2026-06-28";
+              };
+            };
+            readonly response: {
+              readonly data: {
+                readonly daily: readonly [];
+                readonly total: 0;
+                readonly meta: {
+                  readonly siteUrl: "sc-domain:example.com";
+                  readonly syncStatus: "synced";
+                };
+              };
+              readonly meta: {
+                readonly requestId: "req_01";
+                readonly surface: "partner";
+                readonly version: "1.0";
+              };
+            };
+          };
+        };
+      };
     }>;
     analytics: HttpV1Surface<{
       readonly queryRows: {