@harpy-js/core 0.5.0 → 0.5.2

package/dist/decorators/jsx.decorator.d.ts

@@ -2,6 +2,7 @@ import { JsxLayout } from "../core/jsx.engine";
 export interface MetaOptions {
     title?: string;
     description?: string;
+    keywords?: string;
     canonical?: string;
     openGraph?: {
         title?: string;

package/dist/index.d.ts

@@ -7,6 +7,8 @@ export { StaticAssetsController } from "./core/static-assets.controller";
 export { JsxRender } from "./decorators/jsx.decorator";
 export { WithLayout } from "./decorators/layout.decorator";
 export type { MetaOptions, RenderOptions } from "./decorators/jsx.decorator";
+export { SeoModule, BaseSeoService, DefaultSeoService } from "./seo";
+export type { SitemapUrl, RobotsConfig, SeoModuleOptions } from "./seo";
 export type { JsxLayout, JsxLayoutProps, PageProps } from "./types/jsx.types";
 export { RouterModule } from "./core/router.module";
 export { NavigationService } from "./core/navigation.service";

package/dist/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getActiveItemIdFromManifest = exports.getActiveItemIdFromIndex = exports.buildHrefIndex = exports.Link = exports.setupHarpyApp = exports.configureHarpyApp = exports.AutoRegisterModule = exports.NavigationService = exports.RouterModule = exports.WithLayout = exports.JsxRender = exports.StaticAssetsController = exports.LiveReloadController = exports.withJsxEngine = exports.getHydrationManifest = exports.getChunkPath = exports.initializeHydrationContext = exports.hydrationContext = exports.autoWrapClientComponent = void 0;
+exports.getActiveItemIdFromManifest = exports.getActiveItemIdFromIndex = exports.buildHrefIndex = exports.Link = exports.setupHarpyApp = exports.configureHarpyApp = exports.AutoRegisterModule = exports.NavigationService = exports.RouterModule = exports.DefaultSeoService = exports.BaseSeoService = exports.SeoModule = exports.WithLayout = exports.JsxRender = exports.StaticAssetsController = exports.LiveReloadController = exports.withJsxEngine = exports.getHydrationManifest = exports.getChunkPath = exports.initializeHydrationContext = exports.hydrationContext = exports.autoWrapClientComponent = void 0;
 var client_component_wrapper_1 = require("./core/client-component-wrapper");
 Object.defineProperty(exports, "autoWrapClientComponent", { enumerable: true, get: function () { return client_component_wrapper_1.autoWrapClientComponent; } });
 var hydration_1 = require("./core/hydration");
@@ -22,6 +22,10 @@ var jsx_decorator_1 = require("./decorators/jsx.decorator");
 Object.defineProperty(exports, "JsxRender", { enumerable: true, get: function () { return jsx_decorator_1.JsxRender; } });
 var layout_decorator_1 = require("./decorators/layout.decorator");
 Object.defineProperty(exports, "WithLayout", { enumerable: true, get: function () { return layout_decorator_1.WithLayout; } });
+var seo_1 = require("./seo");
+Object.defineProperty(exports, "SeoModule", { enumerable: true, get: function () { return seo_1.SeoModule; } });
+Object.defineProperty(exports, "BaseSeoService", { enumerable: true, get: function () { return seo_1.BaseSeoService; } });
+Object.defineProperty(exports, "DefaultSeoService", { enumerable: true, get: function () { return seo_1.DefaultSeoService; } });
 var router_module_1 = require("./core/router.module");
 Object.defineProperty(exports, "RouterModule", { enumerable: true, get: function () { return router_module_1.RouterModule; } });
 var navigation_service_1 = require("./core/navigation.service");

package/dist/seo/index.d.ts

@@ -0,0 +1,5 @@
+export { SeoModule } from './seo.module';
+export { BaseSeoService, DefaultSeoService } from './seo.service';
+export { RobotsController } from './robots.controller';
+export { SitemapController } from './sitemap.controller';
+export type { SitemapUrl, RobotsConfig, SeoModuleOptions } from './seo.types';

package/dist/seo/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SitemapController = exports.RobotsController = exports.DefaultSeoService = exports.BaseSeoService = exports.SeoModule = void 0;
+var seo_module_1 = require("./seo.module");
+Object.defineProperty(exports, "SeoModule", { enumerable: true, get: function () { return seo_module_1.SeoModule; } });
+var seo_service_1 = require("./seo.service");
+Object.defineProperty(exports, "BaseSeoService", { enumerable: true, get: function () { return seo_service_1.BaseSeoService; } });
+Object.defineProperty(exports, "DefaultSeoService", { enumerable: true, get: function () { return seo_service_1.DefaultSeoService; } });
+var robots_controller_1 = require("./robots.controller");
+Object.defineProperty(exports, "RobotsController", { enumerable: true, get: function () { return robots_controller_1.RobotsController; } });
+var sitemap_controller_1 = require("./sitemap.controller");
+Object.defineProperty(exports, "SitemapController", { enumerable: true, get: function () { return sitemap_controller_1.SitemapController; } });

package/dist/seo/robots.controller.d.ts

@@ -0,0 +1,6 @@
+import { BaseSeoService } from './seo.service';
+export declare class RobotsController {
+    private readonly seoService;
+    constructor(seoService: BaseSeoService);
+    getRobots(): string;
+}

package/dist/seo/robots.controller.js

@@ -0,0 +1,37 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RobotsController = void 0;
+const common_1 = require("@nestjs/common");
+const seo_service_1 = require("./seo.service");
+let RobotsController = class RobotsController {
+    seoService;
+    constructor(seoService) {
+        this.seoService = seoService;
+    }
+    getRobots() {
+        const config = this.seoService.getRobotsConfig();
+        return this.seoService.formatRobotsTxt(config);
+    }
+};
+exports.RobotsController = RobotsController;
+__decorate([
+    (0, common_1.Get)(),
+    (0, common_1.Header)('Content-Type', 'text/plain'),
+    (0, common_1.Header)('Cache-Control', 'public, max-age=86400'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", String)
+], RobotsController.prototype, "getRobots", null);
+exports.RobotsController = RobotsController = __decorate([
+    (0, common_1.Controller)('robots.txt'),
+    __metadata("design:paramtypes", [seo_service_1.BaseSeoService])
+], RobotsController);

package/dist/seo/seo.module.d.ts

@@ -0,0 +1,7 @@
+import { DynamicModule, Type } from '@nestjs/common';
+import { BaseSeoService } from './seo.service';
+import type { SeoModuleOptions } from './seo.types';
+export declare class SeoModule {
+    static forRoot(options?: SeoModuleOptions): DynamicModule;
+    static forRootWithService(customService: Type<BaseSeoService>, options?: SeoModuleOptions): DynamicModule;
+}

package/dist/seo/seo.module.js

@@ -0,0 +1,54 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var SeoModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SeoModule = void 0;
+const common_1 = require("@nestjs/common");
+const robots_controller_1 = require("./robots.controller");
+const sitemap_controller_1 = require("./sitemap.controller");
+const seo_service_1 = require("./seo.service");
+let SeoModule = SeoModule_1 = class SeoModule {
+    static forRoot(options) {
+        return {
+            module: SeoModule_1,
+            controllers: [robots_controller_1.RobotsController, sitemap_controller_1.SitemapController],
+            providers: [
+                {
+                    provide: seo_service_1.SEO_MODULE_OPTIONS,
+                    useValue: options || {},
+                },
+                {
+                    provide: seo_service_1.BaseSeoService,
+                    useClass: seo_service_1.DefaultSeoService,
+                },
+            ],
+            exports: [seo_service_1.BaseSeoService],
+        };
+    }
+    static forRootWithService(customService, options) {
+        return {
+            module: SeoModule_1,
+            controllers: [robots_controller_1.RobotsController, sitemap_controller_1.SitemapController],
+            providers: [
+                {
+                    provide: seo_service_1.SEO_MODULE_OPTIONS,
+                    useValue: options || {},
+                },
+                {
+                    provide: seo_service_1.BaseSeoService,
+                    useClass: customService,
+                },
+            ],
+            exports: [seo_service_1.BaseSeoService],
+        };
+    }
+};
+exports.SeoModule = SeoModule;
+exports.SeoModule = SeoModule = SeoModule_1 = __decorate([
+    (0, common_1.Module)({})
+], SeoModule);

package/dist/seo/seo.service.d.ts

@@ -0,0 +1,16 @@
+import type { SitemapUrl, RobotsConfig, SeoModuleOptions } from './seo.types';
+export declare const SEO_MODULE_OPTIONS = "SEO_MODULE_OPTIONS";
+export declare abstract class BaseSeoService {
+    protected readonly options?: SeoModuleOptions | undefined;
+    protected readonly baseUrl: string;
+    constructor(options?: SeoModuleOptions | undefined);
+    abstract getSitemapUrls(): Promise<SitemapUrl[]>;
+    abstract getRobotsConfig(): RobotsConfig;
+    formatSitemapXml(urls: SitemapUrl[]): string;
+    formatRobotsTxt(config: RobotsConfig): string;
+    protected escapeXml(str: string): string;
+}
+export declare class DefaultSeoService extends BaseSeoService {
+    getSitemapUrls(): Promise<SitemapUrl[]>;
+    getRobotsConfig(): RobotsConfig;
+}

package/dist/seo/seo.service.js

@@ -0,0 +1,136 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultSeoService = exports.BaseSeoService = exports.SEO_MODULE_OPTIONS = void 0;
+const common_1 = require("@nestjs/common");
+exports.SEO_MODULE_OPTIONS = 'SEO_MODULE_OPTIONS';
+let BaseSeoService = class BaseSeoService {
+    options;
+    baseUrl;
+    constructor(options) {
+        this.options = options;
+        this.baseUrl = options?.baseUrl || 'http://localhost:3000';
+    }
+    formatSitemapXml(urls) {
+        const urlEntries = urls
+            .map((entry) => {
+            const lastmod = entry.lastModified
+                ? new Date(entry.lastModified).toISOString()
+                : new Date().toISOString();
+            return `  <url>
+    <loc>${this.escapeXml(entry.url)}</loc>
+    <lastmod>${lastmod}</lastmod>
+    ${entry.changeFrequency ? `<changefreq>${entry.changeFrequency}</changefreq>` : ''}
+    ${entry.priority !== undefined ? `<priority>${entry.priority}</priority>` : ''}
+  </url>`;
+        })
+            .join('\n');
+        return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urlEntries}
+</urlset>`;
+    }
+    formatRobotsTxt(config) {
+        const rules = Array.isArray(config.rules) ? config.rules : [config.rules];
+        const rulesText = rules
+            .map((rule) => {
+            const userAgents = Array.isArray(rule.userAgent)
+                ? rule.userAgent
+                : [rule.userAgent];
+            const allows = rule.allow
+                ? Array.isArray(rule.allow)
+                    ? rule.allow
+                    : [rule.allow]
+                : [];
+            const disallows = rule.disallow
+                ? Array.isArray(rule.disallow)
+                    ? rule.disallow
+                    : [rule.disallow]
+                : [];
+            let text = userAgents.map((ua) => `User-agent: ${ua}`).join('\n');
+            if (allows.length > 0) {
+                text += '\n' + allows.map((path) => `Allow: ${path}`).join('\n');
+            }
+            if (disallows.length > 0) {
+                text +=
+                    '\n' + disallows.map((path) => `Disallow: ${path}`).join('\n');
+            }
+            if (rule.crawlDelay) {
+                text += `\nCrawl-delay: ${rule.crawlDelay}`;
+            }
+            return text;
+        })
+            .join('\n\n');
+        let result = rulesText;
+        if (config.sitemap) {
+            const sitemaps = Array.isArray(config.sitemap)
+                ? config.sitemap
+                : [config.sitemap];
+            result += '\n\n' + sitemaps.map((s) => `Sitemap: ${s}`).join('\n');
+        }
+        if (config.host) {
+            result += `\n\nHost: ${config.host}`;
+        }
+        return result;
+    }
+    escapeXml(str) {
+        return str
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&apos;');
+    }
+};
+exports.BaseSeoService = BaseSeoService;
+exports.BaseSeoService = BaseSeoService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __param(0, (0, common_1.Inject)(exports.SEO_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], BaseSeoService);
+let DefaultSeoService = class DefaultSeoService extends BaseSeoService {
+    async getSitemapUrls() {
+        const now = new Date();
+        return [
+            {
+                url: this.baseUrl,
+                lastModified: now,
+                changeFrequency: 'daily',
+                priority: 1.0,
+            },
+        ];
+    }
+    getRobotsConfig() {
+        const defaultConfig = {
+            rules: {
+                userAgent: '*',
+                allow: '/',
+            },
+            sitemap: `${this.baseUrl}/sitemap.xml`,
+            host: this.baseUrl,
+        };
+        if (this.options?.robotsConfig) {
+            return {
+                ...defaultConfig,
+                ...this.options.robotsConfig,
+            };
+        }
+        return defaultConfig;
+    }
+};
+exports.DefaultSeoService = DefaultSeoService;
+exports.DefaultSeoService = DefaultSeoService = __decorate([
+    (0, common_1.Injectable)()
+], DefaultSeoService);

package/dist/seo/seo.types.d.ts

@@ -0,0 +1,29 @@
+export interface SitemapUrl {
+    url: string;
+    lastModified?: Date | string;
+    changeFrequency?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+    priority?: number;
+    alternates?: {
+        languages?: Record<string, string>;
+    };
+}
+export interface RobotsConfig {
+    rules: {
+        userAgent: string | string[];
+        allow?: string | string[];
+        disallow?: string | string[];
+        crawlDelay?: number;
+    } | Array<{
+        userAgent: string | string[];
+        allow?: string | string[];
+        disallow?: string | string[];
+        crawlDelay?: number;
+    }>;
+    sitemap?: string | string[];
+    host?: string;
+}
+export interface SeoModuleOptions {
+    baseUrl: string;
+    robotsConfig?: Partial<RobotsConfig>;
+    sitemapGenerator?: () => Promise<SitemapUrl[]>;
+}

package/dist/seo/seo.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/seo/sitemap.controller.d.ts

@@ -0,0 +1,6 @@
+import { BaseSeoService } from './seo.service';
+export declare class SitemapController {
+    private readonly seoService;
+    constructor(seoService: BaseSeoService);
+    getSitemap(): Promise<string>;
+}

package/dist/seo/sitemap.controller.js

@@ -0,0 +1,37 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SitemapController = void 0;
+const common_1 = require("@nestjs/common");
+const seo_service_1 = require("./seo.service");
+let SitemapController = class SitemapController {
+    seoService;
+    constructor(seoService) {
+        this.seoService = seoService;
+    }
+    async getSitemap() {
+        const urls = await this.seoService.getSitemapUrls();
+        return this.seoService.formatSitemapXml(urls);
+    }
+};
+exports.SitemapController = SitemapController;
+__decorate([
+    (0, common_1.Get)(),
+    (0, common_1.Header)('Content-Type', 'application/xml'),
+    (0, common_1.Header)('Cache-Control', 'public, max-age=3600, s-maxage=3600'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], SitemapController.prototype, "getSitemap", null);
+exports.SitemapController = SitemapController = __decorate([
+    (0, common_1.Controller)('sitemap.xml'),
+    __metadata("design:paramtypes", [seo_service_1.BaseSeoService])
+], SitemapController);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harpy-js/core",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Harpy - A powerful NestJS + React/JSX SSR framework with automatic hydration and i18n support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/decorators/jsx.decorator.ts

@@ -4,6 +4,7 @@ import { JsxLayout } from "../core/jsx.engine";
 export interface MetaOptions {
   title?: string;
   description?: string;
+  keywords?: string;
   canonical?: string;
   openGraph?: {
     title?: string;

package/src/index.ts

@@ -11,6 +11,10 @@ export { JsxRender } from "./decorators/jsx.decorator";
 export { WithLayout } from "./decorators/layout.decorator";
 export type { MetaOptions, RenderOptions } from "./decorators/jsx.decorator";
 
+// SEO Module
+export { SeoModule, BaseSeoService, DefaultSeoService } from "./seo";
+export type { SitemapUrl, RobotsConfig, SeoModuleOptions } from "./seo";
+
 // I18n is provided in a separate package: @harpy-js/i18n
 // Consumers should import i18n types and modules from that package.
 

package/src/seo/index.ts

@@ -0,0 +1,5 @@
+export { SeoModule } from './seo.module';
+export { BaseSeoService, DefaultSeoService } from './seo.service';
+export { RobotsController } from './robots.controller';
+export { SitemapController } from './sitemap.controller';
+export type { SitemapUrl, RobotsConfig, SeoModuleOptions } from './seo.types';

package/src/seo/robots.controller.ts

@@ -0,0 +1,15 @@
+import { Controller, Get, Header } from '@nestjs/common';
+import { BaseSeoService } from './seo.service';
+
+@Controller('robots.txt')
+export class RobotsController {
+  constructor(private readonly seoService: BaseSeoService) {}
+
+  @Get()
+  @Header('Content-Type', 'text/plain')
+  @Header('Cache-Control', 'public, max-age=86400') // Cache for 24 hours
+  getRobots(): string {
+    const config = this.seoService.getRobotsConfig();
+    return this.seoService.formatRobotsTxt(config);
+  }
+}

package/src/seo/seo.module.ts

@@ -0,0 +1,59 @@
+import { Module, DynamicModule, Type } from '@nestjs/common';
+import { RobotsController } from './robots.controller';
+import { SitemapController } from './sitemap.controller';
+import {
+  BaseSeoService,
+  DefaultSeoService,
+  SEO_MODULE_OPTIONS,
+} from './seo.service';
+import type { SeoModuleOptions } from './seo.types';
+
+@Module({})
+export class SeoModule {
+  /**
+   * Register the SEO module with default implementation
+   */
+  static forRoot(options?: SeoModuleOptions): DynamicModule {
+    return {
+      module: SeoModule,
+      controllers: [RobotsController, SitemapController],
+      providers: [
+        {
+          provide: SEO_MODULE_OPTIONS,
+          useValue: options || {},
+        },
+        {
+          provide: BaseSeoService,
+          useClass: DefaultSeoService,
+        },
+      ],
+      exports: [BaseSeoService],
+    };
+  }
+
+  /**
+   * Register the SEO module with a custom service implementation
+   * @param customService Your custom service that extends BaseSeoService
+   * @param options Optional configuration options
+   */
+  static forRootWithService(
+    customService: Type<BaseSeoService>,
+    options?: SeoModuleOptions,
+  ): DynamicModule {
+    return {
+      module: SeoModule,
+      controllers: [RobotsController, SitemapController],
+      providers: [
+        {
+          provide: SEO_MODULE_OPTIONS,
+          useValue: options || {},
+        },
+        {
+          provide: BaseSeoService,
+          useClass: customService,
+        },
+      ],
+      exports: [BaseSeoService],
+    };
+  }
+}

package/src/seo/seo.service.ts

@@ -0,0 +1,161 @@
+import { Injectable, Inject, Optional } from '@nestjs/common';
+import type { SitemapUrl, RobotsConfig, SeoModuleOptions } from './seo.types';
+
+export const SEO_MODULE_OPTIONS = 'SEO_MODULE_OPTIONS';
+
+@Injectable()
+export abstract class BaseSeoService {
+  protected readonly baseUrl: string;
+
+  constructor(
+    @Optional()
+    @Inject(SEO_MODULE_OPTIONS)
+    protected readonly options?: SeoModuleOptions,
+  ) {
+    this.baseUrl = options?.baseUrl || 'http://localhost:3000';
+  }
+
+  /**
+   * Override this method to provide custom sitemap URLs
+   * This can fetch from database, CMS, or any other source
+   */
+  abstract getSitemapUrls(): Promise<SitemapUrl[]>;
+
+  /**
+   * Override this method to provide custom robots.txt configuration
+   */
+  abstract getRobotsConfig(): RobotsConfig;
+
+  /**
+   * Format sitemap URLs to XML string
+   */
+  formatSitemapXml(urls: SitemapUrl[]): string {
+    const urlEntries = urls
+      .map((entry) => {
+        const lastmod = entry.lastModified
+          ? new Date(entry.lastModified).toISOString()
+          : new Date().toISOString();
+
+        return `  <url>
+    <loc>${this.escapeXml(entry.url)}</loc>
+    <lastmod>${lastmod}</lastmod>
+    ${entry.changeFrequency ? `<changefreq>${entry.changeFrequency}</changefreq>` : ''}
+    ${entry.priority !== undefined ? `<priority>${entry.priority}</priority>` : ''}
+  </url>`;
+      })
+      .join('\n');
+
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urlEntries}
+</urlset>`;
+  }
+
+  /**
+   * Format robots.txt configuration to string
+   */
+  formatRobotsTxt(config: RobotsConfig): string {
+    const rules = Array.isArray(config.rules) ? config.rules : [config.rules];
+
+    const rulesText = rules
+      .map((rule) => {
+        const userAgents = Array.isArray(rule.userAgent)
+          ? rule.userAgent
+          : [rule.userAgent];
+        const allows = rule.allow
+          ? Array.isArray(rule.allow)
+            ? rule.allow
+            : [rule.allow]
+          : [];
+        const disallows = rule.disallow
+          ? Array.isArray(rule.disallow)
+            ? rule.disallow
+            : [rule.disallow]
+          : [];
+
+        let text = userAgents.map((ua) => `User-agent: ${ua}`).join('\n');
+
+        if (allows.length > 0) {
+          text += '\n' + allows.map((path) => `Allow: ${path}`).join('\n');
+        }
+
+        if (disallows.length > 0) {
+          text +=
+            '\n' + disallows.map((path) => `Disallow: ${path}`).join('\n');
+        }
+
+        if (rule.crawlDelay) {
+          text += `\nCrawl-delay: ${rule.crawlDelay}`;
+        }
+
+        return text;
+      })
+      .join('\n\n');
+
+    let result = rulesText;
+
+    if (config.sitemap) {
+      const sitemaps = Array.isArray(config.sitemap)
+        ? config.sitemap
+        : [config.sitemap];
+      result += '\n\n' + sitemaps.map((s) => `Sitemap: ${s}`).join('\n');
+    }
+
+    if (config.host) {
+      result += `\n\nHost: ${config.host}`;
+    }
+
+    return result;
+  }
+
+  protected escapeXml(str: string): string {
+    return str
+      .replace(/&/g, '&amp;')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;')
+      .replace(/'/g, '&apos;');
+  }
+}
+
+/**
+ * Default SEO service implementation
+ * Users can extend BaseSeoService to provide custom implementations
+ */
+@Injectable()
+export class DefaultSeoService extends BaseSeoService {
+  async getSitemapUrls(): Promise<SitemapUrl[]> {
+    const now = new Date();
+
+    // Default homepage only
+    return [
+      {
+        url: this.baseUrl,
+        lastModified: now,
+        changeFrequency: 'daily',
+        priority: 1.0,
+      },
+    ];
+  }
+
+  getRobotsConfig(): RobotsConfig {
+    const defaultConfig: RobotsConfig = {
+      rules: {
+        userAgent: '*',
+        allow: '/',
+      },
+      sitemap: `${this.baseUrl}/sitemap.xml`,
+      host: this.baseUrl,
+    };
+
+    // Merge with options if provided
+    if (this.options?.robotsConfig) {
+      return {
+        ...defaultConfig,
+        ...this.options.robotsConfig,
+      };
+    }
+
+    return defaultConfig;
+  }
+}

package/src/seo/seo.types.ts

@@ -0,0 +1,40 @@
+export interface SitemapUrl {
+  url: string;
+  lastModified?: Date | string;
+  changeFrequency?:
+    | 'always'
+    | 'hourly'
+    | 'daily'
+    | 'weekly'
+    | 'monthly'
+    | 'yearly'
+    | 'never';
+  priority?: number;
+  alternates?: {
+    languages?: Record<string, string>;
+  };
+}
+
+export interface RobotsConfig {
+  rules:
+    | {
+        userAgent: string | string[];
+        allow?: string | string[];
+        disallow?: string | string[];
+        crawlDelay?: number;
+      }
+    | Array<{
+        userAgent: string | string[];
+        allow?: string | string[];
+        disallow?: string | string[];
+        crawlDelay?: number;
+      }>;
+  sitemap?: string | string[];
+  host?: string;
+}
+
+export interface SeoModuleOptions {
+  baseUrl: string;
+  robotsConfig?: Partial<RobotsConfig>;
+  sitemapGenerator?: () => Promise<SitemapUrl[]>;
+}

package/src/seo/sitemap.controller.ts

@@ -0,0 +1,15 @@
+import { Controller, Get, Header } from '@nestjs/common';
+import { BaseSeoService } from './seo.service';
+
+@Controller('sitemap.xml')
+export class SitemapController {
+  constructor(private readonly seoService: BaseSeoService) {}
+
+  @Get()
+  @Header('Content-Type', 'application/xml')
+  @Header('Cache-Control', 'public, max-age=3600, s-maxage=3600') // Cache for 1 hour
+  async getSitemap(): Promise<string> {
+    const urls = await this.seoService.getSitemapUrls();
+    return this.seoService.formatSitemapXml(urls);
+  }
+}