@haptiq/kit 0.4.0 → 0.5.0

package/lib/ship.js

@@ -7,6 +7,7 @@
  */
 import { spawn } from 'child_process';
 import { existsSync } from 'fs';
+import readline from 'readline';
 import path from 'path';
 import { buildCSS } from './css.js';
 import { buildJS } from './js.js';
@@ -104,21 +105,120 @@ async function shipSingleTarget(name, targetConfig, shipConfig, verbose) {
 
 	const normalizedSrc = src.endsWith('/') ? src : `${src}/`;
 
+	const excludeArgs = exclude.flatMap(e => ['--exclude', e]);
+	const deleteArgs = deleteRemoved ? ['--delete', '--delete-excluded'] : [];
+
 	const args = [
 		'-az',
 		...(verbose ? ['-v'] : []),
-		...exclude.flatMap(e => ['--exclude', e]),
-		...(deleteRemoved ? ['--delete', '--delete-excluded'] : []),
+		...excludeArgs,
+		...deleteArgs,
 		normalizedSrc,
 		destination,
 	];
 
 	console.log(`🚀 Shipping [${name}] → ${destination}`);
 
+	if (deleteRemoved) {
+		const dryRunArgs = ['-azv', '-n', ...excludeArgs, ...deleteArgs, normalizedSrc, destination];
+		const deletions = await rsyncDryRun(dryRunArgs);
+		if (deletions.length > 0) {
+			await confirmDeletion(deletions, destination);
+		}
+	}
+
 	await spawnRsync(args, verbose);
 }
 
 
+/**
+ * Run rsync in dry-run mode and return the list of files that would be deleted.
+ *
+ * @param {string[]} args - rsync arguments (must include -n and -v)
+ * @returns {Promise<string[]>}
+ */
+function rsyncDryRun(args) {
+	return new Promise((resolve, reject) => {
+		const childProcess = spawn('rsync', args, { shell: false });
+
+		let stdout = '';
+		let stderr = '';
+
+		childProcess.stdout.on('data', (data) => { stdout += data.toString(); });
+		childProcess.stderr.on('data', (data) => { stderr += data.toString(); });
+
+		childProcess.on('close', (code) => {
+			if (code === 0) {
+				const deletions = stdout
+					.split('\n')
+					.filter(line => line.startsWith('deleting '))
+					.map(line => line.slice('deleting '.length).trim());
+				resolve(deletions);
+			} else {
+				reject(new Error(`rsync dry-run failed: ${stderr.trim()}`));
+			}
+		});
+
+		childProcess.on('error', (err) => {
+			if (err.code === 'ENOENT') {
+				reject(new Error('rsync not found. Please ensure rsync is installed on your system.'));
+			} else {
+				reject(new Error(`Failed to start rsync: ${err.message}`));
+			}
+		});
+	});
+}
+
+
+/**
+ * Show a deletion preview and require the user to type DELETE to continue.
+ *
+ * @param {string[]} deletions - Files that would be deleted
+ * @param {string} destination - Rsync destination (shown in the warning)
+ * @returns {Promise<void>}
+ */
+async function confirmDeletion(deletions, destination) {
+	const count = deletions.length;
+	const shown = deletions.slice(0, 7);
+
+	console.log(`\n⚠️  ${count} ${count === 1 ? 'file' : 'files'} will be permanently deleted from:`);
+	console.log(`    ${destination}\n`);
+
+	for (const file of shown) {
+		console.log(`    - ${file}`);
+	}
+
+	if (count > 7) {
+		console.log(`    … and ${count - 7} more files.`);
+	}
+
+	console.log('\nWARNING: These files will be removed irrevocably!\n');
+	console.log('To proceed, type DELETE and press Enter (Ctrl+C to abort):');
+
+	const answer = await readLine();
+
+	if (answer !== 'DELETE') {
+		throw new Error('Aborted — sync cancelled.');
+	}
+}
+
+
+/**
+ * Read a single line from stdin.
+ *
+ * @returns {Promise<string>}
+ */
+function readLine() {
+	return new Promise((resolve) => {
+		const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+		rl.question('', (answer) => {
+			rl.close();
+			resolve(answer);
+		});
+	});
+}
+
+
 /**
  * Spawn rsync as a child process without shell interpolation
  *

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@haptiq/kit",
-	"version": "0.4.0",
+	"version": "0.5.0",
 	"description": "Build tools for Haptiq projects.",
 	"keywords": [
 		"build",