coding-agent-search 0.6.2

/**
 * cass Archive Share Link Generator
 *
 * Generates shareable URLs for conversations, messages, and search queries.
 * Works with hash-based routing for static hosting compatibility.
 */

import {
    buildConversationPath,
    buildSearchPath,
    parseConversationRouteParts,
    splitRouteQuery,
} from './router.js';

/**
 * Get the base URL (everything before the hash)
 * @returns {string} Base URL
 */
function getBaseUrl() {
    const url = new URL(window.location.href);
    // Remove hash and query params
    url.hash = '';
    url.search = '';
    return url.toString();
}

/**
 * Generate a shareable link for a conversation
 * @param {number|string} conversationId - Conversation ID
 * @param {number|string|null} messageId - Optional message ID to link to
 * @returns {string} Shareable URL
 */
export function getConversationLink(conversationId, messageId = null) {
    const base = getBaseUrl();
    const path = buildConversationPath(conversationId, messageId);
    return `${base}#${path}`;
}

/**
 * Generate a shareable link for a search query
 * @param {string} query - Search query
 * @param {Object} filters - Optional filters (agent, since, until)
 * @returns {string} Shareable URL
 */
export function getSearchLink(query, filters = {}) {
    const base = getBaseUrl();
    const path = buildSearchPath(query, filters);
    return `${base}#${path}`;
}

/**
 * Generate a shareable link for the settings panel
 * @returns {string} Shareable URL
 */
export function getSettingsLink() {
    const base = getBaseUrl();
    return `${base}#/settings`;
}

/**
 * Generate a shareable link for the stats panel
 * @returns {string} Shareable URL
 */
export function getStatsLink() {
    const base = getBaseUrl();
    return `${base}#/stats`;
}

/**
 * Generate a shareable link for the home/search page
 * @returns {string} Shareable URL
 */
export function getHomeLink() {
    const base = getBaseUrl();
    return `${base}#/`;
}

/**
 * Copy text to the clipboard
 * @param {string} text - Text to copy
 * @returns {Promise<boolean>} True if successful
 */
export async function copyTextToClipboard(text) {
    const clipboard = globalThis.navigator?.clipboard;
    if (clipboard?.writeText) {
        try {
            await clipboard.writeText(text);
            return true;
        } catch (error) {
            console.error('[Share] Failed to copy text via Clipboard API:', error);
        }
    }

    let textArea = null;
    try {
        if (!document.body || typeof document.execCommand !== 'function') {
            return false;
        }

        textArea = document.createElement('textarea');
        textArea.value = text;
        textArea.setAttribute('readonly', '');
        textArea.style.position = 'fixed';
        textArea.style.left = '-9999px';
        textArea.style.top = '-9999px';
        textArea.style.opacity = '0';
        document.body.appendChild(textArea);
        textArea.focus();
        textArea.select();

        return document.execCommand('copy');
    } catch (fallbackError) {
        console.error('[Share] Fallback copy failed:', fallbackError);
        return false;
    } finally {
        if (textArea?.parentNode) {
            textArea.parentNode.removeChild(textArea);
        }
    }
}

/**
 * Copy a link to the clipboard
 * @param {string} link - Link to copy
 * @returns {Promise<boolean>} True if successful
 */
export async function copyLinkToClipboard(link) {
    return copyTextToClipboard(link);
}

/**
 * Copy conversation link to clipboard with feedback
 * @param {number|string} conversationId - Conversation ID
 * @param {number|string|null} messageId - Optional message ID
 * @returns {Promise<{success: boolean, link: string}>} Result
 */
export async function copyConversationLink(conversationId, messageId = null) {
    const link = getConversationLink(conversationId, messageId);
    const success = await copyLinkToClipboard(link);
    return { success, link };
}

/**
 * Copy search link to clipboard with feedback
 * @param {string} query - Search query
 * @param {Object} filters - Optional filters
 * @returns {Promise<{success: boolean, link: string}>} Result
 */
export async function copySearchLink(query, filters = {}) {
    const link = getSearchLink(query, filters);
    const success = await copyLinkToClipboard(link);
    return { success, link };
}

/**
 * Share link using Web Share API (if available)
 * @param {Object} options - Share options
 * @param {string} options.title - Share title
 * @param {string} options.text - Share text/description
 * @param {string} options.url - URL to share
 * @returns {Promise<boolean>} True if shared successfully
 */
export async function shareLink(options) {
    if (!navigator.share) {
        console.debug('[Share] Web Share API not available');
        return false;
    }

    try {
        await navigator.share(options);
        return true;
    } catch (error) {
        // User cancelled or share failed
        if (error.name !== 'AbortError') {
            console.error('[Share] Share failed:', error);
        }
        return false;
    }
}

/**
 * Share a conversation using Web Share API
 * @param {number|string} conversationId - Conversation ID
 * @param {string} title - Conversation title
 * @param {number|string|null} messageId - Optional message ID
 * @returns {Promise<boolean>} True if shared successfully
 */
export async function shareConversation(conversationId, title, messageId = null) {
    const link = getConversationLink(conversationId, messageId);

    const shareOptions = {
        title: title || 'Conversation',
        text: `Check out this conversation${messageId ? ' (message #' + messageId + ')' : ''}`,
        url: link,
    };

    return shareLink(shareOptions);
}

/**
 * Check if Web Share API is available
 * @returns {boolean} True if available
 */
export function isWebShareAvailable() {
    return !!navigator.share;
}

/**
 * Parse a share link to extract route info
 * @param {string} link - Share link to parse
 * @returns {Object|null} Parsed route info or null if invalid
 */
export function parseShareLink(link) {
    try {
        const url = new URL(link);
        const hash = url.hash.slice(1); // Remove #

        if (!hash) {
            return { view: 'search', params: {}, query: {} };
        }

        const [pathPart, queryPart] = splitRouteQuery(hash);
        const parts = pathPart.split('/').filter(Boolean);

        // Parse query params
        const query = {};
        if (queryPart) {
            const searchParams = new URLSearchParams(queryPart);
            for (const [key, value] of searchParams) {
                query[key] = value;
            }
        }

        // Home/search
        if (parts.length === 0) {
            return { view: 'search', params: {}, query };
        }

        if (parts[0] === 'search' && parts.length === 1) {
            return { view: 'search', params: {}, query };
        }

        // Conversation
        if (parts[0] === 'c') {
            const conversationParams = parseConversationRouteParts(parts);
            if (!conversationParams) {
                return null;
            }

            return {
                view: 'conversation',
                params: conversationParams,
                query,
            };
        }

        // Settings
        if (parts[0] === 'settings' && parts.length === 1) {
            return { view: 'settings', params: {}, query };
        }

        // Stats
        if (parts[0] === 'stats' && parts.length === 1) {
            return { view: 'stats', params: {}, query };
        }

        return null;
    } catch (error) {
        console.error('[Share] Failed to parse link:', error);
        return null;
    }
}

// Export default
export default {
    getConversationLink,
    getSearchLink,
    getSettingsLink,
    getStatsLink,
    getHomeLink,
    copyTextToClipboard,
    copyLinkToClipboard,
    copyConversationLink,
    copySearchLink,
    shareLink,
    shareConversation,
    isWebShareAvailable,
    parseShareLink,
};