@harpy-js/core 0.5.5 → 0.5.7

package/dist/core/__tests__/redirect-logic.spec.js

@@ -0,0 +1,157 @@
+"use strict";
+describe('Canonical Redirect Logic', () => {
+    function shouldRedirect(options) {
+        const { host, protocol, mainDomain, enforceHttps = true, redirectWww = true } = options;
+        const normalizedHost = host.replace(/:\d+$/, '');
+        if (normalizedHost === 'localhost' || normalizedHost === '127.0.0.1' || normalizedHost === '0.0.0.0') {
+            return { shouldRedirect: false };
+        }
+        const proto = protocol;
+        const isHttp = enforceHttps && proto !== 'https';
+        const isWww = redirectWww && normalizedHost.startsWith('www.');
+        const hostMismatch = mainDomain && normalizedHost !== mainDomain && normalizedHost !== `www.${mainDomain}`;
+        if (isHttp || isWww || hostMismatch) {
+            const targetHost = mainDomain ? mainDomain : normalizedHost.replace(/^www\./, '');
+            const targetProto = enforceHttps ? 'https' : proto;
+            const targetUrl = `${targetProto}://${targetHost}/`;
+            return { shouldRedirect: true, targetUrl };
+        }
+        return { shouldRedirect: false };
+    }
+    describe('HTTP to HTTPS redirect', () => {
+        it('should redirect http://harpyjs.org to https://harpyjs.org', () => {
+            const result = shouldRedirect({
+                host: 'harpyjs.org',
+                protocol: 'http',
+                mainDomain: 'harpyjs.org',
+                enforceHttps: true,
+                redirectWww: true,
+            });
+            expect(result.shouldRedirect).toBe(true);
+            expect(result.targetUrl).toBe('https://harpyjs.org/');
+        });
+        it('should not redirect https://harpyjs.org', () => {
+            const result = shouldRedirect({
+                host: 'harpyjs.org',
+                protocol: 'https',
+                mainDomain: 'harpyjs.org',
+                enforceHttps: true,
+                redirectWww: true,
+            });
+            expect(result.shouldRedirect).toBe(false);
+        });
+    });
+    describe('WWW to non-WWW redirect', () => {
+        it('should redirect www.harpyjs.org to harpyjs.org', () => {
+            const result = shouldRedirect({
+                host: 'www.harpyjs.org',
+                protocol: 'https',
+                mainDomain: 'harpyjs.org',
+                enforceHttps: true,
+                redirectWww: true,
+            });
+            expect(result.shouldRedirect).toBe(true);
+            expect(result.targetUrl).toBe('https://harpyjs.org/');
+        });
+        it('should not redirect when redirectWww is false', () => {
+            const result = shouldRedirect({
+                host: 'www.harpyjs.org',
+                protocol: 'https',
+                mainDomain: 'harpyjs.org',
+                enforceHttps: true,
+                redirectWww: false,
+            });
+            expect(result.shouldRedirect).toBe(false);
+        });
+    });
+    describe('Combined redirects', () => {
+        it('should redirect http://www.harpyjs.org to https://harpyjs.org', () => {
+            const result = shouldRedirect({
+                host: 'www.harpyjs.org',
+                protocol: 'http',
+                mainDomain: 'harpyjs.org',
+                enforceHttps: true,
+                redirectWww: true,
+            });
+            expect(result.shouldRedirect).toBe(true);
+            expect(result.targetUrl).toBe('https://harpyjs.org/');
+        });
+    });
+    describe('Localhost exemption', () => {
+        it('should not redirect localhost', () => {
+            const result = shouldRedirect({
+                host: 'localhost',
+                protocol: 'http',
+                mainDomain: 'harpyjs.org',
+                enforceHttps: true,
+                redirectWww: true,
+            });
+            expect(result.shouldRedirect).toBe(false);
+        });
+        it('should not redirect 127.0.0.1', () => {
+            const result = shouldRedirect({
+                host: '127.0.0.1',
+                protocol: 'http',
+                mainDomain: 'harpyjs.org',
+                enforceHttps: true,
+                redirectWww: true,
+            });
+            expect(result.shouldRedirect).toBe(false);
+        });
+        it('should not redirect localhost:3000', () => {
+            const result = shouldRedirect({
+                host: 'localhost:3000',
+                protocol: 'http',
+                mainDomain: 'harpyjs.org',
+                enforceHttps: true,
+                redirectWww: true,
+            });
+            expect(result.shouldRedirect).toBe(false);
+        });
+    });
+    describe('Domain enforcement', () => {
+        it('should redirect different domain to mainDomain', () => {
+            const result = shouldRedirect({
+                host: 'example.com',
+                protocol: 'https',
+                mainDomain: 'harpyjs.org',
+                enforceHttps: true,
+                redirectWww: true,
+            });
+            expect(result.shouldRedirect).toBe(true);
+            expect(result.targetUrl).toBe('https://harpyjs.org/');
+        });
+        it('should not redirect when host matches mainDomain', () => {
+            const result = shouldRedirect({
+                host: 'harpyjs.org',
+                protocol: 'https',
+                mainDomain: 'harpyjs.org',
+                enforceHttps: true,
+                redirectWww: true,
+            });
+            expect(result.shouldRedirect).toBe(false);
+        });
+    });
+    describe('Configuration variations', () => {
+        it('should not redirect http when enforceHttps is false', () => {
+            const result = shouldRedirect({
+                host: 'harpyjs.org',
+                protocol: 'http',
+                mainDomain: 'harpyjs.org',
+                enforceHttps: false,
+                redirectWww: true,
+            });
+            expect(result.shouldRedirect).toBe(false);
+        });
+        it('should work without mainDomain specified', () => {
+            const result = shouldRedirect({
+                host: 'www.example.com',
+                protocol: 'https',
+                enforceHttps: true,
+                redirectWww: true,
+            });
+            expect(result.shouldRedirect).toBe(true);
+            expect(result.targetUrl).toBe('https://example.com/');
+        });
+    });
+});

package/dist/core/app-setup.d.ts

@@ -1,8 +1,14 @@
 import type { NestFastifyApplication } from "@nestjs/platform-fastify";
+import { ErrorPagesConfig } from "./jsx-exception.filter";
 export interface HarpyAppOptions {
     layout?: any;
     distDir?: string;
     publicDir?: string;
+    errorPages?: ErrorPagesConfig;
+    enforceRedirects?: boolean;
+    mainDomain?: string;
+    enforceHttps?: boolean;
+    redirectWww?: boolean;
 }
 export declare function configureHarpyApp(app: NestFastifyApplication, opts?: HarpyAppOptions): Promise<void>;
 export declare function setupHarpyApp(app: NestFastifyApplication, opts?: HarpyAppOptions): Promise<void>;

package/dist/core/app-setup.js

@@ -32,6 +32,9 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.configureHarpyApp = configureHarpyApp;
 exports.setupHarpyApp = setupHarpyApp;
@@ -51,12 +54,72 @@ catch (e) {
     fastifyCookie = undefined;
 }
 const jsx_engine_1 = require("./jsx.engine");
+const jsx_exception_filter_1 = require("./jsx-exception.filter");
+const react_1 = __importDefault(require("react"));
+const server_1 = require("react-dom/server");
+const default_404_1 = __importDefault(require("./error-pages/default-404"));
+const error_layout_1 = __importDefault(require("./error-pages/error-layout"));
 async function configureHarpyApp(app, opts = {}) {
-    const { layout, distDir = "dist", publicDir } = opts;
+    const { layout, distDir = "dist", publicDir, errorPages } = opts;
     if (layout) {
         (0, jsx_engine_1.withJsxEngine)(app, layout);
     }
     const fastify = app.getHttpAdapter().getInstance();
+    const { enforceRedirects = false, mainDomain, enforceHttps = true, redirectWww = true, } = opts;
+    if (enforceRedirects && (mainDomain || enforceHttps || redirectWww)) {
+        fastify.addHook('onRequest', (req, reply, done) => {
+            try {
+                const hostHeader = (req.headers && (req.headers.host || '')).toString();
+                const normalizedHost = hostHeader.replace(/:\d+$/, '');
+                if (normalizedHost === 'localhost' || normalizedHost === '127.0.0.1' || normalizedHost === '0.0.0.0') {
+                    done();
+                    return;
+                }
+                const forwardedProto = (req.headers['x-forwarded-proto'] || '').toString();
+                const proto = forwardedProto || (req.raw && req.raw.socket && req.raw.socket.encrypted ? 'https' : 'http');
+                const isHttp = enforceHttps && proto !== 'https';
+                const isWww = redirectWww && normalizedHost.startsWith('www.');
+                const hostMismatch = mainDomain && normalizedHost !== mainDomain && normalizedHost !== `www.${mainDomain}`;
+                if (isHttp || isWww || hostMismatch) {
+                    const targetHost = mainDomain ? mainDomain : normalizedHost.replace(/^www\./, '');
+                    const targetProto = enforceHttps ? 'https' : proto;
+                    const targetUrl = `${targetProto}://${targetHost}${req.url}`;
+                    reply.status(301).header('Cache-Control', 'public, max-age=31536000').redirect(targetUrl);
+                    return;
+                }
+            }
+            catch (e) {
+                console.warn('[harpy-core] redirect hook error', e);
+            }
+            done();
+        });
+    }
+    const NotFoundComponent = errorPages?.["404"] || default_404_1.default;
+    fastify.setErrorHandler((error, request, reply) => {
+        if (error?.statusCode === 404 || reply.statusCode === 404) {
+            try {
+                const props = {
+                    message: "Page Not Found",
+                    path: request.url,
+                };
+                const errorPageContent = react_1.default.createElement(NotFoundComponent, props);
+                const wrappedInLayout = react_1.default.createElement(error_layout_1.default, {
+                    title: "404 - Page Not Found",
+                    children: errorPageContent,
+                });
+                const html = (0, server_1.renderToString)(wrappedInLayout);
+                void reply
+                    .status(404)
+                    .header("Content-Type", "text/html; charset=utf-8")
+                    .send(`<!DOCTYPE html>${html}`);
+                return;
+            }
+            catch (renderError) {
+                console.error("Error rendering 404 page:", renderError);
+            }
+        }
+        throw error;
+    });
     if (fastifyCookie) {
         await fastify.register(fastifyCookie);
     }
@@ -82,6 +145,8 @@ async function configureHarpyApp(app, opts = {}) {
     else {
         console.warn("[harpy-core] optional dependency `@fastify/static` is not installed; static `dist` handler not registered.");
     }
+    const exceptionFilter = new jsx_exception_filter_1.JsxExceptionFilter(errorPages);
+    app.useGlobalFilters(exceptionFilter);
 }
 async function setupHarpyApp(app, opts = {}) {
     return configureHarpyApp(app, opts);

package/dist/core/error-pages/default-401.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import type { JsxLayoutProps } from '../../types/jsx.types';
+export interface UnauthorizedPageProps extends JsxLayoutProps {
+    message?: string;
+}
+export default function Default401Page({ message, }: UnauthorizedPageProps): React.JSX.Element;

package/dist/core/error-pages/default-401.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = Default401Page;
+const react_1 = __importDefault(require("react"));
+function Default401Page({ message = 'Unauthorized', }) {
+    return (react_1.default.createElement("div", { className: "min-h-screen bg-gradient-to-br from-orange-500 to-yellow-400 flex items-center justify-center p-6" },
+        react_1.default.createElement("div", { className: "max-w-2xl w-full text-center bg-white rounded-2xl shadow-2xl p-12" },
+            react_1.default.createElement("div", { className: "mb-8" },
+                react_1.default.createElement("div", { className: "inline-flex items-center justify-center w-28 h-28 bg-gradient-to-br from-orange-500 to-yellow-400 rounded-full shadow-lg mb-6" },
+                    react_1.default.createElement("span", { className: "text-5xl" }, "\uD83D\uDD12"))),
+            react_1.default.createElement("h1", { className: "text-9xl font-extrabold text-transparent bg-clip-text bg-gradient-to-r from-orange-500 to-yellow-400 mb-4" }, "401"),
+            react_1.default.createElement("h2", { className: "text-3xl font-bold text-gray-900 mb-4" }, message),
+            react_1.default.createElement("p", { className: "text-lg text-gray-600 mb-8" }, "You need to be authenticated to access this resource."),
+            react_1.default.createElement("a", { href: "/login", className: "inline-block px-8 py-3 bg-gradient-to-r from-orange-500 to-yellow-400 text-white font-semibold rounded-lg shadow-md hover:shadow-lg transform hover:-translate-y-0.5 transition-all duration-200" }, "Go to Login"),
+            react_1.default.createElement("p", { className: "mt-12 text-sm text-gray-500" },
+                "Powered by ",
+                react_1.default.createElement("span", { className: "text-orange-600 font-semibold" }, "Harpy.js")))));
+}

package/dist/core/error-pages/default-403.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import type { JsxLayoutProps } from '../../types/jsx.types';
+export interface ForbiddenPageProps extends JsxLayoutProps {
+    message?: string;
+}
+export default function Default403Page({ message, }: ForbiddenPageProps): React.JSX.Element;

package/dist/core/error-pages/default-403.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = Default403Page;
+const react_1 = __importDefault(require("react"));
+function Default403Page({ message = 'Forbidden', }) {
+    return (react_1.default.createElement("div", { className: "min-h-screen bg-gradient-to-br from-red-600 to-orange-500 flex items-center justify-center p-6" },
+        react_1.default.createElement("div", { className: "max-w-2xl w-full text-center bg-white rounded-2xl shadow-2xl p-12" },
+            react_1.default.createElement("div", { className: "mb-8" },
+                react_1.default.createElement("div", { className: "inline-flex items-center justify-center w-28 h-28 bg-gradient-to-br from-red-600 to-orange-500 rounded-full shadow-lg mb-6" },
+                    react_1.default.createElement("span", { className: "text-5xl" }, "\u26D4"))),
+            react_1.default.createElement("h1", { className: "text-9xl font-extrabold text-transparent bg-clip-text bg-gradient-to-r from-red-600 to-orange-500 mb-4" }, "403"),
+            react_1.default.createElement("h2", { className: "text-3xl font-bold text-gray-900 mb-4" }, message),
+            react_1.default.createElement("p", { className: "text-lg text-gray-600 mb-8" }, "You don't have permission to access this resource."),
+            react_1.default.createElement("a", { href: "/", className: "inline-block px-8 py-3 bg-gradient-to-r from-red-600 to-orange-500 text-white font-semibold rounded-lg shadow-md hover:shadow-lg transform hover:-translate-y-0.5 transition-all duration-200" }, "Go to Homepage"),
+            react_1.default.createElement("p", { className: "mt-12 text-sm text-gray-500" },
+                "Powered by ",
+                react_1.default.createElement("span", { className: "text-red-600 font-semibold" }, "Harpy.js")))));
+}

package/dist/core/error-pages/default-404.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { JsxLayoutProps } from '../../types/jsx.types';
+export interface NotFoundPageProps extends JsxLayoutProps {
+    path?: string;
+    message?: string;
+}
+export default function Default404Page({ path, message, }: NotFoundPageProps): React.JSX.Element;

package/dist/core/error-pages/default-404.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = Default404Page;
+const react_1 = __importDefault(require("react"));
+function Default404Page({ path, message = 'Page Not Found', }) {
+    return (react_1.default.createElement("div", { className: "min-h-screen bg-gradient-to-br from-purple-600 to-blue-600 flex items-center justify-center p-6" },
+        react_1.default.createElement("div", { className: "max-w-2xl w-full text-center bg-white rounded-2xl shadow-2xl p-12" },
+            react_1.default.createElement("div", { className: "mb-8" },
+                react_1.default.createElement("div", { className: "inline-flex items-center justify-center w-28 h-28 bg-gradient-to-br from-purple-600 to-blue-600 rounded-full shadow-lg mb-6" },
+                    react_1.default.createElement("span", { className: "text-5xl font-bold text-white" }, "H"))),
+            react_1.default.createElement("h1", { className: "text-9xl font-extrabold text-transparent bg-clip-text bg-gradient-to-r from-purple-600 to-blue-600 mb-4" }, "404"),
+            react_1.default.createElement("h2", { className: "text-3xl font-bold text-gray-900 mb-4" }, message),
+            react_1.default.createElement("p", { className: "text-lg text-gray-600 mb-8" }, "The page you're looking for doesn't exist or has been moved."),
+            path && (react_1.default.createElement("div", { className: "bg-gray-100 border border-gray-300 rounded-lg p-4 mb-8" },
+                react_1.default.createElement("p", { className: "font-mono text-sm text-gray-700" },
+                    react_1.default.createElement("span", { className: "text-gray-500" }, "Requested path:"),
+                    ' ',
+                    react_1.default.createElement("span", { className: "text-purple-600 font-semibold" }, path)))),
+            react_1.default.createElement("a", { href: "/", className: "inline-block px-8 py-3 bg-gradient-to-r from-purple-600 to-blue-600 text-white font-semibold rounded-lg shadow-md hover:shadow-lg transform hover:-translate-y-0.5 transition-all duration-200" }, "Go to Homepage"),
+            react_1.default.createElement("p", { className: "mt-12 text-sm text-gray-500" },
+                "Powered by ",
+                react_1.default.createElement("span", { className: "text-purple-600 font-semibold" }, "Harpy.js")))));
+}

package/dist/core/error-pages/default-500.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { JsxLayoutProps } from '../../types/jsx.types';
+export interface ServerErrorPageProps extends JsxLayoutProps {
+    message?: string;
+    error?: string;
+}
+export default function Default500Page({ message, error, }: ServerErrorPageProps): React.JSX.Element;

package/dist/core/error-pages/default-500.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = Default500Page;
+const react_1 = __importDefault(require("react"));
+function Default500Page({ message = 'Internal Server Error', error, }) {
+    return (react_1.default.createElement("div", { className: "min-h-screen bg-gradient-to-br from-red-500 to-pink-600 flex items-center justify-center p-6" },
+        react_1.default.createElement("div", { className: "max-w-2xl w-full text-center bg-white rounded-2xl shadow-2xl p-12" },
+            react_1.default.createElement("div", { className: "mb-8" },
+                react_1.default.createElement("div", { className: "inline-flex items-center justify-center w-28 h-28 bg-gradient-to-br from-red-500 to-pink-600 rounded-full shadow-lg mb-6" },
+                    react_1.default.createElement("span", { className: "text-5xl font-bold text-white" }, "H"))),
+            react_1.default.createElement("h1", { className: "text-9xl font-extrabold text-transparent bg-clip-text bg-gradient-to-r from-red-500 to-pink-600 mb-4" }, "500"),
+            react_1.default.createElement("h2", { className: "text-3xl font-bold text-gray-900 mb-4" }, message),
+            react_1.default.createElement("p", { className: "text-lg text-gray-600 mb-8" }, "Something went wrong on our end. Please try again later."),
+            error && (react_1.default.createElement("div", { className: "bg-red-50 border-2 border-red-200 rounded-lg p-6 mb-8 text-left" },
+                react_1.default.createElement("div", { className: "flex items-start gap-3" },
+                    react_1.default.createElement("svg", { className: "w-6 h-6 text-red-600 flex-shrink-0 mt-0.5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24" },
+                        react_1.default.createElement("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" })),
+                    react_1.default.createElement("div", { className: "flex-1" },
+                        react_1.default.createElement("h3", { className: "text-sm font-semibold text-red-900 mb-2" }, "Error Details"),
+                        react_1.default.createElement("pre", { className: "text-xs text-red-800 font-mono whitespace-pre-wrap break-words" }, error))))),
+            react_1.default.createElement("a", { href: "/", className: "inline-block px-8 py-3 bg-gradient-to-r from-red-500 to-pink-600 text-white font-semibold rounded-lg shadow-md hover:shadow-lg transform hover:-translate-y-0.5 transition-all duration-200" }, "Go to Homepage"),
+            react_1.default.createElement("p", { className: "mt-12 text-sm text-gray-500" },
+                "Powered by ",
+                react_1.default.createElement("span", { className: "text-red-600 font-semibold" }, "Harpy.js")))));
+}

package/dist/core/error-pages/error-layout.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+export interface ErrorLayoutProps {
+    children: React.ReactNode;
+    title?: string;
+}
+export default function ErrorLayout({ children, title, }: ErrorLayoutProps): React.JSX.Element;

package/dist/core/error-pages/error-layout.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = ErrorLayout;
+const react_1 = __importDefault(require("react"));
+function ErrorLayout({ children, title = 'Error', }) {
+    return (react_1.default.createElement("html", { lang: "en" },
+        react_1.default.createElement("head", null,
+            react_1.default.createElement("meta", { charSet: "utf-8" }),
+            react_1.default.createElement("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }),
+            react_1.default.createElement("title", null, title),
+            react_1.default.createElement("link", { rel: "stylesheet", href: "/styles/styles.css" }),
+            react_1.default.createElement("link", { rel: "stylesheet", href: "/assets/styles.css" })),
+        react_1.default.createElement("body", null, children)));
+}

package/dist/core/jsx-exception.filter.d.ts

@@ -0,0 +1,14 @@
+import { ExceptionFilter, ArgumentsHost } from '@nestjs/common';
+import React from 'react';
+export interface ErrorPagesConfig {
+    404?: React.ComponentType<any>;
+    500?: React.ComponentType<any>;
+    401?: React.ComponentType<any>;
+    403?: React.ComponentType<any>;
+    default?: React.ComponentType<any>;
+}
+export declare class JsxExceptionFilter implements ExceptionFilter {
+    private readonly errorPages;
+    constructor(errorPages?: ErrorPagesConfig);
+    catch(exception: unknown, host: ArgumentsHost): void;
+}

package/dist/core/jsx-exception.filter.js

@@ -0,0 +1,115 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsxExceptionFilter = void 0;
+const common_1 = require("@nestjs/common");
+const react_1 = __importDefault(require("react"));
+const server_1 = require("react-dom/server");
+const default_404_1 = __importDefault(require("./error-pages/default-404"));
+const default_500_1 = __importDefault(require("./error-pages/default-500"));
+const default_401_1 = __importDefault(require("./error-pages/default-401"));
+const default_403_1 = __importDefault(require("./error-pages/default-403"));
+const error_layout_1 = __importDefault(require("./error-pages/error-layout"));
+let JsxExceptionFilter = class JsxExceptionFilter {
+    errorPages;
+    constructor(errorPages = {}) {
+        this.errorPages = errorPages;
+    }
+    catch(exception, host) {
+        const ctx = host.switchToHttp();
+        const reply = ctx.getResponse();
+        const request = ctx.getRequest();
+        let status;
+        let message;
+        let error;
+        if (exception instanceof common_1.HttpException) {
+            status = exception.getStatus();
+            const response = exception.getResponse();
+            if (typeof response === 'string') {
+                message = response;
+            }
+            else if (typeof response === 'object' && response !== null) {
+                message =
+                    response.message || response.error || 'An error occurred';
+                error = response.error;
+            }
+            else {
+                message = 'An error occurred';
+            }
+        }
+        else if (exception instanceof Error) {
+            status = common_1.HttpStatus.INTERNAL_SERVER_ERROR;
+            message = 'Internal Server Error';
+            error = process.env.NODE_ENV === 'development' ? exception.message : undefined;
+        }
+        else {
+            status = common_1.HttpStatus.INTERNAL_SERVER_ERROR;
+            message = 'Unknown error occurred';
+        }
+        let ErrorComponent;
+        switch (status) {
+            case common_1.HttpStatus.NOT_FOUND:
+                ErrorComponent = this.errorPages[404] || default_404_1.default;
+                break;
+            case common_1.HttpStatus.UNAUTHORIZED:
+                ErrorComponent = this.errorPages[401] || default_401_1.default;
+                break;
+            case common_1.HttpStatus.FORBIDDEN:
+                ErrorComponent = this.errorPages[403] || default_403_1.default;
+                break;
+            case common_1.HttpStatus.INTERNAL_SERVER_ERROR:
+                ErrorComponent = this.errorPages[500] || default_500_1.default;
+                break;
+            default:
+                ErrorComponent = this.errorPages.default || this.errorPages[500] || default_500_1.default;
+        }
+        const props = {
+            message,
+            error,
+            path: request.url,
+        };
+        const titleMap = {
+            404: '404 - Page Not Found',
+            401: '401 - Unauthorized',
+            403: '403 - Forbidden',
+            500: '500 - Internal Server Error',
+        };
+        const title = titleMap[status] || `${status} - Error`;
+        try {
+            const errorPageContent = react_1.default.createElement(ErrorComponent, props);
+            const wrappedInLayout = react_1.default.createElement(error_layout_1.default, {
+                title,
+                children: errorPageContent,
+            });
+            const html = (0, server_1.renderToString)(wrappedInLayout);
+            void reply
+                .status(status)
+                .header('Content-Type', 'text/html; charset=utf-8')
+                .send(`<!DOCTYPE html>${html}`);
+        }
+        catch (renderError) {
+            console.error('Error rendering JSX error page:', renderError);
+            void reply.status(status).send({
+                statusCode: status,
+                message,
+                error,
+            });
+        }
+    }
+};
+exports.JsxExceptionFilter = JsxExceptionFilter;
+exports.JsxExceptionFilter = JsxExceptionFilter = __decorate([
+    (0, common_1.Catch)(),
+    __metadata("design:paramtypes", [Object])
+], JsxExceptionFilter);

package/dist/core/lazy-route-loader.service.d.ts

@@ -0,0 +1,28 @@
+import { Type } from '@nestjs/common';
+import { LazyModuleLoader } from '@nestjs/core';
+import type { FastifyRequest, FastifyReply } from 'fastify';
+export interface LazyRouteConfig {
+    id: string;
+    path: string;
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    moduleLoader: () => Promise<Type<any>>;
+    controllerLoader: () => Promise<Type<any>>;
+    handlerMethod: string;
+}
+export declare class LazyRouteLoaderService {
+    private readonly lazyModuleLoader;
+    private readonly logger;
+    private readonly loadedModules;
+    private readonly registeredRoutes;
+    constructor(lazyModuleLoader: LazyModuleLoader);
+    registerLazyRoute(config: LazyRouteConfig): void;
+    getRegisteredRoutes(): LazyRouteConfig[];
+    handleLazyRoute(config: LazyRouteConfig, req: FastifyRequest, reply: FastifyReply): Promise<any>;
+    isModuleLoaded(moduleId: string): boolean;
+    getStatistics(): {
+        totalRegistered: number;
+        totalLoaded: number;
+        loadedModules: string[];
+        registeredRoutes: string[];
+    };
+}