@thoughtpivot/flight 1.0.7 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
 # Flight
 
-Flight is a modern, high-performance web application server built on Node.js, designed for building scalable, component-driven applications. It represents the evolution of the [Avian](https://github.com/ispyhumanfly/avian) component application server, incorporating modern best practices and improved developer experience.
+Flight is a modern, high-performance web application server built on Node.js, designed for building scalable, component-driven applications. It is the successor to [Avian](https://github.com/ispyhumanfly/avian): originally created by ThoughtPivot, handed to FlyPaper Technologies, LLC, where Avian matured—Flight builds on those advancements with modern tooling and developer experience.
 
 ## Overview
 
@@ -29,6 +29,10 @@ yarn add @thoughtpivot/flight
 
 Previously published on npm as `@spytech/flight`; switch your dependency to `@thoughtpivot/flight`.
 
+### Downstream apps (tsx / patch-package)
+
+From **v1.0.8** onward, Flight normalizes `require('yargs/yargs')` when loaders such as **tsx** expose it as `{ default: factory }` instead of the factory. If you only added **patch-package** for that workaround, upgrade `@thoughtpivot/flight`, delete `patches/@thoughtpivot+flight+*.patch`, and remove any **postinstall** hook that existed solely to apply it.
+
 ## Quick Start
 
 1. Create a new project directory and initialize:
@@ -93,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')
@@ -259,8 +264,10 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 
 ## Acknowledgments
 
-Flight is built upon the solid foundation laid by the [Avian](https://github.com/ispyhumanfly/avian) framework, created by FlyPaper Technologies, LLC. We're grateful for their pioneering work in component-driven architecture.
+Flight succeeds the [Avian](https://github.com/ispyhumanfly/avian) framework. Avian began at ThoughtPivot and was later handed to FlyPaper Technologies, LLC, where it grew into the platform many teams relied on. Flight is born from that lineage—the ideas and hardening FlyPaper contributed to Avian—carried forward as ThoughtPivot’s next-generation server.
+
+We’re grateful to FlyPaper Technologies for stewarding Avian and advancing component-driven architecture.
 
 ## ThoughtPivot
 
-Flight is a [ThoughtPivot](https://github.com/thoughtpivot) technology: developed and maintained as part of the ThoughtPivot organization and ecosystem.
+Today Flight is an official ThoughtPivot technology: developed and maintained by the [ThoughtPivot](https://github.com/thoughtpivot) organization as part of its ecosystem.

package/dist/flight.js

@@ -21,7 +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"));
-const argv = require('yargs/yargs')(process.argv.slice(2)).argv;
+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 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
@@ -63,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}):`;
@@ -113,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.7",
+    "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

@@ -19,7 +19,75 @@ import ratelimit from 'koa-ratelimit'
 import serve from 'koa-static'
 import session from 'koa-session'
 
-const argv = require('yargs/yargs')(process.argv.slice(2)).argv
+/** CLI argv shape after Flight applies defaults (see block below). */
+interface FlightArgv {
+    session_duration?: number
+    app_home?: string
+    app_key?: string
+    app_secret?: string
+    port?: number | string
+    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.
+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
@@ -74,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'
 
@@ -136,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))