ether-to-astro 1.0.0

package/tests/unit/cli-profiles.test.ts

@@ -0,0 +1,128 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { runCli } from '../../src/cli.js';
+
+function parseJson(text: string): Record<string, unknown> {
+  return JSON.parse(text) as Record<string, unknown>;
+}
+
+describe.sequential('CLI profile behavior', () => {
+  let originalCwd: string;
+  let originalProfile: string | undefined;
+  let originalProfileFile: string | undefined;
+
+  beforeEach(() => {
+    originalCwd = process.cwd();
+    originalProfile = process.env.ASTRO_PROFILE;
+    originalProfileFile = process.env.ASTRO_PROFILE_FILE;
+    delete process.env.ASTRO_PROFILE;
+    delete process.env.ASTRO_PROFILE_FILE;
+  });
+
+  afterEach(() => {
+    process.chdir(originalCwd);
+    if (originalProfile === undefined) delete process.env.ASTRO_PROFILE;
+    else process.env.ASTRO_PROFILE = originalProfile;
+    if (originalProfileFile === undefined) delete process.env.ASTRO_PROFILE_FILE;
+    else process.env.ASTRO_PROFILE_FILE = originalProfileFile;
+  });
+
+  it('profiles show returns PROFILE_FILE_NOT_FOUND when profile file is missing', async () => {
+    const missingPath = path.join(tmpdir(), `astro-missing-profile-${Date.now()}.json`);
+    const stdout: string[] = [];
+    const stderr: string[] = [];
+
+    const code = await runCli(
+      ['profiles', 'show', '--profile', 'elwyn', '--profile-file', missingPath],
+      {
+        stdout: (msg) => stdout.push(msg),
+        stderr: (msg) => stderr.push(msg),
+      }
+    );
+
+    expect(code).toBe(1);
+    expect(stdout).toEqual([]);
+    const payload = parseJson(stderr.join('\n'));
+    expect(payload.code).toBe('PROFILE_FILE_NOT_FOUND');
+  });
+
+  it('non-profile command falls back to UTC when local profile file is malformed', async () => {
+    const cwd = path.join(tmpdir(), `astro-cli-malformed-${Date.now()}`);
+    await mkdir(cwd, { recursive: true });
+    await writeFile(path.join(cwd, '.astro.json'), '{invalid json', 'utf8');
+    process.chdir(cwd);
+
+    const stdout: string[] = [];
+    const stderr: string[] = [];
+    const code = await runCli(['get-next-eclipses'], {
+      stdout: (msg) => stdout.push(msg),
+      stderr: (msg) => stderr.push(msg),
+    });
+
+    expect(code).toBe(0);
+    expect(stderr).toEqual([]);
+    const payload = parseJson(stdout.join('\n'));
+    expect(payload.timezone).toBe('UTC');
+  });
+
+  it('non-profile command returns INVALID_PROFILE_FILE when profile is explicitly requested', async () => {
+    const cwd = path.join(tmpdir(), `astro-cli-explicit-profile-${Date.now()}`);
+    await mkdir(cwd, { recursive: true });
+    await writeFile(path.join(cwd, '.astro.json'), '{invalid json', 'utf8');
+    process.chdir(cwd);
+
+    const stdout: string[] = [];
+    const stderr: string[] = [];
+    const code = await runCli(['get-next-eclipses', '--profile', 'elwyn'], {
+      stdout: (msg) => stdout.push(msg),
+      stderr: (msg) => stderr.push(msg),
+    });
+
+    expect(code).toBe(1);
+    expect(stdout).toEqual([]);
+    const payload = parseJson(stderr.join('\n'));
+    expect(payload.code).toBe('INVALID_PROFILE_FILE');
+  });
+
+  it('profiles commands resolve explicit relative profile paths from injected cwd', async () => {
+    const cwd = path.join(tmpdir(), `astro-cli-relative-profile-${Date.now()}`);
+    await mkdir(cwd, { recursive: true });
+    await writeFile(
+      path.join(cwd, 'profiles.json'),
+      JSON.stringify({
+        version: 1,
+        defaultProfile: 'elwyn',
+        profiles: {
+          elwyn: {
+            name: 'Elwyn',
+            year: 1990,
+            month: 1,
+            day: 1,
+            hour: 1,
+            minute: 1,
+            latitude: 1,
+            longitude: 1,
+            timezone: 'UTC',
+          },
+        },
+      }),
+      'utf8'
+    );
+    process.chdir(cwd);
+
+    const stdout: string[] = [];
+    const stderr: string[] = [];
+    const code = await runCli(['profiles', 'show', '--profile', 'elwyn', '--profile-file', 'profiles.json'], {
+      stdout: (msg) => stdout.push(msg),
+      stderr: (msg) => stderr.push(msg),
+    });
+
+    expect(code).toBe(0);
+    expect(stderr).toEqual([]);
+    const payload = parseJson(stdout.join('\n'));
+    expect(path.basename(String(payload.filePath))).toBe('profiles.json');
+    expect(String(payload.filePath)).toContain(path.basename(cwd));
+  });
+});

package/tests/unit/cli.test.ts

@@ -0,0 +1,191 @@
+import { writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { runCli } from '../../src/cli.js';
+import { makeTempDir } from '../helpers/temp.js';
+
+function parseJson(text: string): Record<string, unknown> {
+  return JSON.parse(text) as Record<string, unknown>;
+}
+
+describe.sequential('When running CLI commands', () => {
+  let originalCwd: string;
+  let originalProfile: string | undefined;
+  let originalProfileFile: string | undefined;
+
+  beforeEach(() => {
+    originalCwd = process.cwd();
+    originalProfile = process.env.ASTRO_PROFILE;
+    originalProfileFile = process.env.ASTRO_PROFILE_FILE;
+    delete process.env.ASTRO_PROFILE;
+    delete process.env.ASTRO_PROFILE_FILE;
+  });
+
+  afterEach(() => {
+    process.chdir(originalCwd);
+    if (originalProfile === undefined) delete process.env.ASTRO_PROFILE;
+    else process.env.ASTRO_PROFILE = originalProfile;
+    if (originalProfileFile === undefined) delete process.env.ASTRO_PROFILE_FILE;
+    else process.env.ASTRO_PROFILE_FILE = originalProfileFile;
+  });
+
+  it('Given default output mode, then JSON is emitted; and with --pretty, human text is emitted', async () => {
+    const stdout: string[] = [];
+    const stderr: string[] = [];
+
+    const codeJson = await runCli(['get-next-eclipses'], {
+      stdout: (m) => stdout.push(m),
+      stderr: (m) => stderr.push(m),
+    });
+    expect(codeJson).toBe(0);
+    expect(stderr).toEqual([]);
+    expect(parseJson(stdout.join('\n'))).toHaveProperty('timezone');
+
+    stdout.length = 0;
+    const codePretty = await runCli(['get-next-eclipses', '--pretty'], {
+      stdout: (m) => stdout.push(m),
+      stderr: (m) => stderr.push(m),
+    });
+    expect(codePretty).toBe(0);
+    expect(stdout.join('\n')).toContain('ether-to-astro');
+  });
+
+  it('Given profile file in cwd, then command resolves profile timezone from cwd context', async () => {
+    const dir = await makeTempDir('cli-profile');
+    await writeFile(
+      path.join(dir, '.astro.json'),
+      JSON.stringify({
+        version: 1,
+        defaultProfile: 'default',
+        profiles: {
+          default: {
+            name: 'Test',
+            year: 1990,
+            month: 1,
+            day: 1,
+            hour: 1,
+            minute: 1,
+            latitude: 1,
+            longitude: 1,
+            timezone: 'UTC',
+          },
+        },
+      }),
+      'utf8'
+    );
+    process.chdir(dir);
+    const stdout: string[] = [];
+
+    const code = await runCli(['get-next-eclipses'], {
+      stdout: (m) => stdout.push(m),
+      stderr: vi.fn(),
+    });
+
+    expect(code).toBe(0);
+    const payload = parseJson(stdout.join('\n'));
+    expect(payload.timezone).toBe('UTC');
+  });
+
+  it('Given relative natal file path from cwd, then natal-dependent command executes', async () => {
+    const dir = await makeTempDir('cli-natal-file');
+    await writeFile(
+      path.join(dir, 'natal.json'),
+      JSON.stringify({
+        name: 'Test',
+        year: 1990,
+        month: 1,
+        day: 1,
+        hour: 1,
+        minute: 1,
+        latitude: 1,
+        longitude: 1,
+        timezone: 'UTC',
+      }),
+      'utf8'
+    );
+    process.chdir(dir);
+
+    const code = await runCli(['get-houses', '--natal-file', 'natal.json'], {
+      stdout: vi.fn(),
+      stderr: vi.fn(),
+    });
+
+    expect(code).toBe(0);
+  });
+
+  it('Given a missing profile file, then CLI returns a structured JSON error payload', async () => {
+    const stderr: string[] = [];
+    const code = await runCli(
+      ['profiles', 'show', '--profile', 'missing', '--profile-file', '/tmp/does-not-exist.json'],
+      { stdout: vi.fn(), stderr: (m) => stderr.push(m) }
+    );
+    expect(code).toBe(1);
+    const payload = parseJson(stderr.join('\n'));
+    expect(payload.code).toBe('PROFILE_FILE_NOT_FOUND');
+  });
+
+  it('Given a natal-dependent command with no natal context, then PROFILE_NOT_FOUND is returned', async () => {
+    const stderr: string[] = [];
+    const code = await runCli(
+      ['get-houses'],
+      { stdout: vi.fn(), stderr: (m) => stderr.push(m) }
+    );
+    expect(code).toBe(1);
+    const payload = parseJson(stderr.join('\n'));
+    expect(payload.code).toBe('PROFILE_NOT_FOUND');
+  });
+
+  it('Given --pretty on failure, then error output is human-readable rather than JSON', async () => {
+    const stderr: string[] = [];
+    const code = await runCli(
+      ['get-transits', '--pretty', '--year', 'abc'],
+      { stdout: vi.fn(), stderr: (m) => stderr.push(m) }
+    );
+    expect(code).toBe(1);
+    expect(stderr.join('\n')).not.toContain('{');
+  });
+
+  it('Given set-natal-chart without inline/file/profile input, then PROFILE_NOT_FOUND is returned', async () => {
+    const stderr: string[] = [];
+    const code = await runCli(
+      ['set-natal-chart'],
+      { stdout: vi.fn(), stderr: (m) => stderr.push(m) }
+    );
+    expect(code).toBe(1);
+    const payload = parseJson(stderr.join('\n'));
+    expect(payload.code).toBe('PROFILE_NOT_FOUND');
+  });
+
+  it('Given profiles show for a missing profile key, then PROFILE_NOT_FOUND is returned', async () => {
+    const dir = await makeTempDir('cli-show-missing');
+    const file = path.join(dir, '.astro.json');
+    await writeFile(
+      file,
+      JSON.stringify({
+        version: 1,
+        profiles: {
+          default: {
+            name: 'Default',
+            year: 1990,
+            month: 1,
+            day: 1,
+            hour: 1,
+            minute: 1,
+            latitude: 1,
+            longitude: 1,
+            timezone: 'UTC',
+          },
+        },
+      }),
+      'utf8'
+    );
+    const stderr: string[] = [];
+    const code = await runCli(
+      ['profiles', 'show', '--profile', 'ghost', '--profile-file', file],
+      { stdout: vi.fn(), stderr: (m) => stderr.push(m) }
+    );
+    expect(code).toBe(1);
+    const payload = parseJson(stderr.join('\n'));
+    expect(payload.code).toBe('PROFILE_NOT_FOUND');
+  });
+});

package/tests/unit/constants.test.ts

@@ -0,0 +1,26 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { getDefaultTheme } from '../../src/constants.js';
+
+describe('When deriving default chart theme from local time', () => {
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  it('Given evening local hour in target timezone, then default theme is dark', () => {
+    vi.useFakeTimers();
+    vi.setSystemTime(new Date('2024-03-26T23:00:00Z'));
+    expect(getDefaultTheme('America/New_York')).toBe('dark');
+  });
+
+  it('Given daytime local hour in target timezone, then default theme is light', () => {
+    vi.useFakeTimers();
+    vi.setSystemTime(new Date('2024-03-26T17:00:00Z'));
+    expect(getDefaultTheme('America/New_York')).toBe('light');
+  });
+
+  it('Given no timezone override, then server-local hour determines the theme', () => {
+    vi.useFakeTimers();
+    vi.setSystemTime(new Date('2024-03-26T12:00:00Z'));
+    expect(getDefaultTheme()).toMatch(/light|dark/);
+  });
+});