@jdevalk/astro-seo-graph 0.6.0 → 0.7.0

package/README.md

@@ -24,6 +24,7 @@ schema.org best practices — see [AGENTS.md](https://github.com/jdevalk/seo-gra
 | **`buildAlternateLinks`**      | Pure helper that turns a `{ hreflang, href }` entry list into normalized `<link rel="alternate">` tags plus an `x-default`. Used internally by `<Seo>`'s `alternates` prop, and exported for non-Astro callers (e.g. CMS plugins feeding their own metadata pipelines). |
 | **`breadcrumbsFromUrl`**       | Derives a breadcrumb trail from an Astro URL. Splits path segments, supports custom display names and segment skipping. Returns `BreadcrumbItem[]` ready to pass to `buildBreadcrumbList`.                                                                              |
 | **`<FuzzyRedirect>`**          | Drop-in 404 component. Fetches your sitemap, fuzzy-matches the current URL against known paths, and suggests or auto-redirects to the closest match.                                                                                                                    |
+| **`createIndexNowKeyRoute`**   | Factory returning an `APIRoute` that serves the IndexNow key-verification file at `/<key>.txt`. Pair with the `indexNow` option on the integration to auto-submit built URLs on `astro:build:done`.                                                                      |
 
 ## Installation
 
@@ -76,6 +77,27 @@ const graph = buildSchemaGraph({
 </html>
 ```
 
+### `<Seo>` behavior notes
+
+- **Robots defaults.** `max-snippet:-1`, `max-image-preview:large`, and
+  `max-video-preview:-1` are always emitted alongside any `noindex` /
+  `nofollow` directives, matching the Yoast-style defaults for maximum
+  snippet sizes.
+- **Canonical + noindex.** When `noindex` is true the canonical link is
+  omitted per Google's recommendation.
+- **Query params.** Canonical URLs strip query parameters by default. Pass
+  `preserveQueryParams` to keep them.
+- **Twitter tag dedup.** `twitter:title`, `twitter:description`,
+  `twitter:image`, and `twitter:image:alt` are only emitted when the
+  caller explicitly overrides them via `twitter.title` / `description` /
+  `image` / `imageAlt`. Otherwise Twitter falls back to the `og:`
+  counterparts automatically.
+- **`og:locale:alternate`.** Emitted automatically from the `alternates`
+  prop on multilingual pages.
+- **Author / publisher.** Pass `author` for `<meta name="author">` (falls
+  back to `article.authors[0]`); pass `articlePublisher` for the
+  `article:publisher` Facebook URL.
+
 ## Breadcrumbs from URL
 
 Derive a breadcrumb trail from an Astro page URL instead of computing it
@@ -312,10 +334,13 @@ explicitly. If you want the whole image to be optional, wrap the schema:
 
 ## Astro integration
 
-An Astro integration that runs build-time SEO checks. Currently:
+An Astro integration that runs build-time SEO checks and optional post-build
+actions. Currently:
 
 - Warns about built pages with zero or more than one `<h1>` element (a
   common SEO and accessibility issue).
+- Optionally submits built URLs to [IndexNow](https://www.indexnow.org)
+  after the build completes.
 
 ```js
 // astro.config.mjs
@@ -323,17 +348,48 @@ import { defineConfig } from 'astro/config';
 import seoGraph from '@jdevalk/astro-seo-graph/integration';
 
 export default defineConfig({
-    integrations: [seoGraph()],
+    integrations: [
+        seoGraph({
+            indexNow: {
+                key: process.env.INDEXNOW_KEY!,
+                host: 'example.com',
+                siteUrl: 'https://example.com',
+            },
+        }),
+    ],
 });
 ```
 
 Options:
 
-| Prop         | Default | Description                                 |
-| ------------ | ------- | ------------------------------------------- |
-| `validateH1` | `true`  | Warn about pages without exactly one `<h1>` |
+| Prop         | Default | Description                                               |
+| ------------ | ------- | --------------------------------------------------------- |
+| `validateH1` | `true`  | Warn about pages without exactly one `<h1>`               |
+| `indexNow`   | —       | Submit built URLs to IndexNow. See below for sub-options. |
+
+`indexNow` sub-options: `key` (8–128 hex chars), `host` (bare host, e.g.
+`example.com`), `siteUrl` (absolute origin), `keyLocation?` (defaults to
+`https://<host>/<key>.txt`), `endpoint?` (defaults to `api.indexnow.org`),
+`filter?` (drop URLs for which the callback returns `false`).
+
+`index.html` paths are rewritten to their trailing-slash form. Only static
+pages are checked/submitted (SSR pages aren't on disk at build time).
+
+## IndexNow key route
+
+Serve the IndexNow key-verification file at `/<key>.txt` so participating
+engines can confirm host ownership:
+
+```ts
+// src/pages/[your-key-here].txt.ts
+import { createIndexNowKeyRoute } from '@jdevalk/astro-seo-graph';
+
+export const GET = createIndexNowKeyRoute({ key: 'your-key-here' });
+```
 
-Only static pages are checked (SSR pages aren't on disk at build time).
+The filename (minus `.txt.ts`) must equal the key. Pair this with the
+`indexNow` integration option above, or call `submitToIndexNow` from your
+own deploy hook.
 
 ## License
 

package/dist/index.d.ts

@@ -9,4 +9,6 @@ export { buildAlternateLinks } from './alternates.js';
 export type { AlternateLink, BuildAlternateLinksInput } from './alternates.js';
 export { breadcrumbsFromUrl } from './breadcrumbs.js';
 export type { BreadcrumbsFromUrlInput } from './breadcrumbs.js';
+export { createIndexNowKeyRoute, submitToIndexNow, validateIndexNowKey } from './indexnow.js';
+export type { IndexNowKeyRouteOptions, IndexNowSubmitResult } from './indexnow.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE3F,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE3F,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC9F,YAAY,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -9,4 +9,5 @@ export { seoSchema, imageSchema } from './content-helpers.js';
 export { buildAstroSeoProps } from './components/seo-props.js';
 export { buildAlternateLinks } from './alternates.js';
 export { breadcrumbsFromUrl } from './breadcrumbs.js';
+export { createIndexNowKeyRoute, submitToIndexNow, validateIndexNowKey } from './indexnow.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,wEAAwE;AACxE,8EAA8E;AAC9E,sDAAsD;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGpE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,wEAAwE;AACxE,8EAA8E;AAC9E,sDAAsD;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGpE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/indexnow.d.ts

@@ -0,0 +1,25 @@
+import type { APIRoute } from 'astro';
+import { submitToIndexNow, validateIndexNowKey, type IndexNowSubmitResult } from '@jdevalk/seo-graph-core';
+export interface IndexNowKeyRouteOptions {
+    /** IndexNow key (8–128 hex characters). */
+    key: string;
+    /** Defaults to `public, max-age=86400`. Pass `null` to omit. */
+    cacheControl?: string | null;
+}
+/**
+ * Returns an Astro `APIRoute` that serves the IndexNow key verification
+ * file. Place this at `src/pages/[key].txt.ts` or `src/pages/<key>.txt.ts`
+ * so it resolves to `/<key>.txt` on the deployed site.
+ *
+ * @example
+ * ```ts
+ * // src/pages/your-key-here.txt.ts
+ * import { createIndexNowKeyRoute } from '@jdevalk/astro-seo-graph';
+ *
+ * export const GET = createIndexNowKeyRoute({ key: 'your-key-here' });
+ * ```
+ */
+export declare function createIndexNowKeyRoute(options: IndexNowKeyRouteOptions): APIRoute;
+export { submitToIndexNow, validateIndexNowKey };
+export type { IndexNowSubmitResult };
+//# sourceMappingURL=indexnow.d.ts.map

package/dist/indexnow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexnow.d.ts","sourceRoot":"","sources":["../src/indexnow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAEH,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,oBAAoB,EAC5B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,uBAAuB;IACpC,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,QAAQ,CAYjF;AAED,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/indexnow.js

@@ -0,0 +1,28 @@
+import { getIndexNowKeyFileContent, submitToIndexNow, validateIndexNowKey, } from '@jdevalk/seo-graph-core';
+/**
+ * Returns an Astro `APIRoute` that serves the IndexNow key verification
+ * file. Place this at `src/pages/[key].txt.ts` or `src/pages/<key>.txt.ts`
+ * so it resolves to `/<key>.txt` on the deployed site.
+ *
+ * @example
+ * ```ts
+ * // src/pages/your-key-here.txt.ts
+ * import { createIndexNowKeyRoute } from '@jdevalk/astro-seo-graph';
+ *
+ * export const GET = createIndexNowKeyRoute({ key: 'your-key-here' });
+ * ```
+ */
+export function createIndexNowKeyRoute(options) {
+    const body = getIndexNowKeyFileContent(options.key);
+    const cacheControl = options.cacheControl === undefined ? 'public, max-age=86400' : options.cacheControl;
+    return async () => {
+        const headers = {
+            'Content-Type': 'text/plain; charset=utf-8',
+        };
+        if (cacheControl !== null)
+            headers['Cache-Control'] = cacheControl;
+        return new Response(body, { headers });
+    };
+}
+export { submitToIndexNow, validateIndexNowKey };
+//# sourceMappingURL=indexnow.js.map

package/dist/indexnow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexnow.js","sourceRoot":"","sources":["../src/indexnow.ts"],"names":[],"mappings":"AACA,OAAO,EACH,yBAAyB,EACzB,gBAAgB,EAChB,mBAAmB,GAEtB,MAAM,yBAAyB,CAAC;AASjC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgC;IACnE,MAAM,IAAI,GAAG,yBAAyB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpD,MAAM,YAAY,GACd,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAExF,OAAO,KAAK,IAAI,EAAE;QACd,MAAM,OAAO,GAA2B;YACpC,cAAc,EAAE,2BAA2B;SAC9C,CAAC;QACF,IAAI,YAAY,KAAK,IAAI;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,YAAY,CAAC;QACnE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC;AACN,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/integration.d.ts

@@ -12,6 +12,33 @@ interface AstroIntegrationLike {
         'astro:build:done'?: (args: BuildDoneHook) => void | Promise<void>;
     };
 }
+export interface IndexNowIntegrationOptions {
+    /** IndexNow key (8–128 hex chars). Required to enable submission. */
+    key: string;
+    /** Bare host, e.g. `example.com`. */
+    host: string;
+    /**
+     * Absolute site origin used to resolve built HTML paths into URLs
+     * for submission. E.g. `https://example.com`. Trailing slash is
+     * tolerated.
+     */
+    siteUrl: string;
+    /**
+     * Optional absolute URL to the key file. Defaults to
+     * `https://<host>/<key>.txt`.
+     */
+    keyLocation?: string;
+    /**
+     * Override the IndexNow endpoint. Defaults to the neutral aggregator
+     * at `api.indexnow.org`.
+     */
+    endpoint?: string;
+    /**
+     * Filter the list of URLs before submission. Return `false` to skip
+     * a URL. Useful for excluding 404 pages, drafts, etc.
+     */
+    filter?: (url: string) => boolean;
+}
 export interface SeoGraphIntegrationOptions {
     /**
      * Warn when a built page has zero or more than one `<h1>` element.
@@ -19,7 +46,20 @@ export interface SeoGraphIntegrationOptions {
      * not present on disk at build time).
      */
     validateH1?: boolean;
+    /**
+     * Submit built URLs to IndexNow after the build completes. Omit to
+     * disable. Only URLs on `host` are submitted; URLs with trailing
+     * `index.html` are rewritten to their directory form.
+     */
+    indexNow?: IndexNowIntegrationOptions;
 }
+/**
+ * Turn a built HTML file path (relative to the outDir, e.g.
+ * `blog/post/index.html`) into an absolute URL on `siteUrl`. Rewrites
+ * `index.html` to a trailing slash and strips other `.html` extensions
+ * — matching Astro's default `trailingSlash: 'ignore'` output layout.
+ */
+export declare function htmlFileToUrl(relativePath: string, siteUrl: string): string;
 /**
  * Count `<h1>` elements in an HTML string. Matches the opening tag only;
  * tolerant of attributes and whitespace. Doesn't parse — good enough for

package/dist/integration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AAOA,UAAU,aAAa;IACnB,GAAG,EAAE,GAAG,CAAC;IAET,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;CAC5F;AAED,UAAU,oBAAoB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QACH,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACtE,CAAC;CACL;AAED,MAAM,WAAW,0BAA0B;IACvC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAgBD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,OAAO,GAAE,0BAA+B,GAAG,oBAAoB,CAoC/F"}
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AAQA,UAAU,aAAa;IACnB,GAAG,EAAE,GAAG,CAAC;IAET,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;CAC5F;AAED,UAAU,oBAAoB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QACH,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACtE,CAAC;CACL;AAED,MAAM,WAAW,0BAA0B;IACvC,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,0BAA0B;IACvC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,0BAA0B,CAAC;CACzC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAc3E;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAgBD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,OAAO,GAAE,0BAA+B,GAAG,oBAAoB,CAqE/F"}

package/dist/integration.js

@@ -1,6 +1,31 @@
 import { readFile, readdir } from 'node:fs/promises';
 import { join, relative } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { submitToIndexNow } from '@jdevalk/seo-graph-core';
+/**
+ * Turn a built HTML file path (relative to the outDir, e.g.
+ * `blog/post/index.html`) into an absolute URL on `siteUrl`. Rewrites
+ * `index.html` to a trailing slash and strips other `.html` extensions
+ * — matching Astro's default `trailingSlash: 'ignore'` output layout.
+ */
+export function htmlFileToUrl(relativePath, siteUrl) {
+    const origin = siteUrl.replace(/\/+$/, '');
+    const normalized = relativePath.split(/[\\/]/).join('/');
+    let pathname;
+    if (normalized === 'index.html' || normalized === '/index.html') {
+        pathname = '/';
+    }
+    else if (normalized.endsWith('/index.html')) {
+        pathname = '/' + normalized.slice(0, -'index.html'.length);
+    }
+    else if (normalized.endsWith('.html')) {
+        pathname = '/' + normalized.slice(0, -'.html'.length);
+    }
+    else {
+        pathname = '/' + normalized;
+    }
+    return `${origin}${pathname}`;
+}
 /**
  * Count `<h1>` elements in an HTML string. Matches the opening tag only;
  * tolerant of attributes and whitespace. Doesn't parse — good enough for
@@ -42,34 +67,60 @@ async function collectHtmlFiles(dir, base = dir) {
  * ```
  */
 export default function seoGraph(options = {}) {
-    const { validateH1 = true } = options;
+    const { validateH1 = true, indexNow } = options;
     return {
         name: '@jdevalk/astro-seo-graph',
         hooks: {
             'astro:build:done': async ({ dir, logger }) => {
-                if (!validateH1)
-                    return;
                 const buildDir = fileURLToPath(dir);
-                const htmlFiles = await collectHtmlFiles(buildDir);
-                const missing = [];
-                const multiple = [];
-                for (const file of htmlFiles) {
-                    const content = await readFile(join(buildDir, file), 'utf8');
-                    const count = countH1s(content);
-                    if (count === 0)
-                        missing.push(file);
-                    else if (count > 1)
-                        multiple.push({ file, count });
-                }
-                if (missing.length === 0 && multiple.length === 0) {
-                    logger.info(`H1 validation: ${htmlFiles.length} pages checked, all good.`);
-                    return;
-                }
-                for (const file of missing) {
-                    logger.warn(`H1 validation: ${file} has no <h1>.`);
+                const htmlFiles = validateH1 || indexNow ? await collectHtmlFiles(buildDir) : [];
+                if (validateH1) {
+                    const missing = [];
+                    const multiple = [];
+                    for (const file of htmlFiles) {
+                        const content = await readFile(join(buildDir, file), 'utf8');
+                        const count = countH1s(content);
+                        if (count === 0)
+                            missing.push(file);
+                        else if (count > 1)
+                            multiple.push({ file, count });
+                    }
+                    if (missing.length === 0 && multiple.length === 0) {
+                        logger.info(`H1 validation: ${htmlFiles.length} pages checked, all good.`);
+                    }
+                    else {
+                        for (const file of missing) {
+                            logger.warn(`H1 validation: ${file} has no <h1>.`);
+                        }
+                        for (const { file, count } of multiple) {
+                            logger.warn(`H1 validation: ${file} has ${count} <h1> elements (expected 1).`);
+                        }
+                    }
                 }
-                for (const { file, count } of multiple) {
-                    logger.warn(`H1 validation: ${file} has ${count} <h1> elements (expected 1).`);
+                if (indexNow) {
+                    const urls = htmlFiles
+                        .map((f) => htmlFileToUrl(f, indexNow.siteUrl))
+                        .filter((u) => (indexNow.filter ? indexNow.filter(u) : true));
+                    if (urls.length === 0) {
+                        logger.info('IndexNow: no URLs to submit.');
+                    }
+                    else {
+                        const results = await submitToIndexNow({
+                            host: indexNow.host,
+                            key: indexNow.key,
+                            keyLocation: indexNow.keyLocation,
+                            endpoint: indexNow.endpoint,
+                            urls,
+                        });
+                        for (const r of results) {
+                            if (r.ok) {
+                                logger.info(`IndexNow: submitted ${r.submitted} URLs (status ${r.status}).`);
+                            }
+                            else {
+                                logger.warn(`IndexNow: submission failed (status ${r.status}): ${r.message}`);
+                            }
+                        }
+                    }
                 }
             },
         },

package/dist/integration.js.map

@@ -1 +1 @@
-{"version":3,"file":"integration.js","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"integration.js","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AA6D3D;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,YAAoB,EAAE,OAAe;IAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,IAAI,QAAgB,CAAC;IACrB,IAAI,UAAU,KAAK,YAAY,IAAI,UAAU,KAAK,aAAa,EAAE,CAAC;QAC9D,QAAQ,GAAG,GAAG,CAAC;IACnB,CAAC;SAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5C,QAAQ,GAAG,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;SAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,QAAQ,GAAG,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACJ,QAAQ,GAAG,GAAG,GAAG,UAAU,CAAC;IAChC,CAAC;IACD,OAAO,GAAG,MAAM,GAAG,QAAQ,EAAE,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACzC,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,OAAe,GAAG;IAC3D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5D,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACxD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACzC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,UAAsC,EAAE;IACrE,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAEhD,OAAO;QACH,IAAI,EAAE,0BAA0B;QAChC,KAAK,EAAE;YACH,kBAAkB,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;gBAC1C,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;gBACpC,MAAM,SAAS,GACX,UAAU,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAEnE,IAAI,UAAU,EAAE,CAAC;oBACb,MAAM,OAAO,GAAa,EAAE,CAAC;oBAC7B,MAAM,QAAQ,GAA2C,EAAE,CAAC;oBAE5D,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;wBAC3B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;wBAC7D,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;wBAChC,IAAI,KAAK,KAAK,CAAC;4BAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;6BAC/B,IAAI,KAAK,GAAG,CAAC;4BAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;oBACvD,CAAC;oBAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAChD,MAAM,CAAC,IAAI,CACP,kBAAkB,SAAS,CAAC,MAAM,2BAA2B,CAChE,CAAC;oBACN,CAAC;yBAAM,CAAC;wBACJ,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;4BACzB,MAAM,CAAC,IAAI,CAAC,kBAAkB,IAAI,eAAe,CAAC,CAAC;wBACvD,CAAC;wBACD,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,QAAQ,EAAE,CAAC;4BACrC,MAAM,CAAC,IAAI,CACP,kBAAkB,IAAI,QAAQ,KAAK,8BAA8B,CACpE,CAAC;wBACN,CAAC;oBACL,CAAC;gBACL,CAAC;gBAED,IAAI,QAAQ,EAAE,CAAC;oBACX,MAAM,IAAI,GAAG,SAAS;yBACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;yBAC9C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;oBAElE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACpB,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;oBAChD,CAAC;yBAAM,CAAC;wBACJ,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC;4BACnC,IAAI,EAAE,QAAQ,CAAC,IAAI;4BACnB,GAAG,EAAE,QAAQ,CAAC,GAAG;4BACjB,WAAW,EAAE,QAAQ,CAAC,WAAW;4BACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;4BAC3B,IAAI;yBACP,CAAC,CAAC;wBACH,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;4BACtB,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC;gCACP,MAAM,CAAC,IAAI,CACP,uBAAuB,CAAC,CAAC,SAAS,iBAAiB,CAAC,CAAC,MAAM,IAAI,CAClE,CAAC;4BACN,CAAC;iCAAM,CAAC;gCACJ,MAAM,CAAC,IAAI,CACP,uCAAuC,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,OAAO,EAAE,CACnE,CAAC;4BACN,CAAC;wBACL,CAAC;oBACL,CAAC;gBACL,CAAC;YACL,CAAC;SACJ;KACJ,CAAC;AACN,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jdevalk/astro-seo-graph",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Astro integration for @jdevalk/seo-graph-core. Seo component, route factories, content-collection aggregator, Zod content helpers.",
   "keywords": [
     "astro",
@@ -52,7 +52,7 @@
     "astro-seo": "^1.1.0",
     "schema-dts": "^2.0.0",
     "zod": "^3.24.0",
-    "@jdevalk/seo-graph-core": "0.5.2"
+    "@jdevalk/seo-graph-core": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",