*
     * @param path the file path or URL of the document
     * @param docMap the document metadata map containing field values
     * @return a tuple containing the generator name, thumbnail ID, and path
     */
    @Override
    public Tuple3<String, String, String> createTask(final String path, final Map<String, Object> docMap) {
        final FessConfig fessConfig = ComponentUtil.getFessConfig();

        // when proper conditions are not met.

        Map<String, Object> docMap = new HashMap<>();

        // This will return false because getFessConfig() will fail
        // We verify the method handles the case gracefully
        try {
            emptyGenerator.isTarget(docMap);
        } catch (IllegalStateException e) {
            // Expected when container is not initialized

        generator = new TestThumbnailGenerator();
        Map<String, Object> docMap = new HashMap<>();
        docMap.put("id", "doc123");

        // Since createTask depends on FessConfig, it may not work properly
        // in unit tests without full container
        try {
            generator.createTask("/path/to/thumb.jpg", docMap);
        } catch (Exception e) {
            // Expected when FessConfig is not available

            if (source != null) {
                final Map<String, Object> docMap = new HashMap<>(source);
                docMap.put(fessConfig.getIndexFieldId(), hit.getId());
                docMap.put(fessConfig.getIndexFieldVersion(), hit.getVersion());
                docMap.put(fessConfig.getIndexFieldSeqNo(), hit.getSeqNo());
                docMap.put(fessConfig.getIndexFieldPrimaryTerm(), hit.getPrimaryTerm());

    }

    @Test
    public void test_calculateDocumentSize_withNullValue() {
        final Map<String, Object> docMap = new HashMap<>();
        docMap.put("id", "test");
        docMap.put("nullField", null);

        long size = indexingHelper.calculateDocumentSize(docMap);
        assertTrue(size > 0);
    }

     * Extracts and formats the site path from document URL.
     *
     * @param docMap the document data map
     * @return the formatted site path
     */
    public Object getSitePath(final Map<String, Object> docMap) {
        final FessConfig fessConfig = ComponentUtil.getFessConfig();
        final Object siteValue = docMap.get(fessConfig.getIndexFieldSite());
        if (siteValue != null) {