feat: add comprehensive diagnostics to debug TypeScript declaration issue

- Add platform, Node, and TypeScript version logging

- List dist directory contents before and after attempts

- Check for TypeScript errors explicitly

- Try multiple fallback strategies including CommonJS

- Add detailed file verification with sizes

Author: cynarlab

packages/shared/scripts/ensure-declarations.cjs

@@ -11,13 +11,67 @@ const fs = require('fs');
 const path = require('path');
 const { execSync } = require('child_process');
 
+// Diagnostic information
+console.log('🔍 Diagnostic Information:');
+console.log('   Node version:', process.version);
+console.log('   Platform:', process.platform);
+console.log('   Architecture:', process.arch);
+console.log('   Current directory:', process.cwd());
+console.log('   Script directory:', __dirname);
+
+// Get TypeScript version
+try {
+  const tscVersion = execSync('npx tsc --version', { encoding: 'utf8' }).trim();
+  console.log('   TypeScript version:', tscVersion);
+} catch (e) {
+  console.log('   TypeScript version: Could not determine');
+}
+
 const distDir = path.join(__dirname, '..', 'dist');
 const indexDtsPath = path.join(distDir, 'index.d.ts');
 
+// List what's in dist directory before trying fallbacks
+console.log('\n📁 Contents of dist directory:');
+if (fs.existsSync(distDir)) {
+  const files = fs.readdirSync(distDir);
+  files.forEach(file => {
+    const stats = fs.statSync(path.join(distDir, file));
+    console.log(`   ${file} (${stats.isDirectory() ? 'directory' : stats.size + ' bytes'})`);
+  });
+} else {
+  console.log('   dist directory does not exist!');
+}
+
 // Check if index.d.ts exists
 if (!fs.existsSync(indexDtsPath)) {
-  console.log('⚠️  Declaration files not generated by normal build.');
-  console.log('📝 Attempting alternative declaration generation...');
+  console.log('\n⚠️  Declaration files not generated by normal build.');
+  
+  // Run tsc with diagnostics to see what's happening
+  console.log('\n🔍 Running TypeScript with diagnostics...');
+  try {
+    const diagnostics = execSync('npx tsc --listFiles --noEmit', {
+      cwd: path.join(__dirname, '..'),
+      encoding: 'utf8'
+    });
+    const fileCount = diagnostics.split('\n').filter(line => line.trim()).length;
+    console.log(`   TypeScript processed ${fileCount} files`);
+  } catch (e) {
+    console.log('   TypeScript diagnostics failed:', e.message);
+  }
+  
+  // Check for TypeScript errors
+  console.log('\n🔍 Checking for TypeScript errors...');
+  try {
+    execSync('npx tsc --noEmit', {
+      cwd: path.join(__dirname, '..'),
+      stdio: 'pipe'
+    });
+    console.log('   No TypeScript errors found');
+  } catch (e) {
+    console.log('   TypeScript errors detected:', e.stdout ? e.stdout.toString() : e.message);
+  }
+  
+  console.log('\n📝 Attempting alternative declaration generation...');
 
   try {
     // Try building with different settings
@@ -31,25 +85,47 @@ if (!fs.existsSync(indexDtsPath)) {
       console.log('✅ Declaration files generated successfully via fallback!');
     } else {
       // If still no declarations, try one more approach
-      console.log('   Trying with allowJs and checkJs disabled...');
-      execSync('npx tsc --declaration --declarationMap --outDir dist --allowJs false --checkJs false', {
+      console.log('   Trying with module commonjs...');
+      execSync('npx tsc --declaration --module commonjs --outDir dist', {
         cwd: path.join(__dirname, '..'),
         stdio: 'inherit'
       });
 
       if (fs.existsSync(indexDtsPath)) {
         console.log('✅ Declaration files generated successfully via second fallback!');
       } else {
-        console.error('❌ Failed to generate declaration files after all attempts.');
-        process.exit(1);
+        // Last resort - try with a minimal config
+        console.log('   Trying with minimal config...');
+        execSync('npx tsc src/index.ts --declaration --outDir dist --moduleResolution node --module commonjs', {
+          cwd: path.join(__dirname, '..'),
+          stdio: 'inherit'
+        });
+        
+        if (fs.existsSync(indexDtsPath)) {
+          console.log('✅ Declaration files generated successfully via third fallback!');
+        } else {
+          console.error('\n❌ Failed to generate declaration files after all attempts.');
+          
+          // Final diagnostic - list what files were actually created
+          console.log('\n📁 Final contents of dist directory:');
+          if (fs.existsSync(distDir)) {
+            const files = fs.readdirSync(distDir);
+            files.forEach(file => {
+              const stats = fs.statSync(path.join(distDir, file));
+              console.log(`   ${file} (${stats.isDirectory() ? 'directory' : stats.size + ' bytes'})`);
+            });
+          }
+          
+          process.exit(1);
+        }
       }
     }
   } catch (error) {
     console.error('❌ Error during fallback declaration generation:', error.message);
     process.exit(1);
   }
 } else {
-  console.log('✅ Declaration files already exist.');
+  console.log('\n✅ Declaration files already exist.');
 }
 
 // Verify all expected declaration files exist
@@ -63,18 +139,22 @@ const expectedFiles = [
   'models/index.d.ts'
 ];
 
+console.log('\n📋 Verifying expected declaration files...');
 let allFilesExist = true;
 for (const file of expectedFiles) {
   const filePath = path.join(distDir, file);
   if (!fs.existsSync(filePath)) {
-    console.error(`❌ Missing declaration file: ${file}`);
+    console.error(`   ❌ Missing: ${file}`);
     allFilesExist = false;
+  } else {
+    const stats = fs.statSync(filePath);
+    console.log(`   ✅ Found: ${file} (${stats.size} bytes)`);
   }
 }
 
 if (!allFilesExist) {
-  console.error('❌ Some declaration files are missing!');
+  console.error('\n❌ Some declaration files are missing!');
   process.exit(1);
 }
 
-console.log('✅ All declaration files verified successfully!');
+console.log('\n✅ All declaration files verified successfully!');