@pracht/core 0.2.3 → 0.2.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jovi De Croock
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.mts

@@ -157,6 +157,9 @@ type LoaderData<TLoader extends LoaderLike> = TLoader extends ((...args: any[])
 interface HeadArgs<TLoader extends LoaderLike = undefined, TContext = any> extends BaseRouteArgs<TContext> {
   data: LoaderData<TLoader>;
 }
+interface HeadersArgs<TLoader extends LoaderLike = undefined, TContext = any> extends BaseRouteArgs<TContext> {
+  data: LoaderData<TLoader>;
+}
 interface RouteComponentProps<TLoader extends LoaderLike = undefined> {
   data: LoaderData<TLoader>;
   params: RouteParams;
@@ -171,6 +174,7 @@ type LoaderFn<TContext = any, TData = unknown> = (args: LoaderArgs<TContext>) =>
 interface RouteModule<TContext = any, TLoader extends LoaderLike = undefined> {
   loader?: LoaderFn<TContext>;
   head?: (args: HeadArgs<TLoader, TContext>) => MaybePromise<HeadMetadata>;
+  headers?: (args: HeadersArgs<TLoader, TContext>) => MaybePromise<HeadersInit>;
   Component?: FunctionComponent<RouteComponentProps<TLoader>>;
   default?: FunctionComponent<RouteComponentProps<TLoader>>;
   ErrorBoundary?: FunctionComponent<ErrorBoundaryProps>;
@@ -180,6 +184,7 @@ interface ShellModule<TContext = any> {
   Shell: FunctionComponent<ShellProps>;
   Loading?: FunctionComponent;
   head?: (args: BaseRouteArgs<TContext>) => MaybePromise<HeadMetadata>;
+  headers?: (args: BaseRouteArgs<TContext>) => MaybePromise<HeadersInit>;
 }
 type MiddlewareResult<TContext = any> = void | Response | {
   redirect: string;
@@ -351,6 +356,7 @@ declare function applyDefaultSecurityHeaders(headers: Headers): Headers;
 interface PrerenderResult {
   path: string;
   html: string;
+  headers?: Record<string, string>;
 }
 interface ISGManifestEntry {
   revalidate: RouteRevalidate;
@@ -397,4 +403,4 @@ interface InitClientRouterOptions {
 }
 declare function initClientRouter(options: InitClientRouterOptions): Promise<void>;
 //#endregion
-export { type ApiConfig, type ApiRouteArgs, type ApiRouteHandler, type ApiRouteMatch, type ApiRouteModule, type BaseRouteArgs, type DataModule, type ErrorBoundaryProps, Form, type FormProps, type GroupDefinition, type GroupMeta, type HandlePrachtRequestOptions, type HeadArgs, type HeadMetadata, type HttpMethod, type ISGManifestEntry, type InitClientRouterOptions, type LoaderArgs, type LoaderData, type LoaderFn, type Location, type MiddlewareArgs, type MiddlewareFn, type MiddlewareModule, type MiddlewareResult, type ModuleImporter, type ModuleRef, type ModuleRegistry, type NavigateFn, type PrachtApp, type PrachtAppConfig, PrachtHttpError, type PrachtHydrationState, type PrachtRuntimeDiagnosticPhase, type PrachtRuntimeDiagnostics, PrachtRuntimeProvider, type PrefetchStrategy, type PrerenderAppOptions, type PrerenderAppResult, type PrerenderResult, type Register, type RenderMode, type ResolvedApiRoute, type ResolvedPrachtApp, type ResolvedRoute, type RouteComponentProps, type RouteConfig, type RouteDefinition, type RouteMatch, type RouteMeta, type RouteModule, type RouteParams, type RouteRevalidate, type RouteStateResult, type RouteTreeNode, type SerializedRouteError, type ShellModule, type ShellProps, type StartAppOptions, Suspense, type TimeRevalidatePolicy, applyDefaultSecurityHeaders, buildPathFromSegments, defineApp, forwardRef, group, handlePrachtRequest, initClientRouter, lazy, matchApiRoute, matchAppRoute, prerenderApp, readHydrationState, resolveApiRoutes, resolveApp, route, startApp, timeRevalidate, useIsHydrated, useLocation, useNavigate, useParams, useRevalidate, useRevalidateRoute, useRouteData };
+export { type ApiConfig, type ApiRouteArgs, type ApiRouteHandler, type ApiRouteMatch, type ApiRouteModule, type BaseRouteArgs, type DataModule, type ErrorBoundaryProps, Form, type FormProps, type GroupDefinition, type GroupMeta, type HandlePrachtRequestOptions, type HeadArgs, type HeadMetadata, type HeadersArgs, type HttpMethod, type ISGManifestEntry, type InitClientRouterOptions, type LoaderArgs, type LoaderData, type LoaderFn, type Location, type MiddlewareArgs, type MiddlewareFn, type MiddlewareModule, type MiddlewareResult, type ModuleImporter, type ModuleRef, type ModuleRegistry, type NavigateFn, type PrachtApp, type PrachtAppConfig, PrachtHttpError, type PrachtHydrationState, type PrachtRuntimeDiagnosticPhase, type PrachtRuntimeDiagnostics, PrachtRuntimeProvider, type PrefetchStrategy, type PrerenderAppOptions, type PrerenderAppResult, type PrerenderResult, type Register, type RenderMode, type ResolvedApiRoute, type ResolvedPrachtApp, type ResolvedRoute, type RouteComponentProps, type RouteConfig, type RouteDefinition, type RouteMatch, type RouteMeta, type RouteModule, type RouteParams, type RouteRevalidate, type RouteStateResult, type RouteTreeNode, type SerializedRouteError, type ShellModule, type ShellProps, type StartAppOptions, Suspense, type TimeRevalidatePolicy, applyDefaultSecurityHeaders, buildPathFromSegments, defineApp, forwardRef, group, handlePrachtRequest, initClientRouter, lazy, matchApiRoute, matchAppRoute, prerenderApp, readHydrationState, resolveApiRoutes, resolveApp, route, startApp, timeRevalidate, useIsHydrated, useLocation, useNavigate, useParams, useRevalidate, useRevalidateRoute, useRouteData };

package/dist/index.mjs

@@ -333,6 +333,7 @@ async function handlePrachtRequest(options) {
 		currentPhase = "render";
 		shellModule = match.route.shellFile ? await resolveRegistryModule(registry.shellModules, match.route.shellFile) : void 0;
 		const head = await mergeHeadMetadata(shellModule, routeModule, routeArgs, data);
+		const documentHeaders = await mergeDocumentHeaders(shellModule, routeModule, routeArgs, data);
 		const cssUrls = resolvePageCssUrls(options, match.route.shellFile, match.route.file);
 		const modulePreloadUrls = resolvePageJsUrls(options, match.route.shellFile, match.route.file);
 		if (match.route.render === "spa") {
@@ -356,7 +357,7 @@ async function handlePrachtRequest(options) {
 				clientEntryUrl: options.clientEntryUrl,
 				cssUrls,
 				modulePreloadUrls
-			}));
+			}), 200, documentHeaders);
 		}
 		const DefaultComponent = typeof routeModule.default === "function" ? routeModule.default : void 0;
 		const Component = routeModule.Component ?? DefaultComponent;
@@ -385,7 +386,7 @@ async function handlePrachtRequest(options) {
 			clientEntryUrl: options.clientEntryUrl,
 			cssUrls,
 			modulePreloadUrls
-		}));
+		}), 200, documentHeaders);
 	} catch (error) {
 		return renderRouteErrorResponse({
 			error,
@@ -596,6 +597,7 @@ async function renderRouteErrorResponse(options) {
 	if (options.isRouteStateRequest) return jsonErrorResponse(routeErrorWithDiagnostics, { isRouteStateRequest: true });
 	const shellModule = options.shellModule ?? (options.shellFile ? await resolveRegistryModule(options.options.registry?.shellModules, options.shellFile) : void 0);
 	const head = shellModule?.head ? await shellModule.head(options.routeArgs) : {};
+	const documentHeaders = await mergeDocumentHeaders(shellModule, void 0, options.routeArgs, void 0);
 	const cssUrls = resolvePageCssUrls(options.options, options.shellFile, options.routeArgs.route.file);
 	const modulePreloadUrls = resolvePageJsUrls(options.options, options.shellFile, options.routeArgs.route.file);
 	const renderToString = await getRenderToStringAsync();
@@ -619,7 +621,7 @@ async function renderRouteErrorResponse(options) {
 		clientEntryUrl: options.options.clientEntryUrl,
 		cssUrls,
 		modulePreloadUrls
-	}), routeErrorWithDiagnostics.status);
+	}), routeErrorWithDiagnostics.status, documentHeaders);
 }
 async function runMiddlewareChain(options) {
 	let context = options.context;
@@ -681,6 +683,22 @@ async function mergeHeadMetadata(shellModule, routeModule, routeArgs, data) {
 		link: [...shellHead.link ?? [], ...routeHead.link ?? []]
 	};
 }
+async function mergeDocumentHeaders(shellModule, routeModule, routeArgs, data) {
+	const headers = new Headers();
+	const shellHeaders = shellModule?.headers ? await shellModule.headers(routeArgs) : void 0;
+	if (shellHeaders) applyHeaders(headers, shellHeaders);
+	const routeHeaders = routeModule?.headers ? await routeModule.headers({
+		...routeArgs,
+		data
+	}) : void 0;
+	if (routeHeaders) applyHeaders(headers, routeHeaders);
+	return headers;
+}
+function applyHeaders(headers, init) {
+	new Headers(init).forEach((value, key) => {
+		headers.set(key, value);
+	});
+}
 function buildHtmlDocument(options) {
 	const { head, body, hydrationState, clientEntryUrl, cssUrls = [], modulePreloadUrls = [] } = options;
 	const titleTag = head.title ? `<title>${escapeHtml(head.title)}</title>` : "";
@@ -707,8 +725,10 @@ function buildHtmlDocument(options) {
   </body>
 </html>`;
 }
-function htmlResponse(html, status = 200) {
-	const headers = applySecurityAndRouteHeaders(new Headers({ "content-type": "text/html; charset=utf-8" }), { isRouteStateRequest: false });
+function htmlResponse(html, status = 200, initHeaders) {
+	const headers = new Headers({ "content-type": "text/html; charset=utf-8" });
+	if (initHeaders) applyHeaders(headers, initHeaders);
+	applySecurityAndRouteHeaders(headers, { isRouteStateRequest: false });
 	return new Response(html, {
 		status,
 		headers
@@ -796,16 +816,19 @@ async function prerenderApp(options) {
 				console.warn(`  Warning: ${item.render.toUpperCase()} route "${item.pathname}" returned status ${response.status}, skipping.`);
 				return null;
 			}
+			const html = await response.text();
 			return {
-				item,
-				html: await response.text()
+				headers: Object.fromEntries(response.headers),
+				html,
+				item
 			};
 		}));
 		for (const result of batchResults) {
 			if (!result) continue;
 			results.push({
 				path: result.item.pathname,
-				html: result.html
+				html: result.html,
+				headers: result.headers
 			});
 			if (result.item.render === "isg" && result.item.revalidate) isgManifest[result.item.pathname] = { revalidate: result.item.revalidate };
 		}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@pracht/core",
-  "version": "0.2.3",
+  "version": "0.2.5",
+  "license": "MIT",
   "homepage": "https://github.com/JoviDeCroock/pracht/tree/main/packages/framework",
   "bugs": {
     "url": "https://github.com/JoviDeCroock/pracht/issues"