seo 0.4.0 → 0.4.2

package/dist/index.d.ts

@@ -3538,10 +3538,10 @@ declare const crawlPageSnapshotSchema: z.ZodObject<{
     raw: z.ZodString;
     resolved: z.ZodOptional<z.ZodString>;
     ignoredReason: z.ZodOptional<z.ZodEnum<{
+      "invalid-url": "invalid-url";
       "outside-head": "outside-head";
       "alternate-qualifier": "alternate-qualifier";
       fragment: "fragment";
-      "invalid-url": "invalid-url";
       "non-http-url": "non-http-url";
     }>>;
     streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -4175,15 +4175,15 @@ declare const crawlReportSummarySchema: z.ZodObject<{
   skippedUrls: z.ZodNumber;
   skipReasons: z.ZodArray<z.ZodObject<{
     reason: z.ZodEnum<{
-      "invalid-url": "invalid-url";
-      "robots-disallowed": "robots-disallowed";
-      "origin-backpressure": "origin-backpressure";
       "asset-url": "asset-url";
       "configured-exclusion": "configured-exclusion";
       "duplicate-normalization": "duplicate-normalization";
+      "invalid-url": "invalid-url";
       "memory-pressure": "memory-pressure";
       "off-origin": "off-origin";
+      "origin-backpressure": "origin-backpressure";
       "queue-safety-limit": "queue-safety-limit";
+      "robots-disallowed": "robots-disallowed";
       "robots-uncertain": "robots-uncertain";
       "legacy-unclassified": "legacy-unclassified";
     }>;
@@ -4341,15 +4341,15 @@ declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     skippedUrls: z.ZodNumber;
     skipReasons: z.ZodArray<z.ZodObject<{
       reason: z.ZodEnum<{
-        "invalid-url": "invalid-url";
-        "robots-disallowed": "robots-disallowed";
-        "origin-backpressure": "origin-backpressure";
         "asset-url": "asset-url";
         "configured-exclusion": "configured-exclusion";
         "duplicate-normalization": "duplicate-normalization";
+        "invalid-url": "invalid-url";
         "memory-pressure": "memory-pressure";
         "off-origin": "off-origin";
+        "origin-backpressure": "origin-backpressure";
         "queue-safety-limit": "queue-safety-limit";
+        "robots-disallowed": "robots-disallowed";
         "robots-uncertain": "robots-uncertain";
         "legacy-unclassified": "legacy-unclassified";
       }>;
@@ -4721,10 +4721,10 @@ declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       raw: z.ZodString;
       resolved: z.ZodOptional<z.ZodString>;
       ignoredReason: z.ZodOptional<z.ZodEnum<{
+        "invalid-url": "invalid-url";
         "outside-head": "outside-head";
         "alternate-qualifier": "alternate-qualifier";
         fragment: "fragment";
-        "invalid-url": "invalid-url";
         "non-http-url": "non-http-url";
       }>>;
       streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -5583,15 +5583,15 @@ declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     skippedUrls: z.ZodNumber;
     skipReasons: z.ZodArray<z.ZodObject<{
       reason: z.ZodEnum<{
-        "invalid-url": "invalid-url";
-        "robots-disallowed": "robots-disallowed";
-        "origin-backpressure": "origin-backpressure";
         "asset-url": "asset-url";
         "configured-exclusion": "configured-exclusion";
         "duplicate-normalization": "duplicate-normalization";
+        "invalid-url": "invalid-url";
         "memory-pressure": "memory-pressure";
         "off-origin": "off-origin";
+        "origin-backpressure": "origin-backpressure";
         "queue-safety-limit": "queue-safety-limit";
+        "robots-disallowed": "robots-disallowed";
         "robots-uncertain": "robots-uncertain";
         "legacy-unclassified": "legacy-unclassified";
       }>;
@@ -5963,10 +5963,10 @@ declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       raw: z.ZodString;
       resolved: z.ZodOptional<z.ZodString>;
       ignoredReason: z.ZodOptional<z.ZodEnum<{
+        "invalid-url": "invalid-url";
         "outside-head": "outside-head";
         "alternate-qualifier": "alternate-qualifier";
         fragment: "fragment";
-        "invalid-url": "invalid-url";
         "non-http-url": "non-http-url";
       }>>;
       streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -6825,15 +6825,15 @@ declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     skippedUrls: z.ZodNumber;
     skipReasons: z.ZodArray<z.ZodObject<{
       reason: z.ZodEnum<{
-        "invalid-url": "invalid-url";
-        "robots-disallowed": "robots-disallowed";
-        "origin-backpressure": "origin-backpressure";
         "asset-url": "asset-url";
         "configured-exclusion": "configured-exclusion";
         "duplicate-normalization": "duplicate-normalization";
+        "invalid-url": "invalid-url";
         "memory-pressure": "memory-pressure";
         "off-origin": "off-origin";
+        "origin-backpressure": "origin-backpressure";
         "queue-safety-limit": "queue-safety-limit";
+        "robots-disallowed": "robots-disallowed";
         "robots-uncertain": "robots-uncertain";
         "legacy-unclassified": "legacy-unclassified";
       }>;
@@ -7205,10 +7205,10 @@ declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       raw: z.ZodString;
       resolved: z.ZodOptional<z.ZodString>;
       ignoredReason: z.ZodOptional<z.ZodEnum<{
+        "invalid-url": "invalid-url";
         "outside-head": "outside-head";
         "alternate-qualifier": "alternate-qualifier";
         fragment: "fragment";
-        "invalid-url": "invalid-url";
         "non-http-url": "non-http-url";
       }>>;
       streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -8069,15 +8069,15 @@ declare const crawlerSchemas: {
       skippedUrls: z.ZodNumber;
       skipReasons: z.ZodArray<z.ZodObject<{
         reason: z.ZodEnum<{
-          "invalid-url": "invalid-url";
-          "robots-disallowed": "robots-disallowed";
-          "origin-backpressure": "origin-backpressure";
           "asset-url": "asset-url";
           "configured-exclusion": "configured-exclusion";
           "duplicate-normalization": "duplicate-normalization";
+          "invalid-url": "invalid-url";
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
+          "origin-backpressure": "origin-backpressure";
           "queue-safety-limit": "queue-safety-limit";
+          "robots-disallowed": "robots-disallowed";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -8449,10 +8449,10 @@ declare const crawlerSchemas: {
         raw: z.ZodString;
         resolved: z.ZodOptional<z.ZodString>;
         ignoredReason: z.ZodOptional<z.ZodEnum<{
+          "invalid-url": "invalid-url";
           "outside-head": "outside-head";
           "alternate-qualifier": "alternate-qualifier";
           fragment: "fragment";
-          "invalid-url": "invalid-url";
           "non-http-url": "non-http-url";
         }>>;
         streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -9311,15 +9311,15 @@ declare const crawlerSchemas: {
       skippedUrls: z.ZodNumber;
       skipReasons: z.ZodArray<z.ZodObject<{
         reason: z.ZodEnum<{
-          "invalid-url": "invalid-url";
-          "robots-disallowed": "robots-disallowed";
-          "origin-backpressure": "origin-backpressure";
           "asset-url": "asset-url";
           "configured-exclusion": "configured-exclusion";
           "duplicate-normalization": "duplicate-normalization";
+          "invalid-url": "invalid-url";
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
+          "origin-backpressure": "origin-backpressure";
           "queue-safety-limit": "queue-safety-limit";
+          "robots-disallowed": "robots-disallowed";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -9691,10 +9691,10 @@ declare const crawlerSchemas: {
         raw: z.ZodString;
         resolved: z.ZodOptional<z.ZodString>;
         ignoredReason: z.ZodOptional<z.ZodEnum<{
+          "invalid-url": "invalid-url";
           "outside-head": "outside-head";
           "alternate-qualifier": "alternate-qualifier";
           fragment: "fragment";
-          "invalid-url": "invalid-url";
           "non-http-url": "non-http-url";
         }>>;
         streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -10553,15 +10553,15 @@ declare const crawlerSchemas: {
       skippedUrls: z.ZodNumber;
       skipReasons: z.ZodArray<z.ZodObject<{
         reason: z.ZodEnum<{
-          "invalid-url": "invalid-url";
-          "robots-disallowed": "robots-disallowed";
-          "origin-backpressure": "origin-backpressure";
           "asset-url": "asset-url";
           "configured-exclusion": "configured-exclusion";
           "duplicate-normalization": "duplicate-normalization";
+          "invalid-url": "invalid-url";
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
+          "origin-backpressure": "origin-backpressure";
           "queue-safety-limit": "queue-safety-limit";
+          "robots-disallowed": "robots-disallowed";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -10933,10 +10933,10 @@ declare const crawlerSchemas: {
         raw: z.ZodString;
         resolved: z.ZodOptional<z.ZodString>;
         ignoredReason: z.ZodOptional<z.ZodEnum<{
+          "invalid-url": "invalid-url";
           "outside-head": "outside-head";
           "alternate-qualifier": "alternate-qualifier";
           fragment: "fragment";
-          "invalid-url": "invalid-url";
           "non-http-url": "non-http-url";
         }>>;
         streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -12299,10 +12299,10 @@ declare const crawlerSchemas: {
       raw: z.ZodString;
       resolved: z.ZodOptional<z.ZodString>;
       ignoredReason: z.ZodOptional<z.ZodEnum<{
+        "invalid-url": "invalid-url";
         "outside-head": "outside-head";
         "alternate-qualifier": "alternate-qualifier";
         fragment: "fragment";
-        "invalid-url": "invalid-url";
         "non-http-url": "non-http-url";
       }>>;
       streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -12723,15 +12723,15 @@ declare const crawlerJsonSchemas: {
       skippedUrls: z.ZodNumber;
       skipReasons: z.ZodArray<z.ZodObject<{
         reason: z.ZodEnum<{
-          "invalid-url": "invalid-url";
-          "robots-disallowed": "robots-disallowed";
-          "origin-backpressure": "origin-backpressure";
           "asset-url": "asset-url";
           "configured-exclusion": "configured-exclusion";
           "duplicate-normalization": "duplicate-normalization";
+          "invalid-url": "invalid-url";
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
+          "origin-backpressure": "origin-backpressure";
           "queue-safety-limit": "queue-safety-limit";
+          "robots-disallowed": "robots-disallowed";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -13103,10 +13103,10 @@ declare const crawlerJsonSchemas: {
         raw: z.ZodString;
         resolved: z.ZodOptional<z.ZodString>;
         ignoredReason: z.ZodOptional<z.ZodEnum<{
+          "invalid-url": "invalid-url";
           "outside-head": "outside-head";
           "alternate-qualifier": "alternate-qualifier";
           fragment: "fragment";
-          "invalid-url": "invalid-url";
           "non-http-url": "non-http-url";
         }>>;
         streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -13965,15 +13965,15 @@ declare const crawlerJsonSchemas: {
       skippedUrls: z.ZodNumber;
       skipReasons: z.ZodArray<z.ZodObject<{
         reason: z.ZodEnum<{
-          "invalid-url": "invalid-url";
-          "robots-disallowed": "robots-disallowed";
-          "origin-backpressure": "origin-backpressure";
           "asset-url": "asset-url";
           "configured-exclusion": "configured-exclusion";
           "duplicate-normalization": "duplicate-normalization";
+          "invalid-url": "invalid-url";
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
+          "origin-backpressure": "origin-backpressure";
           "queue-safety-limit": "queue-safety-limit";
+          "robots-disallowed": "robots-disallowed";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -14345,10 +14345,10 @@ declare const crawlerJsonSchemas: {
         raw: z.ZodString;
         resolved: z.ZodOptional<z.ZodString>;
         ignoredReason: z.ZodOptional<z.ZodEnum<{
+          "invalid-url": "invalid-url";
           "outside-head": "outside-head";
           "alternate-qualifier": "alternate-qualifier";
           fragment: "fragment";
-          "invalid-url": "invalid-url";
           "non-http-url": "non-http-url";
         }>>;
         streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -15207,15 +15207,15 @@ declare const crawlerJsonSchemas: {
       skippedUrls: z.ZodNumber;
       skipReasons: z.ZodArray<z.ZodObject<{
         reason: z.ZodEnum<{
-          "invalid-url": "invalid-url";
-          "robots-disallowed": "robots-disallowed";
-          "origin-backpressure": "origin-backpressure";
           "asset-url": "asset-url";
           "configured-exclusion": "configured-exclusion";
           "duplicate-normalization": "duplicate-normalization";
+          "invalid-url": "invalid-url";
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
+          "origin-backpressure": "origin-backpressure";
           "queue-safety-limit": "queue-safety-limit";
+          "robots-disallowed": "robots-disallowed";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -15587,10 +15587,10 @@ declare const crawlerJsonSchemas: {
         raw: z.ZodString;
         resolved: z.ZodOptional<z.ZodString>;
         ignoredReason: z.ZodOptional<z.ZodEnum<{
+          "invalid-url": "invalid-url";
           "outside-head": "outside-head";
           "alternate-qualifier": "alternate-qualifier";
           fragment: "fragment";
-          "invalid-url": "invalid-url";
           "non-http-url": "non-http-url";
         }>>;
         streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -16953,10 +16953,10 @@ declare const crawlerJsonSchemas: {
       raw: z.ZodString;
       resolved: z.ZodOptional<z.ZodString>;
       ignoredReason: z.ZodOptional<z.ZodEnum<{
+        "invalid-url": "invalid-url";
         "outside-head": "outside-head";
         "alternate-qualifier": "alternate-qualifier";
         fragment: "fragment";
-        "invalid-url": "invalid-url";
         "non-http-url": "non-http-url";
       }>>;
       streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -19080,12 +19080,13 @@ interface TrafficAnomaly {
 /** The step-change heuristic and its thresholds, returned with the report. */
 declare const STEP_CHANGE_RULES: {
   readonly method: "best-split";
-  readonly description: "Heuristic. The change date is the split of the daily series where the mean before and the mean after differ most, weighted by segment length. It counts as a step change only when it is sudden and sustained. Sudden: the median of up to localDays observed days after the date differs from the median of up to localDays days before it by at least minLocalShiftInStdDevs pooled within-segment standard deviations, so one unusual day is not a step and a slow trend is not a step. Sustained: the mean of every day from the date differs from the mean before it by a z-score of at least minZScore, stricter than the recent-window test because the date is chosen from the data. Otherwise the last recentDays are compared with the days before them.";
+  readonly description: "Heuristic. The change date is the split of the daily series where the mean before and the mean after differ most, weighted by segment length. It counts as a step change only when it is sudden and sustained. Sudden: the median of up to localDays observed days after the date differs from the median of up to localDays days before it by at least minLocalShiftInStdDevs pooled within-segment standard deviations, so one unusual day is not a step and a slow trend is not a step. Sustained: the mean of every day from the date differs from the mean before it by a z-score of at least minZScore, stricter than the recent-window test because the date is chosen from the data. These tests use daily values capped at the capDays and 1 - capDays quantiles, so one spike day cannot hide a lasting step. Otherwise the last recentDays are compared with the days before them.";
   readonly minDaysBefore: 7;
   readonly minDaysAfter: 3;
   readonly localDays: 7;
   readonly minLocalShiftInStdDevs: 2;
   readonly minZScore: 3;
+  readonly capDays: 0.05;
 };
 type TrafficAnomalyDetection = typeof STEP_CHANGE_RULES & {
   recentDays: number;

package/dist/index.js

@@ -1,5 +1,5 @@
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import { n as load, t as version } from "./package-BfqlCbxN.js";
+import { n as load, t as version } from "./package-D46BDwUk.js";
 import { SEO_PROVIDER_API_VERSION } from "./provider-sdk.js";
 import crypto, { createHash, randomUUID, sign } from "node:crypto";
 import { z } from "zod";
@@ -8341,7 +8341,7 @@ const TOPIC_WORDS = /* @__PURE__ */ new Set([
 	"free",
 	"guide",
 	"how",
-	"inference",
+	"example",
 	"install",
 	"integration",
 	"local",
@@ -20251,12 +20251,13 @@ async function listSearchUpdates(input = {}) {
 /** The step-change heuristic and its thresholds, returned with the report. */
 const STEP_CHANGE_RULES = {
 	method: "best-split",
-	description: "Heuristic. The change date is the split of the daily series where the mean before and the mean after differ most, weighted by segment length. It counts as a step change only when it is sudden and sustained. Sudden: the median of up to localDays observed days after the date differs from the median of up to localDays days before it by at least minLocalShiftInStdDevs pooled within-segment standard deviations, so one unusual day is not a step and a slow trend is not a step. Sustained: the mean of every day from the date differs from the mean before it by a z-score of at least minZScore, stricter than the recent-window test because the date is chosen from the data. Otherwise the last recentDays are compared with the days before them.",
+	description: "Heuristic. The change date is the split of the daily series where the mean before and the mean after differ most, weighted by segment length. It counts as a step change only when it is sudden and sustained. Sudden: the median of up to localDays observed days after the date differs from the median of up to localDays days before it by at least minLocalShiftInStdDevs pooled within-segment standard deviations, so one unusual day is not a step and a slow trend is not a step. Sustained: the mean of every day from the date differs from the mean before it by a z-score of at least minZScore, stricter than the recent-window test because the date is chosen from the data. These tests use daily values capped at the capDays and 1 - capDays quantiles, so one spike day cannot hide a lasting step. Otherwise the last recentDays are compared with the days before them.",
 	minDaysBefore: 7,
 	minDaysAfter: 3,
 	localDays: 7,
 	minLocalShiftInStdDevs: 2,
-	minZScore: 3
+	minZScore: 3,
+	capDays: .05
 };
 /**
 * The dates to check against Google updates (before padding): the change
@@ -20432,10 +20433,18 @@ function sumOfSquaredDeviations(values) {
 	const average = mean(values);
 	return values.reduce((sum, value) => sum + (value - average) ** 2, 0);
 }
-function findStepChange(values) {
+function capped(values) {
+	const sorted = [...values].sort((a, b) => a - b);
+	const last = sorted.length - 1;
+	const low = sorted[Math.floor(last * STEP_CHANGE_RULES.capDays)] ?? 0;
+	const high = sorted[Math.ceil(last * (1 - STEP_CHANGE_RULES.capDays))] ?? 0;
+	return values.map((value) => Math.min(high, Math.max(low, value)));
+}
+function findStepChange(observed) {
 	const { minDaysBefore, minDaysAfter, localDays, minLocalShiftInStdDevs, minZScore } = STEP_CHANGE_RULES;
-	const count = values.length;
+	const count = observed.length;
 	if (count < minDaysBefore + minDaysAfter) return null;
+	const values = capped(observed);
 	const sums = [0];
 	for (const value of values) sums.push((sums.at(-1) ?? 0) + value);
 	const total = sums[count] ?? 0;