/** * ESM test suite for moon-cycle v2. * Uses Node.js built-in test runner. */ import { describe, it } from 'node:test'; import assert from 'node:assert/strict'; import { cycleMonth, cycleYear, imageFolder, cdnUrl, SYNODIC_MONTH, MONTH_IMAGES, YEAR_IMAGES, MONTH_ANCHOR, YEAR_ANCHOR, } from './dist/index.mjs'; // ─── Constants ─────────────────────────────────────────────────────────────── describe('constants', () => { it('SYNODIC_MONTH is correct IAU value', () => { assert.strictEqual(SYNODIC_MONTH, 29.53058821398858); }); it('MONTH_IMAGES is 708', () => { assert.strictEqual(MONTH_IMAGES, 708); }); it('YEAR_IMAGES is 8760', () => { assert.strictEqual(YEAR_IMAGES, 8760); }); it('MONTH_ANCHOR is 2023-11-13T09:27:00Z', () => { assert.strictEqual(MONTH_ANCHOR.toISOString(), '2023-11-13T09:27:00.000Z'); }); it('YEAR_ANCHOR is 2023-01-01T00:00:00Z', () => { assert.strictEqual(YEAR_ANCHOR.toISOString(), '2023-01-01T00:00:00.000Z'); }); }); // ─── cycleMonth ────────────────────────────────────────────────────────────── describe('cycleMonth', () => { it('returns a string', () => { assert.strictEqual(typeof cycleMonth(), 'string'); }); it('result matches /^\\d{3}\\.webp$/', () => { assert.match(cycleMonth(), /^\d{3}\.webp$/); }); it('result is never 000.webp (images are 1-indexed)', () => { const anchor = MONTH_ANCHOR.getTime(); const synodic_ms = SYNODIC_MONTH * 24 * 60 * 60 * 1000; for (let i = 0; i < 100; i++) { const date = new Date(anchor + i * (synodic_ms / 100)); assert.notStrictEqual(cycleMonth(date), '000.webp', `Got 000.webp for offset ${i}`); } }); it('at anchor date returns 001.webp (start of synodic cycle)', () => { assert.strictEqual(cycleMonth(MONTH_ANCHOR), '001.webp'); }); it('one synodic month + 1 min after anchor returns near start of next cycle', () => { const oneMonthPlus = new Date( MONTH_ANCHOR.getTime() + SYNODIC_MONTH * 24 * 60 * 60 * 1000 + 60_000, ); const index = parseInt(cycleMonth(oneMonthPlus).replace('.webp', ''), 10); assert(index <= 3, `Expected near start of next cycle (index <= 3), got ${index}`); }); it('at halfway through synodic month returns ~354.webp', () => { const half = new Date(MONTH_ANCHOR.getTime() + (SYNODIC_MONTH / 2) * 24 * 60 * 60 * 1000); const index = parseInt(cycleMonth(half).replace('.webp', ''), 10); assert(index >= 353 && index <= 355, `Expected ~354, got ${index}`); }); it('result is always in range [001, 708]', () => { const start = new Date('2020-01-01T00:00:00Z'); const step = 24 * 60 * 60 * 1000 * 7; for (let i = 0; i < 260; i++) { const date = new Date(start.getTime() + i * step); const index = parseInt(cycleMonth(date).replace('.webp', ''), 10); assert(index >= 1, `Index ${index} below minimum (date: ${date.toISOString()})`); assert(index <= 708, `Index ${index} above maximum (date: ${date.toISOString()})`); } }); it('handles dates before the anchor (pre-2023)', () => { const past = new Date('2020-06-15T00:00:00Z'); const result = cycleMonth(past); assert.match(result, /^\d{3}\.webp$/); const index = parseInt(result.replace('.webp', ''), 10); assert(index >= 1 && index <= 708); }); it('with no args returns a valid result', () => { assert.match(cycleMonth(), /^\d{3}\.webp$/); }); it('throws TypeError for invalid Date', () => { assert.throws(() => cycleMonth(new Date('invalid')), { name: 'TypeError', message: 'date must be a valid Date instance', }); }); it('throws TypeError for non-Date input', () => { assert.throws(() => cycleMonth('2023-01-01'), { name: 'TypeError', message: 'date must be a valid Date instance', }); }); }); // ─── cycleYear ─────────────────────────────────────────────────────────────── describe('cycleYear', () => { it('returns a string', () => { assert.strictEqual(typeof cycleYear(), 'string'); }); it('result matches /^\\d{4}\\.webp$/', () => { assert.match(cycleYear(), /^\d{4}\.webp$/); }); it('result is never 0000.webp (images are 1-indexed)', () => { const anchor = YEAR_ANCHOR.getTime(); const year_ms = YEAR_IMAGES * 60 * 60 * 1000; for (let i = 0; i < 100; i++) { const date = new Date(anchor + i * (year_ms / 100)); assert.notStrictEqual(cycleYear(date), '0000.webp', `Got 0000.webp for offset ${i}`); } }); it('at anchor date returns 0001.webp (start of year)', () => { assert.strictEqual(cycleYear(YEAR_ANCHOR), '0001.webp'); }); it('at exactly one year after anchor returns 0001.webp', () => { const oneYear = new Date(YEAR_ANCHOR.getTime() + YEAR_IMAGES * 60 * 60 * 1000); assert.strictEqual(cycleYear(oneYear), '0001.webp'); }); it('at halfway through year returns ~4380.webp', () => { const half = new Date(YEAR_ANCHOR.getTime() + (YEAR_IMAGES / 2) * 60 * 60 * 1000); const index = parseInt(cycleYear(half).replace('.webp', ''), 10); assert(index >= 4379 && index <= 4381, `Expected ~4380, got ${index}`); }); it('result is always in range [0001, 8760]', () => { const start = new Date('2020-01-01T00:00:00Z'); const step = 24 * 60 * 60 * 1000 * 7; for (let i = 0; i < 260; i++) { const date = new Date(start.getTime() + i * step); const index = parseInt(cycleYear(date).replace('.webp', ''), 10); assert(index >= 1, `Index ${index} below minimum`); assert(index <= 8760, `Index ${index} above maximum`); } }); it('handles dates before 2023', () => { const past = new Date('2021-06-15T00:00:00Z'); const result = cycleYear(past); assert.match(result, /^\d{4}\.webp$/); const index = parseInt(result.replace('.webp', ''), 10); assert(index >= 1 && index <= 8760); }); it('with no args returns a valid result', () => { assert.match(cycleYear(), /^\d{4}\.webp$/); }); it('throws TypeError for invalid Date', () => { assert.throws(() => cycleYear(new Date('invalid')), { name: 'TypeError', message: 'date must be a valid Date instance', }); }); it('throws TypeError for non-Date input', () => { assert.throws(() => cycleYear('2023-01-01'), { name: 'TypeError', message: 'date must be a valid Date instance', }); }); }); // ─── imageFolder ───────────────────────────────────────────────────────────── describe('imageFolder', () => { it('returns correct folder name', () => { assert.strictEqual(imageFolder('mm', 256, 75), 'mm-256-75'); assert.strictEqual(imageFolder('mm', 512, 85), 'mm-512-85'); assert.strictEqual(imageFolder('my', 256, 75), 'my-256-75'); assert.strictEqual(imageFolder('my', 512, 85), 'my-512-85'); }); }); // ─── cdnUrl ────────────────────────────────────────────────────────────────── describe('cdnUrl', () => { it('returns a valid jsDelivr URL', () => { assert.strictEqual( cdnUrl('354.webp', 'mm', 256, 75), 'https://cdn.jsdelivr.net/gh/acamarata/moon-cycle@main/mm-256-75/354.webp', ); }); it('respects custom ref parameter', () => { assert.strictEqual( cdnUrl('001.webp', 'my', 512, 85, 'v2.0.0'), 'https://cdn.jsdelivr.net/gh/acamarata/moon-cycle@v2.0.0/my-512-85/001.webp', ); }); it('integrates with cycleMonth output', () => { const filename = cycleMonth(MONTH_ANCHOR); const url = cdnUrl(filename, 'mm', 256, 75); assert(url.startsWith('https://cdn.jsdelivr.net/gh/acamarata/moon-cycle@main/mm-256-75/')); assert(url.endsWith('.webp')); }); });