depflow 2.0.0-dev.1 → 2.0.0-dev.3

package/build/support/Resolver/PathResolver.js

@@ -0,0 +1,79 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Utility for path resolution with Local/CDN support and dual path fixing.
+ * @license Apache-2.0
+ */
+import syncFs, { promises as fs } from 'node:fs';
+import path from "node:path";
+import { Logger } from "vortez";
+import Utils from '../Utils.js';
+import File from '../File.js';
+import PathRewriter from './PathRewriter.js';
+import AliasCompiler from './AliasCompiler.js';
+export class PathResolver {
+    config;
+    options;
+    static PROJECT_ROOT = process.cwd();
+    static EXTENSIONS = ['.js', '.ts', '.jsx', '.tsx'];
+    logger;
+    rewriter;
+    absoluteOutDir;
+    aliases;
+    constructor(config, options = {}) {
+        this.config = config;
+        this.options = options;
+        this.logger = options.logger || new Logger({ prefix: 'PathResolver' });
+        const outDir = config.outDir || '.';
+        this.absoluteOutDir = !path.isAbsolute(outDir)
+            ? path.resolve(PathResolver.PROJECT_ROOT, outDir)
+            : outDir;
+        this.aliases = new AliasCompiler(PathResolver.PROJECT_ROOT).compile(config);
+        this.rewriter = new PathRewriter(this.aliases, PathResolver.PROJECT_ROOT);
+    }
+    async rewritePaths(mode) {
+        this.logger.log(`&C2Starting path resolver in &C3${mode} &C2mode...`);
+        if (!await File.exists(this.absoluteOutDir))
+            return void this.logger.warn(`Directory &C4${this.absoluteOutDir}&R not found.`);
+        const files = await File.getAllFiles(this.absoluteOutDir, PathResolver.EXTENSIONS);
+        let rewrittenCount = 0;
+        for (const file of files) {
+            if (await this.processFile(file, mode))
+                rewrittenCount++;
+        }
+        this.logger.log(`&C2Path aliases resolved in &C3${rewrittenCount} &C2files.`);
+    }
+    async processFile(file, mode) {
+        try {
+            const content = await fs.readFile(file, 'utf8');
+            const newContent = this.rewriter.rewrite(content, file, mode);
+            if (content === newContent)
+                return false;
+            await fs.writeFile(file, newContent, 'utf8');
+            return true;
+        }
+        catch (error) {
+            this.logger.error(`Failed to process file &C4${file}:`, error.message);
+            return false;
+        }
+    }
+    async watch(mode) {
+        await this.rewritePaths(mode);
+        this.logger.log(`&C2Watching for changes in &C4${this.absoluteOutDir}...`);
+        const debouncedProcessor = Utils.debounce(async (fullPath, filename) => {
+            if (await this.processFile(fullPath, mode)) {
+                this.logger.log(`&C2File &C4${filename}&C2 updated.`);
+            }
+        }, 300);
+        syncFs.watch(this.absoluteOutDir, { recursive: true }, (eventType, filename) => {
+            if (!filename)
+                return;
+            const isTargetExtension = PathResolver.EXTENSIONS.some(ext => filename.endsWith(ext));
+            if (!isTargetExtension)
+                return;
+            const fullPath = path.join(this.absoluteOutDir, filename);
+            debouncedProcessor(fullPath, filename);
+        });
+    }
+}
+export default PathResolver;
+//# sourceMappingURL=PathResolver.js.map

package/build/support/Resolver/PathResolver.js.map

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

package/build/support/Resolver/PathRewriter.d.ts

@@ -0,0 +1,10 @@
+import AliasCompiler from "./AliasCompiler.js";
+export declare class PathRewriter {
+    private readonly aliases;
+    private readonly projectRoot;
+    static readonly IMPORT_REGEX: RegExp;
+    constructor(aliases: AliasCompiler.CompiledAlias[], projectRoot: string);
+    rewrite(content: string, filePath: string, mode: 'local' | 'cdn'): string;
+}
+export declare namespace PathRewriter { }
+export default PathRewriter;

package/build/support/Resolver/PathRewriter.js

@@ -0,0 +1,39 @@
+import path from "node:path";
+import { Utilities } from "vortez";
+export class PathRewriter {
+    aliases;
+    projectRoot;
+    static IMPORT_REGEX = /(from\s+['"])([^'"]+)(['"])/g;
+    constructor(aliases, projectRoot) {
+        this.aliases = aliases;
+        this.projectRoot = projectRoot;
+    }
+    rewrite(content, filePath, mode) {
+        return content.replace(PathRewriter.IMPORT_REGEX, (match, prefix, modulePath, suffix) => {
+            const aliasCfg = this.aliases.find(c => c.isWildcard ? modulePath.startsWith(`${c.alias}/`) : modulePath === c.alias);
+            if (!aliasCfg)
+                return match;
+            const isCDN = mode === 'cdn' && aliasCfg.targets.cdn;
+            const baseTarget = isCDN ? aliasCfg.targets.cdn : aliasCfg.targets.local;
+            let resolvedPath;
+            if (aliasCfg.isWildcard) {
+                const subPath = modulePath.substring(aliasCfg.alias.length + 1);
+                resolvedPath = isCDN
+                    ? `${baseTarget.replace(/\/$/, '')}/${subPath}`
+                    : path.join(baseTarget, subPath);
+            }
+            else {
+                resolvedPath = baseTarget;
+            }
+            if (isCDN)
+                return `${prefix}${resolvedPath}${suffix}`;
+            const currentFileDir = path.dirname(filePath);
+            let relativeTarget = path.relative(currentFileDir, resolvedPath);
+            if (!relativeTarget.startsWith('.'))
+                relativeTarget = `./${relativeTarget}`;
+            return `${prefix}${Utilities.Path.normalize(relativeTarget)}${suffix}`;
+        });
+    }
+}
+export default PathRewriter;
+//# sourceMappingURL=PathRewriter.js.map

package/build/support/Resolver/PathRewriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathRewriter.js","sourceRoot":"","sources":["../../../src/support/Resolver/PathRewriter.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGnC,MAAM,OAAO,YAAY;IAGA;IACA;IAHd,MAAM,CAAU,YAAY,GAAG,8BAA8B,CAAC;IACrE,YACqB,OAAsC,EACtC,WAAmB;QADnB,YAAO,GAAP,OAAO,CAA+B;QACtC,gBAAW,GAAX,WAAW,CAAQ;IACrC,CAAC;IAEG,OAAO,CAAC,OAAe,EAAE,QAAgB,EAAE,IAAqB;QACnE,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE;YACpF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;YAEtH,IAAI,CAAC,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAE5B,MAAM,KAAK,GAAG,IAAI,KAAK,KAAK,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC;YACrD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;YAE1E,IAAI,YAAoB,CAAC;YACzB,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAChE,YAAY,GAAG,KAAK;oBAChB,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,OAAO,EAAE;oBAC/C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACJ,YAAY,GAAG,UAAU,CAAC;YAC9B,CAAC;YAED,IAAI,KAAK;gBAAE,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,EAAE,CAAC;YAEtD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC9C,IAAI,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;YACjE,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,cAAc,GAAG,KAAK,cAAc,EAAE,CAAC;YAE5E,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,GAAG,MAAM,EAAE,CAAC;QAC3E,CAAC,CAAC,CAAC;IACP,CAAC;;AAGL,eAAe,YAAY,CAAC"}

package/build/support/Resolver/Utils.d.ts

@@ -0,0 +1,36 @@
+export declare class Utils {
+    static readonly WILDCARD_SUFFIX_REGEX: RegExp;
+    /**
+     * Checks if a given alias string ends with a wildcard suffix (either "/*" or "/"), indicating that it is a wildcard alias.
+     * This method is used to determine whether an alias should be treated as a wildcard mapping, which allows for matching multiple paths under the same base alias.
+     * @param alias The alias string to check (e.g., "components/*" or "utils/").
+     * @returns True if the alias ends with a wildcard suffix, false otherwise.
+     */
+    static isWildcard(alias: string): boolean;
+    /**
+     * Removes the wildcard suffix (either "/*" or "/") from a given alias string, returning the base alias without the wildcard.
+     * This is useful for normalizing aliases when processing them, allowing the resolver to work with a consistent format regardless of whether the original alias was defined as a wildcard or not.
+     * @param pathStr The alias string from which to remove the wildcard suffix (e.g., "components/*" or "utils/").
+     * @returns The alias string with the wildcard suffix removed (e.g., "components" or "utils").
+     */
+    static removeWildcardSuffix(pathStr: string): string;
+    /**
+     * Ensures that a given alias string has a wildcard suffix (i.e., ends with "/*"). If the input string already ends with "/*" or "/", it will be normalized to end with "/*".
+     * If it does not end with either, "/*" will be appended to the end of the string.
+     * This method is useful for standardizing alias definitions when they are intended to be wildcard mappings.
+     * @param pathStr The alias string to ensure has a wildcard suffix (e.g., "components", "utils/", or "services/*").
+     * @returns The alias string guaranteed to end with "/*" (e.g., "components/*", "utils/*", or "services/*").
+     */
+    static ensureTsWildcard(pathStr: string): string;
+    /**
+     * Ensures that a given alias string has a trailing slash (i.e., ends with "/"). If the input string already ends with "/*" or "/", it will be normalized to end with "/".
+     * If it does not end with either, "/" will be appended to the end of the string.
+     * This method is useful for standardizing alias definitions when they are intended to be directory mappings without the wildcard.
+     * @param pathStr The alias string to ensure has a trailing slash (e.g., "components", "utils/", or "services/*").
+     * @returns The alias string guaranteed to end with "/" (e.g., "components/", "utils/", or "services/").
+     */
+    static ensureTrailingSlash(pathStr: string): string;
+}
+export declare namespace Utils {
+}
+export default Utils;

package/build/support/Resolver/Utils.js

@@ -0,0 +1,45 @@
+export class Utils {
+    static WILDCARD_SUFFIX_REGEX = /\/\*?$/;
+    /**
+     * Checks if a given alias string ends with a wildcard suffix (either "/*" or "/"), indicating that it is a wildcard alias.
+     * This method is used to determine whether an alias should be treated as a wildcard mapping, which allows for matching multiple paths under the same base alias.
+     * @param alias The alias string to check (e.g., "components/*" or "utils/").
+     * @returns True if the alias ends with a wildcard suffix, false otherwise.
+     */
+    static isWildcard(alias) {
+        return this.WILDCARD_SUFFIX_REGEX.test(alias);
+    }
+    /**
+     * Removes the wildcard suffix (either "/*" or "/") from a given alias string, returning the base alias without the wildcard.
+     * This is useful for normalizing aliases when processing them, allowing the resolver to work with a consistent format regardless of whether the original alias was defined as a wildcard or not.
+     * @param pathStr The alias string from which to remove the wildcard suffix (e.g., "components/*" or "utils/").
+     * @returns The alias string with the wildcard suffix removed (e.g., "components" or "utils").
+     */
+    static removeWildcardSuffix(pathStr) {
+        return pathStr.replace(this.WILDCARD_SUFFIX_REGEX, '');
+    }
+    /**
+     * Ensures that a given alias string has a wildcard suffix (i.e., ends with "/*"). If the input string already ends with "/*" or "/", it will be normalized to end with "/*".
+     * If it does not end with either, "/*" will be appended to the end of the string.
+     * This method is useful for standardizing alias definitions when they are intended to be wildcard mappings.
+     * @param pathStr The alias string to ensure has a wildcard suffix (e.g., "components", "utils/", or "services/*").
+     * @returns The alias string guaranteed to end with "/*" (e.g., "components/*", "utils/*", or "services/*").
+     */
+    static ensureTsWildcard(pathStr) {
+        const clean = this.removeWildcardSuffix(pathStr);
+        return `${clean}/*`;
+    }
+    /**
+     * Ensures that a given alias string has a trailing slash (i.e., ends with "/"). If the input string already ends with "/*" or "/", it will be normalized to end with "/".
+     * If it does not end with either, "/" will be appended to the end of the string.
+     * This method is useful for standardizing alias definitions when they are intended to be directory mappings without the wildcard.
+     * @param pathStr The alias string to ensure has a trailing slash (e.g., "components", "utils/", or "services/*").
+     * @returns The alias string guaranteed to end with "/" (e.g., "components/", "utils/", or "services/").
+     */
+    static ensureTrailingSlash(pathStr) {
+        const clean = this.removeWildcardSuffix(pathStr);
+        return `${clean}/`;
+    }
+}
+export default Utils;
+//# sourceMappingURL=Utils.js.map

package/build/support/Resolver/Utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.js","sourceRoot":"","sources":["../../../src/support/Resolver/Utils.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,KAAK;IACP,MAAM,CAAU,qBAAqB,GAAG,QAAQ,CAAC;IACxD;;;;;OAKG;IACI,MAAM,CAAC,UAAU,CAAC,KAAa;QAClC,OAAO,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,oBAAoB,CAAC,OAAe;QAC9C,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD;;;;;;OAMG;IACI,MAAM,CAAC,gBAAgB,CAAC,OAAe;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACjD,OAAO,GAAG,KAAK,IAAI,CAAC;IACxB,CAAC;IACD;;;;;;OAMG;IACI,MAAM,CAAC,mBAAmB,CAAC,OAAe;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACjD,OAAO,GAAG,KAAK,GAAG,CAAC;IACvB,CAAC;;AAKL,eAAe,KAAK,CAAC"}

package/build/support/Utils.d.ts

@@ -0,0 +1,30 @@
+export declare class Utils {
+    protected static REPO_REGEX: RegExp;
+    /**
+     * Extracts a repository name from its URL.
+     * @param repo - The repository URL.
+     * @returns The repository name.
+     */
+    static getRepoName: (repo: string) => string;
+    /**
+     * Extracts the value(s) of a specified flag from an array of command-line arguments.
+     * @param args - The array of command-line arguments.
+     * @param flag - The flag to search for (e.g., '-p' or '--project').
+     * @param multiple - Whether to allow multiple values for the same flag.
+     * @returns An array of values associated with the specified flag.
+     */
+    static getFlagValue(args: string[], flag: string, multiple?: boolean): string[];
+    /**
+     * Adds JSON schema validation for a specified file in Visual Studio Code by creating or updating the settings.json file in the .vscode directory.
+     * It ensures that the provided schema object is saved locally and referenced correctly in the VSCode settings, allowing for enhanced editing support such as autocompletion and validation based on the defined schema when working with the specified file.
+     * @param flowPath The file path to which the JSON schema validation should be applied (e.g., 'depflow.json').
+     * @param schemaObject The JSON schema object that defines the structure and validation rules for the specified file.
+     * @returns A promise that resolves to true if the operation was successful, or false if an error occurred during the process.
+     */
+    static addVscodeValidation(flowPath: string, schemaObject: object): Promise<boolean>;
+    static debounce<Args extends any[]>(fn: Utils.DebouncedFunction<Args>, delay: number): Utils.DebouncedFunction<Args>;
+}
+export declare namespace Utils {
+    type DebouncedFunction<Args extends any[]> = (...args: Args) => void;
+}
+export default Utils;

package/build/support/Utils.js

@@ -0,0 +1,95 @@
+import { File, Path } from '@netfeez/common-node';
+export class Utils {
+    static REPO_REGEX = /^(?:https:\/\/github\.com\/([^/]+)\/([^/.]+)(?:\.git)?|git@github\.com:([^/]+)\/([^/.]+)(?:\.git)?)$/;
+    /**
+     * Extracts a repository name from its URL.
+     * @param repo - The repository URL.
+     * @returns The repository name.
+     */
+    static getRepoName = (repo) => {
+        const match = repo.match(Utils.REPO_REGEX);
+        if (match) {
+            const user = match[1] || match[3];
+            const repoName = match[2] || match[4];
+            return `${user}.${repoName}`;
+        }
+        throw new Error(`Invalid repository URL: "${repo}"`);
+    };
+    /**
+     * Extracts the value(s) of a specified flag from an array of command-line arguments.
+     * @param args - The array of command-line arguments.
+     * @param flag - The flag to search for (e.g., '-p' or '--project').
+     * @param multiple - Whether to allow multiple values for the same flag.
+     * @returns An array of values associated with the specified flag.
+     */
+    static getFlagValue(args, flag, multiple = false) {
+        const values = [];
+        for (const index in args) {
+            const value = args[index];
+            if (value === flag) {
+                const nextValue = args[Number(index) + 1];
+                if (nextValue && !nextValue.startsWith('-')) {
+                    values.push(nextValue);
+                    if (!multiple)
+                        break;
+                }
+            }
+        }
+        return values;
+    }
+    /**
+     * Adds JSON schema validation for a specified file in Visual Studio Code by creating or updating the settings.json file in the .vscode directory.
+     * It ensures that the provided schema object is saved locally and referenced correctly in the VSCode settings, allowing for enhanced editing support such as autocompletion and validation based on the defined schema when working with the specified file.
+     * @param flowPath The file path to which the JSON schema validation should be applied (e.g., 'depflow.json').
+     * @param schemaObject The JSON schema object that defines the structure and validation rules for the specified file.
+     * @returns A promise that resolves to true if the operation was successful, or false if an error occurred during the process.
+     */
+    static async addVscodeValidation(flowPath, schemaObject) {
+        const root = process.cwd();
+        const internalDir = Path.join(root, '.depflow');
+        const schemaLocalPath = Path.join(internalDir, 'schema.json');
+        const vscodeDir = Path.join(root, '.vscode');
+        const settingsPath = Path.join(vscodeDir, 'settings.json');
+        try {
+            if (!await File.exists(internalDir))
+                await File.mkdir(internalDir, { recursive: true });
+            await File.write(schemaLocalPath, JSON.stringify(schemaObject, null, 4));
+            if (!await File.exists(vscodeDir))
+                await File.mkdir(vscodeDir, { recursive: true });
+            let settings = {};
+            if (await File.exists(settingsPath)) {
+                try {
+                    settings = JSON.parse(await File.read(settingsPath));
+                }
+                catch (e) {
+                    settings = {};
+                }
+            }
+            if (!settings['json.schemas'])
+                settings['json.schemas'] = [];
+            const relativeSchema = './.depflow/schema.json';
+            const hasSchema = settings['json.schemas'].some((s) => s.fileMatch && s.fileMatch.includes(flowPath));
+            if (hasSchema)
+                return true;
+            settings['json.schemas'].push({ fileMatch: [flowPath], url: relativeSchema });
+            await File.write(settingsPath, JSON.stringify(settings, null, 4));
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    static debounce(fn, delay) {
+        let timeoutId = null;
+        return function (...args) {
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            timeoutId = setTimeout(() => {
+                fn.apply(this, args);
+                timeoutId = null;
+            }, delay);
+        };
+    }
+}
+export default Utils;
+//# sourceMappingURL=Utils.js.map

package/build/support/Utils.js.map

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

package/build/support/Validator.d.ts

@@ -0,0 +1,22 @@
+export declare class Validator {
+    /**
+     * Validates that the provided repository URL is a non-empty string and matches common Git repository URL patterns. It checks for both HTTPS and SSH formats, ensuring that the URL is well-formed and points to a valid Git repository.
+     * If the validation fails, it throws an error with a descriptive message indicating the issue with the provided repository URL.
+      * @param repo The repository URL to validate.
+      * @throws Will throw an error if the repository URL is invalid.
+     */
+    static validateRepo(repo: unknown): asserts repo is Validator.Repo;
+    /**
+     * Validates that the provided name is a non-empty string.
+     * It checks if the name is of type string and contains non-whitespace characters.
+     * If the validation fails, it throws an error with a descriptive message indicating the issue with the provided name.
+     * @param name The name to validate.
+     * @throws Will throw an error if the name is invalid.
+     */
+    static validateName(name: unknown): asserts name is Validator.name;
+}
+export declare namespace Validator {
+    type Repo = `https://github.com/${string}/${string}.git` | `git@github.com:${string}/${string}.git`;
+    type name = string;
+}
+export default Validator;

package/build/support/Validator.js

@@ -0,0 +1,28 @@
+export class Validator {
+    /**
+     * Validates that the provided repository URL is a non-empty string and matches common Git repository URL patterns. It checks for both HTTPS and SSH formats, ensuring that the URL is well-formed and points to a valid Git repository.
+     * If the validation fails, it throws an error with a descriptive message indicating the issue with the provided repository URL.
+      * @param repo The repository URL to validate.
+      * @throws Will throw an error if the repository URL is invalid.
+     */
+    static validateRepo(repo) {
+        if (typeof repo !== 'string' || !repo.trim())
+            throw new Error(`Invalid repository URL: "${repo}"`);
+        const gitRegex = /^(?:(?:https?|git|ssh|rsync|file|git@[-\w.]+):(\/\/)?)([\w.@:/\-~]+)(\.git)(\/)?$/;
+        if (!gitRegex.test(repo))
+            throw new Error(`Invalid repository URL: ${repo}`);
+    }
+    /**
+     * Validates that the provided name is a non-empty string.
+     * It checks if the name is of type string and contains non-whitespace characters.
+     * If the validation fails, it throws an error with a descriptive message indicating the issue with the provided name.
+     * @param name The name to validate.
+     * @throws Will throw an error if the name is invalid.
+     */
+    static validateName(name) {
+        if (typeof name !== 'string' || !name.trim())
+            throw new Error(`Invalid dependency name: "${name}"`);
+    }
+}
+export default Validator;
+//# sourceMappingURL=Validator.js.map

package/build/support/Validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validator.js","sourceRoot":"","sources":["../../src/support/Validator.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,SAAS;IAClB;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,IAAa;QAC7B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,GAAG,CAAC,CAAC;QACnG,MAAM,QAAQ,GAAG,mFAAmF,CAAC;QACrG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;IACjF,CAAC;IACD;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,IAAa;QAC7B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,GAAG,CAAC,CAAC;IACxG,CAAC;CACJ;AAKD,eAAe,SAAS,CAAC"}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "depflow",
   "description": "is a simple dependency manager based on github repositories",
-  "version": "2.0.0-dev.1",
+  "version": "2.0.0-dev.3",
   "main": "build/bin/bin.js",
   "type": "module",
   "bin": {
-    "dep": "build/bin/bin.js"
+    "dep": "build/cli/bin.js"
   },
   "scripts": {
     "dev": "npx tsc --watch",
@@ -34,7 +34,8 @@
   ],
   "dependencies": {
     "@netfeez/common": "^2.1.0",
-    "vortez": "^5.0.0"
+    "@netfeez/common-node": "^1.0.1",
+    "@netfeez/vterm": "^1.0.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",

package/build/Config.d.ts

@@ -1,15 +0,0 @@
-/**
- * @author NetFeez <netfeez.dev@gmail.com>
- * @description Utility to help with File operations.
- * @license Apache-2.0
- */
-import schemas from './schemas.js';
-export declare class Config {
-    static load(path: string): Promise<Config.Config>;
-    static save(path: string, config: Config.ConfigToProcess): Promise<void>;
-}
-export declare namespace Config {
-    type Config = typeof schemas.config.infer;
-    type ConfigToProcess = typeof schemas.config.inferToProcess;
-}
-export default Config;

package/build/Config.js

@@ -1,21 +0,0 @@
-/**
- * @author NetFeez <netfeez.dev@gmail.com>
- * @description Utility to help with File operations.
- * @license Apache-2.0
- */
-import { promises as FS } from 'fs';
-import schemas from './schemas.js';
-export class Config {
-    static async load(path) {
-        const content = await FS.readFile(path, 'utf-8');
-        const json = JSON.parse(content);
-        const config = schemas.config.processData(json);
-        return config;
-    }
-    static async save(path, config) {
-        const content = JSON.stringify(config, null, 2);
-        await FS.writeFile(path, content, 'utf-8');
-    }
-}
-export default Config;
-//# sourceMappingURL=Config.js.map

package/build/Config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Config.js","sourceRoot":"","sources":["../src/Config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,MAAM,OAAO,MAAM;IACf,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY;QAC1B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,MAA8B;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAChD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;CACJ;AAMD,eAAe,MAAM,CAAC"}

package/build/Dependency.d.ts

@@ -1,86 +0,0 @@
-import { ChildProcessWithoutNullStreams } from "child_process";
-import schemas from "./schemas.js";
-export declare class Dependency implements Dependency.Dependency {
-    static include: string[];
-    readonly name: string;
-    readonly repo: Dependency.repo;
-    readonly branch?: string;
-    readonly builder: Dependency.Builder[];
-    /**
-     * Create a new dependency
-     * @param dependency Dependency to create
-     * @param logger Logger to use
-     * @returns New dependency
-     */
-    constructor(dependency: Dependency.Dependency);
-    /** Get the folder of the dependency */
-    get folder(): string;
-    /**
-     * Clone a dependency
-     * @param options Options to use
-     * @returns Promise<void>
-     */
-    clone(options?: Dependency.manageOptions): Promise<string>;
-    /**
-     * Pull a dependency
-     * @returns Promise<void>
-     */
-    pull(): Promise<string>;
-    /**
-     * Install a dependency
-     * @param options Options to use
-     * @returns Promise<void>
-     */
-    install(): Promise<string[]>;
-    /**
-     * Uninstall a dependency
-     * @returns Promise<void>
-     */
-    uninstall(): Promise<string[]>;
-    protected build(): Promise<string[]>;
-    protected move(move: Dependency.Builder['move']): Promise<string[]>;
-    /**
-     * Execute multiple commands in a shell
-     * @param commands Commands to execute
-     * @param customShell Custom shell to use (optional)
-     * @returns Output of the commands
-     */
-    protected executeCommands(commands: string[], shell: ChildProcessWithoutNullStreams): Promise<string[]>;
-    /**
-     * Execute a command in a shell
-     * @param shell Shell to execute the command in
-     * @param command Command to execute
-     * @returns Output of the command
-     */
-    protected executeCommand(shell: ChildProcessWithoutNullStreams, command: string): Promise<string[]>;
-    /**
-     * Move files from a dependency
-     * @param destination Destination folder
-     * @param source Source folder
-     * @returns The output of the operation
-     */
-    protected moveFiles(destination: string | string[], source?: string): Promise<string[]>;
-    /**
-     * Get the source path of a dependency
-     * @param source Source path
-     * @returns Source path
-     */
-    static getSourcePath(folder: string, source?: string): string;
-    /**
-     * Get all folders of a dependency
-     * @param builder Builder to get folders from
-     * @returns Folders
-     */
-    static getAllOutFolders(builder: Dependency.Builder['move']): string[];
-}
-export declare namespace Dependency {
-    type logCallback = (messages: string[]) => void;
-    type repo = `https://github.com/${string}/${string}.git` | `git@github.com:${string}/${string}.git`;
-    type Builder = schemas.builder['inferToProcess'];
-    type Dependency = schemas.dependency['infer'];
-    type newDependency = schemas.dependency['inferToProcess'];
-    interface manageOptions {
-        force?: boolean;
-    }
-}
-export default Dependency;