*
     * @param sessionId the session ID to process
     * @return the canonical session ID (portion before first hyphen, or original if no hyphen)
     */
    public String getCanonicalSessionId(final String sessionId) {
        final int idx = sessionId.indexOf('-');
        if (idx >= 0) {
            return sessionId.substring(0, idx);
        }
        return sessionId;
    }

    /**

        verify(dataHelper).addIncludeUrlPattern(sessionId, "https://example.com/.*");
        verify(dataHelper).addIncludeUrlPattern(sessionId, "https://test.com/.*");
        verify(dataHelper).addIncludeUrlPattern(sessionId, "https://sample.org/.*");
        verify(dataHelper).addExcludeUrlPattern(sessionId, "https://example.com/admin/.*");
        verify(dataHelper).addExcludeUrlPattern(sessionId, "https://example.com/private/.*");

    }

    public void test_add() {
        // Setup
        String sessionId = "session123";
        String url = "https://example.com/page";
        Queue<UrlQueueImpl<Long>> mockQueue = new LinkedList<>();

        when(dataHelper.getUrlQueueList(sessionId)).thenReturn(mockQueue);

        // Execute
        service.add(sessionId, url);

        // Verify
        assertEquals(1, mockQueue.size());

        // Second poll should return null (queue is empty)
        final OpenSearchUrlQueue polled2 = urlQueueService.poll(sessionId);
        assertNull(polled2);

        urlQueueService.delete(sessionId);
    }

    public void test_poll_multipleItemsTx() {
        final String sessionId = "poll_session3";
        final List<OpenSearchUrlQueue> urlQueueList = new ArrayList<>();

     * Supports sequential (default) and random ordering based on crawling configuration.
     *
     * @param sessionId the crawling session identifier
     * @return list of URL queue entries for processing
     */
    @Override
    protected List<OpenSearchUrlQueue> fetchUrlQueueList(final String sessionId) {
        final CrawlingConfigHelper crawlingConfigHelper = ComponentUtil.getCrawlingConfigHelper();

        preauthService.initializeSession(sessionId, salt, PreauthIntegrityService.HASH_ALGO_SHA512);

        // Simulate message exchange
        preauthService.updatePreauthHash(sessionId, "Message1".getBytes());
        preauthService.updatePreauthHash(sessionId, "Message2".getBytes());

        byte[] expectedHash = preauthService.getCurrentPreauthHash(sessionId);

        // Validation should pass with correct hash

     *
     * @param sessionId The session ID.
     * @param url The URL to add.
     */
    @Override
    public void add(final String sessionId, final String url) {
        if (exists(sessionId, url)) {
            return;
        }
        final OpenSearchUrlQueue urlQueue = new OpenSearchUrlQueue();
        urlQueue.setSessionId(sessionId);
        urlQueue.setUrl(url);

     *
     * @param sessionId the session identifier to find the latest crawling parameters for
     * @return a list of CrawlingInfoParam entities from the latest session, or empty list if none found
     */
    public List<CrawlingInfoParam> getLastCrawlingInfoParamList(final String sessionId) {
        final CrawlingInfo crawlingInfo = getLast(sessionId);
        if (crawlingInfo == null) {

    /**
     * Offers all URL queues.
     *
     * @param sessionId The session ID.
     * @param newUrlQueueList The list of new URL queues.
     */
    void offerAll(String sessionId, List<QUEUE> newUrlQueueList);

    /**
     * Polls a URL queue.
     *
     * @param sessionId The session ID.
     * @return The URL queue.
     */
    QUEUE poll(String sessionId);

    /**
     * Saves the session.
     *

            public void offerAll(String sessionId, List<UrlQueue<?>> newUrlQueueList) {
            }

            @Override
            public UrlQueue<?> poll(String sessionId) {
                return null;
            }

            @Override
            public void saveSession(String sessionId) {
            }

            @Override
            public boolean visited(UrlQueue<?> urlQueue) {