import { ItemId } from "../definitions/items.js"; /** @param {object|null|undefined} stack */ export function isLetterStack (stack) { return (stack?.itemId | 0) === ItemId.letter && stack?.instance?.kind === "letter"; } /** * True when this character authored the letter (system letters use authorCharacterId 0). * @param {object|null|undefined} stack * @param {number} characterId */ export function isLetterWrittenBy (stack, characterId) { if (!isLetterStack(stack)) { return false; } const authorId = Number(stack.instance?.authorCharacterId); return authorId > 0 && authorId === Number(characterId); } /** * Letters you did not write cannot be pigeon'd or CE-listed to reach another player. * Inheritance is handled separately outside these checks. * @param {object|null|undefined} stack * @param {number} characterId */ export function canTransferLetterToOtherPlayers (stack, characterId) { if (!isLetterStack(stack)) { return true; } return isLetterWrittenBy(stack, characterId); } /** * A ground letter dropped by someone who did not write it is private to that dropper. * Accepts a full ground item (`stack` + `droppedByCharacterId`) or a public payload * (`itemId`/`instance` + `droppedByCharacterId`). */ export function isPrivateGroundLetter (item) { if (!item) { return false; } const stack = item.stack ?? { itemId: item.itemId, instance: item.instance }; if (!isLetterStack(stack)) { return false; } const dropperId = Number(item.droppedByCharacterId); if (!(dropperId > 0)) { return false; } return !isLetterWrittenBy(stack, dropperId); } /** @param {object} item @param {number} characterId */ export function canCharacterSeeGroundItem (item, characterId) { if (!isPrivateGroundLetter(item)) { return true; } return Number(item.droppedByCharacterId) === Number(characterId); } /** @param {object} item @param {number} characterId */ export function canCharacterPickupGroundItem (item, characterId) { return canCharacterSeeGroundItem(item, characterId); }