@ducky7go/ducky-cli 0.0.1

package/dist/formats/nuget/parser.js

@@ -0,0 +1,140 @@
+import { readTextFile } from '../../utils/fs.js';
+import { FileSystemError, ValidationError } from '../../utils/errors.js';
+/**
+ * Parse info.ini file from a mod directory
+ * @param modPath - Path to the mod directory
+ * @returns Parsed metadata
+ * @throws {FileSystemError} If info.ini is not found
+ * @throws {ValidationError} If required fields are missing
+ */
+export async function parseInfoIni(modPath) {
+    const infoIniPath = `${modPath}/info.ini`;
+    try {
+        const content = await readTextFile(infoIniPath);
+        return parseInfoIniContent(content);
+    }
+    catch (error) {
+        if (error instanceof FileSystemError) {
+            throw new FileSystemError(`info.ini not found in ${modPath}`, [
+                'Ensure info.ini exists in the mod directory',
+                'The info.ini file should contain mod metadata',
+            ]);
+        }
+        throw error;
+    }
+}
+/**
+ * Parse info.ini content
+ * @param content - Raw INI content
+ * @returns Parsed metadata
+ * @throws {ValidationError} If required fields are missing or invalid
+ */
+export function parseInfoIniContent(content) {
+    const ini = parseIni(content);
+    const metadata = ini[''];
+    if (!metadata) {
+        throw new ValidationError('info.ini is empty or invalid', ['Ensure info.ini contains metadata fields']);
+    }
+    // Validate required fields
+    const requiredFields = ['name', 'version'];
+    const missingFields = requiredFields.filter((field) => !metadata[field]);
+    if (missingFields.length > 0) {
+        throw new ValidationError(`Missing required fields in info.ini: ${missingFields.join(', ')}`, [
+            'Add the missing fields to info.ini',
+            'Required fields: name, version',
+        ]);
+    }
+    // Validate name (NuGet ID format)
+    const name = metadata.name.trim();
+    if (!isValidNuGetId(name)) {
+        throw new ValidationError(`Invalid NuGet ID: ${name}`, [
+            'NuGet IDs must start with a letter or underscore',
+            'Allowed characters: letters, digits, dots, hyphens, underscores',
+            'Example: MyMod.Example',
+        ]);
+    }
+    // Validate version (SemVer 2.0)
+    const version = metadata.version.trim();
+    if (!isValidSemVer(version)) {
+        throw new ValidationError(`Invalid version format: ${version}`, [
+            'Version must follow SemVer 2.0 format',
+            'Example: 1.0.0, 2.1.0-beta, 3.0.0-rc.1',
+        ]);
+    }
+    return {
+        name,
+        version,
+        description: metadata.description?.trim(),
+        author: metadata.author?.trim(),
+        icon: metadata.icon?.trim(),
+        tags: parseList(metadata.tags),
+        dependencies: parseList(metadata.dependencies),
+        projectUrl: metadata.projectUrl?.trim(),
+        license: metadata.license?.trim(),
+        copyright: metadata.copyright?.trim(),
+    };
+}
+/**
+ * Simple INI parser
+ * @param content - Raw INI content
+ * @returns Parsed INI object
+ */
+function parseIni(content) {
+    const result = { '': {} };
+    let currentSection = '';
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        const commentIndex = trimmed.indexOf('#');
+        const activeLine = commentIndex >= 0 ? trimmed.slice(0, commentIndex).trim() : trimmed;
+        if (!activeLine) {
+            continue;
+        }
+        // Section header
+        const sectionMatch = activeLine.match(/^\[([^\]]+)\]$/);
+        if (sectionMatch) {
+            currentSection = sectionMatch[1];
+            result[currentSection] = {};
+            continue;
+        }
+        // Key-value pair
+        const keyValueMatch = activeLine.match(/^([^=]+)=(.*)$/);
+        if (keyValueMatch) {
+            const key = keyValueMatch[1].trim();
+            const value = keyValueMatch[2].trim();
+            result[currentSection][key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Parse a comma-separated list
+ */
+function parseList(value) {
+    if (!value) {
+        return undefined;
+    }
+    return value
+        .split(',')
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+}
+/**
+ * Validate NuGet ID format
+ * Based on: https://learn.microsoft.com/en-us/nuget/reference/id-prefixes
+ */
+function isValidNuGetId(id) {
+    if (!id || id.length > 100) {
+        return false;
+    }
+    return /^[A-Za-z_][A-Za-z0-9._-]*$/.test(id);
+}
+/**
+ * Validate SemVer 2.0 version format
+ * Based on: https://semver.org/spec/v2.0.0.html
+ */
+function isValidSemVer(version) {
+    // SemVer regex pattern
+    const semverPattern = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
+    return semverPattern.test(version);
+}
+//# sourceMappingURL=parser.js.map

package/dist/formats/nuget/parser.js.map

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

package/dist/formats/nuget/validator.d.ts

@@ -0,0 +1,19 @@
+import type { ModMetadata } from './parser.js';
+import { ValidationError } from '../../utils/errors.js';
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: string[];
+}
+/**
+ * Validate a mod directory according to NuGet Mod Packaging Specification v1.0
+ *
+ * @param modPath - Path to mod directory
+ * @param metadata - Parsed metadata
+ * @returns Validation result
+ */
+export declare function validateMod(modPath: string, metadata: ModMetadata): Promise<ValidationResult>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/formats/nuget/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/formats/nuget/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAqB3B"}

package/dist/formats/nuget/validator.js

@@ -0,0 +1,104 @@
+import { collectFiles } from '../../utils/fs.js';
+import { ValidationError } from '../../utils/errors.js';
+/**
+ * Validate a mod directory according to NuGet Mod Packaging Specification v1.0
+ *
+ * @param modPath - Path to mod directory
+ * @param metadata - Parsed metadata
+ * @returns Validation result
+ */
+export async function validateMod(modPath, metadata) {
+    const errors = [];
+    const warnings = [];
+    // 1. Validate DLL name matches mod name
+    await validateDllName(modPath, metadata, errors);
+    // 2. Validate version format (already done in parser, but double-check)
+    validateSemVer(metadata.version, errors);
+    // 3. Validate NuGet ID (already done in parser, but double-check)
+    validateNuGetId(metadata.name, errors);
+    // 4. Validate required fields
+    validateRequiredFields(metadata, errors);
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validate that at least one DLL exists and its name matches the mod name
+ */
+async function validateDllName(modPath, metadata, errors) {
+    const dllFiles = await collectFiles(modPath, /\.dll$/i);
+    if (dllFiles.length === 0) {
+        errors.push(new ValidationError('No DLL files found in mod directory', [
+            'Add at least one DLL file to the mod',
+            'DLL files are required for game mods',
+        ]));
+        return;
+    }
+    // Check if any DLL name matches the mod name
+    const expectedDllName = metadata.name;
+    const hasMatchingDll = dllFiles.some((dllPath) => {
+        const fileName = dllPath.split('/').pop() || dllPath.split('\\').pop() || '';
+        const baseName = fileName.replace(/\.dll$/i, '');
+        return baseName === expectedDllName;
+    });
+    if (!hasMatchingDll) {
+        const dllNames = dllFiles
+            .map((p) => p.split('/').pop() || p.split('\\').pop() || '')
+            .join(', ');
+        errors.push(new ValidationError(`No DLL file matches mod name "${metadata.name}"`, [
+            `Rename one of the DLLs to "${metadata.name}.dll"`,
+            `Current DLLs: ${dllNames}`,
+        ]));
+    }
+}
+/**
+ * Validate SemVer 2.0 version format
+ */
+function validateSemVer(version, errors) {
+    const semverPattern = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
+    if (!semverPattern.test(version)) {
+        errors.push(new ValidationError(`Invalid version format: ${version}`, [
+            'Version must follow SemVer 2.0 format',
+            'Examples: 1.0.0, 2.1.0-beta, 3.0.0-rc.1+build.123',
+        ]));
+    }
+}
+/**
+ * Validate NuGet ID format
+ */
+function validateNuGetId(id, errors) {
+    if (!id || id.length > 100) {
+        errors.push(new ValidationError(`Invalid NuGet ID length: ${id ? id.length : 0} characters (max 100)`, ['Use a shorter name for your mod']));
+        return;
+    }
+    if (!/^[A-Za-z_][A-Za-z0-9._-]*$/.test(id)) {
+        errors.push(new ValidationError(`Invalid NuGet ID format: ${id}`, [
+            'NuGet IDs must start with a letter or underscore',
+            'Allowed characters: letters, digits, dots, hyphens, underscores',
+            'Example: MyMod.Example',
+        ]));
+    }
+}
+/**
+ * Validate required fields are present
+ */
+function validateRequiredFields(metadata, errors) {
+    if (!metadata.name) {
+        errors.push(new ValidationError('Missing required field: name', [
+            'Add "name" field to info.ini',
+        ]));
+    }
+    if (!metadata.version) {
+        errors.push(new ValidationError('Missing required field: version', [
+            'Add "version" field to info.ini',
+        ]));
+    }
+    if (!metadata.description) {
+        errors.push(new ValidationError('Missing recommended field: description', [
+            'Add "description" field to info.ini',
+        ]));
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/formats/nuget/validator.js.map

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

package/dist/utils/config.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Configuration interface for NuGet operations
+ */
+export interface NuGetConfig {
+    apiKey?: string;
+    server?: string;
+    verbose?: boolean;
+}
+/**
+ * Resolve configuration from multiple sources with precedence:
+ * 1. CLI flags (highest priority)
+ * 2. Environment variables
+ * 3. Config file (.duckyrc)
+ * 4. Default values (lowest priority)
+ *
+ * @param cliFlags - Configuration from CLI flags
+ * @param envPrefix - Prefix for environment variables (default: 'NUGET')
+ * @returns Resolved configuration
+ */
+export declare function resolveConfig(cliFlags?: Partial<NuGetConfig>, envPrefix?: string): NuGetConfig;
+/**
+ * Get API key from configuration
+ * @throws {ConfigError} If API key is required but not found
+ */
+export declare function getApiKey(config: NuGetConfig): string;
+/**
+ * Get server URL from configuration
+ * @throws {ConfigError} If server URL is invalid
+ */
+export declare function getServerUrl(config: NuGetConfig): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,GAAE,OAAO,CAAC,WAAW,CAAM,EACnC,SAAS,SAAU,GAClB,WAAW,CAqCb;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAYrD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAcxD"}

package/dist/utils/config.js

@@ -0,0 +1,86 @@
+import { config as dotenvConfig } from 'dotenv';
+import { dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { ConfigError } from './errors.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Load .env file if it exists
+dotenvConfig();
+/**
+ * Resolve configuration from multiple sources with precedence:
+ * 1. CLI flags (highest priority)
+ * 2. Environment variables
+ * 3. Config file (.duckyrc)
+ * 4. Default values (lowest priority)
+ *
+ * @param cliFlags - Configuration from CLI flags
+ * @param envPrefix - Prefix for environment variables (default: 'NUGET')
+ * @returns Resolved configuration
+ */
+export function resolveConfig(cliFlags = {}, envPrefix = 'NUGET') {
+    const config = {
+        // Default values
+        server: 'https://api.nuget.org/v3/index.json',
+        verbose: false,
+    };
+    // Load from environment variables
+    const envApiKey = process.env[`${envPrefix}_API_KEY`];
+    const envServer = process.env[`${envPrefix}_SERVER`];
+    const envVerbose = process.env[`${envPrefix}_VERBOSE`];
+    if (envApiKey) {
+        config.apiKey = envApiKey;
+    }
+    if (envServer) {
+        config.server = envServer;
+    }
+    if (envVerbose) {
+        config.verbose = envVerbose === 'true' || envVerbose === '1';
+    }
+    // Load from config file (optional)
+    // TODO: Implement .duckyrc parsing if needed
+    // Override with CLI flags (highest priority)
+    if (cliFlags.apiKey !== undefined) {
+        config.apiKey = cliFlags.apiKey;
+    }
+    if (cliFlags.server !== undefined) {
+        config.server = cliFlags.server;
+    }
+    if (cliFlags.verbose !== undefined) {
+        config.verbose = cliFlags.verbose;
+    }
+    return config;
+}
+/**
+ * Get API key from configuration
+ * @throws {ConfigError} If API key is required but not found
+ */
+export function getApiKey(config) {
+    if (!config.apiKey) {
+        throw new ConfigError('NuGet API key is required for this operation', [
+            'Set the NUGET_API_KEY environment variable',
+            'Use the --api-key flag',
+            'For nuget.org, create an API key at https://www.nuget.org/account/apikeys',
+        ]);
+    }
+    return config.apiKey;
+}
+/**
+ * Get server URL from configuration
+ * @throws {ConfigError} If server URL is invalid
+ */
+export function getServerUrl(config) {
+    if (!config.server) {
+        return 'https://api.nuget.org/v3/index.json';
+    }
+    try {
+        new URL(config.server);
+        return config.server;
+    }
+    catch {
+        throw new ConfigError(`Invalid server URL: ${config.server}`, [
+            'Ensure the URL is valid (e.g., https://api.nuget.org/v3/index.json)',
+            'Use the --server flag with a valid URL',
+        ]);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAW,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,8BAA8B;AAC9B,YAAY,EAAE,CAAC;AAWf;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,WAAiC,EAAE,EACnC,SAAS,GAAG,OAAO;IAEnB,MAAM,MAAM,GAAgB;QAC1B,iBAAiB;QACjB,MAAM,EAAE,qCAAqC;QAC7C,OAAO,EAAE,KAAK;KACf,CAAC;IAEF,kCAAkC;IAClC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,UAAU,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,SAAS,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,UAAU,CAAC,CAAC;IAEvD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC;IAC5B,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC;IAC5B,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,CAAC,OAAO,GAAG,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,GAAG,CAAC;IAC/D,CAAC;IAED,mCAAmC;IACnC,6CAA6C;IAE7C,6CAA6C;IAC7C,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAClC,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAClC,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACpC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,MAAmB;IAC3C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,WAAW,CACnB,8CAA8C,EAC9C;YACE,4CAA4C;YAC5C,wBAAwB;YACxB,2EAA2E;SAC5E,CACF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,qCAAqC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvB,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,WAAW,CAAC,uBAAuB,MAAM,CAAC,MAAM,EAAE,EAAE;YAC5D,qEAAqE;YACrE,wCAAwC;SACzC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Base error class for all ducky-cli errors
+ */
+export declare class DuckyError extends Error {
+    readonly code: string;
+    readonly suggestions?: string[] | undefined;
+    constructor(message: string, code: string, suggestions?: string[] | undefined);
+    /**
+     * Format the error with suggestions for user-friendly display
+     */
+    format(): string;
+}
+/**
+ * Error raised when mod validation fails
+ */
+export declare class ValidationError extends DuckyError {
+    constructor(message: string, suggestions?: string[]);
+}
+/**
+ * Error raised when configuration is missing or invalid
+ */
+export declare class ConfigError extends DuckyError {
+    constructor(message: string, suggestions?: string[]);
+}
+/**
+ * Error raised when network operations fail
+ */
+export declare class NetworkError extends DuckyError {
+    constructor(message: string, suggestions?: string[]);
+}
+/**
+ * Error raised when file system operations fail
+ */
+export declare class FileSystemError extends DuckyError {
+    constructor(message: string, suggestions?: string[]);
+}
+/**
+ * Error raised when NuGet CLI operations fail
+ */
+export declare class NuGetError extends DuckyError {
+    constructor(message: string, suggestions?: string[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;aAGjB,IAAI,EAAE,MAAM;aACZ,WAAW,CAAC,EAAE,MAAM,EAAE;gBAFtC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EAAE,YAAA;IAOxC;;OAEG;IACH,MAAM,IAAI,MAAM;CAUjB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;CAIpD;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;CAIpD;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;gBAC9B,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;CAIpD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;CAIpD;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,UAAU;gBAC5B,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;CAIpD"}

package/dist/utils/errors.js

@@ -0,0 +1,73 @@
+/**
+ * Base error class for all ducky-cli errors
+ */
+export class DuckyError extends Error {
+    code;
+    suggestions;
+    constructor(message, code, suggestions) {
+        super(message);
+        this.code = code;
+        this.suggestions = suggestions;
+        this.name = 'DuckyError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+    /**
+     * Format the error with suggestions for user-friendly display
+     */
+    format() {
+        let output = `\x1b[31m✖ ${this.message}\x1b[0m`;
+        if (this.suggestions && this.suggestions.length > 0) {
+            output += '\n\nSuggestions:';
+            for (const suggestion of this.suggestions) {
+                output += `\n  • ${suggestion}`;
+            }
+        }
+        return output;
+    }
+}
+/**
+ * Error raised when mod validation fails
+ */
+export class ValidationError extends DuckyError {
+    constructor(message, suggestions) {
+        super(message, 'VALIDATION_ERROR', suggestions);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Error raised when configuration is missing or invalid
+ */
+export class ConfigError extends DuckyError {
+    constructor(message, suggestions) {
+        super(message, 'CONFIG_ERROR', suggestions);
+        this.name = 'ConfigError';
+    }
+}
+/**
+ * Error raised when network operations fail
+ */
+export class NetworkError extends DuckyError {
+    constructor(message, suggestions) {
+        super(message, 'NETWORK_ERROR', suggestions);
+        this.name = 'NetworkError';
+    }
+}
+/**
+ * Error raised when file system operations fail
+ */
+export class FileSystemError extends DuckyError {
+    constructor(message, suggestions) {
+        super(message, 'FILESYSTEM_ERROR', suggestions);
+        this.name = 'FileSystemError';
+    }
+}
+/**
+ * Error raised when NuGet CLI operations fail
+ */
+export class NuGetError extends DuckyError {
+    constructor(message, suggestions) {
+        super(message, 'NUGET_ERROR', suggestions);
+        this.name = 'NuGetError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGjB;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,WAAsB;QAEtC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,gBAAW,GAAX,WAAW,CAAW;QAGtC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,MAAM,GAAG,aAAa,IAAI,CAAC,OAAO,SAAS,CAAC;QAChD,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,kBAAkB,CAAC;YAC7B,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC1C,MAAM,IAAI,SAAS,UAAU,EAAE,CAAC;YAClC,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,OAAe,EAAE,WAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,WAAW,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,UAAU;IACzC,YAAY,OAAe,EAAE,WAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,UAAU;IAC1C,YAAY,OAAe,EAAE,WAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,OAAe,EAAE,WAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,WAAW,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,UAAU;IACxC,YAAY,OAAe,EAAE,WAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}

package/dist/utils/fs.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Check if a file exists
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Check if a directory exists
+ */
+export declare function directoryExists(dirPath: string): Promise<boolean>;
+/**
+ * Synchronously check if a file exists (for convenience)
+ */
+export declare function fileExistsSync(filePath: string): boolean;
+/**
+ * Validate a file path to prevent directory traversal attacks
+ * @throws {FileSystemError} If path contains directory traversal patterns
+ */
+export declare function validatePath(basePath: string, targetPath: string): string;
+/**
+ * Recursively collect files matching a pattern
+ */
+export declare function collectFiles(dirPath: string, pattern?: RegExp): Promise<string[]>;
+/**
+ * Read a file as text
+ */
+export declare function readTextFile(filePath: string): Promise<string>;
+/**
+ * Ensure a directory exists, creating it if necessary
+ */
+export declare function ensureDirectory(dirPath: string): Promise<void>;
+/**
+ * Get the size of a file in bytes
+ */
+export declare function getFileSize(filePath: string): Promise<number>;
+/**
+ * Check if a path is a directory
+ */
+export declare function isDirectory(path: string): Promise<boolean>;
+/**
+ * Check if a path is a file
+ */
+export declare function isFile(path: string): Promise<boolean>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOvE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAYzE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAa,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBnB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASpE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASpE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUnE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOhE;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO3D"}