Skip to content

The OSINT investigator's workbench. One case, one folder, every tool. Local-first: your media and your investigations never leave your machine.

JavaScript
2.8 KB
Raw Blame
import { describe, expect, it } from 'vitest';
import {
  TEMPORAL_MARKERS,
  TEMPORAL_SYNTAX,
  readTemporalInput,
  writeTemporalInput,
} from './temporalInput.js';

describe('the temporal input adapter', () => {
  it.each([
    '2026',
    '2026-08',
    '2026-08-11?',
    '2026-08-11T18:40:00',
    '2026-08-11T16:40:00Z',
    '2026-08-11T18:40:00+02:00',
    '2026-08-11/2026-08-14',
    '2026-08~/2026-10?',
    '2026-08-11T10:15:00Z/2026-08-11T11:40:00Z',
    '2026-08-11T10:15:00+02:00/2026-08-11T11:40:00+02:00',
  ])('round-trips %s without rewriting it', (raw) => {
    expect(writeTemporalInput(readTemporalInput(raw))).toBe(raw);
  });

  it('adds the seconds required by the backend profile', () => {
    expect(writeTemporalInput({
      mode: 'timestamp', datetime: '2026-08-11T18:40', zone: 'UTC', offset: '',
    })).toBe('2026-08-11T18:40:00Z');
  });

  it('keeps an unrecognised existing value in the advanced editor', () => {
    const state = readTemporalInput('circa late summer');

    expect(state.mode).toBe('advanced');
    expect(writeTemporalInput(state)).toBe('circa late summer');
  });

  it('writes a zone as the offset it keeps at that time', () => {
    const state = { ...readTemporalInput('2026-08-11T17:05:00'), zone: 'Europe/Kyiv' };
    expect(writeTemporalInput(state)).toBe('2026-08-11T17:05:00+03:00');
    expect(writeTemporalInput({ ...state, datetime: '2026-01-11T17:05' })).toBe('2026-01-11T17:05:00+02:00');
    // each end of a range keeps the offset in force at its own time
    const range = { ...readTemporalInput('2026-03-28T12:00:00Z/2026-03-30T12:00:00Z'), zone: 'Europe/Kyiv' };
    expect(writeTemporalInput(range)).toBe('2026-03-28T12:00:00+02:00/2026-03-30T12:00:00+03:00');
  });

  it('reads the clock a stored time writes, and none when it writes none', () => {
    expect(readTemporalInput('2026-08-11T16:40:00Z')).toMatchObject({ zone: 'UTC', offset: '' });
    expect(readTemporalInput('2026-08-11T18:40:00+02:00')).toMatchObject({ zone: '', offset: '+02:00' });
    expect(readTemporalInput('2026-08-11T18:40:00')).toMatchObject({ zone: '', offset: '' });
    expect(readTemporalInput('2026-08-11T10:00:00/2026-08-11T11:00:00')).toMatchObject({ mode: 'time-range', zone: '' });
  });

  it('documents every supported family with a pattern and an example', () => {
    expect(TEMPORAL_SYNTAX.map(({ meaning }) => meaning)).toEqual([
      'Year', 'Month', 'Day', 'Local time', 'UTC time', 'UTC offset',
      'Subseconds', 'Date range', 'Time range',
    ]);
    expect(TEMPORAL_SYNTAX.every(({ pattern, example }) => pattern && example)).toBe(true);
    expect(TEMPORAL_MARKERS).toEqual([
      { value: '~', meaning: 'Approximate' },
      { value: '?', meaning: 'Uncertain' },
      { value: '%', meaning: 'Approximate and uncertain' },
    ]);
  });
});