@stratal/inertia 0.0.22 → 0.0.23

package/dist/index.mjs

@@ -1,8 +1,9 @@
-import { t as __decorate } from "./decorate-CzXVx7ZH.mjs";
+import { t as __decorate } from "./decorate-B7nr7eBl.mjs";
+import { n as buildSeoTags, r as descriptorToHtml, t as DATA_SEO_ATTR } from "./build-seo-tags-DBsHKxX9.mjs";
 import { ApplicationError } from "stratal/errors";
 import { Module } from "stratal/module";
-import { Delete, Get, Patch, Post, Put, ROUTER_TOKENS, Route, RouterContext, SchemaValidationError } from "stratal/router";
-import { DI_TOKENS, Request, Singleton, Transient, inject } from "stratal/di";
+import { Delete, Get, Patch, Post, Put, ROUTER_TOKENS, Route, RouterContext, SchemaValidationError, applyTrailingSlash } from "stratal/router";
+import { CONTAINER_TOKEN, DI_TOKENS, Request, Singleton, Transient, inject } from "stratal/di";
 import { I18N_TOKENS } from "stratal/i18n";
 import { LOGGER_TOKENS } from "stratal/logger";
 import { deleteCookie, getSignedCookie, setSignedCookie } from "hono/cookie";
@@ -39,6 +40,12 @@ function augmentRouterContext(resolveService) {
 		const flashOut = this.c.get("inertiaFlashOut");
 		if (flashOut) flashOut[key] = value;
 	});
+	RouterContext.macro("share", function(key, value) {
+		resolveService(this).share(key, value);
+	});
+	RouterContext.macro("seo", function(data) {
+		resolveService(this).seo(data);
+	});
 	RouterContext.macro("withoutSsr", function() {
 		this.c.set("withoutSsr", true);
 	});
@@ -50,10 +57,12 @@ const INERTIA_TOKENS = {
 	InertiaService: Symbol.for("stratal:inertia:service"),
 	TemplateService: Symbol.for("stratal:inertia:template"),
 	ManifestService: Symbol.for("stratal:inertia:manifest"),
-	SsrRenderer: Symbol.for("stratal:inertia:ssr-renderer")
+	SsrRenderer: Symbol.for("stratal:inertia:ssr-renderer"),
+	HreflangService: Symbol.for("stratal:inertia:hreflang"),
+	SeoService: Symbol.for("stratal:inertia:seo")
 };
 //#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/decorateParam.js
+//#region \0@oxc-project+runtime@0.133.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);
@@ -105,6 +114,60 @@ let InertiaMiddleware = class InertiaMiddleware {
 };
 InertiaMiddleware = __decorate([Transient(), __decorateParam(0, inject(INERTIA_TOKENS.Options))], InertiaMiddleware);
 //#endregion
+//#region src/services/hreflang.service.ts
+let HreflangService = class HreflangService {
+	container;
+	constructor(container) {
+		this.container = container;
+	}
+	buildLinks(currentUrl) {
+		const i18n = this.container.tryResolve(I18N_TOKENS.Options);
+		if (!i18n) return [];
+		const locales = i18n.locales ?? ["en"];
+		if (locales.length < 2) return [];
+		const defaultLocale = i18n.defaultLocale ?? "en";
+		const trailingSlash = this.container.resolve(DI_TOKENS.Application).config.trailingSlash ?? "ignore";
+		const localeUrl = this.container.resolve(ROUTER_TOKENS.LocaleUrlService);
+		if (localeUrl.pathEnabled) return this.buildPathLinks(currentUrl, locales, defaultLocale, localeUrl, trailingSlash);
+		if ((i18n.detection && "strategy" in i18n.detection ? i18n.detection.strategy : void 0) === "querystring") return this.buildQuerystringLinks(currentUrl, locales, defaultLocale, trailingSlash);
+		return [];
+	}
+	buildPathLinks(url, locales, defaultLocale, localeUrl, trailingSlash) {
+		const basePath = localeUrl.stripPrefix(url.pathname);
+		const links = locales.map((locale) => this.linkTag(locale, this.compose(url, localeUrl.applyPrefix(basePath, locale), url.search, trailingSlash)));
+		links.push(this.linkTag("x-default", this.compose(url, localeUrl.applyPrefix(basePath, defaultLocale), url.search, trailingSlash)));
+		return links;
+	}
+	buildQuerystringLinks(url, locales, defaultLocale, trailingSlash) {
+		const params = new URLSearchParams(url.search);
+		params.delete("locale");
+		const baseQs = params.toString();
+		const links = locales.map((locale) => {
+			const qs = this.composeQuery(baseQs, locale === defaultLocale ? null : ["locale", locale]);
+			return this.linkTag(locale, this.compose(url, url.pathname, qs, trailingSlash));
+		});
+		const xDefaultQs = baseQs ? `?${baseQs}` : "";
+		links.push(this.linkTag("x-default", this.compose(url, url.pathname, xDefaultQs, trailingSlash)));
+		return links;
+	}
+	compose(url, pathname, search, mode) {
+		return applyTrailingSlash(url.origin + pathname + search, mode);
+	}
+	composeQuery(baseQs, extra) {
+		if (!extra) return baseQs ? `?${baseQs}` : "";
+		const tail = `${extra[0]}=${encodeURIComponent(extra[1])}`;
+		return baseQs ? `?${baseQs}&${tail}` : `?${tail}`;
+	}
+	linkTag(hreflang, href) {
+		return {
+			rel: "alternate",
+			hreflang,
+			href
+		};
+	}
+};
+HreflangService = __decorate([Singleton(), __decorateParam(0, inject(CONTAINER_TOKEN))], HreflangService);
+//#endregion
 //#region src/types.ts
 const INERTIA_PROP_OPTIONAL = Symbol.for("stratal:inertia:prop:optional");
 const INERTIA_PROP_DEFERRED = Symbol.for("stratal:inertia:prop:deferred");
@@ -117,15 +180,20 @@ let InertiaService = class InertiaService {
 	options;
 	template;
 	ssr;
+	seoService;
 	sharedData = {};
-	constructor(options, template, ssr) {
+	constructor(options, template, ssr, seoService) {
 		this.options = options;
 		this.template = template;
 		this.ssr = ssr;
+		this.seoService = seoService;
 	}
 	share(key, value) {
 		this.sharedData[key] = value;
 	}
+	seo(data) {
+		this.seoService.set(data);
+	}
 	location(url) {
 		return new Response("", {
 			status: 409,
@@ -172,12 +240,18 @@ let InertiaService = class InertiaService {
 		const url = reqUrl.search ? `${reqUrl.pathname}${reqUrl.search}` : reqUrl.pathname;
 		const isInertia = ctx.c.get("inertia");
 		const { shared: resolvedShared, sharedKeys } = await this.resolveSharedData(ctx);
+		const resolvedSeo = await this.seoService.resolve(ctx);
 		const allProps = {
 			...resolvedShared,
 			...this.sharedData,
+			seo: this.always(() => resolvedSeo),
 			...props
 		};
-		const allSharedKeys = [...sharedKeys, ...Object.keys(this.sharedData)];
+		const allSharedKeys = [
+			...sharedKeys,
+			...Object.keys(this.sharedData),
+			"seo"
+		];
 		const result = await this.processProps(allProps, ctx, component, isInertia);
 		const { errors: flashErrors, ...flash } = ctx.c.get("inertiaFlash") ?? {};
 		const errors = flashErrors && typeof flashErrors === "object" && !Array.isArray(flashErrors) ? flashErrors : {};
@@ -217,7 +291,8 @@ let InertiaService = class InertiaService {
 			head: [],
 			body: ""
 		} : await this.ssr.render(page);
-		const html = this.template.render(page, ssrResult.head, ssrResult.body);
+		const seoTags = this.seoService.tagsFor(resolvedSeo);
+		const html = this.template.render(page, [...ssrResult.head, ...seoTags], ssrResult.body);
 		return new Response(html, {
 			status,
 			headers: { "Content-Type": "text/html; charset=utf-8" }
@@ -248,6 +323,7 @@ let InertiaService = class InertiaService {
 			const uri = container.resolve(ROUTER_TOKENS.Uri);
 			const name = registry.findNameByRoute(ctx.c.req.method, ctx.c.req.routePath) ?? null;
 			const params = { ...ctx.param() };
+			const localePathService = container.resolve(ROUTER_TOKENS.LocalePathService);
 			shared.routes = this.serializeRoutes(registry.named());
 			shared.trailingSlash = application.config.trailingSlash ?? "ignore";
 			shared.route = {
@@ -255,6 +331,10 @@ let InertiaService = class InertiaService {
 				params,
 				defaults: uri.getDefaults()
 			};
+			shared.localeConfig = {
+				defaultLocale: localePathService.localePathConfig?.defaultLocale ?? null,
+				prefixDefaultLocale: localePathService.prefixDefaultLocale
+			};
 		}
 		return {
 			shared,
@@ -393,7 +473,8 @@ InertiaService = __decorate([
 	Request(INERTIA_TOKENS.InertiaService),
 	__decorateParam(0, inject(INERTIA_TOKENS.Options)),
 	__decorateParam(1, inject(INERTIA_TOKENS.TemplateService)),
-	__decorateParam(2, inject(INERTIA_TOKENS.SsrRenderer))
+	__decorateParam(2, inject(INERTIA_TOKENS.SsrRenderer)),
+	__decorateParam(3, inject(INERTIA_TOKENS.SeoService))
 ], InertiaService);
 //#endregion
 //#region src/services/manifest.service.ts
@@ -437,6 +518,70 @@ hot.on("vite:afterUpdate", () => {
 };
 ManifestService = __decorate([Transient(), __decorateParam(0, inject(INERTIA_TOKENS.Options))], ManifestService);
 //#endregion
+//#region src/services/seo.service.ts
+let SeoService = class SeoService {
+	options;
+	hreflang;
+	accumulated = {};
+	constructor(options, hreflang) {
+		this.options = options;
+		this.hreflang = hreflang;
+	}
+	/** Merges the given metadata into the request's accumulated SEO data. */
+	set(data) {
+		this.accumulated = mergeSeo(this.accumulated, data);
+	}
+	/**
+	* Resolves the final SEO data: module defaults (base) merged with the
+	* request's accumulated data, then the title template applied. Resolver
+	* functions for `defaults`/`titleTemplate` are awaited with the request `ctx`.
+	* Locale-aware `hreflang` alternates are appended last so they ride the same
+	* head injection and SPA reconciliation as the rest of the SEO tags.
+	*
+	* The resolved `title` is ALWAYS a string (falling back to `''`). This makes
+	* the `<title>` descriptor deterministic: every navigation — including to a
+	* page with no SEO — produces a title, so the client head-sync sets
+	* `document.title` rather than leaving the previous page's title stale.
+	*/
+	async resolve(ctx) {
+		const seo = this.options.seo;
+		const resolved = mergeSeo(typeof seo?.defaults === "function" ? await seo.defaults(ctx) : seo?.defaults ?? {}, this.accumulated);
+		const template = seo?.titleTemplate;
+		if (typeof template === "function") resolved.title = await template(resolved.title, ctx);
+		else if (typeof template === "string" && this.accumulated.title != null) resolved.title = template.split("%s").join(this.accumulated.title);
+		resolved.title ??= "";
+		const hreflang = this.hreflang.buildLinks(new URL(ctx.c.req.url));
+		if (hreflang.length > 0) resolved.link = [...resolved.link ?? [], ...hreflang];
+		return resolved;
+	}
+	/** Renders resolved SEO data into a list of head-tag HTML strings. */
+	tagsFor(resolved) {
+		return buildSeoTags(resolved).map(descriptorToHtml);
+	}
+};
+SeoService = __decorate([
+	Request(INERTIA_TOKENS.SeoService),
+	__decorateParam(0, inject(INERTIA_TOKENS.Options)),
+	__decorateParam(1, inject(INERTIA_TOKENS.HreflangService))
+], SeoService);
+/** Merges `b` over `a`: `openGraph`/`twitter` shallow-merge, `meta`/`link` concat, scalars overwrite. */
+function mergeSeo(a, b) {
+	return {
+		...a,
+		...b,
+		...a.openGraph || b.openGraph ? { openGraph: {
+			...a.openGraph,
+			...b.openGraph
+		} } : {},
+		...a.twitter || b.twitter ? { twitter: {
+			...a.twitter,
+			...b.twitter
+		} } : {},
+		...a.meta || b.meta ? { meta: [...a.meta ?? [], ...b.meta ?? []] } : {},
+		...a.link || b.link ? { link: [...a.link ?? [], ...b.link ?? []] } : {}
+	};
+}
+//#endregion
 //#region src/services/ssr-renderer.service.ts
 let SsrRendererService = class SsrRendererService {
 	options;
@@ -498,10 +643,10 @@ let TemplateService = class TemplateService {
 		const viteHead = this.manifest.getHeadTags();
 		const viteScripts = this.manifest.getScriptTags();
 		let html = this.options.rootView;
-		html = html.replace("@inertiaHead", headTags);
-		html = html.replace("@inertia", appHtml);
-		html = html.replace("@viteHead", viteHead);
-		html = html.replace("@viteScripts", viteScripts);
+		html = html.replace("@inertiaHead", () => headTags);
+		html = html.replace("@inertia", () => appHtml);
+		html = html.replace("@viteHead", () => viteHead);
+		html = html.replace("@viteScripts", () => viteScripts);
 		return html;
 	}
 	buildClientOnlyBody(page) {
@@ -544,6 +689,7 @@ let InertiaModule = _InertiaModule = class InertiaModule {
 			if (context.type !== "http") return void 0;
 			if (this.isPrecognitionRequest(context)) return this.handlePrecognitionValidationError(error, context);
 			if (!this.isInertiaRequest(context)) return void 0;
+			if (this.isReadRequest(context)) return void 0;
 			const issues = error.issues ?? [];
 			const errors = {};
 			for (const issue of issues) errors[issue.path] = issue.message;
@@ -555,6 +701,7 @@ let InertiaModule = _InertiaModule = class InertiaModule {
 			const message = error.message;
 			if (this.isPrecognitionRequest(context)) return this.createPrecognitionErrorResponse({ _form: message });
 			if (!this.isInertiaRequest(context)) return void 0;
+			if (this.isReadRequest(context)) return void 0;
 			context.ctx.flash("errors", { _form: message });
 			return this.redirectBack(context);
 		});
@@ -577,6 +724,23 @@ let InertiaModule = _InertiaModule = class InertiaModule {
 	isInertiaRequest(context) {
 		return context.ctx.header("x-inertia") === "true";
 	}
+	/**
+	* GET/HEAD requests are idempotent navigations — including Inertia deferred
+	* partial reloads, which fetch deferred props over a follow-up XHR that still
+	* carries `X-Inertia: true`.
+	*
+	* Such requests must NOT use the flash-errors + redirect-back convention: the
+	* redirect points back at the very URL that just threw, so an error raised
+	* while resolving a deferred prop would redirect → re-request → throw again
+	* in an infinite loop (`ERR_TOO_MANY_REDIRECTS`). For these we fall through to
+	* the errorPage pipeline, which renders `Errors/${status}` in place as an
+	* Inertia response. Redirect-back stays for mutations (POST/PUT/PATCH/DELETE),
+	* where it drives the post-submit form-error flow.
+	*/
+	isReadRequest(context) {
+		const method = context.ctx.c.req.method.toUpperCase();
+		return method === "GET" || method === "HEAD";
+	}
 	isPrecognitionRequest(context) {
 		return context.ctx.header("precognition") === "true";
 	}
@@ -637,6 +801,14 @@ InertiaModule = _InertiaModule = __decorate([Module({ providers: [
 	{
 		provide: INERTIA_TOKENS.SsrRenderer,
 		useClass: SsrRendererService
+	},
+	{
+		provide: INERTIA_TOKENS.HreflangService,
+		useClass: HreflangService
+	},
+	{
+		provide: INERTIA_TOKENS.SeoService,
+		useClass: SeoService
 	}
 ] })], InertiaModule);
 //#endregion
@@ -829,6 +1001,6 @@ let HandlePrecognitiveRequests = class HandlePrecognitiveRequests {
 };
 HandlePrecognitiveRequests = __decorate([Transient()], HandlePrecognitiveRequests);
 //#endregion
-export { CookieFlashStore, HandlePrecognitiveRequests, INERTIA_TOKENS, InertiaDelete, InertiaGet, InertiaMiddleware, InertiaModule, InertiaPatch, InertiaPost, InertiaPut, InertiaRoute, InertiaService, ManifestService, SsrRendererService, TemplateService };
+export { CookieFlashStore, DATA_SEO_ATTR, HandlePrecognitiveRequests, INERTIA_TOKENS, InertiaDelete, InertiaGet, InertiaMiddleware, InertiaModule, InertiaPatch, InertiaPost, InertiaPut, InertiaRoute, InertiaService, ManifestService, SeoService, SsrRendererService, TemplateService, buildSeoTags, descriptorToHtml };
 
 //# sourceMappingURL=index.mjs.map