@nuxtseo/protocol 0.4.1 → 0.5.1

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 (11) hide show
  1. package/dist/v1/actions.d.ts +101 -7
  2. package/dist/v1/actions.js +35 -8
  3. package/dist/v1/backlinks.d.ts +405 -6
  4. package/dist/v1/backlinks.js +81 -3
  5. package/dist/v1/gsc.d.ts +189 -29
  6. package/dist/v1/gsc.js +18 -3
  7. package/dist/v1/sitemaps.d.ts +42 -0
  8. package/dist/v1/sites.d.ts +187 -19
  9. package/dist/v1/sites.js +30 -8
  10. package/generated/openapi.v1.json +1 -1
  11. package/package.json +3 -3
package/dist/v1/gsc.d.ts CHANGED
@@ -1671,6 +1671,19 @@ export declare const indexingDiagnosticsDataSchema: {
1671
1671
  readonly totalUrls: z.ZodNumber;
1672
1672
  readonly indexed: z.ZodNumber;
1673
1673
  readonly asOf: z.ZodNullable<z.ZodString>;
1674
+ /** Where `asOf` came from: `rollup` build time, `capture` (when gscdump counted the verdicts), or the `newest-check` URL inspection. Null when the age is unknown. */
1675
+ readonly asOfSource: z.ZodNullable<z.ZodEnum<{
1676
+ capture: "capture";
1677
+ "newest-check": "newest-check";
1678
+ rollup: "rollup";
1679
+ }>>;
1680
+ /** The oldest URL inspection behind these counts. With `asOf` it bounds the evidence age. Null when unknown. */
1681
+ readonly oldestCheckAt: z.ZodNullable<z.ZodString>;
1682
+ /** Share of the counted verdicts older than 7 and 30 days when `asOf` was set. Null when gscdump did not measure verdict age. */
1683
+ readonly verdictFreshness: z.ZodNullable<z.ZodObject<{
1684
+ olderThan7dPercent: z.ZodNumber;
1685
+ olderThan30dPercent: z.ZodNumber;
1686
+ }, z.core.$strip>>;
1674
1687
  readonly issues: z.ZodArray<z.ZodObject<{
1675
1688
  type: z.ZodString;
1676
1689
  label: z.ZodString;
@@ -1686,6 +1699,12 @@ export declare const indexingDiagnosticsDataSchema: {
1686
1699
  }, z.core.$strip>, z.ZodObject<{
1687
1700
  readonly view: z.ZodLiteral<"urls">;
1688
1701
  readonly total: z.ZodNumber;
1702
+ /** Lookahead reports a floor until the terminal page; it does not count every matching URL. */
1703
+ readonly totalSemantics: z.ZodEnum<{
1704
+ exact: "exact";
1705
+ "lower-bound": "lower-bound";
1706
+ unknown: "unknown";
1707
+ }>;
1689
1708
  readonly limit: z.ZodNumber;
1690
1709
  readonly offset: z.ZodNumber;
1691
1710
  readonly hasMore: z.ZodBoolean;
@@ -1705,6 +1724,19 @@ export declare const indexingDiagnosticsDataSchema: {
1705
1724
  readonly totalUrls: z.ZodNumber;
1706
1725
  readonly indexed: z.ZodNumber;
1707
1726
  readonly asOf: z.ZodNullable<z.ZodString>;
1727
+ /** Where `asOf` came from: `rollup` build time, `capture` (when gscdump counted the verdicts), or the `newest-check` URL inspection. Null when the age is unknown. */
1728
+ readonly asOfSource: z.ZodNullable<z.ZodEnum<{
1729
+ capture: "capture";
1730
+ "newest-check": "newest-check";
1731
+ rollup: "rollup";
1732
+ }>>;
1733
+ /** The oldest URL inspection behind these counts. With `asOf` it bounds the evidence age. Null when unknown. */
1734
+ readonly oldestCheckAt: z.ZodNullable<z.ZodString>;
1735
+ /** Share of the counted verdicts older than 7 and 30 days when `asOf` was set. Null when gscdump did not measure verdict age. */
1736
+ readonly verdictFreshness: z.ZodNullable<z.ZodObject<{
1737
+ olderThan7dPercent: z.ZodNumber;
1738
+ olderThan30dPercent: z.ZodNumber;
1739
+ }, z.core.$strip>>;
1708
1740
  readonly issues: z.ZodArray<z.ZodObject<{
1709
1741
  type: z.ZodString;
1710
1742
  label: z.ZodString;
@@ -1720,6 +1752,11 @@ export declare const indexingDiagnosticsDataSchema: {
1720
1752
  }, z.core.$strip>, z.ZodObject<{
1721
1753
  readonly view: z.ZodLiteral<"urls">;
1722
1754
  readonly total: z.ZodNumber;
1755
+ readonly totalSemantics: z.ZodEnum<{
1756
+ exact: "exact";
1757
+ "lower-bound": "lower-bound";
1758
+ unknown: "unknown";
1759
+ }>;
1723
1760
  readonly limit: z.ZodNumber;
1724
1761
  readonly offset: z.ZodNumber;
1725
1762
  readonly hasMore: z.ZodBoolean;
@@ -1741,6 +1778,19 @@ export declare const indexingDiagnosticsResponseSchema: import("./core.js").Comp
1741
1778
  readonly totalUrls: z.ZodNumber;
1742
1779
  readonly indexed: z.ZodNumber;
1743
1780
  readonly asOf: z.ZodNullable<z.ZodString>;
1781
+ /** Where `asOf` came from: `rollup` build time, `capture` (when gscdump counted the verdicts), or the `newest-check` URL inspection. Null when the age is unknown. */
1782
+ readonly asOfSource: z.ZodNullable<z.ZodEnum<{
1783
+ capture: "capture";
1784
+ "newest-check": "newest-check";
1785
+ rollup: "rollup";
1786
+ }>>;
1787
+ /** The oldest URL inspection behind these counts. With `asOf` it bounds the evidence age. Null when unknown. */
1788
+ readonly oldestCheckAt: z.ZodNullable<z.ZodString>;
1789
+ /** Share of the counted verdicts older than 7 and 30 days when `asOf` was set. Null when gscdump did not measure verdict age. */
1790
+ readonly verdictFreshness: z.ZodNullable<z.ZodObject<{
1791
+ olderThan7dPercent: z.ZodNumber;
1792
+ olderThan30dPercent: z.ZodNumber;
1793
+ }, z.core.$strip>>;
1744
1794
  readonly issues: z.ZodArray<z.ZodObject<{
1745
1795
  type: z.ZodString;
1746
1796
  label: z.ZodString;
@@ -1756,6 +1806,12 @@ export declare const indexingDiagnosticsResponseSchema: import("./core.js").Comp
1756
1806
  }, z.core.$strip>, z.ZodObject<{
1757
1807
  readonly view: z.ZodLiteral<"urls">;
1758
1808
  readonly total: z.ZodNumber;
1809
+ /** Lookahead reports a floor until the terminal page; it does not count every matching URL. */
1810
+ readonly totalSemantics: z.ZodEnum<{
1811
+ exact: "exact";
1812
+ "lower-bound": "lower-bound";
1813
+ unknown: "unknown";
1814
+ }>;
1759
1815
  readonly limit: z.ZodNumber;
1760
1816
  readonly offset: z.ZodNumber;
1761
1817
  readonly hasMore: z.ZodBoolean;
@@ -1780,6 +1836,19 @@ export declare const indexingDiagnosticsResponseSchema: import("./core.js").Comp
1780
1836
  readonly totalUrls: z.ZodNumber;
1781
1837
  readonly indexed: z.ZodNumber;
1782
1838
  readonly asOf: z.ZodNullable<z.ZodString>;
1839
+ /** Where `asOf` came from: `rollup` build time, `capture` (when gscdump counted the verdicts), or the `newest-check` URL inspection. Null when the age is unknown. */
1840
+ readonly asOfSource: z.ZodNullable<z.ZodEnum<{
1841
+ capture: "capture";
1842
+ "newest-check": "newest-check";
1843
+ rollup: "rollup";
1844
+ }>>;
1845
+ /** The oldest URL inspection behind these counts. With `asOf` it bounds the evidence age. Null when unknown. */
1846
+ readonly oldestCheckAt: z.ZodNullable<z.ZodString>;
1847
+ /** Share of the counted verdicts older than 7 and 30 days when `asOf` was set. Null when gscdump did not measure verdict age. */
1848
+ readonly verdictFreshness: z.ZodNullable<z.ZodObject<{
1849
+ olderThan7dPercent: z.ZodNumber;
1850
+ olderThan30dPercent: z.ZodNumber;
1851
+ }, z.core.$strip>>;
1783
1852
  readonly issues: z.ZodArray<z.ZodObject<{
1784
1853
  type: z.ZodString;
1785
1854
  label: z.ZodString;
@@ -1795,6 +1864,11 @@ export declare const indexingDiagnosticsResponseSchema: import("./core.js").Comp
1795
1864
  }, z.core.$strip>, z.ZodObject<{
1796
1865
  readonly view: z.ZodLiteral<"urls">;
1797
1866
  readonly total: z.ZodNumber;
1867
+ readonly totalSemantics: z.ZodEnum<{
1868
+ exact: "exact";
1869
+ "lower-bound": "lower-bound";
1870
+ unknown: "unknown";
1871
+ }>;
1798
1872
  readonly limit: z.ZodNumber;
1799
1873
  readonly offset: z.ZodNumber;
1800
1874
  readonly hasMore: z.ZodBoolean;
@@ -1817,9 +1891,9 @@ export declare const indexingDiagnosticsResponseSchema: import("./core.js").Comp
1817
1891
  export declare const indexingHistoryQuerySchema: z.ZodObject<{
1818
1892
  url: z.ZodOptional<z.ZodString>;
1819
1893
  field: z.ZodOptional<z.ZodEnum<{
1894
+ coverageState: "coverageState";
1820
1895
  indexStatus: "indexStatus";
1821
1896
  googleCanonical: "googleCanonical";
1822
- coverageState: "coverageState";
1823
1897
  robotsTxtState: "robotsTxtState";
1824
1898
  indexingState: "indexingState";
1825
1899
  pageFetchState: "pageFetchState";
@@ -1833,9 +1907,9 @@ export declare const indexingHistoryDataSchema: import("./core.js").CompatibleRe
1833
1907
  }, z.core.$strict>, z.ZodObject<{
1834
1908
  _tag: z.ZodLiteral<"site">;
1835
1909
  field: z.ZodEnum<{
1910
+ coverageState: "coverageState";
1836
1911
  indexStatus: "indexStatus";
1837
1912
  googleCanonical: "googleCanonical";
1838
- coverageState: "coverageState";
1839
1913
  robotsTxtState: "robotsTxtState";
1840
1914
  indexingState: "indexingState";
1841
1915
  pageFetchState: "pageFetchState";
@@ -1853,9 +1927,9 @@ export declare const indexingHistoryDataSchema: import("./core.js").CompatibleRe
1853
1927
  readonly changes: z.ZodArray<z.ZodObject<{
1854
1928
  readonly url: z.ZodString;
1855
1929
  readonly field: z.ZodEnum<{
1930
+ coverageState: "coverageState";
1856
1931
  indexStatus: "indexStatus";
1857
1932
  googleCanonical: "googleCanonical";
1858
- coverageState: "coverageState";
1859
1933
  robotsTxtState: "robotsTxtState";
1860
1934
  indexingState: "indexingState";
1861
1935
  pageFetchState: "pageFetchState";
@@ -1896,9 +1970,9 @@ export declare const indexingHistoryDataSchema: import("./core.js").CompatibleRe
1896
1970
  }, z.core.$loose>, z.ZodObject<{
1897
1971
  _tag: z.ZodLiteral<"site">;
1898
1972
  field: z.ZodEnum<{
1973
+ coverageState: "coverageState";
1899
1974
  indexStatus: "indexStatus";
1900
1975
  googleCanonical: "googleCanonical";
1901
- coverageState: "coverageState";
1902
1976
  robotsTxtState: "robotsTxtState";
1903
1977
  indexingState: "indexingState";
1904
1978
  pageFetchState: "pageFetchState";
@@ -1916,9 +1990,9 @@ export declare const indexingHistoryDataSchema: import("./core.js").CompatibleRe
1916
1990
  readonly changes: z.ZodArray<z.ZodObject<{
1917
1991
  readonly url: z.ZodString;
1918
1992
  readonly field: z.ZodEnum<{
1993
+ coverageState: "coverageState";
1919
1994
  indexStatus: "indexStatus";
1920
1995
  googleCanonical: "googleCanonical";
1921
- coverageState: "coverageState";
1922
1996
  robotsTxtState: "robotsTxtState";
1923
1997
  indexingState: "indexingState";
1924
1998
  pageFetchState: "pageFetchState";
@@ -1961,9 +2035,9 @@ export declare const indexingHistoryResponseSchema: import("./core.js").Compatib
1961
2035
  }, z.core.$strict>, z.ZodObject<{
1962
2036
  _tag: z.ZodLiteral<"site">;
1963
2037
  field: z.ZodEnum<{
2038
+ coverageState: "coverageState";
1964
2039
  indexStatus: "indexStatus";
1965
2040
  googleCanonical: "googleCanonical";
1966
- coverageState: "coverageState";
1967
2041
  robotsTxtState: "robotsTxtState";
1968
2042
  indexingState: "indexingState";
1969
2043
  pageFetchState: "pageFetchState";
@@ -1981,9 +2055,9 @@ export declare const indexingHistoryResponseSchema: import("./core.js").Compatib
1981
2055
  readonly changes: z.ZodArray<z.ZodObject<{
1982
2056
  readonly url: z.ZodString;
1983
2057
  readonly field: z.ZodEnum<{
2058
+ coverageState: "coverageState";
1984
2059
  indexStatus: "indexStatus";
1985
2060
  googleCanonical: "googleCanonical";
1986
- coverageState: "coverageState";
1987
2061
  robotsTxtState: "robotsTxtState";
1988
2062
  indexingState: "indexingState";
1989
2063
  pageFetchState: "pageFetchState";
@@ -2030,9 +2104,9 @@ export declare const indexingHistoryResponseSchema: import("./core.js").Compatib
2030
2104
  }, z.core.$loose>, z.ZodObject<{
2031
2105
  _tag: z.ZodLiteral<"site">;
2032
2106
  field: z.ZodEnum<{
2107
+ coverageState: "coverageState";
2033
2108
  indexStatus: "indexStatus";
2034
2109
  googleCanonical: "googleCanonical";
2035
- coverageState: "coverageState";
2036
2110
  robotsTxtState: "robotsTxtState";
2037
2111
  indexingState: "indexingState";
2038
2112
  pageFetchState: "pageFetchState";
@@ -2050,9 +2124,9 @@ export declare const indexingHistoryResponseSchema: import("./core.js").Compatib
2050
2124
  readonly changes: z.ZodArray<z.ZodObject<{
2051
2125
  readonly url: z.ZodString;
2052
2126
  readonly field: z.ZodEnum<{
2127
+ coverageState: "coverageState";
2053
2128
  indexStatus: "indexStatus";
2054
2129
  googleCanonical: "googleCanonical";
2055
- coverageState: "coverageState";
2056
2130
  robotsTxtState: "robotsTxtState";
2057
2131
  indexingState: "indexingState";
2058
2132
  pageFetchState: "pageFetchState";
@@ -3519,6 +3593,19 @@ export declare const indexingDiagnosticsReadOperation: {
3519
3593
  readonly totalUrls: z.ZodNumber;
3520
3594
  readonly indexed: z.ZodNumber;
3521
3595
  readonly asOf: z.ZodNullable<z.ZodString>;
3596
+ /** Where `asOf` came from: `rollup` build time, `capture` (when gscdump counted the verdicts), or the `newest-check` URL inspection. Null when the age is unknown. */
3597
+ readonly asOfSource: z.ZodNullable<z.ZodEnum<{
3598
+ capture: "capture";
3599
+ "newest-check": "newest-check";
3600
+ rollup: "rollup";
3601
+ }>>;
3602
+ /** The oldest URL inspection behind these counts. With `asOf` it bounds the evidence age. Null when unknown. */
3603
+ readonly oldestCheckAt: z.ZodNullable<z.ZodString>;
3604
+ /** Share of the counted verdicts older than 7 and 30 days when `asOf` was set. Null when gscdump did not measure verdict age. */
3605
+ readonly verdictFreshness: z.ZodNullable<z.ZodObject<{
3606
+ olderThan7dPercent: z.ZodNumber;
3607
+ olderThan30dPercent: z.ZodNumber;
3608
+ }, z.core.$strip>>;
3522
3609
  readonly issues: z.ZodArray<z.ZodObject<{
3523
3610
  type: z.ZodString;
3524
3611
  label: z.ZodString;
@@ -3534,6 +3621,12 @@ export declare const indexingDiagnosticsReadOperation: {
3534
3621
  }, z.core.$strip>, z.ZodObject<{
3535
3622
  readonly view: z.ZodLiteral<"urls">;
3536
3623
  readonly total: z.ZodNumber;
3624
+ /** Lookahead reports a floor until the terminal page; it does not count every matching URL. */
3625
+ readonly totalSemantics: z.ZodEnum<{
3626
+ exact: "exact";
3627
+ "lower-bound": "lower-bound";
3628
+ unknown: "unknown";
3629
+ }>;
3537
3630
  readonly limit: z.ZodNumber;
3538
3631
  readonly offset: z.ZodNumber;
3539
3632
  readonly hasMore: z.ZodBoolean;
@@ -3558,6 +3651,19 @@ export declare const indexingDiagnosticsReadOperation: {
3558
3651
  readonly totalUrls: z.ZodNumber;
3559
3652
  readonly indexed: z.ZodNumber;
3560
3653
  readonly asOf: z.ZodNullable<z.ZodString>;
3654
+ /** Where `asOf` came from: `rollup` build time, `capture` (when gscdump counted the verdicts), or the `newest-check` URL inspection. Null when the age is unknown. */
3655
+ readonly asOfSource: z.ZodNullable<z.ZodEnum<{
3656
+ capture: "capture";
3657
+ "newest-check": "newest-check";
3658
+ rollup: "rollup";
3659
+ }>>;
3660
+ /** The oldest URL inspection behind these counts. With `asOf` it bounds the evidence age. Null when unknown. */
3661
+ readonly oldestCheckAt: z.ZodNullable<z.ZodString>;
3662
+ /** Share of the counted verdicts older than 7 and 30 days when `asOf` was set. Null when gscdump did not measure verdict age. */
3663
+ readonly verdictFreshness: z.ZodNullable<z.ZodObject<{
3664
+ olderThan7dPercent: z.ZodNumber;
3665
+ olderThan30dPercent: z.ZodNumber;
3666
+ }, z.core.$strip>>;
3561
3667
  readonly issues: z.ZodArray<z.ZodObject<{
3562
3668
  type: z.ZodString;
3563
3669
  label: z.ZodString;
@@ -3573,6 +3679,11 @@ export declare const indexingDiagnosticsReadOperation: {
3573
3679
  }, z.core.$strip>, z.ZodObject<{
3574
3680
  readonly view: z.ZodLiteral<"urls">;
3575
3681
  readonly total: z.ZodNumber;
3682
+ readonly totalSemantics: z.ZodEnum<{
3683
+ exact: "exact";
3684
+ "lower-bound": "lower-bound";
3685
+ unknown: "unknown";
3686
+ }>;
3576
3687
  readonly limit: z.ZodNumber;
3577
3688
  readonly offset: z.ZodNumber;
3578
3689
  readonly hasMore: z.ZodBoolean;
@@ -3621,6 +3732,12 @@ export declare const indexingDiagnosticsReadOperation: {
3621
3732
  readonly totalUrls: 100;
3622
3733
  readonly indexed: 92;
3623
3734
  readonly asOf: '2026-08-10T00:00:00.000Z';
3735
+ readonly asOfSource: 'newest-check';
3736
+ readonly oldestCheckAt: '2026-07-01T00:00:00.000Z';
3737
+ readonly verdictFreshness: {
3738
+ readonly olderThan7dPercent: 87.4;
3739
+ readonly olderThan30dPercent: 60.5;
3740
+ };
3624
3741
  readonly issues: readonly [];
3625
3742
  };
3626
3743
  readonly meta: {
@@ -3719,9 +3836,9 @@ export declare const indexingHistoryReadOperation: {
3719
3836
  readonly query: z.ZodObject<{
3720
3837
  url: z.ZodOptional<z.ZodString>;
3721
3838
  field: z.ZodOptional<z.ZodEnum<{
3839
+ coverageState: "coverageState";
3722
3840
  indexStatus: "indexStatus";
3723
3841
  googleCanonical: "googleCanonical";
3724
- coverageState: "coverageState";
3725
3842
  robotsTxtState: "robotsTxtState";
3726
3843
  indexingState: "indexingState";
3727
3844
  pageFetchState: "pageFetchState";
@@ -3740,9 +3857,9 @@ export declare const indexingHistoryReadOperation: {
3740
3857
  }, z.core.$strict>, z.ZodObject<{
3741
3858
  _tag: z.ZodLiteral<"site">;
3742
3859
  field: z.ZodEnum<{
3860
+ coverageState: "coverageState";
3743
3861
  indexStatus: "indexStatus";
3744
3862
  googleCanonical: "googleCanonical";
3745
- coverageState: "coverageState";
3746
3863
  robotsTxtState: "robotsTxtState";
3747
3864
  indexingState: "indexingState";
3748
3865
  pageFetchState: "pageFetchState";
@@ -3760,9 +3877,9 @@ export declare const indexingHistoryReadOperation: {
3760
3877
  readonly changes: z.ZodArray<z.ZodObject<{
3761
3878
  readonly url: z.ZodString;
3762
3879
  readonly field: z.ZodEnum<{
3880
+ coverageState: "coverageState";
3763
3881
  indexStatus: "indexStatus";
3764
3882
  googleCanonical: "googleCanonical";
3765
- coverageState: "coverageState";
3766
3883
  robotsTxtState: "robotsTxtState";
3767
3884
  indexingState: "indexingState";
3768
3885
  pageFetchState: "pageFetchState";
@@ -3809,9 +3926,9 @@ export declare const indexingHistoryReadOperation: {
3809
3926
  }, z.core.$loose>, z.ZodObject<{
3810
3927
  _tag: z.ZodLiteral<"site">;
3811
3928
  field: z.ZodEnum<{
3929
+ coverageState: "coverageState";
3812
3930
  indexStatus: "indexStatus";
3813
3931
  googleCanonical: "googleCanonical";
3814
- coverageState: "coverageState";
3815
3932
  robotsTxtState: "robotsTxtState";
3816
3933
  indexingState: "indexingState";
3817
3934
  pageFetchState: "pageFetchState";
@@ -3829,9 +3946,9 @@ export declare const indexingHistoryReadOperation: {
3829
3946
  readonly changes: z.ZodArray<z.ZodObject<{
3830
3947
  readonly url: z.ZodString;
3831
3948
  readonly field: z.ZodEnum<{
3949
+ coverageState: "coverageState";
3832
3950
  indexStatus: "indexStatus";
3833
3951
  googleCanonical: "googleCanonical";
3834
- coverageState: "coverageState";
3835
3952
  robotsTxtState: "robotsTxtState";
3836
3953
  indexingState: "indexingState";
3837
3954
  pageFetchState: "pageFetchState";
@@ -4211,7 +4328,7 @@ export declare const indexCohortsDataSchema: import("./core.js").CompatibleRespo
4211
4328
  }, z.core.$strict>>;
4212
4329
  readonly coverage: z.ZodNullable<z.ZodObject<{
4213
4330
  analysed: z.ZodNumber;
4214
- notIndexedButNeverCrawled: z.ZodNumber;
4331
+ notIndexedNotInCrawl: z.ZodNumber;
4215
4332
  excludedFragments: z.ZodNumber;
4216
4333
  }, z.core.$strict>>;
4217
4334
  readonly method: z.ZodNullable<z.ZodString>;
@@ -4259,7 +4376,7 @@ export declare const indexCohortsDataSchema: import("./core.js").CompatibleRespo
4259
4376
  }, z.core.$loose>>;
4260
4377
  readonly coverage: z.ZodNullable<z.ZodObject<{
4261
4378
  analysed: z.ZodNumber;
4262
- notIndexedButNeverCrawled: z.ZodNumber;
4379
+ notIndexedNotInCrawl: z.ZodNumber;
4263
4380
  excludedFragments: z.ZodNumber;
4264
4381
  }, z.core.$loose>>;
4265
4382
  readonly method: z.ZodNullable<z.ZodString>;
@@ -4302,7 +4419,7 @@ export declare const indexCohortsResponseEnvelopeSchema: import("./core.js").Com
4302
4419
  }, z.core.$strict>>;
4303
4420
  readonly coverage: z.ZodNullable<z.ZodObject<{
4304
4421
  analysed: z.ZodNumber;
4305
- notIndexedButNeverCrawled: z.ZodNumber;
4422
+ notIndexedNotInCrawl: z.ZodNumber;
4306
4423
  excludedFragments: z.ZodNumber;
4307
4424
  }, z.core.$strict>>;
4308
4425
  readonly method: z.ZodNullable<z.ZodString>;
@@ -4356,7 +4473,7 @@ export declare const indexCohortsResponseEnvelopeSchema: import("./core.js").Com
4356
4473
  }, z.core.$loose>>;
4357
4474
  readonly coverage: z.ZodNullable<z.ZodObject<{
4358
4475
  analysed: z.ZodNumber;
4359
- notIndexedButNeverCrawled: z.ZodNumber;
4476
+ notIndexedNotInCrawl: z.ZodNumber;
4360
4477
  excludedFragments: z.ZodNumber;
4361
4478
  }, z.core.$loose>>;
4362
4479
  readonly method: z.ZodNullable<z.ZodString>;
@@ -4434,7 +4551,7 @@ export declare const indexCohortsReadOperation: {
4434
4551
  }, z.core.$strict>>;
4435
4552
  readonly coverage: z.ZodNullable<z.ZodObject<{
4436
4553
  analysed: z.ZodNumber;
4437
- notIndexedButNeverCrawled: z.ZodNumber;
4554
+ notIndexedNotInCrawl: z.ZodNumber;
4438
4555
  excludedFragments: z.ZodNumber;
4439
4556
  }, z.core.$strict>>;
4440
4557
  readonly method: z.ZodNullable<z.ZodString>;
@@ -4488,7 +4605,7 @@ export declare const indexCohortsReadOperation: {
4488
4605
  }, z.core.$loose>>;
4489
4606
  readonly coverage: z.ZodNullable<z.ZodObject<{
4490
4607
  analysed: z.ZodNumber;
4491
- notIndexedButNeverCrawled: z.ZodNumber;
4608
+ notIndexedNotInCrawl: z.ZodNumber;
4492
4609
  excludedFragments: z.ZodNumber;
4493
4610
  }, z.core.$loose>>;
4494
4611
  readonly method: z.ZodNullable<z.ZodString>;
@@ -4623,7 +4740,7 @@ export declare const indexCohortsReadOperation: {
4623
4740
  };
4624
4741
  readonly coverage: {
4625
4742
  readonly analysed: 1200;
4626
- readonly notIndexedButNeverCrawled: 40;
4743
+ readonly notIndexedNotInCrawl: 40;
4627
4744
  readonly excludedFragments: 2;
4628
4745
  };
4629
4746
  readonly method: 'Wilson score interval per family against its own complement, Bonferroni-corrected across 9 tested families (critical value z=2.77).';
@@ -5906,6 +6023,19 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
5906
6023
  readonly totalUrls: z.ZodNumber;
5907
6024
  readonly indexed: z.ZodNumber;
5908
6025
  readonly asOf: z.ZodNullable<z.ZodString>;
6026
+ /** Where `asOf` came from: `rollup` build time, `capture` (when gscdump counted the verdicts), or the `newest-check` URL inspection. Null when the age is unknown. */
6027
+ readonly asOfSource: z.ZodNullable<z.ZodEnum<{
6028
+ capture: "capture";
6029
+ "newest-check": "newest-check";
6030
+ rollup: "rollup";
6031
+ }>>;
6032
+ /** The oldest URL inspection behind these counts. With `asOf` it bounds the evidence age. Null when unknown. */
6033
+ readonly oldestCheckAt: z.ZodNullable<z.ZodString>;
6034
+ /** Share of the counted verdicts older than 7 and 30 days when `asOf` was set. Null when gscdump did not measure verdict age. */
6035
+ readonly verdictFreshness: z.ZodNullable<z.ZodObject<{
6036
+ olderThan7dPercent: z.ZodNumber;
6037
+ olderThan30dPercent: z.ZodNumber;
6038
+ }, z.core.$strip>>;
5909
6039
  readonly issues: z.ZodArray<z.ZodObject<{
5910
6040
  type: z.ZodString;
5911
6041
  label: z.ZodString;
@@ -5921,6 +6051,12 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
5921
6051
  }, z.core.$strip>, z.ZodObject<{
5922
6052
  readonly view: z.ZodLiteral<"urls">;
5923
6053
  readonly total: z.ZodNumber;
6054
+ /** Lookahead reports a floor until the terminal page; it does not count every matching URL. */
6055
+ readonly totalSemantics: z.ZodEnum<{
6056
+ exact: "exact";
6057
+ "lower-bound": "lower-bound";
6058
+ unknown: "unknown";
6059
+ }>;
5924
6060
  readonly limit: z.ZodNumber;
5925
6061
  readonly offset: z.ZodNumber;
5926
6062
  readonly hasMore: z.ZodBoolean;
@@ -5945,6 +6081,19 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
5945
6081
  readonly totalUrls: z.ZodNumber;
5946
6082
  readonly indexed: z.ZodNumber;
5947
6083
  readonly asOf: z.ZodNullable<z.ZodString>;
6084
+ /** Where `asOf` came from: `rollup` build time, `capture` (when gscdump counted the verdicts), or the `newest-check` URL inspection. Null when the age is unknown. */
6085
+ readonly asOfSource: z.ZodNullable<z.ZodEnum<{
6086
+ capture: "capture";
6087
+ "newest-check": "newest-check";
6088
+ rollup: "rollup";
6089
+ }>>;
6090
+ /** The oldest URL inspection behind these counts. With `asOf` it bounds the evidence age. Null when unknown. */
6091
+ readonly oldestCheckAt: z.ZodNullable<z.ZodString>;
6092
+ /** Share of the counted verdicts older than 7 and 30 days when `asOf` was set. Null when gscdump did not measure verdict age. */
6093
+ readonly verdictFreshness: z.ZodNullable<z.ZodObject<{
6094
+ olderThan7dPercent: z.ZodNumber;
6095
+ olderThan30dPercent: z.ZodNumber;
6096
+ }, z.core.$strip>>;
5948
6097
  readonly issues: z.ZodArray<z.ZodObject<{
5949
6098
  type: z.ZodString;
5950
6099
  label: z.ZodString;
@@ -5960,6 +6109,11 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
5960
6109
  }, z.core.$strip>, z.ZodObject<{
5961
6110
  readonly view: z.ZodLiteral<"urls">;
5962
6111
  readonly total: z.ZodNumber;
6112
+ readonly totalSemantics: z.ZodEnum<{
6113
+ exact: "exact";
6114
+ "lower-bound": "lower-bound";
6115
+ unknown: "unknown";
6116
+ }>;
5963
6117
  readonly limit: z.ZodNumber;
5964
6118
  readonly offset: z.ZodNumber;
5965
6119
  readonly hasMore: z.ZodBoolean;
@@ -6008,6 +6162,12 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
6008
6162
  readonly totalUrls: 100;
6009
6163
  readonly indexed: 92;
6010
6164
  readonly asOf: '2026-08-10T00:00:00.000Z';
6165
+ readonly asOfSource: 'newest-check';
6166
+ readonly oldestCheckAt: '2026-07-01T00:00:00.000Z';
6167
+ readonly verdictFreshness: {
6168
+ readonly olderThan7dPercent: 87.4;
6169
+ readonly olderThan30dPercent: 60.5;
6170
+ };
6011
6171
  readonly issues: readonly [];
6012
6172
  };
6013
6173
  readonly meta: {
@@ -6106,9 +6266,9 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
6106
6266
  readonly query: z.ZodObject<{
6107
6267
  url: z.ZodOptional<z.ZodString>;
6108
6268
  field: z.ZodOptional<z.ZodEnum<{
6269
+ coverageState: "coverageState";
6109
6270
  indexStatus: "indexStatus";
6110
6271
  googleCanonical: "googleCanonical";
6111
- coverageState: "coverageState";
6112
6272
  robotsTxtState: "robotsTxtState";
6113
6273
  indexingState: "indexingState";
6114
6274
  pageFetchState: "pageFetchState";
@@ -6127,9 +6287,9 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
6127
6287
  }, z.core.$strict>, z.ZodObject<{
6128
6288
  _tag: z.ZodLiteral<"site">;
6129
6289
  field: z.ZodEnum<{
6290
+ coverageState: "coverageState";
6130
6291
  indexStatus: "indexStatus";
6131
6292
  googleCanonical: "googleCanonical";
6132
- coverageState: "coverageState";
6133
6293
  robotsTxtState: "robotsTxtState";
6134
6294
  indexingState: "indexingState";
6135
6295
  pageFetchState: "pageFetchState";
@@ -6147,9 +6307,9 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
6147
6307
  readonly changes: z.ZodArray<z.ZodObject<{
6148
6308
  readonly url: z.ZodString;
6149
6309
  readonly field: z.ZodEnum<{
6310
+ coverageState: "coverageState";
6150
6311
  indexStatus: "indexStatus";
6151
6312
  googleCanonical: "googleCanonical";
6152
- coverageState: "coverageState";
6153
6313
  robotsTxtState: "robotsTxtState";
6154
6314
  indexingState: "indexingState";
6155
6315
  pageFetchState: "pageFetchState";
@@ -6196,9 +6356,9 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
6196
6356
  }, z.core.$loose>, z.ZodObject<{
6197
6357
  _tag: z.ZodLiteral<"site">;
6198
6358
  field: z.ZodEnum<{
6359
+ coverageState: "coverageState";
6199
6360
  indexStatus: "indexStatus";
6200
6361
  googleCanonical: "googleCanonical";
6201
- coverageState: "coverageState";
6202
6362
  robotsTxtState: "robotsTxtState";
6203
6363
  indexingState: "indexingState";
6204
6364
  pageFetchState: "pageFetchState";
@@ -6216,9 +6376,9 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
6216
6376
  readonly changes: z.ZodArray<z.ZodObject<{
6217
6377
  readonly url: z.ZodString;
6218
6378
  readonly field: z.ZodEnum<{
6379
+ coverageState: "coverageState";
6219
6380
  indexStatus: "indexStatus";
6220
6381
  googleCanonical: "googleCanonical";
6221
- coverageState: "coverageState";
6222
6382
  robotsTxtState: "robotsTxtState";
6223
6383
  indexingState: "indexingState";
6224
6384
  pageFetchState: "pageFetchState";
@@ -6569,7 +6729,7 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
6569
6729
  }, z.core.$strict>>;
6570
6730
  readonly coverage: z.ZodNullable<z.ZodObject<{
6571
6731
  analysed: z.ZodNumber;
6572
- notIndexedButNeverCrawled: z.ZodNumber;
6732
+ notIndexedNotInCrawl: z.ZodNumber;
6573
6733
  excludedFragments: z.ZodNumber;
6574
6734
  }, z.core.$strict>>;
6575
6735
  readonly method: z.ZodNullable<z.ZodString>;
@@ -6623,7 +6783,7 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
6623
6783
  }, z.core.$loose>>;
6624
6784
  readonly coverage: z.ZodNullable<z.ZodObject<{
6625
6785
  analysed: z.ZodNumber;
6626
- notIndexedButNeverCrawled: z.ZodNumber;
6786
+ notIndexedNotInCrawl: z.ZodNumber;
6627
6787
  excludedFragments: z.ZodNumber;
6628
6788
  }, z.core.$loose>>;
6629
6789
  readonly method: z.ZodNullable<z.ZodString>;
@@ -6758,7 +6918,7 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
6758
6918
  };
6759
6919
  readonly coverage: {
6760
6920
  readonly analysed: 1200;
6761
- readonly notIndexedButNeverCrawled: 40;
6921
+ readonly notIndexedNotInCrawl: 40;
6762
6922
  readonly excludedFragments: 2;
6763
6923
  };
6764
6924
  readonly method: 'Wilson score interval per family against its own complement, Bonferroni-corrected across 9 tested families (critical value z=2.77).';
package/dist/v1/gsc.js CHANGED
@@ -342,12 +342,24 @@ const diagnosticsSummaryDataSchema = defineResponseObject({
342
342
  totalUrls: schema.number().int().nonnegative(),
343
343
  indexed: schema.number().int().nonnegative(),
344
344
  asOf: schema.string().datetime().nullable(),
345
+ /** Where `asOf` came from: `rollup` build time, `capture` (when gscdump counted the verdicts), or the `newest-check` URL inspection. Null when the age is unknown. */
346
+ asOfSource: schema.enum(['rollup', 'capture', 'newest-check']).nullable(),
347
+ /** The oldest URL inspection behind these counts. With `asOf` it bounds the evidence age. Null when unknown. */
348
+ oldestCheckAt: schema.string().datetime().nullable(),
349
+ /** Share of the counted verdicts older than 7 and 30 days when `asOf` was set. Null when gscdump did not measure verdict age. */
350
+ verdictFreshness: schema.object({ olderThan7dPercent: schema.number().min(0).max(100), olderThan30dPercent: schema.number().min(0).max(100) }).nullable(),
345
351
  issues: schema.array(issueSchema.producer),
346
352
  }, {
347
353
  view: schema.literal('summary'),
348
354
  totalUrls: schema.number().int().nonnegative(),
349
355
  indexed: schema.number().int().nonnegative(),
350
356
  asOf: schema.string().datetime().nullable(),
357
+ /** Where `asOf` came from: `rollup` build time, `capture` (when gscdump counted the verdicts), or the `newest-check` URL inspection. Null when the age is unknown. */
358
+ asOfSource: schema.enum(['rollup', 'capture', 'newest-check']).nullable(),
359
+ /** The oldest URL inspection behind these counts. With `asOf` it bounds the evidence age. Null when unknown. */
360
+ oldestCheckAt: schema.string().datetime().nullable(),
361
+ /** Share of the counted verdicts older than 7 and 30 days when `asOf` was set. Null when gscdump did not measure verdict age. */
362
+ verdictFreshness: schema.object({ olderThan7dPercent: schema.number().min(0).max(100), olderThan30dPercent: schema.number().min(0).max(100) }).nullable(),
351
363
  issues: schema.array(issueSchema.client),
352
364
  });
353
365
  const diagnosticsUrlSchema = defineResponseObject({
@@ -363,6 +375,8 @@ const diagnosticsUrlSchema = defineResponseObject({
363
375
  const diagnosticsUrlsDataSchema = defineResponseObject({
364
376
  view: schema.literal('urls'),
365
377
  total: schema.number().int().nonnegative(),
378
+ /** Lookahead reports a floor until the terminal page; it does not count every matching URL. */
379
+ totalSemantics: schema.enum(['exact', 'lower-bound', 'unknown']),
366
380
  limit: schema.number().int().positive(),
367
381
  offset: schema.number().int().nonnegative(),
368
382
  hasMore: schema.boolean(),
@@ -370,6 +384,7 @@ const diagnosticsUrlsDataSchema = defineResponseObject({
370
384
  }, {
371
385
  view: schema.literal('urls'),
372
386
  total: schema.number().int().nonnegative(),
387
+ totalSemantics: schema.enum(['exact', 'lower-bound', 'unknown']),
373
388
  limit: schema.number().int().positive(),
374
389
  offset: schema.number().int().nonnegative(),
375
390
  hasMore: schema.boolean(),
@@ -572,7 +587,7 @@ export const indexingDiagnosticsReadOperation = defineOperation({
572
587
  summary: 'Diagnose Site indexing',
573
588
  description: 'Returns indexed coverage and issue counts, or one filtered page of affected URLs, from retained Search Console evidence.',
574
589
  tags: ['Sites', 'Search', 'Indexing'],
575
- examples: [{ request: { params: { siteId: 'site_01JXYZ' }, query: { view: 'summary' } }, response: { status: 200, body: { data: { view: 'summary', totalUrls: 100, indexed: 92, asOf: '2026-08-10T00:00:00.000Z', issues: [] }, meta: { requestId: 'req_01JXYZ', version: '1.0' } } } }],
590
+ examples: [{ request: { params: { siteId: 'site_01JXYZ' }, query: { view: 'summary' } }, response: { status: 200, body: { data: { view: 'summary', totalUrls: 100, indexed: 92, asOf: '2026-08-10T00:00:00.000Z', asOfSource: 'newest-check', oldestCheckAt: '2026-07-01T00:00:00.000Z', verdictFreshness: { olderThan7dPercent: 87.4, olderThan30dPercent: 60.5 }, issues: [] }, meta: { requestId: 'req_01JXYZ', version: '1.0' } } } }],
576
591
  },
577
592
  });
578
593
  export const indexingHistoryReadOperation = defineOperation({
@@ -663,7 +678,7 @@ const cohortBaselineShape = {
663
678
  };
664
679
  const cohortCoverageShape = {
665
680
  analysed: schema.number().int().nonnegative(),
666
- notIndexedButNeverCrawled: schema.number().int().nonnegative(),
681
+ notIndexedNotInCrawl: schema.number().int().nonnegative(),
667
682
  excludedFragments: schema.number().int().nonnegative(),
668
683
  };
669
684
  /**
@@ -759,7 +774,7 @@ export const indexCohortsReadOperation = defineOperation({
759
774
  message: null,
760
775
  asOf: '2026-09-01T00:00:00.000Z',
761
776
  baseline: { pages: 1200, notIndexed: 180, notIndexedPercent: 15 },
762
- coverage: { analysed: 1200, notIndexedButNeverCrawled: 40, excludedFragments: 2 },
777
+ coverage: { analysed: 1200, notIndexedNotInCrawl: 40, excludedFragments: 2 },
763
778
  method: 'Wilson score interval per family against its own complement, Bonferroni-corrected across 9 tested families (critical value z=2.77).',
764
779
  familiesTested: 9,
765
780
  established: [{