@growth-labs/seo 0.1.3

package/dist/utils/sitemap.d.ts

@@ -0,0 +1,13 @@
+import type { ResolvedSeoOptions } from '../options.js';
+import type { ContentItem } from '../types.js';
+export declare const SITEMAP_INDEX_PATH = "/sitemap-index.xml";
+export interface SitemapEntry {
+    loc: string;
+    lastmod?: string;
+}
+export declare function generateSitemapIndex(sitemaps: SitemapEntry[]): string;
+export declare function generateArticleSitemap(articles: ContentItem[], options: ResolvedSeoOptions): string;
+export declare function generatePagesSitemap(pages: ContentItem[]): string;
+export declare function generateVideoSitemap(items: ContentItem[]): string;
+export declare function generateProductSitemap(items: ContentItem[]): string;
+//# sourceMappingURL=sitemap.d.ts.map

package/dist/utils/sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/utils/sitemap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,eAAO,MAAM,kBAAkB,uBAAuB,CAAA;AAEtD,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAWD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CAYrE;AASD,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,EAAE,kBAAkB,GACzB,MAAM,CA6CR;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAajE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAoCjE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAyBnE"}

package/dist/utils/sitemap.js

@@ -0,0 +1,133 @@
+export const SITEMAP_INDEX_PATH = '/sitemap-index.xml';
+function escapeXml(str) {
+    return str
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+export function generateSitemapIndex(sitemaps) {
+    const entries = sitemaps
+        .map((s) => {
+        const lastmod = s.lastmod ? `\n    <lastmod>${escapeXml(s.lastmod)}</lastmod>` : '';
+        return `  <sitemap>\n    <loc>${escapeXml(s.loc)}</loc>${lastmod}\n  </sitemap>`;
+    })
+        .join('\n');
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${entries}
+</sitemapindex>`;
+}
+function isWithin48Hours(dateStr) {
+    const published = new Date(dateStr);
+    const now = new Date();
+    const diff = now.getTime() - published.getTime();
+    return diff <= 48 * 60 * 60 * 1000;
+}
+export function generateArticleSitemap(articles, options) {
+    const { googleNews, organization } = options;
+    const entries = articles
+        .map((item) => {
+        const lastmod = item.dateModified ?? item.datePublished ?? '';
+        const lastmodTag = lastmod ? `\n    <lastmod>${escapeXml(lastmod)}</lastmod>` : '';
+        // image:image
+        const imageTag = item.image
+            ? `\n    <image:image>\n      <image:loc>${escapeXml(item.image)}</image:loc>\n    </image:image>`
+            : '';
+        // news:news (only for recent articles when googleNews enabled)
+        let newsTag = '';
+        if (googleNews && item.datePublished && isWithin48Hours(item.datePublished)) {
+            newsTag = `\n    <news:news>
+      <news:publication>
+        <news:name>${escapeXml(organization.name)}</news:name>
+        <news:language>${escapeXml('en')}</news:language>
+      </news:publication>
+      <news:publication_date>${escapeXml(item.datePublished)}</news:publication_date>
+      <news:title>${escapeXml(item.title)}</news:title>
+    </news:news>`;
+        }
+        // xhtml:link hreflang
+        const hreflangTags = (item.alternateLocales ?? [])
+            .map((alt) => `\n    <xhtml:link rel="alternate" hreflang="${escapeXml(alt.lang)}" href="${escapeXml(alt.url)}"/>`)
+            .join('');
+        return `  <url>\n    <loc>${escapeXml(item.url)}</loc>${lastmodTag}${imageTag}${newsTag}${hreflangTags}\n  </url>`;
+    })
+        .join('\n');
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
+  xmlns:image="http://www.google.com/schemas/sitemap-image/1.1"
+  xmlns:news="http://www.google.com/schemas/sitemap-news/0.9"
+  xmlns:xhtml="http://www.w3.org/1999/xhtml">
+${entries}
+</urlset>`;
+}
+export function generatePagesSitemap(pages) {
+    const entries = pages
+        .map((item) => {
+        const lastmod = item.dateModified ?? item.datePublished ?? '';
+        const lastmodTag = lastmod ? `\n    <lastmod>${escapeXml(lastmod)}</lastmod>` : '';
+        return `  <url>\n    <loc>${escapeXml(item.url)}</loc>${lastmodTag}\n  </url>`;
+    })
+        .join('\n');
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${entries}
+</urlset>`;
+}
+export function generateVideoSitemap(items) {
+    const entries = items
+        .filter((item) => item.video)
+        .map((item) => {
+        const v = item.video;
+        const contentUrlTag = v.contentUrl
+            ? `\n      <video:content_loc>${escapeXml(v.contentUrl)}</video:content_loc>`
+            : '';
+        const embedUrlTag = v.embedUrl
+            ? `\n      <video:player_loc>${escapeXml(v.embedUrl)}</video:player_loc>`
+            : '';
+        const descriptionTag = item.description
+            ? `\n      <video:description>${escapeXml(item.description)}</video:description>`
+            : '';
+        const durationTag = v.duration
+            ? `\n      <video:duration>${escapeXml(v.duration)}</video:duration>`
+            : '';
+        const pubDateTag = item.datePublished
+            ? `\n      <video:publication_date>${escapeXml(item.datePublished)}</video:publication_date>`
+            : '';
+        return `  <url>
+    <loc>${escapeXml(item.url)}</loc>
+    <video:video>
+      <video:thumbnail_loc>${escapeXml(v.thumbnailUrl)}</video:thumbnail_loc>
+      <video:title>${escapeXml(item.title)}</video:title>${descriptionTag}${contentUrlTag}${embedUrlTag}${durationTag}${pubDateTag}
+    </video:video>
+  </url>`;
+    })
+        .join('\n');
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
+  xmlns:video="http://www.google.com/schemas/sitemap-video/1.1">
+${entries}
+</urlset>`;
+}
+export function generateProductSitemap(items) {
+    const entries = items
+        .filter((item) => item.product)
+        .map((item) => {
+        const p = item.product;
+        const images = p.images.length > 0 ? p.images : item.image ? [item.image] : [];
+        const imageTags = images
+            .map((img) => `\n    <image:image>\n      <image:loc>${escapeXml(img)}</image:loc>\n    </image:image>`)
+            .join('');
+        const lastmod = item.dateModified ?? item.datePublished ?? '';
+        const lastmodTag = lastmod ? `\n    <lastmod>${escapeXml(lastmod)}</lastmod>` : '';
+        return `  <url>\n    <loc>${escapeXml(item.url)}</loc>${lastmodTag}${imageTags}\n  </url>`;
+    })
+        .join('\n');
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
+  xmlns:image="http://www.google.com/schemas/sitemap-image/1.1">
+${entries}
+</urlset>`;
+}
+//# sourceMappingURL=sitemap.js.map

package/dist/utils/sitemap.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,18 @@
+export interface ValidationResult {
+    errors: string[];
+    warnings: string[];
+}
+export interface PageValidationOptions {
+    titleMaxLength: number;
+    descriptionMaxLength: number;
+    heroMinWidth?: number;
+}
+/**
+ * Validate a JSON-LD object for common SEO issues.
+ */
+export declare function validateJsonLd(jsonLd: Record<string, unknown>): ValidationResult;
+/**
+ * Validate an HTML string for common on-page SEO issues.
+ */
+export declare function validatePage(html: string, options: PageValidationOptions): ValidationResult;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,qBAAqB;IACrC,cAAc,EAAE,MAAM,CAAA;IACtB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAqEhF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,gBAAgB,CAqF3F"}

package/dist/utils/validation.js

@@ -0,0 +1,141 @@
+/**
+ * Validate a JSON-LD object for common SEO issues.
+ */
+export function validateJsonLd(jsonLd) {
+    const errors = [];
+    const warnings = [];
+    // Must have @context
+    if (!jsonLd['@context']) {
+        errors.push('JSON-LD missing @context');
+    }
+    // Must have @type
+    const type = jsonLd['@type'];
+    if (!type) {
+        errors.push('JSON-LD missing @type');
+    }
+    const typeStr = Array.isArray(type) ? type[0] : String(type ?? '');
+    // Article checks
+    if (typeStr === 'Article' || typeStr === 'NewsArticle' || typeStr === 'BlogPosting') {
+        if (!jsonLd.image) {
+            warnings.push(`${typeStr} JSON-LD missing recommended "image" property`);
+        }
+        if (!jsonLd.author) {
+            warnings.push(`${typeStr} JSON-LD missing recommended "author" property`);
+        }
+        const headline = jsonLd.headline;
+        if (headline && typeof headline === 'string' && headline.length > 110) {
+            warnings.push(`${typeStr} JSON-LD "headline" exceeds 110 characters (${headline.length})`);
+        }
+    }
+    // Product checks
+    if (typeStr === 'Product') {
+        const offers = jsonLd.offers;
+        if (!offers) {
+            warnings.push('Product JSON-LD missing recommended "offers" property');
+        }
+        else {
+            const offersObj = Array.isArray(offers) ? offers[0] : offers;
+            if (offersObj && typeof offersObj === 'object') {
+                const o = offersObj;
+                if (!o.price && o.price !== 0) {
+                    warnings.push('Product JSON-LD offers missing "price"');
+                }
+                if (!o.availability) {
+                    warnings.push('Product JSON-LD offers missing "availability"');
+                }
+            }
+        }
+    }
+    // BreadcrumbList position ordering
+    if (typeStr === 'BreadcrumbList') {
+        const itemListElement = jsonLd.itemListElement;
+        if (Array.isArray(itemListElement)) {
+            let lastPosition = 0;
+            for (let i = 0; i < itemListElement.length; i++) {
+                const item = itemListElement[i];
+                const position = Number(item.position);
+                if (position <= lastPosition) {
+                    errors.push(`BreadcrumbList itemListElement[${i}] position ${position} is not in ascending order`);
+                }
+                lastPosition = position;
+            }
+        }
+    }
+    return { errors, warnings };
+}
+/**
+ * Validate an HTML string for common on-page SEO issues.
+ */
+export function validatePage(html, options) {
+    const errors = [];
+    const warnings = [];
+    const { titleMaxLength, descriptionMaxLength } = options;
+    // Title checks
+    const titleMatch = html.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
+    if (!titleMatch) {
+        errors.push('Missing <title> tag');
+    }
+    else {
+        const title = titleMatch[1].trim();
+        if (title.length > titleMaxLength) {
+            warnings.push(`<title> exceeds ${titleMaxLength} characters (${title.length})`);
+        }
+    }
+    // Meta description checks
+    const descMatch = html.match(/<meta\s[^>]*name=["']description["'][^>]*>/i) ??
+        html.match(/<meta\s[^>]*name=description[^>]*>/i);
+    if (!descMatch) {
+        warnings.push('Missing meta description');
+    }
+    else {
+        const contentMatch = descMatch[0].match(/content=["']([^"']*)["']/i) ?? descMatch[0].match(/content=([^\s>]+)/i);
+        if (contentMatch) {
+            const desc = contentMatch[1].trim();
+            if (desc.length > descriptionMaxLength) {
+                warnings.push(`Meta description exceeds ${descriptionMaxLength} characters (${desc.length})`);
+            }
+        }
+    }
+    // Canonical check
+    const canonicalMatch = html.match(/<link\s[^>]*rel=["']canonical["'][^>]*>/i) ??
+        html.match(/<link\s[^>]*rel=canonical[^>]*>/i);
+    if (!canonicalMatch) {
+        warnings.push('Missing canonical link');
+    }
+    // og:image check
+    const ogImageMatch = html.match(/<meta\s[^>]*property=["']og:image["'][^>]*>/i) ??
+        html.match(/<meta\s[^>]*property=og:image[^>]*>/i);
+    if (!ogImageMatch) {
+        warnings.push('Missing og:image meta tag');
+    }
+    // og:image:width check against heroMinWidth
+    if (options.heroMinWidth) {
+        const ogWidthMatch = html.match(/<meta\s[^>]*property=["']og:image:width["'][^>]*>/i) ??
+            html.match(/<meta\s[^>]*property=og:image:width[^>]*>/i);
+        if (ogWidthMatch) {
+            const widthContentMatch = ogWidthMatch[0].match(/content=["']([^"']*)["']/i) ??
+                ogWidthMatch[0].match(/content=([^\s>]+)/i);
+            if (widthContentMatch) {
+                const width = Number(widthContentMatch[1]);
+                if (!Number.isNaN(width) && width < options.heroMinWidth) {
+                    warnings.push(`Hero image width ${width}px is below minimum ${options.heroMinWidth}px`);
+                }
+            }
+        }
+    }
+    // H1 checks
+    const h1Matches = html.match(/<h1[\s>]/gi) ?? [];
+    if (h1Matches.length === 0) {
+        warnings.push('Missing H1 tag');
+    }
+    else if (h1Matches.length > 1) {
+        warnings.push(`Multiple H1 tags found (${h1Matches.length})`);
+    }
+    // JSON-LD presence check
+    const jsonLdMatch = html.match(/<script\s[^>]*type=["']application\/ld\+json["'][^>]*>/i);
+    if (!jsonLdMatch) {
+        warnings.push('Missing JSON-LD structured data');
+    }
+    return { errors, warnings };
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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

package/dist/vite-plugin.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from 'vite';
+import type { ResolvedSeoOptions } from './options.js';
+export declare function growthLabsSeoPlugin(config: ResolvedSeoOptions): Plugin;
+//# sourceMappingURL=vite-plugin.d.ts.map

package/dist/vite-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAKtD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAmBtE"}

package/dist/vite-plugin.js

@@ -0,0 +1,22 @@
+const VIRTUAL_MODULE_ID = 'virtual:growth-labs/seo/config';
+const RESOLVED_VIRTUAL_MODULE_ID = `\0${VIRTUAL_MODULE_ID}`;
+export function growthLabsSeoPlugin(config) {
+    const { contentProvider: _, ...staticConfig } = config;
+    return {
+        name: 'growth-labs-seo-config',
+        resolveId(id) {
+            if (id === VIRTUAL_MODULE_ID) {
+                return RESOLVED_VIRTUAL_MODULE_ID;
+            }
+        },
+        load(id) {
+            if (id === RESOLVED_VIRTUAL_MODULE_ID) {
+                return [
+                    `export const config = ${JSON.stringify(staticConfig)};`,
+                    `export { getConfig, getContentProvider } from '@growth-labs/seo/state';`,
+                ].join('\n');
+            }
+        },
+    };
+}
+//# sourceMappingURL=vite-plugin.js.map

package/dist/vite-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.js","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAGA,MAAM,iBAAiB,GAAG,gCAAgC,CAAA;AAC1D,MAAM,0BAA0B,GAAG,KAAK,iBAAiB,EAAE,CAAA;AAE3D,MAAM,UAAU,mBAAmB,CAAC,MAA0B;IAC7D,MAAM,EAAE,eAAe,EAAE,CAAC,EAAE,GAAG,YAAY,EAAE,GAAG,MAAiC,CAAA;IAEjF,OAAO;QACN,IAAI,EAAE,wBAAwB;QAC9B,SAAS,CAAC,EAAE;YACX,IAAI,EAAE,KAAK,iBAAiB,EAAE,CAAC;gBAC9B,OAAO,0BAA0B,CAAA;YAClC,CAAC;QACF,CAAC;QACD,IAAI,CAAC,EAAE;YACN,IAAI,EAAE,KAAK,0BAA0B,EAAE,CAAC;gBACvC,OAAO;oBACN,yBAAyB,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG;oBACxD,yEAAyE;iBACzE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACb,CAAC;QACF,CAAC;KACD,CAAA;AACF,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+	"name": "@growth-labs/seo",
+	"version": "0.1.3",
+	"type": "module",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./utils": {
+			"types": "./dist/utils/index.d.ts",
+			"import": "./dist/utils/index.js"
+		},
+		"./utils/*": {
+			"types": "./dist/utils/*.d.ts",
+			"import": "./dist/utils/*.js"
+		},
+		"./middleware/*": {
+			"types": "./dist/middleware/*.d.ts",
+			"import": "./dist/middleware/*.js",
+			"default": "./dist/middleware/*.js"
+		},
+		"./routes/*": {
+			"types": "./dist/routes/*.d.ts",
+			"import": "./dist/routes/*.js",
+			"default": "./dist/routes/*.js"
+		},
+		"./state": {
+			"types": "./dist/state.d.ts",
+			"import": "./dist/state.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org/"
+	},
+	"scripts": {
+		"build": "tsc",
+		"test": "vitest run",
+		"test:watch": "vitest"
+	},
+	"peerDependencies": {
+		"astro": "^6.0.0"
+	},
+	"dependencies": {
+		"zod": "^3.23.0"
+	},
+	"devDependencies": {
+		"@types/node": "^25.5.0",
+		"astro": "^6.0.0",
+		"typescript": "^5.7.0",
+		"vite": "^7.0.0",
+		"vitest": "^3.0.0"
+	}
+}