lovable-ssr 0.1.18 → 0.1.19

package/README.md

@@ -1,6 +1,6 @@
 # lovable-ssr
 
-SSR and route data engine for [Lovable](https://lovable.dev) projects: route registry, `getServerData`, Express + Vite server.
+SSR and route data engine for [Lovable](https://lovable.dev) projects: route registry, `getData`, Express + Vite server, and built-in SEO support.
 
 **Documentation:** [Documentação completa](https://calm-meadow-5cf6.github-8c8.workers.dev/)
 
@@ -8,6 +8,8 @@ SSR and route data engine for [Lovable](https://lovable.dev) projects: route reg
 
 ```bash
 npm i lovable-ssr
+# or
+yarn add lovable-ssr
 ```
 
 Peer dependencies: `react`, `react-dom`, `react-router-dom` (^18 / ^6).
@@ -17,6 +19,7 @@ Peer dependencies: `react`, `react-dom`, `react-router-dom` (^18 / ^6).
 1. Register routes with `registerRoutes(routes)`.
 2. Wrap your app with `BrowserRouteDataProvider` and render `AppRoutes` (inside `BrowserRouter`).
 3. (Optional) SSR: entry module + `createServer` from `lovable-ssr/server`.
+4. (Optional) SEO: add `<SEO />` on pages to set meta tags and JSON-LD; helmet content is injected during SSR.
 
 Details, examples, and API: see the [documentation](https://calm-meadow-5cf6.github-8c8.workers.dev/).
 

package/dist/components/BrowserRouteDataProvider.d.ts

@@ -1,6 +1,6 @@
 import type { ReactNode } from 'react';
 /**
- * Wraps children with RouteDataProvider using initial data from the browser:
+ * Wraps children with HelmetProvider and RouteDataProvider using initial data from the browser:
  * - window.__PRELOADED_DATA__ (from SSR)
  * - window.location.pathname + RouterService for matchedRoute and routeParams
  *

package/dist/components/BrowserRouteDataProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BrowserRouteDataProvider.d.ts","sourceRoot":"","sources":["../../src/components/BrowserRouteDataProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CA0B7E"}
+{"version":3,"file":"BrowserRouteDataProvider.d.ts","sourceRoot":"","sources":["../../src/components/BrowserRouteDataProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CA4B7E"}

package/dist/components/BrowserRouteDataProvider.js

@@ -1,8 +1,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { HelmetProvider } from 'react-helmet-async';
 import RouterService from '../router/RouterService.js';
 import { RouteDataProvider } from '../router/RouteDataContext.js';
 /**
- * Wraps children with RouteDataProvider using initial data from the browser:
+ * Wraps children with HelmetProvider and RouteDataProvider using initial data from the browser:
  * - window.__PRELOADED_DATA__ (from SSR)
  * - window.location.pathname + RouterService for matchedRoute and routeParams
  *
@@ -21,5 +22,5 @@ export function BrowserRouteDataProvider({ children }) {
         routeParams: routeParamsResult.routeParams,
         searchParams: Object.keys(searchParams).length > 0 ? searchParams : routeParamsResult.searchParams,
     };
-    return (_jsx(RouteDataProvider, { initialData: preloadedData, initialRoute: matchedRoute, initialParams: initialParams, children: children }));
+    return (_jsx(HelmetProvider, { children: _jsx(RouteDataProvider, { initialData: preloadedData, initialRoute: matchedRoute, initialParams: initialParams, children: children }) }));
 }

package/dist/components/SEO.d.ts

@@ -0,0 +1,15 @@
+export interface SEOProps {
+    title: string;
+    description: string;
+    image?: string;
+    url?: string;
+    type?: string;
+    noindex?: boolean;
+    structuredData?: object;
+}
+/**
+ * Centralized SEO component for meta tags and JSON-LD.
+ * Use within HelmetProvider (provided by framework at app level).
+ */
+export declare function SEO({ title, description, image, url, type, noindex, structuredData, }: SEOProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SEO.d.ts.map

package/dist/components/SEO.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SEO.d.ts","sourceRoot":"","sources":["../../src/components/SEO.tsx"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,EAClB,KAAK,EACL,WAAW,EACX,KAAK,EACL,GAAG,EACH,IAAgB,EAChB,OAAe,EACf,cAAc,GACf,EAAE,QAAQ,2CAuBV"}

package/dist/components/SEO.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Helmet } from 'react-helmet-async';
+/**
+ * Centralized SEO component for meta tags and JSON-LD.
+ * Use within HelmetProvider (provided by framework at app level).
+ */
+export function SEO({ title, description, image, url, type = 'website', noindex = false, structuredData, }) {
+    return (_jsxs(Helmet, { children: [_jsx("title", { children: title }), _jsx("meta", { name: "description", content: description }), noindex && _jsx("meta", { name: "robots", content: "noindex, nofollow" }), url && _jsx("link", { rel: "canonical", href: url }), url && _jsx("meta", { property: "og:url", content: url }), _jsx("meta", { property: "og:title", content: title }), _jsx("meta", { property: "og:description", content: description }), _jsx("meta", { property: "og:type", content: type }), image && _jsx("meta", { property: "og:image", content: image }), _jsx("meta", { name: "twitter:card", content: "summary_large_image" }), _jsx("meta", { name: "twitter:title", content: title }), _jsx("meta", { name: "twitter:description", content: description }), image && _jsx("meta", { name: "twitter:image", content: image }), structuredData && (_jsx("script", { type: "application/ld+json", children: JSON.stringify(structuredData) }))] }));
+}

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import './globals.js';
-export type { RouteConfig, ComponentWithGetData, RouteDataParams } from './types.js';
+export type { RouteConfig, ComponentWithGetData, RouteDataParams, SitemapEntry, SitemapRouteConfig, SitemapChangefreq, } from './types.js';
 export { registerRoutes, getRoutes } from './registry.js';
 export { BrowserRouteDataProvider } from './components/BrowserRouteDataProvider.js';
+export { SEO, type SEOProps } from './components/SEO.js';
 export { default as RouterService } from './router/RouterService.js';
 export { RouteDataProvider, useRouteData, buildRouteKey, type RouteDataState, type InitialRouteShape, } from './router/RouteDataContext.js';
 export { AppRoutes } from './components/AppRoutes.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AACtB,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EACL,MAAM,EACN,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AACtB,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,EAAE,GAAG,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EACL,MAAM,EACN,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,6 +1,7 @@
 import './globals.js';
 export { registerRoutes, getRoutes } from './registry.js';
 export { BrowserRouteDataProvider } from './components/BrowserRouteDataProvider.js';
+export { SEO } from './components/SEO.js';
 export { default as RouterService } from './router/RouterService.js';
 export { RouteDataProvider, useRouteData, buildRouteKey, } from './router/RouteDataContext.js';
 export { AppRoutes } from './components/AppRoutes.js';

package/dist/ssr/render.d.ts

@@ -3,6 +3,12 @@ import { RequestContext } from '../types.js';
 export interface RenderResult {
     html: string;
     preloadedData: Record<string, unknown>;
+    helmet?: {
+        title: string;
+        meta: string;
+        link: string;
+        script: string;
+    };
 }
 export interface RenderOptions {
     wrap?: (children: ReactNode) => ReactNode;

package/dist/ssr/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/ssr/render.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,OAAO,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,SAAS,CAAC;IAC1C;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAwCxF"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/ssr/render.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOvC,OAAO,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACxE;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,SAAS,CAAC;IAC1C;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAqDxF"}

package/dist/ssr/render.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { renderToString } from 'react-dom/server';
+import { HelmetProvider } from 'react-helmet-async';
 import { StaticRouter } from 'react-router-dom/server';
 import { AppRoutes } from '../components/AppRoutes.js';
 import { RouteDataProvider } from '../router/RouteDataContext.js';
@@ -32,8 +33,17 @@ export async function render(url, options) {
             preloadedData = { ...preloadedData, is_success: false };
         }
     }
-    const inner = (_jsx(StaticRouter, { location: url, children: _jsx(RouteDataProvider, { initialData: preloadedData, initialRoute: matchedRoute, initialParams: params, children: _jsx(AppRoutes, {}) }) }));
+    const helmetContext = {};
+    const inner = (_jsx(HelmetProvider, { context: helmetContext, children: _jsx(StaticRouter, { location: url, children: _jsx(RouteDataProvider, { initialData: preloadedData, initialRoute: matchedRoute, initialParams: params, children: _jsx(AppRoutes, {}) }) }) }));
     const app = options?.wrap ? options.wrap(inner) : inner;
     const html = renderToString(app);
-    return { html, preloadedData };
+    const helmet = helmetContext.helmet
+        ? {
+            title: helmetContext.helmet.title.toString(),
+            meta: helmetContext.helmet.meta.toString(),
+            link: helmetContext.helmet.link.toString(),
+            script: helmetContext.helmet.script.toString(),
+        }
+        : undefined;
+    return { html, preloadedData, helmet };
 }

package/dist/ssr/server.d.ts

@@ -2,6 +2,12 @@ import { type Express } from 'express';
 export interface RenderResult {
     html: string;
     preloadedData: Record<string, unknown>;
+    helmet?: {
+        title: string;
+        meta: string;
+        link: string;
+        script: string;
+    };
 }
 export interface CreateServerConfig {
     root: string;
@@ -10,6 +16,12 @@ export interface CreateServerConfig {
     port?: number;
     /** Optional link tag to inject in dev for CSS (e.g. '<link rel="stylesheet" href="/src/index.css">') */
     cssLinkInDev?: string;
+    /** Register routes before the SSR catch-all (e.g. sitemap.xml, robots.txt) */
+    extraRoutes?: (app: Express) => void;
+    /** Enable sitemap.xml and robots.txt from route registry. Routes with sitemap.include are included. */
+    sitemap?: {
+        siteUrl: string;
+    };
 }
 export declare function createServer(config: CreateServerConfig): Promise<{
     getApp: () => Express;

package/dist/ssr/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/ssr/server.ts"],"names":[],"mappings":"AAGA,OAAgB,EAAE,KAAK,OAAO,EAAkD,MAAM,SAAS,CAAC;AAKhG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wGAAwG;IACxG,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAkPD,wBAAsB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC;IACtE,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACxD,CAAC,CAOD;AAED;qDACqD;AACrD,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,QAO7D"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/ssr/server.ts"],"names":[],"mappings":"AAGA,OAAgB,EAAE,KAAK,OAAO,EAAkD,MAAM,SAAS,CAAC;AAOhG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACxE;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wGAAwG;IACxG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,uGAAuG;IACvG,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B;AAmVD,wBAAsB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC;IACtE,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACxD,CAAC,CAOD;AAED;qDACqD;AACrD,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,QAO7D"}

package/dist/ssr/server.js

@@ -3,6 +3,7 @@ import path from 'node:path';
 import { pathToFileURL } from 'node:url';
 import express from 'express';
 import { createServer as createViteServer } from 'vite';
+import { getRoutes } from '../registry.js';
 import RouterService from '../router/RouterService.js';
 function defaultDistEntryPath(entryPath) {
     return entryPath
@@ -30,6 +31,8 @@ class SsrServer {
             entryPath: config.entryPath,
             port: config.port ?? 5173,
             cssLinkInDev: config.cssLinkInDev ?? '<link rel="stylesheet" href="/src/index.css"></head>',
+            extraRoutes: config.extraRoutes ?? (() => { }),
+            sitemap: config.sitemap ?? undefined,
         };
         this.isProd = process.env.NODE_ENV === 'production';
         this.app = express();
@@ -65,8 +68,74 @@ class SsrServer {
         this.app.use(express.static(path.join(this.config.root, 'dist'), { index: false }));
     }
     configureRequestHandler() {
+        if (this.config.sitemap?.siteUrl) {
+            this.registerSitemapRoutes(this.config.sitemap.siteUrl);
+        }
+        this.config.extraRoutes?.(this.app);
         this.app.use('*', (req, res, next) => this.handleRequest(req, res, next));
     }
+    registerSitemapRoutes(siteUrl) {
+        const baseUrl = siteUrl.replace(/\/$/, '');
+        this.app.get('/robots.txt', (_req, res) => {
+            res.type('text/plain');
+            res.send(`User-agent: *
+Allow: /
+
+Sitemap: ${baseUrl}/sitemap.xml`);
+        });
+        this.app.get('/sitemap.xml', async (_req, res) => {
+            const today = new Date().toISOString().split('T')[0];
+            const entries = [];
+            for (const route of getRoutes()) {
+                const cfg = route.sitemap;
+                if (!cfg?.include)
+                    continue;
+                const changefreq = cfg.changefreq ?? 'weekly';
+                const priority = cfg.priority ?? 0.5;
+                if (cfg.getEntries) {
+                    try {
+                        const dynamicEntries = await cfg.getEntries({ siteUrl: baseUrl });
+                        for (const e of dynamicEntries) {
+                            entries.push({
+                                loc: e.loc,
+                                lastmod: e.lastmod ?? today,
+                                changefreq: e.changefreq ?? changefreq,
+                                priority: e.priority ?? priority,
+                            });
+                        }
+                    }
+                    catch (err) {
+                        console.error(`[lovable-ssr] sitemap getEntries failed for ${route.path}:`, err);
+                    }
+                }
+                else if (!route.path.includes(':')) {
+                    entries.push({
+                        loc: `${baseUrl}${route.path === '/' ? '' : route.path}`,
+                        lastmod: today,
+                        changefreq,
+                        priority,
+                    });
+                }
+            }
+            const xml = this.buildSitemapXml(entries);
+            res.type('application/xml').send(xml);
+        });
+    }
+    buildSitemapXml(entries) {
+        const lines = entries.map((e) => `  <url><loc>${this.escapeXml(e.loc)}</loc><lastmod>${e.lastmod ?? ''}</lastmod><changefreq>${e.changefreq ?? 'weekly'}</changefreq><priority>${e.priority ?? 0.5}</priority></url>`);
+        return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${lines.join('\n')}
+</urlset>`;
+    }
+    escapeXml(str) {
+        return str
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&apos;');
+    }
     async handleRequest(req, res, next) {
         const url = req.originalUrl;
         const pathname = url.replace(/\?.*$/, '').replace(/#.*$/, '') || '/';
@@ -100,6 +169,7 @@ class SsrServer {
         }
         let appHtml;
         let preloadedData;
+        let helmet;
         // Constrói um contexto simples de request (cookies raw + headers) para o getData.
         const cookiesRaw = req.headers.cookie ?? '';
         const cookies = {};
@@ -131,26 +201,31 @@ class SsrServer {
                 if (cached) {
                     appHtml = cached.html;
                     preloadedData = cached.preloadedData;
+                    helmet = cached.helmet;
                 }
                 else {
                     const result = await render(url, { requestContext });
                     appHtml = typeof result.html === 'string' ? result.html : '';
                     preloadedData = result.preloadedData ?? {};
-                    this._ssrCache.set(cacheKey, { html: appHtml, preloadedData });
+                    helmet = result.helmet;
+                    this._ssrCache.set(cacheKey, { html: appHtml, preloadedData, helmet });
                 }
             }
             else {
                 const result = await render(url, { requestContext });
                 appHtml = typeof result.html === 'string' ? result.html : '';
                 preloadedData = result.preloadedData ?? {};
+                helmet = result.helmet;
             }
         }
         else {
             const result = await render(url, { requestContext });
             appHtml = typeof result.html === 'string' ? result.html : '';
             preloadedData = result.preloadedData ?? {};
+            helmet = result.helmet;
         }
         let html = template.replace('<div id="root"></div>', `<div id="root">${appHtml}</div>`);
+        html = this.injectHelmet(html, helmet);
         html = this.injectPreloadedData(html, preloadedData);
         if (this.vite) {
             const transformed = await this.vite.transformIndexHtml(url, html);
@@ -186,6 +261,14 @@ class SsrServer {
             return html;
         return html.replace('</head>', this.config.cssLinkInDev);
     }
+    injectHelmet(html, helmet) {
+        if (!helmet)
+            return html;
+        const tags = [helmet.title, helmet.meta, helmet.link, helmet.script].filter(Boolean).join('\n');
+        if (!tags)
+            return html;
+        return html.replace('</head>', `${tags}\n</head>`);
+    }
     injectPreloadedData(html, preloadedData) {
         if (Object.keys(preloadedData).length === 0)
             return html;

package/dist/types.d.ts

@@ -3,10 +3,27 @@ import type React from 'react';
 export type ComponentWithGetData = React.ComponentType<any> & {
     getData?: (params?: RouteDataParams) => Promise<Record<string, unknown>>;
 };
+export type SitemapChangefreq = 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+export type SitemapEntry = {
+    loc: string;
+    lastmod?: string;
+    changefreq?: SitemapChangefreq;
+    priority?: number;
+};
+export type SitemapRouteConfig = {
+    include: boolean;
+    changefreq?: SitemapChangefreq;
+    priority?: number;
+    /** For dynamic routes (e.g. /video/:id): return all URLs for this pattern. */
+    getEntries?: (ctx: {
+        siteUrl: string;
+    }) => Promise<SitemapEntry[]>;
+};
 export type RouteConfig = {
     path: string;
     Component: ComponentWithGetData;
     isSSR: boolean;
+    sitemap?: SitemapRouteConfig;
 };
 export type RequestContext = {
     cookiesRaw: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG;IAC5D,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,oBAAoB,CAAC;IAChC,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG;IAC5D,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACpE,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,oBAAoB,CAAC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lovable-ssr",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "SSR and route data engine for Lovable projects",
   "license": "MIT",
   "keywords": [
@@ -43,10 +43,12 @@
   "peerDependencies": {
     "react": "^18.0.0",
     "react-dom": "^18.0.0",
-    "react-router-dom": "^6.0.0"
+    "react-router-dom": "^6.0.0",
+    "react-helmet-async": "^2.0.5"
   },
   "dependencies": {
-    "express": "^4.21.0"
+    "express": "^4.21.0",
+    "react-helmet-async": "^2.0.5"
   },
   "devDependencies": {
     "@types/express": "^4.17.21",