import jakarta.annotation.PreDestroy;

/**
 * Manager class for chat sessions.
 * Sessions are stored in memory with automatic expiration.
 *
 * <p><b>Note:</b> Sessions are stored in a local in-memory ConcurrentHashMap.
 * In multi-instance deployments (e.g., behind a load balancer), sessions are
 * not shared between instances. Use sticky sessions or an external session
 * store if session affinity across instances is required.</p>
 *

    }

    /**
     * Deletes crawling sessions that expired before the specified date.
     * Excludes the active session and optionally filters by name.
     * This method performs batch deletion of both parameters and session records.
     *
     * @param activeSessionId the session ID to exclude from deletion (can be null)
     * @param name optional name filter for sessions to delete (can be null or blank)

        logger.info("Number of crawling info logs before deletion: {}", sizeBeforeDeletion);

        // Delete all old crawling sessions
        deleteMethod("/api/admin/crawlinginfo/all").then().body("response.status", equalTo(0));
        refresh();

        // Verify all old sessions are deleted (size should be 0 after deletion)
        final List<Map<String, Object>> logListAfter = readCrawlingInfo(webConfigId);

import org.opensearch.search.aggregations.bucket.terms.TermsAggregationBuilder;

/**
 * Helper class for managing crawling information and statistics.
 * Provides functionality to track crawling sessions, manage document expiration,
 * and handle crawling information storage and retrieval.
 */
public class CrawlingInfoHelper {

    /**
     * Creates a new instance of CrawlingInfoHelper.
     */

 * This class handles user identification through cookies, session management, and query tracking.
 * It provides functionality for generating unique user codes, managing user sessions,
 * and tracking search result document IDs for analytics and personalization.
 *
 */
public class UserInfoHelper {

    /**
     * Default constructor for UserInfoHelper.
     */

    private TimeManager timeManager;

    /** The async manager for handling asynchronous operations. */
    @Resource
    private AsyncManager asyncManager;

    /** The session manager for handling user sessions. */
    @Resource
    private SessionManager sessionManager;

    /** The Fess configuration providing application settings. */
    @Resource
    private FessConfig fessConfig;

     * <li>Applies document boosting and metadata enhancements</li>
     * <li>Sends processed documents to the search engine</li>
     * <li>Cleans up processed data and manages crawler sessions</li>
     * </ul>
     *
     * <p>The method includes error handling, retry logic, and will terminate
     * if too many empty results are encountered or if a system shutdown is requested.
     */
    @Override

                }
            }
        }

        /**
         * Deletes old documents from the search index.
         * This method removes documents that were indexed in previous
         * crawling sessions for the same data configuration, keeping
         * only the documents from the current session.
         *
         * <p>The deletion process:</p>
         * <ul>

        indexUpdater.addFinishedSessionId(sessionId);
        assertTrue(indexUpdater.finishedSessionIdList.contains(sessionId));
    }

    // Test addFinishedSessionId with multiple sessions
    @Test
    public void test_addFinishedSessionId_multiple() {
        indexUpdater.addFinishedSessionId("session1");
        indexUpdater.addFinishedSessionId("session2");

                duplicateHostHelper.init();
            } catch (final Exception e) {
                logger.warn("Could not initialize duplicateHostHelper.", e);
            }

            // delete expired sessions
            crawlingInfoService.deleteSessionIdsBefore(options.sessionId, options.name, systemHelper.getCurrentTimeAsLong());

            final List<String> webConfigIdList = options.getWebConfigIdList();