@thoughtpivot/flight 1.0.8 → 1.1.0

package/README.md

@@ -97,6 +97,7 @@ node flight.js --mode production --app_home .
 Available CLI options:
 
 - `--app_home`: Application root directory (default: current directory)
+- `--exclude_paths` / `--exclude-paths`: Directories under `app_home` to omit when discovering `**/*.backend.ts` routes. Repeat the flag (`--exclude_paths node_modules --exclude_paths dist`) or use commas (`--exclude_paths node_modules,dist`). Also accepts `FLIGHT_EXCLUDE_PATHS` (comma-separated). Paths must stay inside `app_home`.
 - `--app_key`: Application key for sessions (default: 'flightApp')
 - `--app_secret`: Secret key for session encryption (default: 'the best secret key in the world')
 - `--mode`: 'development' or 'production' (default: 'production')

package/dist/flight.js

@@ -21,9 +21,54 @@ const path_1 = __importDefault(require("path"));
 const koa_ratelimit_1 = __importDefault(require("koa-ratelimit"));
 const koa_static_1 = __importDefault(require("koa-static"));
 const koa_session_1 = __importDefault(require("koa-session"));
+function normalizeExcludePaths(value) {
+    if (value == null || value === '')
+        return [];
+    const parts = Array.isArray(value) ? value : [value];
+    const out = [];
+    for (const p of parts) {
+        const s = String(p).trim();
+        if (!s)
+            continue;
+        out.push(...s
+            .split(',')
+            .map((x) => x.trim())
+            .filter(Boolean));
+    }
+    return out;
+}
+function dedupeStrings(items) {
+    return [...new Set(items)];
+}
+/** Build fast-glob ignore globs for trees rooted under `appRootAbs`. */
+function backendDiscoveryIgnorePatterns(appRootAbs, excludeRelativeDirs) {
+    const patterns = [];
+    for (const raw of excludeRelativeDirs) {
+        const trimmed = raw.trim();
+        if (!trimmed)
+            continue;
+        const resolved = path_1.default.resolve(appRootAbs, trimmed);
+        const rel = path_1.default.relative(appRootAbs, resolved);
+        const relPosix = rel.replace(/\\/g, '/');
+        if (!relPosix || relPosix.startsWith('..') || path_1.default.isAbsolute(rel)) {
+            console.warn(`Flight: exclude_paths entry skipped (outside app_home): ${trimmed}`);
+            continue;
+        }
+        patterns.push(`${relPosix}/**`);
+    }
+    return patterns;
+}
 const _yargs = require('yargs/yargs');
-const yargsFactory = typeof _yargs === 'function' ? _yargs : _yargs.default;
-const argv = yargsFactory(process.argv.slice(2)).argv;
+const yargsEntry = typeof _yargs === 'function' ? _yargs : _yargs.default;
+const argv = yargsEntry(process.argv.slice(2))
+    .option('exclude_paths', {
+    alias: 'exclude-paths',
+    type: 'array',
+    string: true,
+    default: [],
+    describe: 'Directories under app_home to skip when discovering **/*.backend.ts (repeat flag or comma-separated)'
+})
+    .parseSync();
 // Set default session duration (24 hours in milliseconds)
 const DEFAULT_SESSION_DURATION = 86400000; // 24 hours in milliseconds
 // Get session duration from environment variable or command line argument
@@ -65,8 +110,16 @@ if (argv.disable_vite === undefined) {
 // Ensure the value is a boolean
 argv.disable_vite = Boolean(argv.disable_vite);
 const appHomePath = path_1.default.resolve(argv.app_home);
+const excludePathsConfigured = dedupeStrings([
+    ...normalizeExcludePaths(argv.exclude_paths),
+    ...normalizeExcludePaths(process.env.FLIGHT_EXCLUDE_PATHS)
+]);
+const backendDiscoveryIgnores = backendDiscoveryIgnorePatterns(appHomePath, excludePathsConfigured);
 process.chdir(appHomePath);
 console.log(appHomePath);
+if (backendDiscoveryIgnores.length > 0) {
+    console.log('Flight: excluding **/*.backend.ts discovery under:', backendDiscoveryIgnores.map((g) => g.replace(/\*\*$/, '')).join(', '));
+}
 const mode = process.env.FLIGHT_MODE || argv.mode || 'production';
 /** Prefix without breaking printf-style logs (koa-logger uses `%s` as the first argument). */
 const flightModeLabel = `Flight (${mode}):`;
@@ -115,7 +168,9 @@ else {
     app.use((0, cors_1.default)()).use((0, koa_bodyparser_1.default)({
         jsonLimit: argv.payload_limit
     }));
-    const backEndFiles = fast_glob_1.default.sync('**/*.backend.ts');
+    const backEndFiles = fast_glob_1.default.sync('**/*.backend.ts', {
+        ignore: backendDiscoveryIgnores
+    });
     backEndFiles.forEach((file) => {
         const serverRoutes = require(path_1.default.resolve(file));
         console.log('Found component backend file: ' + path_1.default.resolve(file));

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@thoughtpivot/flight",
-    "version": "1.0.8",
+    "version": "1.1.0",
     "description": "A web server designed for running full stack, component based applications at enterprise scale.",
     "main": "src/flight.ts",
     "publishConfig": {

package/src/flight.ts

@@ -29,13 +29,65 @@ interface FlightArgv {
     payload_limit?: string
     disable_vite?: boolean
     mode?: string
+    exclude_paths?: string[]
+}
+
+function normalizeExcludePaths(value: unknown): string[] {
+    if (value == null || value === '') return []
+    const parts = Array.isArray(value) ? value : [value]
+    const out: string[] = []
+    for (const p of parts) {
+        const s = String(p).trim()
+        if (!s) continue
+        out.push(
+            ...s
+                .split(',')
+                .map((x) => x.trim())
+                .filter(Boolean)
+        )
+    }
+    return out
+}
+
+function dedupeStrings(items: string[]): string[] {
+    return [...new Set(items)]
+}
+
+/** Build fast-glob ignore globs for trees rooted under `appRootAbs`. */
+function backendDiscoveryIgnorePatterns(appRootAbs: string, excludeRelativeDirs: string[]): string[] {
+    const patterns: string[] = []
+    for (const raw of excludeRelativeDirs) {
+        const trimmed = raw.trim()
+        if (!trimmed) continue
+        const resolved = path.resolve(appRootAbs, trimmed)
+        const rel = path.relative(appRootAbs, resolved)
+        const relPosix = rel.replace(/\\/g, '/')
+        if (!relPosix || relPosix.startsWith('..') || path.isAbsolute(rel)) {
+            console.warn(`Flight: exclude_paths entry skipped (outside app_home): ${trimmed}`)
+            continue
+        }
+        patterns.push(`${relPosix}/**`)
+    }
+    return patterns
 }
 
 // tsx (and similar loaders) may expose require('yargs/yargs') as { default: factory } instead of factory.
-type YargsFactoryFn = (args: string[]) => { argv: FlightArgv }
-const _yargs = require('yargs/yargs') as YargsFactoryFn | { default: YargsFactoryFn }
-const yargsFactory: YargsFactoryFn = typeof _yargs === 'function' ? _yargs : _yargs.default
-const argv = yargsFactory(process.argv.slice(2)).argv
+interface YargsInstance {
+    option(key: string, opts: Record<string, unknown>): YargsInstance
+    parseSync(): FlightArgv
+}
+type YargsFn = (args: string[]) => YargsInstance
+const _yargs = require('yargs/yargs') as YargsFn | { default: YargsFn }
+const yargsEntry: YargsFn = typeof _yargs === 'function' ? _yargs : _yargs.default
+const argv = yargsEntry(process.argv.slice(2))
+    .option('exclude_paths', {
+        alias: 'exclude-paths',
+        type: 'array',
+        string: true,
+        default: [],
+        describe: 'Directories under app_home to skip when discovering **/*.backend.ts (repeat flag or comma-separated)'
+    })
+    .parseSync() as FlightArgv
 
 // Set default session duration (24 hours in milliseconds)
 const DEFAULT_SESSION_DURATION = 86400000 // 24 hours in milliseconds
@@ -90,9 +142,21 @@ if (argv.disable_vite === undefined) {
 argv.disable_vite = Boolean(argv.disable_vite)
 
 const appHomePath = path.resolve(argv.app_home)
+const excludePathsConfigured = dedupeStrings([
+    ...normalizeExcludePaths(argv.exclude_paths),
+    ...normalizeExcludePaths(process.env.FLIGHT_EXCLUDE_PATHS)
+])
+const backendDiscoveryIgnores = backendDiscoveryIgnorePatterns(appHomePath, excludePathsConfigured)
+
 process.chdir(appHomePath)
 
 console.log(appHomePath)
+if (backendDiscoveryIgnores.length > 0) {
+    console.log(
+        'Flight: excluding **/*.backend.ts discovery under:',
+        backendDiscoveryIgnores.map((g) => g.replace(/\*\*$/, '')).join(', ')
+    )
+}
 
 const mode = process.env.FLIGHT_MODE || argv.mode || 'production'
 
@@ -152,7 +216,9 @@ if (cluster.isPrimary) {
         })
     )
 
-    const backEndFiles = fg.sync('**/*.backend.ts')
+    const backEndFiles = fg.sync('**/*.backend.ts', {
+        ignore: backendDiscoveryIgnores
+    })
     backEndFiles.forEach((file) => {
         const serverRoutes = require(path.resolve(file))