@harpy-js/core 0.5.5 → 0.5.7

package/dist/core/lazy-route-loader.service.js

@@ -0,0 +1,79 @@
+"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 LazyRouteLoaderService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LazyRouteLoaderService = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+let LazyRouteLoaderService = LazyRouteLoaderService_1 = class LazyRouteLoaderService {
+    lazyModuleLoader;
+    logger = new common_1.Logger(LazyRouteLoaderService_1.name);
+    loadedModules = new Map();
+    registeredRoutes = new Map();
+    constructor(lazyModuleLoader) {
+        this.lazyModuleLoader = lazyModuleLoader;
+    }
+    registerLazyRoute(config) {
+        const routeKey = `${config.method}:${config.path}`;
+        this.registeredRoutes.set(routeKey, config);
+        this.logger.log(`Registered lazy route: ${routeKey} -> ${config.id}`);
+    }
+    getRegisteredRoutes() {
+        return Array.from(this.registeredRoutes.values());
+    }
+    async handleLazyRoute(config, req, reply) {
+        try {
+            let moduleRef = this.loadedModules.get(config.id);
+            if (!moduleRef) {
+                this.logger.log(`Loading lazy module: ${config.id}...`);
+                const startTime = Date.now();
+                const ModuleClass = await config.moduleLoader();
+                moduleRef = await this.lazyModuleLoader.load(() => ModuleClass);
+                this.loadedModules.set(config.id, moduleRef);
+                const loadTime = Date.now() - startTime;
+                this.logger.log(`Lazy module ${config.id} loaded in ${loadTime}ms`);
+            }
+            const ControllerClass = await config.controllerLoader();
+            const controller = moduleRef.get(ControllerClass, { strict: false });
+            if (!controller) {
+                throw new Error(`Controller instance not found in lazy module ${config.id}`);
+            }
+            const handler = controller[config.handlerMethod];
+            if (!handler || typeof handler !== 'function') {
+                throw new Error(`Handler method ${config.handlerMethod} not found in controller`);
+            }
+            const result = await handler.call(controller, req, reply);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const errorStack = error instanceof Error ? error.stack : undefined;
+            this.logger.error(`Failed to handle lazy route ${config.id}: ${errorMessage}`, errorStack);
+            throw error;
+        }
+    }
+    isModuleLoaded(moduleId) {
+        return this.loadedModules.has(moduleId);
+    }
+    getStatistics() {
+        return {
+            totalRegistered: this.registeredRoutes.size,
+            totalLoaded: this.loadedModules.size,
+            loadedModules: Array.from(this.loadedModules.keys()),
+            registeredRoutes: Array.from(this.registeredRoutes.keys()),
+        };
+    }
+};
+exports.LazyRouteLoaderService = LazyRouteLoaderService;
+exports.LazyRouteLoaderService = LazyRouteLoaderService = LazyRouteLoaderService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.LazyModuleLoader])
+], LazyRouteLoaderService);

package/dist/core/lazy-routes.module.d.ts

@@ -0,0 +1,2 @@
+export declare class LazyRoutesModule {
+}

package/dist/core/lazy-routes.module.js

@@ -0,0 +1,21 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LazyRoutesModule = void 0;
+const common_1 = require("@nestjs/common");
+const lazy_route_loader_service_1 = require("./lazy-route-loader.service");
+let LazyRoutesModule = class LazyRoutesModule {
+};
+exports.LazyRoutesModule = LazyRoutesModule;
+exports.LazyRoutesModule = LazyRoutesModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [lazy_route_loader_service_1.LazyRouteLoaderService],
+        exports: [lazy_route_loader_service_1.LazyRouteLoaderService],
+    })
+], LazyRoutesModule);

package/dist/decorators/lazy-route.decorator.d.ts

@@ -0,0 +1,12 @@
+export declare const LAZY_ROUTE_METADATA = "harpy:lazy-route";
+export interface LazyRouteDecoratorConfig {
+    id: string;
+    moduleLoader: () => Promise<any>;
+    controllerLoader: () => Promise<any>;
+    handlerMethod: string;
+}
+export interface LazyRouteMetadata extends LazyRouteDecoratorConfig {
+    path: string;
+    method: string;
+}
+export declare function LazyRoute(path: string, method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH', config: LazyRouteDecoratorConfig): <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

package/dist/decorators/lazy-route.decorator.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LAZY_ROUTE_METADATA = void 0;
+exports.LazyRoute = LazyRoute;
+const common_1 = require("@nestjs/common");
+exports.LAZY_ROUTE_METADATA = 'harpy:lazy-route';
+function LazyRoute(path, method, config) {
+    const methodDecorator = method === 'GET'
+        ? (0, common_1.Get)(path)
+        : method === 'POST'
+            ? (0, common_1.Post)(path)
+            : method === 'PUT'
+                ? (0, common_1.Put)(path)
+                : method === 'DELETE'
+                    ? (0, common_1.Delete)(path)
+                    : (0, common_1.Patch)(path);
+    return (0, common_1.applyDecorators)(methodDecorator, (0, common_1.SetMetadata)(exports.LAZY_ROUTE_METADATA, {
+        ...config,
+        path,
+        method,
+    }));
+}

package/dist/index.d.ts

@@ -4,6 +4,13 @@ export { getChunkPath, getHydrationManifest } from "./core/hydration-manifest";
 export { withJsxEngine } from "./core/jsx.engine";
 export { LiveReloadController } from "./core/live-reload.controller";
 export { StaticAssetsController } from "./core/static-assets.controller";
+export { JsxExceptionFilter } from "./core/jsx-exception.filter";
+export type { ErrorPagesConfig } from "./core/jsx-exception.filter";
+export { default as Default404Page } from "./core/error-pages/default-404";
+export { default as Default500Page } from "./core/error-pages/default-500";
+export { default as Default401Page } from "./core/error-pages/default-401";
+export { default as Default403Page } from "./core/error-pages/default-403";
+export { default as ErrorLayout } from "./core/error-pages/error-layout";
 export { JsxRender } from "./decorators/jsx.decorator";
 export { WithLayout } from "./decorators/layout.decorator";
 export type { MetaOptions, RenderOptions } from "./decorators/jsx.decorator";

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.useI18n = 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;
+exports.useI18n = 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.ErrorLayout = exports.Default403Page = exports.Default401Page = exports.Default500Page = exports.Default404Page = exports.JsxExceptionFilter = 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");
@@ -18,6 +18,18 @@ var live_reload_controller_1 = require("./core/live-reload.controller");
 Object.defineProperty(exports, "LiveReloadController", { enumerable: true, get: function () { return live_reload_controller_1.LiveReloadController; } });
 var static_assets_controller_1 = require("./core/static-assets.controller");
 Object.defineProperty(exports, "StaticAssetsController", { enumerable: true, get: function () { return static_assets_controller_1.StaticAssetsController; } });
+var jsx_exception_filter_1 = require("./core/jsx-exception.filter");
+Object.defineProperty(exports, "JsxExceptionFilter", { enumerable: true, get: function () { return jsx_exception_filter_1.JsxExceptionFilter; } });
+var default_404_1 = require("./core/error-pages/default-404");
+Object.defineProperty(exports, "Default404Page", { enumerable: true, get: function () { return __importDefault(default_404_1).default; } });
+var default_500_1 = require("./core/error-pages/default-500");
+Object.defineProperty(exports, "Default500Page", { enumerable: true, get: function () { return __importDefault(default_500_1).default; } });
+var default_401_1 = require("./core/error-pages/default-401");
+Object.defineProperty(exports, "Default401Page", { enumerable: true, get: function () { return __importDefault(default_401_1).default; } });
+var default_403_1 = require("./core/error-pages/default-403");
+Object.defineProperty(exports, "Default403Page", { enumerable: true, get: function () { return __importDefault(default_403_1).default; } });
+var error_layout_1 = require("./core/error-pages/error-layout");
+Object.defineProperty(exports, "ErrorLayout", { enumerable: true, get: function () { return __importDefault(error_layout_1).default; } });
 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");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harpy-js/core",
-  "version": "0.5.5",
+  "version": "0.5.7",
   "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/core/__tests__/redirect-logic.spec.ts

@@ -0,0 +1,200 @@
+/**
+ * Unit tests for canonical redirect logic
+ */
+
+describe('Canonical Redirect Logic', () => {
+  // Simulate the redirect logic from app-setup.ts
+  function shouldRedirect(options: {
+    host: string;
+    protocol: string;
+    mainDomain?: string;
+    enforceHttps?: boolean;
+    redirectWww?: boolean;
+  }): { shouldRedirect: boolean; targetUrl?: string } {
+    const { host, protocol, mainDomain, enforceHttps = true, redirectWww = true } = options;
+    
+    const normalizedHost = host.replace(/:\d+$/, '');
+    
+    // Skip redirects for localhost/127.0.0.1
+    if (normalizedHost === 'localhost' || normalizedHost === '127.0.0.1' || normalizedHost === '0.0.0.0') {
+      return { shouldRedirect: false };
+    }
+
+    const proto = protocol;
+    
+    // Decide whether to redirect
+    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/src/core/app-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-setup.js","sourceRoot":"","sources":["app-setup.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,8CAwJC;AASD,sCAKC;AAlOD,2CAA6B;AAO7B,IAAI,aAAkB,CAAC;AACvB,IAAI,aAAkB,CAAC;AACvB,IAAI,CAAC;IAEH,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAC7C,CAAC;AAAC,OAAO,CAAC,EAAE,CAAC;IAEX,aAAa,GAAG,SAAS,CAAC;AAC5B,CAAC;AACD,IAAI,CAAC;IAEH,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAC7C,CAAC;AAAC,OAAO,CAAC,EAAE,CAAC;IACX,aAAa,GAAG,SAAS,CAAC;AAC5B,CAAC;AACD,6CAA6C;AAC7C,iEAA8E;AAE9E,kDAA0B;AAC1B,6CAAkD;AAClD,4EAAuD;AACvD,8EAAqD;AAgC9C,KAAK,UAAU,iBAAiB,CACrC,GAA2B,EAC3B,OAAwB,EAAE;IAE1B,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAEjE,IAAI,MAAM,EAAE,CAAC;QACX,IAAA,0BAAa,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC,WAAW,EAAE,CAAC;IAGnD,MAAM,EACJ,gBAAgB,GAAG,KAAK,EACxB,UAAU,EACV,YAAY,GAAG,IAAI,EACnB,WAAW,GAAG,IAAI,GACnB,GAAG,IAAuB,CAAC;IAE5B,IAAI,gBAAgB,IAAI,CAAC,UAAU,IAAI,YAAY,IAAI,WAAW,CAAC,EAAE,CAAC;QAOpE,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,GAAQ,EAAE,KAAU,EAAE,IAAS,EAAE,EAAE;YAC/D,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACxE,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC3E,MAAM,KAAK,GAAG,cAAc,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,IAAK,GAAG,CAAC,GAAG,CAAC,MAAc,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;gBAEpH,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAGvD,MAAM,MAAM,GAAG,YAAY,IAAI,KAAK,KAAK,OAAO,CAAC;gBACjD,MAAM,KAAK,GAAG,WAAW,IAAI,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBAC/D,MAAM,YAAY,GAAG,UAAU,IAAI,cAAc,KAAK,UAAU,CAAC;gBAEjE,IAAI,MAAM,IAAI,KAAK,IAAI,YAAY,EAAE,CAAC;oBAEpC,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBAClF,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;oBACnD,MAAM,SAAS,GAAG,GAAG,WAAW,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;oBAG7D,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,eAAe,EAAE,0BAA0B,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;oBAC1F,OAAO;gBACT,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBAGX,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE,CAAC,CAAC,CAAC;YACtD,CAAC;YAED,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;IACL,CAAC;IAID,MAAM,iBAAiB,GAAG,UAAU,EAAE,CAAC,KAAK,CAAC,IAAI,qBAAc,CAAC;IAChE,OAAO,CAAC,eAAe,CAAC,CAAC,KAAU,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAErD,IAAI,KAAK,EAAE,UAAU,KAAK,GAAG,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;YAC1D,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG;oBACZ,OAAO,EAAE,gBAAgB;oBACzB,IAAI,EAAE,OAAO,CAAC,GAAG;iBAClB,CAAC;gBAGF,MAAM,gBAAgB,GAAG,eAAK,CAAC,aAAa,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;gBACvE,MAAM,eAAe,GAAG,eAAK,CAAC,aAAa,CAAC,sBAAW,EAAE;oBACvD,KAAK,EAAE,sBAAsB;oBAC7B,QAAQ,EAAE,gBAAgB;iBAC3B,CAAC,CAAC;gBACH,MAAM,IAAI,GAAG,IAAA,uBAAc,EAAC,eAAe,CAAC,CAAC;gBAE7C,KAAK,KAAK;qBACP,MAAM,CAAC,GAAG,CAAC;qBACX,MAAM,CAAC,cAAc,EAAE,0BAA0B,CAAC;qBAClD,IAAI,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;gBAClC,OAAO;YACT,CAAC;YAAC,OAAO,WAAW,EAAE,CAAC;gBACrB,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,WAAW,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IAGH,IAAI,aAAa,EAAE,CAAC;QAElB,MAAM,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QAMN,OAAO,CAAC,IAAI,CACV,oGAAoG,CACrG,CAAC;IACJ,CAAC;IAKD,IAAI,aAAa,EAAE,CAAC;QAElB,IAAI,SAAS,EAAE,CAAC;YAEd,MAAM,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE;gBACpC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;gBAC9E,MAAM,EAAE,GAAG;gBACX,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YAGN,MAAM,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE;gBACpC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC;gBACvC,MAAM,EAAE,GAAG;gBACX,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;SAAM,CAAC;QAKN,OAAO,CAAC,IAAI,CACV,4GAA4G,CAC7G,CAAC;IACJ,CAAC;IAaD,MAAM,eAAe,GAAG,IAAI,yCAAkB,CAAC,UAAU,CAAC,CAAC;IAC3D,GAAG,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;AACxC,CAAC;AASM,KAAK,UAAU,aAAa,CACjC,GAA2B,EAC3B,OAAwB,EAAE;IAE1B,OAAO,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/src/core/app-setup.ts

@@ -22,6 +22,12 @@ try {
   fastifyCookie = undefined;
 }
 import { withJsxEngine } from "./jsx.engine";
+import { JsxExceptionFilter, ErrorPagesConfig } from "./jsx-exception.filter";
+import { APP_FILTER } from "@nestjs/core";
+import React from "react";
+import { renderToString } from "react-dom/server";
+import Default404Page from "./error-pages/default-404";
+import ErrorLayout from "./error-pages/error-layout";
 
 export interface HarpyAppOptions {
   /** JSX Default layout used by the app (optional) */
@@ -30,6 +36,18 @@ export interface HarpyAppOptions {
   distDir?: string;
   /** Optional folder containing public assets (favicon, manifest, etc.) */
   publicDir?: string;
+  /** Custom error pages for different HTTP status codes */
+  errorPages?: ErrorPagesConfig;
+  /**
+   * Optional redirect settings. When `enforceRedirects` is true (default false)
+   * Harpy will register a Fastify `onRequest` hook to redirect requests to
+   * the canonical domain and HTTPS. Configure `mainDomain` to your primary
+   * host (e.g. `harpyjs.org`).
+   */
+  enforceRedirects?: boolean;
+  mainDomain?: string;
+  enforceHttps?: boolean;
+  redirectWww?: boolean;
 }
 
 /**
@@ -45,7 +63,7 @@ export async function configureHarpyApp(
   app: NestFastifyApplication,
   opts: HarpyAppOptions = {},
 ) {
-  const { layout, distDir = "dist", publicDir } = opts;
+  const { layout, distDir = "dist", publicDir, errorPages } = opts;
 
   if (layout) {
     withJsxEngine(app, layout);
@@ -53,6 +71,93 @@ export async function configureHarpyApp(
 
   const fastify = app.getHttpAdapter().getInstance();
 
+  // Optional redirects to canonical domain / HTTPS
+  const {
+    enforceRedirects = false,
+    mainDomain,
+    enforceHttps = true,
+    redirectWww = true,
+  } = opts as HarpyAppOptions;
+
+  if (enforceRedirects && (mainDomain || enforceHttps || redirectWww)) {
+    // Register early hook to redirect incoming requests to the canonical URL
+    // This keeps redirect handling in Harpy core so consumers can opt-in.
+    // Uses x-forwarded-proto when behind proxies (Vercel, Cloudflare)
+    // and falls back to socket encryption detection.
+    // NOTE: Make sure your proxy forwards `x-forwarded-proto`.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    fastify.addHook('onRequest', (req: any, reply: any, done: any) => {
+      try {
+        const hostHeader = (req.headers && (req.headers.host || '')).toString();
+        const normalizedHost = hostHeader.replace(/:\d+$/, '');
+
+        // Skip redirects for localhost/127.0.0.1 (local development)
+        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 as any).encrypted ? 'https' : 'http');
+
+        // Decide whether to redirect: http -> https, www -> apex, or host mismatch
+        const isHttp = enforceHttps && proto !== 'https';
+        const isWww = redirectWww && normalizedHost.startsWith('www.');
+        const hostMismatch = mainDomain && normalizedHost !== mainDomain && normalizedHost !== `www.${mainDomain}`;
+
+        if (isHttp || isWww || hostMismatch) {
+          // Build target host (prefer configured mainDomain, else strip www.)
+          const targetHost = mainDomain ? mainDomain : normalizedHost.replace(/^www\./, '');
+          const targetProto = enforceHttps ? 'https' : proto;
+          const targetUrl = `${targetProto}://${targetHost}${req.url}`;
+
+          // Permanent redirect
+          reply.status(301).header('Cache-Control', 'public, max-age=31536000').redirect(targetUrl);
+          return;
+        }
+      } catch (e) {
+        // swallow errors and continue to avoid blocking requests
+        // eslint-disable-next-line no-console
+        console.warn('[harpy-core] redirect hook error', e);
+      }
+
+      done();
+    });
+  }
+
+  // Set custom error handler BEFORE other plugins to catch 404s
+  // This works with @fastify/static and catches all errors including 404s
+  const NotFoundComponent = errorPages?.["404"] || Default404Page;
+  fastify.setErrorHandler((error: any, request, reply) => {
+    // Check if it's a 404 error
+    if (error?.statusCode === 404 || reply.statusCode === 404) {
+      try {
+        const props = {
+          message: "Page Not Found",
+          path: request.url,
+        };
+        
+        // Wrap the error page content in ErrorLayout for proper styling
+        const errorPageContent = React.createElement(NotFoundComponent, props);
+        const wrappedInLayout = React.createElement(ErrorLayout, {
+          title: "404 - Page Not Found",
+          children: errorPageContent,
+        });
+        const html = 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);
+      }
+    }
+    // For other errors, send them to NestJS exception filters
+    throw error;
+  });
+
   // Cookie support is used by i18n and other helpers if available.
   if (fastifyCookie) {
     // eslint-disable-next-line @typescript-eslint/no-unsafe-call
@@ -107,6 +212,11 @@ export async function configureHarpyApp(
 
   // Analytics injection is intentionally omitted — keep analytics opt-in for
   // application authors so they can wire up their provider of choice.
+
+  // Register global JSX exception filter for custom error pages
+  // This must be done via app.useGlobalFilters since we can't modify module providers
+  const exceptionFilter = new JsxExceptionFilter(errorPages);
+  app.useGlobalFilters(exceptionFilter);
 }
 
 /**

package/src/core/error-pages/default-401.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-401.js","sourceRoot":"","sources":["default-401.tsx"],"names":[],"mappings":";;AAOA,iCAmCC;;AAnCD,SAAwB,cAAc,CAAC,EACrC,OAAO,GAAG,cAAc,GACF;IACtB,OAAO,CACL,gCAAK,SAAS,EAAC,mGAAmG,YAChH,iCAAK,SAAS,EAAC,mEAAmE,aAChF,gCAAK,SAAS,EAAC,MAAM,YACnB,gCAAK,SAAS,EAAC,+HAA+H,YAC5I,iCAAM,SAAS,EAAC,UAAU,6BAAU,GAChC,GACF,EAEN,+BAAI,SAAS,EAAC,2GAA2G,oBAEpH,EAEL,+BAAI,SAAS,EAAC,uCAAuC,YAAE,OAAO,GAAM,EAEpE,8BAAG,SAAS,EAAC,4BAA4B,sEAErC,EAEJ,8BACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,kMAAkM,4BAG1M,EAEJ,+BAAG,SAAS,EAAC,6BAA6B,4BAC7B,iCAAM,SAAS,EAAC,+BAA+B,yBAAgB,IACxE,IACA,GACF,CACP,CAAC;AACJ,CAAC"}

package/src/core/error-pages/default-401.tsx

@@ -0,0 +1,43 @@
+import React from 'react';
+import type { JsxLayoutProps } from '../../types/jsx.types';
+
+export interface UnauthorizedPageProps extends JsxLayoutProps {
+  message?: string;
+}
+
+export default function Default401Page({
+  message = 'Unauthorized',
+}: UnauthorizedPageProps) {
+  return (
+    <div className="min-h-screen bg-gradient-to-br from-orange-500 to-yellow-400 flex items-center justify-center p-6">
+      <div className="max-w-2xl w-full text-center bg-white rounded-2xl shadow-2xl p-12">
+        <div className="mb-8">
+          <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">
+            <span className="text-5xl">🔒</span>
+          </div>
+        </div>
+        
+        <h1 className="text-9xl font-extrabold text-transparent bg-clip-text bg-gradient-to-r from-orange-500 to-yellow-400 mb-4">
+          401
+        </h1>
+        
+        <h2 className="text-3xl font-bold text-gray-900 mb-4">{message}</h2>
+        
+        <p className="text-lg text-gray-600 mb-8">
+          You need to be authenticated to access this resource.
+        </p>
+        
+        <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
+        </a>
+        
+        <p className="mt-12 text-sm text-gray-500">
+          Powered by <span className="text-orange-600 font-semibold">Harpy.js</span>
+        </p>
+      </div>
+    </div>
+  );
+}

package/src/core/error-pages/default-403.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-403.js","sourceRoot":"","sources":["default-403.tsx"],"names":[],"mappings":";;AAOA,iCAmCC;;AAnCD,SAAwB,cAAc,CAAC,EACrC,OAAO,GAAG,WAAW,GACF;IACnB,OAAO,CACL,gCAAK,SAAS,EAAC,gGAAgG,YAC7G,iCAAK,SAAS,EAAC,mEAAmE,aAChF,gCAAK,SAAS,EAAC,MAAM,YACnB,gCAAK,SAAS,EAAC,4HAA4H,YACzI,iCAAM,SAAS,EAAC,UAAU,uBAAS,GAC/B,GACF,EAEN,+BAAI,SAAS,EAAC,wGAAwG,oBAEjH,EAEL,+BAAI,SAAS,EAAC,uCAAuC,YAAE,OAAO,GAAM,EAEpE,8BAAG,SAAS,EAAC,4BAA4B,mEAErC,EAEJ,8BACE,IAAI,EAAC,GAAG,EACR,SAAS,EAAC,+LAA+L,+BAGvM,EAEJ,+BAAG,SAAS,EAAC,6BAA6B,4BAC7B,iCAAM,SAAS,EAAC,4BAA4B,yBAAgB,IACrE,IACA,GACF,CACP,CAAC;AACJ,CAAC"}

package/src/core/error-pages/default-403.tsx

@@ -0,0 +1,43 @@
+import React from 'react';
+import type { JsxLayoutProps } from '../../types/jsx.types';
+
+export interface ForbiddenPageProps extends JsxLayoutProps {
+  message?: string;
+}
+
+export default function Default403Page({
+  message = 'Forbidden',
+}: ForbiddenPageProps) {
+  return (
+    <div className="min-h-screen bg-gradient-to-br from-red-600 to-orange-500 flex items-center justify-center p-6">
+      <div className="max-w-2xl w-full text-center bg-white rounded-2xl shadow-2xl p-12">
+        <div className="mb-8">
+          <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">
+            <span className="text-5xl">⛔</span>
+          </div>
+        </div>
+        
+        <h1 className="text-9xl font-extrabold text-transparent bg-clip-text bg-gradient-to-r from-red-600 to-orange-500 mb-4">
+          403
+        </h1>
+        
+        <h2 className="text-3xl font-bold text-gray-900 mb-4">{message}</h2>
+        
+        <p className="text-lg text-gray-600 mb-8">
+          You don't have permission to access this resource.
+        </p>
+        
+        <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
+        </a>
+        
+        <p className="mt-12 text-sm text-gray-500">
+          Powered by <span className="text-red-600 font-semibold">Harpy.js</span>
+        </p>
+      </div>
+    </div>
+  );
+}

package/src/core/error-pages/default-404.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-404.js","sourceRoot":"","sources":["default-404.tsx"],"names":[],"mappings":";;AAQA,iCA6CC;;AA7CD,SAAwB,cAAc,CAAC,EACrC,IAAI,EACJ,OAAO,GAAG,gBAAgB,GACR;IAClB,OAAO,CACL,gCAAK,SAAS,EAAC,iGAAiG,YAC9G,iCAAK,SAAS,EAAC,mEAAmE,aAChF,gCAAK,SAAS,EAAC,MAAM,YACnB,gCAAK,SAAS,EAAC,6HAA6H,YAC1I,iCAAM,SAAS,EAAC,+BAA+B,kBAAS,GACpD,GACF,EAEN,+BAAI,SAAS,EAAC,yGAAyG,oBAElH,EAEL,+BAAI,SAAS,EAAC,uCAAuC,YAAE,OAAO,GAAM,EAEpE,8BAAG,SAAS,EAAC,4BAA4B,6EAErC,EAEH,IAAI,IAAI,CACP,gCAAK,SAAS,EAAC,wDAAwD,YACrE,+BAAG,SAAS,EAAC,iCAAiC,aAC5C,iCAAM,SAAS,EAAC,eAAe,gCAAuB,EAAC,GAAG,EAC1D,iCAAM,SAAS,EAAC,+BAA+B,YAAE,IAAI,GAAQ,IAC3D,GACA,CACP,EAED,8BACE,IAAI,EAAC,GAAG,EACR,SAAS,EAAC,gMAAgM,+BAGxM,EAEJ,+BAAG,SAAS,EAAC,6BAA6B,4BAC7B,iCAAM,SAAS,EAAC,+BAA+B,yBAAgB,IACxE,IACA,GACF,CACP,CAAC;AACJ,CAAC"}