@growth-labs/seo 0.1.3

package/README.md

@@ -0,0 +1,80 @@
+# @growth-labs/seo
+
+Astro integration for complete SEO infrastructure on Cloudflare. Handles JSON-LD structured data, meta tags, sitemaps, RSS/podcast feeds, AEO (Answer Engine Optimization), multilingual support, robots.txt, llms.txt, and build-time validation.
+
+## Config
+
+```typescript
+import seo from '@growth-labs/seo'
+
+seo({
+  site: 'https://warfronts.channel',
+  schemaType: 'Article',                        // Default JSON-LD type
+  organization: {
+    name: 'WarFronts',
+    logo: 'https://media.warfronts.channel/logos/header.png',
+    sameAs: ['https://youtube.com/@warfronts'],
+  },
+  googleNews: false,                             // Include in Google News sitemap
+  aeoTwins: true,                                // Accept: text/markdown content negotiation
+  llmsTxt: true,                                 // Serve /llms.txt
+  rss: true,                                     // Serve /feed.xml
+  contentSignal: {                               // Content-Signal HTTP header
+    aiTrain: 'no',
+    search: 'yes',
+    aiInput: 'yes',
+  },
+  defaults: {
+    titleSuffix: ' | WarFronts',
+    twitterSite: '@warfronts',
+  },
+  // Optional:
+  commerce: { enabled: true, currency: 'USD', returnPolicy: { ... } },
+  podcast: { enabled: true, title: '...', author: '...', ... },
+  audioNarration: { enabled: true, narratorName: '...', asPodcastFeed: true },
+  locales: [{ lang: 'en', region: 'US', default: true }],   // Multilingual
+})
+```
+
+## What It Injects
+
+**Middleware** (order: `post`):
+- Adds `Content-Signal` header to responses
+- Adds `Link` alternate header for hreflang
+- Handles `Accept: text/markdown` → returns markdown twin (AEO)
+
+**Routes:**
+- `/sitemap-index.xml` — sitemap index
+- `/sitemap-articles.xml`, `/sitemap-pages.xml`, `/sitemap-videos.xml`
+- `/sitemap-products.xml` (if commerce enabled)
+- `/robots.txt` — with AI crawler blocking directives
+- `/llms.txt` (if enabled)
+- `/feed.xml` (if RSS enabled)
+- `/podcast.xml` (if podcast enabled)
+- `/listen.xml` (if audio narration podcast feed enabled)
+
+## Standalone Utilities
+
+Available without the integration:
+
+```typescript
+import { generateJsonLd, generateMeta } from '@growth-labs/seo/utils'
+import { articleJsonLd } from '@growth-labs/seo/utils/json-ld/article'
+import { productJsonLd } from '@growth-labs/seo/utils/json-ld/product'
+```
+
+**JSON-LD generators:** Article, NewsArticle, BlogPosting, FAQPage, VideoObject, AudioObject, Person, HowTo, Product, ProductGroup, Review, AggregateRating, BreadcrumbList, Organization, WebSite, ItemList, SpeakableSpecification
+
+**Other utilities:** `generateMeta()` (OG + Twitter Card), sitemap XML, RSS/Atom, podcast RSS (iTunes namespace), hreflang tags, robots.txt, llms.txt
+
+## Wrangler Bindings
+
+None required.
+
+## Key Patterns
+
+- Virtual module: `virtual:growth-labs/seo/config`
+- AI crawler blocking happens at Cloudflare CDN level, NOT in this package
+- AEO twins: same content as markdown via `Accept: text/markdown` content negotiation
+- Build-time validation warns on missing titles, descriptions, JSON-LD issues (non-blocking)
+- `.astro` component files ship as source from `src/components/`

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { AstroIntegration } from 'astro';
+import { type SeoOptions } from './options.js';
+export default function seo(userOptions: SeoOptions): AstroIntegration;
+export type { ResolvedSeoOptions, SeoOptions } from './options.js';
+export { seoOptionsSchema } from './options.js';
+export { getConfig, getContentProvider } from './state.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,cAAc,CAAA;AAYhE,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,WAAW,EAAE,UAAU,GAAG,gBAAgB,CA+IrE;AAeD,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC1D,mBAAmB,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,162 @@
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { seoOptionsSchema } from './options.js';
+import { _setConfig, _setContentProvider } from './state.js';
+import { SITEMAP_INDEX_PATH } from './utils/sitemap.js';
+import { validateJsonLd, validatePage } from './utils/validation.js';
+import { growthLabsSeoPlugin } from './vite-plugin.js';
+const ENTRYPOINT_EXTENSION = import.meta.url.endsWith('.ts') ? '.ts' : '.js';
+function resolveEntrypoint(path) {
+    return fileURLToPath(new URL(`${path}${ENTRYPOINT_EXTENSION}`, import.meta.url));
+}
+export default function seo(userOptions) {
+    const options = seoOptionsSchema.parse(userOptions);
+    _setConfig(options);
+    if (userOptions.contentProvider) {
+        _setContentProvider(userOptions.contentProvider);
+    }
+    return {
+        name: '@growth-labs/seo',
+        hooks: {
+            'astro:config:setup': ({ addMiddleware, injectRoute, updateConfig }) => {
+                updateConfig({ vite: { plugins: [growthLabsSeoPlugin(options)] } });
+                addMiddleware({ entrypoint: resolveEntrypoint('./middleware/seo'), order: 'post' });
+                // Sitemaps
+                injectRoute({
+                    pattern: SITEMAP_INDEX_PATH,
+                    entrypoint: resolveEntrypoint('./routes/sitemap-index'),
+                    prerender: false,
+                });
+                injectRoute({
+                    pattern: '/sitemap-articles.xml',
+                    entrypoint: resolveEntrypoint('./routes/sitemap-articles'),
+                    prerender: false,
+                });
+                injectRoute({
+                    pattern: '/sitemap-pages.xml',
+                    entrypoint: resolveEntrypoint('./routes/sitemap-pages'),
+                    prerender: false,
+                });
+                injectRoute({
+                    pattern: '/sitemap-videos.xml',
+                    entrypoint: resolveEntrypoint('./routes/sitemap-videos'),
+                    prerender: false,
+                });
+                if (options.commerce?.enabled) {
+                    injectRoute({
+                        pattern: '/sitemap-products.xml',
+                        entrypoint: resolveEntrypoint('./routes/sitemap-products'),
+                        prerender: false,
+                    });
+                }
+                // Robots + llms
+                injectRoute({
+                    pattern: '/robots.txt',
+                    entrypoint: resolveEntrypoint('./routes/robots'),
+                    prerender: false,
+                });
+                if (options.llmsTxt) {
+                    injectRoute({
+                        pattern: '/llms.txt',
+                        entrypoint: resolveEntrypoint('./routes/llms'),
+                        prerender: false,
+                    });
+                }
+                // RSS
+                if (options.rss) {
+                    injectRoute({
+                        pattern: '/feed.xml',
+                        entrypoint: resolveEntrypoint('./routes/rss'),
+                        prerender: false,
+                    });
+                }
+                // Podcast
+                if (options.podcast?.enabled) {
+                    injectRoute({
+                        pattern: options.podcast.feedPath,
+                        entrypoint: resolveEntrypoint('./routes/podcast'),
+                        prerender: false,
+                    });
+                }
+                // Narrated articles podcast feed
+                if (options.audioNarration?.asPodcastFeed) {
+                    injectRoute({
+                        pattern: options.audioNarration.podcastFeedPath,
+                        entrypoint: resolveEntrypoint('./routes/podcast-narration'),
+                        prerender: false,
+                    });
+                }
+            },
+            'astro:build:done': async ({ dir, logger }) => {
+                if (!options.validation.enabled)
+                    return;
+                const outDir = fileURLToPath(dir);
+                const htmlFiles = findHtmlFiles(outDir);
+                let errorCount = 0;
+                let warningCount = 0;
+                for (const file of htmlFiles) {
+                    const html = readFileSync(file, 'utf-8');
+                    const result = validatePage(html, {
+                        titleMaxLength: options.validation.titleMaxLength,
+                        descriptionMaxLength: options.validation.descriptionMaxLength,
+                        heroMinWidth: options.validation.heroMinWidth,
+                    });
+                    const relPath = file.replace(outDir, '');
+                    for (const error of result.errors) {
+                        logger.error(`${relPath}: ${error}`);
+                        errorCount++;
+                    }
+                    for (const warning of result.warnings) {
+                        logger.warn(`${relPath}: ${warning}`);
+                        warningCount++;
+                    }
+                    // Validate JSON-LD blocks
+                    const jsonLdMatches = html.matchAll(/<script type="application\/ld\+json">([\s\S]*?)<\/script>/gi);
+                    for (const match of jsonLdMatches) {
+                        try {
+                            const parsed = JSON.parse(match[1]);
+                            const ldResult = validateJsonLd(parsed);
+                            for (const e of ldResult.errors) {
+                                logger.error(`${relPath} [JSON-LD]: ${e}`);
+                                errorCount++;
+                            }
+                            for (const w of ldResult.warnings) {
+                                logger.warn(`${relPath} [JSON-LD]: ${w}`);
+                                warningCount++;
+                            }
+                        }
+                        catch {
+                            logger.error(`${relPath}: Invalid JSON-LD`);
+                            errorCount++;
+                        }
+                    }
+                }
+                if (errorCount || warningCount) {
+                    logger.info(`SEO validation: ${errorCount} errors, ${warningCount} warnings`);
+                }
+                else {
+                    logger.info('SEO validation: all checks passed');
+                }
+            },
+        },
+    };
+}
+function findHtmlFiles(dir) {
+    const results = [];
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory())
+                results.push(...findHtmlFiles(fullPath));
+            else if (entry.name.endsWith('.html'))
+                results.push(fullPath);
+        }
+    }
+    catch { }
+    return results;
+}
+export { seoOptionsSchema } from './options.js';
+export { getConfig, getContentProvider } from './state.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/middleware/seo.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedSeoOptions } from '../options.js';
+import type { ContentProvider } from '../types.js';
+export declare function createSeoMiddleware(options: ResolvedSeoOptions, contentProvider?: ContentProvider): (context: any, next: () => Promise<Response>) => Promise<Response>;
+export declare const onRequest: (context: any, next: () => Promise<Response>) => Promise<Response>;
+//# sourceMappingURL=seo.d.ts.map

package/dist/middleware/seo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../src/middleware/seo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AASlD,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,kBAAkB,EAC3B,eAAe,CAAC,EAAE,eAAe,IAEnB,SAAS,GAAG,EAAE,MAAM,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAG,OAAO,CAAC,QAAQ,CAAC,CAgE7E;AAGD,eAAO,MAAM,SAAS,GAAU,SAAS,GAAG,EAAE,MAAM,MAAM,OAAO,CAAC,QAAQ,CAAC,sBAK1E,CAAA"}

package/dist/middleware/seo.js

@@ -0,0 +1,70 @@
+import { getConfig, getContentProvider } from '../state.js';
+import { estimateTokenCount, generateAeoMarkdown } from '../utils/aeo.js';
+function buildContentSignalHeader(config) {
+    const { aiTrain, search, aiInput } = config.contentSignal;
+    return `ai-train=${aiTrain}, search=${search}, ai-input=${aiInput}`;
+}
+// Factory for testability
+export function createSeoMiddleware(options, contentProvider) {
+    return async (context, next) => {
+        const { request } = context;
+        const accept = request.headers.get('accept') ?? '';
+        const url = new URL(request.url);
+        // AEO content negotiation: intercept Accept: text/markdown requests
+        if (options.aeoTwins && accept.includes('text/markdown') && contentProvider) {
+            try {
+                const articles = await contentProvider({ type: 'articles' }, context);
+                const matched = articles.find((a) => {
+                    try {
+                        return new URL(a.url).pathname === url.pathname;
+                    }
+                    catch {
+                        return a.url === url.pathname;
+                    }
+                });
+                if (matched) {
+                    const content = matched.description ?? '';
+                    const markdown = generateAeoMarkdown(matched, content, options.schemaType, options.organization.name);
+                    const tokenCount = estimateTokenCount(markdown);
+                    const contentSignal = buildContentSignalHeader(options);
+                    return new Response(markdown, {
+                        headers: {
+                            'Content-Type': 'text/markdown; charset=utf-8',
+                            'x-markdown-tokens': String(tokenCount),
+                            'content-signal': contentSignal,
+                        },
+                    });
+                }
+            }
+            catch { }
+        }
+        // Pass through to next middleware/route handler
+        const response = await next();
+        // Clone to add headers (Response headers are immutable)
+        const newHeaders = new Headers(response.headers);
+        // Add Content-Signal header to every response
+        newHeaders.set('content-signal', buildContentSignalHeader(options));
+        // Add Link alternate header on HTML responses when aeoTwins enabled
+        if (options.aeoTwins) {
+            const contentType = response.headers.get('content-type') ?? '';
+            if (contentType.includes('text/html')) {
+                const linkValue = `<${url.toString()}>; rel="alternate"; type="text/markdown"`;
+                const existing = newHeaders.get('Link');
+                newHeaders.set('Link', existing ? `${existing}, ${linkValue}` : linkValue);
+            }
+        }
+        return new Response(response.body, {
+            status: response.status,
+            statusText: response.statusText,
+            headers: newHeaders,
+        });
+    };
+}
+// Astro middleware entry point
+export const onRequest = async (context, next) => {
+    const config = getConfig();
+    const contentProvider = getContentProvider();
+    const middleware = createSeoMiddleware(config, contentProvider);
+    return middleware(context, next);
+};
+//# sourceMappingURL=seo.js.map

package/dist/middleware/seo.js.map

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