SEO & Discoverability

1import { Module } from '@nestjs/common';2import { SeoModule } from '@harpy-js/core';34@Module({5  imports: [6    SeoModule.forRoot({7      baseUrl: process.env.BASE_URL || 'http://localhost:3000',8    }),9  ],10})11export class AppModule {}

1User-agent: *2Allow: /3Disallow: /api/4Disallow: /private/56Sitemap: https://example.com/sitemap.xml78Host: https://example.com

1<?xml version="1.0" encoding="UTF-8"?>2<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">3  <url>4    <loc>https://example.com</loc>5    <lastmod>2025-12-13T12:00:00.000Z</lastmod>6    <changefreq>daily</changefreq>7    <priority>1</priority>8  </url>9  <url>10    <loc>https://example.com/about</loc>11    <lastmod>2025-12-13T12:00:00.000Z</lastmod>12    <changefreq>monthly</changefreq>13    <priority>0.8</priority>14  </url>15</urlset>

1import { Injectable } from '@nestjs/common';2import { BaseSeoService, SitemapUrl, RobotsConfig } from '@harpy-js/core';34@Injectable()5export class SeoService extends BaseSeoService {6  getSitemapUrls(): Promise<SitemapUrl[]> {7    const now = new Date();89    return Promise.resolve([10      {11        url: this.baseUrl,12        lastModified: now,13        changeFrequency: 'daily',14        priority: 1.0,15      },16      {17        url: `${this.baseUrl}/about`,18        lastModified: now,19        changeFrequency: 'monthly',20        priority: 0.8,21      },22    ]);23  }2425  getRobotsConfig(): RobotsConfig {26    return {27      rules: {28        userAgent: '*',29        allow: '/',30        disallow: ['/api/', '/admin/'],31      },32      sitemap: `${this.baseUrl}/sitemap.xml`,33      host: this.baseUrl,34    };35  }36}

1import { Module } from '@nestjs/common';2import { SeoModule } from '@harpy-js/core';3import { SeoService } from './seo.service';45@Module({6  imports: [7    SeoModule.forRootWithService(SeoService, {8      baseUrl: process.env.BASE_URL || 'http://localhost:3000',9    }),10  ],11})12export class AppModule {}

1import { Injectable } from '@nestjs/common';2import { BaseSeoService, SitemapUrl } from '@harpy-js/core';3import { InjectRepository } from '@nestjs/typeorm';4import { Repository } from 'typeorm';5import { Post } from './entities/post.entity';67@Injectable()8export class SeoService extends BaseSeoService {9  constructor(10    @InjectRepository(Post)11    private postsRepository: Repository<Post>,12  ) {13    super();14  }1516  async getSitemapUrls(): Promise<SitemapUrl[]> {17    const staticPages: SitemapUrl[] = [18      {19        url: this.baseUrl,20        lastModified: new Date(),21        changeFrequency: 'daily',22        priority: 1.0,23      },24    ];2526    // Fetch blog posts from database27    const posts = await this.postsRepository.find({28      select: ['slug', 'updatedAt'],29      where: { published: true },30    });3132    const dynamicPages = posts.map((post) => ({33      url: `${this.baseUrl}/blog/${post.slug}`,34      lastModified: post.updatedAt,35      changeFrequency: 'weekly' as const,36      priority: 0.7,37    }));3839    return [...staticPages, ...dynamicPages];40  }4142  getRobotsConfig() {43    return {44      rules: { userAgent: '*', allow: '/' },45      sitemap: `${this.baseUrl}/sitemap.xml`,46    };47  }48}

1getSitemapUrls(): Promise<SitemapUrl[]> {2  const locales = ['en', 'fr', 'es'];3  const pages = ['/', '/about', '/contact'];4  5  const urls: SitemapUrl[] = [];6  7  for (const locale of locales) {8    for (const page of pages) {9      urls.push({10        url: `${this.baseUrl}/${locale}${page}`,11        lastModified: new Date(),12        changeFrequency: 'weekly',13        priority: page === '/' ? 1.0 : 0.8,14        alternates: {15          languages: locales.reduce((acc, lang) => {16            acc[lang] = `${this.baseUrl}/${lang}${page}`;17            return acc;18          }, {} as Record<string, string>),19        },20      });21    }22  }23  24  return Promise.resolve(urls);25}

1getRobotsConfig(): RobotsConfig {2  return {3    rules: [4      {5        userAgent: 'Googlebot',6        allow: '/',7        crawlDelay: 0,8      },9      {10        userAgent: 'Bingbot',11        allow: '/',12        crawlDelay: 1,13      },14      {15        userAgent: '*',16        disallow: ['/api/', '/admin/', '/private/'],17      },18    ],19    sitemap: [20      `${this.baseUrl}/sitemap.xml`,21      `${this.baseUrl}/sitemap-images.xml`,22    ],23    host: this.baseUrl,24  };25}

1interface SitemapUrl {2  url: string;3  lastModified?: Date | string;4  changeFrequency?: 5    | 'always' 6    | 'hourly' 7    | 'daily' 8    | 'weekly' 9    | 'monthly' 10    | 'yearly' 11    | 'never';12  priority?: number; // 0.0 to 1.013  alternates?: {14    languages?: Record<string, string>;15  };16}1718interface RobotsConfig {19  rules: {20    userAgent: string | string[];21    allow?: string | string[];22    disallow?: string | string[];23    crawlDelay?: number;24  } | Array<{...}>;25  sitemap?: string | string[];26  host?: string;27}

1# Test robots.txt2curl http://localhost:3000/robots.txt34# Test sitemap.xml5curl http://localhost:3000/sitemap.xml

1import { NestFactory } from '@nestjs/core';2import { FastifyAdapter } from '@nestjs/platform-fastify';3import { setupHarpyApp } from '@harpy-js/core';45async function bootstrap() {6  const adapter = new FastifyAdapter();7  const app = await NestFactory.create(AppModule, adapter);89  await setupHarpyApp(app, {10    enforceRedirects: true,           // Enable canonical redirects11    mainDomain: 'example.com',        // Your canonical domain12    enforceHttps: true,               // Redirect HTTP → HTTPS13    redirectWww: true,                // Redirect www → non-www14  });1516  await app.listen(process.env.PORT || 3000, '0.0.0.0');17}18bootstrap();