@haptiq/kit 0.4.0 → 0.6.0

package/bin/haptiq.kit.js

@@ -87,6 +87,14 @@ async function loadConfig(verbose = false) {
 				throw new Error('ship configuration must be an object');
 			}
 
+			if (config.ship.src !== undefined && (typeof config.ship.src !== 'string' || config.ship.src.trim() === '')) {
+				throw new Error('ship.src must be a non-empty string');
+			}
+
+			if (config.ship.exclude !== undefined && !Array.isArray(config.ship.exclude)) {
+				throw new Error('ship.exclude must be an array');
+			}
+
 			if (config.ship.targets) {
 				if (typeof config.ship.targets !== 'object' || Array.isArray(config.ship.targets)) {
 					throw new Error('ship.targets must be an object');
@@ -134,8 +142,8 @@ async function loadConfig(verbose = false) {
  */
 function createCommandHandler(taskName, taskFunction) {
 	return async (...args) => {
-		const options = args[args.length - 1];
-		const positionalArgs = args.slice(0, -1);
+		const options = args[args.length - 2];
+		const positionalArgs = args.slice(0, -2);
 		try {
 			const config = await loadConfig(options.verbose);
 			await taskFunction(config, options, ...positionalArgs);

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';
@@ -49,7 +50,7 @@ async function ship(config, verbose, options = {}) {
 
 	for (const name of targetsToProcess) {
 		const targetConfig = targets[name] ?? {};
-		const dev = cliDev || targetConfig.dev || false;
+		const dev = (cliDev ?? targetConfig.dev) ?? false;
 
 		await buildCSS(config, verbose, dev);
 		await buildJS(config, verbose, { dev });
@@ -104,21 +105,123 @@ 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 = '';
+		let rejected = false;
+
+		childProcess.stdout.on('data', (data) => { stdout += data.toString(); });
+		childProcess.stderr.on('data', (data) => { stderr += data.toString(); });
+
+		childProcess.on('close', (code) => {
+			if (rejected) return;
+			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) => {
+			rejected = true;
+			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
  *
@@ -131,6 +234,7 @@ function spawnRsync(args, verbose) {
 		const childProcess = spawn('rsync', args, { shell: false });
 
 		let stderr = '';
+		let rejected = false;
 
 		if (verbose) {
 			childProcess.stdout.on('data', (data) => process.stdout.write(data));
@@ -141,6 +245,7 @@ function spawnRsync(args, verbose) {
 		});
 
 		childProcess.on('close', (code) => {
+			if (rejected) return;
 			if (code === 0) {
 				resolve();
 			} else {
@@ -149,6 +254,7 @@ function spawnRsync(args, verbose) {
 		});
 
 		childProcess.on('error', (err) => {
+			rejected = true;
 			if (err.code === 'ENOENT') {
 				reject(new Error('rsync not found. Please ensure rsync is installed on your system.'));
 			} else {

package/package.json

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