deepseek-harness/packages/util/workspace-path/tests/file-address.spec.ts

import { describe, expect, it } from 'vitest'
import { absoluteFileAddress, parseFileAddress, sessionFileAddress } from '../src/file-address.ts'

describe('file addresses', () => {
  it('round-trips a session-relative path with encoded segments', () => {
    const address = sessionFileAddress('s 1', 'w/a b#c?.txt')
    expect(address).toBe('dsh-resource://file/session/s%201/w/a%20b%23c%3F.txt')
    expect(parseFileAddress(address)).toEqual({ scope: 'session', sessionId: 's 1', path: 'w/a b#c?.txt' })
  })

  it('drops a leading ./ from a session-relative path and names the root with an empty path', () => {
    expect(sessionFileAddress('s', './src/a.ts')).toBe('dsh-resource://file/session/s/src/a.ts')
    expect(sessionFileAddress('s', '././../outside/a.txt')).toBe('dsh-resource://file/session/s/../outside/a.txt')
    expect(sessionFileAddress('s', 'src\\a.ts')).toBe('dsh-resource://file/session/s/src/a.ts')
    expect(sessionFileAddress('s', '')).toBe('dsh-resource://file/session/s/')
    expect(parseFileAddress('dsh-resource://file/session/s/')).toEqual({ scope: 'session', sessionId: 's', path: '' })
  })

  it.each([
    ['/etc/hosts', '/etc/hosts', 'dsh-resource://file/session/s//etc/hosts'],
    ['/', '/', 'dsh-resource://file/session/s//'],
    ['C:\\w\\x.ts', 'C:/w/x.ts', 'dsh-resource://file/session/s/C:/w/x.ts'],
    ['\\\\server\\share\\x.ts', '//server/share/x.ts', 'dsh-resource://file/session/s///server/share/x.ts'],
    ['/a b#c?%.txt', '/a b#c?%.txt', 'dsh-resource://file/session/s//a%20b%23c%3F%25.txt'],
  ])('round-trips the absolute path %s in a Session address', (input, path, expected) => {
    const address = sessionFileAddress('s', input)
    expect(address).toBe(expected)
    expect(parseFileAddress(address)).toEqual({ scope: 'session', sessionId: 's', path })
  })

  it('gives the same absolute path different addresses in different Sessions', () => {
    expect(sessionFileAddress('s1', '/etc/hosts')).toBe('dsh-resource://file/session/s1//etc/hosts')
    expect(sessionFileAddress('s2', '/etc/hosts')).toBe('dsh-resource://file/session/s2//etc/hosts')
  })

  it.each([
    '../outside/a.txt',
    'dir/../outside/a.txt',
    'dir/./a.txt',
    '/workspace/../outside/a.txt',
    'C:/workspace/../outside/a.txt',
    '//server/share/workspace/../outside/a.txt',
  ])('keeps the Session id and the unresolved path %s', (path) => {
    expect(parseFileAddress(sessionFileAddress('s 1', path))).toEqual({ scope: 'session', sessionId: 's 1', path })
  })

  it.each([
    '/workspace/../outside/a.txt',
    'C:/workspace/../outside/a.txt',
    '//server/share/workspace/../outside/a.txt',
  ])('keeps the unresolved absolute path %s without a Session', (path) => {
    expect(parseFileAddress(absoluteFileAddress(path))).toEqual({ scope: 'absolute', path })
  })

  it.each([
    ['./a.txt', './a.txt'],
    ['%2e%2E/outside/a.txt', '../outside/a.txt'],
    ['dir/%2E/a.txt', 'dir/./a.txt'],
    ['%252e%252e/a.txt', '%2e%2e/a.txt'],
    ['a%2Fb%5Cc.txt', 'a/b\\c.txt'],
  ])('decodes %s once without resolving dot segments', (encoded, path) => {
    expect(parseFileAddress(`dsh-resource://file/session/s%2F1/${encoded}`)).toEqual({ scope: 'session', sessionId: 's/1', path })
  })

  it.each(['?download=1#section', '#section?download=1', '?ignored=%E0%A4%A', '#ignored=%ZZ'])(
    'ignores the literal suffix %s without consuming encoded filename characters', (suffix) => {
      expect(parseFileAddress(`dsh-resource://file/session/s/dir/../a%3Fb%23c%25.txt${suffix}`))
        .toEqual({ scope: 'session', sessionId: 's', path: 'dir/../a?b#c%.txt' })
      expect(parseFileAddress(`dsh-resource://file/absolute/workspace/../a%3Fb%23c%25.txt${suffix}`))
        .toEqual({ scope: 'absolute', path: '/workspace/../a?b#c%.txt' })
    },
  )

  it('round-trips an absolute POSIX path with the leading slash dropped', () => {
    const address = absoluteFileAddress('/home/me/notes.md')
    expect(address).toBe('dsh-resource://file/absolute/home/me/notes.md')
    expect(parseFileAddress(address)).toEqual({ scope: 'absolute', path: '/home/me/notes.md' })
  })

  it('round-trips an absolute Windows drive path with backslashes normalized and the colon literal', () => {
    const address = absoluteFileAddress('C:\\w\\x.ts')
    expect(address).toBe('dsh-resource://file/absolute/C:/w/x.ts')
    expect(parseFileAddress(address)).toEqual({ scope: 'absolute', path: 'C:/w/x.ts' })
  })

  it('keeps a UNC path\'s identity in an absolute address', () => {
    const address = absoluteFileAddress('\\\\server\\share\\x.ts')
    expect(address).toBe('dsh-resource://file/absolute//server/share/x.ts')
    expect(parseFileAddress(address)).toEqual({ scope: 'absolute', path: '//server/share/x.ts' })
  })

  it('decodes either spelling of a path segment', () => {
    expect(parseFileAddress('dsh-resource://file/session/s/w/a+b.txt')?.path).toBe('w/a+b.txt')
    expect(parseFileAddress('dsh-resource://file/session/s/w/a%2Bb.txt')?.path).toBe('w/a+b.txt')
    expect(parseFileAddress('dsh-resource://file/absolute/w/a%2Bb.txt')?.path).toBe('/w/a+b.txt')
  })

  it.each([
    ['another resource type', 'dsh-resource://terminal/session/s/1'],
    ['a type spelled with another case', 'dsh-resource://File/session/s/w/x.ts'],
    ['a scheme spelled with another case', 'DSH-RESOURCE://file/session/s/w/x.ts'],
    ['an unknown scope', 'dsh-resource://file/shared/s/w/x'],
    ['the retired file:// grammar', 'file://sessions/s/w/x.ts'],
    ['a host-less file URL', 'file:///w/x.ts'],
    ['a session address with no path', 'dsh-resource://file/session/s'],
    ['a session address with no id', 'dsh-resource://file/session'],
    ['a session address with an empty id', 'dsh-resource://file/session//a.txt'],
    ['an absolute address with no path', 'dsh-resource://file/absolute'],
    ['an absolute address with an empty path', 'dsh-resource://file/absolute/'],
    ['a UNC marker with no host behind it', 'dsh-resource://file/absolute//'],
    ['no scope', 'dsh-resource://file'],
    ['another scheme', 'sidebar://files'],
    ['not a URL', 'notes.txt'],
    ['a malformed escape', 'dsh-resource://file/session/s/%E0%A4%A'],
    ['a malformed id escape', 'dsh-resource://file/session/%/a.txt'],
    ['a malformed absolute escape', 'dsh-resource://file/absolute/a%ZZ.txt'],
  ])('rejects %s', (_, address) => {
    expect(parseFileAddress(address)).toBeUndefined()
  })
})