import { LAST_DIGEST_KEY, listUndelivered, markDelivered, setState, type LastDigest } from './store.ts' import { digestCounts, formatDigestText, orderDigest } from './digest-core.ts' import { parseNow } from './status-core.ts' import type { QueueItem } from './types.ts' export type DigestInput = { /** Preview only: do not mark anything delivered. */ dryRun?: boolean /** Who delivered it (e.g. 'kody-routine', 'discord-fallback'). Default 'digest'. */ via?: string /** Optional ISO instant to treat as now (tests). */ now?: string } export async function buildDigest(now: Date) { const items = await listUndelivered() const groups = orderDigest(items, now) return { groups, items: groups.flatMap((g) => g.items), counts: digestCounts(items), text: formatDigestText(groups), } } export async function recordDelivery(items: QueueItem[], via: string, now: Date) { const record: LastDigest = { id: crypto.randomUUID(), at: now.toISOString(), via, count: items.length, } await markDelivered(items.map((i) => i.id), record.id, record.at) await setState(LAST_DIGEST_KEY, record) return record } /** * The 8 AM digest: a report of finished work (done) and open decisions * (needs-decision) since the last digest, ordered urgent-but-resolved, * hard deadlines today, decisions blocking a bot, then FYI/done. Not a * backlog to kick off. Marks every returned item delivered (unless * `dryRun`), even when empty, so the 8:15 fallback stays quiet. * * @param input.dryRun - Preview without marking delivered * @param input.via - Delivery channel label recorded with the digest * @returns `{ digestId, deliveredAt, counts, buckets, items, text }` * * @example * import digest from 'kody:@kentcdodds/quiet-hours/digest' * const d = await digest({ via: 'kody-routine' }) * // d.text => 'Morning. Overnight: 9 done, 3 need you. ...' */ export default async function digest(input: DigestInput = {}) { const now = parseNow(input?.now) const built = await buildDigest(now) const buckets = built.groups.map((g) => ({ bucket: g.bucket, label: g.label, items: g.items })) if (input?.dryRun === true) { return { dryRun: true as const, digestId: null, deliveredAt: null, counts: built.counts, buckets, items: built.items, text: built.text } } const via = typeof input?.via === 'string' && input.via.trim() ? input.via.trim() : 'digest' const record = await recordDelivery(built.items, via, now) return { digestId: record.id, deliveredAt: record.at, counts: built.counts, buckets, items: built.items, text: built.text } }