import { randomUUID } from "node:crypto"; import { ItemId, LETTER_MAX_BODY_CHARS } from "../../../shared/definitions/items.js"; import { attachOrigins, writtenOrigin } from "../../../shared/items/origin.js"; /** * Build a system-authored letter stack (authorCharacterId 0). * Callers should dispatch via CourierService.enqueueSystemLetter / dispatchSystemLetter * so online players get a pigeon immediately and offline players are held until login. */ export function makeSystemLetterStack ({ authorDisplayName, authorOrganization = null, body, centralExchange = false, bankRestNotice = false, letterId = null, writtenAt = Date.now() }) { const name = String(authorDisplayName ?? "").trim() || "Unknown"; const trimmed = String(body ?? "").replace(/\r\n/g, "\n").trimEnd().slice(0, LETTER_MAX_BODY_CHARS); const org = String(authorOrganization ?? "").trim() || null; const instance = { kind: "letter", letterId: letterId ?? randomUUID(), authorCharacterId: 0, authorDisplayName: name, body: trimmed, opened: false, writtenAt: writtenAt | 0 || Date.now() }; if (org) { instance.authorOrganization = org; } if (centralExchange) { instance.centralExchange = true; } if (bankRestNotice) { instance.bankRestNotice = true; } return attachOrigins({ itemId: ItemId.letter, quantity: 1, origins: [{ origin: writtenOrigin(name), quantity: 1 }], instance }); }