@within-7/minto 0.1.7 → 0.2.0

package/scripts/postinstall.js

@@ -1,11 +1,27 @@
 #!/usr/bin/env node
 
+/**
+ * Minto Post-Install Script
+ *
+ * This script runs after npm install to:
+ * 1. Check if the platform-specific binary was installed
+ * 2. Display helpful getting-started information
+ *
+ * The binary is installed automatically via optionalDependencies.
+ * If it fails (e.g., unsupported platform), we fall back to JS mode.
+ */
+
 const fs = require('fs');
 const path = require('path');
 
+const PACKAGE_ROOT = path.join(__dirname, '..');
+
+/**
+ * Get the package version from package.json
+ */
 function getPackageVersion() {
   try {
-    const pkgPath = path.join(__dirname, '..', 'package.json');
+    const pkgPath = path.join(PACKAGE_ROOT, 'package.json');
     const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
     return pkg.version;
   } catch {
@@ -13,50 +29,124 @@ function getPackageVersion() {
   }
 }
 
-function postinstallNotice() {
-  // Only print informational hints; never fail install.
-  // Use console.error (stderr) to ensure output is visible in npm install
-  try {
-    const version = getPackageVersion();
-    const isGlobal = process.env.npm_config_global === 'true';
+/**
+ * Get the expected package name for this platform
+ */
+function getPlatformPackageName() {
+  const platform = process.platform; // darwin, linux, win32
+  const arch = process.arch; // arm64, x64
+  return `@within-7/minto-${platform}-${arch}`;
+}
 
-    console.error('');
-    console.error('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    console.error('');
-    console.error('  ✨ Minto installed successfully!');
-    console.error('  📦 Version: ' + version);
-    console.error('');
-    console.error('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    console.error('');
-    console.error('  🚀 Quick Start:');
-    console.error('');
+/**
+ * Check if the platform binary package was installed
+ */
+function checkBinaryInstalled() {
+  const packageName = getPlatformPackageName();
+  const binaryName = process.platform === 'win32' ? 'minto.exe' : 'minto';
+
+  // Check possible installation locations
+  const possiblePaths = [
+    // Standard npm install location
+    path.join(PACKAGE_ROOT, 'node_modules', packageName, binaryName),
+    // Hoisted location
+    path.join(PACKAGE_ROOT, '..', packageName, binaryName),
+    // Global install
+    path.join(PACKAGE_ROOT, '..', '..', packageName, binaryName),
+  ];
 
-    if (isGlobal) {
-      console.error('     minto              # Start interactive mode');
-      console.error('     minto --help       # Show all commands');
-      console.error('     mt                 # Short alias for minto');
-    } else {
-      console.error('     npx minto          # Start interactive mode');
-      console.error('     npx minto --help   # Show all commands');
+  for (const binaryPath of possiblePaths) {
+    if (fs.existsSync(binaryPath)) {
+      // Ensure executable permission on Unix
+      if (process.platform !== 'win32') {
+        try {
+          fs.chmodSync(binaryPath, 0o755);
+        } catch {
+          // Ignore permission errors
+        }
+      }
+      return {
+        installed: true,
+        path: binaryPath,
+        packageName,
+      };
     }
+  }
 
+  return {
+    installed: false,
+    packageName,
+  };
+}
+
+/**
+ * Display installation success message
+ */
+function displaySuccessMessage(binaryStatus) {
+  const version = getPackageVersion();
+  const isGlobal = process.env.npm_config_global === 'true';
+
+  console.error('');
+  console.error('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.error('');
+  console.error('  ✨ Minto 安装成功！');
+  console.error('  📦 版本: ' + version);
+
+  if (binaryStatus.installed) {
+    console.error('  🚀 运行模式: 原生二进制 (最佳性能)');
+  } else {
+    console.error('  📋 运行模式: JavaScript');
+    console.error('  💡 提示: 原生二进制不可用，将使用 JS 回退模式');
+  }
+
+  console.error('');
+  console.error('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.error('');
+  console.error('  🚀 快速开始:');
+  console.error('');
+
+  if (isGlobal) {
+    console.error('     minto              # 启动交互模式');
+    console.error('     minto --help       # 查看所有命令');
+  } else {
+    console.error('     npx minto          # 启动交互模式');
+    console.error('     npx minto --help   # 查看所有命令');
+  }
+
+  console.error('');
+  console.error('  📚 文档: https://within-7.com/minto');
+  console.error('  🐛 问题反馈: https://github.com/within-7/minto/issues');
+  console.error('');
+  console.error('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.error('');
+
+  if (!isGlobal) {
+    console.error('  💡 提示: 全局安装可以更方便地使用:');
+    console.error('     npm install -g @within-7/minto');
     console.error('');
-    console.error('  📚 Documentation: https://within-7.com/minto');
-    console.error('  🐛 Issues: https://github.com/within-7/minto/issues');
-    console.error('');
-    console.error('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    console.error('');
+  }
+}
 
-    if (!isGlobal) {
-      console.error('  💡 Tip: Install globally for easier access:');
-      console.error('     npm install -g @within-7/minto');
-      console.error('');
-    }
+/**
+ * Main postinstall function
+ */
+function postinstall() {
+  // Only run during actual npm postinstall
+  if (process.env.npm_lifecycle_event !== 'postinstall') {
+    return;
+  }
+
+  try {
+    // Check if binary was installed
+    const binaryStatus = checkBinaryInstalled();
+
+    // Display success message
+    displaySuccessMessage(binaryStatus);
   } catch (err) {
-    // Silently fail - postinstall should never break the installation
+    // Silently fail - postinstall should never break installation
+    // Users can still use JavaScript fallback mode
   }
 }
 
-if (process.env.npm_lifecycle_event === 'postinstall') {
-  postinstallNotice();
-}
+// Run postinstall
+postinstall();