create-harper 0.0.5 → 0.0.6

package/index.js

@@ -4,6 +4,7 @@ import mri from 'mri';
 import { helpMessage } from './lib/constants/helpMessage.js';
 import { formatTargetDir } from './lib/fs/formatTargetDir.js';
 import { pkgFromUserAgent } from './lib/pkg/pkgFromUserAgent.js';
+import { checkForUpdate } from './lib/steps/checkForUpdate.js';
 import { getEnvVars } from './lib/steps/getEnvVars.js';
 import { getExamples } from './lib/steps/getExamples.js';
 import { getImmediate } from './lib/steps/getImmediate.js';
@@ -38,6 +39,13 @@ async function init() {
 		return;
 	}
 
+	const currentVersion = await checkForUpdate();
+	const version = argv.version;
+	if (version) {
+		console.log(`Current version: ${currentVersion}`);
+		return;
+	}
+
 	const interactive = argInteractive ?? process.stdin.isTTY;
 
 	// Detect AI agent environment for better agent experience (AX)

package/lib/constants/helpMessage.js

@@ -16,6 +16,7 @@ Options:
   -t, --template NAME                   use a specific template
   -i, --immediate                       install dependencies and start dev
   --interactive / --no-interactive      force interactive / non-interactive mode
+  --version                             print out the version of the create-harper templates
 
 Available templates:
 ${yellow('vanilla-ts          vanilla')}

package/lib/pkg/getLatestVersion.js

@@ -0,0 +1,14 @@
+export async function getLatestVersion(packageName) {
+	try {
+		const response = await fetch(`https://registry.npmjs.org/${packageName}/latest`, {
+			signal: AbortSignal.timeout(1000), // 1 second timeout
+		});
+		if (!response.ok) {
+			return null;
+		}
+		const data = await response.json();
+		return data.version;
+	} catch (error) {
+		return null;
+	}
+}

package/lib/pkg/isVersionNewer.js

@@ -0,0 +1,17 @@
+/**
+ * Simple semver comparison for x.y.z
+ * @param {string} latest
+ * @param {string} current
+ * @returns {boolean}
+ */
+export function isVersionNewer(latest, current) {
+	const l = latest.split('.').map(x => parseInt(x, 10));
+	const c = current.split('.').map(x => parseInt(x, 10));
+
+	for (let i = 0; i < 3; i++) {
+		if (isNaN(l[i]) || isNaN(c[i])) { break; }
+		if (l[i] > c[i]) { return true; }
+		if (l[i] < c[i]) { return false; }
+	}
+	return false;
+}

package/lib/steps/checkForUpdate.js

@@ -0,0 +1,43 @@
+import spawn from 'cross-spawn';
+import fs from 'node:fs';
+import pc from 'picocolors';
+import { getLatestVersion } from '../pkg/getLatestVersion.js';
+import { isVersionNewer } from '../pkg/isVersionNewer.js';
+
+/**
+ * Checks if the current version of the package is the latest version on npm.
+ * If not, it tries to re-run the command using npx with the @latest tag.
+ */
+export async function checkForUpdate() {
+	const pkg = JSON.parse(fs.readFileSync(new URL('../../package.json', import.meta.url), 'utf-8'));
+	const currentVersion = pkg.version;
+
+	if (process.env.CREATE_HARPER_SKIP_UPDATE) {
+		return currentVersion;
+	}
+
+	try {
+		const latestVersion = await getLatestVersion(pkg.name);
+
+		if (latestVersion && isVersionNewer(latestVersion, currentVersion)) {
+			console.log(
+				pc.yellow(
+					`\n  A new version of ${pc.bold(pkg.name)} is available! (${pc.dim(currentVersion)} -> ${
+						pc.green(latestVersion)
+					})`,
+				),
+			);
+			console.log(`  Automatically updating to the latest version...\n`);
+
+			const result = spawn.sync('npx', [`${pkg.name}@latest`, ...process.argv.slice(2)], {
+				stdio: 'inherit',
+			});
+
+			process.exit(result.status ?? 0);
+		}
+	} catch {
+		// Ignore errors, we don't want to block the user if the check fails
+	}
+
+	return currentVersion;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "create-harper",
-	"version": "0.0.5",
+	"version": "0.0.6",
 	"type": "module",
 	"author": {
 		"name": "HarperDB",