ccs/tests/unit/utils/expand-path.test.ts

import { expect, test, describe, beforeEach, afterEach } from 'bun:test';
import * as path from 'path';
import * as os from 'os';
import { expandPath } from '../../../src/utils/helpers';

describe('expandPath', () => {
  const originalEnv = { ...process.env };
  const HOME = os.homedir();

  beforeEach(() => {
    process.env.TEST_HOME = '/custom/home';
    process.env.TEST_VAR = 'foo';
  });

  afterEach(() => {
    process.env = { ...originalEnv };
  });

  test('1. Tilde expansion: ~/path -> /home/user/path', () => {
    expect(expandPath('~/test/file.txt')).toBe(path.join(HOME, 'test/file.txt'));
  });

  test('2. Windows tilde with backslash: ~\\path', () => {
    // expandPath handles both ~/ and ~\ regardless of platform
    expect(expandPath('~\\test\\file.txt')).toBe(path.join(HOME, 'test/file.txt'));
  });

  test('3. Environment variable expansion: ${VAR}/path', () => {
    expect(expandPath('${TEST_HOME}/file.txt')).toBe(path.normalize('/custom/home/file.txt'));
  });

  test('4. Dollar sign env vars: $VAR/path', () => {
    expect(expandPath('$TEST_HOME/file.txt')).toBe(path.normalize('/custom/home/file.txt'));
  });

  test('5. Windows %VAR% expansion: %VAR%\\path (simulated)', () => {
    // We can't easily mock process.platform if it's not win32,
    // but the function check process.platform === 'win32'
    if (process.platform === 'win32') {
      expect(expandPath('%TEST_HOME%\\file.txt')).toBe(path.normalize('/custom/home/file.txt'));
    } else {
      // Should remain unchanged on non-windows (but separators normalized)
      expect(expandPath('%TEST_HOME%\\file.txt')).toBe(path.normalize('%TEST_HOME%/file.txt'));
    }
  });

  test('6. Mixed path separators normalization', () => {
    const result = expandPath('path/to\\some/file');
    expect(result).toBe(path.normalize('path/to/some/file'));
  });

  test('7. Nested env vars: ${HOME}/${VAR}/path', () => {
    expect(expandPath('${TEST_HOME}/${TEST_VAR}/file.txt')).toBe(
      path.normalize('/custom/home/foo/file.txt')
    );
  });

  test('8. Empty/null path handling', () => {
    expect(expandPath('')).toBe('.');
  });

  test('9. Already absolute paths stay unchanged', () => {
    const absPath = '/absolute/path';
    expect(expandPath(absPath)).toBe(path.normalize(absPath));
  });

  test('10. Undefined env vars -> empty string', () => {
    expect(expandPath('${UNDEFINED_VAR}/file.txt')).toBe(path.normalize('/file.txt'));
    expect(expandPath('$UNDEFINED_VAR/file.txt')).toBe(path.normalize('/file.txt'));
  });

  test('11. Windows drive letters stay intact', () => {
    // Windows drive letter paths should be preserved
    const result = expandPath('C:\\Users\\test\\file.txt');
    expect(result).toContain('Users');
    expect(result).toContain('test');
  });

  test('12. Windows UNC paths handled', () => {
    // UNC paths start with \\
    const uncPath = '\\\\server\\share\\folder';
    const result = expandPath(uncPath);
    // Should normalize but preserve the structure
    expect(result).toContain('server');
    expect(result).toContain('share');
  });

  test('13. Null-like input throws TypeError', () => {
    // Function requires string input - documents current behavior
    // @ts-ignore - testing runtime edge case
    expect(() => expandPath(undefined as unknown as string)).toThrow(TypeError);
    // @ts-ignore - testing runtime edge case
    expect(() => expandPath(null as unknown as string)).toThrow(TypeError);
  });

  test('14. Path with spaces preserved', () => {
    const pathWithSpaces = '~/My Documents/file.txt';
    const result = expandPath(pathWithSpaces);
    expect(result).toContain('My Documents');
  });

  test('15. Multiple consecutive slashes normalized', () => {
    const result = expandPath('path//to///file.txt');
    expect(result).toBe(path.normalize('path/to/file.txt'));
  });
});