exisjs 0.7.6 → 0.7.8

package/dist/router/scanner/cron-mounter.js

@@ -0,0 +1,216 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mountCronJobs = mountCronJobs;
+exports.mountCronJobsFromEntries = mountCronJobsFromEntries;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const node_url_1 = require("node:url");
+const fs_scanner_1 = require("./fs-scanner");
+/**
+ * Discovers and mounts all cron jobs from dedicated directories (e.g. `src/cron/`)
+ * and single-file/colocated cron definitions (e.g. `src/http/cron.ts`).
+ */
+async function mountCronJobs(root, app, allApiDirs) {
+    const cronFiles = [];
+    // 1. Scan dedicated src/cron and .exis/server/src/cron directories (all files are cron jobs)
+    const dedicatedCronDirs = [
+        path.join(root, '.exis', 'server', 'src', 'cron'),
+        path.join(root, '.exis', 'src', 'cron'),
+        path.join(root, 'src', 'cron'),
+    ];
+    for (const dir of dedicatedCronDirs) {
+        try {
+            const stat = await fs.stat(dir);
+            if (stat.isDirectory()) {
+                const files = await (0, fs_scanner_1.getFilesRecursively)(dir);
+                for (const file of files) {
+                    if (!cronFiles.includes(file)) {
+                        cronFiles.push(file);
+                    }
+                }
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    // 2. Scan single-file and colocated cron files in src/http (e.g. src/http/cron.ts)
+    const httpDirs = allApiDirs && allApiDirs.length > 0
+        ? allApiDirs
+        : [
+            path.join(root, '.exis', 'server', 'src', 'http'),
+            path.join(root, '.exis', 'src', 'http'),
+            path.join(root, 'src', 'http'),
+        ];
+    for (const dir of httpDirs) {
+        try {
+            const stat = await fs.stat(dir).catch(() => null);
+            if (!stat || !stat.isDirectory())
+                continue;
+            const scan = await (0, fs_scanner_1.scanDirectory)(dir);
+            for (const { filePath } of scan) {
+                const baseName = path.basename(filePath);
+                if (baseName === 'cron.ts' ||
+                    baseName === 'cron.js' ||
+                    baseName === 'cron.mjs' ||
+                    baseName === 'cron.cjs') {
+                    if (!cronFiles.includes(filePath)) {
+                        cronFiles.push(filePath);
+                    }
+                }
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    const entries = [];
+    for (const file of cronFiles) {
+        try {
+            const url = process.env.VITEST || process.env.NODE_ENV === 'test'
+                ? (0, node_url_1.pathToFileURL)(file).href
+                : (0, node_url_1.pathToFileURL)(file).href + '?t=' + Date.now();
+            let mod;
+            try {
+                if (process.env.VITEST || process.env.NODE_ENV === 'test') {
+                    mod = await Promise.resolve(`${url}`).then(s => __importStar(require(s)));
+                }
+                else {
+                    const dynamicImport = new Function('specifier', 'return import(specifier)');
+                    mod = await dynamicImport(url);
+                }
+            }
+            catch {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                mod = require(file);
+            }
+            entries.push({ filePath: file, module: mod });
+        }
+        catch (err) {
+            app.log.error({ err: err.message, file }, `Failed to load cron file: ${file}`);
+        }
+    }
+    mountCronJobsFromEntries(entries, app);
+}
+/**
+ * Mounts cron jobs from pre-loaded module entries (used by both filesystem discovery and manifest boot).
+ */
+function mountCronJobsFromEntries(entries, app) {
+    const CRON_REGISTRY = Symbol.for('exisjs:cron_jobs');
+    const registeredCronEntities = new Set();
+    for (const { filePath: file, module: mod } of entries) {
+        try {
+            const candidateExports = [];
+            const unwrapped = mod && mod.default && mod.default.default
+                ? mod.default.default
+                : mod && mod.default
+                    ? mod.default
+                    : mod;
+            if (unwrapped) {
+                candidateExports.push({ key: 'default', value: unwrapped });
+            }
+            if (mod && typeof mod === 'object' && !mod.__isExisCron) {
+                for (const [key, value] of Object.entries(mod)) {
+                    if (key !== 'default' && key !== '__esModule') {
+                        candidateExports.push({ key, value });
+                    }
+                }
+            }
+            const fileBaseName = path.basename(file).replace(/\.[jmt]s$/, '');
+            for (const { key, value } of candidateExports) {
+                if (!value || registeredCronEntities.has(value))
+                    continue;
+                // Handle array of cron jobs (e.g. export default [job1, job2])
+                const items = Array.isArray(value) ? value : [value];
+                for (const item of items) {
+                    if (!item || registeredCronEntities.has(item))
+                        continue;
+                    // 1. Functional Cron Definition
+                    if (item.__isExisCron) {
+                        registeredCronEntities.add(item);
+                        const jobName = item.options.name ||
+                            (key === 'default' ? fileBaseName : `${fileBaseName}_${key}`);
+                        app.cron.schedule({
+                            ...item.options,
+                            name: jobName,
+                        });
+                        app.log.info({ file }, `Mounted cron job "${jobName}" from ${file}`);
+                        continue;
+                    }
+                    // 2. Class-Based Decorated Cron
+                    const targetClass = typeof item === 'function' && item.prototype?.[CRON_REGISTRY]
+                        ? item
+                        : null;
+                    if (targetClass) {
+                        registeredCronEntities.add(targetClass);
+                        let instance;
+                        try {
+                            instance = app.container.resolve(targetClass);
+                        }
+                        catch {
+                            instance = null;
+                        }
+                        if (!instance) {
+                            try {
+                                instance = app.container.instantiateClass(targetClass);
+                            }
+                            catch {
+                                instance = new targetClass();
+                            }
+                        }
+                        const decoratedJobs = targetClass.prototype[CRON_REGISTRY];
+                        if (Array.isArray(decoratedJobs)) {
+                            for (const jobMeta of decoratedJobs) {
+                                const jobName = jobMeta.options.name ||
+                                    `${targetClass.name}.${jobMeta.methodName}`;
+                                app.cron.schedule({
+                                    ...jobMeta.options,
+                                    name: jobName,
+                                    run: instance[jobMeta.methodName].bind(instance),
+                                });
+                                app.log.info({ file }, `Mounted OOP cron job "${jobName}" from ${file}`);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        catch (err) {
+            app.log.error({ err: err.message, file }, `Failed to load cron file: ${file}`);
+        }
+    }
+}
+//# sourceMappingURL=cron-mounter.js.map

package/dist/router/scanner/cron-mounter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-mounter.js","sourceRoot":"","sources":["../../../src/router/scanner/cron-mounter.ts"],"names":[],"mappings":"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"}

package/dist/router/scanner/error-mounter.d.ts

@@ -0,0 +1,14 @@
+import type { App } from '../../server/app';
+/**
+ * Discovers and mounts the global error handler for a given HTTP directory.
+ */
+export declare function mountErrorHandler(dir: string, app: App): Promise<void>;
+/**
+ * Mounts a global error handler from an already loaded module export.
+ * Supports:
+ * - OOP class error handlers with DI resolution (`onError`, `catch`, `handle`, `handleError`)
+ * - Object-based error handlers
+ * - Functional error handler callbacks `(err, req, res, next)`
+ */
+export declare function mountErrorHandlerFromModule(mod: any, app: App, errorFile?: string): void;
+//# sourceMappingURL=error-mounter.d.ts.map

package/dist/router/scanner/error-mounter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mounter.d.ts","sourceRoot":"","sources":["../../../src/router/scanner/error-mounter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAE3C;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CA6D5E;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,EACR,SAAS,SAAa,GACrB,IAAI,CA+GN"}

package/dist/router/scanner/error-mounter.js

@@ -0,0 +1,200 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mountErrorHandler = mountErrorHandler;
+exports.mountErrorHandlerFromModule = mountErrorHandlerFromModule;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const node_url_1 = require("node:url");
+/**
+ * Discovers and mounts the global error handler for a given HTTP directory.
+ */
+async function mountErrorHandler(dir, app) {
+    const candidateFiles = [
+        path.join(dir, 'error.ts'),
+        path.join(dir, 'error.js'),
+        path.join(dir, 'error.mjs'),
+        path.join(dir, 'error.cjs'),
+    ];
+    let errorFile = null;
+    for (const file of candidateFiles) {
+        try {
+            const stat = await fs.stat(file);
+            if (stat.isFile()) {
+                errorFile = file;
+                break;
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    if (!errorFile) {
+        try {
+            const dirFiles = await fs.readdir(dir).catch(() => []);
+            const namedError = dirFiles.find((f) => /\.error\.[jmt]s$/.test(f));
+            if (namedError) {
+                errorFile = path.join(dir, namedError);
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    if (!errorFile)
+        return;
+    try {
+        const url = process.env.VITEST || process.env.NODE_ENV === 'test'
+            ? (0, node_url_1.pathToFileURL)(errorFile).href
+            : (0, node_url_1.pathToFileURL)(errorFile).href + '?t=' + Date.now();
+        let mod;
+        if (process.env.VITEST || process.env.NODE_ENV === 'test') {
+            mod = await Promise.resolve(`${url}`).then(s => __importStar(require(s)));
+        }
+        else {
+            const dynamicImport = new Function('specifier', 'return import(specifier)');
+            mod = await dynamicImport(url);
+        }
+        mountErrorHandlerFromModule(mod, app, errorFile);
+    }
+    catch (err) {
+        app.log.error({ err, file: errorFile }, `Failed to load error handler file: ${errorFile}`);
+    }
+}
+/**
+ * Mounts a global error handler from an already loaded module export.
+ * Supports:
+ * - OOP class error handlers with DI resolution (`onError`, `catch`, `handle`, `handleError`)
+ * - Object-based error handlers
+ * - Functional error handler callbacks `(err, req, res, next)`
+ */
+function mountErrorHandlerFromModule(mod, app, errorFile = 'error.ts') {
+    try {
+        const unwrapped = mod && mod.default && mod.default.default
+            ? mod.default.default
+            : mod && mod.default
+                ? mod.default
+                : mod;
+        let handler = null;
+        const isClass = (fn) => {
+            if (typeof fn !== 'function')
+                return false;
+            if (fn.prototype &&
+                (typeof fn.prototype.onError === 'function' ||
+                    typeof fn.prototype.catch === 'function' ||
+                    typeof fn.prototype.handle === 'function' ||
+                    typeof fn.prototype.handleError === 'function')) {
+                return true;
+            }
+            return /^class\s/.test(Function.prototype.toString.call(fn));
+        };
+        const targetClass = isClass(unwrapped)
+            ? unwrapped
+            : isClass(mod?.GlobalErrorHandler)
+                ? mod.GlobalErrorHandler
+                : isClass(mod?.ErrorHandler)
+                    ? mod.ErrorHandler
+                    : null;
+        if (targetClass) {
+            let instance;
+            try {
+                instance = app.container.resolve(targetClass);
+            }
+            catch {
+                instance = null;
+            }
+            if (!instance) {
+                try {
+                    instance = app.container.instantiateClass(targetClass);
+                }
+                catch {
+                    instance = new targetClass();
+                }
+            }
+            const method = instance.onError ||
+                instance.catch ||
+                instance.handle ||
+                instance.handleError;
+            if (typeof method === 'function') {
+                handler = (err, req, res, next) => {
+                    if (method.length === 2 && instance.catch === method) {
+                        return method.call(instance, err, { req, res, next });
+                    }
+                    return method.call(instance, err, req, res, next);
+                };
+            }
+        }
+        else if (unwrapped &&
+            typeof unwrapped === 'object' &&
+            (typeof unwrapped.onError === 'function' ||
+                typeof unwrapped.catch === 'function' ||
+                typeof unwrapped.handle === 'function' ||
+                typeof unwrapped.handleError === 'function')) {
+            const method = unwrapped.onError ||
+                unwrapped.catch ||
+                unwrapped.handle ||
+                unwrapped.handleError;
+            handler = (err, req, res, next) => {
+                if (method.length === 2 && unwrapped.catch === method) {
+                    return method.call(unwrapped, err, { req, res, next });
+                }
+                return method.call(unwrapped, err, req, res, next);
+            };
+        }
+        if (!handler) {
+            handler =
+                mod.onError ||
+                    (unwrapped && unwrapped.onError) ||
+                    (typeof unwrapped === 'function' && !isClass(unwrapped)
+                        ? unwrapped
+                        : null) ||
+                    mod.errorHandler ||
+                    mod.handleError;
+        }
+        if (typeof handler === 'function') {
+            if (handler.length === 4) {
+                app.use(handler);
+            }
+            else {
+                app.onError(handler);
+            }
+            app.log.info({ file: errorFile }, 'Mounted global error handler from error.ts');
+        }
+    }
+    catch (err) {
+        app.log.error({ err, file: errorFile }, `Failed to load error handler file: ${errorFile}`);
+    }
+}
+//# sourceMappingURL=error-mounter.js.map

package/dist/router/scanner/error-mounter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mounter.js","sourceRoot":"","sources":["../../../src/router/scanner/error-mounter.ts"],"names":[],"mappings":"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"}

package/dist/router/scanner/fs-scanner.d.ts

@@ -0,0 +1,25 @@
+export interface ScannedRoute {
+    filePath: string;
+    routePath: string;
+}
+/**
+ * Recursively scans a directory and computes the route path for each file.
+ * Handles:
+ * - `(group)` route groups (skipped from URL path)
+ * - `[...param]` wildcard parameters (transformed to `*param`)
+ * - `[param]` dynamic route parameters (transformed to `:param`)
+ */
+export declare function scanDirectory(dir: string, baseRoute?: string): Promise<ScannedRoute[]>;
+/**
+ * Recursively retrieves all files within a directory matching script extensions.
+ */
+export declare function getFilesRecursively(dir: string): Promise<string[]>;
+/**
+ * Determines whether a file path represents a boundary definition.
+ */
+export declare function isBoundaryFile(filePath: string): boolean;
+/**
+ * Determines whether a file path represents a route definition.
+ */
+export declare function isRouteFile(filePath: string): boolean;
+//# sourceMappingURL=fs-scanner.d.ts.map

package/dist/router/scanner/fs-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-scanner.d.ts","sourceRoot":"","sources":["../../../src/router/scanner/fs-scanner.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,SAAS,SAAM,GACd,OAAO,CAAC,YAAY,EAAE,CAAC,CAiCzB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBxE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMxD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMrD"}

package/dist/router/scanner/fs-scanner.js

@@ -0,0 +1,115 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanDirectory = scanDirectory;
+exports.getFilesRecursively = getFilesRecursively;
+exports.isBoundaryFile = isBoundaryFile;
+exports.isRouteFile = isRouteFile;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+/**
+ * Recursively scans a directory and computes the route path for each file.
+ * Handles:
+ * - `(group)` route groups (skipped from URL path)
+ * - `[...param]` wildcard parameters (transformed to `*param`)
+ * - `[param]` dynamic route parameters (transformed to `:param`)
+ */
+async function scanDirectory(dir, baseRoute = '/') {
+    const entries = await fs.readdir(dir, { withFileTypes: true }).catch(() => []);
+    const results = [];
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            let segment = entry.name;
+            // Route groups: (group) -> do not add segment to URL
+            if (segment.startsWith('(') && segment.endsWith(')')) {
+                const subResults = await scanDirectory(fullPath, baseRoute);
+                results.push(...subResults);
+                continue;
+            }
+            // Wildcard / Catch-all params: [...slug] -> *slug
+            if (segment.startsWith('[...') && segment.endsWith(']')) {
+                segment = '*' + segment.slice(4, -1);
+            }
+            else {
+                // Dynamic route params: [id] -> :id
+                segment = segment.replace(/\[(.*?)\]/g, ':$1');
+            }
+            const nextBase = baseRoute === '/' ? `/${segment}` : `${baseRoute}/${segment}`;
+            const subResults = await scanDirectory(fullPath, nextBase);
+            results.push(...subResults);
+        }
+        else {
+            results.push({ filePath: fullPath, routePath: baseRoute });
+        }
+    }
+    return results;
+}
+/**
+ * Recursively retrieves all files within a directory matching script extensions.
+ */
+async function getFilesRecursively(dir) {
+    const entries = await fs.readdir(dir, { withFileTypes: true }).catch(() => []);
+    const files = [];
+    for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...(await getFilesRecursively(full)));
+        }
+        else if (entry.isFile() &&
+            /\.[jmt]s$/.test(entry.name) &&
+            !entry.name.endsWith('.d.ts')) {
+            files.push(full);
+        }
+    }
+    return files;
+}
+/**
+ * Determines whether a file path represents a boundary definition.
+ */
+function isBoundaryFile(filePath) {
+    return (filePath.endsWith('boundary.ts') ||
+        filePath.endsWith('boundary.js') ||
+        /\.boundary\.[jt]s$/.test(filePath));
+}
+/**
+ * Determines whether a file path represents a route definition.
+ */
+function isRouteFile(filePath) {
+    return (filePath.endsWith('route.ts') ||
+        filePath.endsWith('route.js') ||
+        /\.route\.[jt]s$/.test(filePath));
+}
+//# sourceMappingURL=fs-scanner.js.map

package/dist/router/scanner/fs-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-scanner.js","sourceRoot":"","sources":["../../../src/router/scanner/fs-scanner.ts"],"names":[],"mappings":"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"}

package/dist/router/scanner/functional-compiler.d.ts

@@ -0,0 +1,9 @@
+import { Router } from '../router';
+import type { App } from '../../server/app';
+/**
+ * Compiles a modern functional controller configuration object into an ExisJS Router instance.
+ * Assembles middleware, route parameter / body validation, guard checking, context injection,
+ * and error interception into an ultra-high performance handler pipeline.
+ */
+export declare function compileFunctionalController(config: any, app: App): Router;
+//# sourceMappingURL=functional-compiler.d.ts.map

package/dist/router/scanner/functional-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functional-compiler.d.ts","sourceRoot":"","sources":["../../../src/router/scanner/functional-compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAIlC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAE3C;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,MAAM,CAwPzE"}