doc-fetch-cli 1.1.4 → 1.1.5

package/bin/postinstall.js

@@ -40,6 +40,7 @@ console.log(`📦 Will copy to: ${binaryName}\n`);
 
 // List all available binaries for debugging
 console.log('📋 Available binaries in package:');
+let hasPlatformBinary = false;
 try {
   const files = fs.readdirSync(packageDir);
   const binaries = files.filter(f => f.includes('doc-fetch') && !f.endsWith('.js'));
@@ -49,7 +50,12 @@ try {
     binaries.forEach(file => {
       const stats = fs.statSync(path.join(packageDir, file));
       const size = (stats.size / 1024 / 1024).toFixed(2);
-      console.log(`   ✅ ${file} (${size} MB)`);
+      const isCorrect = file === expectedBinary || file === binaryName;
+      const marker = isCorrect ? '✅' : 'ℹ️ ';
+      console.log(`   ${marker} ${file} (${size} MB)`);
+      if (file === expectedBinary) {
+        hasPlatformBinary = true;
+      }
     });
   }
 } catch (e) {
@@ -57,33 +63,30 @@ try {
 }
 console.log('');
 
-// Check if the expected binary exists
-if (!fs.existsSync(sourcePath)) {
-  console.error(`⚠️  CRITICAL: Expected binary not found at: ${sourcePath}`);
+// Extra validation: Check if platform binary exists
+if (!hasPlatformBinary && !fs.existsSync(sourcePath)) {
+  console.error('⚠️  CRITICAL: Platform binary missing!');
+  console.error(`   Expected: ${expectedBinary}`);
   console.error('');
-  console.error('💡 This might be because:');
-  console.error('   1. Your platform/architecture is not supported');
-  console.error('   2. The package was published without binaries');
+  console.error('💡 This is a packaging error - the NPM package was published without your platform binary.');
   console.error('');
-  console.error('Supported platforms:');
-  console.error('   ✅ Linux x64 (amd64)');
-  console.error('   ✅ Linux ARM64 (arm64)');
-  console.error('   ✅ macOS x64 (amd64)');
-  console.error('   ✅ macOS ARM64 (M1/M2)');
-  console.error('   ✅ Windows x64 (amd64)');
-  console.error('');
-  console.error('💡 Manual fix:');
-  console.error(`   1. Navigate to: ${packageDir}`);
-  console.error(`   2. Rename the correct binary for your platform:`);
+  console.error('💡 Immediate workaround - Install from source:');
+  console.error('   1. Install Go: https://golang.org/dl/');
+  console.error('   2. Run these commands:');
+  console.error('      npm uninstall -g doc-fetch-cli');
+  console.error('      git clone https://github.com/AlphaTechini/doc-fetch.git');
+  console.error('      cd doc-fetch');
   if (platform === 'win32') {
-    console.error(`      copy doc-fetch_windows_amd64.exe ${binaryName}`);
-  } else if (platform === 'darwin') {
-    console.error(`      cp doc-fetch_darwin_amd64 ${binaryName}`);
-    console.error(`      chmod +x ${binaryName}`);
+    console.error('      go build -o doc-fetch.exe ./cmd/docfetch');
+    console.error('      copy doc-fetch.exe "' + packageDir + '"');
   } else {
-    console.error(`      cp doc-fetch_linux_amd64 ${binaryName}`);
-    console.error(`      chmod +x ${binaryName}`);
+    console.error('      go build -o doc-fetch ./cmd/docfetch');
+    console.error('      cp doc-fetch "' + packageDir + '"');
+    console.error('      chmod +x "' + path.join(packageDir, 'doc-fetch') + '"');
   }
+  console.error('');
+  console.error('💡 Or wait for fixed version (check for updates):');
+  console.error('   npm install -g doc-fetch-cli@latest');
   process.exit(1);
 }
 

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "doc-fetch-cli",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "description": "Dynamic documentation fetching CLI that converts entire documentation sites to single markdown files for AI/LLM consumption",
   "bin": {
     "doc-fetch": "./bin/doc-fetch.js"
   },
   "scripts": {
-    "postinstall": "node ./bin/postinstall.js"
+    "prepublishOnly": "node ./scripts/verify-binaries.js",
+    "postinstall": "node ./bin/postinstall.js",
+    "verify": "node ./scripts/verify-binaries.js"
   },
   "repository": {
     "type": "git",

package/scripts/verify-binaries.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+/**
+ * Pre-publish verification script
+ * Ensures all platform binaries are present before publishing to NPM
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const packageDir = path.join(__dirname, '..');
+
+console.log('🔍 Verifying platform binaries before publish...\n');
+
+const requiredBinaries = [
+  { name: 'doc-fetch_linux_amd64', platform: 'linux', arch: 'x64' },
+  { name: 'doc-fetch_linux_arm64', platform: 'linux', arch: 'arm64', optional: true },
+  { name: 'doc-fetch_darwin_amd64', platform: 'darwin', arch: 'x64' },
+  { name: 'doc-fetch_darwin_arm64', platform: 'darwin', arch: 'arm64', optional: true },
+  { name: 'doc-fetch_windows_amd64.exe', platform: 'win32', arch: 'x64' },
+];
+
+let allPresent = true;
+const missing = [];
+const present = [];
+
+console.log('📦 Checking binaries:\n');
+
+requiredBinaries.forEach(binary => {
+  const binaryPath = path.join(packageDir, binary.name);
+  const exists = fs.existsSync(binaryPath);
+  
+  if (exists) {
+    const stats = fs.statSync(binaryPath);
+    const size = (stats.size / 1024 / 1024).toFixed(2);
+    console.log(`   ✅ ${binary.name.padEnd(35)} (${size} MB) - ${binary.platform} ${binary.arch}`);
+    present.push(binary.name);
+  } else {
+    const marker = binary.optional ? '⚠️ ' : '❌';
+    const note = binary.optional ? '(optional)' : '(REQUIRED)';
+    console.log(`   ${marker} ${binary.name.padEnd(35)} MISSING ${note}`);
+    if (!binary.optional) {
+      missing.push(binary.name);
+      allPresent = false;
+    }
+  }
+});
+
+console.log('\n📊 Summary:');
+console.log(`   Present:  ${present.length}`);
+console.log(`   Missing:  ${missing.length}${missing.length > 0 ? ' (' + missing.join(', ') + ')' : ''}`);
+console.log('');
+
+if (!allPresent) {
+  console.error('❌ CRITICAL: Required binaries are missing!');
+  console.error('');
+  console.error('💡 Build all platforms before publishing:');
+  console.error('');
+  console.error('   # Linux x64');
+  console.error('   GOOS=linux GOARCH=amd64 go build -o doc-fetch_linux_amd64 ./cmd/docfetch');
+  console.error('');
+  console.error('   # Linux ARM64 (optional)');
+  console.error('   GOOS=linux GOARCH=arm64 go build -o doc-fetch_linux_arm64 ./cmd/docfetch');
+  console.error('');
+  console.error('   # macOS Intel');
+  console.error('   GOOS=darwin GOARCH=amd64 go build -o doc-fetch_darwin_amd64 ./cmd/docfetch');
+  console.error('');
+  console.error('   # macOS Apple Silicon (optional)');
+  console.error('   GOOS=darwin GOARCH=arm64 go build -o doc-fetch_darwin_arm64 ./cmd/docfetch');
+  console.error('');
+  console.error('   # Windows x64');
+  console.error('   GOOS=windows GOARCH=amd64 go build -o doc-fetch_windows_amd64.exe ./cmd/docfetch');
+  console.error('');
+  console.error('Then run this script again to verify.');
+  console.error('');
+  process.exit(1);
+}
+
+// Verify minimum file sizes (catches corrupted/empty files)
+console.log('🔍 Verifying binary integrity...\n');
+
+let allValid = true;
+present.forEach(binaryName => {
+  const binaryPath = path.join(packageDir, binaryName);
+  const stats = fs.statSync(binaryPath);
+  
+  // Minimum expected size: 5MB (actual binaries are ~8-9MB)
+  const minSize = 5 * 1024 * 1024;
+  
+  if (stats.size < minSize) {
+    const sizeMB = (stats.size / 1024 / 1024).toFixed(2);
+    console.log(`   ⚠️  ${binaryName.padEnd(35)} Suspiciously small (${sizeMB} MB)`);
+    allValid = false;
+  } else {
+    const sizeMB = (stats.size / 1024 / 1024).toFixed(2);
+    console.log(`   ✅ ${binaryName.padEnd(35)} OK (${sizeMB} MB)`);
+  }
+});
+
+console.log('');
+
+if (!allValid) {
+  console.error('⚠️  Warning: Some binaries seem too small and may be corrupted.');
+  console.error('   Consider rebuilding them before publishing.\n');
+}
+
+// Final verdict
+if (allPresent && allValid) {
+  console.log('✅ All required binaries present and valid!');
+  console.log('✅ Ready to publish to NPM\n');
+  process.exit(0);
+} else if (allPresent) {
+  console.log('⚠️  All binaries present but some may be corrupted.');
+  console.log('⚠️  Proceed with caution!\n');
+  process.exit(0); // Allow publishing but warn
+} else {
+  process.exit(1);
+}