import { beforeEach, describe, expect, it, vi } from 'vitest'
const { openURLMock } = vi.hoisted(() => ({
openURLMock: vi.fn(() => Promise.resolve(true)),
}))
vi.mock('react-native', () => ({
Linking: {
openURL: openURLMock,
canOpenURL: vi.fn(() => Promise.resolve(true)),
},
}))
import {
createMarkdownParser,
decodeSessionMentionUri,
markdownFilePath,
openSafeExternalUrl,
} from '../src/ui/link-helpers'
const parser = createMarkdownParser()
function collectLinkHrefs(source: string): string[] {
const hrefs: string[] = []
for (const token of parser.parse(source, {})) {
for (const child of token.children ?? []) {
if (child.type !== 'link_open') continue
const href = child.attrGet('href')
if (href !== null) hrefs.push(href)
}
}
return hrefs
}
/** Mirror of the app-side encoder: base64/padded and base64url/unpadded. */
function mentionFromJson(json: string, unpadded = false): string {
const base64 = Buffer.from(json, 'utf8').toString('base64')
if (!unpadded) return `dsh-session:${base64}`
return `dsh-session:${base64.replace(/=+$/u, '').replace(/\+/gu, '-').replace(/\//gu, '_')}`
}
function sessionMention(sessionId: string, unpadded = false): string {
return mentionFromJson(JSON.stringify(sessionId), unpadded)
}
describe('openSafeExternalUrl', () => {
beforeEach(() => {
openURLMock.mockReset()
openURLMock.mockImplementation(() => Promise.resolve(true))
})
it('opens https and http links', () => {
expect(openSafeExternalUrl('https://example.com/docs')).toBe(true)
expect(openURLMock).toHaveBeenLastCalledWith('https://example.com/docs')
expect(openSafeExternalUrl('http://example.com')).toBe(true)
expect(openURLMock).toHaveBeenLastCalledWith('http://example.com')
})
it('matches schemes case-insensitively', () => {
expect(openSafeExternalUrl('HTTPS://EXAMPLE.COM/A')).toBe(true)
expect(openURLMock).toHaveBeenLastCalledWith('HTTPS://EXAMPLE.COM/A')
})
it('opens mailto links', () => {
expect(openSafeExternalUrl('mailto:dev@example.com')).toBe(true)
expect(openURLMock).toHaveBeenLastCalledWith('mailto:dev@example.com')
})
it('upgrades a bare www host to https', () => {
expect(openSafeExternalUrl('www.example.com/docs')).toBe(true)
expect(openURLMock).toHaveBeenLastCalledWith('https://www.example.com/docs')
})
it('trims surrounding whitespace', () => {
expect(openSafeExternalUrl(' https://example.com ')).toBe(true)
expect(openURLMock).toHaveBeenLastCalledWith('https://example.com')
})
it.each([
'javascript:alert(1)',
'JavaScript:alert(1)',
'data:text/html,x',
'vbscript:msgbox(1)',
'intent://scan#Intent;scheme=zxing;end',
'file:///workspace/src/index.ts',
'dsh-session:eyJhIjoxfQ==',
'',
' ',
])('rejects %p without calling the opener', (url) => {
expect(openSafeExternalUrl(url)).toBe(false)
expect(openURLMock).not.toHaveBeenCalled()
})
it('reports "attempted" and swallows a rejected openURL promise', async () => {
openURLMock.mockImplementationOnce(() => Promise.reject(new Error('no handler')))
expect(openSafeExternalUrl('https://example.com')).toBe(true)
await Promise.resolve()
expect(openURLMock).toHaveBeenCalledTimes(1)
})
})
describe('markdownFilePath', () => {
it('keeps workspace-relative paths', () => {
expect(markdownFilePath('src/index.ts')).toBe('src/index.ts')
expect(markdownFilePath('docs/guide.md')).toBe('docs/guide.md')
})
it('strips a leading ./', () => {
expect(markdownFilePath('./src/index.ts')).toBe('src/index.ts')
expect(markdownFilePath('./')).toBeUndefined()
})
it('percent-decodes path segments', () => {
expect(markdownFilePath('docs/My%20File.md')).toBe('docs/My File.md')
expect(markdownFilePath('./docs/a%23b.md')).toBe('docs/a#b.md')
})
it('rejects malformed percent-encoding', () => {
expect(markdownFilePath('docs/%ZZ.md')).toBeUndefined()
expect(markdownFilePath('docs/%E0%A4%A.md')).toBeUndefined()
})
it('removes query strings and fragments', () => {
expect(markdownFilePath('src/index.ts?view=raw')).toBe('src/index.ts')
expect(markdownFilePath('src/index.ts#L10')).toBe('src/index.ts')
expect(markdownFilePath('src/index.ts?view=raw#L10')).toBe('src/index.ts')
})
it('returns absolute paths unchanged', () => {
expect(markdownFilePath('/workspace/src/index.ts')).toBe('/workspace/src/index.ts')
})
it('normalizes file: URLs', () => {
expect(markdownFilePath('file:///workspace/src/index.ts')).toBe('/workspace/src/index.ts')
expect(markdownFilePath('file:///C:/repo/src/index.ts')).toBe('C:/repo/src/index.ts')
expect(markdownFilePath('file:///workspace/My%20File.md')).toBe('/workspace/My File.md')
})
it('accepts Windows drive paths without treating them as a scheme', () => {
expect(markdownFilePath('C:/repo/src/index.ts')).toBe('C:/repo/src/index.ts')
expect(markdownFilePath('C:/repo/docs/My%20File.md#L3')).toBe('C:/repo/docs/My File.md')
})
it('rejects anchors, protocol-relative paths, and empty input', () => {
expect(markdownFilePath('#section')).toBeUndefined()
expect(markdownFilePath('//host/share/file.md')).toBeUndefined()
expect(markdownFilePath('')).toBeUndefined()
expect(markdownFilePath(' ')).toBeUndefined()
})
it.each([
'https://example.com/a.ts',
'http://example.com',
'mailto:dev@example.com',
'data:text/plain,hello',
'javascript:alert(1)',
'dsh-session:eyJhIjoxfQ==',
])('does not classify %p as a workspace path', (href) => {
expect(markdownFilePath(href)).toBeUndefined()
})
})
describe('decodeSessionMentionUri', () => {
it('decodes the JSON-encoded canonical payload', () => {
expect(decodeSessionMentionUri(sessionMention('session-id-123'))).toBe('session-id-123')
})
it('decodes base64url payloads without padding', () => {
expect(decodeSessionMentionUri(sessionMention('session-id-123', true))).toBe('session-id-123')
})
it('parses the JSON envelope instead of returning the raw payload', () => {
const decoded = decodeSessionMentionUri(mentionFromJson('"abc"'))
expect(decoded).toBe('abc')
expect(decoded).not.toBe('"abc"')
})
it('decodes non-ASCII (UTF-8) session ids', () => {
expect(decodeSessionMentionUri(sessionMention('会话-123'))).toBe('会话-123')
expect(decodeSessionMentionUri(sessionMention('séance-émoji-🚀'))).toBe('séance-émoji-🚀')
})
it('trims surrounding whitespace', () => {
expect(decodeSessionMentionUri(` ${sessionMention('abc')} `)).toBe('abc')
})
it.each([
'dsh-session:',
'dsh-session: ',
'dsh-session:!!!!',
'dsh-session:a',
'https://example.com',
'src/index.ts',
'',
])('returns undefined for %p', (href) => {
expect(decodeSessionMentionUri(href)).toBeUndefined()
})
it('returns undefined for payloads that are not a JSON string', () => {
expect(decodeSessionMentionUri(mentionFromJson('not json'))).toBeUndefined()
expect(decodeSessionMentionUri(mentionFromJson('123'))).toBeUndefined()
expect(decodeSessionMentionUri(mentionFromJson('null'))).toBeUndefined()
expect(decodeSessionMentionUri(mentionFromJson('{"id":"abc"}'))).toBeUndefined()
expect(decodeSessionMentionUri(mentionFromJson('""'))).toBeUndefined()
})
it('returns an id that the caller may fail to resolve', () => {
expect(decodeSessionMentionUri(sessionMention('does-not-exist'))).toBe('does-not-exist')
})
it('returns undefined when the bytes are not valid UTF-8', () => {
const invalidUtf8 = Buffer.from([0xff, 0xfe]).toString('base64')
expect(decodeSessionMentionUri(`dsh-session:${invalidUtf8}`)).toBeUndefined()
})
})
describe('parser linkification', () => {
it('linkifies bare URLs in prose', () => {
const hrefs = collectLinkHrefs('see https://example.com/docs for details')
expect(hrefs).toEqual(['https://example.com/docs'])
})
it('linkifies bare www hosts', () => {
const hrefs = collectLinkHrefs('visit www.example.com for docs')
expect(hrefs).toHaveLength(1)
expect(hrefs[0] ?? '').toMatch(/^https?:\/\/www\.example\.com\/?$/u)
})
it('keeps explicit markdown links', () => {
expect(collectLinkHrefs('[docs](https://example.com/docs)')).toEqual([
'https://example.com/docs',
])
expect(collectLinkHrefs('[session](dsh-session:eyJhIjoxfQ==)')).toEqual([
'dsh-session:eyJhIjoxfQ==',
])
})
it('does not linkify inline code', () => {
expect(collectLinkHrefs('use `https://example.com` here')).toEqual([])
})
it('does not linkify fenced or indented code blocks', () => {
expect(collectLinkHrefs('```\nhttps://example.com\n```')).toEqual([])
expect(collectLinkHrefs(' https://example.com')).toEqual([])
})
it('does not create duplicate link tokens', () => {
expect(collectLinkHrefs('')).toEqual(['https://example.com'])
})
it('keeps raw HTML disabled', () => {
const tokens = parser.parse('bold', {})
expect(tokens.some((token) => token.type === 'html_inline' || token.type === 'html_block')).toBe(
false,
)
})
})