@jdevalk/astro-seo-graph 0.5.2 → 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
@@ -292,18 +314,83 @@ export const GET = createSchemaMap({
 ```ts
 // src/content.config.ts
 import { defineCollection, z } from 'astro:content';
-import { seoSchema } from '@jdevalk/astro-seo-graph';
+import { seoSchema, imageSchema } from '@jdevalk/astro-seo-graph';
 
 const blog = defineCollection({
     schema: ({ image }) =>
         z.object({
             title: z.string(),
             publishDate: z.coerce.date(),
+            featureImage: imageSchema(image).optional(),
             seo: seoSchema(image).optional(),
         }),
 });
 ```
 
+`imageSchema` **requires** `alt` — missing alt text is an accessibility
+failure and an SEO failure. Decorative images should use `alt: ''`
+explicitly. If you want the whole image to be optional, wrap the schema:
+`imageSchema(image).optional()`.
+
+## Astro integration
+
+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
+import { defineConfig } from 'astro/config';
+import seoGraph from '@jdevalk/astro-seo-graph/integration';
+
+export default defineConfig({
+    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>`               |
+| `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' });
+```
+
+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
 
 MIT © Joost de Valk

package/dist/components/seo-props.d.ts

@@ -19,8 +19,20 @@ export interface SeoProps {
     titleTemplate?: string;
     /** Meta description. */
     description?: string;
-    /** Canonical URL. Defaults to the current page URL (`Astro.url.href`). */
+    /**
+     * Canonical URL. Defaults to the current page URL with the query
+     * string stripped. Set `preserveQueryParams` to keep the query
+     * string, or pass an explicit `canonical` to override entirely.
+     *
+     * Omitted from the output when `noindex` is true.
+     */
     canonical?: string | URL;
+    /**
+     * Keep the query string in the default canonical URL. Defaults to
+     * `false` (query params are stripped — the SEO-correct behavior for
+     * most cases). Has no effect when `canonical` is explicitly set.
+     */
+    preserveQueryParams?: boolean;
     /** Open Graph type. Defaults to `'website'`. */
     ogType?: 'website' | 'article' | 'profile' | 'book';
     /** Absolute URL of the share image. */
@@ -35,7 +47,14 @@ export interface SeoProps {
     siteName?: string;
     /** OG locale. Defaults to `'en_US'`. */
     locale?: string;
-    /** Twitter card metadata. */
+    /**
+     * Twitter card metadata. Only Twitter-specific tags (card, site,
+     * creator) are emitted by default — twitter:title, :description,
+     * :image, and :image:alt fall back to their `og:` counterparts
+     * automatically. Set `title`, `description`, `image`, or `imageAlt`
+     * here only when you want Twitter-specific content that differs
+     * from the OG values.
+     */
     twitter?: {
         /** Twitter handle of the site owner, e.g. `'@jdevalk'`. */
         site?: string;
@@ -43,6 +62,14 @@ export interface SeoProps {
         creator?: string;
         /** Card type. Defaults to `'summary_large_image'`. */
         card?: 'summary' | 'summary_large_image' | 'app' | 'player';
+        /** Override twitter:title. Omit to fall back to og:title. */
+        title?: string;
+        /** Override twitter:description. Omit to fall back to og:description. */
+        description?: string;
+        /** Override twitter:image. Omit to fall back to og:image. */
+        image?: string;
+        /** Override twitter:image:alt. Omit to fall back to og:image:alt. */
+        imageAlt?: string;
     };
     /**
      * Article-specific OG metadata. Only emitted when `ogType` is
@@ -56,8 +83,20 @@ export interface SeoProps {
         tags?: readonly string[];
         section?: string;
     };
-    /** Emit `<meta name="robots" content="noindex, follow">` when `true`. */
+    /** Emit `<meta name="robots" content="noindex, follow, max-*">`. */
     noindex?: boolean;
+    /** Emit `nofollow` in the robots meta. */
+    nofollow?: boolean;
+    /**
+     * Facebook page URL of the publisher. Emitted as `article:publisher`
+     * when `ogType` is `'article'`.
+     */
+    articlePublisher?: string;
+    /**
+     * Author name for the `<meta name="author">` tag. If omitted but
+     * `article.authors` is set, the first author is used.
+     */
+    author?: string;
     /**
      * JSON-LD `@graph` envelope to inject as
      * `<script type="application/ld+json">`. Typically the output of
@@ -74,21 +113,8 @@ export interface SeoProps {
      *
      * Emits one `<link rel="alternate" hreflang="…" href="…">` per
      * entry, plus an `x-default` entry pointing at the default-locale
-     * sibling (or the first entry, if no default match is found).
-     *
-     * All `href` values MUST be absolute `http(s)://` URLs — relative
-     * or other-scheme values are dropped silently. BCP 47 tags are
-     * normalized on output (`fr-ca` → `fr-CA`, `zh-hant-hk` →
-     * `zh-Hant-HK`). On duplicate normalized tags, the first entry
-     * wins.
-     *
-     * **The caller must include the current page itself** in the
-     * entries list — Google treats self-referential hreflang as
-     * required, not optional.
-     *
-     * When fewer than 2 entries survive validation, nothing is emitted
-     * (a single-locale page has no meaningful alternates). If you
-     * prefer strict input checking, validate before passing in.
+     * sibling (or the first entry, if no default match is found). Also
+     * emits matching `og:locale:alternate` tags.
      */
     alternates?: BuildAlternateLinksInput;
 }
@@ -100,8 +126,7 @@ export interface SeoProps {
 export interface AstroSeoProps {
     title: string;
     description?: string;
-    canonical: string;
-    noindex?: boolean;
+    canonical?: string;
     openGraph: {
         basic: {
             title: string;
@@ -113,6 +138,7 @@ export interface AstroSeoProps {
             description?: string;
             siteName?: string;
             locale?: string;
+            localeAlternate?: string[];
         };
         image?: {
             alt?: string;
@@ -126,13 +152,14 @@ export interface AstroSeoProps {
             authors?: string[];
             tags?: string[];
             section?: string;
+            publisher?: string;
         };
     };
     twitter?: {
         card: 'summary' | 'summary_large_image' | 'app' | 'player';
         site?: string;
         creator?: string;
-        title: string;
+        title?: string;
         description?: string;
         image?: string;
         imageAlt?: string;

package/dist/components/seo-props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seo-props.d.ts","sourceRoot":"","sources":["../../src/components/seo-props.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"seo-props.d.ts","sourceRoot":"","sources":["../../src/components/seo-props.ts"],"names":[],"mappings":"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"}

package/dist/components/seo-props.js

@@ -11,6 +11,40 @@ function toIsoString(value) {
         return undefined;
     return value instanceof Date ? value.toISOString() : value;
 }
+/**
+ * Build the `content` value of the `<meta name="robots">` tag. Always
+ * includes `max-snippet:-1, max-image-preview:large, max-video-preview:-1`
+ * (opt into maximum snippet/preview sizes in search results). Prepends
+ * `noindex`, `nofollow`, or `noindex, follow` as applicable.
+ */
+function buildRobotsContent(noindex, nofollow) {
+    const directives = [];
+    if (noindex && nofollow) {
+        directives.push('noindex', 'nofollow');
+    }
+    else if (noindex) {
+        directives.push('noindex', 'follow');
+    }
+    else if (nofollow) {
+        directives.push('nofollow');
+    }
+    directives.push('max-snippet:-1', 'max-image-preview:large', 'max-video-preview:-1');
+    return directives.join(', ');
+}
+/**
+ * Strip the query string from a URL. Fragments are preserved. Falls
+ * back to returning the input unchanged if URL parsing fails.
+ */
+function stripQueryParams(url) {
+    try {
+        const parsed = new URL(url);
+        parsed.search = '';
+        return parsed.toString();
+    }
+    catch {
+        return url;
+    }
+}
 /**
  * Project the public `SeoProps` onto the shape `astro-seo`'s `<SEO>`
  * component expects. Pure function; no Astro runtime access.
@@ -24,7 +58,26 @@ export function buildAstroSeoProps(props, pageUrl) {
     const fullTitle = props.titleTemplate
         ? props.titleTemplate.replace('%s', props.title)
         : props.title;
-    const canonical = props.canonical !== undefined ? props.canonical.toString() : pageUrl;
+    // Default canonical strips query params (SEO-correct for most
+    // cases). `preserveQueryParams` opts out. Explicit `canonical`
+    // overrides entirely.
+    let canonical;
+    if (props.canonical !== undefined) {
+        canonical = props.canonical.toString();
+    }
+    else if (props.preserveQueryParams) {
+        canonical = pageUrl;
+    }
+    else {
+        canonical = stripQueryParams(pageUrl);
+    }
+    // Omit canonical when the page is noindex (Google recommendation).
+    if (props.noindex) {
+        canonical = undefined;
+    }
+    // og:url uses the canonical when available, otherwise the (possibly
+    // query-stripped) page URL.
+    const ogUrl = canonical ?? stripQueryParams(pageUrl);
     const ogType = props.ogType ?? 'website';
     const ogImage = props.ogImage ?? '';
     const openGraph = {
@@ -32,7 +85,7 @@ export function buildAstroSeoProps(props, pageUrl) {
             title: fullTitle,
             type: ogType,
             image: ogImage,
-            url: canonical,
+            url: ogUrl,
         },
     };
     const optional = {};
@@ -41,6 +94,30 @@ export function buildAstroSeoProps(props, pageUrl) {
     if (props.siteName !== undefined)
         optional.siteName = props.siteName;
     optional.locale = props.locale ?? 'en_US';
+    // og:locale:alternate from hreflang entries. Convert hyphenated
+    // BCP 47 (fr-CA) to OG-style underscores (fr_CA), and skip any
+    // entry that matches the primary og:locale (including language-only
+    // matches like hreflang='en' when og:locale='en_US').
+    if (props.alternates?.entries && props.alternates.entries.length > 1) {
+        const primaryLang = optional.locale?.split('_')[0]?.toLowerCase();
+        const localeAlternate = [];
+        const seen = new Set();
+        for (const entry of props.alternates.entries) {
+            const ogLocale = entry.hreflang.replace('-', '_');
+            const entryLang = entry.hreflang.split('-')[0]?.toLowerCase();
+            if (seen.has(ogLocale))
+                continue;
+            if (ogLocale === optional.locale)
+                continue;
+            // Skip language-only hreflang when it matches the primary locale's language.
+            if (!entry.hreflang.includes('-') && entryLang === primaryLang)
+                continue;
+            seen.add(ogLocale);
+            localeAlternate.push(ogLocale);
+        }
+        if (localeAlternate.length > 0)
+            optional.localeAlternate = localeAlternate;
+    }
     openGraph.optional = optional;
     const hasImageMeta = props.ogImageAlt !== undefined ||
         props.ogImageWidth !== undefined ||
@@ -55,78 +132,103 @@ export function buildAstroSeoProps(props, pageUrl) {
             image.height = props.ogImageHeight;
         openGraph.image = image;
     }
-    if (ogType === 'article' && props.article) {
+    if (ogType === 'article' && (props.article || props.articlePublisher)) {
         const article = {};
-        const published = toIsoString(props.article.publishedTime);
-        if (published !== undefined)
-            article.publishedTime = published;
-        const modified = toIsoString(props.article.modifiedTime);
-        if (modified !== undefined)
-            article.modifiedTime = modified;
-        const expiration = toIsoString(props.article.expirationTime);
-        if (expiration !== undefined)
-            article.expirationTime = expiration;
-        if (props.article.authors !== undefined)
-            article.authors = [...props.article.authors];
-        if (props.article.tags !== undefined)
-            article.tags = [...props.article.tags];
-        if (props.article.section !== undefined)
-            article.section = props.article.section;
+        if (props.article) {
+            const published = toIsoString(props.article.publishedTime);
+            if (published !== undefined)
+                article.publishedTime = published;
+            const modified = toIsoString(props.article.modifiedTime);
+            if (modified !== undefined)
+                article.modifiedTime = modified;
+            const expiration = toIsoString(props.article.expirationTime);
+            if (expiration !== undefined)
+                article.expirationTime = expiration;
+            if (props.article.authors !== undefined)
+                article.authors = [...props.article.authors];
+            if (props.article.tags !== undefined)
+                article.tags = [...props.article.tags];
+            if (props.article.section !== undefined)
+                article.section = props.article.section;
+        }
+        if (props.articlePublisher !== undefined)
+            article.publisher = props.articlePublisher;
         openGraph.article = article;
     }
     const astroSeo = {
         title: fullTitle,
-        canonical,
         openGraph,
     };
+    if (canonical !== undefined)
+        astroSeo.canonical = canonical;
     if (props.description !== undefined)
         astroSeo.description = props.description;
-    if (props.noindex)
-        astroSeo.noindex = true;
     if (props.twitter !== undefined) {
         const twitter = {
             card: props.twitter.card ?? 'summary_large_image',
-            title: fullTitle,
         };
         if (props.twitter.site !== undefined)
             twitter.site = props.twitter.site;
         if (props.twitter.creator !== undefined)
             twitter.creator = props.twitter.creator;
-        if (props.description !== undefined)
-            twitter.description = props.description;
-        if (ogImage)
-            twitter.image = ogImage;
-        if (props.ogImageAlt !== undefined)
-            twitter.imageAlt = props.ogImageAlt;
+        // Only emit twitter:title/description/image/imageAlt when the
+        // caller explicitly provided Twitter-specific overrides.
+        // Otherwise Twitter falls back to the og: counterparts
+        // automatically — emitting duplicates is noisy.
+        if (props.twitter.title !== undefined && props.twitter.title !== fullTitle) {
+            twitter.title = props.twitter.title;
+        }
+        if (props.twitter.description !== undefined &&
+            props.twitter.description !== props.description) {
+            twitter.description = props.twitter.description;
+        }
+        if (props.twitter.image !== undefined && props.twitter.image !== ogImage) {
+            twitter.image = props.twitter.image;
+        }
+        if (props.twitter.imageAlt !== undefined && props.twitter.imageAlt !== props.ogImageAlt) {
+            twitter.imageAlt = props.twitter.imageAlt;
+        }
         astroSeo.twitter = twitter;
     }
     // Resolve hreflang alternates (if any). Returns [] when fewer than
     // 2 entries survive validation, so this is cheap to call.
     const alternateLinks = props.alternates !== undefined ? buildAlternateLinks(props.alternates) : [];
+    // Build our own robots meta (astro-seo's doesn't support max-*).
+    const robotsContent = buildRobotsContent(props.noindex, props.nofollow);
+    // Resolve author name: explicit prop takes precedence, falls back
+    // to first entry in article.authors.
+    const authorName = props.author ?? props.article?.authors?.[0];
+    const meta = [];
+    meta.push({ name: 'robots', content: robotsContent });
+    if (authorName !== undefined) {
+        meta.push({ name: 'author', content: authorName });
+    }
+    if (props.extraMeta !== undefined) {
+        for (const entry of props.extraMeta)
+            meta.push({ ...entry });
+    }
     const hasExtraLinks = props.extraLinks !== undefined && props.extraLinks.length > 0;
-    const hasExtraMeta = props.extraMeta !== undefined && props.extraMeta.length > 0;
     const hasAlternates = alternateLinks.length > 0;
-    if (hasExtraLinks || hasExtraMeta || hasAlternates) {
-        const extend = {};
-        const link = [];
-        if (hasExtraLinks) {
-            for (const entry of props.extraLinks)
-                link.push({ ...entry });
-        }
-        if (hasAlternates) {
-            for (const entry of alternateLinks) {
-                link.push({
-                    rel: entry.rel,
-                    href: entry.href,
-                    hreflang: entry.hreflang,
-                });
-            }
-        }
-        if (link.length > 0)
-            extend.link = link;
-        if (hasExtraMeta) {
-            extend.meta = props.extraMeta.map((meta) => ({ ...meta }));
+    const link = [];
+    if (hasExtraLinks) {
+        for (const entry of props.extraLinks)
+            link.push({ ...entry });
+    }
+    if (hasAlternates) {
+        for (const entry of alternateLinks) {
+            link.push({
+                rel: entry.rel,
+                href: entry.href,
+                hreflang: entry.hreflang,
+            });
         }
+    }
+    const extend = {};
+    if (link.length > 0)
+        extend.link = link;
+    if (meta.length > 0)
+        extend.meta = meta;
+    if (extend.link !== undefined || extend.meta !== undefined) {
         astroSeo.extend = extend;
     }
     return astroSeo;

package/dist/components/seo-props.js.map

@@ -1 +1 @@
-{"version":3,"file":"seo-props.js","sourceRoot":"","sources":["../../src/components/seo-props.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"seo-props.js","sourceRoot":"","sources":["../../src/components/seo-props.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAiC,MAAM,kBAAkB,CAAC;AAuKtF,SAAS,WAAW,CAAC,KAAgC;IACjD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,SAAS,kBAAkB,CAAC,OAAiB,EAAE,QAAkB;IAC7D,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC3C,CAAC;SAAM,IAAI,OAAO,EAAE,CAAC;QACjB,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;SAAM,IAAI,QAAQ,EAAE,CAAC;QAClB,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IACD,UAAU,CAAC,IAAI,CAAC,gBAAgB,EAAE,yBAAyB,EAAE,sBAAsB,CAAC,CAAC;IACrF,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,GAAW;IACjC,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,GAAG,CAAC;IACf,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAe,EAAE,OAAe;IAC/D,MAAM,SAAS,GAAG,KAAK,CAAC,aAAa;QACjC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC;QAChD,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IAElB,8DAA8D;IAC9D,+DAA+D;IAC/D,sBAAsB;IACtB,IAAI,SAA6B,CAAC;IAClC,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAChC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IAC3C,CAAC;SAAM,IAAI,KAAK,CAAC,mBAAmB,EAAE,CAAC;QACnC,SAAS,GAAG,OAAO,CAAC;IACxB,CAAC;SAAM,CAAC;QACJ,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,mEAAmE;IACnE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,SAAS,GAAG,SAAS,CAAC;IAC1B,CAAC;IAED,oEAAoE;IACpE,4BAA4B;IAC5B,MAAM,KAAK,GAAG,SAAS,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAErD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;IAEpC,MAAM,SAAS,GAA+B;QAC1C,KAAK,EAAE;YACH,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,OAAO;YACd,GAAG,EAAE,KAAK;SACb;KACJ,CAAC;IAEF,MAAM,QAAQ,GAAwD,EAAE,CAAC;IACzE,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,QAAQ,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAC9E,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,QAAQ,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACrE,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC;IAE1C,gEAAgE;IAChE,+DAA+D;IAC/D,oEAAoE;IACpE,sDAAsD;IACtD,IAAI,KAAK,CAAC,UAAU,EAAE,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnE,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;QAClE,MAAM,eAAe,GAAa,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAClD,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;YAC9D,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACjC,IAAI,QAAQ,KAAK,QAAQ,CAAC,MAAM;gBAAE,SAAS;YAC3C,6EAA6E;YAC7E,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,SAAS,KAAK,WAAW;gBAAE,SAAS;YACzE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACnB,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC;YAAE,QAAQ,CAAC,eAAe,GAAG,eAAe,CAAC;IAC/E,CAAC;IAED,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAE9B,MAAM,YAAY,GACd,KAAK,CAAC,UAAU,KAAK,SAAS;QAC9B,KAAK,CAAC,YAAY,KAAK,SAAS;QAChC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC;IACtC,IAAI,OAAO,IAAI,YAAY,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAqD,EAAE,CAAC;QACnE,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;YAAE,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC;QACjE,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC;QACvE,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS;YAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC;QAC1E,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACpE,MAAM,OAAO,GAAuD,EAAE,CAAC;QACvE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAChB,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAC3D,IAAI,SAAS,KAAK,SAAS;gBAAE,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;YAC/D,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACzD,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,CAAC,YAAY,GAAG,QAAQ,CAAC;YAC5D,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAC7D,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO,CAAC,cAAc,GAAG,UAAU,CAAC;YAClE,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS;gBAAE,OAAO,CAAC,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACtF,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7E,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS;gBAAE,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACrF,CAAC;QACD,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS;YAAE,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC,gBAAgB,CAAC;QACrF,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC;IAChC,CAAC;IAED,MAAM,QAAQ,GAAkB;QAC5B,KAAK,EAAE,SAAS;QAChB,SAAS;KACZ,CAAC;IAEF,IAAI,SAAS,KAAK,SAAS;QAAE,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5D,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,QAAQ,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAE9E,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,OAAO,GAA0C;YACnD,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,qBAAqB;SACpD,CAAC;QACF,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACxE,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACjF,8DAA8D;QAC9D,yDAAyD;QACzD,uDAAuD;QACvD,gDAAgD;QAChD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACzE,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACxC,CAAC;QACD,IACI,KAAK,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS;YACvC,KAAK,CAAC,OAAO,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,EACjD,CAAC;YACC,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;QACpD,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YACvE,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACxC,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC,UAAU,EAAE,CAAC;YACtF,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC9C,CAAC;QACD,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;IAC/B,CAAC;IAED,mEAAmE;IACnE,0DAA0D;IAC1D,MAAM,cAAc,GAChB,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEhF,iEAAiE;IACjE,MAAM,aAAa,GAAG,kBAAkB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAExE,kEAAkE;IAClE,qCAAqC;IACrC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAE/D,MAAM,IAAI,GAAkC,EAAE,CAAC;IAC/C,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;IACtD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IACpF,MAAM,aAAa,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;IAChD,MAAM,IAAI,GAAkC,EAAE,CAAC;IAC/C,IAAI,aAAa,EAAE,CAAC;QAChB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,UAAW;YAAE,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,aAAa,EAAE,CAAC;QAChB,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC;gBACN,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;aAC3B,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAyC,EAAE,CAAC;IACxD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IACxC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IACxC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACzD,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;IAC7B,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/content-helpers.d.ts

@@ -11,6 +11,11 @@ type AstroImageFunction = any;
  * `image()` from the collection schema factory so the image is processed
  * through Astro's asset pipeline.
  *
+ * `alt` is **required** — missing alt text is an accessibility failure
+ * and an SEO failure. Decorative images should use `alt: ''` explicitly.
+ * If you want to make the whole image optional, wrap the schema:
+ * `imageSchema(image).optional()`.
+ *
  * @example
  * ```ts
  * import { defineCollection, z } from 'astro:content';
@@ -27,13 +32,13 @@ type AstroImageFunction = any;
  */
 export declare function imageSchema(image: AstroImageFunction): z.ZodObject<{
     src: any;
-    alt: z.ZodOptional<z.ZodString>;
+    alt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    alt: string;
     src?: any;
-    alt?: string | undefined;
 }, {
+    alt: string;
     src?: any;
-    alt?: string | undefined;
 }>;
 /**
  * Zod schema for a nested `seo` field holding per-entry SEO overrides:
@@ -57,13 +62,13 @@ export declare function seoSchema(image: AstroImageFunction): z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     image: z.ZodOptional<z.ZodObject<{
         src: any;
-        alt: z.ZodOptional<z.ZodString>;
+        alt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        alt: string;
         src?: any;
-        alt?: string | undefined;
     }, {
+        alt: string;
         src?: any;
-        alt?: string | undefined;
     }>>;
     pageType: z.ZodDefault<z.ZodEnum<["website", "article"]>>;
 }, "strip", z.ZodTypeAny, {
@@ -71,15 +76,15 @@ export declare function seoSchema(image: AstroImageFunction): z.ZodObject<{
     title?: string | undefined;
     description?: string | undefined;
     image?: {
+        alt: string;
         src?: any;
-        alt?: string | undefined;
     } | undefined;
 }, {
     title?: string | undefined;
     description?: string | undefined;
     image?: {
+        alt: string;
         src?: any;
-        alt?: string | undefined;
     } | undefined;
     pageType?: "website" | "article" | undefined;
 }>;

package/dist/content-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-helpers.d.ts","sourceRoot":"","sources":["../src/content-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AAEH,KAAK,kBAAkB,GAAG,GAAG,CAAC;AAE9B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,kBAAkB;;;;;;;;;GAKpD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAOlD"}
+{"version":3,"file":"content-helpers.d.ts","sourceRoot":"","sources":["../src/content-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AAEH,KAAK,kBAAkB,GAAG,GAAG,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,kBAAkB;;;;;;;;;GAKpD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAOlD"}

package/dist/content-helpers.js

@@ -4,6 +4,11 @@ import { z } from 'zod';
  * `image()` from the collection schema factory so the image is processed
  * through Astro's asset pipeline.
  *
+ * `alt` is **required** — missing alt text is an accessibility failure
+ * and an SEO failure. Decorative images should use `alt: ''` explicitly.
+ * If you want to make the whole image optional, wrap the schema:
+ * `imageSchema(image).optional()`.
+ *
  * @example
  * ```ts
  * import { defineCollection, z } from 'astro:content';
@@ -21,7 +26,7 @@ import { z } from 'zod';
 export function imageSchema(image) {
     return z.object({
         src: image(),
-        alt: z.string().optional(),
+        alt: z.string(),
     });
 }
 /**

package/dist/content-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"content-helpers.js","sourceRoot":"","sources":["../src/content-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,WAAW,CAAC,KAAyB;IACjD,OAAO,CAAC,CAAC,MAAM,CAAC;QACZ,GAAG,EAAE,KAAK,EAAE;QACZ,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC7B,CAAC,CAAC;AACP,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,SAAS,CAAC,KAAyB;IAC/C,OAAO,CAAC,CAAC,MAAM,CAAC;QACZ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QACnD,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;QACpC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;KAC9D,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"content-helpers.js","sourceRoot":"","sources":["../src/content-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,WAAW,CAAC,KAAyB;IACjD,OAAO,CAAC,CAAC,MAAM,CAAC;QACZ,GAAG,EAAE,KAAK,EAAE;QACZ,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;KAClB,CAAC,CAAC;AACP,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,SAAS,CAAC,KAAyB;IAC/C,OAAO,CAAC,CAAC,MAAM,CAAC;QACZ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QACnD,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;QACpC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;KAC9D,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,88 @@
+interface BuildDoneHook {
+    dir: URL;
+    logger: {
+        warn: (msg: string) => void;
+        info: (msg: string) => void;
+        [key: string]: any;
+    };
+}
+interface AstroIntegrationLike {
+    name: string;
+    hooks: {
+        '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.
+     * Defaults to `true`. Only static pages are checked (SSR pages are
+     * 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
+ * a lint warning.
+ */
+export declare function countH1s(html: string): number;
+/**
+ * Astro integration for `@jdevalk/astro-seo-graph`.
+ *
+ * Currently:
+ * - Warns about built pages with zero or more than one `<h1>` element
+ *   (a common SEO and accessibility issue).
+ *
+ * ```js
+ * // astro.config.mjs
+ * import { defineConfig } from 'astro/config';
+ * import seoGraph from '@jdevalk/astro-seo-graph/integration';
+ *
+ * export default defineConfig({
+ *     integrations: [seoGraph()],
+ * });
+ * ```
+ */
+export default function seoGraph(options?: SeoGraphIntegrationOptions): AstroIntegrationLike;
+export {};
+//# sourceMappingURL=integration.d.ts.map

package/dist/integration.d.ts.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,129 @@
+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
+ * a lint warning.
+ */
+export function countH1s(html) {
+    const matches = html.match(/<h1[\s>]/gi);
+    return matches ? matches.length : 0;
+}
+async function collectHtmlFiles(dir, base = dir) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...(await collectHtmlFiles(fullPath, base)));
+        }
+        else if (entry.isFile() && entry.name.endsWith('.html')) {
+            files.push(relative(base, fullPath));
+        }
+    }
+    return files;
+}
+/**
+ * Astro integration for `@jdevalk/astro-seo-graph`.
+ *
+ * Currently:
+ * - Warns about built pages with zero or more than one `<h1>` element
+ *   (a common SEO and accessibility issue).
+ *
+ * ```js
+ * // astro.config.mjs
+ * import { defineConfig } from 'astro/config';
+ * import seoGraph from '@jdevalk/astro-seo-graph/integration';
+ *
+ * export default defineConfig({
+ *     integrations: [seoGraph()],
+ * });
+ * ```
+ */
+export default function seoGraph(options = {}) {
+    const { validateH1 = true, indexNow } = options;
+    return {
+        name: '@jdevalk/astro-seo-graph',
+        hooks: {
+            'astro:build:done': async ({ dir, logger }) => {
+                const buildDir = fileURLToPath(dir);
+                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).`);
+                        }
+                    }
+                }
+                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}`);
+                            }
+                        }
+                    }
+                }
+            },
+        },
+    };
+}
+//# sourceMappingURL=integration.js.map

package/dist/integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.js","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"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"}

package/dist/routes.d.ts

@@ -58,10 +58,6 @@ export interface SchemaMapEntry {
     path: string;
     /** When the resource at this path was last modified. */
     lastModified: Date;
-    /** Defaults to `'daily'`. */
-    changeFreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
-    /** 0.0–1.0. Defaults to `0.8`. */
-    priority?: number;
 }
 export interface SchemaMapOptions {
     /** Canonical site URL. Trailing slash is stripped. */

package/dist/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,MAAM,WAAW,qBAAqB,CAAC,KAAK;IACxC;;;;OAIG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;IACzC;;;;OAIG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,aAAa,CAAC,WAAW,CAAC,CAAC;IACrD;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,GAAG,QAAQ,CAY3F;AAED,MAAM,WAAW,cAAc;IAC3B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,YAAY,EAAE,IAAI,CAAC;IACnB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvF,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAWD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,QAAQ,CA8BnE"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,MAAM,WAAW,qBAAqB,CAAC,KAAK;IACxC;;;;OAIG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;IACzC;;;;OAIG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,aAAa,CAAC,WAAW,CAAC,CAAC;IACrD;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,GAAG,QAAQ,CAe3F;AAED,MAAM,WAAW,cAAc;IAC3B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,YAAY,EAAE,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC7B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAWD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,QAAQ,CA6BnE"}

package/dist/routes.js

@@ -27,7 +27,10 @@ export function createSchemaEndpoint(options) {
     return async () => {
         const entries = await options.entries();
         const graph = aggregate({ entries, mapper: options.mapper });
-        const headers = { 'Content-Type': contentType };
+        const headers = {
+            'Content-Type': contentType,
+            'X-Robots-Tag': 'noindex, follow',
+        };
         if (cacheControl !== null)
             headers['Cache-Control'] = cacheControl;
         return new Response(JSON.stringify(graph, null, indent), { headers });
@@ -69,13 +72,9 @@ export function createSchemaMap(options) {
             const pathPart = entry.path.startsWith('/') ? entry.path : `/${entry.path}`;
             const loc = escapeXml(`${site}${pathPart}`);
             const lastmod = entry.lastModified.toISOString().split('T')[0];
-            const changefreq = entry.changeFreq ?? 'daily';
-            const priority = entry.priority ?? 0.8;
             return `  <url contentType="structuredData/schema.org">
     <loc>${loc}</loc>
     <lastmod>${lastmod}</lastmod>
-    <changefreq>${changefreq}</changefreq>
-    <priority>${priority}</priority>
   </url>`;
         })
             .join('\n');
@@ -83,7 +82,10 @@ export function createSchemaMap(options) {
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 ${urls}
 </urlset>`;
-        const headers = { 'Content-Type': 'application/xml' };
+        const headers = {
+            'Content-Type': 'application/xml',
+            'X-Robots-Tag': 'noindex, follow',
+        };
         if (cacheControl !== null)
             headers['Cache-Control'] = cacheControl;
         return new Response(xml, { headers });

package/dist/routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA+B5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,oBAAoB,CAAQ,OAAqC;IAC7E,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAC/F,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,qBAAqB,CAAC;IACjE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IAEnC,OAAO,KAAK,IAAI,EAAE;QACd,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7D,MAAM,OAAO,GAA2B;YACpC,cAAc,EAAE,WAAW;YAC3B,cAAc,EAAE,iBAAiB;SACpC,CAAC;QACF,IAAI,YAAY,KAAK,IAAI;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,YAAY,CAAC;QACnE,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC;AACN,CAAC;AAqBD,SAAS,SAAS,CAAC,KAAa;IAC5B,OAAO,KAAK;SACP,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,eAAe,CAAC,OAAyB;IACrD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAC/F,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEjD,OAAO,KAAK,IAAI,EAAE;QACd,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO;aACvB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACX,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC5E,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,QAAQ,EAAE,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/D,OAAO;WACZ,GAAG;eACC,OAAO;SACb,CAAC;QACE,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhB,MAAM,GAAG,GAAG;;EAElB,IAAI;UACI,CAAC;QAEH,MAAM,OAAO,GAA2B;YACpC,cAAc,EAAE,iBAAiB;YACjC,cAAc,EAAE,iBAAiB;SACpC,CAAC;QACF,IAAI,YAAY,KAAK,IAAI;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,YAAY,CAAC;QACnE,OAAO,IAAI,QAAQ,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC;AACN,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jdevalk/astro-seo-graph",
-  "version": "0.5.2",
+  "version": "0.7.0",
   "description": "Astro integration for @jdevalk/seo-graph-core. Seo component, route factories, content-collection aggregator, Zod content helpers.",
   "keywords": [
     "astro",
@@ -23,7 +23,11 @@
       "import": "./dist/index.js"
     },
     "./Seo.astro": "./dist/components/Seo.astro",
-    "./FuzzyRedirect.astro": "./dist/components/FuzzyRedirect.astro"
+    "./FuzzyRedirect.astro": "./dist/components/FuzzyRedirect.astro",
+    "./integration": {
+      "types": "./dist/integration.d.ts",
+      "import": "./dist/integration.js"
+    }
   },
   "files": [
     "dist",
@@ -48,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",