No value has been assigned to the donated property by the chapter. Determining its value is the donor’s responsibility.
}
{receipt.purpose &&
Designation / purpose
{receipt.purpose}
}
Goods or services provided in return
{receipt.benefits === 'none' ?
No goods or services were provided in exchange for this contribution.
:
{receipt.benefitsDescription}
Good faith estimate of fair market value: {receiptMoney(receipt.benefitsValue)}
For federal income tax purposes, the deductible portion of a contribution is limited to the amount by which the money contributed and the fair market value of property donated exceed the value of goods or services provided in return, subject to applicable law.
}
;
}
function DonationReceipts() {
const [session, setSession] = React.useState(null);
const [loading, setLoading] = React.useState(true);
const [authError, setAuthError] = React.useState('');
const [unavailable, setUnavailable] = React.useState(false);
const [error, setError] = React.useState('');
const [invalidField, setInvalidField] = React.useState('');
const [notice, setNotice] = React.useState('');
const [fields, setFields] = React.useState(emptyReceipt);
const [moneyGift, setMoneyGift] = React.useState(true);
const [propertyGift, setPropertyGift] = React.useState(false);
const [dirty, setDirty] = React.useState(false);
const [stage, setStage] = React.useState('edit');
const [review, setReview] = React.useState(null);
const [confirmed, setConfirmed] = React.useState(false);
const [receipt, setReceipt] = React.useState(null);
const [records, setRecords] = React.useState([]);
const [cursor, setCursor] = React.useState(null);
const [historyLoading, setHistoryLoading] = React.useState(false);
const [historyError, setHistoryError] = React.useState('');
const [busy, setBusy] = React.useState(false);
const [saveUnknown, setSaveUnknown] = React.useState(false);
const [voidOpen, setVoidOpen] = React.useState(false);
const [voidReason, setVoidReason] = React.useState('');
const pendingSave = React.useRef(null);
const inFlight = React.useRef(false);
const allowed = React.useRef(false);
const errorRef = React.useRef(null);
const viewRef = React.useRef(null);
const clearPrivate = React.useCallback(() => {
allowed.current = false; pendingSave.current = null;
setSession(null); setFields(emptyReceipt()); setReview(null); setReceipt(null); setRecords([]);
setDirty(false); setError(''); setInvalidField(''); setNotice(''); setVoidOpen(false); setVoidReason('');
}, []);
const request = React.useCallback(async (path, options = {}) => {
const response = await fetch(`${receiptApiRoot}${path}`, { credentials: 'same-origin', cache: 'no-store', redirect: 'manual',
...options, headers: { Accept: 'application/json', ...(options.body ? { 'Content-Type': 'application/json' } : {}), ...options.headers } });
if (response.type === 'opaqueredirect' || (response.status >= 300 && response.status < 400)) {
clearPrivate(); setAuthError('Your leadership session ended. Sign in again to continue.');
throw new Error('Sign-in required.');
}
const result = await response.json().catch(() => null);
if ([401, 403].includes(response.status) || (response.ok && !result)) {
clearPrivate(); setAuthError('Your leadership session ended or receipt access is unavailable. Sign in again to continue.');
throw new Error('Sign-in required.');
}
if (!response.ok || !result?.success) {
const failure = new Error(result?.message || result?.error || 'The request could not be completed. Please try again.');
failure.status = response.status; throw failure;
}
return result;
}, [clearPrivate]);
const loadHistory = React.useCallback(async (before = null) => {
setHistoryLoading(true); setHistoryError('');
try {
const result = await request(`/receipts${before ? `?before=${encodeURIComponent(before)}` : ''}`);
if (allowed.current) { setRecords((old) => before ? [...old, ...result.receipts] : result.receipts); setCursor(result.nextCursor || null); }
} catch (failure) { if (allowed.current) setHistoryError(failure.message); }
finally { setHistoryLoading(false); }
}, [request]);
React.useEffect(() => {
let cancelled = false;
const load = async () => {
try {
const result = await request('/session');
if (!cancelled) { allowed.current = true; setSession(result); await loadHistory(); }
} catch (failure) { if (!cancelled) { setUnavailable(failure.status === 503); setAuthError(failure.status === 503 ? `${failure.message} Please contact the chapter website administrator.` : 'Your receipt access could not be verified. Sign in through Leadership login, or ask the chapter administrator for access.'); } }
finally { if (!cancelled) setLoading(false); }
};
load();
const restored = (event) => { if (event.persisted) { clearPrivate(); window.location.reload(); } };
const hidden = (event) => { if (event.persisted) clearPrivate(); };
window.addEventListener('pageshow', restored); window.addEventListener('pagehide', hidden);
return () => { cancelled = true; allowed.current = false; window.removeEventListener('pageshow', restored); window.removeEventListener('pagehide', hidden); };
}, [request, loadHistory, clearPrivate]);
React.useEffect(() => {
if (!dirty) return;
const unload = (event) => { event.preventDefault(); event.returnValue = ''; };
const navigate = (event) => { if (!window.confirm('Leave this receipt? Unsaved information will be lost.')) event.preventDefault(); };
window.addEventListener('beforeunload', unload); window.addEventListener('wkbeforeNavigate', navigate);
return () => { window.removeEventListener('beforeunload', unload); window.removeEventListener('wkbeforeNavigate', navigate); };
}, [dirty]);
React.useEffect(() => { if (error) { const field = invalidField && document.getElementById(`dr-${invalidField}`); (field || errorRef.current)?.focus(); } }, [error, invalidField]);
React.useEffect(() => { if (stage !== 'edit') viewRef.current?.focus(); }, [stage]);
const update = (name, value) => { setFields((old) => ({ ...old, [name]: value })); setDirty(true); setError(''); setInvalidField(''); };
const normalized = () => ({ ...fields, donorName: fields.donorName.trim(), donorEmail: fields.donorEmail.trim(), donorAddress: fields.donorAddress.trim(),
monetaryAmount: moneyGift ? fields.monetaryAmount.trim() : '', paymentMethod: moneyGift ? fields.paymentMethod : '',
checkNumber: moneyGift && fields.paymentMethod === 'check' ? fields.checkNumber.trim() : '',
propertyDescription: propertyGift ? fields.propertyDescription.trim() : '', purpose: fields.purpose.trim(),
benefitsDescription: fields.benefits === 'provided' ? fields.benefitsDescription.trim() : '',
benefitsValue: fields.benefits === 'provided' ? fields.benefitsValue.trim() : '', issuedBy: fields.issuedBy.trim() });
const reviewReceipt = (event) => {
event.preventDefault(); setError(''); setInvalidField('');
const invalid = (message, name = '') => { setInvalidField(name); setError(message); };
const value = normalized();
const validAmount = (amount, allowZero = false) => /^(?:0|[1-9]\d{0,7})(\.\d{1,2})?$/.test(amount) && (allowZero ? Number(amount) >= 0 : Number(amount) > 0);
if (!moneyGift && !propertyGift) return invalid('Choose a monetary contribution, a non-cash contribution, or both.');
if (!value.donorName) return invalid('Enter the donor’s name.', 'donorName');
if (!value.issuedBy) return invalid('Enter the officer’s full name.', 'issuedBy');
if (moneyGift && !validAmount(value.monetaryAmount)) return invalid('Enter a monetary amount greater than zero, with no leading zeros and no more than two decimal places.', 'monetaryAmount');
if (propertyGift && !value.propertyDescription) return invalid('Describe the donated property. Do not enter a value.', 'propertyDescription');
if (!value.benefits) return invalid('Choose whether the donor received goods or services in return.');
if (value.benefits === 'provided' && (!value.benefitsDescription || !validAmount(value.benefitsValue, true))) return invalid('Describe what the donor received and enter its good faith fair market value, including zero if appropriate.', !value.benefitsDescription ? 'benefitsDescription' : 'benefitsValue');
setReview(value); setConfirmed(false); setStage('review'); setDirty(true);
};
const issueReceipt = async () => {
if (!confirmed || inFlight.current) return;
if (!pendingSave.current) pendingSave.current = { ...review, requestId: crypto.randomUUID(), confirmation: true };
inFlight.current = true; setBusy(true); setError('');
try {
const result = await request('/receipts', { method: 'POST', body: JSON.stringify(pendingSave.current) });
if (!allowed.current) return;
pendingSave.current = null; setReceipt(result.receipt); setStage('saved'); setDirty(false); setSaveUnknown(false);
setNotice('Receipt issued and saved in the chapter’s private records. Download the PDF to email the donor yourself.');
await loadHistory();
} catch (failure) {
if (!allowed.current) return;
const rejected = [400, 422].includes(failure.status);
if (rejected) pendingSave.current = null;
setSaveUnknown(!rejected);
setError(rejected ? failure.message : 'We could not confirm whether this receipt was saved. Retry below using the same information; the receipt number will not be duplicated.');
} finally { inFlight.current = false; setBusy(false); }
};
const reset = () => {
if (dirty && !window.confirm('Discard the unsaved receipt and start over?')) return;
setFields(emptyReceipt()); setMoneyGift(true); setPropertyGift(false); setReview(null); setReceipt(null); setStage('edit');
setConfirmed(false); setDirty(false); setError(''); setNotice(''); setSaveUnknown(false); pendingSave.current = null;
setVoidOpen(false); setVoidReason('');
};
const openReceipt = async (id) => {
if (busy || (dirty && !window.confirm('Leave your unsaved receipt and open this saved receipt?'))) return;
setBusy(true); setError(''); setNotice('');
try {
const result = await request(`/receipts/${encodeURIComponent(id)}`);
if (!allowed.current) return;
setReceipt(result.receipt); setStage('saved'); setDirty(false); setReview(null); setFields(emptyReceipt());
pendingSave.current = null; setSaveUnknown(false); setVoidOpen(false); setVoidReason('');
} catch (failure) { if (allowed.current) setError(failure.message); }
finally { setBusy(false); }
};
const retryTreasurerCopy = async () => {
if (inFlight.current) return;
inFlight.current = true; setBusy(true); setError(''); setNotice('');
try {
const result = await request(`/receipts/${encodeURIComponent(receipt.id)}/treasurer-copy`, { method: 'POST', body: JSON.stringify({ confirmation: true }) });
if (!allowed.current) return;
setReceipt(result.receipt);
setNotice('The email provider accepted the recordkeeping copy for treasurer@wkyhb.com. Inbox delivery is not confirmed.');
} catch (failure) {
if (!allowed.current) return;
setError(`${failure.message} The receipt is still saved and its PDF is available. Delivery of the treasurer’s copy is not confirmed.`);
try { const result = await request(`/receipts/${encodeURIComponent(receipt.id)}`); if (allowed.current) setReceipt(result.receipt); } catch { /* Keep the visible failure and never claim delivery. */ }
} finally { inFlight.current = false; setBusy(false); }
};
const downloadPdf = async () => {
if (inFlight.current) return;
inFlight.current = true; setBusy(true); setError('');
try {
const response = await fetch(`${receiptApiRoot}/receipts/${encodeURIComponent(receipt.id)}/pdf`, { credentials: 'same-origin', cache: 'no-store', redirect: 'manual', headers: { Accept: 'application/pdf' } });
if ([401, 403].includes(response.status) || response.type === 'opaqueredirect' || (response.status >= 300 && response.status < 400)) {
clearPrivate(); setAuthError('Your leadership session ended. Sign in again to continue.'); return;
}
if (!response.ok || !response.headers.get('Content-Type')?.includes('application/pdf')) {
const result = await response.json().catch(() => null);
throw new Error(result?.message || 'The PDF could not be downloaded. Reopen the saved receipt and try again, or use Print receipt.');
}
const blob = await response.blob();
if (!allowed.current) return;
const url = URL.createObjectURL(blob);
const link = document.createElement('a'); link.href = url; link.download = `${receipt.receiptNumber}${receipt.status === 'void' ? '-VOID' : ''}.pdf`;
document.body.appendChild(link); link.click(); link.remove();
window.setTimeout(() => URL.revokeObjectURL(url), 30000);
} catch (failure) { if (allowed.current) setError(failure.message); }
finally { inFlight.current = false; setBusy(false); }
};
const voidReceipt = async (event) => {
event.preventDefault(); if (inFlight.current || !voidReason.trim()) return;
inFlight.current = true; setBusy(true); setError('');
try {
const result = await request(`/receipts/${encodeURIComponent(receipt.id)}/void`, { method: 'POST', body: JSON.stringify({ reason: voidReason.trim(), confirmation: true }) });
if (!allowed.current) return;
setReceipt(result.receipt); setVoidOpen(false); setNotice('Receipt marked void. The original record is retained. Notify the donor and treasurer if they already received a copy; the website does not send a void notice.'); await loadHistory();
} catch (failure) { if (allowed.current) setError(failure.message); }
finally { inFlight.current = false; setBusy(false); }
};
const field = (name, label, options = {}) =>