@codyswann/lisa 1.0.0

package/dist/transaction/backup.js

@@ -0,0 +1,97 @@
+import * as fse from 'fs-extra';
+import { readdir, mkdtemp } from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { BackupError, RollbackError } from '../errors/index.js';
+/**
+ * Service for backing up and restoring files during operations
+ */
+export class BackupService {
+    backupDir = null;
+    destDir = '';
+    logger;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    async init(destDir) {
+        this.destDir = destDir;
+        this.backupDir = await mkdtemp(path.join(os.tmpdir(), 'lisa-backup-'));
+        this.logger.info(`Backup directory: ${this.backupDir}`);
+    }
+    async backup(absolutePath) {
+        if (!this.backupDir) {
+            throw new BackupError('backup', 'Backup service not initialized');
+        }
+        try {
+            if (await fse.pathExists(absolutePath)) {
+                const relativePath = path.relative(this.destDir, absolutePath);
+                const backupPath = path.join(this.backupDir, relativePath);
+                await fse.ensureDir(path.dirname(backupPath));
+                await fse.copy(absolutePath, backupPath);
+            }
+        }
+        catch (error) {
+            throw new BackupError('backup', `Failed to backup ${absolutePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async rollback() {
+        if (!this.backupDir || !(await fse.pathExists(this.backupDir))) {
+            throw new RollbackError('No backup directory available');
+        }
+        this.logger.warn('Rolling back changes...');
+        try {
+            // Find all backed up files and restore them
+            const files = await this.listFilesRecursive(this.backupDir);
+            for (const backupFile of files) {
+                const relativePath = path.relative(this.backupDir, backupFile);
+                const destFile = path.join(this.destDir, relativePath);
+                await fse.copy(backupFile, destFile);
+                this.logger.info(`Restored: ${relativePath}`);
+            }
+            await this.cleanup();
+            this.logger.success('Rollback complete');
+        }
+        catch (error) {
+            throw new RollbackError(`Failed to rollback: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async cleanup() {
+        if (this.backupDir && (await fse.pathExists(this.backupDir))) {
+            await fse.remove(this.backupDir);
+            this.backupDir = null;
+        }
+    }
+    async listFilesRecursive(dir) {
+        const files = [];
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                const subFiles = await this.listFilesRecursive(fullPath);
+                files.push(...subFiles);
+            }
+            else if (entry.isFile()) {
+                files.push(fullPath);
+            }
+        }
+        return files;
+    }
+}
+/**
+ * No-op backup service for dry-run mode
+ */
+export class DryRunBackupService {
+    async init(_destDir) {
+        // No-op
+    }
+    async backup(_absolutePath) {
+        // No-op
+    }
+    async rollback() {
+        // No-op
+    }
+    async cleanup() {
+        // No-op
+    }
+}
+//# sourceMappingURL=backup.js.map

package/dist/transaction/backup.js.map

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

package/dist/transaction/index.d.ts

@@ -0,0 +1,4 @@
+export type { IBackupService } from './backup.js';
+export { BackupService, DryRunBackupService } from './backup.js';
+export { Transaction, DryRunTransaction } from './transaction.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transaction/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/transaction/index.js

@@ -0,0 +1,3 @@
+export { BackupService, DryRunBackupService } from './backup.js';
+export { Transaction, DryRunTransaction } from './transaction.js';
+//# sourceMappingURL=index.js.map

package/dist/transaction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transaction/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/transaction/transaction.d.ts

@@ -0,0 +1,34 @@
+import type { IBackupService } from './backup.js';
+import type { ILogger } from '../logging/index.js';
+/**
+ * Transaction wrapper for atomic operations
+ * Provides init → execute → cleanup/rollback pattern
+ */
+export declare class Transaction {
+    private readonly backupService;
+    private readonly logger;
+    private initialized;
+    constructor(backupService: IBackupService, logger: ILogger);
+    /**
+     * Initialize the transaction
+     */
+    init(destDir: string): Promise<void>;
+    /**
+     * Execute an operation within the transaction context
+     * Automatically rolls back on failure
+     */
+    execute<T>(operation: () => Promise<T>): Promise<T>;
+    /**
+     * Create a backup of a file within this transaction
+     */
+    backup(absolutePath: string): Promise<void>;
+}
+/**
+ * No-op transaction for dry-run mode
+ */
+export declare class DryRunTransaction {
+    init(_destDir: string): Promise<void>;
+    execute<T>(operation: () => Promise<T>): Promise<T>;
+    backup(_absolutePath: string): Promise<void>;
+}
+//# sourceMappingURL=transaction.d.ts.map

package/dist/transaction/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/transaction/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;GAGG;AACH,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,WAAW,CAAS;gBAGT,aAAa,EAAE,cAAc,EAC7B,MAAM,EAAE,OAAO;IAGlC;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C;;;OAGG;IACG,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA0BzD;;OAEG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMlD;AAED;;GAEG;AACH,qBAAa,iBAAiB;IACtB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAInD,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGnD"}

package/dist/transaction/transaction.js

@@ -0,0 +1,68 @@
+/**
+ * Transaction wrapper for atomic operations
+ * Provides init → execute → cleanup/rollback pattern
+ */
+export class Transaction {
+    backupService;
+    logger;
+    initialized = false;
+    constructor(backupService, logger) {
+        this.backupService = backupService;
+        this.logger = logger;
+    }
+    /**
+     * Initialize the transaction
+     */
+    async init(destDir) {
+        await this.backupService.init(destDir);
+        this.initialized = true;
+    }
+    /**
+     * Execute an operation within the transaction context
+     * Automatically rolls back on failure
+     */
+    async execute(operation) {
+        if (!this.initialized) {
+            throw new Error('Transaction not initialized');
+        }
+        try {
+            const result = await operation();
+            await this.backupService.cleanup();
+            return result;
+        }
+        catch (error) {
+            this.logger.error(`Operation failed: ${error instanceof Error ? error.message : String(error)}`);
+            try {
+                await this.backupService.rollback();
+            }
+            catch (rollbackError) {
+                this.logger.error(`Rollback also failed: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Create a backup of a file within this transaction
+     */
+    async backup(absolutePath) {
+        if (!this.initialized) {
+            throw new Error('Transaction not initialized');
+        }
+        await this.backupService.backup(absolutePath);
+    }
+}
+/**
+ * No-op transaction for dry-run mode
+ */
+export class DryRunTransaction {
+    async init(_destDir) {
+        // No-op
+    }
+    async execute(operation) {
+        return operation();
+    }
+    async backup(_absolutePath) {
+        // No-op
+    }
+}
+//# sourceMappingURL=transaction.js.map

package/dist/transaction/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../src/transaction/transaction.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,WAAW;IAIH;IACA;IAJX,WAAW,GAAG,KAAK,CAAC;IAE5B,YACmB,aAA6B,EAC7B,MAAe;QADf,kBAAa,GAAb,aAAa,CAAgB;QAC7B,WAAM,GAAN,MAAM,CAAS;IAC/B,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe;QACxB,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAI,SAA2B;QAC1C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YACnC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC9E,CAAC;YAEF,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;YACtC,CAAC;YAAC,OAAO,aAAa,EAAE,CAAC;gBACvB,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,yBAAyB,aAAa,YAAY,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAC1G,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,YAAoB;QAC/B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,QAAQ;IACV,CAAC;IAED,KAAK,CAAC,OAAO,CAAI,SAA2B;QAC1C,OAAO,SAAS,EAAE,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,aAAqB;QAChC,QAAQ;IACV,CAAC;CACF"}

package/dist/utils/file-operations.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Check if two files have identical content
+ */
+export declare function filesIdentical(path1: string, path2: string): Promise<boolean>;
+/**
+ * Ensure the parent directory of a file exists
+ */
+export declare function ensureParentDir(filePath: string): Promise<void>;
+/**
+ * Read file as UTF-8 string, returning null if file doesn't exist
+ */
+export declare function readFileOrNull(filePath: string): Promise<string | null>;
+/**
+ * Check if a path exists
+ */
+export declare function pathExists(filePath: string): Promise<boolean>;
+/**
+ * Check if a path is a file
+ */
+export declare function isFile(filePath: string): Promise<boolean>;
+/**
+ * Check if a path is a directory
+ */
+export declare function isDirectory(filePath: string): Promise<boolean>;
+/**
+ * List all files in a directory recursively
+ */
+export declare function listFilesRecursive(dir: string): Promise<string[]>;
+//# sourceMappingURL=file-operations.d.ts.map

package/dist/utils/file-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-operations.d.ts","sourceRoot":"","sources":["../../src/utils/file-operations.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnF;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAM7E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnE;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOpE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBvE"}

package/dist/utils/file-operations.js

@@ -0,0 +1,84 @@
+import * as fse from 'fs-extra';
+import { stat, readFile, readdir } from 'node:fs/promises';
+/**
+ * Check if two files have identical content
+ */
+export async function filesIdentical(path1, path2) {
+    try {
+        const [content1, content2] = await Promise.all([readFile(path1), readFile(path2)]);
+        return content1.equals(content2);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Ensure the parent directory of a file exists
+ */
+export async function ensureParentDir(filePath) {
+    await fse.ensureDir(filePath.substring(0, filePath.lastIndexOf('/')));
+}
+/**
+ * Read file as UTF-8 string, returning null if file doesn't exist
+ */
+export async function readFileOrNull(filePath) {
+    try {
+        return await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a path exists
+ */
+export async function pathExists(filePath) {
+    return fse.pathExists(filePath);
+}
+/**
+ * Check if a path is a file
+ */
+export async function isFile(filePath) {
+    try {
+        const stats = await stat(filePath);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a path is a directory
+ */
+export async function isDirectory(filePath) {
+    try {
+        const stats = await stat(filePath);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * List all files in a directory recursively
+ */
+export async function listFilesRecursive(dir) {
+    const files = [];
+    async function walk(currentDir) {
+        const entries = await readdir(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = `${currentDir}/${entry.name}`;
+            if (entry.isDirectory()) {
+                await walk(fullPath);
+            }
+            else if (entry.isFile()) {
+                files.push(fullPath);
+            }
+        }
+    }
+    if (await isDirectory(dir)) {
+        await walk(dir);
+    }
+    return files;
+}
+//# sourceMappingURL=file-operations.js.map

package/dist/utils/file-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-operations.js","sourceRoot":"","sources":["../../src/utils/file-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAa,EAAE,KAAa;IAC/D,IAAI,CAAC;QACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnF,OAAO,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,OAAO,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAW;IAClD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,UAAU,IAAI,CAAC,UAAkB;QACpC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,GAAG,UAAU,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAE/C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from './file-operations.js';
+export * from './json-utils.js';
+export * from './path-utils.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,4 @@
+export * from './file-operations.js';
+export * from './json-utils.js';
+export * from './path-utils.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/utils/json-utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Read and parse a JSON file
+ */
+export declare function readJson<T = unknown>(filePath: string): Promise<T>;
+/**
+ * Read JSON file, returning null if file doesn't exist or is invalid
+ */
+export declare function readJsonOrNull<T = unknown>(filePath: string): Promise<T | null>;
+/**
+ * Write object as JSON to a file
+ */
+export declare function writeJson(filePath: string, data: unknown, spaces?: number): Promise<void>;
+/**
+ * Check if a file contains valid JSON
+ */
+export declare function isValidJson(filePath: string): Promise<boolean>;
+/**
+ * Deep merge two objects (base values serve as defaults, override values take precedence)
+ * Uses lodash.merge for deep merging
+ */
+export declare function deepMerge<T extends object>(base: T, override: T): T;
+//# sourceMappingURL=json-utils.d.ts.map

package/dist/utils/json-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-utils.d.ts","sourceRoot":"","sources":["../../src/utils/json-utils.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAUxE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAMrF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1F;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOpE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAGnE"}

package/dist/utils/json-utils.js

@@ -0,0 +1,57 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import merge from 'lodash.merge';
+import { JsonParseError } from '../errors/index.js';
+/**
+ * Read and parse a JSON file
+ */
+export async function readJson(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new JsonParseError(filePath, error);
+        }
+        throw error;
+    }
+}
+/**
+ * Read JSON file, returning null if file doesn't exist or is invalid
+ */
+export async function readJsonOrNull(filePath) {
+    try {
+        return await readJson(filePath);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write object as JSON to a file
+ */
+export async function writeJson(filePath, data, spaces = 2) {
+    const content = JSON.stringify(data, null, spaces);
+    await writeFile(filePath, content + '\n', 'utf-8');
+}
+/**
+ * Check if a file contains valid JSON
+ */
+export async function isValidJson(filePath) {
+    try {
+        await readJson(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Deep merge two objects (base values serve as defaults, override values take precedence)
+ * Uses lodash.merge for deep merging
+ */
+export function deepMerge(base, override) {
+    // Create a new object to avoid mutating inputs
+    return merge({}, base, override);
+}
+//# sourceMappingURL=json-utils.js.map

package/dist/utils/json-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-utils.js","sourceRoot":"","sources":["../../src/utils/json-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,MAAM,cAAc,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAc,QAAgB;IAC1D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACjC,MAAM,IAAI,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAc,QAAgB;IAChE,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAI,QAAQ,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,IAAa,EAAE,MAAM,GAAG,CAAC;IACzE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAmB,IAAO,EAAE,QAAW;IAC9D,+CAA+C;IAC/C,OAAO,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAM,CAAC;AACxC,CAAC"}

package/dist/utils/path-utils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Resolve a path to an absolute path
+ */
+export declare function toAbsolutePath(inputPath: string): string;
+/**
+ * Get the relative path from base to target
+ */
+export declare function getRelativePath(basePath: string, targetPath: string): string;
+/**
+ * Join path segments
+ */
+export declare function joinPaths(...segments: string[]): string;
+/**
+ * Get the directory name of a path
+ */
+export declare function getDirname(filePath: string): string;
+/**
+ * Get the base name of a path
+ */
+export declare function getBasename(filePath: string): string;
+//# sourceMappingURL=path-utils.d.ts.map

package/dist/utils/path-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/utils/path-utils.js

@@ -0,0 +1,35 @@
+import * as path from 'node:path';
+/**
+ * Resolve a path to an absolute path
+ */
+export function toAbsolutePath(inputPath) {
+    if (path.isAbsolute(inputPath)) {
+        return inputPath;
+    }
+    return path.resolve(process.cwd(), inputPath);
+}
+/**
+ * Get the relative path from base to target
+ */
+export function getRelativePath(basePath, targetPath) {
+    return path.relative(basePath, targetPath);
+}
+/**
+ * Join path segments
+ */
+export function joinPaths(...segments) {
+    return path.join(...segments);
+}
+/**
+ * Get the directory name of a path
+ */
+export function getDirname(filePath) {
+    return path.dirname(filePath);
+}
+/**
+ * Get the base name of a path
+ */
+export function getBasename(filePath) {
+    return path.basename(filePath);
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/utils/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,UAAkB;IAClE,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,GAAG,QAAkB;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC"}