Bug-report template

• All my tests pass
• No uncaught errors

// A bug report as data: a developer can act on it at once, and the test below reproduces it.
export const BUG = {
  id: 'BUG-342',
  title: 'Discount code rejected on its last day',
  severity: 2, // 1 blocks everyone · 2 a main flow is wrong · 3 a workaround exists · 4 cosmetic
  environment: 'app 4.12 (Android), staging, 2026-03-31 10:15 store time',
  steps: [
    'Create code SPRING10, valid until 2026-03-31',
    'On 2026-03-31 at 10:15, add an item and enter SPRING10',
  ],
  expected: 'The code is accepted all day on 31 March',
  actual: 'The app says "This code has expired"',
  notes: 'Expiry dates are compared as midnight at the start of the day, so the last day never counts.',
};

// The code with the bug (the fix goes here, and then the known-bug test must become a normal test).
export function isCodeValid(code, now) {
  // BUG-342: validUntil is a date, so it means midnight at the start of that day
  return now <= new Date(code.validUntil + 'T00:00:00');
}

import { BUG } from './bug';
import { isCodeValid } from './codes';

// knownBug: passes while the bug is still there, and fails as soon as it is fixed, telling you to
// turn it into a normal test (the same idea as an "expected failure" in other test tools).
function knownBug(id, name, fn) {
  test(id + ' (known bug) › ' + name, () => {
    let failed = false;
    try { fn(); } catch (e) { failed = true; }
    if (!failed) throw new Error(id + ' looks fixed: make this a normal test and close the bug.');
  });
}

const spring = { code: 'SPRING10', validUntil: '2026-03-31' };

test('the report is complete', () => {
  expect(Boolean(BUG.title && BUG.environment && BUG.steps.length && BUG.expected && BUG.actual && BUG.expected !== BUG.actual)).toBe(true);
  expect([1, 2, 3, 4]).toContain(BUG.severity);
});
test('codes › a code works before its last day', () => {
  expect(isCodeValid(spring, new Date('2026-03-30T18:00:00'))).toBe(true);
});
test('codes › a code is refused after its last day', () => {
  expect(isCodeValid(spring, new Date('2026-04-01T09:00:00'))).toBe(false);
});
knownBug(BUG.id, 'a code works on its last day', () => {
  expect(isCodeValid(spring, new Date('2026-03-31T10:15:00'))).toBe(true);
});