@nu-art/build-and-install 0.401.9 → 0.500.6

package/BuildAndInstall.d.ts

@@ -1,10 +1,10 @@
 import { Logger } from '@nu-art/ts-common';
 import { BaiParams } from './core/params.js';
-import { Phase } from './phases/definitions/index.js';
+import type { Phase } from './phases/definitions/types.js';
 import { UnitsMapper } from './units/discovery/UnitsMapper.js';
 import { ProjectUnit } from './units/base/ProjectUnit.js';
 import { PhaseManager } from './phases/PhaseManager.js';
-import { Unit_NodeProject } from './units/index.js';
+import { Unit_NodeProject } from './units/implementations/Unit_NodeProject.js';
 import { Workspace } from './workspace/Workspace.js';
 import { BaseCliParam } from '@nu-art/cli-params';
 import { RunningStatusHandler } from './runtime/RunningStatusHandler.js';

package/BuildAndInstall.js

@@ -1,6 +1,7 @@
 import { BeLogged, DebugFlag, filterDuplicates, ImplementationMissingException, LogClient_Terminal, Logger, LogLevel, merge } from '@nu-art/ts-common';
 import { AllBaiParams } from './core/params.js';
-import { phases_Build, phases_Deploy, phases_Launch, phases_Terminating } from './phases/definitions/index.js';
+import { phase_Help, Unit_HelpPrinter } from './core/Unit_HelpPrinter.js';
+import { phases_Build, phases_Deploy, phases_Launch, phases_Terminating } from './phases/definitions/consts.js';
 import { UnitsMapper } from './units/discovery/UnitsMapper.js';
 import { FilesCache } from './core/FilesCache.js';
 import { ProjectUnit } from './units/base/ProjectUnit.js';
@@ -8,11 +9,16 @@ import { PhaseManager } from './phases/PhaseManager.js';
 import { Workspace } from './workspace/Workspace.js';
 import { resolve } from 'path';
 import { CONST_BaiConfig, CONST_NodeModules, CONST_VersionApp } from './config/consts.js';
-import { UnitMapper_FirebaseFunction, UnitMapper_FirebaseHosting, UnitMapper_NodeLib, UnitMapper_NodeProject } from './units/discovery/resolvers/index.js';
+import { UnitMapper_FirebaseFunction } from './units/discovery/resolvers/UnitMapper_FirebaseFunction.js';
+import { UnitMapper_FirebaseHosting } from './units/discovery/resolvers/UnitMapper_FirebaseHosting.js';
+import { UnitMapper_NodeLib } from './units/discovery/resolvers/UnitMapper_NodeLib.js';
+import { UnitMapper_NodeProject } from './units/discovery/resolvers/UnitMapper_NodeProject.js';
+import { UnitMapper_ViteHosting } from './units/discovery/resolvers/UnitMapper_ViteHosting.js';
 import { CLIParamsResolver } from '@nu-art/cli-params';
 import { RunningStatusHandler } from './runtime/RunningStatusHandler.js';
 import { FileSystemUtils } from '@nu-art/ts-common/utils/FileSystemUtils';
 export const DefaultPhases = [
+    [phase_Help],
     ...phases_Build,
     ...phases_Terminating,
     ...phases_Launch,
@@ -60,6 +66,7 @@ export class BuildAndInstall extends Logger {
             .addRules(UnitMapper_NodeLib)
             .addRules(UnitMapper_NodeProject)
             .addRules(UnitMapper_FirebaseHosting)
+            .addRules(UnitMapper_ViteHosting)
             .addRules(UnitMapper_FirebaseFunction)
             .setRuntimeParams(this.runtimeParams);
     }
@@ -99,6 +106,7 @@ export class BuildAndInstall extends Logger {
     }
     async build() {
         await this.init();
+        this.workspace.addProjectUnits([Unit_HelpPrinter]);
         // Scan units from workspace
         await this.workspace.scanUnits(this.pathToProject, this.unitsMapper);
         const nodeProjectUnit = this.workspace.getNodeProjectUnit();

package/config/consts.d.ts

@@ -1,8 +1,8 @@
 /**
  * Constants for file names and configuration keys used throughout the build system.
  */
-import { MemKey } from '@nu-art/ts-common/mem-storage/index';
-import { RuntimeProjectConfig } from './types/index.js';
+import { MemKey } from '@nu-art/ts-common/mem-storage';
+import { RuntimeProjectConfig } from './types/project-config.js';
 /** Version file name (version-app.json) */
 export declare const CONST_VersionApp = "version-app.json";
 /** Package.json template file name (__package.json) */

package/config/consts.js

@@ -1,7 +1,7 @@
 /**
  * Constants for file names and configuration keys used throughout the build system.
  */
-import { MemKey } from '@nu-art/ts-common/mem-storage/index';
+import { MemKey } from '@nu-art/ts-common/mem-storage';
 /** Version file name (version-app.json) */
 export const CONST_VersionApp = 'version-app.json';
 /** Package.json template file name (__package.json) */

package/config/package/consts.d.ts

@@ -1,4 +1,4 @@
-import { FirebasePackageConfig } from '../types/index.js';
+import { FirebasePackageConfig } from '../types/package/package.js';
 export type DefaultType_ProjectEnvs = 'local' | 'dev' | 'staging' | 'prod';
 export declare const Default_ProjectEnvs: ("local" | "staging" | "dev" | "prod")[];
 export declare const Default_FunctionsIgnoreFiles: string[];

package/config/types/package/runtime-package.d.ts

@@ -1,4 +1,4 @@
-import { PackageJson } from '../configs/index.js';
+import { PackageJson } from '../configs/package-json.js';
 import { Package, Package_Sourceless } from './package.js';
 type WithPackageJson = {
     packageJsonTemplate: PackageJson;

package/config/types/project-config.d.ts

@@ -1,5 +1,6 @@
 import { StringMap, TypedMap } from '@nu-art/ts-common';
-import { Package, RuntimePackage } from './package/index.js';
+import type { Package } from './package/package.js';
+import type { RuntimePackage } from './package/runtime-package.js';
 export type ProjectConfig = {
     params: StringMap;
     packages: Package[];
@@ -28,6 +29,20 @@ export type BAI_Config = {
                 'firebase.json'?: string;
                 '.firebaserc'?: string;
                 baseEmulationPort?: number;
+                mongoPort?: number;
+            };
+            playwright?: {
+                browsers?: ('chromium' | 'firefox' | 'webkit')[];
+                headless?: boolean;
+                baseURL?: string;
+                viewport?: {
+                    width: number;
+                    height: number;
+                };
+                vite?: {
+                    port?: number;
+                    configPath?: string;
+                };
             };
         };
         firebase?: {
@@ -41,7 +56,7 @@ export type BAI_Config = {
             eslintConfig?: string;
         };
         backend: {
-            proxy: string;
+            proxy: string | null;
         };
     };
 };

package/core/FilesCache.d.ts

@@ -16,11 +16,15 @@
  */
 export declare const FilesCache: {
     /**
-     * Clears the file cache.
+     * Clears the entire file cache.
      *
      * Useful for tests or when files may have changed.
      */
     clear: () => {};
+    /**
+     * Invalidates a single cached entry so the next load re-reads from disk.
+     */
+    invalidate: (path: string) => void;
     load: {
         /**
          * Loads and caches a JSON file.

package/core/FilesCache.js

@@ -32,11 +32,15 @@ const readFile = async (path) => {
  */
 export const FilesCache = {
     /**
-     * Clears the file cache.
+     * Clears the entire file cache.
      *
      * Useful for tests or when files may have changed.
      */
     clear: () => cachedFiles = {},
+    /**
+     * Invalidates a single cached entry so the next load re-reads from disk.
+     */
+    invalidate: (path) => { delete cachedFiles[path]; },
     load: {
         /**
          * Loads and caches a JSON file.

package/core/Unit_HelpPrinter.d.ts

@@ -1,10 +1,8 @@
-import { BaseCliParam, CliParams } from '@nu-art/cli-params';
+import { BaiParam_Help } from './params.js';
 import { UnitPhaseImplementor } from './types.js';
-import { Phase } from '../phases/definitions/index.js';
-import { ProjectUnit } from '../units/index.js';
-export declare const BaiParam_Help: BaseCliParam<'help', boolean>;
-declare const AllBaiParams_Help: (BaseCliParam<"allUnits", boolean> | BaseCliParam<"dependencyTree", boolean> | BaseCliParam<"environment", string> | BaseCliParam<"install", boolean> | BaseCliParam<"clean", boolean> | BaseCliParam<"purge", boolean> | BaseCliParam<"generate", boolean> | BaseCliParam<"generateDocs", boolean> | BaseCliParam<"noBuild", boolean> | BaseCliParam<"prepare", boolean> | BaseCliParam<"dryRun", boolean> | BaseCliParam<"lint", boolean> | BaseCliParam<"watch", boolean> | BaseCliParam<"watchBuildTree", boolean> | BaseCliParam<"continue", boolean> | BaseCliParam<"test", boolean> | BaseCliParam<"testType", string[]> | BaseCliParam<"testFiles", string[]> | BaseCliParam<"testCases", string[]> | BaseCliParam<"testDebugPort", number> | BaseCliParam<"launch", boolean> | BaseCliParam<"debugBackend", boolean> | BaseCliParam<"deploy", boolean> | BaseCliParam<"buildPushImage", string> | BaseCliParam<"deployImage", string> | BaseCliParam<"deployFunction", string> | BaseCliParam<"deleteFunctions", boolean> | BaseCliParam<"deleteFunction", string> | BaseCliParam<"debug", boolean> | BaseCliParam<"debugLifecycle", boolean> | BaseCliParam<"verbose", boolean> | BaseCliParam<"publish", "patch" | "minor" | "major"> | BaseCliParam<"usePackage", string[]> | BaseCliParam<"buildTree", boolean> | BaseCliParam<"includeApps", string[]> | BaseCliParam<"toESM", boolean> | BaseCliParam<"simulation", boolean> | BaseCliParam<"checkCyclicImports", boolean> | BaseCliParam<"extractDynamicDeps", boolean> | BaseCliParam<"mapExports", boolean> | BaseCliParam<"indicesMcpServer", boolean> | BaseCliParam<"indicesMcpPort", number> | BaseCliParam<"help", boolean>)[];
-export type Help_BaiParams = CliParams<typeof AllBaiParams_Help>;
+import type { Phase } from '../phases/definitions/types.js';
+import { ProjectUnit } from '../units/base/ProjectUnit.js';
+export { BaiParam_Help };
 export type Phase_Help = typeof phase_Help;
 export declare const phaseKey_Help = "help";
 export declare const phase_Help: Phase<'printHelp'>;
@@ -13,4 +11,3 @@ declare class _Unit_HelpPrinter extends ProjectUnit implements UnitPhaseImplemen
     printHelp(): Promise<void>;
 }
 export declare const Unit_HelpPrinter: _Unit_HelpPrinter;
-export {};

package/core/Unit_HelpPrinter.js

@@ -1,15 +1,7 @@
 import { _keys, LogLevel, reduceToMap } from '@nu-art/ts-common';
-import { AllBaiParams, BaiParam_AllUnits, BaiParam_NoBuild, BaiParam_Prepare } from './params.js';
-import { ProjectUnit } from '../units/index.js';
-export const BaiParam_Help = {
-    keys: ['--help', '-h'],
-    keyName: 'help',
-    type: 'boolean',
-    group: 'General',
-    description: 'This help menu',
-    dependencies: [{ param: BaiParam_NoBuild, value: true }, { param: BaiParam_Prepare, value: false }, { param: BaiParam_AllUnits, value: true }],
-};
-const AllBaiParams_Help = [...AllBaiParams, BaiParam_Help];
+import { AllBaiParams, BaiParam_Help } from './params.js';
+import { ProjectUnit } from '../units/base/ProjectUnit.js';
+export { BaiParam_Help };
 export const phaseKey_Help = 'help';
 export const phase_Help = {
     key: phaseKey_Help,

package/core/params.d.ts

@@ -45,6 +45,7 @@ export declare const BaiParam_ExtractDynamicDeps: BaseCliParam<'extractDynamicDe
 export declare const BaiParam_MapExports: BaseCliParam<'mapExports', boolean>;
 export declare const BaiParam_IndicesMcpServer: BaseCliParam<'indicesMcpServer', boolean>;
 export declare const BaiParam_IndicesMcpPort: BaseCliParam<'indicesMcpPort', number>;
-export declare const AllBaiParams: (BaseCliParam<"allUnits", boolean> | BaseCliParam<"dependencyTree", boolean> | BaseCliParam<"environment", string> | BaseCliParam<"install", boolean> | BaseCliParam<"clean", boolean> | BaseCliParam<"purge", boolean> | BaseCliParam<"generate", boolean> | BaseCliParam<"generateDocs", boolean> | BaseCliParam<"noBuild", boolean> | BaseCliParam<"prepare", boolean> | BaseCliParam<"dryRun", boolean> | BaseCliParam<"lint", boolean> | BaseCliParam<"watch", boolean> | BaseCliParam<"watchBuildTree", boolean> | BaseCliParam<"continue", boolean> | BaseCliParam<"test", boolean> | BaseCliParam<"testType", string[]> | BaseCliParam<"testFiles", string[]> | BaseCliParam<"testCases", string[]> | BaseCliParam<"testDebugPort", number> | BaseCliParam<"launch", boolean> | BaseCliParam<"debugBackend", boolean> | BaseCliParam<"deploy", boolean> | BaseCliParam<"buildPushImage", string> | BaseCliParam<"deployImage", string> | BaseCliParam<"deployFunction", string> | BaseCliParam<"deleteFunctions", boolean> | BaseCliParam<"deleteFunction", string> | BaseCliParam<"debug", boolean> | BaseCliParam<"debugLifecycle", boolean> | BaseCliParam<"verbose", boolean> | BaseCliParam<"publish", PromoteType> | BaseCliParam<"usePackage", string[]> | BaseCliParam<"buildTree", boolean> | BaseCliParam<"includeApps", string[]> | BaseCliParam<"toESM", boolean> | BaseCliParam<"simulation", boolean> | BaseCliParam<"checkCyclicImports", boolean> | BaseCliParam<"extractDynamicDeps", boolean> | BaseCliParam<"mapExports", boolean> | BaseCliParam<"indicesMcpServer", boolean> | BaseCliParam<"indicesMcpPort", number>)[];
+export declare const BaiParam_Help: BaseCliParam<'help', boolean>;
+export declare const AllBaiParams: (BaseCliParam<"allUnits", boolean> | BaseCliParam<"dependencyTree", boolean> | BaseCliParam<"environment", string> | BaseCliParam<"install", boolean> | BaseCliParam<"clean", boolean> | BaseCliParam<"purge", boolean> | BaseCliParam<"generate", boolean> | BaseCliParam<"generateDocs", boolean> | BaseCliParam<"noBuild", boolean> | BaseCliParam<"prepare", boolean> | BaseCliParam<"dryRun", boolean> | BaseCliParam<"lint", boolean> | BaseCliParam<"watch", boolean> | BaseCliParam<"watchBuildTree", boolean> | BaseCliParam<"continue", boolean> | BaseCliParam<"test", boolean> | BaseCliParam<"testType", string[]> | BaseCliParam<"testFiles", string[]> | BaseCliParam<"testCases", string[]> | BaseCliParam<"testDebugPort", number> | BaseCliParam<"launch", boolean> | BaseCliParam<"debugBackend", boolean> | BaseCliParam<"deploy", boolean> | BaseCliParam<"buildPushImage", string> | BaseCliParam<"deployImage", string> | BaseCliParam<"deployFunction", string> | BaseCliParam<"deleteFunctions", boolean> | BaseCliParam<"deleteFunction", string> | BaseCliParam<"debug", boolean> | BaseCliParam<"debugLifecycle", boolean> | BaseCliParam<"verbose", boolean> | BaseCliParam<"publish", PromoteType> | BaseCliParam<"usePackage", string[]> | BaseCliParam<"buildTree", boolean> | BaseCliParam<"includeApps", string[]> | BaseCliParam<"toESM", boolean> | BaseCliParam<"simulation", boolean> | BaseCliParam<"checkCyclicImports", boolean> | BaseCliParam<"extractDynamicDeps", boolean> | BaseCliParam<"mapExports", boolean> | BaseCliParam<"indicesMcpServer", boolean> | BaseCliParam<"indicesMcpPort", number> | BaseCliParam<"help", boolean>)[];
 export type BaiParams = CliParams<typeof AllBaiParams>;
 export {};

package/core/params.js

@@ -117,7 +117,7 @@ export const BaiParam_Test = {
     group: 'Test',
     description: 'Run the tests in all the project packages',
 };
-export const TestTypes = ['pure', 'firebase', 'ui', 'mobile'];
+export const TestTypes = ['pure', 'firebase', 'ui', 'mobile', 'playwright'];
 export const BaiParam_TestType = {
     keys: ['--test-type', '-tt'],
     keyName: 'testType',
@@ -296,7 +296,7 @@ export const BaiParam_Publish = {
     process: (part) => part ?? 'patch'
 };
 export const BaiParam_UsePackage = {
-    keys: ['-up', '--use-packages'],
+    keys: ['-up', '--use-package'],
     keyName: 'usePackage',
     type: 'string[]',
     group: 'Other',
@@ -395,6 +395,14 @@ export const BaiParam_IndicesMcpPort = {
     description: 'Port for Export Indices MCP server (default: 3001)',
     dependencies: [{ param: BaiParam_IndicesMcpServer, value: true }]
 };
+export const BaiParam_Help = {
+    keys: ['--help', '-h'],
+    keyName: 'help',
+    type: 'boolean',
+    group: 'General',
+    description: 'This help menu',
+    dependencies: [{ param: BaiParam_NoBuild, value: true }, { param: BaiParam_Prepare, value: false }, { param: BaiParam_AllUnits, value: true }],
+};
 export const AllBaiParams = [
     BaiParam_AllUnits,
     BaiParam_DependencyTree,
@@ -437,5 +445,6 @@ export const AllBaiParams = [
     BaiParam_MapExports,
     BaiParam_IndicesMcpServer,
     BaiParam_IndicesMcpPort,
-    BaiParam_DebugLifecycle
+    BaiParam_DebugLifecycle,
+    BaiParam_Help,
 ];

package/core/types.d.ts

@@ -1,6 +1,6 @@
 import { AsyncVoidFunction } from '@nu-art/ts-common';
-import { BaseUnit } from '../units/index.js';
-import { Phase } from '../phases/definitions/index.js';
+import { BaseUnit } from '../units/base/BaseUnit.js';
+import type { Phase } from '../phases/definitions/types.js';
 export type Unit<P extends Phase<string>[]> = BaseUnit & UnitPhaseImplementor<P>;
 export type UnitPhaseImplementor<P extends Phase<string>[]> = {
     [K in P[number]['method']]: AsyncVoidFunction;

package/dependencies/UnitsDependencyMapper.d.ts

@@ -69,4 +69,12 @@ export declare class UnitsDependencyMapper extends Logger {
      * Returns all leaf units (those with no dependencies).
      */
     getLeaves(): string[];
+    /**
+     * Detects cycles in a given dependency map (used for error reporting).
+     */
+    private detectCyclesInMap;
+    /**
+     * Formats the dependency graph as a readable string for error messages.
+     */
+    private formatDependencyGraph;
 }

package/dependencies/UnitsDependencyMapper.js

@@ -99,10 +99,23 @@ export class UnitsDependencyMapper extends Logger {
                 }
             }
             if (nextLayer.length === 0) {
-                this.logWarning(participatingKeys);
-                this.logWarning(map);
-                this.logWarning(`Cyclic or disconnected dependency detected: ${lastNode?.key ?? '??'} and [${nextLayer.join(', ')}]`);
-                throw new Error('Cyclic or disconnected dependency detected');
+                // Detect and report cycles explicitly
+                const cycles = this.detectCyclesInMap(map);
+                const unresolved = _keys(map).filter(key => !resolved.has(key) && !topLayer.includes(key));
+                let errorMessage = '';
+                errorMessage += `Last processed node: ${lastNode?.key ?? '??'}\n`;
+                errorMessage += `Unresolved nodes: [${unresolved.join(', ')}]\n`;
+                errorMessage += 'Cyclic or disconnected dependency detected!\n\n';
+                if (cycles.length > 0) {
+                    errorMessage += `Found ${cycles.length} cycle(s):\n`;
+                    for (const cycle of cycles) {
+                        errorMessage += `  Cycle: ${cycle.join(' -> ')}\n`;
+                    }
+                    errorMessage += '\n';
+                }
+                this.logVerbose(`Full dependency graph:`, this.formatDependencyGraph(map));
+                this.logWarning(errorMessage);
+                throw new Error(errorMessage);
             }
             nextLayer.sort();
             layers.push(sortArray(nextLayer));
@@ -306,4 +319,45 @@ export class UnitsDependencyMapper extends Logger {
     getLeaves() {
         return _values(this.map).filter(node => node.dependsOn.length === 0).map(node => node.key).sort();
     }
+    /**
+     * Detects cycles in a given dependency map (used for error reporting).
+     */
+    detectCyclesInMap(map) {
+        const visited = new Set();
+        const inStack = new Set();
+        const cycles = [];
+        const visit = (key, path) => {
+            if (inStack.has(key)) {
+                const cycleStart = path.indexOf(key);
+                cycles.push(path.slice(cycleStart).concat(key));
+                return;
+            }
+            if (visited.has(key))
+                return;
+            visited.add(key);
+            inStack.add(key);
+            const node = map[key];
+            if (node)
+                for (const dep of node.dependsOn)
+                    visit(dep, path.concat(key));
+            inStack.delete(key);
+        };
+        for (const key of _keys(map))
+            visit(key, []);
+        return cycles;
+    }
+    /**
+     * Formats the dependency graph as a readable string for error messages.
+     */
+    formatDependencyGraph(map) {
+        const lines = [];
+        for (const key of _keys(map)) {
+            const node = map[key];
+            const deps = node.dependsOn.length > 0
+                ? ` -> [${node.dependsOn.join(', ')}]`
+                : ' (no dependencies)';
+            lines.push(`  ${key}${deps}`);
+        }
+        return lines.join('\n');
+    }
 }

package/exceptions/UnitPhaseException.d.ts

@@ -1,5 +1,5 @@
 import { CustomException } from '@nu-art/ts-common';
-import { BaseUnit } from '../units/index.js';
+import { BaseUnit } from '../units/base/BaseUnit.js';
 /**
  * Exception thrown when a specific phase fails on a specific unit.
  *

package/exports/IndicesMcpServer.js

@@ -201,7 +201,7 @@ export class IndicesMcpServer extends Logger {
                 package: packageName,
                 stale,
                 message: stale
-                    ? "Source files are newer than index files. Run 'bai --map-exports' to regenerate."
+                    ? 'Source files are newer than index files. Run \'bai --map-exports\' to regenerate.'
                     : 'Indices are up to date.'
             });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nu-art/build-and-install",
-  "version": "0.401.9",
+  "version": "0.500.6",
   "description": "A build system for monorepos that orchestrates building, testing, and deploying units with dependency-aware phase execution",
   "type": "module",
   "keywords": [
@@ -39,12 +39,12 @@
   },
   "dependencies": {
     "chokidar": "^3.6.0",
-    "@nu-art/cli-params": "0.401.9",
-    "@nu-art/ts-common": "0.401.9",
-    "@nu-art/commando": "0.401.9"
+    "@nu-art/cli-params": "0.500.6",
+    "@nu-art/ts-common": "0.500.6",
+    "@nu-art/commando": "0.500.6"
   },
   "devDependencies": {
-    "@nu-art/testalot": "0.401.9"
+    "@nu-art/testalot": "0.500.6"
   },
   "unitConfig": {
     "type": "typescript-lib"

package/phases/PhaseManager.d.ts

@@ -1,7 +1,7 @@
 import { Logger } from '@nu-art/ts-common';
 import { RunningStatusHandler } from '../runtime/RunningStatusHandler.js';
-import { Phase } from './definitions/index.js';
-import { BaseUnit } from '../units/index.js';
+import type { Phase } from './definitions/types.js';
+import { BaseUnit } from '../units/base/BaseUnit.js';
 /**
  * Scheduled execution step (before mapping to actual phases/units).
  */

package/phases/PhaseManager.js

@@ -99,8 +99,8 @@ export class PhaseManager extends Logger {
                 // A unit is eligible if it's eligible for at least one phase in the group
                 const eligibleUnitKeys = new Set();
                 for (const phase of phaseGroup) {
-                    const unitCategory = phase.unitCategory ?? "active";
-                    const phaseEligibleKeys = unitCategory === "project" ? this.projectUnitKeys : this.activeUnits;
+                    const unitCategory = phase.unitCategory ?? 'active';
+                    const phaseEligibleKeys = unitCategory === 'project' ? this.projectUnitKeys : this.activeUnits;
                     phaseEligibleKeys.forEach(key => eligibleUnitKeys.add(key));
                 }
                 const layerUnits = layer.filter(u => eligibleUnitKeys.has(u.config.key));
@@ -113,8 +113,8 @@ export class PhaseManager extends Logger {
                         if (!(phase.method in unit && typeof unit[phase.method] === 'function'))
                             return false;
                         // Check if unit is eligible for this specific phase
-                        const unitCategory = phase.unitCategory ?? "active";
-                        const phaseEligibleKeys = unitCategory === "project" ? this.projectUnitKeys : this.activeUnits;
+                        const unitCategory = phase.unitCategory ?? 'active';
+                        const phaseEligibleKeys = unitCategory === 'project' ? this.projectUnitKeys : this.activeUnits;
                         return phaseEligibleKeys.includes(unit.config.key);
                     });
                     if (supportedPhases.length === 0)

package/phases/definitions/consts.d.ts

@@ -57,6 +57,9 @@ export declare const phase_Compile: Phase<'compile'>;
 export type Phase_PrepareWatch = typeof phase_PrepareWatch;
 export declare const phaseKey_PrepareWatch = "watchPrepare";
 export declare const phase_PrepareWatch: Phase<'watchPrepare'>;
+export type Phase_InstallWatch = typeof phase_InstallWatch;
+export declare const phaseKey_InstallWatch = "watchInstall";
+export declare const phase_InstallWatch: Phase<'watchInstall'>;
 export type Phase_CompileWatch = typeof phase_CompileWatch;
 export declare const phaseKey_CompileWatch = "watchCompile";
 export declare const phase_CompileWatch: Phase<'watchCompile'>;

package/phases/definitions/consts.js

@@ -92,6 +92,13 @@ export const phase_PrepareWatch = {
     filter: (baiParams) => baiParams.prepare,
     unitCategory: 'project', // All project units need to be prepared
 };
+export const phaseKey_InstallWatch = 'watchInstall';
+export const phase_InstallWatch = {
+    key: phaseKey_InstallWatch,
+    name: 'Install Watch',
+    method: 'watchInstall',
+    dependencyPhase: [phase_PrepareWatch],
+};
 export const phaseKey_CompileWatch = 'watchCompile';
 export const phase_CompileWatch = {
     key: phaseKey_CompileWatch,

package/phases/definitions/types.d.ts

@@ -36,5 +36,5 @@ export type Phase<PhaseMethod extends string> = {
     /** Phases that must complete before this phase runs */
     dependencyPhase?: Phase<string>[];
     /** Unit category: 'project' = all project units (active + dependencies), 'active' = only active units (default) */
-    unitCategory?: "project" | "active";
+    unitCategory?: 'project' | 'active';
 };

package/templates/backend/proxy/proxy._ts

@@ -1,56 +1,61 @@
 import express from 'express';
-import request from 'request';
 import * as fs from 'fs';
+import {Readable} from 'node:stream';
+import {createServer} from 'node:https';
 
 
 const _express: express.Express = express();
 let _counter = 0;
-_express.all('*', (req, res) => {
+_express.all('*', async (req, res) => {
 	const counter = ++_counter;
 	const qMark = req.originalUrl.indexOf('?');
 	const query = qMark > 1 ? req.originalUrl.substring(qMark) : '';
 	const path = req.path;
-	let url = `http://127.0.0.1:SERVER_PORT/PROJECT_ID/us-central1/api${path}${query}`;
-	if (path.startsWith('/emulatorDownload') || path.startsWith('/emulatorUpload'))
-		url = `http://127.0.0.1:SERVER_PORT/PROJECT_ID/us-central1${path}${query}`;
-
+	let url = `http://127.0.0.1:{{SERVER_PORT}}/{{PROJECT_ID}}/us-central1/api${path}${query}`;
 	console.log(`PROXY ${counter} - [${req.method}] ${url}`);
 
-	const handleError = (error: any) => {
-	    if(!error)
-	        return;
+	try {
+		const headers: Record<string, string | string[] | undefined> = {...req.headers};
+		delete headers['host'];
+		delete headers['content-length'];
 
-		console.log(`ERROR calling: ${url}`, error);
-        res.status(503).end();
-	};
+		const fetchOptions: RequestInit = {
+			method: req.method,
+			headers: headers as HeadersInit
+		};
 
-	try {
-		let reqContent;
-		if (req.method === 'POST') {
-			reqContent = request.post({uri: url, body: req.body}, handleError);
-		} else if (req.method === 'PUT') {
-			reqContent = request.put({uri: url, body: req.body}, handleError);
-		} else if (req.method === 'GET') {
-			reqContent = request.get(url, handleError);
-		} else if (req.method === 'DELETE') {
-			reqContent = request.delete(url, handleError);
-		} else if (req.method === 'HEAD') {
-			reqContent = request.head(url, handleError);
+		// Stream request body for methods that can have a body (fetch forbids body on GET/HEAD)
+		if (req.method !== 'GET' && req.method !== 'HEAD') {
+			fetchOptions.body = Readable.toWeb(req) as any;
+			(fetchOptions as RequestInit & { duplex: 'half' }).duplex = 'half';
+		}
+
+		const response = await fetch(url, fetchOptions);
+
+		res.status(response.status);
+		// Don't forward content-encoding/content-length: fetch already decompressed the body
+		response.headers.forEach((value, key) => {
+			const k = key.toLowerCase();
+			if (k === 'content-encoding' || k === 'content-length') return;
+			res.setHeader(key, value);
+		});
+
+		if (response.body) {
+			Readable.fromWeb(response.body as Parameters<typeof Readable.fromWeb>[0]).pipe(res, {end: true});
 		} else {
-			reqContent = request(url, handleError);
+			res.end();
 		}
 
-		req.pipe(reqContent).pipe(res, {end: true});
 		console.log(`PROXY ${counter} - END`);
 	} catch (e) {
 		console.log(`ERROR calling: ${url}`, e);
-		res.status(500).end();
+		res.status(503).end();
 	}
 });
 
 const ssl = {
-	key: 'PATH_TO_SSL_KEY',
-	cert: 'PATH_TO_SSL_CERTIFICATE'
+	key: '{{PATH_TO_SSL_KEY}}',
+	cert: '{{PATH_TO_SSL_CERTIFICATE}}'
 };
 
 let key = ssl.key;
@@ -68,5 +73,5 @@ const options = {
 	requestCert: false,
 };
 
-require('https').createServer(options, _express).listen(PROXY_PORT);
-console.log('SSL proxy started!!!');
+createServer(options, _express).listen(+'{{PROXY_PORT}}');
+console.log(`SSL proxy started at port: {{PROXY_PORT}}`);

package/templates/firebase/config/database.rules.json

@@ -2,6 +2,12 @@
   "rules": {
     ".read": false,
     ".write": false,
+    "_config": {
+      "frontend": {
+        ".read": true,
+        ".write": false
+      }
+    },
     "state": {
       "ModuleBE_SyncManager": {
         "syncData": {

package/units/base/BaseUnit.d.ts

@@ -3,7 +3,7 @@ import { CommandoInteractive } from '@nu-art/commando';
 import { BaseCommando } from '@nu-art/commando';
 import { MergeTypes } from '@nu-art/commando';
 import { Commando_Basic } from '@nu-art/commando';
-import { BAI_Config } from '../../config/types/index.js';
+import { BAI_Config } from '../../config/types/project-config.js';
 import { UnitsDependencyMapper } from '../../dependencies/UnitsDependencyMapper.js';
 import { BaiParams } from '../../core/params.js';
 import { Workspace } from '../../workspace/Workspace.js';

package/units/discovery/UnitsMapper.d.ts

@@ -1,4 +1,5 @@
-import { BaseUnit, ProjectUnit } from '../index.js';
+import { BaseUnit } from '../base/BaseUnit.js';
+import { ProjectUnit } from '../base/ProjectUnit.js';
 import { Logger } from '@nu-art/ts-common';
 import { UnitMapper_Base } from './resolvers/UnitMapper_Base.js';
 import { BaiParams } from '../../core/params.js';
@@ -34,7 +35,7 @@ export declare class UnitsMapper extends Logger {
      * @param projectRoot - The path to the project root
      * @param units - The project units derived from the file system
      */
-    resolveUnits(path: string, projectRoot?: string, units?: BaseUnit<any>[]): Promise<BaseUnit<any, import("../index.js").UnitRuntimeContext>[]>;
+    resolveUnits(path: string, projectRoot?: string, units?: BaseUnit<any>[]): Promise<BaseUnit<any, import("../base/BaseUnit.js").UnitRuntimeContext>[]>;
     /**
      * Adds unit resolution rules.
      *

package/units/discovery/resolvers/UnitMapper_Base.d.ts

@@ -1,6 +1,6 @@
 import { AbsolutePath, Logger, RelativePath, StringMap, TypeValidator } from '@nu-art/ts-common';
-import { BaseUnit } from '../../index.js';
-import { BAI_Config } from '../../../config/types/index.js';
+import { BaseUnit } from '../../base/BaseUnit.js';
+import { BAI_Config } from '../../../config/types/project-config.js';
 import { BaiParams } from '../../../core/params.js';
 export type BaseUnitConfig = {
     fullPath: AbsolutePath;