fix: Ensure DANFSE artifacts are correctly generated with improved error logging

[vitormattos]

Problem

In production, DANFSE (PDF) generation failed intermittently:

1. Certificate files were deleted before being used by the gateway client
2. HTTP 400 errors from gateway with insufficient error context
3. Production environments with restricted /dev/shm access failed silently

Root Causes

Certificate Cleanup Timing

Transport certificates (/dev/shm/nfse_tls_cert_*) were deleted before storeArtifacts() completed:

1. makeClient() → creates cert files
2. try block completes → finally deletes certs ❌
3. storeArtifacts() → getDanfse() fails (certs gone)

Limited Error Visibility

Gateway HTTP 400 errors lacked debugging context:

• No exception class/code information
• No stack trace showing failure point
• No XML payload details

Directory Availability Issues

/dev/shm may be unavailable in some production environments.

Solutions Implemented

1. Smart Temporary Directory Selection

// Try /dev/shm first (fast, in-memory)
// Fallback to sys_get_temp_dir() if unavailable
// Better error messaging listing both checked directories

2. Fixed Cleanup Sequencing

Moved cleanup to AFTER all client operations complete:

• emit(): Cleanup after storeArtifacts() completes
• refresh(): Cleanup after storeArtifacts() completes
• reemit(): Cleanup after storeArtifacts() completes

3. Comprehensive Error Logging

Capture complete exception information:

• exception_class: The exception type
• exception_message: Error message
• exception_code: Error code
• trace: Full stack trace
• rawXml_length & rawXml_sample: XML payload details

Testing

• New test: TransportCertificateCleanupTest validates certificate availability during DANFSE generation
• Updated existing tests to match corrected behavior
• All tests pass

Changes

• ✅ Support/TransportCertificateManager.php: Fallback directory logic
• ✅ Http/Controllers/InvoiceController.php: Cleanup sequencing + enhanced logging
• ✅ tests/Unit/Http/Controllers/TransportCertificateCleanupTest.php: New test
• ✅ tests/Unit/Http/Controllers/InvoiceControllerTest.php: Updated test assertions