feat: add update notifier, better errors, and debug mode v0.3.0

- Add update-notifier to alert users of new versions
- Add typo suggestions using fuzzy matching (fastest-levenshtein)
- Add debug mode with --verbose flag for detailed logging
- Fix ES module issues by using CommonJS for CLI tool
- Test confirmed: hello-world setup works correctly

Author: Olanetsoft

package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-mn-app",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "description": "Create Midnight Network applications with zero configuration",
   "main": "dist/index.js",
   "bin": {
@@ -34,11 +34,13 @@
     "chalk": "^4.1.2",
     "commander": "^11.0.0",
     "cross-spawn": "^7.0.3",
+    "fastest-levenshtein": "^1.0.16",
     "fs-extra": "^11.1.1",
     "mustache": "^4.2.0",
     "ora": "^5.4.1",
     "prompts": "^2.4.2",
     "semver": "^7.5.4",
+    "update-notifier": "^7.3.1",
     "validate-npm-package-name": "^5.0.0"
   },
   "devDependencies": {
@@ -47,6 +49,7 @@
     "@types/mustache": "^4.2.2",
     "@types/node": "^20.0.0",
     "@types/prompts": "^2.4.9",
+    "@types/update-notifier": "^6.0.8",
     "@types/validate-npm-package-name": "^4.0.2",
     "typescript": "^5.0.0"
   },

src/cli.ts

@@ -1,7 +1,19 @@
 import { Command } from "commander";
 import chalk from "chalk";
-import { createApp } from "./create-app.js";
-import { ErrorHandler } from "./utils/error-handler.js";
+import updateNotifier from "update-notifier";
+import { createApp } from "./create-app";
+import { ErrorHandler } from "./utils/error-handler";
+import * as path from "path";
+import * as fs from "fs";
+
+const pkg = JSON.parse(
+  fs.readFileSync(path.join(__dirname, "../package.json"), "utf-8")
+);
+
+// Check for updates
+updateNotifier({ pkg, updateCheckInterval: 1000 * 60 * 60 * 24 }).notify({
+  isGlobal: true,
+});
 
 const program = new Command();
 
@@ -11,7 +23,7 @@ ErrorHandler.checkNodeVersion(22);
 program
   .name("create-mn-app")
   .description("Create a new Midnight Network application")
-  .version("0.2.4")
+  .version("0.3.0")
   .argument("[project-directory]", "Directory name for your project")
   .option(
     "-t, --template <name>",
@@ -25,7 +37,7 @@ program
   .option("--skip-git", "Skip git repository initialization")
   .option("--verbose", "Show detailed output")
   .action(async (projectDirectory, options) => {
-    console.log(chalk.bold.cyan("\ncreate-mn-app") + chalk.gray(" v0.2.4\n"));
+    console.log(chalk.bold.cyan("\ncreate-mn-app") + chalk.gray(" v0.3.0\n"));
 
     try {
       await createApp(projectDirectory, options);

src/create-app.ts

@@ -3,6 +3,7 @@ import fs from "fs-extra";
 import chalk from "chalk";
 import ora from "ora";
 import prompts from "prompts";
+import { distance } from "fastest-levenshtein";
 import { validateProjectName } from "./utils/validation.js";
 import { PackageInstaller } from "./installers/package-installer.js";
 import { TemplateManager } from "./utils/template-manager.js";
@@ -12,6 +13,7 @@ import { GitUtils } from "./utils/git-utils.js";
 import { GitCloner } from "./utils/git-cloner.js";
 import { RequirementChecker } from "./utils/requirement-checker.js";
 import { SetupGuide } from "./utils/setup-guide.js";
+import { debug, enableDebug } from "./utils/debug.js";
 import {
   detectPackageManager,
   getPackageManagerInfo,
@@ -34,14 +36,46 @@ export interface CreateAppOptions {
   verbose?: boolean;
 }
 
+/**
+ * Find the closest matching template name for typo suggestions
+ */
+function findSimilarTemplate(input: string): string | null {
+  const templates = getAllTemplates()
+    .filter((t) => t.available)
+    .map((t) => t.name);
+
+  let closest = templates[0];
+  let minDistance = distance(input.toLowerCase(), closest.toLowerCase());
+
+  for (const template of templates) {
+    const d = distance(input.toLowerCase(), template.toLowerCase());
+    if (d < minDistance) {
+      minDistance = d;
+      closest = template;
+    }
+  }
+
+  // Only suggest if it's close enough (threshold: 3 characters difference)
+  return minDistance <= 3 ? closest : null;
+}
+
 export async function createApp(
   projectDirectory: string | undefined,
   options: CreateAppOptions
 ): Promise<void> {
+  // Enable debug mode if verbose flag is set
+  if (options.verbose) {
+    enableDebug();
+    debug("Debug mode enabled");
+    debug("Options:", options);
+  }
+
   let projectName = projectDirectory;
   let selectedTemplate = options.template || "hello-world";
   let packageManager: PackageManager;
 
+  debug("Starting project creation", { projectName, selectedTemplate });
+
   // Interactive mode if no project name provided
   if (!projectName) {
     const response = await prompts({
@@ -96,7 +130,7 @@ export async function createApp(
     const template = getTemplate(selectedTemplate);
     if (template && template.comingSoon) {
       console.error(
-        chalk.red(`✖ Template "${selectedTemplate}" is coming soon!`)
+        chalk.red(`\n✖ Template "${selectedTemplate}" is coming soon!`)
       );
       console.log(chalk.yellow("\n📢 Available templates:"));
       getAllTemplates()
@@ -105,31 +139,53 @@ export async function createApp(
           console.log(`  • ${chalk.cyan(t.name)} - ${t.description}`);
         });
     } else {
-      console.error(chalk.red(`✖ Template "${selectedTemplate}" not found.`));
+      console.error(chalk.red(`\n✖ Template "${selectedTemplate}" not found.`));
+
+      // Suggest similar template if typo detected
+      const suggestion = findSimilarTemplate(selectedTemplate);
+      if (suggestion) {
+        console.log(
+          chalk.yellow(`\n💡 Did you mean "${chalk.cyan(suggestion)}"?`)
+        );
+      }
+
+      console.log(chalk.gray("\nAvailable templates:"));
+      getAllTemplates()
+        .filter((t) => t.available)
+        .forEach((t) => {
+          console.log(`  • ${chalk.cyan(t.name)} - ${t.description}`);
+        });
     }
     process.exit(1);
   }
 
   // Detect or select package manager
   if (options.useNpm) {
     packageManager = "npm";
+    debug("Package manager set to npm via --use-npm flag");
   } else if (options.useYarn) {
     packageManager = "yarn";
+    debug("Package manager set to yarn via --use-yarn flag");
   } else if (options.usePnpm) {
     packageManager = "pnpm";
+    debug("Package manager set to pnpm via --use-pnpm flag");
   } else if (options.useBun) {
     packageManager = "bun";
+    debug("Package manager set to bun via --use-bun flag");
   } else {
     packageManager = detectPackageManager();
+    debug("Auto-detected package manager:", packageManager);
     console.log(
       chalk.bold("[" + chalk.blue("i") + "] ") +
         chalk.gray(`package manager: ${chalk.cyan(packageManager)}\n`)
     );
   }
 
   const pmInfo = getPackageManagerInfo(packageManager);
+  debug("Package manager info:", pmInfo);
 
   const validation = validateProjectName(projectName!);
+  debug("Project name validation:", validation);
   if (!validation.valid) {
     console.error(
       chalk.red(`✖ Invalid project name: ${validation.problems![0]}`)
@@ -138,9 +194,11 @@ export async function createApp(
   }
 
   const projectPath = path.resolve(projectName!);
+  debug("Project path resolved:", projectPath);
 
   // Check if directory exists
   if (fs.existsSync(projectPath)) {
+    debug("Directory already exists, prompting for overwrite");
     const { overwrite } = await prompts({
       type: "confirm",
       name: "overwrite",

src/utils/debug.ts

@@ -0,0 +1,20 @@
+import chalk from "chalk";
+
+let debugEnabled = false;
+
+export function enableDebug() {
+  debugEnabled = true;
+}
+
+export function debug(message: string, data?: any) {
+  if (!debugEnabled) return;
+
+  console.log(chalk.gray("[debug]"), message);
+  if (data !== undefined) {
+    console.log(chalk.gray(JSON.stringify(data, null, 2)));
+  }
+}
+
+export function isDebugEnabled(): boolean {
+  return debugEnabled;
+}

tsconfig.json

@@ -2,6 +2,7 @@
   "compilerOptions": {
     "target": "ES2020",
     "module": "CommonJS",
+    "moduleResolution": "node",
     "lib": ["ES2020"],
     "outDir": "./dist",
     "rootDir": "./src",