depflow 1.0.0

package/build/File.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description Utility to help with File operations.
+ * @license Apache-2.0
+ */
+import Dependency from './Dependency.js';
+export declare class File {
+    /**
+     * Validates and transforms raw data into a DependencyDef object.
+     * @param data - The raw data to extract from.
+     * @returns A valid DependencyDef object.
+     */
+    private static extractDependency;
+    /**
+     * Reads and parses a dependency file.
+     * @param path - Path to the dependency file.
+     * @returns The parsed JSON content.
+     */
+    private static read;
+    /**
+     * Loads, validates, and compiles dependencies from a file.
+     * @param path - Path to the dependency file.
+     * @returns An array of valid DependencyDef objects.
+     */
+    static load(path: string): Promise<Dependency.Dependency[]>;
+    /**
+     * Saves an array of dependency definitions to a file.
+     * @param path - Path to the dependency file.
+     * @param dependencies - The dependencies to save.
+     */
+    static save(path: string, dependencies: any[]): Promise<void>;
+    /**
+     * Check if a file exists
+     * @param path Path to check
+     * @returns Promise<boolean>
+     */
+    static isFile(path: string): Promise<boolean>;
+    /**
+     * Check if a file or folder exists
+     * @param path Path to check
+     * @returns Promise<boolean>
+     */
+    static exists(path: string): Promise<boolean>;
+}
+export default File;

package/build/File.js

@@ -0,0 +1,113 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description Utility to help with File operations.
+ * @license Apache-2.0
+ */
+import { promises as FS } from 'fs';
+import Validator from './Validator.js';
+export class File {
+    /**
+     * Validates and transforms raw data into a DependencyDef object.
+     * @param data - The raw data to extract from.
+     * @returns A valid DependencyDef object.
+     */
+    static extractDependency(data) {
+        Validator.validateDependency(data);
+        return data;
+    }
+    /**
+     * Reads and parses a dependency file.
+     * @param path - Path to the dependency file.
+     * @returns The parsed JSON content.
+     */
+    static async read(path) {
+        try {
+            if (!await this.exists(path))
+                await FS.writeFile(path, '[]');
+            if (!await this.isFile(path))
+                throw new Error(`Dependency file at &C2${path}&R does not exist.`);
+            const content = await FS.readFile(path, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            throw new Error(`Failed to read or parse dependency file at &C2${path}&R.`, { cause: error });
+        }
+    }
+    /**
+     * Loads, validates, and compiles dependencies from a file.
+     * @param path - Path to the dependency file.
+     * @returns An array of valid DependencyDef objects.
+     */
+    static async load(path) {
+        try {
+            const data = await this.read(path);
+            if (!Array.isArray(data))
+                throw new Error('Dependency file content must be an array.');
+            const dependencies = [];
+            for (const item of data)
+                dependencies.push(this.extractDependency(item));
+            return dependencies;
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    /**
+     * Saves an array of dependency definitions to a file.
+     * @param path - Path to the dependency file.
+     * @param dependencies - The dependencies to save.
+     */
+    static async save(path, dependencies) {
+        try {
+            const validatedDeps = [];
+            const seenNames = new Set();
+            for (const item of dependencies) {
+                const dependency = this.extractDependency(item);
+                if (seenNames.has(dependency.name))
+                    throw new Error(`Duplicate dependency name found: "${dependency.name}".`);
+                seenNames.add(dependency.name);
+                validatedDeps.push(dependency);
+            }
+            try {
+                const content = JSON.stringify(validatedDeps, null, 4);
+                await FS.writeFile(path, content);
+            }
+            catch (error) {
+                throw new Error(`Failed to write dependency file at &C2${path}&R.`, { cause: error });
+            }
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    /**
+     * Check if a file exists
+     * @param path Path to check
+     * @returns Promise<boolean>
+     */
+    static async isFile(path) {
+        try {
+            const stats = await FS.stat(path);
+            return stats.isFile();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if a file or folder exists
+     * @param path Path to check
+     * @returns Promise<boolean>
+     */
+    static async exists(path) {
+        try {
+            await FS.access(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+export default File;
+//# sourceMappingURL=File.js.map

package/build/File.js.map

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

package/build/Git.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description Executes git commands.
+ * @license Apache-2.0
+ */
+declare class Git {
+    /**
+     * Executes a command and returns its output.
+     * @param command The command to execute.
+     * @returns A promise that resolves with the command's output.
+     */
+    private static exec;
+    /**
+     * Clones a repository.
+     * @param repo The repository URL.
+     * @param path The path to clone the repository to.
+     * @returns A promise that resolves when the command is finished.
+     * @throws Error if the command fails.
+     */
+    static clone(repo: string, path: string, branch?: string): Promise<string>;
+    /**
+     * Checks out a branch/tag.
+     * @param path The path to the repository.
+     * @param branch The branch/tag to checkout.
+     * @returns A promise that resolves when the command is finished.
+     */
+    static switch(path: string, branch: string): Promise<string>;
+    /**
+     * Pulls changes from a remote repository.
+     * @param path The path to the repository.
+     * @param branch The branch to pull from.
+     * @returns A promise that resolves when the command is finished.
+     */
+    static pull(path: string, branch?: string): Promise<string>;
+}
+export default Git;

package/build/Git.js

@@ -0,0 +1,68 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description Executes git commands.
+ * @license Apache-2.0
+ */
+import ChildProcess from 'child_process';
+class Git {
+    /**
+     * Executes a command and returns its output.
+     * @param command The command to execute.
+     * @returns A promise that resolves with the command's output.
+     */
+    static exec(command) {
+        return new Promise((resolve, reject) => {
+            const [cmd, ...args] = command.split(' ');
+            const process = ChildProcess.spawn(cmd, args, { shell: true });
+            let output = '';
+            let errorOutput = '';
+            process.stdout.on('data', (data) => output += data.toString());
+            process.stderr.on('data', (data) => errorOutput += data.toString());
+            process.on('error', (err) => reject(err));
+            process.on('close', (code) => {
+                if (code === 0) {
+                    const result = (output + errorOutput).trim();
+                    resolve(result);
+                }
+                else {
+                    const errorMessage = `Command failed with code ${code}: ${command}\n${errorOutput || output}`.trim();
+                    reject(new Error(errorMessage));
+                }
+            });
+        });
+    }
+    /**
+     * Clones a repository.
+     * @param repo The repository URL.
+     * @param path The path to clone the repository to.
+     * @returns A promise that resolves when the command is finished.
+     * @throws Error if the command fails.
+     */
+    static async clone(repo, path, branch) {
+        return this.exec(`git clone ${repo} ${path}${branch ? ` --branch ${branch}` : ''}`);
+    }
+    /**
+     * Checks out a branch/tag.
+     * @param path The path to the repository.
+     * @param branch The branch/tag to checkout.
+     * @returns A promise that resolves when the command is finished.
+     */
+    static async switch(path, branch) {
+        return this.exec(`git -C ${path} switch ${branch}`);
+    }
+    /**
+     * Pulls changes from a remote repository.
+     * @param path The path to the repository.
+     * @param branch The branch to pull from.
+     * @returns A promise that resolves when the command is finished.
+     */
+    static async pull(path, branch) {
+        const command = `git -C ${path} pull`;
+        if (branch)
+            return this.exec(`${command} --branch ${branch}`);
+        else
+            return this.exec(command);
+    }
+}
+export default Git;
+//# sourceMappingURL=Git.js.map

package/build/Git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Git.js","sourceRoot":"","sources":["../src/Git.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,YAAY,MAAM,eAAe,CAAC;AAEzC,MAAM,GAAG;IACL;;;;OAIG;IACK,MAAM,CAAC,IAAI,CAAC,OAAe;QAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnC,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAG,CAAC,CAAC;YAEhE,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,WAAW,GAAG,EAAE,CAAC;YAErB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1C,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACb,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC7C,OAAO,CAAC,MAAM,CAAC,CAAC;gBACpB,CAAC;qBAAM,CAAC;oBACJ,MAAM,YAAY,GAAG,4BAA4B,IAAI,KAAK,OAAO,KAAK,WAAW,IAAI,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;oBACrG,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;gBACpC,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;IACD;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,IAAY,EAAE,MAAe;QACjE,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,IAAI,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,MAAc;QACnD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,WAAW,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,MAAe;QAClD,MAAM,OAAO,GAAG,UAAU,IAAI,OAAO,CAAC;QACtC,IAAI,MAAM;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,aAAa,MAAM,EAAE,CAAC,CAAC;;YACzD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;CACJ;AAED,eAAe,GAAG,CAAC"}

package/build/PathFixer.d.ts

@@ -0,0 +1,35 @@
+export declare class PathFixer {
+    readonly info: PathFixer.ProjectInfo;
+    readonly projectRoot: string;
+    static readonly IMPORT_REGEX: RegExp;
+    static readonly DEFAULT_PROJECT_INFO: PathFixer.ProjectInfo;
+    static readonly PROJECT_ROOT: string;
+    static readonly EXTENSIONS: string[];
+    absoluteRoot: string;
+    _alias: PathFixer.Alias[] | null;
+    constructor(info?: PathFixer.ProjectInfo, projectRoot?: string);
+    get alias(): PathFixer.Alias[];
+    run(): Promise<void>;
+    watch(): Promise<void>;
+    private process;
+    private processReplacer;
+    watchHandler(queue: Map<string, NodeJS.Timeout>, eventType: string, filename: string): Promise<void>;
+    watchTimeout(file: string, name: string): Promise<void>;
+    static getAllFiles(dir: string, extensions: string[]): Promise<string[]>;
+    static getProjectInfo(tsconfig?: string): Promise<PathFixer.ProjectInfo>;
+}
+declare namespace PathFixer {
+    interface Paths {
+        [alias: string]: string[];
+    }
+    interface Alias {
+        alias: string;
+        target: string;
+    }
+    interface ProjectInfo {
+        root: string;
+        out: string;
+        path: Paths;
+    }
+}
+export default PathFixer;

package/build/PathFixer.js

@@ -0,0 +1,158 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description Utility for path fixing.
+ * @license Apache-2.0
+ */
+import path from 'path';
+import syncFs, { promises as fs } from 'fs';
+import { Logger, Utilities } from 'vortez';
+const logger = new Logger({ prefix: 'PathFixer' });
+export class PathFixer {
+    info;
+    projectRoot;
+    static IMPORT_REGEX = /(from\s+['"])([^'"]+)(['"])/g;
+    static DEFAULT_PROJECT_INFO = { root: 'src', out: 'build', path: {} };
+    static PROJECT_ROOT = process.cwd();
+    static EXTENSIONS = ['js', '.d.ts'];
+    absoluteRoot;
+    _alias = null;
+    constructor(info = PathFixer.DEFAULT_PROJECT_INFO, projectRoot = PathFixer.PROJECT_ROOT) {
+        this.info = info;
+        this.projectRoot = projectRoot;
+        const fullPath = path.join(projectRoot, info.out);
+        this.absoluteRoot = path.resolve(fullPath);
+    }
+    get alias() {
+        if (this._alias)
+            return this._alias;
+        const result = [];
+        for (const [key, value] of Object.entries(this.info.path)) {
+            let alias = key.replace(/\/\*$/, '');
+            alias = alias.replace(new RegExp(`^${this.info.root}`), '');
+            alias = alias.replace(/^\//, '');
+            let target = value[0].replace(/\/\*$/, '');
+            target = target.replace(new RegExp(`^${this.info.root}`), '');
+            target = target.replace(/^\/|\/$/, '');
+            target = path.join(this.absoluteRoot, target);
+            result.push({ alias, target });
+        }
+        this._alias = result;
+        return result;
+    }
+    async run() {
+        logger.log('&C2Starting path fixer, please wait...');
+        if (!await Utilities.fileExists(this.absoluteRoot))
+            return void logger.warn(`The root directory &C4${this.absoluteRoot}&R does not exist.`);
+        const files = await PathFixer.getAllFiles(this.absoluteRoot, PathFixer.EXTENSIONS);
+        logger.log(`&C2Found &C3${files.length} &C2files to process in &C4${this.absoluteRoot}.`);
+        let rewrittenCount = 0;
+        for (const file of files) {
+            const changed = await this.process(file);
+            if (changed)
+                rewrittenCount++;
+        }
+        logger.log(`&C2Path aliases rewritten in &C3${rewrittenCount} &C2files.`);
+    }
+    async watch() {
+        await this.run();
+        logger.log(`&C2Starting watcher in &C4${this.absoluteRoot}.`);
+        if (!await Utilities.fileExists(this.absoluteRoot))
+            await fs.mkdir(this.absoluteRoot, { recursive: true });
+        const watcher = syncFs.watch(this.absoluteRoot, { recursive: true });
+        const queue = new Map();
+        watcher.on('change', this.watchHandler.bind(this, queue));
+    }
+    async process(file) {
+        const content = await fs.readFile(file, 'utf8');
+        const newContent = content.replace(PathFixer.IMPORT_REGEX, this.processReplacer.bind(this, file));
+        if (content === newContent)
+            return false;
+        await fs.writeFile(file, newContent, 'utf8');
+        return true;
+    }
+    processReplacer(file, match, prefix, modulePath, suffix) {
+        const config = this.alias.find(config => modulePath.startsWith(`${config.alias}/`) || modulePath === config.alias);
+        if (!config)
+            return match;
+        const dir = path.dirname(file);
+        const restOfModulePath = modulePath.substring(config.alias.length);
+        const absoluteTarget = path.join(config.target, restOfModulePath);
+        let target = path.relative(dir, absoluteTarget);
+        if (!target.startsWith('.'))
+            target = `./${target}`;
+        target = target.replace(/\\/g, '/');
+        return `${prefix}${target}${suffix}`;
+    }
+    async watchHandler(queue, eventType, filename) {
+        if (!filename || !PathFixer.EXTENSIONS.some(ext => filename.endsWith(ext)))
+            return;
+        const fullPath = path.join(this.absoluteRoot, filename);
+        if (queue.has(fullPath))
+            clearTimeout(queue.get(fullPath));
+        queue.set(fullPath, setTimeout(this.watchTimeout.bind(this, fullPath, filename), 300));
+    }
+    async watchTimeout(file, name) {
+        try {
+            const stat = await fs.stat(file);
+            if (!stat.isFile())
+                return;
+            logger.log(`&C2Change detected in &C4${name}&C2. Processing`);
+            const changed = await this.process(file);
+            if (changed)
+                logger.log(`&C2File &C4${name}&C2 rewritten.`);
+        }
+        catch (error) {
+            if (error.code && error.code === 'ENOENT') {
+                logger.warn(`File &C4${name}&R not found, it may have been deleted.`);
+            }
+            else {
+                logger.error(`Error processing file &C4${name}&R:`, error);
+            }
+        }
+    }
+    static async getAllFiles(dir, extensions) {
+        const result = [];
+        if (!await Utilities.fileExists(dir))
+            return result;
+        const files = await fs.readdir(dir);
+        for (const file of files) {
+            const fullPath = path.join(dir, file);
+            try {
+                const stat = await fs.stat(fullPath);
+                if (stat.isDirectory()) {
+                    const subFiles = await this.getAllFiles(fullPath, extensions);
+                    result.push(...subFiles);
+                }
+                else if (stat.isFile() && extensions.some(ext => fullPath.endsWith(ext))) {
+                    result.push(fullPath);
+                }
+            }
+            catch (error) {
+                if (error && error.code === 'ENOENT') {
+                    logger.warn(`File or directory &C4${fullPath}&R not found during scan, skipping.`);
+                }
+                else {
+                    logger.error(`Error scanning file &C4${fullPath}&R:`, error);
+                }
+            }
+        }
+        return result;
+    }
+    static async getProjectInfo(tsconfig = 'tsconfig.json') {
+        const info = PathFixer.DEFAULT_PROJECT_INFO;
+        const content = await fs.readFile(tsconfig, 'utf8');
+        const json = JSON.parse(content);
+        if (!json.compilerOptions)
+            return info;
+        const options = json.compilerOptions;
+        if (options.rootDir)
+            info.root = options.rootDir;
+        if (options.outDir)
+            info.out = options.outDir;
+        if (options.paths)
+            info.path = options.paths;
+        return info;
+    }
+}
+export default PathFixer;
+//# sourceMappingURL=PathFixer.js.map

package/build/PathFixer.js.map

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

package/build/Validator.d.ts

@@ -0,0 +1,54 @@
+import Dependency from './Dependency.js';
+export declare class Validator {
+    /**
+     * Validates the 'name' property.
+     * @param name The 'name' property to validate.
+     * @returns `true` if valid, otherwise throws an error.
+     */
+    static validateName(name: any): asserts name is string;
+    /**
+     * Validates the repository URL.
+     * @param repo The repository URL to validate.
+     * @returns `true` if valid, otherwise throws an error.
+     * @throws Error if the repository URL is invalid.
+     */
+    static validateRepo(repo: any): asserts repo is Dependency.repo;
+    /**
+     * Validates the 'branch' property.
+     * @param branch The 'branch' property to validate.
+     * @returns `true` if valid, otherwise throws an error.
+     */
+    static validateBranch(branch: any): asserts branch is string | null | undefined;
+    static validateBuilder(builder: any): asserts builder is Dependency.Builder | null | undefined;
+    /**
+     * Validates the 'builder.run' property.
+     * @param run The 'builder.run' property to validate.
+     * @returns `true` if valid, otherwise throws an error.
+     */
+    static validateRun(run: any): asserts run is string | string[] | null | undefined;
+    /**
+     * Validates the 'builder.move' property.
+     * @param move The 'builder.move' property to validate.
+     * @returns `true` if valid, otherwise throws an error.
+     */
+    static validateMove(move: any): asserts move is Dependency.Builder.MoveType | null | undefined;
+    /**
+     * Validates a full dependency definition object.
+     * @param data The dependency data to validate.
+     * @returns `true` if valid, otherwise throws an error.
+     */
+    static validateDependency(data: any): asserts data is Dependency.Dependency;
+    /**
+     * Check if a file exists
+     * @param path Path to check
+     * @returns Promise<boolean>
+     */
+    protected isFile(path: string): Promise<boolean>;
+    /**
+     * Check if a file or folder exists
+     * @param path Path to check
+     * @returns Promise<boolean>
+     */
+    protected exists(path: string): Promise<boolean>;
+}
+export default Validator;