The OSINT investigator's workbench. One case, one folder, every tool. Local-first: your media and your investigations never leave your machine.
JavaScript
import { describe, it, expect } from 'vitest';
import {
variantId,
DEFAULT_MAXCC,
validMaxcc,
maxccLabel,
overCloudCeiling,
latestAllowedPass,
isoDay,
daysBefore,
validWindow,
validDay,
cloudLabel,
cloudClass,
monthOf,
addMonths,
monthLabel,
monthBounds,
monthGrid,
sentinelPlaceKey,
coverageRequestPath,
dateAfterCoverage,
DEFAULT_LAYER,
SENTINEL_ID,
} from './sentinel.js';
describe('variantId', () => {
it('leaves the plain default basemap as the bare id', () => {
// a second name for the same thing would cache twice and read as two
// providers in a capture's provenance
expect(variantId(SENTINEL_ID)).toBe('sentinel2');
expect(variantId(SENTINEL_ID, { layer: DEFAULT_LAYER })).toBe('sentinel2');
expect(variantId(SENTINEL_ID, { layer: '' })).toBe('sentinel2');
});
it('packs the layer and the window into the id', () => {
expect(variantId(SENTINEL_ID, { layer: 'SWIR' })).toBe('sentinel2~SWIR');
expect(variantId(SENTINEL_ID, { layer: 'SWIR', from: '2026-05-01', to: '2026-05-31' })).toBe(
'sentinel2~SWIR~2026-05-01~2026-05-31'
);
// a window on the default layer still needs naming
expect(variantId(SENTINEL_ID, { from: '2026-05-01', to: '2026-05-01' })).toBe(
'sentinel2~TRUE_COLOR~2026-05-01~2026-05-01'
);
});
it('ignores half a window (both ends or neither)', () => {
expect(variantId(SENTINEL_ID, { layer: 'SWIR', from: '2026-05-01' })).toBe('sentinel2~SWIR');
});
it('never touches another provider', () => {
expect(variantId('esri-world-imagery', { layer: 'SWIR' })).toBe('esri-world-imagery');
});
});
describe('cloud ceiling', () => {
it('leaves the default ceiling off the id', () => {
// 100 is "no filter", which is the plain basemap — naming it would file the
// same tiles under a second id
expect(variantId(SENTINEL_ID, { maxcc: DEFAULT_MAXCC })).toBe('sentinel2');
});
it('packs a ceiling last, after any window', () => {
expect(variantId(SENTINEL_ID, { maxcc: 20 })).toBe('sentinel2~TRUE_COLOR~CC20');
expect(
variantId(SENTINEL_ID, { layer: 'SWIR', from: '2026-05-01', to: '2026-05-01', maxcc: 0 })
).toBe('sentinel2~SWIR~2026-05-01~2026-05-01~CC0');
});
it('ignores a ceiling the backend would refuse', () => {
expect(variantId(SENTINEL_ID, { maxcc: 150 })).toBe('sentinel2');
expect(variantId(SENTINEL_ID, { maxcc: 12.5 })).toBe('sentinel2');
expect(validMaxcc(20)).toBe(true);
expect(validMaxcc(-1)).toBe(false);
});
it('reads as a ceiling, or as no ceiling at all', () => {
expect(maxccLabel(100)).toBe('Any cloud');
expect(maxccLabel(20)).toBe('Up to 20%');
});
it('filters a pass over the ceiling but never one with no figure', () => {
expect(overCloudCeiling(38, 20)).toBe(true);
expect(overCloudCeiling(20, 20)).toBe(false);
// an unknown is not a reason to hide real imagery
expect(overCloudCeiling(null, 20)).toBe(false);
});
it('names the newest pass the ceiling still allows as "most recent"', () => {
const days = {
'2026-05-03': { cloud: 80 },
'2026-05-08': { cloud: 12 },
'2026-05-13': { cloud: 60 },
};
expect(latestAllowedPass(days, '2026-05-31', 100)).toBe('2026-05-13');
expect(latestAllowedPass(days, '2026-05-31', 20)).toBe('2026-05-08');
// a future pass is not "most recent", whatever the ceiling
expect(latestAllowedPass(days, '2026-05-10', 100)).toBe('2026-05-08');
expect(latestAllowedPass(days, '2026-05-31', 0)).toBe('');
});
});
describe('isoDay / daysBefore', () => {
it('dates by the UTC calendar, not the viewer timezone', () => {
expect(isoDay(new Date(Date.UTC(2026, 6, 14, 23, 30)))).toBe('2026-07-14');
});
it('walks back across a month boundary', () => {
expect(daysBefore(14, new Date(Date.UTC(2026, 6, 7)))).toBe('2026-06-23');
expect(daysBefore(0, new Date(Date.UTC(2026, 6, 7)))).toBe('2026-07-07');
});
});
describe('validWindow', () => {
it('accepts a well-formed range in order', () => {
expect(validWindow('2026-05-01', '2026-05-31')).toBe(true);
expect(validWindow('2026-05-01', '2026-05-01')).toBe(true); // a single day
});
it('rejects what the backend would reject, before it costs a request', () => {
expect(validWindow('2026-05-31', '2026-05-01')).toBe(false); // reversed
expect(validWindow('2026-05-01', '')).toBe(false);
expect(validWindow('05/01/2026', '2026-05-31')).toBe(false);
expect(validWindow('2026-5-1', '2026-05-31')).toBe(false); // half-typed
expect(validWindow(undefined, undefined)).toBe(false);
});
});
describe('cloudLabel', () => {
it('is the reason to skip a date without paying to find out', () => {
expect(cloudLabel(3.4)).toBe('3% cloud');
expect(cloudLabel(0)).toBe('0% cloud');
});
it('is empty when the service gave no figure', () => {
expect(cloudLabel(null)).toBe('');
expect(cloudLabel(undefined)).toBe('');
});
});
describe('validDay', () => {
it('accepts one well-formed day and nothing else', () => {
expect(validDay('2026-05-01')).toBe(true);
expect(validDay('2026-5-1')).toBe(false);
expect(validDay('')).toBe(false);
});
});
describe('cloudClass', () => {
it('grades a pass by how much of it is cloud', () => {
expect(cloudClass(0)).toBe('clear');
expect(cloudClass(19.9)).toBe('clear');
expect(cloudClass(20)).toBe('part');
expect(cloudClass(59)).toBe('part');
expect(cloudClass(60)).toBe('cloudy');
// a pass with no figure is still a pass — it must not read as clear
expect(cloudClass(null)).toBe('unknown');
expect(cloudClass(undefined)).toBe('unknown');
});
});
describe('month arithmetic', () => {
it('reads the month off a day, defaulting to now', () => {
expect(monthOf('2026-05-14')).toBe('2026-05');
expect(monthOf('')).toMatch(/^\d{4}-\d{2}$/);
});
it('steps months without a 31st spilling into the next one', () => {
expect(addMonths('2026-01', 1)).toBe('2026-02');
expect(addMonths('2026-03', -1)).toBe('2026-02');
expect(addMonths('2026-12', 1)).toBe('2027-01');
expect(addMonths('2026-01', -1)).toBe('2025-12');
});
it('labels a month for a human', () => {
expect(monthLabel('2026-07')).toBe('July 2026');
});
it('bounds a month, leap years included', () => {
expect(monthBounds('2026-07')).toEqual({ from: '2026-07-01', to: '2026-07-31' });
expect(monthBounds('2026-02')).toEqual({ from: '2026-02-01', to: '2026-02-28' });
expect(monthBounds('2028-02').to).toBe('2028-02-29'); // leap
});
});
describe('monthGrid', () => {
it('pads the first day onto its weekday, Monday-first', () => {
// 2026-07-01 is a Wednesday → two blanks before it
const cells = monthGrid('2026-07');
expect(cells.slice(0, 4)).toEqual([null, null, '2026-07-01', '2026-07-02']);
expect(cells.at(-1)).toBe('2026-07-31');
expect(cells.filter(Boolean)).toHaveLength(31);
});
it('needs no padding when a month opens on a Monday', () => {
// 2026-06-01 is a Monday
expect(monthGrid('2026-06')[0]).toBe('2026-06-01');
});
it('handles a Sunday start (the last Monday-first column)', () => {
// 2026-02-01 is a Sunday → six blanks
const cells = monthGrid('2026-02');
expect(cells.slice(0, 6)).toEqual([null, null, null, null, null, null]);
expect(cells[6]).toBe('2026-02-01');
});
});
describe('coverage checks', () => {
it('buckets nearby map centres together', () => {
expect(sentinelPlaceKey(48.85837, 2.29448)).toBe('48.858,2.294');
});
it('builds a request for the selected layer, day and exact crosshair', () => {
const path = coverageRequestPath({
lat: 48.8584,
lon: 2.2945,
layer: 'FALSE_COLOR',
date: '2026-05-11',
});
const url = new URL(path, 'http://localhost');
expect(url.pathname).toBe('/api/satellite/sentinel/coverage');
expect(Object.fromEntries(url.searchParams)).toEqual({
lat: '48.8584',
lon: '2.2945',
layer: 'FALSE_COLOR',
date: '2026-05-11',
maxcc: '100',
});
});
it('probes at the cloud ceiling the map will render with', () => {
const url = new URL(
coverageRequestPath({ lat: 48, lon: 2, layer: 'TRUE_COLOR', date: '2026-05-11', maxcc: 20 }),
'http://localhost'
);
expect(url.searchParams.get('maxcc')).toBe('20');
});
it('keeps the working date when the candidate has no imagery', () => {
expect(dateAfterCoverage('2026-05-06', '2026-05-11', false)).toBe('2026-05-06');
expect(dateAfterCoverage('2026-05-06', '2026-05-11', true)).toBe('2026-05-11');
});
});