Fix crypto module loading issue with pnpm and add integration tests

[robdimarco-atxp]

Summary

Fixes the crypto module loading issue that was causing "Cannot find module 'crypto'" errors when using pnpm, and adds comprehensive integration tests to prevent future regressions.

🐛 Problem Resolved

• Issue: NOV-174 - "Cannot find module 'crypto'" error when using pnpm
• Root Cause: eval('require') pattern failing in certain runtime environments
• Impact: Crypto functionality (UUID generation, hashing) completely broken with pnpm

✅ Solution Implemented

1. Enhanced Crypto Module Loading (packages/atxp-common/src/platform/index.ts)

• Improved module loading: Try standard require before falling back to eval('require')
• Web Crypto API preference: Use globalThis.crypto when available (Node.js 16+)
• Node.js protocol support: Added node:crypto imports for better explicit resolution
• Cross-environment compatibility: Works in CommonJS, ESM, browser, and Node.js environments

2. Comprehensive Integration Test Suite

• File: packages/atxp-common/src/platform/packageManager.integration.test.ts
• Tests all major package managers: npm, pnpm, yarn, bun
• Real-world validation: Actually installs and tests published package as external consumer
• Complete crypto validation: UUID generation, SHA-256 hashing, hex encoding, environment detection

3. Automated CI/CD Testing

• GitHub Actions workflow: .github/workflows/package-manager-integration.yml
• Matrix testing: Node.js 18/20/22 × Linux/macOS/Windows
• Automatic triggers: Push/PR to main, crypto code changes
• Prevents broken releases: Required status checks

4. Documentation & Developer Experience

• Commands: npm run test:package-managers, npm run test:integration
• Comprehensive docs: docs/PACKAGE_MANAGER_TESTING.md
• README integration: Clear examples and explanations
• Troubleshooting guide: Common issues and debugging steps

🧪 Test Results

All package managers now work correctly:

Package Manager	Status	Crypto Functions
npm	✅ PASSED	All working
pnpm	✅ PASSED	All working
yarn	✅ PASSED	All working
bun	✅ PASSED	All working

🚀 Benefits

1. Immediate fix: pnpm users can now use crypto functionality without errors
2. Regression prevention: Integration tests catch issues before they reach users
3. Cross-platform confidence: Tested on Linux, macOS, Windows with multiple Node.js versions
4. Developer productivity: Clear test commands and documentation for contributors
5. Release safety: Automated CI prevents crypto regressions in future releases

📝 Breaking Changes

None - this is a backward-compatible fix that only improves existing functionality.

🔍 Verification Steps

Before (❌ Broken)

# With pnpm
pnpm install @atxp/common
# Error: Cannot find module 'crypto'

After (✅ Working)

# Test all package managers
npm run test:package-managers

# All crypto functions work correctly:
# ✅ randomUUID() - generates valid UUIDs
# ✅ digest() - SHA-256 hashing with expected outputs  
# ✅ toHex() - proper hex encoding
# ✅ Environment detection - correct Node.js/browser detection

🤖 Generated with Claude Code