@gscdump/contracts 5.0.0 → 5.1.0

package/dist/endpoints.d.mts

@@ -1076,8 +1076,8 @@ export declare const partnerEndpoints: {
         status: import("zod").ZodEnum<{
           error: "error";
           registered: "registered";
-          already_exists: "already_exists";
           not_found: "not_found";
+          already_exists: "already_exists";
         }>;
         error: import("zod").ZodOptional<import("zod").ZodString>;
         site: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>>;
@@ -1431,19 +1431,19 @@ export declare const partnerEndpoints: {
           _tag: import("zod").ZodLiteral<"counted">;
           capturedAt: import("zod").ZodString;
           counts: import("zod").ZodObject<{
-            indexed: import("zod").ZodDefault<import("zod").ZodNumber>;
-            not_found: import("zod").ZodDefault<import("zod").ZodNumber>;
-            redirect: import("zod").ZodDefault<import("zod").ZodNumber>;
             unknown_to_google: import("zod").ZodDefault<import("zod").ZodNumber>;
             discovered_not_indexed: import("zod").ZodDefault<import("zod").ZodNumber>;
             crawled_not_indexed: import("zod").ZodDefault<import("zod").ZodNumber>;
+            indexed: import("zod").ZodDefault<import("zod").ZodNumber>;
             noindex: import("zod").ZodDefault<import("zod").ZodNumber>;
             blocked_robots: import("zod").ZodDefault<import("zod").ZodNumber>;
             soft_404: import("zod").ZodDefault<import("zod").ZodNumber>;
+            not_found: import("zod").ZodDefault<import("zod").ZodNumber>;
             server_error: import("zod").ZodDefault<import("zod").ZodNumber>;
             access_denied: import("zod").ZodDefault<import("zod").ZodNumber>;
             access_forbidden: import("zod").ZodDefault<import("zod").ZodNumber>;
             blocked_4xx: import("zod").ZodDefault<import("zod").ZodNumber>;
+            redirect: import("zod").ZodDefault<import("zod").ZodNumber>;
             redirect_error: import("zod").ZodDefault<import("zod").ZodNumber>;
             alternate_canonical: import("zod").ZodDefault<import("zod").ZodNumber>;
             duplicate_no_canonical: import("zod").ZodDefault<import("zod").ZodNumber>;

package/dist/indexing-coverage.d.mts

@@ -21,19 +21,19 @@ export type CoverageStateTag = typeof COVERAGE_STATE_TAGS[number];
 export declare const COVERAGE_LADDER: readonly ["unknown_to_google", "discovered_not_indexed", "crawled_not_indexed", "indexed"];
 export type CoverageLadderTag = typeof COVERAGE_LADDER[number];
 export declare const coverageStateTagSchema: z.ZodEnum<{
-  indexed: "indexed";
-  not_found: "not_found";
-  redirect: "redirect";
   unknown_to_google: "unknown_to_google";
   discovered_not_indexed: "discovered_not_indexed";
   crawled_not_indexed: "crawled_not_indexed";
+  indexed: "indexed";
   noindex: "noindex";
   blocked_robots: "blocked_robots";
   soft_404: "soft_404";
+  not_found: "not_found";
   server_error: "server_error";
   access_denied: "access_denied";
   access_forbidden: "access_forbidden";
   blocked_4xx: "blocked_4xx";
+  redirect: "redirect";
   redirect_error: "redirect_error";
   alternate_canonical: "alternate_canonical";
   duplicate_no_canonical: "duplicate_no_canonical";
@@ -49,19 +49,19 @@ export declare const coverageStateTagSchema: z.ZodEnum<{
  * reads a newer host's counts. Neither case fails the parse.
  */
 export declare const coverageStateCountsSchema: z.ZodObject<{
-  indexed: z.ZodDefault<z.ZodNumber>;
-  not_found: z.ZodDefault<z.ZodNumber>;
-  redirect: z.ZodDefault<z.ZodNumber>;
   unknown_to_google: z.ZodDefault<z.ZodNumber>;
   discovered_not_indexed: z.ZodDefault<z.ZodNumber>;
   crawled_not_indexed: z.ZodDefault<z.ZodNumber>;
+  indexed: z.ZodDefault<z.ZodNumber>;
   noindex: z.ZodDefault<z.ZodNumber>;
   blocked_robots: z.ZodDefault<z.ZodNumber>;
   soft_404: z.ZodDefault<z.ZodNumber>;
+  not_found: z.ZodDefault<z.ZodNumber>;
   server_error: z.ZodDefault<z.ZodNumber>;
   access_denied: z.ZodDefault<z.ZodNumber>;
   access_forbidden: z.ZodDefault<z.ZodNumber>;
   blocked_4xx: z.ZodDefault<z.ZodNumber>;
+  redirect: z.ZodDefault<z.ZodNumber>;
   redirect_error: z.ZodDefault<z.ZodNumber>;
   alternate_canonical: z.ZodDefault<z.ZodNumber>;
   duplicate_no_canonical: z.ZodDefault<z.ZodNumber>;
@@ -143,19 +143,19 @@ export declare const coverageStatesPointSchema: z.ZodDiscriminatedUnion<[z.ZodOb
   _tag: z.ZodLiteral<"counted">;
   capturedAt: z.ZodString;
   counts: z.ZodObject<{
-    indexed: z.ZodDefault<z.ZodNumber>;
-    not_found: z.ZodDefault<z.ZodNumber>;
-    redirect: z.ZodDefault<z.ZodNumber>;
     unknown_to_google: z.ZodDefault<z.ZodNumber>;
     discovered_not_indexed: z.ZodDefault<z.ZodNumber>;
     crawled_not_indexed: z.ZodDefault<z.ZodNumber>;
+    indexed: z.ZodDefault<z.ZodNumber>;
     noindex: z.ZodDefault<z.ZodNumber>;
     blocked_robots: z.ZodDefault<z.ZodNumber>;
     soft_404: z.ZodDefault<z.ZodNumber>;
+    not_found: z.ZodDefault<z.ZodNumber>;
     server_error: z.ZodDefault<z.ZodNumber>;
     access_denied: z.ZodDefault<z.ZodNumber>;
     access_forbidden: z.ZodDefault<z.ZodNumber>;
     blocked_4xx: z.ZodDefault<z.ZodNumber>;
+    redirect: z.ZodDefault<z.ZodNumber>;
     redirect_error: z.ZodDefault<z.ZodNumber>;
     alternate_canonical: z.ZodDefault<z.ZodNumber>;
     duplicate_no_canonical: z.ZodDefault<z.ZodNumber>;
@@ -193,19 +193,19 @@ export declare const WATCHED_URL_CHECKPOINT_LIMIT = 12;
 export declare const watchedUrlCheckpointSchema: z.ZodObject<{
   checkedAt: z.ZodString;
   coverageState: z.ZodCatch<z.ZodEnum<{
-    indexed: "indexed";
-    not_found: "not_found";
-    redirect: "redirect";
     unknown_to_google: "unknown_to_google";
     discovered_not_indexed: "discovered_not_indexed";
     crawled_not_indexed: "crawled_not_indexed";
+    indexed: "indexed";
     noindex: "noindex";
     blocked_robots: "blocked_robots";
     soft_404: "soft_404";
+    not_found: "not_found";
     server_error: "server_error";
     access_denied: "access_denied";
     access_forbidden: "access_forbidden";
     blocked_4xx: "blocked_4xx";
+    redirect: "redirect";
     redirect_error: "redirect_error";
     alternate_canonical: "alternate_canonical";
     duplicate_no_canonical: "duplicate_no_canonical";
@@ -226,19 +226,19 @@ export declare const watchedUrlSchema: z.ZodObject<{
   checkpoints: z.ZodArray<z.ZodObject<{
     checkedAt: z.ZodString;
     coverageState: z.ZodCatch<z.ZodEnum<{
-      indexed: "indexed";
-      not_found: "not_found";
-      redirect: "redirect";
       unknown_to_google: "unknown_to_google";
       discovered_not_indexed: "discovered_not_indexed";
       crawled_not_indexed: "crawled_not_indexed";
+      indexed: "indexed";
       noindex: "noindex";
       blocked_robots: "blocked_robots";
       soft_404: "soft_404";
+      not_found: "not_found";
       server_error: "server_error";
       access_denied: "access_denied";
       access_forbidden: "access_forbidden";
       blocked_4xx: "blocked_4xx";
+      redirect: "redirect";
       redirect_error: "redirect_error";
       alternate_canonical: "alternate_canonical";
       duplicate_no_canonical: "duplicate_no_canonical";
@@ -261,19 +261,19 @@ export declare const watchedUrlsResponseSchema: z.ZodObject<{
     checkpoints: z.ZodArray<z.ZodObject<{
       checkedAt: z.ZodString;
       coverageState: z.ZodCatch<z.ZodEnum<{
-        indexed: "indexed";
-        not_found: "not_found";
-        redirect: "redirect";
         unknown_to_google: "unknown_to_google";
         discovered_not_indexed: "discovered_not_indexed";
         crawled_not_indexed: "crawled_not_indexed";
+        indexed: "indexed";
         noindex: "noindex";
         blocked_robots: "blocked_robots";
         soft_404: "soft_404";
+        not_found: "not_found";
         server_error: "server_error";
         access_denied: "access_denied";
         access_forbidden: "access_forbidden";
         blocked_4xx: "blocked_4xx";
+        redirect: "redirect";
         redirect_error: "redirect_error";
         alternate_canonical: "alternate_canonical";
         duplicate_no_canonical: "duplicate_no_canonical";

package/dist/schemas.d.mts

@@ -365,9 +365,9 @@ export declare const indexingUrlsResponseSchema: z.ZodObject<{
 }, z.core.$loose>;
 export declare const GSCDUMP_INDEXING_TRANSITION_FIELDS: readonly ["indexStatus", "coverageState", "robotsTxtState", "indexingState", "pageFetchState", "googleCanonical"];
 export declare const gscdumpIndexingTransitionFieldSchema: z.ZodEnum<{
+  coverageState: "coverageState";
   indexStatus: "indexStatus";
   googleCanonical: "googleCanonical";
-  coverageState: "coverageState";
   robotsTxtState: "robotsTxtState";
   indexingState: "indexingState";
   pageFetchState: "pageFetchState";
@@ -1409,8 +1409,8 @@ export declare const bulkRegisterPartnerSitesResponseSchema: z.ZodObject<{
     status: z.ZodEnum<{
       error: "error";
       registered: "registered";
-      already_exists: "already_exists";
       not_found: "not_found";
+      already_exists: "already_exists";
     }>;
     error: z.ZodOptional<z.ZodString>;
     site: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -1805,19 +1805,19 @@ export declare const gscdumpIndexingResponseSchema: z.ZodObject<{
       _tag: z.ZodLiteral<"counted">;
       capturedAt: z.ZodString;
       counts: z.ZodObject<{
-        indexed: z.ZodDefault<z.ZodNumber>;
-        not_found: z.ZodDefault<z.ZodNumber>;
-        redirect: z.ZodDefault<z.ZodNumber>;
         unknown_to_google: z.ZodDefault<z.ZodNumber>;
         discovered_not_indexed: z.ZodDefault<z.ZodNumber>;
         crawled_not_indexed: z.ZodDefault<z.ZodNumber>;
+        indexed: z.ZodDefault<z.ZodNumber>;
         noindex: z.ZodDefault<z.ZodNumber>;
         blocked_robots: z.ZodDefault<z.ZodNumber>;
         soft_404: z.ZodDefault<z.ZodNumber>;
+        not_found: z.ZodDefault<z.ZodNumber>;
         server_error: z.ZodDefault<z.ZodNumber>;
         access_denied: z.ZodDefault<z.ZodNumber>;
         access_forbidden: z.ZodDefault<z.ZodNumber>;
         blocked_4xx: z.ZodDefault<z.ZodNumber>;
+        redirect: z.ZodDefault<z.ZodNumber>;
         redirect_error: z.ZodDefault<z.ZodNumber>;
         alternate_canonical: z.ZodDefault<z.ZodNumber>;
         duplicate_no_canonical: z.ZodDefault<z.ZodNumber>;
@@ -2124,8 +2124,8 @@ export declare const gscdumpSyncProgressResponseSchema: z.ZodObject<{
     authFailureCount: z.ZodNumber;
     currentPhase: z.ZodEnum<{
       complete: "complete";
-      backfill: "backfill";
       initial: "initial";
+      backfill: "backfill";
     }>;
     isStalled: z.ZodBoolean;
     stallDays: z.ZodNumber;
@@ -3619,8 +3619,8 @@ export declare const partnerControlEndpointSchemas: {
         authFailureCount: z.ZodNumber;
         currentPhase: z.ZodEnum<{
           complete: "complete";
-          backfill: "backfill";
           initial: "initial";
+          backfill: "backfill";
         }>;
         isStalled: z.ZodBoolean;
         stallDays: z.ZodNumber;
@@ -4226,8 +4226,8 @@ export declare const partnerControlEndpointSchemas: {
         status: z.ZodEnum<{
           error: "error";
           registered: "registered";
-          already_exists: "already_exists";
           not_found: "not_found";
+          already_exists: "already_exists";
         }>;
         error: z.ZodOptional<z.ZodString>;
         site: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -4491,19 +4491,19 @@ export declare const partnerControlEndpointSchemas: {
           _tag: z.ZodLiteral<"counted">;
           capturedAt: z.ZodString;
           counts: z.ZodObject<{
-            indexed: z.ZodDefault<z.ZodNumber>;
-            not_found: z.ZodDefault<z.ZodNumber>;
-            redirect: z.ZodDefault<z.ZodNumber>;
             unknown_to_google: z.ZodDefault<z.ZodNumber>;
             discovered_not_indexed: z.ZodDefault<z.ZodNumber>;
             crawled_not_indexed: z.ZodDefault<z.ZodNumber>;
+            indexed: z.ZodDefault<z.ZodNumber>;
             noindex: z.ZodDefault<z.ZodNumber>;
             blocked_robots: z.ZodDefault<z.ZodNumber>;
             soft_404: z.ZodDefault<z.ZodNumber>;
+            not_found: z.ZodDefault<z.ZodNumber>;
             server_error: z.ZodDefault<z.ZodNumber>;
             access_denied: z.ZodDefault<z.ZodNumber>;
             access_forbidden: z.ZodDefault<z.ZodNumber>;
             blocked_4xx: z.ZodDefault<z.ZodNumber>;
+            redirect: z.ZodDefault<z.ZodNumber>;
             redirect_error: z.ZodDefault<z.ZodNumber>;
             alternate_canonical: z.ZodDefault<z.ZodNumber>;
             duplicate_no_canonical: z.ZodDefault<z.ZodNumber>;
@@ -5424,8 +5424,8 @@ export declare const partnerEndpointSchemas: {
         authFailureCount: z.ZodNumber;
         currentPhase: z.ZodEnum<{
           complete: "complete";
-          backfill: "backfill";
           initial: "initial";
+          backfill: "backfill";
         }>;
         isStalled: z.ZodBoolean;
         stallDays: z.ZodNumber;
@@ -6031,8 +6031,8 @@ export declare const partnerEndpointSchemas: {
         status: z.ZodEnum<{
           error: "error";
           registered: "registered";
-          already_exists: "already_exists";
           not_found: "not_found";
+          already_exists: "already_exists";
         }>;
         error: z.ZodOptional<z.ZodString>;
         site: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -6296,19 +6296,19 @@ export declare const partnerEndpointSchemas: {
           _tag: z.ZodLiteral<"counted">;
           capturedAt: z.ZodString;
           counts: z.ZodObject<{
-            indexed: z.ZodDefault<z.ZodNumber>;
-            not_found: z.ZodDefault<z.ZodNumber>;
-            redirect: z.ZodDefault<z.ZodNumber>;
             unknown_to_google: z.ZodDefault<z.ZodNumber>;
             discovered_not_indexed: z.ZodDefault<z.ZodNumber>;
             crawled_not_indexed: z.ZodDefault<z.ZodNumber>;
+            indexed: z.ZodDefault<z.ZodNumber>;
             noindex: z.ZodDefault<z.ZodNumber>;
             blocked_robots: z.ZodDefault<z.ZodNumber>;
             soft_404: z.ZodDefault<z.ZodNumber>;
+            not_found: z.ZodDefault<z.ZodNumber>;
             server_error: z.ZodDefault<z.ZodNumber>;
             access_denied: z.ZodDefault<z.ZodNumber>;
             access_forbidden: z.ZodDefault<z.ZodNumber>;
             blocked_4xx: z.ZodDefault<z.ZodNumber>;
+            redirect: z.ZodDefault<z.ZodNumber>;
             redirect_error: z.ZodDefault<z.ZodNumber>;
             alternate_canonical: z.ZodDefault<z.ZodNumber>;
             duplicate_no_canonical: z.ZodDefault<z.ZodNumber>;

package/dist/v1/browser.d.mts

@@ -17,12 +17,12 @@ export declare const GSCDUMP_V1_ANALYTICS_DIMENSIONS: readonly ["page", "query",
 export declare function createGscdumpV1BrowserSchemas(realtimeSchemas?: RealtimeV1Schemas): {
   analyticsRowsRequest: z.ZodObject<{
     dimensions: z.ZodArray<z.ZodEnum<{
+      date: "date";
       page: "page";
       query: "query";
       queryCanonical: "queryCanonical";
       country: "country";
       device: "device";
-      date: "date";
       searchAppearance: "searchAppearance";
       hour: "hour";
     }>>;

package/dist/v1/google-indexing.d.mts

@@ -0,0 +1,225 @@
+import { z } from "zod";
+/** Notifications one Site may send in one Pacific day. */
+export declare const GOOGLE_SUBMISSION_SITE_DAILY_LIMIT = 5;
+/** Days after an accepted notification before the same URL may be sent again. */
+export declare const GOOGLE_SUBMISSION_URL_COOLDOWN_DAYS = 7;
+/** Google's default publish quota for one Cloud project in one Pacific day. */
+export declare const GOOGLE_INDEXING_API_PROJECT_DAILY_DEFAULT = 200;
+/** Attempts one idempotency key may make before its receipt stays `failed`. */
+export declare const GOOGLE_SUBMISSION_MAX_ATTEMPTS = 3;
+/**
+ * `partner.users.indexing.google.grant.update`. The partner runs Google's
+ * consent with its dedicated Indexing API client, then hands over the refresh
+ * token and the scopes Google granted. gscdump refuses a grant whose `scope`
+ * lacks `https://www.googleapis.com/auth/indexing`.
+ */
+export declare const indexingApiGrantUpdateV1Schema: z.ZodObject<{
+  refreshToken: z.ZodString;
+  scope: z.ZodString;
+  googleEmail: z.ZodNullable<z.ZodEmail>;
+}, z.core.$strict>;
+export declare const indexingApiGrantV1Schemas: {
+  producer: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    readonly _tag: z.ZodLiteral<"missing">;
+  }, z.core.$strip>, z.ZodObject<{
+    readonly _tag: z.ZodLiteral<"granted">;
+    readonly googleEmail: z.ZodNullable<z.ZodString>;
+    readonly grantedAt: z.ZodISODateTime;
+  }, z.core.$strip>, z.ZodObject<{
+    readonly _tag: z.ZodLiteral<"reauthorization-required">;
+    readonly googleEmail: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>], "_tag">;
+  client: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    readonly _tag: z.ZodLiteral<"missing">;
+  }, z.core.$strip>, z.ZodObject<{
+    readonly _tag: z.ZodLiteral<"granted">;
+    readonly googleEmail: z.ZodNullable<z.ZodString>;
+    readonly grantedAt: z.ZodISODateTime;
+  }, z.core.$strip>, z.ZodObject<{
+    readonly _tag: z.ZodLiteral<"reauthorization-required">;
+    readonly googleEmail: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>], "_tag">;
+};
+export declare const indexingApiGrantV1Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  readonly _tag: z.ZodLiteral<"missing">;
+}, z.core.$strip>, z.ZodObject<{
+  readonly _tag: z.ZodLiteral<"granted">;
+  readonly googleEmail: z.ZodNullable<z.ZodString>;
+  readonly grantedAt: z.ZodISODateTime;
+}, z.core.$strip>, z.ZodObject<{
+  readonly _tag: z.ZodLiteral<"reauthorization-required">;
+  readonly googleEmail: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>], "_tag">;
+export type IndexingApiGrantV1 = z.infer<typeof indexingApiGrantV1Schema>;
+/** `partner.sites.indexing.google.submissions.create`. One URL per request. */
+export declare const googleSubmitV1Schema: z.ZodObject<{
+  url: z.ZodURL;
+  idempotencyKey: z.ZodString;
+}, z.core.$strict>;
+/**
+ * Why Google refused a notification. gscdump never retries a rejection.
+ *
+ * - `not-owner`: the grant's Google account does not own the property.
+ * - `access-revoked`: Google disabled the Indexing API for the partner's
+ *   Cloud project. gscdump pauses the partner's Google delivery.
+ * - `quota-exhausted`: Google's project quota is spent until the next Pacific day.
+ * - `reauthorization-required`: Google refused the stored grant.
+ */
+export declare const GOOGLE_SUBMISSION_REJECTION_REASONS: readonly ["not-owner", "access-revoked", "quota-exhausted", "reauthorization-required"];
+export type GoogleSubmissionRejectionReason = typeof GOOGLE_SUBMISSION_REJECTION_REASONS[number];
+export declare const googleSubmissionReceiptV1Schemas: {
+  producer: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    readonly httpStatus: z.ZodLiteral<200>;
+    readonly reason: z.ZodNull;
+    readonly id: z.ZodString;
+    readonly url: z.ZodURL;
+    readonly createdAt: z.ZodISODateTime;
+    readonly updatedAt: z.ZodISODateTime;
+    readonly attempts: z.ZodNumber;
+    readonly _tag: z.ZodLiteral<"accepted">;
+  }, z.core.$strip>, z.ZodObject<{
+    readonly httpStatus: z.ZodNullable<z.ZodNumber>;
+    readonly reason: z.ZodEnum<{
+      "reauthorization-required": "reauthorization-required";
+      "not-owner": "not-owner";
+      "access-revoked": "access-revoked";
+      "quota-exhausted": "quota-exhausted";
+    }>;
+    readonly id: z.ZodString;
+    readonly url: z.ZodURL;
+    readonly createdAt: z.ZodISODateTime;
+    readonly updatedAt: z.ZodISODateTime;
+    readonly attempts: z.ZodNumber;
+    readonly _tag: z.ZodLiteral<"rejected">;
+  }, z.core.$strip>, z.ZodObject<{
+    readonly httpStatus: z.ZodNullable<z.ZodNumber>;
+    readonly reason: z.ZodString;
+    readonly id: z.ZodString;
+    readonly url: z.ZodURL;
+    readonly createdAt: z.ZodISODateTime;
+    readonly updatedAt: z.ZodISODateTime;
+    readonly attempts: z.ZodNumber;
+    readonly _tag: z.ZodLiteral<"failed">;
+  }, z.core.$strip>], "_tag">;
+  client: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    readonly httpStatus: z.ZodLiteral<200>;
+    readonly reason: z.ZodNull;
+    readonly id: z.ZodString;
+    readonly url: z.ZodURL;
+    readonly createdAt: z.ZodISODateTime;
+    readonly updatedAt: z.ZodISODateTime;
+    readonly attempts: z.ZodNumber;
+    readonly _tag: z.ZodLiteral<"accepted">;
+  }, z.core.$strip>, z.ZodObject<{
+    readonly httpStatus: z.ZodNullable<z.ZodNumber>;
+    readonly reason: z.ZodEnum<{
+      "reauthorization-required": "reauthorization-required";
+      "not-owner": "not-owner";
+      "access-revoked": "access-revoked";
+      "quota-exhausted": "quota-exhausted";
+    }>;
+    readonly id: z.ZodString;
+    readonly url: z.ZodURL;
+    readonly createdAt: z.ZodISODateTime;
+    readonly updatedAt: z.ZodISODateTime;
+    readonly attempts: z.ZodNumber;
+    readonly _tag: z.ZodLiteral<"rejected">;
+  }, z.core.$strip>, z.ZodObject<{
+    readonly httpStatus: z.ZodNullable<z.ZodNumber>;
+    readonly reason: z.ZodString;
+    readonly id: z.ZodString;
+    readonly url: z.ZodURL;
+    readonly createdAt: z.ZodISODateTime;
+    readonly updatedAt: z.ZodISODateTime;
+    readonly attempts: z.ZodNumber;
+    readonly _tag: z.ZodLiteral<"failed">;
+  }, z.core.$strip>], "_tag">;
+};
+export declare const googleSubmissionReceiptV1Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  readonly httpStatus: z.ZodLiteral<200>;
+  readonly reason: z.ZodNull;
+  readonly id: z.ZodString;
+  readonly url: z.ZodURL;
+  readonly createdAt: z.ZodISODateTime;
+  readonly updatedAt: z.ZodISODateTime;
+  readonly attempts: z.ZodNumber;
+  readonly _tag: z.ZodLiteral<"accepted">;
+}, z.core.$strip>, z.ZodObject<{
+  readonly httpStatus: z.ZodNullable<z.ZodNumber>;
+  readonly reason: z.ZodEnum<{
+    "reauthorization-required": "reauthorization-required";
+    "not-owner": "not-owner";
+    "access-revoked": "access-revoked";
+    "quota-exhausted": "quota-exhausted";
+  }>;
+  readonly id: z.ZodString;
+  readonly url: z.ZodURL;
+  readonly createdAt: z.ZodISODateTime;
+  readonly updatedAt: z.ZodISODateTime;
+  readonly attempts: z.ZodNumber;
+  readonly _tag: z.ZodLiteral<"rejected">;
+}, z.core.$strip>, z.ZodObject<{
+  readonly httpStatus: z.ZodNullable<z.ZodNumber>;
+  readonly reason: z.ZodString;
+  readonly id: z.ZodString;
+  readonly url: z.ZodURL;
+  readonly createdAt: z.ZodISODateTime;
+  readonly updatedAt: z.ZodISODateTime;
+  readonly attempts: z.ZodNumber;
+  readonly _tag: z.ZodLiteral<"failed">;
+}, z.core.$strip>], "_tag">;
+export type GoogleSubmissionReceiptV1 = z.infer<typeof googleSubmissionReceiptV1Schema>;
+/**
+ * The `details.reason` values of a v1 error envelope that refuses a Google
+ * Submission before gscdump sends anything. They are snake_case, like the
+ * entitlement refusals.
+ */
+export declare const GOOGLE_SUBMISSION_REFUSAL_REASONS: readonly ["indexing_api_unavailable", "needs_indexing_api_grant", "url_outside_site", "cooling_down", "site_daily_limit", "project_quota_spent"];
+export type GoogleSubmissionRefusalReason = typeof GOOGLE_SUBMISSION_REFUSAL_REASONS[number];
+/**
+ * The `details` of a v1 error envelope that refuses a Google Submission.
+ *
+ * - `indexing_api_unavailable` (409 `invalid_request`): the partner has no
+ *   Indexing API client, or gscdump paused its Google delivery.
+ * - `needs_indexing_api_grant` (409 `invalid_request`): the Site's user holds
+ *   no usable Indexing API grant for this partner. `grant` says which.
+ * - `url_outside_site` (400 `invalid_request`): the URL is not on the
+ *   registered Site host, or not inside its URL-prefix property.
+ * - `cooling_down` (409 `invalid_request`): Google accepted this URL at
+ *   `lastAcceptedAt`. It may be sent again at `availableAt`.
+ * - `site_daily_limit` (429 `rate_limited`): the Site sent `limit`
+ *   notifications this Pacific day. The count resets at `resetsAt`.
+ * - `project_quota_spent` (429 `rate_limited`): the partner's Cloud project
+ *   has no quota left this Pacific day. It resets at `resetsAt`.
+ *
+ * Unknown `details` keys are dropped, so a newer host can add keys.
+ */
+export declare const googleSubmissionRefusalSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  reason: z.ZodLiteral<"indexing_api_unavailable">;
+}, z.core.$strip>, z.ZodObject<{
+  reason: z.ZodLiteral<"needs_indexing_api_grant">;
+  grant: z.ZodEnum<{
+    "reauthorization-required": "reauthorization-required";
+    missing: "missing";
+  }>;
+}, z.core.$strip>, z.ZodObject<{
+  reason: z.ZodLiteral<"url_outside_site">;
+}, z.core.$strip>, z.ZodObject<{
+  reason: z.ZodLiteral<"cooling_down">;
+  lastAcceptedAt: z.ZodISODateTime;
+  availableAt: z.ZodISODateTime;
+}, z.core.$strip>, z.ZodObject<{
+  reason: z.ZodLiteral<"site_daily_limit">;
+  limit: z.ZodNumber;
+  resetsAt: z.ZodISODateTime;
+}, z.core.$strip>, z.ZodObject<{
+  reason: z.ZodLiteral<"project_quota_spent">;
+  resetsAt: z.ZodISODateTime;
+}, z.core.$strip>], "reason">;
+export type GoogleSubmissionRefusal = z.infer<typeof googleSubmissionRefusalSchema>;
+/**
+ * Read a Google Submission refusal from the `details` of a v1 error envelope,
+ * such as `GscdumpV1Error.details`. Returns `null` when the details describe a
+ * different failure, or a refusal this contract version does not know.
+ */
+export declare function parseGoogleSubmissionRefusal(details: unknown): GoogleSubmissionRefusal | null;

package/dist/v1/google-indexing.mjs

@@ -0,0 +1,119 @@
+import { defineResponseObject } from "./http-core.mjs";
+import { z } from "zod";
+const GOOGLE_SUBMISSION_SITE_DAILY_LIMIT = 5;
+const GOOGLE_SUBMISSION_URL_COOLDOWN_DAYS = 7;
+const GOOGLE_INDEXING_API_PROJECT_DAILY_DEFAULT = 200;
+const GOOGLE_SUBMISSION_MAX_ATTEMPTS = 3;
+const count = z.number().int().nonnegative();
+const pageUrl = z.url({ protocol: /^https?$/ });
+const indexingApiGrantUpdateV1Schema = z.strictObject({
+	refreshToken: z.string().min(1),
+	scope: z.string().min(1),
+	googleEmail: z.email().nullable()
+});
+const missingGrant = defineResponseObject({ _tag: z.literal("missing") });
+const grantedGrant = defineResponseObject({
+	_tag: z.literal("granted"),
+	googleEmail: z.string().nullable(),
+	grantedAt: z.iso.datetime()
+});
+const reauthorizationGrant = defineResponseObject({
+	_tag: z.literal("reauthorization-required"),
+	googleEmail: z.string().nullable()
+});
+const indexingApiGrantV1Schemas = {
+	producer: z.discriminatedUnion("_tag", [
+		missingGrant.producer,
+		grantedGrant.producer,
+		reauthorizationGrant.producer
+	]),
+	client: z.discriminatedUnion("_tag", [
+		missingGrant.client,
+		grantedGrant.client,
+		reauthorizationGrant.client
+	])
+};
+const indexingApiGrantV1Schema = indexingApiGrantV1Schemas.producer;
+const googleSubmitV1Schema = z.strictObject({
+	url: pageUrl,
+	idempotencyKey: z.string().min(1).max(128)
+});
+const GOOGLE_SUBMISSION_REJECTION_REASONS = [
+	"not-owner",
+	"access-revoked",
+	"quota-exhausted",
+	"reauthorization-required"
+];
+const receiptShape = {
+	id: z.string().min(1),
+	url: pageUrl,
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime(),
+	attempts: z.number().int().min(1).max(3)
+};
+const acceptedReceipt = defineResponseObject({
+	_tag: z.literal("accepted"),
+	...receiptShape,
+	httpStatus: z.literal(200),
+	reason: z.null()
+});
+const rejectedReceipt = defineResponseObject({
+	_tag: z.literal("rejected"),
+	...receiptShape,
+	httpStatus: z.number().int().min(400).max(499).nullable(),
+	reason: z.enum(GOOGLE_SUBMISSION_REJECTION_REASONS)
+});
+const failedReceipt = defineResponseObject({
+	_tag: z.literal("failed"),
+	...receiptShape,
+	httpStatus: z.number().int().min(100).max(599).nullable(),
+	reason: z.string().min(1)
+});
+const googleSubmissionReceiptV1Schemas = {
+	producer: z.discriminatedUnion("_tag", [
+		acceptedReceipt.producer,
+		rejectedReceipt.producer,
+		failedReceipt.producer
+	]),
+	client: z.discriminatedUnion("_tag", [
+		acceptedReceipt.client,
+		rejectedReceipt.client,
+		failedReceipt.client
+	])
+};
+const googleSubmissionReceiptV1Schema = googleSubmissionReceiptV1Schemas.producer;
+const GOOGLE_SUBMISSION_REFUSAL_REASONS = [
+	"indexing_api_unavailable",
+	"needs_indexing_api_grant",
+	"url_outside_site",
+	"cooling_down",
+	"site_daily_limit",
+	"project_quota_spent"
+];
+const googleSubmissionRefusalSchema = z.discriminatedUnion("reason", [
+	z.object({ reason: z.literal("indexing_api_unavailable") }),
+	z.object({
+		reason: z.literal("needs_indexing_api_grant"),
+		grant: z.enum(["missing", "reauthorization-required"])
+	}),
+	z.object({ reason: z.literal("url_outside_site") }),
+	z.object({
+		reason: z.literal("cooling_down"),
+		lastAcceptedAt: z.iso.datetime(),
+		availableAt: z.iso.datetime()
+	}),
+	z.object({
+		reason: z.literal("site_daily_limit"),
+		limit: count,
+		resetsAt: z.iso.datetime()
+	}),
+	z.object({
+		reason: z.literal("project_quota_spent"),
+		resetsAt: z.iso.datetime()
+	})
+]);
+function parseGoogleSubmissionRefusal(details) {
+	const parsed = googleSubmissionRefusalSchema.safeParse(details);
+	return parsed.success ? parsed.data : null;
+}
+export { GOOGLE_INDEXING_API_PROJECT_DAILY_DEFAULT, GOOGLE_SUBMISSION_MAX_ATTEMPTS, GOOGLE_SUBMISSION_REFUSAL_REASONS, GOOGLE_SUBMISSION_REJECTION_REASONS, GOOGLE_SUBMISSION_SITE_DAILY_LIMIT, GOOGLE_SUBMISSION_URL_COOLDOWN_DAYS, googleSubmissionReceiptV1Schema, googleSubmissionReceiptV1Schemas, googleSubmissionRefusalSchema, googleSubmitV1Schema, indexingApiGrantUpdateV1Schema, indexingApiGrantV1Schema, indexingApiGrantV1Schemas, parseGoogleSubmissionRefusal };