@digitaldefiance/node-express-suite 3.7.5 → 3.7.6

package/src/routers/app.js

@@ -0,0 +1,285 @@
+"use strict";
+/**
+ * @fileoverview Application router for serving React frontend and API routes.
+ * Handles static file serving, EJS template rendering, and catch-all routing.
+ * @module routers/app
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppRouter = void 0;
+const tslib_1 = require("tslib");
+const i18n_lib_1 = require("@digitaldefiance/i18n-lib");
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+const ejs_1 = tslib_1.__importDefault(require("ejs"));
+const express_1 = require("express");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const utils_1 = require("../utils");
+/**
+ * Dummy function to ensure EJS is included in the bundle.
+ * @private
+ */
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+function keepEJS() {
+    ejs_1.default.compile(''); // Compile an empty string, doesn't generate anything meaningful
+}
+/**
+ * Application router for serving React frontend and API routes.
+ * Sets up static file serving, EJS template rendering, and catch-all routing for SPA.
+ * @template TID Platform-specific ID type
+ * @template TApplication Application instance type
+ */
+class AppRouter {
+    /** Path to EJS views directory */
+    viewsPath;
+    /** Path to index.html file */
+    indexPath;
+    /** Path to assets directory */
+    assetsDir;
+    /** Path to React distribution directory */
+    reactDistDir;
+    /** API router instance */
+    apiRouter;
+    /** Application instance */
+    application;
+    /**
+     * Creates a new application router instance.
+     * Validates and resolves all paths to prevent directory traversal attacks.
+     * @param apiRouter API router instance to mount under /api
+     * @throws {TranslatableSuiteError} If paths contain invalid traversal sequences
+     */
+    constructor(apiRouter) {
+        this.application = apiRouter.application;
+        this.apiRouter = apiRouter;
+        // Validate paths don't contain traversal sequences
+        if (this.application.environment.apiDistDir.includes('..') ||
+            this.application.environment.reactDistDir.includes('..')) {
+            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_InvalidPathContainsParentDirectoryReference);
+        }
+        const normalizedApiDistDir = (0, path_1.resolve)(this.application.environment.apiDistDir);
+        const viewsPath = (0, path_1.resolve)(normalizedApiDistDir, 'views');
+        if (!viewsPath.startsWith(normalizedApiDistDir + path_1.sep) &&
+            viewsPath !== normalizedApiDistDir) {
+            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_InvalidViewsPathEscapesBaseDirectory);
+        }
+        this.viewsPath = viewsPath;
+        const normalizedReactDistDir = (0, path_1.resolve)(this.application.environment.reactDistDir);
+        this.reactDistDir = normalizedReactDistDir;
+        const indexPath = (0, path_1.resolve)(normalizedReactDistDir, 'index.html');
+        if (!indexPath.startsWith(normalizedReactDistDir + path_1.sep) &&
+            indexPath !== normalizedReactDistDir) {
+            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_InvalidIndexPathEscapesBaseDirectory);
+        }
+        this.indexPath = indexPath;
+        const assetsPath = (0, path_1.resolve)(normalizedReactDistDir, 'assets');
+        if (!assetsPath.startsWith(normalizedReactDistDir + path_1.sep) &&
+            assetsPath !== normalizedReactDistDir) {
+            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_InvalidAssetsPathEscapesBaseDirectory);
+        }
+        this.assetsDir = assetsPath;
+    }
+    /**
+     * Gets the filename of an asset matching a pattern.
+     * @param assetDir Directory to search in
+     * @param pattern Regular expression pattern to match
+     * @returns Filename if found, undefined otherwise
+     */
+    getAssetFilename(assetDir, pattern) {
+        try {
+            // Prevent path traversal by validating assetDir is within expected directory
+            // amazonq-ignore-next-line already addressed
+            if (
+            // amazonq-ignore-next-line
+            assetDir.includes('..') ||
+                !assetDir.startsWith(this.reactDistDir)) {
+                return undefined;
+            }
+            const files = (0, fs_1.readdirSync)(assetDir, 'utf8');
+            return files.find((f) => pattern.test(f));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Gets base view locals for EJS template rendering.
+     * Subclasses can override to add additional locals.
+     * @param req Express request
+     * @param res Express response
+     * @returns Object containing base template variables
+     */
+    getBaseViewLocals(req, res) {
+        const SiteName = this.application.constants.Site;
+        const SiteTagline = this.application.constants.SiteTagline;
+        const SiteDescription = this.application.constants.SiteDescription;
+        const hostname = req.hostname;
+        const server = (req.socket.localPort === 443 && req.protocol === 'https') ||
+            (req.socket.localPort === 80 && req.protocol === 'http')
+            ? `${req.protocol}://${hostname}`
+            : `${req.protocol}://${hostname}:${req.socket.localPort}`;
+        return {
+            cspNonce: res.locals['cspNonce'],
+            title: SiteName,
+            tagline: SiteTagline,
+            description: SiteDescription,
+            server,
+            siteUrl: this.apiRouter.application.environment.serverUrl,
+            baseHref: this.apiRouter.application.environment.basePath,
+            hostname,
+            siteTitle: SiteName,
+        };
+    }
+    /**
+     * Renders an EJS template with the provided locals.
+     * @param req Express request
+     * @param res Express response
+     * @param next Express next function
+     * @param template Template name to render
+     * @param locals Template variables
+     */
+    renderTemplate(req, res, next, template, locals) {
+        if (!/^[\w/-]+$/.test(template)) {
+            next(new Error('Invalid template name requested'));
+            return;
+        }
+        const sanitizedUrl = (req.url || '').replace(/[\r\n]/g, ' ');
+        (0, utils_1.debugLog)(this.apiRouter.application.environment.debug, 'log', `Rendering view "${template}" for ${sanitizedUrl}`);
+        res.render(template, locals, (err, html) => {
+            if (err) {
+                const errMsg = err && typeof err === 'object' && 'message' in err
+                    ? String(err.message).replace(/[\r\n]/g, ' ')
+                    : 'Unknown error';
+                console.error('Error rendering: ' + errMsg);
+                const normalizedError = err instanceof Error ? err : new Error(errMsg);
+                if (!res.headersSent) {
+                    res.status(500).send('An error occurred');
+                }
+                next(normalizedError);
+                return;
+            }
+            if (!html) {
+                next(new Error(`Rendered template "${template}" returned empty HTML`));
+                return;
+            }
+            (0, utils_1.debugLog)(this.apiRouter.application.environment.debug, 'log', `Rendered view "${template}" for ${sanitizedUrl}`);
+            res.send(html);
+        });
+    }
+    /**
+     * Creates a view renderer function for a specific template.
+     * @param template Template name to render
+     * @param localsFactory Optional function to generate additional locals
+     * @returns Express middleware function
+     */
+    createViewRenderer(template, localsFactory) {
+        return (req, res, next) => {
+            const baseLocals = this.getBaseViewLocals(req, res);
+            const extraLocals = localsFactory ? localsFactory(req, res) : {};
+            this.renderTemplate(req, res, next, template, {
+                ...baseLocals,
+                ...extraLocals,
+            });
+        };
+    }
+    /**
+     * Override to register additional routes (e.g. other EJS pages) before the index catch-all.
+     * @param app Express application
+     */
+    registerAdditionalRenderHooks(app) {
+        void app;
+    }
+    /**
+     * Renders the index.html page with injected asset paths.
+     * @param req Express request
+     * @param res Express response
+     * @param next Express next function
+     */
+    renderIndex(req, res, next) {
+        if (req.url.endsWith('.js')) {
+            res.type('application/javascript');
+        }
+        const jsFile = this.getAssetFilename(this.assetsDir, /^index-.*\.js$/);
+        const cssFile = this.getAssetFilename(this.assetsDir, /^index-.*\.css$/);
+        const locals = {
+            ...this.getBaseViewLocals(req, res),
+            jsFile: jsFile ? `assets/${jsFile}` : undefined,
+            cssFile: cssFile ? `assets/${cssFile}` : undefined,
+        };
+        this.renderTemplate(req, res, next, 'index', locals);
+    }
+    /**
+     * Initializes the application router with all routes and middleware.
+     * Sets up API routes, static file serving, and catch-all routing.
+     * @param app Express application
+     * @throws {TranslatableGenericError} If index file not found or invalid paths
+     */
+    init(app) {
+        const reactDistHasDistSegment = this.reactDistDir
+            .split(path_1.sep)
+            .filter((segment) => segment.length > 0)
+            .some((segment) => segment.toLowerCase() === 'dist');
+        if (!reactDistHasDistSegment) {
+            throw new i18n_lib_1.TranslatableGenericError(i18n_lib_1.CoreI18nComponentId, suite_core_lib_1.SuiteCoreStringKey.Error_AppDoesNotAppearToBeRunningWithinDistTemplate, { dir: this.apiRouter.application.environment.reactDistDir });
+        }
+        if (!(0, fs_1.existsSync)(this.indexPath)) {
+            throw new i18n_lib_1.TranslatableGenericError(i18n_lib_1.CoreI18nComponentId, suite_core_lib_1.SuiteCoreStringKey.Error_IndexFileNotFoundTemplate, { path: this.indexPath });
+        }
+        if (this.apiRouter.application.environment.debug) {
+            app.use((req, res, next) => {
+                const port = (req.socket.localPort === 443 && req.protocol === 'https') ||
+                    (req.socket.localPort === 80 && req.protocol === 'http')
+                    ? ''
+                    : `:${req.socket.localPort}`;
+                // amazonq-ignore-next-line
+                console.log((0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Admin_ServingRoute) +
+                    ': method=' +
+                    req.method +
+                    ' url=' +
+                    req.protocol +
+                    '://' +
+                    req.hostname +
+                    port +
+                    (req.url || '').replace(/[\r\n]/g, ' '));
+                next();
+            });
+        }
+        app.use('/api', this.apiRouter.router);
+        app.set('views', this.viewsPath);
+        app.set('view engine', 'ejs');
+        // Serve static files from the React app build directory (validated in constructor)
+        app.use('/assets', (0, express_1.static)(this.assetsDir));
+        const serveStaticWithLogging = (0, express_1.static)(this.reactDistDir);
+        app.use('/static/js', (0, express_1.static)(this.reactDistDir));
+        app.use((req, res, next) => {
+            if (req.url === '/') {
+                next();
+                return;
+            }
+            (0, utils_1.debugLog)(this.apiRouter.application.environment.debug, 'log', `Trying to serve static for ${(req.url || '').replace(/[\r\n]/g, ' ')}`);
+            if (req.url.endsWith('.js')) {
+                res.type('application/javascript');
+            }
+            serveStaticWithLogging(req, res, (err) => {
+                if (err) {
+                    const sanitizedErr = err instanceof Error
+                        ? err.message.replace(/[\r\n]/g, ' ')
+                        : String(err).replace(/[\r\n]/g, ' ');
+                    (0, utils_1.debugLog)(this.apiRouter.application.environment.debug, 'error', 'Error serving static file:', sanitizedErr);
+                    (0, utils_1.handleError)(err, res, utils_1.sendApiMessageResponse, next);
+                    return;
+                }
+                next();
+            });
+        });
+        // The "catchall" handler: for any request that doesn't
+        // match one above, send back React's index.html file.
+        // app.get('*', (req, res) => {
+        //   res.sendFile(path.join(__dirname,'..', '..', '..', 'myapp-react', 'index.html'));
+        // });
+        this.registerAdditionalRenderHooks(app);
+        app.use((req, res, next) => {
+            this.renderIndex(req, res, next);
+        });
+    }
+}
+exports.AppRouter = AppRouter;
+//# sourceMappingURL=app.js.map

package/src/routers/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/routers/app.ts"],"names":[],"mappings":"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"}

package/src/routers/{base.ts → base.d.ts}

@@ -3,32 +3,24 @@
  * All routers extend this class to access application context and Express router.
  * @module routers/base
  */
-
 import { Router } from 'express';
 import { IApplication } from '../interfaces/application';
 import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
-
 /**
  * Abstract base class for all routers in the application.
  * Provides access to the Express router and application instance.
  * @template TID Platform-specific ID type (Buffer, ObjectId, etc.)
  * @template TApplication Application instance type
  */
-export abstract class BaseRouter<
-  TID extends PlatformID = Buffer,
-  TApplication extends IApplication<TID> = IApplication<TID>,
-> {
-  /** Express router instance for registering routes */
-  public readonly router: Router;
-  /** Application instance providing access to services and configuration */
-  public readonly application: TApplication;
-
-  /**
-   * Creates a new base router instance.
-   * @param application Application instance
-   */
-  protected constructor(application: TApplication) {
-    this.application = application;
-    this.router = Router();
-  }
+export declare abstract class BaseRouter<TID extends PlatformID = Buffer, TApplication extends IApplication<TID> = IApplication<TID>> {
+    /** Express router instance for registering routes */
+    readonly router: Router;
+    /** Application instance providing access to services and configuration */
+    readonly application: TApplication;
+    /**
+     * Creates a new base router instance.
+     * @param application Application instance
+     */
+    protected constructor(application: TApplication);
 }
+//# sourceMappingURL=base.d.ts.map

package/src/routers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/routers/base.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE;;;;;GAKG;AACH,8BAAsB,UAAU,CAC9B,GAAG,SAAS,UAAU,GAAG,MAAM,EAC/B,YAAY,SAAS,YAAY,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC;IAE1D,qDAAqD;IACrD,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,SAAgB,WAAW,EAAE,YAAY,CAAC;IAE1C;;;OAGG;IACH,SAAS,aAAa,WAAW,EAAE,YAAY;CAIhD"}

package/src/routers/base.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * @fileoverview Base router class providing common router functionality.
+ * All routers extend this class to access application context and Express router.
+ * @module routers/base
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseRouter = void 0;
+const express_1 = require("express");
+/**
+ * Abstract base class for all routers in the application.
+ * Provides access to the Express router and application instance.
+ * @template TID Platform-specific ID type (Buffer, ObjectId, etc.)
+ * @template TApplication Application instance type
+ */
+class BaseRouter {
+    /** Express router instance for registering routes */
+    router;
+    /** Application instance providing access to services and configuration */
+    application;
+    /**
+     * Creates a new base router instance.
+     * @param application Application instance
+     */
+    constructor(application) {
+        this.application = application;
+        this.router = (0, express_1.Router)();
+    }
+}
+exports.BaseRouter = BaseRouter;
+//# sourceMappingURL=base.js.map

package/src/routers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/routers/base.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,qCAAiC;AAIjC;;;;;GAKG;AACH,MAAsB,UAAU;IAI9B,qDAAqD;IACrC,MAAM,CAAS;IAC/B,0EAA0E;IAC1D,WAAW,CAAe;IAE1C;;;OAGG;IACH,YAAsB,WAAyB;QAC7C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,IAAA,gBAAM,GAAE,CAAC;IACzB,CAAC;CACF;AAjBD,gCAiBC"}

package/src/routers/{index.ts → index.d.ts}

@@ -1,3 +1,4 @@
 export * from './api';
 export * from './app';
 export * from './base';
+//# sourceMappingURL=index.d.ts.map

package/src/routers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/routers/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC"}

package/src/routers/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./api"), exports);
+tslib_1.__exportStar(require("./app"), exports);
+tslib_1.__exportStar(require("./base"), exports);
+//# sourceMappingURL=index.js.map

package/src/routers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/routers/index.ts"],"names":[],"mappings":";;;AAAA,gDAAsB;AACtB,gDAAsB;AACtB,iDAAuB"}

package/src/routers/router-config.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Router configuration interface and defaults.
+ * Defines configuration options for router setup including static paths, view engine, and middleware.
+ * @module routers/router-config
+ */
+import { RequestHandler } from 'express';
+/**
+ * Configuration interface for router setup.
+ */
+export interface RouterConfig {
+    /** Array of static path configurations with prefix and directory */
+    staticPaths?: Array<{
+        prefix: string;
+        directory: string;
+    }>;
+    /** View engine configuration with name and views path */
+    viewEngine?: {
+        name: string;
+        viewsPath: string;
+    };
+    /** Array of middleware functions to apply */
+    middleware?: RequestHandler[];
+    /** CORS configuration options */
+    cors?: {
+        /** Allowed origin(s) for CORS */
+        origin?: string | string[];
+        /** Whether to allow credentials */
+        credentials?: boolean;
+    };
+}
+/**
+ * Default router configuration with empty arrays.
+ */
+export declare const DefaultRouterConfig: RouterConfig;
+//# sourceMappingURL=router-config.d.ts.map

package/src/routers/router-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-config.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/routers/router-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,yDAAyD;IACzD,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,6CAA6C;IAC7C,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,iCAAiC;IACjC,IAAI,CAAC,EAAE;QACL,iCAAiC;QACjC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC3B,mCAAmC;QACnC,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAGjC,CAAC"}

package/src/routers/router-config.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * @fileoverview Router configuration interface and defaults.
+ * Defines configuration options for router setup including static paths, view engine, and middleware.
+ * @module routers/router-config
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultRouterConfig = void 0;
+/**
+ * Default router configuration with empty arrays.
+ */
+exports.DefaultRouterConfig = {
+    staticPaths: [],
+    middleware: [],
+};
+//# sourceMappingURL=router-config.js.map

package/src/routers/router-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-config.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/routers/router-config.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAuBH;;GAEG;AACU,QAAA,mBAAmB,GAAiB;IAC/C,WAAW,EAAE,EAAE;IACf,UAAU,EAAE,EAAE;CACf,CAAC"}

package/src/routing/index.d.ts

@@ -0,0 +1,2 @@
+export * from './route-builder';
+//# sourceMappingURL=index.d.ts.map

package/src/routing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/routing/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/src/routing/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./route-builder"), exports);
+//# sourceMappingURL=index.js.map

package/src/routing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/routing/index.ts"],"names":[],"mappings":";;;AAAA,0DAAgC"}

package/src/routing/route-builder.d.ts

@@ -0,0 +1,121 @@
+/**
+ * @fileoverview Route builder for fluent route configuration.
+ * Provides builder pattern for defining Express routes.
+ * @module routing/route-builder
+ */
+import { RequestHandler } from 'express';
+import { ValidationChain } from 'express-validator';
+import { z } from 'zod';
+/**
+ * Builder for constructing route configurations with fluent API.
+ * @template TLanguage - Language code type (defaults to string)
+ */
+export declare class RouteBuilder<TLanguage extends string = string> {
+    private config;
+    /**
+     * Creates a new RouteBuilder instance.
+     * @template T - Language code type
+     * @returns {RouteBuilder<T>} New builder instance
+     */
+    static create<T extends string = string>(): RouteBuilder<T>;
+    /**
+     * Sets GET method and path.
+     * @param {string} path - Route path
+     * @returns {this} This builder for chaining
+     */
+    get(path: string): this;
+    /**
+     * Sets POST method and path.
+     * @param {string} path - Route path
+     * @returns {this} This builder for chaining
+     */
+    post(path: string): this;
+    /**
+     * Sets PUT method and path.
+     * @param {string} path - Route path
+     * @returns {this} This builder for chaining
+     */
+    put(path: string): this;
+    /**
+     * Sets DELETE method and path.
+     * @param {string} path - Route path
+     * @returns {this} This builder for chaining
+     */
+    delete(path: string): this;
+    /**
+     * Sets PATCH method and path.
+     * @param {string} path - Route path
+     * @returns {this} This builder for chaining
+     */
+    patch(path: string): this;
+    /**
+     * Enables authentication.
+     * @param {boolean} [enabled=true] - Whether to enable authentication
+     * @returns {this} This builder for chaining
+     */
+    auth(enabled?: boolean): this;
+    /**
+     * Enables crypto authentication.
+     * @param {boolean} [enabled=true] - Whether to enable crypto authentication
+     * @returns {this} This builder for chaining
+     */
+    cryptoAuth(enabled?: boolean): this;
+    /**
+     * Sets validation chains.
+     * @param {ValidationChain[] | Function} validation - Validation chains or factory function
+     * @returns {this} This builder for chaining
+     */
+    validate(validation: ValidationChain[] | ((lang: TLanguage) => ValidationChain[])): this;
+    /**
+     * Sets Zod schema for validation.
+     * @param {z.ZodSchema} schema - Zod schema
+     * @returns {this} This builder for chaining
+     */
+    schema(schema: z.ZodSchema): this;
+    /**
+     * Adds middleware to the route.
+     * @param {...RequestHandler[]} middleware - Middleware functions
+     * @returns {this} This builder for chaining
+     */
+    use(...middleware: RequestHandler[]): this;
+    /**
+     * Enables transaction support.
+     * @param {boolean} [enabled=true] - Whether to enable transactions
+     * @param {number} [timeout] - Transaction timeout in milliseconds
+     * @returns {this} This builder for chaining
+     */
+    transaction(enabled?: boolean, timeout?: number): this;
+    /**
+     * Enables raw JSON handling.
+     * @param {boolean} [enabled=true] - Whether to enable raw JSON
+     * @returns {this} This builder for chaining
+     */
+    rawJson(enabled?: boolean): this;
+    /**
+     * Builds the route configuration with handler.
+     * @param {RequestHandler} handler - Route handler function
+     * @returns {RouteConfig<TLanguage>} Complete route configuration
+     * @throws {Error} If method or path not set
+     */
+    handle(handler: RequestHandler): RouteConfig<TLanguage>;
+}
+/**
+ * Route configuration interface.
+ * @template TLanguage - Language code type (defaults to string)
+ */
+export interface RouteConfig<TLanguage extends string = string> {
+    method: 'get' | 'post' | 'put' | 'delete' | 'patch';
+    path: string;
+    handler: RequestHandler;
+    options: {
+        auth?: boolean;
+        cryptoAuth?: boolean;
+        validation?: ValidationChain[] | ((lang: TLanguage) => ValidationChain[]);
+        schema?: z.ZodSchema;
+        middleware?: RequestHandler[];
+        transaction?: boolean;
+        transactionTimeout?: number;
+        rawJson?: boolean;
+    };
+}
+//# sourceMappingURL=route-builder.d.ts.map

package/src/routing/route-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-builder.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/routing/route-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,qBAAa,YAAY,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IACzD,OAAO,CAAC,MAAM,CAYP;IAEP;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC;IAI3D;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMvB;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMxB;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMvB;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM1B;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMzB;;;;OAIG;IACH,IAAI,CAAC,OAAO,UAAO,GAAG,IAAI;IAK1B;;;;OAIG;IACH,UAAU,CAAC,OAAO,UAAO,GAAG,IAAI;IAKhC;;;;OAIG;IACH,QAAQ,CACN,UAAU,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,eAAe,EAAE,CAAC,GACvE,IAAI;IAKP;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,GAAG,IAAI;IAKjC;;;;OAIG;IACH,GAAG,CAAC,GAAG,UAAU,EAAE,cAAc,EAAE,GAAG,IAAI;IAK1C;;;;;OAKG;IACH,WAAW,CAAC,OAAO,UAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAMnD;;;;OAIG;IACH,OAAO,CAAC,OAAO,UAAO,GAAG,IAAI;IAK7B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,WAAW,CAAC,SAAS,CAAC;CAoBxD;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAC5D,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,eAAe,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC;QACrB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;QAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH"}