throw new IOException("Failed to access " + url, e);
            }
        }

        /**
         * Gets the object statistics from the storage service.
         * This method caches the response to avoid repeated calls.
         *
         * @return The object statistics response
         * @throws InvalidKeyException If the access key is invalid
         * @throws ErrorResponseException If the server returns an error

- ✅ Consistent `validateInputStream()` usage
- ✅ Reduced code duplication
- ✅ Clear exception messages

### 3. Error Handling
- ✅ Archive extractors continue on partial failures
- ✅ Processing statistics in error messages
- ✅ Specific file names in error logs

### 4. Error Messages
- ✅ Encoding information in TextExtractor errors
- ✅ File type context in MS Office errors

/**
 * Helper class for crawler logging operations.
 * Extends LogHelperImpl to provide specialized logging functionality for crawler operations,
 * including failure URL tracking and crawler statistics integration.
 */
public class CrawlerLogHelper extends LogHelperImpl {

    /**
     * Creates a new instance of CrawlerLogHelper.
     */
    public CrawlerLogHelper() {
        super();
    }

        }
    }

    /**
     * Sends email notification with crawling results and statistics.
     * The email contains detailed information about the crawling session including
     * execution times, index sizes, and status information.
     *
     * @param infoMap map containing crawling session information and statistics
     */
    protected void sendMail(final Map<String, String> infoMap) {

    public static final String USER_CODE = "userCode";

    /** Search query field name for logging. */
    public static final String SEARCH_FIELD_LOG_SEARCH_QUERY = "q";

    /** Statistics report type parameter name. */
    public static final String STATS_REPORT_TYPE = "reportType";

    /** Result document ID cache key. */
    public static final String RESULT_DOC_ID_CACHE = "resultDocIds";

     *   <li>Manages concurrent execution based on thread count limits</li>
     *   <li>Monitors thread completion and handles cleanup</li>
     *   <li>Records execution timing and statistics</li>
     * </ul>
     *
     * @param sessionId unique identifier for this crawling session
     * @param configList list of data configurations to crawl
     */