[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_318":319,"_320":321},"routes/_app.x.$handle.$name",{"_98":97,"_32":45,"_107":88,"_27":53,"_13":14,"_108":-5,"_11":109,"_110":111,"_112":113,"_114":115,"_116":117,"_20":-5,"_118":-5,"_119":-5,"_120":25,"_121":122,"_123":124,"_125":-5,"_126":-5,"_127":128},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_43":44,"_32":45,"_38":46,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":-5,"_57":25,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":81,"_82":83,"_84":85,"_86":25},"version",110,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":34,"_35":37,"_38":39,"_40":14,"_41":42,"_24":25},"previous",{"_30":31,"_32":28,"_33":34,"_35":36},"deleted",false,"deletedHere","path","combat.ts","latestPath","fileId","8de9ca4c-a4d9-11f1-a925-1607ee4eb77e","name","fileType","script","content","// Duels, party combat, monster duels, and initiative tracker\n\nimport { pickMonsterForLevel } from \"./data.ts\";\nimport {\n duelNarration,\n combatStats,\n firstAlive,\n} from \"./utils.ts\";\nimport {\n getCharacter,\n getDuel,\n getMonsterDuel,\n getParty,\n getPartyMembers,\n getPartyDuel,\n getEncounter,\n saveEncounter,\n sqlite,\n} from \"./db.ts\";\nimport { sendChatMessage, sendChatMessages } from \"./twitch.ts\";\nimport { awardMonsterXp } from \"./characters.ts\";\n\nexport async function duelSummary(d: any) {\n const a = await getCharacter(d.challenger);\n const b = await getCharacter(d.defender);\n return `Duel: ${d.challenger} ${d.challenger_hp}/${a?.hpMax ?? \"?\"} HP vs ${d.defender} ${d.defender_hp}/${b?.hpMax ?? \"?\"} HP. Turn: ${d.current_turn}.`;\n}\n\n/** Simulate one attack; mutates hp map. Returns a short log line. */\nfunction simulateAttack(\n attackerName: string,\n defenderName: string,\n attacker: { proficiency: number; scores: Record },\n defender: { proficiency: number; scores: Record },\n hp: Record,\n): string {\n const stats = combatStats(attacker as any);\n const targetStats = combatStats(defender as any);\n const roll = 1 + Math.floor(Math.random() * 20);\n const total = roll + stats.mod + attacker.proficiency;\n const critical = roll === 20;\n const hit = critical || (roll !== 1 && total >= targetStats.attack);\n const dice = critical\n ? 1 + Math.floor(Math.random() * stats.die) + (1 + Math.floor(Math.random() * stats.die))\n : 1 + Math.floor(Math.random() * stats.die);\n const damage = hit ? Math.max(1, dice + stats.mod) : 0;\n if (hit) hp[defenderName] = Math.max(0, (hp[defenderName] ?? 0) - damage);\n if (critical) return `${attackerName} CRIT ${damage}→${defenderName}(${hp[defenderName]}HP)`;\n if (hit) return `${attackerName} hit ${damage}→${defenderName}(${hp[defenderName]}HP)`;\n return `${attackerName} miss`;\n}\n\n/** Auto-resolve a 1v1 duel. Returns chat-ready summary lines. */\nfunction resolvePlayerDuel(\n aName: string,\n bName: string,\n aChar: any,\n bChar: any,\n): { winner: string; log: string; rounds: number } {\n const hp: Record = { [aName]: aChar.hpMax, [bName]: bChar.hpMax };\n const maxRounds = 40;\n const highlights: string[] = [];\n let rounds = 0;\n let turn = aName;\n while (hp[aName] > 0 && hp[bName] > 0 && rounds < maxRounds) {\n rounds++;\n const attackerName = turn;\n const defenderName = turn === aName ? bName : aName;\n const attacker = turn === aName ? aChar : bChar;\n const defender = turn === aName ? bChar : aChar;\n const line = simulateAttack(attackerName, defenderName, attacker, defender, hp);\n // Keep crits, finishing blows, and a sample of early hits\n if (line.includes(\"CRIT\") || hp[defenderName] <= 0 || highlights.length < 6) {\n highlights.push(line);\n }\n turn = defenderName;\n }\n const winner = hp[aName] > 0 ? aName : bName;\n const log = [\n `${aName} ${aChar.hpMax}HP vs ${bName} ${bChar.hpMax}HP — auto-resolved in ${rounds} swings.`,\n highlights.join(\" · \"),\n `${winner} wins! ${duelNarration(\"victory\")} Final: ${aName} ${hp[aName]}HP, ${bName} ${hp[bName]}HP.`,\n ].join(\" \");\n return { winner, log, rounds };\n}\n\nexport async function handleDuelCommand(\n chatMessage: string,\n username: string,\n display: string,\n broadcasterId: string,\n) {\n if (!/^!dndduel(?:\\s|$)/i.test(chatMessage)) return false;\n const parts = chatMessage.trim().split(/\\s+/);\n const action = (parts[1] ?? \"status\").toLowerCase();\n const active = await getDuel(broadcasterId);\n\n if (action === \"accept\" || action === \"decline\") {\n const res = await sqlite.execute(\n \"SELECT challenger, defender, mode FROM duel_challenges WHERE broadcaster_id = ? AND defender = ? ORDER BY created_at DESC LIMIT 1\",\n [broadcasterId, username],\n );\n if (!res.rows.length) {\n await sendChatMessage(`@${display} you have no pending duel challenge.`, broadcasterId);\n return true;\n }\n const challenge = res.rows[0];\n const mode = String(challenge.mode || \"auto\").toLowerCase() === \"classic\" ? \"classic\" : \"auto\";\n await sqlite.execute(\"DELETE FROM duel_challenges WHERE broadcaster_id = ? AND defender = ?\", [\n broadcasterId,\n username,\n ]);\n if (action === \"decline\") {\n await sendChatMessage(`@${display} duel declined. ${duelNarration(\"decline\")}`, broadcasterId);\n return true;\n }\n const challenger = await getCharacter(challenge.challenger);\n const defender = await getCharacter(username);\n if (!challenger || !defender) {\n await sendChatMessage(`@${display} both players need saved characters before dueling.`, broadcasterId);\n return true;\n }\n if (mode === \"classic\") {\n // Turn-based: store active duel; players use !dndduel attack.\n await sqlite.execute(\n \"INSERT OR REPLACE INTO duels (broadcaster_id,challenger,defender,current_turn,challenger_hp,defender_hp,active,updated_at) VALUES (?,?,?,?,?,?,1,?)\",\n [\n broadcasterId,\n challenge.challenger,\n username,\n challenge.challenger,\n challenger.hpMax,\n defender.hpMax,\n Date.now(),\n ],\n );\n await sendChatMessage(\n `@${display} accepted classic duel! ${challenge.challenger} goes first. ${duelNarration(\"accept\")} Use !dndduel attack on your turn, or !dndduel status / !dndduel end.`,\n broadcasterId,\n );\n return true;\n }\n // Auto-resolve mode\n await sqlite.execute(\"DELETE FROM duels WHERE broadcaster_id = ?\", [broadcasterId]);\n const result = resolvePlayerDuel(String(challenge.challenger), username, challenger, defender);\n await sendChatMessages(\n `@${display} accepted! ${duelNarration(\"accept\")} ${result.log}`,\n broadcasterId,\n );\n return true;\n }\n\n if (action === \"end\" || action === \"cancel\") {\n if (active && (active.challenger === username || active.defender === username)) {\n await sqlite.execute(\"DELETE FROM duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessage(`@${display} duel ended.`, broadcasterId);\n } else {\n await sendChatMessage(`@${display} no duel to end.`, broadcasterId);\n }\n return true;\n }\n\n if (action === \"status\" || action === \"show\") {\n await sendChatMessage(\n active ? `@${display} ${await duelSummary(active)}` : `@${display} no active duel. Challenge someone with !dndduel @username.`,\n broadcasterId,\n );\n return true;\n }\n\n if (action === \"attack\") {\n if (!active) {\n await sendChatMessage(`@${display} no active duel. Challenge someone with !dndduel @username.`, broadcasterId);\n return true;\n }\n if (active.current_turn !== username) {\n await sendChatMessage(`@${display} it is ${active.current_turn}'s turn.`, broadcasterId);\n return true;\n }\n const attacker = await getCharacter(username);\n const targetName = active.challenger === username ? active.defender : active.challenger;\n const target = await getCharacter(targetName);\n if (!attacker || !target) {\n await sendChatMessage(`@${display} both duel characters must still exist.`, broadcasterId);\n return true;\n }\n const stats = combatStats(attacker);\n const targetStats = combatStats(target);\n const roll = 1 + Math.floor(Math.random() * 20);\n const total = roll + stats.mod + attacker.proficiency;\n const critical = roll === 20;\n const hit = critical || (roll !== 1 && total >= targetStats.attack);\n const dice = critical\n ? 1 + Math.floor(Math.random() * stats.die) + (1 + Math.floor(Math.random() * stats.die))\n : 1 + Math.floor(Math.random() * stats.die);\n const damage = hit ? Math.max(1, dice + stats.mod) : 0;\n if (active.challenger === username) active.defender_hp = Math.max(0, active.defender_hp - damage);\n else active.challenger_hp = Math.max(0, active.challenger_hp - damage);\n const defeated = active.challenger_hp <= 0 || active.defender_hp <= 0;\n const result = `${username} rolled ${roll}${critical ? \" CRITICAL\" : \"\"} + ${stats.mod + attacker.proficiency} = ${total} vs AC ${targetStats.attack}: ${hit ? `hit for ${damage} damage` : \"miss\"}. ${duelNarration(critical ? \"critical\" : hit ? \"hit\" : \"miss\")}`;\n if (defeated) {\n const winner = active.challenger_hp > 0 ? active.challenger : active.defender;\n await sqlite.execute(\"DELETE FROM duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessage(`@${display} ${result} ${winner} wins the duel! ${duelNarration(\"victory\")}`, broadcasterId);\n } else {\n active.current_turn = targetName;\n await sqlite.execute(\n \"UPDATE duels SET current_turn = ?, challenger_hp = ?, defender_hp = ?, updated_at = ? WHERE broadcaster_id = ?\",\n [active.current_turn, active.challenger_hp, active.defender_hp, Date.now(), broadcasterId],\n );\n await sendChatMessages(`@${display} ${result} ${await duelSummary(active)}`, broadcasterId);\n }\n return true;\n }\n\n // Challenge: !dndduel @user (auto) | !dndduel classic @user | !dndduel turn @user\n let mode: \"auto\" | \"classic\" = \"auto\";\n let targetRaw = \"\";\n if (action === \"classic\" || action === \"turn\" || action === \"manual\") {\n mode = \"classic\";\n targetRaw = parts.slice(2).join(\" \");\n } else if (action === \"auto\" || action === \"quick\") {\n mode = \"auto\";\n targetRaw = parts.slice(2).join(\" \");\n } else {\n // Bare \"!dndduel @user\" — default auto\n targetRaw = parts.slice(1).join(\" \");\n }\n const targetName = targetRaw.replace(/^@/, \"\").toLowerCase().replace(/[,:]+$/, \"\");\n if (!targetName || [\"party\", \"monster\", \"accept\", \"decline\", \"attack\", \"status\", \"show\", \"end\", \"cancel\"].includes(targetName)) {\n await sendChatMessage(\n `@${display} Duels: !dndduel @user (auto) | !dndduel classic @user (turn-based) | !dndduel accept | !dndduel decline | !dndduel attack | !dndduel status | !dndduel end`,\n broadcasterId,\n );\n return true;\n }\n if (active) {\n await sendChatMessage(`@${display} a classic duel is already active in this channel. Finish it or !dndduel end.`, broadcasterId);\n return true;\n }\n const target = await getCharacter(targetName);\n const own = await getCharacter(username);\n if (!own || !target) {\n await sendChatMessage(`@${display} both players need saved characters before issuing a challenge.`, broadcasterId);\n return true;\n }\n if (targetName === username.toLowerCase()) {\n await sendChatMessage(`@${display} you cannot duel yourself.`, broadcasterId);\n return true;\n }\n await sqlite.execute(\n \"INSERT OR REPLACE INTO duel_challenges (broadcaster_id,challenger,defender,created_at,mode) VALUES (?,?,?,?,?)\",\n [broadcasterId, username, targetName, Date.now(), mode],\n );\n if (mode === \"classic\") {\n await sendChatMessage(\n `@${display} challenged @${targetName} to a classic turn-based duel! ${duelNarration(\"challenge\")} @${targetName}, type !dndduel accept or !dndduel decline.`,\n broadcasterId,\n );\n } else {\n await sendChatMessage(\n `@${display} challenged @${targetName} to a quick auto-duel! ${duelNarration(\"challenge\")} @${targetName}, type !dndduel accept or !dndduel decline.`,\n broadcasterId,\n );\n }\n return true;\n}\n\nexport async function monsterDuelText(d: any) {\n return `${d.player} vs ${d.monster_name} (CR ${d.monster_cr}) — Player HP ${d.player_hp ?? \"?\"}; Monster HP ${d.monster_hp}/${d.monster_hp_max}; AC ${d.monster_ac}; turn: ${d.current_turn}.`;\n}\n\nexport async function handleMonsterDuelCommand(\n chatMessage: string,\n username: string,\n display: string,\n broadcasterId: string,\n) {\n const normalized = chatMessage.trim().toLowerCase();\n if (\n !(\n normalized === \"!dndduel\" ||\n normalized === \"!dndduel attack\" ||\n normalized === \"!dndduel monster\" ||\n normalized === \"!dndduel monster classic\" ||\n normalized === \"!dndduel monster attack\" ||\n normalized === \"!dndduel monster status\" ||\n normalized === \"!dndduel monster end\"\n )\n ) {\n return false;\n }\n\n let active = await getMonsterDuel(broadcasterId);\n\n if (\n normalized === \"!dndduel monster status\" ||\n normalized === \"!dndduel monster end\" ||\n normalized === \"!dndduel monster attack\"\n ) {\n if (!active || active.player !== username) {\n await sendChatMessage(`@${display} you do not have an active monster duel.`, broadcasterId);\n return true;\n }\n if (normalized.endsWith(\"status\")) {\n await sendChatMessage(`@${display} ${await monsterDuelText(active)}`, broadcasterId);\n return true;\n }\n if (normalized.endsWith(\"end\")) {\n await sqlite.execute(\"DELETE FROM monster_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessage(\n `@${display} the monster duel ends. The dungeon master calls it a tactical retreat.`,\n broadcasterId,\n );\n return true;\n }\n }\n\n // Classic turn-based monster: !dndduel monster [classic]\n if (normalized === \"!dndduel monster\" || normalized === \"!dndduel monster classic\") {\n if (active && active.player === username) {\n await sendChatMessage(`@${display} ${await monsterDuelText(active)} Use !dndduel attack.`, broadcasterId);\n return true;\n }\n const c = await getCharacter(username);\n if (!c) {\n await sendChatMessage(\n `@${display} create a character first with !createchar, then !dndduel monster.`,\n broadcasterId,\n );\n return true;\n }\n const monster = pickMonsterForLevel(c.level);\n await sqlite.execute(\n \"INSERT OR REPLACE INTO monster_duels (broadcaster_id,player,monster_name,monster_cr,monster_ac,monster_hp,monster_hp_max,monster_attack,monster_damage_die,monster_damage_bonus,current_turn,active,updated_at) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?)\",\n [\n broadcasterId,\n username,\n monster.name,\n monster.cr,\n monster.ac,\n monster.hp,\n monster.hp,\n monster.attack,\n monster.die,\n monster.bonus,\n \"player\",\n 1,\n Date.now(),\n ],\n );\n await sendChatMessage(\n `@${display} classic monster fight! ${monster.name} (CR ${monster.cr}) AC ${monster.ac}, HP ${monster.hp}. Your HP: ${c.hpMax}. ${duelNarration(\"challenge\")} Use !dndduel attack.`,\n broadcasterId,\n );\n return true;\n }\n\n // Auto monster: bare !dndduel\n if (normalized === \"!dndduel\") {\n const c = await getCharacter(username);\n if (!c) {\n await sendChatMessage(\n `@${display} create a character first with !createchar, then challenge the wilds with !dndduel.`,\n broadcasterId,\n );\n return true;\n }\n const monster = pickMonsterForLevel(c.level);\n let playerHp = c.hpMax;\n let monsterHp = monster.hp;\n const pStats = combatStats(c);\n const playerAc = 10 + pStats.mod + c.proficiency;\n const highlights: string[] = [];\n let swings = 0;\n const maxSwings = 40;\n while (playerHp > 0 && monsterHp > 0 && swings < maxSwings) {\n swings++;\n const roll = 1 + Math.floor(Math.random() * 20);\n const total = roll + pStats.mod + c.proficiency;\n const critical = roll === 20;\n const hit = critical || (roll !== 1 && total >= monster.ac);\n const dice = critical\n ? 1 + Math.floor(Math.random() * 8) + 1 + Math.floor(Math.random() * 8)\n : 1 + Math.floor(Math.random() * 8);\n const damage = hit ? Math.max(1, dice + pStats.mod) : 0;\n if (hit) monsterHp = Math.max(0, monsterHp - damage);\n if (critical || monsterHp <= 0 || highlights.length < 4) {\n highlights.push(\n hit\n ? `${username}${critical ? \" CRIT\" : \"\"} ${damage}→${monster.name}(${monsterHp})`\n : `${username} miss`,\n );\n }\n if (monsterHp <= 0) break;\n const mRoll = 1 + Math.floor(Math.random() * 20);\n const mTotal = mRoll + monster.attack;\n const mHit = mRoll !== 1 && (mRoll === 20 || mTotal >= playerAc);\n const mDice = 1 + Math.floor(Math.random() * monster.die);\n const mDamage = mHit ? Math.max(1, mDice + monster.bonus) : 0;\n if (mHit) playerHp = Math.max(0, playerHp - mDamage);\n if (mRoll === 20 || playerHp <= 0 || highlights.length < 8) {\n highlights.push(\n mHit ? `${monster.name} ${mDamage}→${username}(${playerHp})` : `${monster.name} miss`,\n );\n }\n }\n await sqlite.execute(\"DELETE FROM monster_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n const won = monsterHp <= 0 && playerHp > 0;\n let xpNote = \"\";\n if (won) {\n const xp = await awardMonsterXp(username, monster.cr);\n if (xp) {\n xpNote = ` +${xp.gained} XP (total ${xp.total})${xp.leveledTo ? ` — leveled to ${xp.leveledTo}!` : \"\"}`;\n }\n }\n await sendChatMessages(\n `@${display} the D20 of Fate summons a ${monster.name} (CR ${monster.cr}, AC ${monster.ac}, HP ${monster.hp})! ${duelNarration(\"challenge\")} Auto-resolved (${swings} exchanges): ${highlights.join(\" · \")} — ${won ? `${username} defeats ${monster.name}! ${duelNarration(\"victory\")}${xpNote}` : `${monster.name} wins. ${duelNarration(\"defeat\")}`} Final HP: you ${playerHp}/${c.hpMax}, ${monster.name} ${monsterHp}/${monster.hp}.`,\n broadcasterId,\n );\n return true;\n }\n\n if (\n (normalized === \"!dndduel attack\" || normalized === \"!dndduel monster attack\") &&\n active &&\n active.player === username\n ) {\n if (active.current_turn !== \"player\") {\n await sendChatMessage(`@${display} the monster is still acting.`, broadcasterId);\n return true;\n }\n const player = await getCharacter(username);\n if (!player) {\n await sendChatMessage(`@${display} your character no longer exists.`, broadcasterId);\n return true;\n }\n const pStats = combatStats(player);\n const playerHp = Number(active.player_hp ?? player.hpMax);\n const roll = 1 + Math.floor(Math.random() * 20);\n const total = roll + pStats.mod + player.proficiency;\n const critical = roll === 20;\n const hit = critical || (roll !== 1 && total >= Number(active.monster_ac));\n const dice = critical\n ? 1 + Math.floor(Math.random() * 8) + 1 + Math.floor(Math.random() * 8)\n : 1 + Math.floor(Math.random() * 8);\n const damage = hit ? Math.max(1, dice + pStats.mod) : 0;\n active.monster_hp = Math.max(0, Number(active.monster_hp) - damage);\n const playerResult = `${username} attacks ${active.monster_name}: d20 ${roll}${critical ? \" CRITICAL\" : \"\"} + ${pStats.mod + player.proficiency} = ${total} vs AC ${active.monster_ac}; ${hit ? `hit for ${damage} damage` : \"miss\"}. ${duelNarration(critical ? \"critical\" : hit ? \"hit\" : \"miss\")}`;\n if (active.monster_hp <= 0) {\n await sqlite.execute(\"DELETE FROM monster_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n const xp = await awardMonsterXp(username, String(active.monster_cr ?? \"1\"));\n const xpNote = xp\n ? ` +${xp.gained} XP (total ${xp.total})${xp.leveledTo ? ` — leveled to ${xp.leveledTo}!` : \"\"}`\n : \"\";\n await sendChatMessage(\n `@${display} ${playerResult} ${active.monster_name} is defeated! ${duelNarration(\"victory\")}${xpNote}`,\n broadcasterId,\n );\n return true;\n }\n const monsterRoll = 1 + Math.floor(Math.random() * 20);\n const monsterTotal = monsterRoll + Number(active.monster_attack);\n const playerAc = 10 + pStats.mod + player.proficiency;\n const monsterHit = monsterRoll !== 1 && (monsterRoll === 20 || monsterTotal >= playerAc);\n const monsterDice = 1 + Math.floor(Math.random() * Number(active.monster_damage_die));\n const monsterDamage = monsterHit ? Math.max(1, monsterDice + Number(active.monster_damage_bonus)) : 0;\n const nextPlayerHp = Math.max(0, playerHp - monsterDamage);\n active.player_hp = nextPlayerHp;\n const monsterResult = `${active.monster_name} retaliates: d20 ${monsterRoll} + ${active.monster_attack} = ${monsterTotal} vs AC ${playerAc}; ${monsterHit ? `hit for ${monsterDamage} damage` : \"miss\"}. ${duelNarration(monsterHit ? \"hit\" : \"miss\")}`;\n if (nextPlayerHp <= 0) {\n await sqlite.execute(\"DELETE FROM monster_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessages(\n `@${display} ${playerResult} ${monsterResult} ${duelNarration(\"defeat\")} ${active.monster_name} wins this encounter.`,\n broadcasterId,\n );\n } else {\n await sqlite.execute(\n \"UPDATE monster_duels SET player_hp = ?, monster_hp = ?, current_turn = ?, updated_at = ? WHERE broadcaster_id = ?\",\n [nextPlayerHp, active.monster_hp, \"player\", Date.now(), broadcasterId],\n );\n await sendChatMessages(\n `@${display} ${playerResult} ${monsterResult} ${await monsterDuelText({ ...active, player_hp: nextPlayerHp })}`,\n broadcasterId,\n );\n }\n return true;\n }\n\n return false;\n}\n\nexport async function partySummary(broadcasterId: string, partyName: string) {\n const party = await getParty(broadcasterId, partyName);\n if (!party) return `party ${partyName} was not found`;\n const members = await getPartyMembers(broadcasterId, partyName);\n return `${party.party_name} (leader ${party.owner}): ${members.length ? members.join(\", \") : \"no members\"}`;\n}\n\nexport async function handlePartyCommand(\n chatMessage: string,\n username: string,\n display: string,\n broadcasterId: string,\n) {\n if (!/^!party(?:\\s|$)/i.test(chatMessage)) return false;\n // Twitch logins are case-insensitive; always normalize for storage/lookup.\n const me = username.toLowerCase();\n const parts = chatMessage.trim().split(/\\s+/);\n const action = (parts[1] ?? \"list\").toLowerCase();\n const sanitizeParty = (raw: string) =>\n (raw ?? \"\").replace(/^@/, \"\").toLowerCase().replace(/[^a-z0-9_-]/g, \"\");\n const name = sanitizeParty(parts[2] ?? \"\");\n\n if (action === \"create\") {\n if (!name) {\n await sendChatMessage(`@${display} use !party create .`, broadcasterId);\n return true;\n }\n if (await getParty(broadcasterId, name)) {\n await sendChatMessage(`@${display} that party already exists.`, broadcasterId);\n return true;\n }\n // Creator is always owner AND a member so they can invite immediately.\n await sqlite.execute(\n \"INSERT INTO parties (broadcaster_id,party_name,owner,created_at) VALUES (?,?,?,?)\",\n [broadcasterId, name, me, Date.now()],\n );\n await sqlite.execute(\n \"INSERT OR IGNORE INTO party_members (broadcaster_id,party_name,username,joined_at) VALUES (?,?,?,?)\",\n [broadcasterId, name, me, Date.now()],\n );\n await sendChatMessage(\n `@${display} party ${name} created. You are the leader and a member. Invite with !party invite @user ${name}`,\n broadcasterId,\n );\n return true;\n }\n\n if (action === \"join\") {\n const party = await getParty(broadcasterId, name);\n if (!party) await sendChatMessage(`@${display} party ${name} was not found.`, broadcasterId);\n else if (!(await getCharacter(me))) {\n await sendChatMessage(`@${display} create a character before joining a party.`, broadcasterId);\n } else {\n await sqlite.execute(\n \"INSERT OR IGNORE INTO party_members (broadcaster_id,party_name,username,joined_at) VALUES (?,?,?,?)\",\n [broadcasterId, name, me, Date.now()],\n );\n await sendChatMessage(`@${display} joined party ${name}.`, broadcasterId);\n }\n return true;\n }\n\n if (action === \"leave\") {\n if (!name) {\n await sendChatMessage(`@${display} use !party leave .`, broadcasterId);\n return true;\n }\n const party = await getParty(broadcasterId, name);\n if (!party) await sendChatMessage(`@${display} party ${name} was not found.`, broadcasterId);\n else if (String(party.owner).toLowerCase() === me) {\n await sendChatMessage(`@${display} leaders must use !party disband ${name}.`, broadcasterId);\n } else {\n await sqlite.execute(\n \"DELETE FROM party_members WHERE broadcaster_id = ? AND party_name = ? AND username = ?\",\n [broadcasterId, name, me],\n );\n await sendChatMessage(`@${display} left party ${name}.`, broadcasterId);\n }\n return true;\n }\n\n if (action === \"invite\") {\n const target = (parts[2] ?? \"\").replace(/^@/, \"\").toLowerCase().replace(/[,:]+$/, \"\");\n let partyName = sanitizeParty(parts[3] ?? \"\");\n\n // If party name omitted, use a party this user owns (or is the only member of).\n if (target && !partyName) {\n const owned = await sqlite.execute(\n \"SELECT party_name FROM parties WHERE broadcaster_id = ? AND lower(owner) = ? ORDER BY created_at ASC\",\n [broadcasterId, me],\n );\n if (owned.rows.length === 1) {\n partyName = String(owned.rows[0].party_name);\n } else {\n const membership = await sqlite.execute(\n \"SELECT party_name FROM party_members WHERE broadcaster_id = ? AND lower(username) = ? ORDER BY party_name\",\n [broadcasterId, me],\n );\n if (membership.rows.length === 1) partyName = String(membership.rows[0].party_name);\n }\n }\n\n if (!target || !partyName) {\n await sendChatMessage(\n `@${display} use !party invite @user (party name optional if you only lead/belong to one party).`,\n broadcasterId,\n );\n return true;\n }\n\n const party = await getParty(broadcasterId, partyName);\n if (!party) {\n await sendChatMessage(`@${display} party ${partyName} was not found.`, broadcasterId);\n return true;\n }\n\n // Repair: if this user is the owner but missing from members, add them.\n const ownerName = String(party.owner).toLowerCase();\n if (ownerName === me) {\n await sqlite.execute(\n \"INSERT OR IGNORE INTO party_members (broadcaster_id,party_name,username,joined_at) VALUES (?,?,?,?)\",\n [broadcasterId, partyName, me, Date.now()],\n );\n }\n\n const members = (await getPartyMembers(broadcasterId, partyName)).map((m) => m.toLowerCase());\n const isOwner = ownerName === me;\n const isMember = members.includes(me);\n if (!isOwner && !isMember) {\n await sendChatMessage(`@${display} only a party member or the leader can invite someone to that party.`, broadcasterId);\n return true;\n }\n if (target === me) {\n await sendChatMessage(`@${display} you are already in party ${partyName}.`, broadcasterId);\n return true;\n }\n if (!(await getCharacter(target))) {\n await sendChatMessage(`@${display} that player needs a saved character first.`, broadcasterId);\n return true;\n }\n await sqlite.execute(\n \"INSERT OR IGNORE INTO party_members (broadcaster_id,party_name,username,joined_at) VALUES (?,?,?,?)\",\n [broadcasterId, partyName, target, Date.now()],\n );\n await sendChatMessage(`@${display} @${target} joined party ${partyName}.`, broadcasterId);\n return true;\n }\n\n if (action === \"disband\") {\n const party = await getParty(broadcasterId, name);\n if (!party) await sendChatMessage(`@${display} party ${name} was not found.`, broadcasterId);\n else if (String(party.owner).toLowerCase() !== me) {\n await sendChatMessage(`@${display} only the party leader can disband that party.`, broadcasterId);\n } else {\n await sqlite.execute(\"DELETE FROM party_members WHERE broadcaster_id = ? AND party_name = ?\", [\n broadcasterId,\n name,\n ]);\n await sqlite.execute(\"DELETE FROM parties WHERE broadcaster_id = ? AND party_name = ?\", [\n broadcasterId,\n name,\n ]);\n await sendChatMessage(`@${display} party ${name} disbanded.`, broadcasterId);\n }\n return true;\n }\n\n if (action === \"list\" || action === \"show\") {\n if (name) {\n await sendChatMessage(`@${display} ${await partySummary(broadcasterId, name)}.`, broadcasterId);\n } else {\n const res = await sqlite.execute(\n \"SELECT party_name FROM party_members WHERE broadcaster_id = ? AND lower(username) = ? ORDER BY party_name\",\n [broadcasterId, me],\n );\n await sendChatMessage(\n `@${display} your parties: ${res.rows.length ? res.rows.map((r: any) => r.party_name).join(\", \") : \"none\"}.`,\n broadcasterId,\n );\n }\n return true;\n }\n\n await sendChatMessage(\n `@${display} Party: !party create | !party join | !party invite @user | !party list [name] | !party leave | !party disband .`,\n broadcasterId,\n );\n return true;\n}\n\nexport async function partyDuelText(d: any) {\n const left = d.challenger_members.map((n: string) => `${n} ${d.challenger_hp[n] ?? 0} HP`).join(\", \");\n const right = d.defender_members.map((n: string) => `${n} ${d.defender_hp[n] ?? 0} HP`).join(\", \");\n const active =\n d.current_side === \"challenger\"\n ? d.challenger_members[d.current_index]\n : d.defender_members[d.current_index];\n return `Party duel ${d.challenger_party} [${left}] vs ${d.defender_party} [${right}]. Turn: ${active ?? \"none\"}.`;\n}\n\nexport async function handlePartyDuelCommand(\n chatMessage: string,\n username: string,\n display: string,\n broadcasterId: string,\n) {\n if (!/^!dndduel\\s+party(?:\\s|$)/i.test(chatMessage)) return false;\n const parts = chatMessage.trim().split(/\\s+/);\n const sub = (parts[2] ?? \"\").toLowerCase();\n let active = await getPartyDuel(broadcasterId);\n\n if (sub === \"accept\" || sub === \"decline\") {\n const res = await sqlite.execute(\n \"SELECT * FROM party_duel_challenges WHERE broadcaster_id = ? AND defender_owner = ? ORDER BY created_at DESC LIMIT 1\",\n [broadcasterId, username],\n );\n if (!res.rows.length) {\n await sendChatMessage(`@${display} no party duel challenge is waiting for you.`, broadcasterId);\n return true;\n }\n const challenge = res.rows[0];\n const mode = String(challenge.mode || \"auto\").toLowerCase() === \"classic\" ? \"classic\" : \"auto\";\n await sqlite.execute(\"DELETE FROM party_duel_challenges WHERE broadcaster_id = ? AND defender_owner = ?\", [\n broadcasterId,\n username,\n ]);\n if (sub === \"decline\") {\n await sendChatMessage(`@${display} party duel declined. ${duelNarration(\"decline\")}`, broadcasterId);\n return true;\n }\n const attackers = await getPartyMembers(broadcasterId, challenge.challenger_party);\n const defenders = await getPartyMembers(broadcasterId, challenge.defender_party);\n const aChars: Record = {};\n const dChars: Record = {};\n const aHp: Record = {};\n const dHp: Record = {};\n for (const n of attackers) {\n const c = await getCharacter(n);\n if (c) {\n aChars[n] = c;\n aHp[n] = c.hpMax;\n }\n }\n for (const n of defenders) {\n const c = await getCharacter(n);\n if (c) {\n dChars[n] = c;\n dHp[n] = c.hpMax;\n }\n }\n if (\n !attackers.length ||\n !defenders.length ||\n Object.keys(aHp).length !== attackers.length ||\n Object.keys(dHp).length !== defenders.length\n ) {\n await sendChatMessage(\n `@${display} both parties need at least one member with a saved character.`,\n broadcasterId,\n );\n return true;\n }\n\n if (mode === \"classic\") {\n await sqlite.execute(\n \"INSERT OR REPLACE INTO party_duels (broadcaster_id,challenger_party,defender_party,current_side,current_index,challenger_members,defender_members,challenger_hp,defender_hp,active,updated_at) VALUES (?,?,?,?,?,?,?,?,?,1,?)\",\n [\n broadcasterId,\n challenge.challenger_party,\n challenge.defender_party,\n \"challenger\",\n 0,\n JSON.stringify(attackers),\n JSON.stringify(defenders),\n JSON.stringify(aHp),\n JSON.stringify(dHp),\n Date.now(),\n ],\n );\n await sendChatMessage(\n `@${display} classic party duel accepted! ${challenge.challenger_party} goes first. ${duelNarration(\"accept\")} Use !dndduel party attack [@target].`,\n broadcasterId,\n );\n return true;\n }\n\n // Auto-resolve party duel\n const highlights: string[] = [];\n let side: \"challenger\" | \"defender\" = \"challenger\";\n let swings = 0;\n const maxSwings = 80;\n while (\n attackers.some((n) => aHp[n] > 0) &&\n defenders.some((n) => dHp[n] > 0) &&\n swings < maxSwings\n ) {\n swings++;\n const atkMembers = side === \"challenger\" ? attackers : defenders;\n const atkHp = side === \"challenger\" ? aHp : dHp;\n const atkChars = side === \"challenger\" ? aChars : dChars;\n const defMembers = side === \"challenger\" ? defenders : attackers;\n const defHp = side === \"challenger\" ? dHp : aHp;\n const defChars = side === \"challenger\" ? dChars : aChars;\n const attackerName = atkMembers.find((n) => atkHp[n] > 0);\n const defenderName = defMembers.find((n) => defHp[n] > 0);\n if (!attackerName || !defenderName) break;\n const line = simulateAttack(\n attackerName,\n defenderName,\n atkChars[attackerName],\n defChars[defenderName],\n defHp,\n );\n if (line.includes(\"CRIT\") || defHp[defenderName] <= 0 || highlights.length < 8) {\n highlights.push(line);\n }\n side = side === \"challenger\" ? \"defender\" : \"challenger\";\n }\n const challengerAlive = attackers.some((n) => aHp[n] > 0);\n const winnerParty = challengerAlive ? challenge.challenger_party : challenge.defender_party;\n const left = attackers.map((n) => `${n}:${aHp[n]}`).join(\",\");\n const right = defenders.map((n) => `${n}:${dHp[n]}`).join(\",\");\n await sqlite.execute(\"DELETE FROM party_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessages(\n `@${display} party duel accepted! ${duelNarration(\"accept\")} ${challenge.challenger_party} vs ${challenge.defender_party} auto-resolved (${swings} swings). ${highlights.join(\" · \")} — ${winnerParty} wins! ${duelNarration(\"victory\")} HP [${left}] vs [${right}]`,\n broadcasterId,\n );\n return true;\n }\n\n if (sub === \"status\" || sub === \"show\") {\n active = active ?? null;\n await sendChatMessage(\n active ? `@${display} ${await partyDuelText(active)}` : `@${display} no active party duel.`,\n broadcasterId,\n );\n return true;\n }\n\n if (sub === \"end\") {\n if (!active) await sendChatMessage(`@${display} no active party duel.`, broadcasterId);\n else {\n const all = [...active.challenger_members, ...active.defender_members];\n const member = all.includes(username);\n const ownerA = (await getParty(broadcasterId, active.challenger_party))?.owner === username;\n const ownerB = (await getParty(broadcasterId, active.defender_party))?.owner === username;\n if (!member && !ownerA && !ownerB) {\n await sendChatMessage(`@${display} only a party member or leader can end this duel.`, broadcasterId);\n } else {\n await sqlite.execute(\"DELETE FROM party_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessage(`@${display} party duel ended.`, broadcasterId);\n }\n }\n return true;\n }\n\n if (sub === \"attack\") {\n if (!active) {\n await sendChatMessage(`@${display} no active party duel.`, broadcasterId);\n return true;\n }\n const members = active.current_side === \"challenger\" ? active.challenger_members : active.defender_members;\n const ownHp = active.current_side === \"challenger\" ? active.challenger_hp : active.defender_hp;\n const enemyMembers = active.current_side === \"challenger\" ? active.defender_members : active.challenger_members;\n const enemyHp = active.current_side === \"challenger\" ? active.defender_hp : active.challenger_hp;\n const attackerName = members[active.current_index];\n if (attackerName !== username) {\n await sendChatMessage(`@${display} it is ${attackerName}'s turn.`, broadcasterId);\n return true;\n }\n const attacker = await getCharacter(attackerName);\n const targetQuery = parts[3]?.replace(/^@/, \"\").toLowerCase();\n const targetName =\n targetQuery && enemyMembers.includes(targetQuery) && enemyHp[targetQuery] > 0\n ? targetQuery\n : enemyMembers.find((n: string) => enemyHp[n] > 0);\n const target = targetName ? await getCharacter(targetName) : null;\n if (!attacker || !target || !targetName) {\n await sendChatMessage(`@${display} no living target remains.`, broadcasterId);\n return true;\n }\n const stats = combatStats(attacker);\n const targetStats = combatStats(target);\n const roll = 1 + Math.floor(Math.random() * 20);\n const total = roll + stats.mod + attacker.proficiency;\n const critical = roll === 20;\n const hit = critical || (roll !== 1 && total >= targetStats.attack);\n const dice = critical\n ? 1 + Math.floor(Math.random() * 8) + (1 + Math.floor(Math.random() * 8))\n : 1 + Math.floor(Math.random() * 8);\n const damage = hit ? Math.max(1, dice + stats.mod) : 0;\n enemyHp[targetName] = Math.max(0, enemyHp[targetName] - damage);\n const result = `${attackerName} rolled ${roll}${critical ? \" CRITICAL\" : \"\"} + ${stats.mod + attacker.proficiency} = ${total} vs AC ${targetStats.attack}: ${hit ? `hit ${targetName} for ${damage} damage` : \"miss\"}. ${duelNarration(critical ? \"critical\" : hit ? \"hit\" : \"miss\")}`;\n const defeated = enemyMembers.every((n: string) => Number(enemyHp[n]) <= 0);\n if (defeated) {\n const winner = active.current_side === \"challenger\" ? active.challenger_party : active.defender_party;\n await sqlite.execute(\"DELETE FROM party_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessage(\n `@${display} ${result} ${winner} wins the party duel! ${duelNarration(\"victory\")}`,\n broadcasterId,\n );\n } else {\n const nextSide = active.current_side === \"challenger\" ? \"defender\" : \"challenger\";\n const nextMembers = nextSide === \"challenger\" ? active.challenger_members : active.defender_members;\n const nextHp = nextSide === \"challenger\" ? active.challenger_hp : active.defender_hp;\n active.current_side = nextSide;\n active.current_index = firstAlive(nextMembers, nextHp);\n await sqlite.execute(\n \"UPDATE party_duels SET current_side = ?, current_index = ?, challenger_hp = ?, defender_hp = ?, updated_at = ? WHERE broadcaster_id = ?\",\n [\n active.current_side,\n active.current_index,\n JSON.stringify(active.challenger_hp),\n JSON.stringify(active.defender_hp),\n Date.now(),\n broadcasterId,\n ],\n );\n await sendChatMessages(`@${display} ${result} ${await partyDuelText(active)}`, broadcasterId);\n }\n return true;\n }\n\n // Challenge: !dndduel party (auto)\n // !dndduel party classic (turn-based)\n let partyMode: \"auto\" | \"classic\" = \"auto\";\n let challengerParty = \"\";\n let defenderParty = \"\";\n const p2 = (parts[2] ?? \"\").toLowerCase();\n const p3 = (parts[3] ?? \"\").toLowerCase();\n const p4 = (parts[4] ?? \"\").toLowerCase();\n if (p2 === \"classic\" || p2 === \"turn\" || p2 === \"manual\") {\n partyMode = \"classic\";\n challengerParty = p3;\n defenderParty = p4;\n } else if (p2 === \"auto\" || p2 === \"quick\") {\n partyMode = \"auto\";\n challengerParty = p3;\n defenderParty = p4;\n } else {\n challengerParty = p2;\n defenderParty = p3;\n }\n if (!challengerParty || !defenderParty) {\n await sendChatMessage(\n `@${display} Party duels: !dndduel party (auto) | !dndduel party classic (turn-based) | !dndduel party accept | !dndduel party decline`,\n broadcasterId,\n );\n return true;\n }\n if (active) {\n await sendChatMessage(`@${display} a classic party duel is already active in this channel.`, broadcasterId);\n return true;\n }\n const ownParty = await getParty(broadcasterId, challengerParty);\n const targetParty = await getParty(broadcasterId, defenderParty);\n const ownMembers = ownParty ? await getPartyMembers(broadcasterId, challengerParty) : [];\n if (!ownParty || !targetParty || String(ownParty.owner).toLowerCase() !== username.toLowerCase() || !ownMembers.length) {\n await sendChatMessage(\n `@${display} you must lead a non-empty party, and both parties must exist.`,\n broadcasterId,\n );\n return true;\n }\n if (String(targetParty.owner).toLowerCase() === username.toLowerCase()) {\n await sendChatMessage(`@${display} you cannot challenge your own party.`, broadcasterId);\n return true;\n }\n await sqlite.execute(\n \"INSERT OR REPLACE INTO party_duel_challenges (broadcaster_id,challenger_party,defender_party,challenger_owner,defender_owner,created_at,mode) VALUES (?,?,?,?,?,?,?)\",\n [broadcasterId, challengerParty, defenderParty, username, targetParty.owner, Date.now(), partyMode],\n );\n await sendChatMessage(\n `@${display} party ${challengerParty} challenged party ${defenderParty} to a ${partyMode === \"classic\" ? \"classic turn-based\" : \"quick auto\"} duel! ${duelNarration(\"challenge\")} @${targetParty.owner}, use !dndduel party accept or !dndduel party decline.`,\n broadcasterId,\n );\n return true;\n}\n\nexport function encounterText(e: any) {\n const order = e.entries\n .map((x: any, i: number) => `${i === e.currentIndex && e.active ? \"▶\" : \"•\"} ${x.name} ${x.initiative}`)\n .join(\" | \");\n return `Initiative R${e.round}: ${order || \"no combatants\"}`;\n}\n\nexport async function handleInitiativeCommand(\n chatMessage: string,\n broadcasterId: string,\n display: string,\n isModerator: boolean,\n) {\n if (!chatMessage.toLowerCase().startsWith(\"!turn\")) return false;\n if (!isModerator) {\n await sendChatMessage(`@${display} only the broadcaster or a moderator can manage initiative.`, broadcasterId);\n return true;\n }\n const parts = chatMessage.trim().split(/\\s+/);\n const action = (parts[1] ?? \"show\").toLowerCase();\n let e = await getEncounter(broadcasterId);\n\n if (action === \"start\") {\n e = { broadcasterId, round: 1, currentIndex: 0, active: true, entries: [] };\n await saveEncounter(e);\n await sendChatMessage(\n `@${display} combat started. Add combatants with !turn add .`,\n broadcasterId,\n );\n return true;\n }\n\n if (action === \"end\" || action === \"clear\") {\n if (e) await sqlite.execute(\"DELETE FROM encounters WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessage(`@${display} combat ended and initiative cleared.`, broadcasterId);\n return true;\n }\n\n if (!e || !e.active) {\n await sendChatMessage(`@${display} no active encounter. Start one with !turn start.`, broadcasterId);\n return true;\n }\n\n if (action === \"add\") {\n const match = chatMessage.match(/^!turn\\s+add\\s+(.+?)\\s+(\\d+)$/i);\n const initiative = match ? Number(match[2]) : NaN;\n if (!match || !Number.isInteger(initiative) || initiative < 0 || initiative > 50) {\n await sendChatMessage(\n `@${display} use !turn add , such as !turn add Goblin 15.`,\n broadcasterId,\n );\n return true;\n }\n const name = match[1].replace(/^@/, \"\").trim();\n const existing = e.entries.find((x: any) => x.name.toLowerCase() === name.toLowerCase());\n if (existing) existing.initiative = initiative;\n else e.entries.push({ name, initiative });\n e.entries.sort((a: any, b: any) => b.initiative - a.initiative);\n e.currentIndex = 0;\n await saveEncounter(e);\n await sendChatMessages(`@${display} ${encounterText(e)}`, broadcasterId);\n return true;\n }\n\n if (action === \"remove\") {\n const name = parts.slice(2).join(\" \").replace(/^@/, \"\");\n e.entries = e.entries.filter((x: any) => x.name.toLowerCase() !== name.toLowerCase());\n e.currentIndex = Math.min(e.currentIndex, Math.max(0, e.entries.length - 1));\n await saveEncounter(e);\n await sendChatMessages(`@${display} ${encounterText(e)}`, broadcasterId);\n return true;\n }\n\n if (action === \"next\" || action === \"prev\") {\n if (!e.entries.length) {\n await sendChatMessage(\n `@${display} add combatants first with !turn add .`,\n broadcasterId,\n );\n return true;\n }\n const step = action === \"next\" ? 1 : -1;\n const nextIndex = e.currentIndex + step;\n if (nextIndex >= e.entries.length) {\n e.currentIndex = 0;\n e.round += 1;\n } else if (nextIndex < 0) {\n e.currentIndex = e.entries.length - 1;\n e.round = Math.max(1, e.round - 1);\n } else e.currentIndex = nextIndex;\n await saveEncounter(e);\n await sendChatMessages(`@${display} ${encounterText(e)}`, broadcasterId);\n return true;\n }\n\n if (action === \"show\" || action === \"list\") {\n await sendChatMessages(`@${display} ${encounterText(e)}`, broadcasterId);\n return true;\n }\n\n await sendChatMessage(\n `@${display} Initiative: !turn start | !turn add | !turn show | !turn next | !turn prev | !turn remove | !turn end`,\n broadcasterId,\n );\n return true;\n}\n","// Duels, party combat, monster duels, and initiative tracker\n\nimport { pickMonsterForLevel } from \"./data.ts\";\nimport {\n duelNarration,\n combatStats,\n firstAlive,\n} from \"./utils.ts\";\nimport {\n getCharacter,\n getDuel,\n getMonsterDuel,\n getParty,\n getPartyMembers,\n getPartyDuel,\n getPartyMonsterDuel,\n getEncounter,\n saveEncounter,\n sqlite,\n} from \"./db.ts\";\nimport { sendChatMessage, sendChatMessages } from \"./twitch.ts\";\nimport { awardMonsterXp } from \"./characters.ts\";\n\nexport async function duelSummary(d: any) {\n const a = await getCharacter(d.challenger);\n const b = await getCharacter(d.defender);\n return `Duel: ${d.challenger} ${d.challenger_hp}/${a?.hpMax ?? \"?\"} HP vs ${d.defender} ${d.defender_hp}/${b?.hpMax ?? \"?\"} HP. Turn: ${d.current_turn}.`;\n}\n\n/** Simulate one attack; mutates hp map. Returns a short log line. */\nfunction simulateAttack(\n attackerName: string,\n defenderName: string,\n attacker: { proficiency: number; scores: Record },\n defender: { proficiency: number; scores: Record },\n hp: Record,\n): string {\n const stats = combatStats(attacker as any);\n const targetStats = combatStats(defender as any);\n const roll = 1 + Math.floor(Math.random() * 20);\n const total = roll + stats.mod + attacker.proficiency;\n const critical = roll === 20;\n const hit = critical || (roll !== 1 && total >= targetStats.attack);\n const dice = critical\n ? 1 + Math.floor(Math.random() * stats.die) + (1 + Math.floor(Math.random() * stats.die))\n : 1 + Math.floor(Math.random() * stats.die);\n const damage = hit ? Math.max(1, dice + stats.mod) : 0;\n if (hit) hp[defenderName] = Math.max(0, (hp[defenderName] ?? 0) - damage);\n if (critical) return `${attackerName} CRIT ${damage}→${defenderName}(${hp[defenderName]}HP)`;\n if (hit) return `${attackerName} hit ${damage}→${defenderName}(${hp[defenderName]}HP)`;\n return `${attackerName} miss`;\n}\n\n/** Auto-resolve a 1v1 duel. Returns chat-ready summary lines. */\nfunction resolvePlayerDuel(\n aName: string,\n bName: string,\n aChar: any,\n bChar: any,\n): { winner: string; log: string; rounds: number } {\n const hp: Record = { [aName]: aChar.hpMax, [bName]: bChar.hpMax };\n const maxRounds = 40;\n const highlights: string[] = [];\n let rounds = 0;\n let turn = aName;\n while (hp[aName] > 0 && hp[bName] > 0 && rounds < maxRounds) {\n rounds++;\n const attackerName = turn;\n const defenderName = turn === aName ? bName : aName;\n const attacker = turn === aName ? aChar : bChar;\n const defender = turn === aName ? bChar : aChar;\n const line = simulateAttack(attackerName, defenderName, attacker, defender, hp);\n // Keep crits, finishing blows, and a sample of early hits\n if (line.includes(\"CRIT\") || hp[defenderName] <= 0 || highlights.length < 6) {\n highlights.push(line);\n }\n turn = defenderName;\n }\n const winner = hp[aName] > 0 ? aName : bName;\n const log = [\n `${aName} ${aChar.hpMax}HP vs ${bName} ${bChar.hpMax}HP — auto-resolved in ${rounds} swings.`,\n highlights.join(\" · \"),\n `${winner} wins! ${duelNarration(\"victory\")} Final: ${aName} ${hp[aName]}HP, ${bName} ${hp[bName]}HP.`,\n ].join(\" \");\n return { winner, log, rounds };\n}\n\nexport async function handleDuelCommand(\n chatMessage: string,\n username: string,\n display: string,\n broadcasterId: string,\n) {\n if (!/^!dndduel(?:\\s|$)/i.test(chatMessage)) return false;\n const parts = chatMessage.trim().split(/\\s+/);\n const action = (parts[1] ?? \"status\").toLowerCase();\n const active = await getDuel(broadcasterId);\n\n if (action === \"accept\" || action === \"decline\") {\n const res = await sqlite.execute(\n \"SELECT challenger, defender, mode FROM duel_challenges WHERE broadcaster_id = ? AND defender = ? ORDER BY created_at DESC LIMIT 1\",\n [broadcasterId, username],\n );\n if (!res.rows.length) {\n await sendChatMessage(`@${display} you have no pending duel challenge.`, broadcasterId);\n return true;\n }\n const challenge = res.rows[0];\n const mode = String(challenge.mode || \"auto\").toLowerCase() === \"classic\" ? \"classic\" : \"auto\";\n await sqlite.execute(\"DELETE FROM duel_challenges WHERE broadcaster_id = ? AND defender = ?\", [\n broadcasterId,\n username,\n ]);\n if (action === \"decline\") {\n await sendChatMessage(`@${display} duel declined. ${duelNarration(\"decline\")}`, broadcasterId);\n return true;\n }\n const challenger = await getCharacter(challenge.challenger);\n const defender = await getCharacter(username);\n if (!challenger || !defender) {\n await sendChatMessage(`@${display} both players need saved characters before dueling.`, broadcasterId);\n return true;\n }\n if (mode === \"classic\") {\n // Turn-based: store active duel; players use !dndduel attack.\n await sqlite.execute(\n \"INSERT OR REPLACE INTO duels (broadcaster_id,challenger,defender,current_turn,challenger_hp,defender_hp,active,updated_at) VALUES (?,?,?,?,?,?,1,?)\",\n [\n broadcasterId,\n challenge.challenger,\n username,\n challenge.challenger,\n challenger.hpMax,\n defender.hpMax,\n Date.now(),\n ],\n );\n await sendChatMessage(\n `@${display} accepted classic duel! ${challenge.challenger} goes first. ${duelNarration(\"accept\")} Use !dndduel attack on your turn, or !dndduel status / !dndduel end.`,\n broadcasterId,\n );\n return true;\n }\n // Auto-resolve mode\n await sqlite.execute(\"DELETE FROM duels WHERE broadcaster_id = ?\", [broadcasterId]);\n const result = resolvePlayerDuel(String(challenge.challenger), username, challenger, defender);\n await sendChatMessages(\n `@${display} accepted! ${duelNarration(\"accept\")} ${result.log}`,\n broadcasterId,\n );\n return true;\n }\n\n if (action === \"end\" || action === \"cancel\") {\n if (active && (active.challenger === username || active.defender === username)) {\n await sqlite.execute(\"DELETE FROM duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessage(`@${display} duel ended.`, broadcasterId);\n } else {\n await sendChatMessage(`@${display} no duel to end.`, broadcasterId);\n }\n return true;\n }\n\n if (action === \"status\" || action === \"show\") {\n await sendChatMessage(\n active ? `@${display} ${await duelSummary(active)}` : `@${display} no active duel. Challenge someone with !dndduel @username.`,\n broadcasterId,\n );\n return true;\n }\n\n if (action === \"attack\") {\n if (!active) {\n await sendChatMessage(`@${display} no active duel. Challenge someone with !dndduel @username.`, broadcasterId);\n return true;\n }\n if (active.current_turn !== username) {\n await sendChatMessage(`@${display} it is ${active.current_turn}'s turn.`, broadcasterId);\n return true;\n }\n const attacker = await getCharacter(username);\n const targetName = active.challenger === username ? active.defender : active.challenger;\n const target = await getCharacter(targetName);\n if (!attacker || !target) {\n await sendChatMessage(`@${display} both duel characters must still exist.`, broadcasterId);\n return true;\n }\n const stats = combatStats(attacker);\n const targetStats = combatStats(target);\n const roll = 1 + Math.floor(Math.random() * 20);\n const total = roll + stats.mod + attacker.proficiency;\n const critical = roll === 20;\n const hit = critical || (roll !== 1 && total >= targetStats.attack);\n const dice = critical\n ? 1 + Math.floor(Math.random() * stats.die) + (1 + Math.floor(Math.random() * stats.die))\n : 1 + Math.floor(Math.random() * stats.die);\n const damage = hit ? Math.max(1, dice + stats.mod) : 0;\n if (active.challenger === username) active.defender_hp = Math.max(0, active.defender_hp - damage);\n else active.challenger_hp = Math.max(0, active.challenger_hp - damage);\n const defeated = active.challenger_hp <= 0 || active.defender_hp <= 0;\n const result = `${username} rolled ${roll}${critical ? \" CRITICAL\" : \"\"} + ${stats.mod + attacker.proficiency} = ${total} vs AC ${targetStats.attack}: ${hit ? `hit for ${damage} damage` : \"miss\"}. ${duelNarration(critical ? \"critical\" : hit ? \"hit\" : \"miss\")}`;\n if (defeated) {\n const winner = active.challenger_hp > 0 ? active.challenger : active.defender;\n await sqlite.execute(\"DELETE FROM duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessage(`@${display} ${result} ${winner} wins the duel! ${duelNarration(\"victory\")}`, broadcasterId);\n } else {\n active.current_turn = targetName;\n await sqlite.execute(\n \"UPDATE duels SET current_turn = ?, challenger_hp = ?, defender_hp = ?, updated_at = ? WHERE broadcaster_id = ?\",\n [active.current_turn, active.challenger_hp, active.defender_hp, Date.now(), broadcasterId],\n );\n await sendChatMessages(`@${display} ${result} ${await duelSummary(active)}`, broadcasterId);\n }\n return true;\n }\n\n // Challenge: !dndduel @user (auto) | !dndduel classic @user | !dndduel turn @user\n let mode: \"auto\" | \"classic\" = \"auto\";\n let targetRaw = \"\";\n if (action === \"classic\" || action === \"turn\" || action === \"manual\") {\n mode = \"classic\";\n targetRaw = parts.slice(2).join(\" \");\n } else if (action === \"auto\" || action === \"quick\") {\n mode = \"auto\";\n targetRaw = parts.slice(2).join(\" \");\n } else {\n // Bare \"!dndduel @user\" — default auto\n targetRaw = parts.slice(1).join(\" \");\n }\n const targetName = targetRaw.replace(/^@/, \"\").toLowerCase().replace(/[,:]+$/, \"\");\n if (!targetName || [\"party\", \"monster\", \"accept\", \"decline\", \"attack\", \"status\", \"show\", \"end\", \"cancel\"].includes(targetName)) {\n await sendChatMessage(\n `@${display} Duels: !dndduel @user (auto) | !dndduel classic @user (turn-based) | !dndduel accept | !dndduel decline | !dndduel attack | !dndduel status | !dndduel end`,\n broadcasterId,\n );\n return true;\n }\n if (active) {\n await sendChatMessage(`@${display} a classic duel is already active in this channel. Finish it or !dndduel end.`, broadcasterId);\n return true;\n }\n const target = await getCharacter(targetName);\n const own = await getCharacter(username);\n if (!own || !target) {\n await sendChatMessage(`@${display} both players need saved characters before issuing a challenge.`, broadcasterId);\n return true;\n }\n if (targetName === username.toLowerCase()) {\n await sendChatMessage(`@${display} you cannot duel yourself.`, broadcasterId);\n return true;\n }\n await sqlite.execute(\n \"INSERT OR REPLACE INTO duel_challenges (broadcaster_id,challenger,defender,created_at,mode) VALUES (?,?,?,?,?)\",\n [broadcasterId, username, targetName, Date.now(), mode],\n );\n if (mode === \"classic\") {\n await sendChatMessage(\n `@${display} challenged @${targetName} to a classic turn-based duel! ${duelNarration(\"challenge\")} @${targetName}, type !dndduel accept or !dndduel decline.`,\n broadcasterId,\n );\n } else {\n await sendChatMessage(\n `@${display} challenged @${targetName} to a quick auto-duel! ${duelNarration(\"challenge\")} @${targetName}, type !dndduel accept or !dndduel decline.`,\n broadcasterId,\n );\n }\n return true;\n}\n\nexport async function monsterDuelText(d: any) {\n return `${d.player} vs ${d.monster_name} (CR ${d.monster_cr}) — Player HP ${d.player_hp ?? \"?\"}; Monster HP ${d.monster_hp}/${d.monster_hp_max}; AC ${d.monster_ac}; turn: ${d.current_turn}.`;\n}\n\nexport async function handleMonsterDuelCommand(\n chatMessage: string,\n username: string,\n display: string,\n broadcasterId: string,\n) {\n const normalized = chatMessage.trim().toLowerCase();\n if (\n !(\n normalized === \"!dndduel\" ||\n normalized === \"!dndduel attack\" ||\n normalized === \"!dndduel monster\" ||\n normalized === \"!dndduel monster classic\" ||\n normalized === \"!dndduel monster attack\" ||\n normalized === \"!dndduel monster status\" ||\n normalized === \"!dndduel monster end\"\n )\n ) {\n return false;\n }\n\n let active = await getMonsterDuel(broadcasterId);\n\n if (\n normalized === \"!dndduel monster status\" ||\n normalized === \"!dndduel monster end\" ||\n normalized === \"!dndduel monster attack\"\n ) {\n if (!active || active.player !== username) {\n await sendChatMessage(`@${display} you do not have an active monster duel.`, broadcasterId);\n return true;\n }\n if (normalized.endsWith(\"status\")) {\n await sendChatMessage(`@${display} ${await monsterDuelText(active)}`, broadcasterId);\n return true;\n }\n if (normalized.endsWith(\"end\")) {\n await sqlite.execute(\"DELETE FROM monster_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessage(\n `@${display} the monster duel ends. The dungeon master calls it a tactical retreat.`,\n broadcasterId,\n );\n return true;\n }\n }\n\n // Classic turn-based monster: !dndduel monster [classic]\n if (normalized === \"!dndduel monster\" || normalized === \"!dndduel monster classic\") {\n if (active && active.player === username) {\n await sendChatMessage(`@${display} ${await monsterDuelText(active)} Use !dndduel attack.`, broadcasterId);\n return true;\n }\n const c = await getCharacter(username);\n if (!c) {\n await sendChatMessage(\n `@${display} create a character first with !createchar, then !dndduel monster.`,\n broadcasterId,\n );\n return true;\n }\n const monster = pickMonsterForLevel(c.level);\n await sqlite.execute(\n \"INSERT OR REPLACE INTO monster_duels (broadcaster_id,player,monster_name,monster_cr,monster_ac,monster_hp,monster_hp_max,monster_attack,monster_damage_die,monster_damage_bonus,current_turn,active,updated_at) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?)\",\n [\n broadcasterId,\n username,\n monster.name,\n monster.cr,\n monster.ac,\n monster.hp,\n monster.hp,\n monster.attack,\n monster.die,\n monster.bonus,\n \"player\",\n 1,\n Date.now(),\n ],\n );\n await sendChatMessage(\n `@${display} classic monster fight! ${monster.name} (CR ${monster.cr}) AC ${monster.ac}, HP ${monster.hp}. Your HP: ${c.hpMax}. ${duelNarration(\"challenge\")} Use !dndduel attack.`,\n broadcasterId,\n );\n return true;\n }\n\n // Auto monster: bare !dndduel\n if (normalized === \"!dndduel\") {\n const c = await getCharacter(username);\n if (!c) {\n await sendChatMessage(\n `@${display} create a character first with !createchar, then challenge the wilds with !dndduel.`,\n broadcasterId,\n );\n return true;\n }\n const monster = pickMonsterForLevel(c.level);\n let playerHp = c.hpMax;\n let monsterHp = monster.hp;\n const pStats = combatStats(c);\n // Slightly forgiving AC for stream pacing\n const playerAc = 11 + pStats.mod + c.proficiency;\n const highlights: string[] = [];\n let swings = 0;\n const maxSwings = 40;\n const dmgDie = 10; // heroes hit a bit harder vs monsters than PvP d8\n while (playerHp > 0 && monsterHp > 0 && swings < maxSwings) {\n swings++;\n const roll = 1 + Math.floor(Math.random() * 20);\n const total = roll + pStats.mod + c.proficiency + 1; // +1 to-hit bias\n const critical = roll === 20;\n const hit = critical || (roll !== 1 && total >= monster.ac);\n const dice = critical\n ? 1 + Math.floor(Math.random() * dmgDie) + 1 + Math.floor(Math.random() * dmgDie)\n : 1 + Math.floor(Math.random() * dmgDie);\n const damage = hit ? Math.max(1, dice + pStats.mod + 1) : 0;\n if (hit) monsterHp = Math.max(0, monsterHp - damage);\n if (critical || monsterHp <= 0 || highlights.length < 4) {\n highlights.push(\n hit\n ? `${username}${critical ? \" CRIT\" : \"\"} ${damage}→${monster.name}(${monsterHp})`\n : `${username} miss`,\n );\n }\n if (monsterHp <= 0) break;\n const mRoll = 1 + Math.floor(Math.random() * 20);\n const mTotal = mRoll + monster.attack;\n const mHit = mRoll !== 1 && (mRoll === 20 || mTotal >= playerAc);\n const mDice = 1 + Math.floor(Math.random() * monster.die);\n const mDamage = mHit ? Math.max(1, mDice + monster.bonus) : 0;\n if (mHit) playerHp = Math.max(0, playerHp - mDamage);\n if (mRoll === 20 || playerHp <= 0 || highlights.length < 8) {\n highlights.push(\n mHit ? `${monster.name} ${mDamage}→${username}(${playerHp})` : `${monster.name} miss`,\n );\n }\n }\n await sqlite.execute(\"DELETE FROM monster_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n const won = monsterHp <= 0 && playerHp > 0;\n let xpNote = \"\";\n if (won) {\n const xp = await awardMonsterXp(username, monster.cr);\n if (xp) {\n xpNote = ` +${xp.gained} XP (total ${xp.total})${xp.leveledTo ? ` — leveled to ${xp.leveledTo}!` : \"\"}`;\n }\n }\n await sendChatMessages(\n `@${display} the D20 of Fate summons a ${monster.name} (CR ${monster.cr}, AC ${monster.ac}, HP ${monster.hp})! ${duelNarration(\"challenge\")} Auto-resolved (${swings} exchanges): ${highlights.join(\" · \")} — ${won ? `${username} defeats ${monster.name}! ${duelNarration(\"victory\")}${xpNote}` : `${monster.name} wins. ${duelNarration(\"defeat\")}`} Final HP: you ${playerHp}/${c.hpMax}, ${monster.name} ${monsterHp}/${monster.hp}.`,\n broadcasterId,\n );\n return true;\n }\n\n if (\n (normalized === \"!dndduel attack\" || normalized === \"!dndduel monster attack\") &&\n active &&\n active.player === username\n ) {\n if (active.current_turn !== \"player\") {\n await sendChatMessage(`@${display} the monster is still acting.`, broadcasterId);\n return true;\n }\n const player = await getCharacter(username);\n if (!player) {\n await sendChatMessage(`@${display} your character no longer exists.`, broadcasterId);\n return true;\n }\n const pStats = combatStats(player);\n const playerHp = Number(active.player_hp ?? player.hpMax);\n const roll = 1 + Math.floor(Math.random() * 20);\n const toHitBonus = pStats.mod + player.proficiency + 1;\n const total = roll + toHitBonus;\n const critical = roll === 20;\n const hit = critical || (roll !== 1 && total >= Number(active.monster_ac));\n const dmgDie = 10;\n const dice = critical\n ? 1 + Math.floor(Math.random() * dmgDie) + 1 + Math.floor(Math.random() * dmgDie)\n : 1 + Math.floor(Math.random() * dmgDie);\n const damage = hit ? Math.max(1, dice + pStats.mod + 1) : 0;\n active.monster_hp = Math.max(0, Number(active.monster_hp) - damage);\n const playerResult = `${username} attacks ${active.monster_name}: d20 ${roll}${critical ? \" CRITICAL\" : \"\"} + ${toHitBonus} = ${total} vs AC ${active.monster_ac}; ${hit ? `hit for ${damage} damage` : \"miss\"}. ${duelNarration(critical ? \"critical\" : hit ? \"hit\" : \"miss\")}`;\n if (active.monster_hp <= 0) {\n await sqlite.execute(\"DELETE FROM monster_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n const xp = await awardMonsterXp(username, String(active.monster_cr ?? \"1\"));\n const xpNote = xp\n ? ` +${xp.gained} XP (total ${xp.total})${xp.leveledTo ? ` — leveled to ${xp.leveledTo}!` : \"\"}`\n : \"\";\n await sendChatMessage(\n `@${display} ${playerResult} ${active.monster_name} is defeated! ${duelNarration(\"victory\")}${xpNote}`,\n broadcasterId,\n );\n return true;\n }\n const monsterRoll = 1 + Math.floor(Math.random() * 20);\n const monsterTotal = monsterRoll + Number(active.monster_attack);\n const playerAc = 11 + pStats.mod + player.proficiency;\n const monsterHit = monsterRoll !== 1 && (monsterRoll === 20 || monsterTotal >= playerAc);\n const monsterDice = 1 + Math.floor(Math.random() * Number(active.monster_damage_die));\n const monsterDamage = monsterHit ? Math.max(1, monsterDice + Number(active.monster_damage_bonus)) : 0;\n const nextPlayerHp = Math.max(0, playerHp - monsterDamage);\n active.player_hp = nextPlayerHp;\n const monsterResult = `${active.monster_name} retaliates: d20 ${monsterRoll} + ${active.monster_attack} = ${monsterTotal} vs AC ${playerAc}; ${monsterHit ? `hit for ${monsterDamage} damage` : \"miss\"}. ${duelNarration(monsterHit ? \"hit\" : \"miss\")}`;\n if (nextPlayerHp <= 0) {\n await sqlite.execute(\"DELETE FROM monster_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessages(\n `@${display} ${playerResult} ${monsterResult} ${duelNarration(\"defeat\")} ${active.monster_name} wins this encounter.`,\n broadcasterId,\n );\n } else {\n await sqlite.execute(\n \"UPDATE monster_duels SET player_hp = ?, monster_hp = ?, current_turn = ?, updated_at = ? WHERE broadcaster_id = ?\",\n [nextPlayerHp, active.monster_hp, \"player\", Date.now(), broadcasterId],\n );\n await sendChatMessages(\n `@${display} ${playerResult} ${monsterResult} ${await monsterDuelText({ ...active, player_hp: nextPlayerHp })}`,\n broadcasterId,\n );\n }\n return true;\n }\n\n return false;\n}\n\nexport async function partySummary(broadcasterId: string, partyName: string) {\n const party = await getParty(broadcasterId, partyName);\n if (!party) return `party ${partyName} was not found`;\n const members = await getPartyMembers(broadcasterId, partyName);\n return `${party.party_name} (leader ${party.owner}): ${members.length ? members.join(\", \") : \"no members\"}`;\n}\n\nexport async function handlePartyCommand(\n chatMessage: string,\n username: string,\n display: string,\n broadcasterId: string,\n) {\n if (!/^!party(?:\\s|$)/i.test(chatMessage)) return false;\n // Twitch logins are case-insensitive; always normalize for storage/lookup.\n const me = username.toLowerCase();\n const parts = chatMessage.trim().split(/\\s+/);\n const action = (parts[1] ?? \"list\").toLowerCase();\n const sanitizeParty = (raw: string) =>\n (raw ?? \"\").replace(/^@/, \"\").toLowerCase().replace(/[^a-z0-9_-]/g, \"\");\n const name = sanitizeParty(parts[2] ?? \"\");\n\n if (action === \"create\") {\n if (!name) {\n await sendChatMessage(`@${display} use !party create .`, broadcasterId);\n return true;\n }\n if (await getParty(broadcasterId, name)) {\n await sendChatMessage(`@${display} that party already exists.`, broadcasterId);\n return true;\n }\n // Creator is always owner AND a member so they can invite immediately.\n await sqlite.execute(\n \"INSERT INTO parties (broadcaster_id,party_name,owner,created_at) VALUES (?,?,?,?)\",\n [broadcasterId, name, me, Date.now()],\n );\n await sqlite.execute(\n \"INSERT OR IGNORE INTO party_members (broadcaster_id,party_name,username,joined_at) VALUES (?,?,?,?)\",\n [broadcasterId, name, me, Date.now()],\n );\n await sendChatMessage(\n `@${display} party ${name} created. You are the leader and a member. Invite with !party invite @user ${name}`,\n broadcasterId,\n );\n return true;\n }\n\n if (action === \"join\") {\n const party = await getParty(broadcasterId, name);\n if (!party) await sendChatMessage(`@${display} party ${name} was not found.`, broadcasterId);\n else if (!(await getCharacter(me))) {\n await sendChatMessage(`@${display} create a character before joining a party.`, broadcasterId);\n } else {\n await sqlite.execute(\n \"INSERT OR IGNORE INTO party_members (broadcaster_id,party_name,username,joined_at) VALUES (?,?,?,?)\",\n [broadcasterId, name, me, Date.now()],\n );\n await sendChatMessage(`@${display} joined party ${name}.`, broadcasterId);\n }\n return true;\n }\n\n if (action === \"leave\") {\n if (!name) {\n await sendChatMessage(`@${display} use !party leave .`, broadcasterId);\n return true;\n }\n const party = await getParty(broadcasterId, name);\n if (!party) await sendChatMessage(`@${display} party ${name} was not found.`, broadcasterId);\n else if (String(party.owner).toLowerCase() === me) {\n await sendChatMessage(`@${display} leaders must use !party disband ${name}.`, broadcasterId);\n } else {\n await sqlite.execute(\n \"DELETE FROM party_members WHERE broadcaster_id = ? AND party_name = ? AND username = ?\",\n [broadcasterId, name, me],\n );\n await sendChatMessage(`@${display} left party ${name}.`, broadcasterId);\n }\n return true;\n }\n\n if (action === \"invite\") {\n const target = (parts[2] ?? \"\").replace(/^@/, \"\").toLowerCase().replace(/[,:]+$/, \"\");\n let partyName = sanitizeParty(parts[3] ?? \"\");\n\n // If party name omitted, use a party this user owns (or is the only member of).\n if (target && !partyName) {\n const owned = await sqlite.execute(\n \"SELECT party_name FROM parties WHERE broadcaster_id = ? AND lower(owner) = ? ORDER BY created_at ASC\",\n [broadcasterId, me],\n );\n if (owned.rows.length === 1) {\n partyName = String(owned.rows[0].party_name);\n } else {\n const membership = await sqlite.execute(\n \"SELECT party_name FROM party_members WHERE broadcaster_id = ? AND lower(username) = ? ORDER BY party_name\",\n [broadcasterId, me],\n );\n if (membership.rows.length === 1) partyName = String(membership.rows[0].party_name);\n }\n }\n\n if (!target || !partyName) {\n await sendChatMessage(\n `@${display} use !party invite @user (party name optional if you only lead/belong to one party).`,\n broadcasterId,\n );\n return true;\n }\n\n const party = await getParty(broadcasterId, partyName);\n if (!party) {\n await sendChatMessage(`@${display} party ${partyName} was not found.`, broadcasterId);\n return true;\n }\n\n // Repair: if this user is the owner but missing from members, add them.\n const ownerName = String(party.owner).toLowerCase();\n if (ownerName === me) {\n await sqlite.execute(\n \"INSERT OR IGNORE INTO party_members (broadcaster_id,party_name,username,joined_at) VALUES (?,?,?,?)\",\n [broadcasterId, partyName, me, Date.now()],\n );\n }\n\n const members = (await getPartyMembers(broadcasterId, partyName)).map((m) => m.toLowerCase());\n const isOwner = ownerName === me;\n const isMember = members.includes(me);\n if (!isOwner && !isMember) {\n await sendChatMessage(`@${display} only a party member or the leader can invite someone to that party.`, broadcasterId);\n return true;\n }\n if (target === me) {\n await sendChatMessage(`@${display} you are already in party ${partyName}.`, broadcasterId);\n return true;\n }\n if (!(await getCharacter(target))) {\n await sendChatMessage(`@${display} that player needs a saved character first.`, broadcasterId);\n return true;\n }\n await sqlite.execute(\n \"INSERT OR IGNORE INTO party_members (broadcaster_id,party_name,username,joined_at) VALUES (?,?,?,?)\",\n [broadcasterId, partyName, target, Date.now()],\n );\n await sendChatMessage(`@${display} @${target} joined party ${partyName}.`, broadcasterId);\n return true;\n }\n\n if (action === \"disband\") {\n const party = await getParty(broadcasterId, name);\n if (!party) await sendChatMessage(`@${display} party ${name} was not found.`, broadcasterId);\n else if (String(party.owner).toLowerCase() !== me) {\n await sendChatMessage(`@${display} only the party leader can disband that party.`, broadcasterId);\n } else {\n await sqlite.execute(\"DELETE FROM party_members WHERE broadcaster_id = ? AND party_name = ?\", [\n broadcasterId,\n name,\n ]);\n await sqlite.execute(\"DELETE FROM parties WHERE broadcaster_id = ? AND party_name = ?\", [\n broadcasterId,\n name,\n ]);\n await sendChatMessage(`@${display} party ${name} disbanded.`, broadcasterId);\n }\n return true;\n }\n\n if (action === \"list\" || action === \"show\") {\n if (name) {\n await sendChatMessage(`@${display} ${await partySummary(broadcasterId, name)}.`, broadcasterId);\n } else {\n const res = await sqlite.execute(\n \"SELECT party_name FROM party_members WHERE broadcaster_id = ? AND lower(username) = ? ORDER BY party_name\",\n [broadcasterId, me],\n );\n await sendChatMessage(\n `@${display} your parties: ${res.rows.length ? res.rows.map((r: any) => r.party_name).join(\", \") : \"none\"}.`,\n broadcasterId,\n );\n }\n return true;\n }\n\n await sendChatMessage(\n `@${display} Party: !party create | !party join | !party invite @user | !party list [name] | !party leave | !party disband .`,\n broadcasterId,\n );\n return true;\n}\n\nexport async function partyDuelText(d: any) {\n const left = d.challenger_members.map((n: string) => `${n} ${d.challenger_hp[n] ?? 0} HP`).join(\", \");\n const right = d.defender_members.map((n: string) => `${n} ${d.defender_hp[n] ?? 0} HP`).join(\", \");\n const active =\n d.current_side === \"challenger\"\n ? d.challenger_members[d.current_index]\n : d.defender_members[d.current_index];\n return `Party duel ${d.challenger_party} [${left}] vs ${d.defender_party} [${right}]. Turn: ${active ?? \"none\"}.`;\n}\n\nexport async function handlePartyDuelCommand(\n chatMessage: string,\n username: string,\n display: string,\n broadcasterId: string,\n) {\n if (!/^!dndduel\\s+party(?:\\s|$)/i.test(chatMessage)) return false;\n const parts = chatMessage.trim().split(/\\s+/);\n const sub = (parts[2] ?? \"\").toLowerCase();\n let active = await getPartyDuel(broadcasterId);\n const me = username.toLowerCase();\n\n // ── Party vs monster (hunt): party fights one scaled monster together ──\n // !dndduel party hunt → auto\n // !dndduel party hunt classic → turn-based\n // !dndduel party hunt attack|status|end\n if (sub === \"hunt\") {\n const huntAction = (parts[3] ?? \"\").toLowerCase();\n const partyHunt = await getPartyMonsterDuel(broadcasterId);\n\n if (huntAction === \"status\" || huntAction === \"show\") {\n if (!partyHunt) {\n await sendChatMessage(`@${display} no active party hunt. Start with !dndduel party hunt .`, broadcasterId);\n return true;\n }\n const roster = partyHunt.members\n .map((n: string) => `${n} ${partyHunt.member_hp[n] ?? 0}HP`)\n .join(\", \");\n const turn = partyHunt.members[partyHunt.current_index] ?? \"?\";\n await sendChatMessage(\n `@${display} Party hunt ${partyHunt.party_name} vs ${partyHunt.monster_name} (CR ${partyHunt.monster_cr}) HP ${partyHunt.monster_hp}/${partyHunt.monster_hp_max} AC ${partyHunt.monster_ac}. Party: [${roster}]. Turn: ${turn}.`,\n broadcasterId,\n );\n return true;\n }\n\n if (huntAction === \"end\" || huntAction === \"cancel\") {\n if (!partyHunt) {\n await sendChatMessage(`@${display} no active party hunt.`, broadcasterId);\n return true;\n }\n if (!partyHunt.members.map((m: string) => m.toLowerCase()).includes(me)) {\n await sendChatMessage(`@${display} only a hunting party member can end this hunt.`, broadcasterId);\n return true;\n }\n await sqlite.execute(\"DELETE FROM party_monster_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessage(`@${display} party hunt ended. The party retreats.`, broadcasterId);\n return true;\n }\n\n if (huntAction === \"attack\") {\n if (!partyHunt) {\n await sendChatMessage(`@${display} no active party hunt. Start with !dndduel party hunt classic .`, broadcasterId);\n return true;\n }\n const attackerName = partyHunt.members[partyHunt.current_index];\n if (!attackerName || attackerName.toLowerCase() !== me) {\n await sendChatMessage(`@${display} it is ${attackerName ?? \"someone else\"}'s turn.`, broadcasterId);\n return true;\n }\n if ((partyHunt.member_hp[attackerName] ?? 0) <= 0) {\n await sendChatMessage(`@${display} you are down and cannot attack.`, broadcasterId);\n return true;\n }\n const attacker = await getCharacter(attackerName);\n if (!attacker) {\n await sendChatMessage(`@${display} your character no longer exists.`, broadcasterId);\n return true;\n }\n const stats = combatStats(attacker);\n const roll = 1 + Math.floor(Math.random() * 20);\n const total = roll + stats.mod + attacker.proficiency;\n const critical = roll === 20;\n const hit = critical || (roll !== 1 && total >= Number(partyHunt.monster_ac));\n const dice = critical\n ? 1 + Math.floor(Math.random() * 8) + 1 + Math.floor(Math.random() * 8)\n : 1 + Math.floor(Math.random() * 8);\n const damage = hit ? Math.max(1, dice + stats.mod) : 0;\n partyHunt.monster_hp = Math.max(0, Number(partyHunt.monster_hp) - damage);\n const playerResult = `${attackerName} attacks ${partyHunt.monster_name}: d20 ${roll}${critical ? \" CRITICAL\" : \"\"} + ${stats.mod + attacker.proficiency} = ${total} vs AC ${partyHunt.monster_ac}; ${hit ? `hit for ${damage}` : \"miss\"}. ${duelNarration(critical ? \"critical\" : hit ? \"hit\" : \"miss\")}`;\n\n if (partyHunt.monster_hp <= 0) {\n await sqlite.execute(\"DELETE FROM party_monster_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n const xpNotes: string[] = [];\n for (const n of partyHunt.members) {\n if ((partyHunt.member_hp[n] ?? 0) > 0) {\n const xp = await awardMonsterXp(n, String(partyHunt.monster_cr));\n if (xp) xpNotes.push(`${n}+${xp.gained}`);\n }\n }\n await sendChatMessages(\n `@${display} ${playerResult} ${partyHunt.monster_name} falls! ${duelNarration(\"victory\")} XP: ${xpNotes.join(\", \") || \"none\"}.`,\n broadcasterId,\n );\n return true;\n }\n\n // Monster strikes a random living party member after each player attack\n const living = partyHunt.members.filter((n: string) => (partyHunt.member_hp[n] ?? 0) > 0);\n const targetName = living[Math.floor(Math.random() * living.length)] ?? attackerName;\n const targetChar = await getCharacter(targetName);\n const tStats = targetChar ? combatStats(targetChar) : { mod: 0, attack: 10 };\n const playerAc = 10 + tStats.mod + (targetChar?.proficiency ?? 2);\n const mRoll = 1 + Math.floor(Math.random() * 20);\n const mTotal = mRoll + Number(partyHunt.monster_attack);\n const mHit = mRoll !== 1 && (mRoll === 20 || mTotal >= playerAc);\n const mDice = 1 + Math.floor(Math.random() * Number(partyHunt.monster_damage_die));\n const mDamage = mHit ? Math.max(1, mDice + Number(partyHunt.monster_damage_bonus)) : 0;\n if (mHit) partyHunt.member_hp[targetName] = Math.max(0, (partyHunt.member_hp[targetName] ?? 0) - mDamage);\n const monsterResult = `${partyHunt.monster_name} strikes ${targetName}: d20 ${mRoll} + ${partyHunt.monster_attack} = ${mTotal} vs AC ${playerAc}; ${mHit ? `hit for ${mDamage}` : \"miss\"}.`;\n\n const stillAlive = partyHunt.members.some((n: string) => (partyHunt.member_hp[n] ?? 0) > 0);\n if (!stillAlive) {\n await sqlite.execute(\"DELETE FROM party_monster_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessages(\n `@${display} ${playerResult} ${monsterResult} ${duelNarration(\"defeat\")} The party is wiped.`,\n broadcasterId,\n );\n return true;\n }\n\n // Advance to next living member\n let idx = partyHunt.current_index;\n for (let i = 0; i < partyHunt.members.length; i++) {\n idx = (idx + 1) % partyHunt.members.length;\n if ((partyHunt.member_hp[partyHunt.members[idx]] ?? 0) > 0) break;\n }\n partyHunt.current_index = idx;\n await sqlite.execute(\n \"UPDATE party_monster_duels SET member_hp = ?, monster_hp = ?, current_index = ?, updated_at = ? WHERE broadcaster_id = ?\",\n [\n JSON.stringify(partyHunt.member_hp),\n partyHunt.monster_hp,\n partyHunt.current_index,\n Date.now(),\n broadcasterId,\n ],\n );\n const roster = partyHunt.members.map((n: string) => `${n} ${partyHunt.member_hp[n]}HP`).join(\", \");\n await sendChatMessages(\n `@${display} ${playerResult} ${monsterResult} Monster HP ${partyHunt.monster_hp}/${partyHunt.monster_hp_max}. Party: [${roster}]. Next: ${partyHunt.members[partyHunt.current_index]}.`,\n broadcasterId,\n );\n return true;\n }\n\n // Start hunt: !dndduel party hunt [classic] \n let classic = false;\n let partyName = \"\";\n if (huntAction === \"classic\" || huntAction === \"turn\" || huntAction === \"manual\") {\n classic = true;\n partyName = (parts[4] ?? \"\").toLowerCase().replace(/[^a-z0-9_-]/g, \"\");\n } else {\n partyName = huntAction.replace(/[^a-z0-9_-]/g, \"\");\n }\n if (!partyName) {\n await sendChatMessage(\n `@${display} Party hunt: !dndduel party hunt (auto) | !dndduel party hunt classic | !dndduel party hunt attack | status | end`,\n broadcasterId,\n );\n return true;\n }\n if (partyHunt) {\n await sendChatMessage(`@${display} a party hunt is already active. Use !dndduel party hunt status or end.`, broadcasterId);\n return true;\n }\n const party = await getParty(broadcasterId, partyName);\n const members = await getPartyMembers(broadcasterId, partyName);\n if (!party || !members.length) {\n await sendChatMessage(`@${display} party ${partyName} was not found or has no members.`, broadcasterId);\n return true;\n }\n if (\n String(party.owner).toLowerCase() !== me &&\n !members.map((m) => m.toLowerCase()).includes(me)\n ) {\n await sendChatMessage(`@${display} only a party member can start a hunt for that party.`, broadcasterId);\n return true;\n }\n\n const chars: Record = {};\n const memberHp: Record = {};\n let levelSum = 0;\n for (const n of members) {\n const c = await getCharacter(n);\n if (c) {\n chars[n] = c;\n memberHp[n] = c.hpMax;\n levelSum += c.level;\n }\n }\n const livingMembers = members.filter((n) => chars[n]);\n if (livingMembers.length < 1) {\n await sendChatMessage(`@${display} at least one party member needs a saved character.`, broadcasterId);\n return true;\n }\n const avgLevel = Math.max(1, Math.round(levelSum / livingMembers.length));\n // Scale monster gently for group size (still player-favored).\n const monster = pickMonsterForLevel(avgLevel);\n const sizeScale = 0.5 + livingMembers.length * 0.22; // 1p~0.72, 2p~0.94, 3p~1.16\n monster.hp = Math.max(10, Math.round(monster.hp * sizeScale));\n monster.attack = Math.max(2, monster.attack + Math.floor((livingMembers.length - 1) / 3));\n\n if (!classic) {\n // Auto-resolve: each living member attacks, then monster hits a random member\n let monsterHp = monster.hp;\n const hp = { ...memberHp };\n const highlights: string[] = [];\n let swings = 0;\n const maxSwings = 100;\n while (monsterHp > 0 && livingMembers.some((n) => hp[n] > 0) && swings < maxSwings) {\n swings++;\n for (const n of livingMembers) {\n if (hp[n] <= 0 || monsterHp <= 0) continue;\n const stats = combatStats(chars[n]);\n const roll = 1 + Math.floor(Math.random() * 20);\n const total = roll + stats.mod + chars[n].proficiency;\n const critical = roll === 20;\n const hit = critical || (roll !== 1 && total >= monster.ac);\n const dice = critical\n ? 1 + Math.floor(Math.random() * 8) + 1 + Math.floor(Math.random() * 8)\n : 1 + Math.floor(Math.random() * 8);\n const damage = hit ? Math.max(1, dice + stats.mod) : 0;\n if (hit) monsterHp = Math.max(0, monsterHp - damage);\n if (critical || monsterHp <= 0 || highlights.length < 10) {\n highlights.push(hit ? `${n}${critical ? \" CRIT\" : \"\"} ${damage}` : `${n} miss`);\n }\n }\n if (monsterHp <= 0) break;\n const living = livingMembers.filter((n) => hp[n] > 0);\n if (!living.length) break;\n const victim = living[Math.floor(Math.random() * living.length)];\n const vStats = combatStats(chars[victim]);\n const playerAc = 10 + vStats.mod + chars[victim].proficiency;\n const mRoll = 1 + Math.floor(Math.random() * 20);\n const mTotal = mRoll + monster.attack;\n const mHit = mRoll !== 1 && (mRoll === 20 || mTotal >= playerAc);\n const mDice = 1 + Math.floor(Math.random() * monster.die);\n const mDamage = mHit ? Math.max(1, mDice + monster.bonus) : 0;\n if (mHit) hp[victim] = Math.max(0, hp[victim] - mDamage);\n if (mRoll === 20 || hp[victim] <= 0 || highlights.length < 14) {\n highlights.push(mHit ? `${monster.name}→${victim} ${mDamage}` : `${monster.name} miss`);\n }\n }\n const partyWon = monsterHp <= 0 && livingMembers.some((n) => hp[n] > 0);\n const xpNotes: string[] = [];\n if (partyWon) {\n for (const n of livingMembers) {\n if (hp[n] > 0) {\n const xp = await awardMonsterXp(n, monster.cr);\n if (xp) xpNotes.push(`${n}+${xp.gained}${xp.leveledTo ? `→Lv${xp.leveledTo}` : \"\"}`);\n }\n }\n }\n const roster = livingMembers.map((n) => `${n}:${hp[n]}`).join(\", \");\n await sendChatMessages(\n `@${display} party ${partyName} hunts a ${monster.name} (CR ${monster.cr}, AC ${monster.ac}, HP ${monster.hp})! ${duelNarration(\"challenge\")} Auto (${swings} rounds): ${highlights.join(\" · \")} — ${partyWon ? `Victory! ${duelNarration(\"victory\")} XP: ${xpNotes.join(\", \")}` : `Defeat. ${duelNarration(\"defeat\")}`} Final party HP [${roster}]; monster ${monsterHp}/${monster.hp}.`,\n broadcasterId,\n );\n return true;\n }\n\n // Classic party hunt\n await sqlite.execute(\n \"INSERT OR REPLACE INTO party_monster_duels (broadcaster_id,party_name,members,member_hp,current_index,monster_name,monster_cr,monster_ac,monster_hp,monster_hp_max,monster_attack,monster_damage_die,monster_damage_bonus,active,updated_at) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,1,?)\",\n [\n broadcasterId,\n partyName,\n JSON.stringify(livingMembers),\n JSON.stringify(Object.fromEntries(livingMembers.map((n) => [n, memberHp[n]]))),\n 0,\n monster.name,\n monster.cr,\n monster.ac,\n monster.hp,\n monster.hp,\n monster.attack,\n monster.die,\n monster.bonus,\n Date.now(),\n ],\n );\n await sendChatMessage(\n `@${display} classic party hunt! ${partyName} vs ${monster.name} (CR ${monster.cr}) AC ${monster.ac}, HP ${monster.hp}. ${livingMembers[0]} goes first. ${duelNarration(\"challenge\")} Use !dndduel party hunt attack.`,\n broadcasterId,\n );\n return true;\n }\n\n if (sub === \"accept\" || sub === \"decline\") {\n const res = await sqlite.execute(\n \"SELECT * FROM party_duel_challenges WHERE broadcaster_id = ? AND defender_owner = ? ORDER BY created_at DESC LIMIT 1\",\n [broadcasterId, username],\n );\n if (!res.rows.length) {\n await sendChatMessage(`@${display} no party duel challenge is waiting for you.`, broadcasterId);\n return true;\n }\n const challenge = res.rows[0];\n const mode = String(challenge.mode || \"auto\").toLowerCase() === \"classic\" ? \"classic\" : \"auto\";\n await sqlite.execute(\"DELETE FROM party_duel_challenges WHERE broadcaster_id = ? AND defender_owner = ?\", [\n broadcasterId,\n username,\n ]);\n if (sub === \"decline\") {\n await sendChatMessage(`@${display} party duel declined. ${duelNarration(\"decline\")}`, broadcasterId);\n return true;\n }\n const attackers = await getPartyMembers(broadcasterId, challenge.challenger_party);\n const defenders = await getPartyMembers(broadcasterId, challenge.defender_party);\n const aChars: Record = {};\n const dChars: Record = {};\n const aHp: Record = {};\n const dHp: Record = {};\n for (const n of attackers) {\n const c = await getCharacter(n);\n if (c) {\n aChars[n] = c;\n aHp[n] = c.hpMax;\n }\n }\n for (const n of defenders) {\n const c = await getCharacter(n);\n if (c) {\n dChars[n] = c;\n dHp[n] = c.hpMax;\n }\n }\n if (\n !attackers.length ||\n !defenders.length ||\n Object.keys(aHp).length !== attackers.length ||\n Object.keys(dHp).length !== defenders.length\n ) {\n await sendChatMessage(\n `@${display} both parties need at least one member with a saved character.`,\n broadcasterId,\n );\n return true;\n }\n\n if (mode === \"classic\") {\n await sqlite.execute(\n \"INSERT OR REPLACE INTO party_duels (broadcaster_id,challenger_party,defender_party,current_side,current_index,challenger_members,defender_members,challenger_hp,defender_hp,active,updated_at) VALUES (?,?,?,?,?,?,?,?,?,1,?)\",\n [\n broadcasterId,\n challenge.challenger_party,\n challenge.defender_party,\n \"challenger\",\n 0,\n JSON.stringify(attackers),\n JSON.stringify(defenders),\n JSON.stringify(aHp),\n JSON.stringify(dHp),\n Date.now(),\n ],\n );\n await sendChatMessage(\n `@${display} classic party duel accepted! ${challenge.challenger_party} goes first. ${duelNarration(\"accept\")} Use !dndduel party attack [@target].`,\n broadcasterId,\n );\n return true;\n }\n\n // Auto-resolve party duel\n const highlights: string[] = [];\n let side: \"challenger\" | \"defender\" = \"challenger\";\n let swings = 0;\n const maxSwings = 80;\n while (\n attackers.some((n) => aHp[n] > 0) &&\n defenders.some((n) => dHp[n] > 0) &&\n swings < maxSwings\n ) {\n swings++;\n const atkMembers = side === \"challenger\" ? attackers : defenders;\n const atkHp = side === \"challenger\" ? aHp : dHp;\n const atkChars = side === \"challenger\" ? aChars : dChars;\n const defMembers = side === \"challenger\" ? defenders : attackers;\n const defHp = side === \"challenger\" ? dHp : aHp;\n const defChars = side === \"challenger\" ? dChars : aChars;\n const attackerName = atkMembers.find((n) => atkHp[n] > 0);\n const defenderName = defMembers.find((n) => defHp[n] > 0);\n if (!attackerName || !defenderName) break;\n const line = simulateAttack(\n attackerName,\n defenderName,\n atkChars[attackerName],\n defChars[defenderName],\n defHp,\n );\n if (line.includes(\"CRIT\") || defHp[defenderName] <= 0 || highlights.length < 8) {\n highlights.push(line);\n }\n side = side === \"challenger\" ? \"defender\" : \"challenger\";\n }\n const challengerAlive = attackers.some((n) => aHp[n] > 0);\n const winnerParty = challengerAlive ? challenge.challenger_party : challenge.defender_party;\n const left = attackers.map((n) => `${n}:${aHp[n]}`).join(\",\");\n const right = defenders.map((n) => `${n}:${dHp[n]}`).join(\",\");\n await sqlite.execute(\"DELETE FROM party_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessages(\n `@${display} party duel accepted! ${duelNarration(\"accept\")} ${challenge.challenger_party} vs ${challenge.defender_party} auto-resolved (${swings} swings). ${highlights.join(\" · \")} — ${winnerParty} wins! ${duelNarration(\"victory\")} HP [${left}] vs [${right}]`,\n broadcasterId,\n );\n return true;\n }\n\n if (sub === \"status\" || sub === \"show\") {\n active = active ?? null;\n await sendChatMessage(\n active ? `@${display} ${await partyDuelText(active)}` : `@${display} no active party duel.`,\n broadcasterId,\n );\n return true;\n }\n\n if (sub === \"end\") {\n if (!active) await sendChatMessage(`@${display} no active party duel.`, broadcasterId);\n else {\n const all = [...active.challenger_members, ...active.defender_members];\n const member = all.includes(username);\n const ownerA = (await getParty(broadcasterId, active.challenger_party))?.owner === username;\n const ownerB = (await getParty(broadcasterId, active.defender_party))?.owner === username;\n if (!member && !ownerA && !ownerB) {\n await sendChatMessage(`@${display} only a party member or leader can end this duel.`, broadcasterId);\n } else {\n await sqlite.execute(\"DELETE FROM party_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessage(`@${display} party duel ended.`, broadcasterId);\n }\n }\n return true;\n }\n\n if (sub === \"attack\") {\n if (!active) {\n await sendChatMessage(`@${display} no active party duel.`, broadcasterId);\n return true;\n }\n const members = active.current_side === \"challenger\" ? active.challenger_members : active.defender_members;\n const ownHp = active.current_side === \"challenger\" ? active.challenger_hp : active.defender_hp;\n const enemyMembers = active.current_side === \"challenger\" ? active.defender_members : active.challenger_members;\n const enemyHp = active.current_side === \"challenger\" ? active.defender_hp : active.challenger_hp;\n const attackerName = members[active.current_index];\n if (attackerName !== username) {\n await sendChatMessage(`@${display} it is ${attackerName}'s turn.`, broadcasterId);\n return true;\n }\n const attacker = await getCharacter(attackerName);\n const targetQuery = parts[3]?.replace(/^@/, \"\").toLowerCase();\n const targetName =\n targetQuery && enemyMembers.includes(targetQuery) && enemyHp[targetQuery] > 0\n ? targetQuery\n : enemyMembers.find((n: string) => enemyHp[n] > 0);\n const target = targetName ? await getCharacter(targetName) : null;\n if (!attacker || !target || !targetName) {\n await sendChatMessage(`@${display} no living target remains.`, broadcasterId);\n return true;\n }\n const stats = combatStats(attacker);\n const targetStats = combatStats(target);\n const roll = 1 + Math.floor(Math.random() * 20);\n const total = roll + stats.mod + attacker.proficiency;\n const critical = roll === 20;\n const hit = critical || (roll !== 1 && total >= targetStats.attack);\n const dice = critical\n ? 1 + Math.floor(Math.random() * 8) + (1 + Math.floor(Math.random() * 8))\n : 1 + Math.floor(Math.random() * 8);\n const damage = hit ? Math.max(1, dice + stats.mod) : 0;\n enemyHp[targetName] = Math.max(0, enemyHp[targetName] - damage);\n const result = `${attackerName} rolled ${roll}${critical ? \" CRITICAL\" : \"\"} + ${stats.mod + attacker.proficiency} = ${total} vs AC ${targetStats.attack}: ${hit ? `hit ${targetName} for ${damage} damage` : \"miss\"}. ${duelNarration(critical ? \"critical\" : hit ? \"hit\" : \"miss\")}`;\n const defeated = enemyMembers.every((n: string) => Number(enemyHp[n]) <= 0);\n if (defeated) {\n const winner = active.current_side === \"challenger\" ? active.challenger_party : active.defender_party;\n await sqlite.execute(\"DELETE FROM party_duels WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessage(\n `@${display} ${result} ${winner} wins the party duel! ${duelNarration(\"victory\")}`,\n broadcasterId,\n );\n } else {\n const nextSide = active.current_side === \"challenger\" ? \"defender\" : \"challenger\";\n const nextMembers = nextSide === \"challenger\" ? active.challenger_members : active.defender_members;\n const nextHp = nextSide === \"challenger\" ? active.challenger_hp : active.defender_hp;\n active.current_side = nextSide;\n active.current_index = firstAlive(nextMembers, nextHp);\n await sqlite.execute(\n \"UPDATE party_duels SET current_side = ?, current_index = ?, challenger_hp = ?, defender_hp = ?, updated_at = ? WHERE broadcaster_id = ?\",\n [\n active.current_side,\n active.current_index,\n JSON.stringify(active.challenger_hp),\n JSON.stringify(active.defender_hp),\n Date.now(),\n broadcasterId,\n ],\n );\n await sendChatMessages(`@${display} ${result} ${await partyDuelText(active)}`, broadcasterId);\n }\n return true;\n }\n\n // Challenge: !dndduel party (auto)\n // !dndduel party classic (turn-based)\n let partyMode: \"auto\" | \"classic\" = \"auto\";\n let challengerParty = \"\";\n let defenderParty = \"\";\n const p2 = (parts[2] ?? \"\").toLowerCase();\n const p3 = (parts[3] ?? \"\").toLowerCase();\n const p4 = (parts[4] ?? \"\").toLowerCase();\n if (p2 === \"classic\" || p2 === \"turn\" || p2 === \"manual\") {\n partyMode = \"classic\";\n challengerParty = p3;\n defenderParty = p4;\n } else if (p2 === \"auto\" || p2 === \"quick\") {\n partyMode = \"auto\";\n challengerParty = p3;\n defenderParty = p4;\n } else {\n challengerParty = p2;\n defenderParty = p3;\n }\n if (!challengerParty || !defenderParty) {\n await sendChatMessage(\n `@${display} Party duels: !dndduel party (auto) | !dndduel party classic (turn-based) | !dndduel party accept | !dndduel party decline`,\n broadcasterId,\n );\n return true;\n }\n if (active) {\n await sendChatMessage(`@${display} a classic party duel is already active in this channel.`, broadcasterId);\n return true;\n }\n const ownParty = await getParty(broadcasterId, challengerParty);\n const targetParty = await getParty(broadcasterId, defenderParty);\n const ownMembers = ownParty ? await getPartyMembers(broadcasterId, challengerParty) : [];\n if (!ownParty || !targetParty || String(ownParty.owner).toLowerCase() !== username.toLowerCase() || !ownMembers.length) {\n await sendChatMessage(\n `@${display} you must lead a non-empty party, and both parties must exist.`,\n broadcasterId,\n );\n return true;\n }\n if (String(targetParty.owner).toLowerCase() === username.toLowerCase()) {\n await sendChatMessage(`@${display} you cannot challenge your own party.`, broadcasterId);\n return true;\n }\n await sqlite.execute(\n \"INSERT OR REPLACE INTO party_duel_challenges (broadcaster_id,challenger_party,defender_party,challenger_owner,defender_owner,created_at,mode) VALUES (?,?,?,?,?,?,?)\",\n [broadcasterId, challengerParty, defenderParty, username, targetParty.owner, Date.now(), partyMode],\n );\n await sendChatMessage(\n `@${display} party ${challengerParty} challenged party ${defenderParty} to a ${partyMode === \"classic\" ? \"classic turn-based\" : \"quick auto\"} duel! ${duelNarration(\"challenge\")} @${targetParty.owner}, use !dndduel party accept or !dndduel party decline.`,\n broadcasterId,\n );\n return true;\n}\n\nexport function encounterText(e: any) {\n const order = e.entries\n .map((x: any, i: number) => `${i === e.currentIndex && e.active ? \"▶\" : \"•\"} ${x.name} ${x.initiative}`)\n .join(\" | \");\n return `Initiative R${e.round}: ${order || \"no combatants\"}`;\n}\n\nexport async function handleInitiativeCommand(\n chatMessage: string,\n broadcasterId: string,\n display: string,\n isModerator: boolean,\n) {\n if (!chatMessage.toLowerCase().startsWith(\"!turn\")) return false;\n if (!isModerator) {\n await sendChatMessage(`@${display} only the broadcaster or a moderator can manage initiative.`, broadcasterId);\n return true;\n }\n const parts = chatMessage.trim().split(/\\s+/);\n const action = (parts[1] ?? \"show\").toLowerCase();\n let e = await getEncounter(broadcasterId);\n\n if (action === \"start\") {\n e = { broadcasterId, round: 1, currentIndex: 0, active: true, entries: [] };\n await saveEncounter(e);\n await sendChatMessage(\n `@${display} combat started. Add combatants with !turn add .`,\n broadcasterId,\n );\n return true;\n }\n\n if (action === \"end\" || action === \"clear\") {\n if (e) await sqlite.execute(\"DELETE FROM encounters WHERE broadcaster_id = ?\", [broadcasterId]);\n await sendChatMessage(`@${display} combat ended and initiative cleared.`, broadcasterId);\n return true;\n }\n\n if (!e || !e.active) {\n await sendChatMessage(`@${display} no active encounter. Start one with !turn start.`, broadcasterId);\n return true;\n }\n\n if (action === \"add\") {\n const match = chatMessage.match(/^!turn\\s+add\\s+(.+?)\\s+(\\d+)$/i);\n const initiative = match ? Number(match[2]) : NaN;\n if (!match || !Number.isInteger(initiative) || initiative < 0 || initiative > 50) {\n await sendChatMessage(\n `@${display} use !turn add , such as !turn add Goblin 15.`,\n broadcasterId,\n );\n return true;\n }\n const name = match[1].replace(/^@/, \"\").trim();\n const existing = e.entries.find((x: any) => x.name.toLowerCase() === name.toLowerCase());\n if (existing) existing.initiative = initiative;\n else e.entries.push({ name, initiative });\n e.entries.sort((a: any, b: any) => b.initiative - a.initiative);\n e.currentIndex = 0;\n await saveEncounter(e);\n await sendChatMessages(`@${display} ${encounterText(e)}`, broadcasterId);\n return true;\n }\n\n if (action === \"remove\") {\n const name = parts.slice(2).join(\" \").replace(/^@/, \"\");\n e.entries = e.entries.filter((x: any) => x.name.toLowerCase() !== name.toLowerCase());\n e.currentIndex = Math.min(e.currentIndex, Math.max(0, e.entries.length - 1));\n await saveEncounter(e);\n await sendChatMessages(`@${display} ${encounterText(e)}`, broadcasterId);\n return true;\n }\n\n if (action === \"next\" || action === \"prev\") {\n if (!e.entries.length) {\n await sendChatMessage(\n `@${display} add combatants first with !turn add .`,\n broadcasterId,\n );\n return true;\n }\n const step = action === \"next\" ? 1 : -1;\n const nextIndex = e.currentIndex + step;\n if (nextIndex >= e.entries.length) {\n e.currentIndex = 0;\n e.round += 1;\n } else if (nextIndex < 0) {\n e.currentIndex = e.entries.length - 1;\n e.round = Math.max(1, e.round - 1);\n } else e.currentIndex = nextIndex;\n await saveEncounter(e);\n await sendChatMessages(`@${display} ${encounterText(e)}`, broadcasterId);\n return true;\n }\n\n if (action === \"show\" || action === \"list\") {\n await sendChatMessages(`@${display} ${encounterText(e)}`, broadcasterId);\n return true;\n }\n\n await sendChatMessage(\n `@${display} Initiative: !turn start | !turn add | !turn show | !turn next | !turn prev | !turn remove | !turn end`,\n broadcasterId,\n );\n return true;\n}\n","createdAt",["D",1788144274844],"branchVersion","branchId","05246ac8-a272-4b74-b48a-34d91555f75d","id","20e82baa-ad9c-41ac-a8e5-4d2d285f6a79","dnd-twitch-bot",["D",1787995257440],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","","imageUrl","cc37ba10-6e6d-4af6-a801-9955c92d23c4","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","01a04ba1-c79f-7319-b4f2-7c4f3772837b","tursoName","20e82baaad9c41aca8e54d2d285f6a79","tursoHostname","20e82baaad9c41aca8e54d2d285f6a79-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789500119686],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_98":97,"_106":102},"org",{"_98":97,"_99":100,"_101":102,"_18":55,"_103":104,"_105":25},"branch",{"_13":87,"_32":88,"_43":42,"_89":44,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":45,"_96":97},"isOwned",512,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","StonedSheamus","handle","displayName","Shea Stolp","avatar","https://lh3.googleusercontent.com/a/ACg8ocIWmQgR3gyoMMicg2zCAoN1c7i36qX5mf9gRIdIXm8F2mo-ig=s96-c","tier","free","canRestrictVals","profileImageUrl","branchName","adoptOrgId",{"_43":44,"_32":45,"_38":313,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":-5,"_57":25,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":314,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":315,"_82":316,"_84":317,"_86":25},"tree",[256,257,258,259,260,261,262,263,264,265,266,267,268,269],"files",[256,257,258,259,260,261,262,263,264,265,266,267,268,269],"counts",{"_246":61,"_247":242,"_248":61,"_249":250,"_251":252},"contents",[129,130,131,132,133,134,135,136,137,138,139,140,141,142],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles",true,"grants","orgs","customDomains",{},{"_43":239,"_32":240,"_30":241,"_146":-5,"_41":42,"_40":242,"_148":124,"_38":243,"_13":61,"_33":20,"_35":244,"_24":25,"_152":-5,"_27":245},{"_43":233,"_32":234,"_30":235,"_146":-5,"_41":42,"_40":166,"_148":25,"_38":236,"_13":61,"_33":20,"_35":237,"_24":25,"_152":-5,"_27":238},{"_43":226,"_32":227,"_30":228,"_146":-5,"_41":42,"_40":229,"_148":25,"_38":230,"_13":205,"_33":20,"_35":231,"_24":25,"_152":-5,"_27":232},{"_43":219,"_32":220,"_30":221,"_146":-5,"_41":42,"_40":222,"_148":25,"_38":223,"_13":150,"_33":34,"_35":224,"_24":25,"_152":-5,"_27":225},{"_43":216,"_32":28,"_30":31,"_146":-5,"_41":42,"_40":14,"_148":25,"_38":217,"_13":213,"_33":34,"_35":37,"_24":25,"_152":-5,"_27":218},{"_43":208,"_32":209,"_30":210,"_146":-5,"_41":42,"_40":211,"_148":25,"_38":212,"_13":213,"_33":34,"_35":214,"_24":25,"_152":-5,"_27":215},{"_43":200,"_32":201,"_30":202,"_146":-5,"_41":42,"_40":203,"_148":25,"_38":204,"_13":205,"_33":34,"_35":206,"_24":25,"_152":-5,"_27":207},{"_43":193,"_32":194,"_30":195,"_146":-5,"_41":42,"_40":196,"_148":124,"_38":197,"_13":61,"_33":20,"_35":198,"_24":25,"_152":-5,"_27":199},{"_43":186,"_32":187,"_30":188,"_146":-5,"_41":42,"_40":189,"_148":25,"_38":190,"_13":150,"_33":34,"_35":191,"_24":25,"_152":-5,"_27":192},{"_43":176,"_32":177,"_30":178,"_146":-5,"_41":42,"_40":179,"_148":25,"_38":180,"_13":181,"_33":182,"_35":183,"_24":25,"_152":184,"_27":185},{"_43":169,"_32":170,"_30":171,"_146":-5,"_41":42,"_40":172,"_148":25,"_38":173,"_13":166,"_33":34,"_35":174,"_24":25,"_152":-5,"_27":175},{"_43":161,"_32":162,"_30":163,"_146":-5,"_41":42,"_40":164,"_148":25,"_38":165,"_13":166,"_33":34,"_35":167,"_24":25,"_152":-5,"_27":168},{"_43":154,"_32":155,"_30":156,"_146":-5,"_41":42,"_40":157,"_148":25,"_38":158,"_13":150,"_33":34,"_35":159,"_24":25,"_152":-5,"_27":160},{"_43":143,"_32":144,"_30":145,"_146":-5,"_41":42,"_40":147,"_148":25,"_38":149,"_13":150,"_33":34,"_35":151,"_24":25,"_152":-5,"_27":153},"b9a8a91d-99c5-4363-bf83-a3ab0f95b645","utils.ts","7c7a4070-a4d9-11f1-90df-1607ee4eb77e","parentId",100,"latest",["D",1788143288555],3,"// Pure helpers and small shared utilities\n\nimport type { Character } from \"./types.ts\";\nimport { abilityNames, knownBotAccounts } from \"./data.ts\";\n\nexport const pick = (items: T[]): T => items[Math.floor(Math.random() * items.length)];\n\nexport const modifier = (score: number) => Math.floor((score - 10) / 2);\n\nexport function rollStat() {\n const d = Array.from({ length: 4 }, () => 1 + Math.floor(Math.random() * 6)).sort((a, b) => b - a);\n return d[0] + d[1] + d[2];\n}\n\nexport function formatRaceName(race: string, subrace: string | null) {\n if (!subrace) return race.trim();\n const nr = race.trim().toLowerCase();\n const ns = subrace.trim().toLowerCase();\n return ns === nr || ns.endsWith(` ${nr}`) ? subrace.trim() : `${subrace.trim()} ${race.trim()}`;\n}\n\nexport function escapeHtml(value: string) {\n return value.replace(/[&<>'\"]/g, (c) => ({ \"&\": \"&\", \"<\": \"<\", \">\": \">\", \"'\": \"'\", '\"': \""\" }[c]!));\n}\n\nexport function formatStatLine(c: Character) {\n return `Lv${c.level} XP ${c.xp ?? 0} | ${abilityNames\n .map((a) => `${a} ${c.scores[a]}(${modifier(c.scores[a]) >= 0 ? \"+\" : \"\"}${modifier(c.scores[a])})`)\n .join(\" \")} | HP ${c.hpCurrent}/${c.hpMax} | Speed ${c.speed}ft | Prof +${c.proficiency}`;\n}\n\nexport function duelNarration(stage: string) {\n const lines: Record = {\n challenge: [\"The arena gates swing open.\", \"The gauntlet has been thrown.\", \"Fate calls for a showdown.\"],\n accept: [\"The crowd roars—the duel is on.\", \"Steel meets destiny.\", \"The initiative gods have been consulted.\"],\n decline: [\"The challenge fades into the tavern gossip.\", \"Wisdom wins this round.\", \"The duel is postponed by fate.\"],\n hit: [\"A clean strike finds its mark.\", \"That hit had advantage from destiny.\", \"The dice have chosen violence.\"],\n miss: [\"The attack misses wide; the boots remain unharmed.\", \"The blade finds only air.\", \"The dice requested a dramatic near miss.\"],\n critical: [\"A critical hit! The bards are taking notes.\", \"Natural twenty—legendary timing.\", \"The D20 of Fate has opened the vault.\"],\n defeat: [\"A character falls, but the story continues.\", \"The HP bar has entered the underworld.\", \"A dramatic collapse worthy of the final act.\"],\n victory: [\"Victory belongs to the last character standing.\", \"The winner claims the tavern bragging rights.\", \"The campaign chronicle gains a new legend.\"],\n };\n const pool = lines[stage] ?? lines.hit;\n return pool[Math.floor(Math.random() * pool.length)];\n}\n\nexport function combatStats(c: Character) {\n const ability = Math.max(c.scores.STR, c.scores.DEX);\n const mod = modifier(ability);\n return { attack: 10 + mod + c.proficiency, mod, die: 8 };\n}\n\nexport function isBotAccount(username: string, userId: string, botUserId: string) {\n const normalized = username.toLowerCase();\n const configured = (Deno.env.get(\"BOT_USERNAMES\") ?? \"\")\n .split(\",\")\n .map((x) => x.trim().toLowerCase())\n .filter(Boolean);\n return (\n userId === botUserId ||\n knownBotAccounts.has(normalized) ||\n configured.includes(normalized) ||\n normalized.endsWith(\"bot\")\n );\n}\n\nexport function hasModeratorBadge(event: any) {\n const badges = [...(event?.badges ?? []), ...(event?.source_badges ?? [])];\n return badges.some((badge: any) => badge.set_id === \"moderator\" || badge.set_id === \"broadcaster\");\n}\n\nexport function rollDice(input = \"1d20\") {\n const expression = input.trim() || \"1d20\";\n const m = expression.match(/^(\\d+)d(\\d+)([+-]\\d+)?$/i);\n if (!m) return null;\n const n = +m[1],\n sides = +m[2],\n mod = m[3] ? +m[3] : 0;\n if (n > 100 || sides > 1000) return null;\n const rolls = Array.from({ length: n }, () => 1 + Math.floor(Math.random() * sides));\n const rawTotal = rolls.reduce((a, b) => a + b, 0);\n const total = rawTotal + mod;\n const label = expression.toLowerCase() === \"1d20\" ? \"D20 of Fate\" : \"Dice roll\";\n const rawD20 = n === 1 && sides === 20 ? rolls[0] : null;\n const puns =\n rawD20 === 20\n ? [\n \"Natural 20! The bards are already writing the song.\",\n \"Critical success! Even the dice wanted to be legendary.\",\n \"The gods have stamped this roll approved.\",\n \"A natural 20—today, the dungeon fears you.\",\n \"Fate has opened the treasure chest of victory.\",\n ]\n : rawD20 === 1\n ? [\n \"Natural 1! The floor wins this round.\",\n \"Critical fumble! Somewhere, a goblin just gained confidence.\",\n \"The dice have requested a short rest.\",\n \"A natural 1—excellent roleplay opportunity incoming.\",\n \"Fate rolled a banana peel under your boots.\",\n ]\n : total >= 17\n ? [\n \"That roll arrived wearing a hero’s cape.\",\n \"The adventure is leaning dramatically in your favor.\",\n \"Even the dungeon master raised an eyebrow at that one.\",\n \"A mighty swing of the fate hammer.\",\n \"The prophecy is looking unusually promising.\",\n ]\n : total <= 4\n ? [\n \"That roll took a wrong turn at the tavern.\",\n \"The dungeon master is trying very hard not to smile.\",\n \"Fate has assigned you a side quest.\",\n \"The dice are demanding better snacks.\",\n \"That result has strong mimic-energy.\",\n ]\n : [\n \"Fate has spoken—no rerolling destiny.\",\n \"The dungeon master may now pretend this was planned.\",\n \"That roll wandered in from a side quest.\",\n \"Somewhere, a bard is composing a song about this.\",\n \"Your modifiers are doing the heavy lifting.\",\n \"The goblins are taking notes.\",\n \"The prophecy remains open.\",\n \"Fate rolled over and asked for advantage.\",\n \"The initiative order has noticed you.\",\n \"A perfectly serviceable bit of adventuring.\",\n \"The dice have offered a plot twist.\",\n \"The tavern is buying the next round.\",\n ];\n const pun = puns[Math.floor(Math.random() * puns.length)];\n return `🎲 ${label}: ${expression} → [${rolls.join(\", \")}]${mod ? (mod > 0 ? `+${mod}` : mod) : \"\"} = ${total}. ${pun}`;\n}\n\nexport function compactText(value: unknown, max = 240) {\n return String(value ?? \"\")\n .replace(/\\s+/g, \" \")\n .replace(/<[^>]+>/g, \"\")\n .trim()\n .slice(0, max);\n}\n\nexport function splitChatMessage(text: string, max = 300) {\n const parts: string[] = [];\n let remaining = text.trim();\n while (remaining.length > max) {\n let cut = remaining.lastIndexOf(\" \", max);\n if (cut < 1) cut = max;\n parts.push(remaining.slice(0, cut).trim());\n remaining = remaining.slice(cut).trim();\n }\n if (remaining) parts.push(remaining);\n return parts;\n}\n\nexport function firstAlive(members: string[], hp: Record) {\n return members.findIndex((name) => Number(hp[name]) > 0);\n}\n\nexport function logRowText(r: any) {\n return `${new Date(Number(r.created_at)).toISOString()} | @${r.username} | ${r.action} | ${r.detail}`;\n}\n","label",[144],"bcf59234-267e-4fe3-b101-f4a1ea207c0c","types.ts","760b7a24-a4d9-11f1-9139-1607ee4eb77e",99,["D",1788143288555],"// Shared type definitions for GuildScribe\n\nexport type Ability = \"STR\" | \"DEX\" | \"CON\" | \"INT\" | \"WIS\" | \"CHA\";\n\nexport type Race = {\n subraces: string[];\n bonuses: Partial>;\n speed: number;\n traits: string[];\n};\n\nexport type ClassData = {\n priority: Ability[];\n savingThrows: Ability[];\n hitDie: number;\n calling: string;\n};\n\nexport type Character = {\n username: string;\n race: string;\n subrace: string | null;\n cls: string;\n level: number;\n xp: number;\n scores: Record;\n speed: number;\n hpMax: number;\n hpCurrent: number;\n proficiency: number;\n traits: string[];\n spells: string[];\n items: string[];\n feats: string[];\n abilities: string[];\n};\n\nexport type CreationSession = {\n username: string;\n step: string;\n race?: string | null;\n subrace?: string | null;\n cls?: string | null;\n scores?: number[] | null;\n};\n",[155],"20b49cf9-fbcf-4303-9d3c-0126adf47a57","twitch.ts","9c5a8652-a4d9-11f1-b87e-1607ee4eb77e",85,["D",1788139249104],2,"// Twitch API helpers (tokens, chat, EventSub)\n\nimport { MAX_LOOKUP_MESSAGE_LENGTH } from \"./data.ts\";\nimport { splitChatMessage } from \"./utils.ts\";\n\nexport const env = (name: string) => {\n const value = Deno.env.get(name);\n if (!value) throw new Error(`Missing environment variable: ${name}`);\n return value;\n};\n\nexport async function sendChatMessage(text: string, broadcasterId: string) {\n const res = await fetch(\"https://api.twitch.tv/helix/chat/messages\", {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${await getAppToken()}`,\n \"Client-Id\": env(\"TWITCH_CLIENT_ID\"),\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n broadcaster_id: broadcasterId,\n sender_id: env(\"TWITCH_BOT_ID\"),\n message: text,\n for_source_only: true,\n }),\n });\n console.log(`Send message response: ${res.status} ${await res.text()}`);\n}\n\nexport async function sendChatMessages(text: string, broadcasterId: string) {\n const parts = splitChatMessage(text, MAX_LOOKUP_MESSAGE_LENGTH);\n for (const part of parts) {\n if (part.length > MAX_LOOKUP_MESSAGE_LENGTH) {\n throw new Error(\"Chat message splitter produced an oversized message\");\n }\n await sendChatMessage(part, broadcasterId);\n }\n}\n\nexport async function sendSpellSections(sections: string[], display: string, broadcasterId: string) {\n for (const section of sections) {\n const parts = splitChatMessage(`@${display} ${section}`, MAX_LOOKUP_MESSAGE_LENGTH);\n for (const part of parts) {\n if (part.length > MAX_LOOKUP_MESSAGE_LENGTH) {\n throw new Error(\"Spell section exceeded safe chat length\");\n }\n await sendChatMessage(part, broadcasterId);\n }\n }\n}\n\nexport async function getAppToken() {\n const body = new URLSearchParams({\n client_id: env(\"TWITCH_CLIENT_ID\"),\n client_secret: env(\"TWITCH_CLIENT_SECRET\"),\n grant_type: \"client_credentials\",\n });\n const res = await fetch(\"https://id.twitch.tv/oauth2/token\", {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n body,\n });\n if (!res.ok) throw new Error(`App token failed: ${res.status} ${await res.text()}`);\n return (await res.json()).access_token as string;\n}\n\nexport async function exchangeCode(code: string, redirectUri: string) {\n const body = new URLSearchParams({\n client_id: env(\"TWITCH_CLIENT_ID\"),\n client_secret: env(\"TWITCH_CLIENT_SECRET\"),\n code,\n grant_type: \"authorization_code\",\n redirect_uri: redirectUri,\n });\n const res = await fetch(\"https://id.twitch.tv/oauth2/token\", {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n body,\n });\n if (!res.ok) throw new Error(`OAuth exchange failed: ${res.status} ${await res.text()}`);\n return await res.json();\n}\n\nexport async function createChatSubscription(broadcasterId: string, callbackUrl: string) {\n const appToken = await getAppToken();\n const res = await fetch(\"https://api.twitch.tv/helix/eventsub/subscriptions\", {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${appToken}`,\n \"Client-Id\": env(\"TWITCH_CLIENT_ID\"),\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n type: \"channel.chat.message\",\n version: \"1\",\n condition: {\n broadcaster_user_id: broadcasterId,\n user_id: env(\"TWITCH_BOT_ID\"),\n },\n transport: {\n method: \"webhook\",\n callback: callbackUrl,\n secret: env(\"EVENTSUB_SECRET\"),\n },\n }),\n });\n const text = await res.text();\n if (!res.ok) throw new Error(`EventSub subscription failed: ${res.status} ${text}`);\n return JSON.parse(text).data[0];\n}\n\nexport async function verifyEventSub(req: Request, rawBody: string) {\n const id = req.headers.get(\"Twitch-Eventsub-Message-Id\") ?? \"\";\n const timestamp = req.headers.get(\"Twitch-Eventsub-Message-Timestamp\") ?? \"\";\n const received = req.headers.get(\"Twitch-Eventsub-Message-Signature\") ?? \"\";\n const key = await crypto.subtle.importKey(\n \"raw\",\n new TextEncoder().encode(env(\"EVENTSUB_SECRET\")),\n { name: \"HMAC\", hash: \"SHA-256\" },\n false,\n [\"sign\"],\n );\n const signature = new Uint8Array(\n await crypto.subtle.sign(\"HMAC\", key, new TextEncoder().encode(id + timestamp + rawBody)),\n );\n const hex = [...signature].map((b) => b.toString(16).padStart(2, \"0\")).join(\"\");\n const expected = `sha256=${hex}`;\n return received.length === expected.length && [...expected].every((c, i) => c === received[i]);\n}\n",[162],"0919b4ac-8fc8-46dd-9ede-de718855d4c9","pages.ts","a605108c-a4d9-11f1-a673-1607ee4eb77e",82,["D",1788139249091],"// HTML page rendering for the web UI\n\nimport type { Character } from \"./types.ts\";\nimport { abilityNames } from \"./data.ts\";\nimport { modifier, formatRaceName, escapeHtml } from \"./utils.ts\";\n\nexport function page(title: string, body: string) {\n return new Response(\n `${title}${body}`,\n { headers: { \"Content-Type\": \"text/html; charset=utf-8\" } },\n );\n}\n\nexport function renderCharacterPage(c: Character) {\n const statLine = abilityNames\n .map(\n (a) =>\n `

${a} ${c.scores[a]} (${modifier(c.scores[a]) >= 0 ? \"+\" : \"\"}${modifier(c.scores[a])})

`,\n )\n .join(\"\");\n return `${escapeHtml(c.username)}'s Character

${escapeHtml(c.username)}

Level ${c.level} ${escapeHtml(formatRaceName(c.race, c.subrace))} ${escapeHtml(c.cls)}

HP: ${c.hpCurrent}/${c.hpMax} | Speed: ${c.speed} ft | Proficiency: +${c.proficiency}

${statLine}

Traits: ${c.traits.map(escapeHtml).join(\", \")}

`;\n}\n\nexport function renderLogsPage(rows: any[]) {\n const lines = rows\n .map(\n (r: any) =>\n `${escapeHtml(new Date(Number(r.created_at)).toLocaleString())}${escapeHtml(r.username || \"unknown\")}${escapeHtml(r.broadcaster_id || \"\")}${escapeHtml(r.action || \"\")}${escapeHtml(r.detail || \"\")}`,\n )\n .join(\"\");\n return `

GuildScribe Activity Logs

Recent bot activity with timestamps, Twitch usernames, channels, and command details.

Back to guide · Bot home

${lines || ``}

Timestamp	Username	Channel ID	Action	Details
No activity recorded yet.

`;\n}\n\nexport function renderGuidePage() {\n return `

Twitch D&D bot

GuildScribe

Keep the table moving. A quick reference for character creation, D&D lookups, and live combat turns.

Connect a channel Support the bot

Getting started: Mod the bot in your channel with /mod GuildScribeBot, then use !help for the welcome guide or !dndbothelp to browse this reference from chat.

Character commands

Create and view

!newchar

Start a guided chat wizard. Reply with !answer <choice> to select a race, subrace, class, and ability scores.

!createchar

Immediately create a level 1 character.

!createchar @username

Broadcaster/moderator only: create a level 1 character for someone else, such as for a viewer who can't chat directly.

!char!char @username

Display your current character summary, or view another player’s saved character.

Manage progress

!levelup!levelup +2!levelup -1

Adjust levels from 1 through 20. HP maximum, current HP, and proficiency are recalculated.

!hp +5!hp -3

Adjust current HP within the character’s valid range.

Save and restore

!savechar!loadchar!resetchar

Save a backup, restore the latest backup, or reset your character.

Dice

!roll!r!d20

All three commands roll the D20 of Fate by default.

!roll NdS[+/-M]

Roll a custom dice expression, such as !roll 1d20+5, !roll 2d6, or !roll 4d8-2.

!roll @username [NdS[+/-M]]

Roll on behalf of someone else in chat, such as !roll @friend or !roll @friend 2d6+3. Anyone can do this.

D&D lookups

Look up SRD information by name. Add an optional positive modifier to the search; for spells it represents an upcast amount, and for items it represents an attack/damage bonus.

Rules and magic

!spell <spell> [+N]

Shows level, school, casting details, range, duration, components, damage dice, damage type, save, area, classes, and higher-level scaling.

!class <class> [+N]

Shows Hit Die, saving throws, and proficiencies.

!feat <feat> [+N]

Shows prerequisites and the feat description.

Equipment and abilities

!item <item> [+N]

Shows weapon damage, type, range, weight, cost, armor class, properties, and modifier.

!ability <ability> [+N]

Shows the ability score, related skills, and description.

Races

!race <race> [+N]

Shows ability bonuses, speed, size, languages, and racial traits.

!subrace <subrace> [+N]

Shows subrace bonuses, parent race, speed, languages, and traits.

Combat turn tracker

Combat commands are restricted to the broadcaster or a moderator.

!turn start!turn add <name> <initiative>!turn show!turn next!turn prev!turn remove <name>!turn end

The tracker stores one encounter per connected channel, sorts combatants from highest to lowest initiative, shows the active combatant with an arrow, and advances the round automatically.

Player duels

!dndduel @username!dndduel accept | !dndduel decline!dndduel attack!dndduel status | !dndduel end | !dndduel party

Challenge another chatter’s saved character, accept or decline, then take alternating attack turns until a winner is found. Party leaders can use !dndduel party <your-party> <target-party> to challenge another party; the target leader accepts with !dndduel party accept, and party members attack with !dndduel party attack [@target].

Onboarding and support

In chat

!help

Replay the three-step getting-started welcome message.

!dndbothelp

Show the command categories.

!link

Post the GuildScribe Bot Guide link in chat.

Show the command categories. Expand one with !dndbothelp character, !dndbothelp combat, !dndbothelp lookup, or !dndbothelp dice.

Connect and support

Use the onboarding page to connect a Twitch channel. After connecting, run /mod GuildScribeBot in that channel.

Support the project through the donations page.

Moderators can review recent activity at /logs or use !logs in chat.

GuildScribe provides reference and gameplay utilities. Always verify rules, character choices, and wallet details before acting.

`;\n}\n",[170],"d84b9e1f-d18e-490c-83b7-274edde83ee0","main.ts","6b349c48-a4d9-11f1-b9f9-1607ee4eb77e",109,["D",1788144274871],8,"http","// GuildScribe — Twitch D&D bot entry point\n// Val Town / Deno HTTP handler\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\nimport {\n ensureTables,\n getCharacter,\n saveCharacter,\n adjustHp,\n backupCharacter,\n loadBackup,\n resetCharacter,\n getConnections,\n isChannelEnabled,\n setChannelEnabled,\n recordActivity,\n getRecentLogs,\n} from \"./db.ts\";\nimport {\n generateCharacter,\n handleCreationCommand,\n adjustLevel,\n} from \"./characters.ts\";\nimport {\n handleDuelCommand,\n handleMonsterDuelCommand,\n handlePartyCommand,\n handlePartyDuelCommand,\n handleInitiativeCommand,\n} from \"./combat.ts\";\nimport { lookup5e, formatSpellSections, formatLookup } from \"./lookups.ts\";\nimport {\n env,\n sendChatMessage,\n sendChatMessages,\n sendSpellSections,\n exchangeCode,\n createChatSubscription,\n verifyEventSub,\n} from \"./twitch.ts\";\nimport {\n formatRaceName,\n formatStatLine,\n escapeHtml,\n rollDice,\n isBotAccount,\n hasModeratorBadge,\n logRowText,\n} from \"./utils.ts\";\nimport { page, renderCharacterPage, renderLogsPage, renderGuidePage } from \"./pages.ts\";\n\n// Public HTTP trigger URL for this val (used for guide links in chat).\n// OAuth redirects and character page links still use the request origin dynamically.\nconst PUBLIC_BASE_URL = \"https://StonedSheamus--6b349c48a4d911f1b9f91607ee4eb77e.web.val.run\";\n\nasync function sendWelcomeMessage(display: string, broadcasterId: string) {\n await sendChatMessage(\n `@${display} Welcome to GuildScribe! Get started with !createchar, then !char; manage with !levelup [+/-levels], !hp [+/-amount], !savechar, !loadchar, and !resetchar; roll with !roll, !r, or !d20; look up !spell, !item, !class, !feat, !ability, !race, or !subrace; use !dndbothelp for categories and !link for the guide.`,\n broadcasterId,\n );\n}\n\nexport default async function (req: Request): Promise {\n await ensureTables();\n const url = new URL(req.url);\n const path = url.pathname;\n\n // ── Static / GET routes ──\n if (req.method === \"GET\" && (path === \"/logs\" || path === \"/activity\")) {\n return page(\"GuildScribe Activity Logs\", renderLogsPage(await getRecentLogs()));\n }\n if (req.method === \"GET\" && (path === \"/guide\" || path === \"/commands\")) {\n return page(\"GuildScribe Bot Guide\", `

GuildScribe Bot Guide

${renderGuidePage()}`);\n }\n if (req.method === \"GET\" && (path === \"/donate\" || path === \"/donations\")) {\n return page(\n \"Support the D&D Bot\",\n `

Support the D&D Bot

If this bot has helped your campaign, you can support its continued development.

Ethereum (ETH)

0x422413678AdFC67d3d9AB545FE4e1ec1D00197fd

Send ETH using the Ethereum network. Verify the address and network in your wallet before confirming.

Bitcoin (BTC)

3JYo1Vwyh6aQENzXoi16rA9mXZuZQVL1rN

Send BTC using the Bitcoin network. Verify the address carefully before confirming.

Back to the bot

`,\n );\n }\n\n if (req.method === \"GET\" && path === \"/callback\") {\n const error = url.searchParams.get(\"error\");\n if (error) {\n return page(\n \"Twitch connection cancelled\",\n `

Connection cancelled

${escapeHtml(url.searchParams.get(\"error_description\") ?? error)}

`,\n );\n }\n const code = url.searchParams.get(\"code\");\n const state = url.searchParams.get(\"state\");\n if (!code || !state) return new Response(\"Missing OAuth code or state\", { status: 400 });\n const check = await sqlite.execute(\"SELECT * FROM oauth_states WHERE state = ? AND expires_at > ?\", [\n state,\n Date.now(),\n ]);\n if (!check.rows.length) return new Response(\"Invalid or expired OAuth state\", { status: 400 });\n await sqlite.execute(\"DELETE FROM oauth_states WHERE state = ?\", [state]);\n try {\n const token = await exchangeCode(code, `${url.origin}/callback`);\n const userRes = await fetch(\"https://api.twitch.tv/helix/users\", {\n headers: {\n Authorization: `Bearer ${token.access_token}`,\n \"Client-Id\": env(\"TWITCH_CLIENT_ID\"),\n },\n });\n if (!userRes.ok) throw new Error(`Could not identify broadcaster: ${userRes.status}`);\n const user = (await userRes.json()).data[0];\n const sub = await createChatSubscription(user.id, url.origin);\n await sqlite.execute(\n \"INSERT OR REPLACE INTO broadcasters (broadcaster_id,login,display_name,subscription_id,connected_at) VALUES (?,?,?,?,?)\",\n [user.id, user.login, user.display_name, sub.id, Date.now()],\n );\n return page(\n \"Twitch connected\",\n `

Connected successfully

${escapeHtml(user.display_name)} is now connected. The bot can respond in that channel after the EventSub subscription is enabled.

Important: In your Twitch chat, run /mod GuildScribeBot so the bot can read and respond reliably.

`,\n );\n } catch (e) {\n console.error(e);\n return page(\"Connection failed\", `

Connection failed

${escapeHtml(String(e))}

`);\n }\n }\n\n if (req.method === \"GET\") {\n const username = url.searchParams.get(\"user\");\n if (!username) {\n const state = crypto.randomUUID();\n await sqlite.execute(\"INSERT INTO oauth_states (state,expires_at) VALUES (?,?)\", [\n state,\n Date.now() + 10 * 60 * 1000,\n ]);\n const auth = new URL(\"https://id.twitch.tv/oauth2/authorize\");\n auth.search = new URLSearchParams({\n client_id: env(\"TWITCH_CLIENT_ID\"),\n redirect_uri: `${url.origin}/callback`,\n response_type: \"code\",\n scope: \"channel:bot\",\n state,\n }).toString();\n return page(\n \"D&D Twitch Bot\",\n `

D&D Twitch Bot

Connect your Twitch channel to enable the bot.

Add Bot to My Channel

Important: After connecting, mod the bot in your channel with /mod GuildScribeBot so it can read and respond reliably.

View all commands and bot info

Support the bot

`,\n );\n }\n const c = await getCharacter(username);\n if (!c) return new Response(\"No character found for that user.\", { status: 404 });\n return new Response(renderCharacterPage(c), {\n headers: { \"Content-Type\": \"text/html; charset=utf-8\" },\n });\n }\n\n if (req.method !== \"POST\") return new Response(\"OK\");\n\n // ── EventSub webhook ──\n const rawBody = await req.text();\n if (!(await verifyEventSub(req, rawBody))) return new Response(\"Invalid signature\", { status: 403 });\n const messageType = req.headers.get(\"Twitch-Eventsub-Message-Type\");\n const body = JSON.parse(rawBody);\n\n if (messageType === \"webhook_callback_verification\") {\n return new Response(body.challenge, { headers: { \"Content-Type\": \"text/plain\" } });\n }\n\n if (messageType === \"notification\") {\n const chatMessage: string = body.event?.message?.text ?? \"\";\n const chatter: string = body.event?.chatter_user_login ?? \"\";\n const display: string = body.event?.chatter_user_name ?? chatter;\n const chatterId: string = body.event?.chatter_user_id ?? \"\";\n const moderatorId: string = body.event?.moderator_user_id ?? \"\";\n const eventBroadcasterId: string = body.event?.broadcaster_user_id ?? \"\";\n const broadcasterId: string = body.event?.source_broadcaster_user_id ?? eventBroadcasterId;\n const isModerator =\n chatterId === broadcasterId ||\n chatterId === eventBroadcasterId ||\n chatterId === moderatorId ||\n hasModeratorBadge(body.event);\n const baseUrl = url.origin;\n\n console.log(`[${broadcasterId}] ${chatter} said: ${chatMessage}`);\n\n if (isBotAccount(chatter, chatterId, env(\"TWITCH_BOT_ID\"))) return new Response(\"OK\");\n\n // Channel enable/disable toggle\n const botToggle = chatMessage.trim().match(/^!dndbot\\s+(on|off|status)$/i);\n if (botToggle) {\n if (!isModerator) {\n await sendChatMessage(\n `@${display} only the broadcaster or a moderator can change the bot setting.`,\n broadcasterId,\n );\n } else if (botToggle[1].toLowerCase() === \"status\") {\n await sendChatMessage(\n `@${display} GuildScribe is currently ${(await isChannelEnabled(broadcasterId)) ? \"on\" : \"off\"} in this channel.`,\n broadcasterId,\n );\n } else {\n const enabled = botToggle[1].toLowerCase() === \"on\";\n await setChannelEnabled(broadcasterId, enabled);\n await sendChatMessage(\n `@${display} GuildScribe is now ${enabled ? \"on\" : \"off\"} in this channel.`,\n broadcasterId,\n );\n }\n return new Response(\"OK\");\n }\n\n if (!(await isChannelEnabled(broadcasterId))) return new Response(\"OK\");\n\n if (chatMessage.startsWith(\"!\")) {\n await recordActivity(chatter, broadcasterId, chatMessage.split(/\\s+/)[0].toLowerCase(), chatMessage);\n }\n\n // Command handlers (return true if handled)\n if (await handleCreationCommand(chatter, display, broadcasterId, chatMessage)) return new Response(\"OK\");\n if (await handleInitiativeCommand(chatMessage, broadcasterId, display, isModerator)) return new Response(\"OK\");\n if (await handlePartyCommand(chatMessage, chatter, display, broadcasterId)) return new Response(\"OK\");\n if (await handlePartyDuelCommand(chatMessage, chatter, display, broadcasterId)) return new Response(\"OK\");\n // Monster first: only claims exact \"!dndduel\" / \"!dndduel attack\" / \"!dndduel monster …\"\n // so player-vs-player \"!dndduel @user\" still falls through to handleDuelCommand.\n if (await handleMonsterDuelCommand(chatMessage, chatter, display, broadcasterId)) return new Response(\"OK\");\n if (await handleDuelCommand(chatMessage, chatter, display, broadcasterId)) return new Response(\"OK\");\n\n if (chatMessage === \"!logs\") {\n if (!isModerator) {\n await sendChatMessage(`@${display} only the broadcaster or a moderator can use !logs.`, broadcasterId);\n } else {\n const logs = await getRecentLogs(broadcasterId, 8);\n await sendChatMessages(\n logs.length\n ? `@${display} Recent activity: ${logs.reverse().map(logRowText).join(\" || \")}`\n : `@${display} no activity has been logged yet.`,\n broadcasterId,\n );\n }\n } else if (chatMessage === \"!connections\") {\n if (!isModerator) {\n await sendChatMessage(\n `@${display} only the broadcaster or a moderator can use !connections.`,\n broadcasterId,\n );\n } else {\n const names = await getConnections();\n await sendChatMessages(\n `@${display} Connected channels (${names.length}): ${names.length ? names.join(\", \") : \"none\"}`,\n broadcasterId,\n );\n }\n } else if (chatMessage === \"!help\") {\n await sendWelcomeMessage(display, broadcasterId);\n } else if (chatMessage === \"!link\") {\n await sendChatMessage(`@${display} GuildScribe Bot Guide ${PUBLIC_BASE_URL}/guide`, broadcasterId);\n } else if (/^!dndbothelp(?:\\s+\\w+)?$/i.test(chatMessage)) {\n const category = chatMessage.split(/\\s+/)[1]?.toLowerCase();\n const help =\n category === \"dice\"\n ? \"Dice: !roll | !r | !d20 (D20 of Fate) | !roll NdS[+/-M] | !d20 @user | !roll @user [NdS[+/-M]] to roll on someone's behalf\"\n : category === \"settings\"\n ? \"Settings (mod): !dndbot on | !dndbot off | !dndbot status\"\n : category === \"character\"\n ? \"Character: !newchar | !answer | !cancel | !createchar | !createchar @user (mod only) | !char | !char @user | !levelup [+/-levels] | !hp [+/-amount] | !savechar | !loadchar | !resetchar\"\n : category === \"combat\"\n ? \"Combat: !dndduel @user | !dndduel classic @user | !dndduel accept/attack | !dndduel (monster) | !dndduel party A B | !dndduel party hunt (group vs monster auto) | !dndduel party hunt classic | !dndduel party hunt attack\"\n : category === \"lookup\"\n ? \"Lookups: !spell | !item | !class | !feat | !ability | !race | !subrace | !rule / !rules (e.g. !rule advantage, !rules combat)\"\n : `Categories: dice | character | combat | lookup | settings. Expand one with !dndbothelp .`;\n await sendChatMessages(`@${display} ${help}`, broadcasterId);\n } else if (/^!levelup(?:\\s+([+-]\\d+))?$/i.test(chatMessage)) {\n const match = chatMessage.match(/^!levelup(?:\\s+([+-]\\d+))?$/i)!;\n const delta = match[1] ? Number.parseInt(match[1], 10) : 1;\n const result = await adjustLevel(chatter, delta);\n if (\"error\" in result) {\n const errorText =\n result.error === \"no character\"\n ? \"you don't have a character yet — try !createchar\"\n : result.error === \"max level\"\n ? \"you're already level 20\"\n : result.error === \"min level\"\n ? \"you're already level 1\"\n : \"use !levelup, !levelup +2, or !levelup -1\";\n await sendChatMessage(`@${display} ${errorText}`, broadcasterId);\n } else {\n const direction = result.delta > 0 ? \"advanced\" : \"reduced\";\n const hpChange = result.hpGain >= 0 ? `HP +${result.hpGain}` : `HP ${result.hpGain}`;\n await sendChatMessage(\n `@${display} level ${direction} from ${result.oldLevel} to ${result.c.level}; ${hpChange}, HP ${result.c.hpCurrent}/${result.c.hpMax}, Prof +${result.c.proficiency}.${result.asi}`,\n broadcasterId,\n );\n }\n } else if (/^!(spell|item|class|feat|ability|race|subrace|rule|rules)\\s+/i.test(chatMessage)) {\n const match = chatMessage.match(\n /^!(spell|item|class|feat|ability|race|subrace|rule|rules)\\s+(.+?)(?:\\s+\\+(\\d+))?$/i,\n )!;\n const kind = match[1].toLowerCase();\n const bonus = match[3] ? Math.min(20, Number.parseInt(match[3], 10)) : null;\n const data = await lookup5e(kind, match[2].trim());\n if (data && kind === \"spell\") {\n await sendSpellSections(formatSpellSections(data, bonus), display, broadcasterId);\n } else {\n await sendChatMessages(\n data\n ? `@${display} ${formatLookup(kind, data, bonus)}`\n : `@${display} couldn't find that ${kind}. Try e.g. !spell fireball, !item longsword, or !rule advantage`,\n broadcasterId,\n );\n }\n } else if (/^!(?:roll|r|d20)(?:\\s+.*)?$/i.test(chatMessage)) {\n // Support: !d20 | !d20 @user | !roll | !roll @user 2d6+3 | !r 4d8\n let rest = chatMessage.replace(/^!(?:roll|r|d20)\\s*/i, \"\").trim();\n let rollTarget: string | null = null;\n const targetMatch = rest.match(/^@(\\S+)\\s*(.*)$/);\n if (targetMatch) {\n rollTarget = targetMatch[1].replace(/[,:]+$/, \"\");\n rest = targetMatch[2].trim();\n }\n const expression = rest || \"1d20\";\n const result = rollDice(expression);\n if (!result) {\n await sendChatMessage(\n `@${display} that's not a valid roll — try !roll, !r, !d20, or !roll 2d6+3`,\n broadcasterId,\n );\n } else if (rollTarget) {\n await sendChatMessage(`@${display} rolled for @${rollTarget}: ${result}`, broadcasterId);\n } else {\n await sendChatMessage(`@${display} ${result}`, broadcasterId);\n }\n } else if (/^!createchar(?:\\s+@?\\S+)?$/i.test(chatMessage)) {\n const createMatch = chatMessage.match(/^!createchar(?:\\s+@?(\\S+))?$/i)!;\n const createTarget = createMatch[1] ? createMatch[1].toLowerCase() : null;\n if (createTarget && createTarget !== chatter && !isModerator) {\n await sendChatMessage(\n `@${display} only the broadcaster or a moderator can create a character for someone else.`,\n broadcasterId,\n );\n } else {\n const targetUser = createTarget || chatter;\n const c = generateCharacter(targetUser);\n await saveCharacter(c);\n const forSomeoneElse = targetUser !== chatter;\n await sendChatMessage(\n `@${display} created a level 1 ${formatRaceName(c.race, c.subrace)} ${c.cls}${forSomeoneElse ? ` for @${targetUser}` : \"\"}! ${formatStatLine(c)} — ${baseUrl}/?user=${targetUser}`,\n broadcasterId,\n );\n }\n } else if (/^!char(?:\\s+@?\\S+)?$/i.test(chatMessage)) {\n const charMatch = chatMessage.match(/^!char(?:\\s+@?(\\S+))?$/i)!;\n const targetUser = charMatch[1] ? charMatch[1].toLowerCase().replace(/[,:]+$/, \"\") : chatter;\n const c = await getCharacter(targetUser);\n if (c) {\n const label = targetUser === chatter ? \"\" : `@${targetUser} `;\n await sendChatMessage(\n `@${display} ${label}${formatRaceName(c.race, c.subrace)} ${c.cls} — ${formatStatLine(c)} — ${baseUrl}/?user=${targetUser}`,\n broadcasterId,\n );\n } else {\n await sendChatMessage(\n targetUser === chatter\n ? `@${display} you don't have a character yet — try !createchar`\n : `@${display} @${targetUser} doesn't have a character yet.`,\n broadcasterId,\n );\n }\n } else if (chatMessage.startsWith(\"!hp \")) {\n const delta = Number.parseInt(chatMessage.slice(4).trim());\n if (Number.isNaN(delta)) {\n await sendChatMessage(`@${display} use !hp +5 or !hp -3`, broadcasterId);\n } else {\n const c = await adjustHp(chatter, delta);\n await sendChatMessage(\n c\n ? `@${display} HP: ${c.hpCurrent}/${c.hpMax}`\n : `@${display} you don't have a character yet — try !createchar`,\n broadcasterId,\n );\n }\n } else if (chatMessage === \"!savechar\") {\n await sendChatMessage(\n (await backupCharacter(chatter))\n ? `@${display} character saved!`\n : `@${display} no character to save — try !createchar`,\n broadcasterId,\n );\n } else if (chatMessage === \"!loadchar\") {\n const c = await loadBackup(chatter);\n await sendChatMessage(\n c\n ? `@${display} character loaded! ${formatStatLine(c)} — ${baseUrl}/?user=${chatter}`\n : `@${display} no saved backup found — try !savechar first`,\n broadcasterId,\n );\n } else if (chatMessage === \"!resetchar\") {\n await resetCharacter(chatter);\n await sendChatMessage(\n `@${display} character reset — use !createchar to roll a new one`,\n broadcasterId,\n );\n }\n }\n\n if (messageType === \"revocation\") console.log(\"Subscription revoked:\", body);\n return new Response(\"OK\");\n}\n\n// TWITCH_BOT_ID must be the numeric Twitch user ID belonging to TWITCH_BOT_TOKEN.\n","guildscribe",[177],"8e53bf8c-83ba-4ad1-9a9b-075cfb91e00e","lookups.ts","8e4689c6-a4d9-11f1-8724-1607ee4eb77e",103,["D",1788143831431],"// D&D 5e API lookups and formatting\n\nimport { lookupResources } from \"./data.ts\";\nimport { compactText } from \"./utils.ts\";\n\nasync function fetchFromResource(resource: string, lookupQuery: string): Promise {\n const normalized = lookupQuery\n .toLowerCase()\n .trim()\n .replace(/[^a-z0-9]+/g, \" \")\n .replace(/\\s+/g, \" \");\n const slug = normalized.replace(/ /g, \"-\");\n const base = `https://www.dnd5eapi.co/api/2014/${resource}`;\n for (const candidate of [slug, normalized.replace(/ /g, \"-\")]) {\n const direct = await fetch(`${base}/${encodeURIComponent(candidate)}`);\n if (direct.ok) return await direct.json();\n }\n const res = await fetch(base);\n if (!res.ok) return null;\n const list = (await res.json()).results ?? [];\n const comparable = (value: string) => value.toLowerCase().replace(/[^a-z0-9]/g, \"\");\n const wanted = comparable(lookupQuery);\n const found =\n list.find((x: any) => comparable(x.name) === wanted) ??\n list.find((x: any) => comparable(x.name).includes(wanted) || wanted.includes(comparable(x.name)));\n if (!found) return null;\n const detail = await fetch(`https://www.dnd5eapi.co${found.url}`);\n return detail.ok ? await detail.json() : null;\n}\n\nexport async function lookup5e(kind: string, query: string): Promise {\n const resource = lookupResources[kind];\n if (!resource || !query || query.length > 60) return null;\n const abilityAliases: Record = {\n strength: \"str\",\n dexterity: \"dex\",\n constitution: \"con\",\n intelligence: \"int\",\n wisdom: \"wis\",\n charisma: \"cha\",\n };\n const lookupQuery = kind === \"ability\" ? (abilityAliases[query.toLowerCase().trim()] ?? query) : query;\n\n // Rules: try specific sections first, then chapter-level \"rules\"\n if (kind === \"rule\" || kind === \"rules\") {\n const section = await fetchFromResource(\"rule-sections\", lookupQuery);\n if (section) return { ...section, _kind: \"rule-section\" };\n const chapter = await fetchFromResource(\"rules\", lookupQuery);\n if (chapter) return { ...chapter, _kind: \"rule-chapter\" };\n return null;\n }\n\n return fetchFromResource(resource, lookupQuery);\n}\n\nexport function formatSpellSections(data: any, bonus: number | null = null) {\n const upcast = bonus && bonus > 0 ? bonus : 0;\n const baseSlot = data.level + upcast;\n const slotDamage = data.damage?.damage_at_slot_level?.[String(baseSlot)];\n const damage = data.damage\n ? `${data.damage.damage_type?.name ?? \"Damage\"} ${\n slotDamage\n ? `at slot ${baseSlot}: ${slotDamage}`\n : Object.entries(data.damage.damage_at_slot_level ?? {})\n .map(([level, dice]) => `L${level}:${dice}`)\n .join(\"/\")\n }`\n : \"no direct damage\";\n const dc = data.dc ? `${data.dc.dc_type?.name ?? \"save\"} save (${data.dc.dc_success ?? \"normal\"})` : \"no save\";\n const area = data.area_of_effect\n ? `${data.area_of_effect.size}-ft ${data.area_of_effect.type}`\n : \"not listed\";\n const components = (data.components ?? []).join(\"\") || \"none\";\n const material = data.material ? `; material: ${compactText(data.material, 80)}` : \"\";\n const classes =\n compactText((data.classes ?? []).map((x: any) => x.name).join(\", \"), 100) || \"none listed\";\n const higher = data.higher_level?.length ? compactText(data.higher_level[0], 180) : \"none\";\n return [\n `${data.name} Lv${data.level}${upcast ? ` (upcast +${upcast}, slot ${baseSlot})` : \"\"} ${data.school?.name ?? \"magic\"} | Cast: ${data.casting_time} | Range: ${data.range} | Duration: ${data.duration}${data.concentration ? \" (concentration)\" : \"\"}`,\n `Components: ${components}${material} | Damage: ${damage} | Save: ${dc} | Area: ${area}`,\n `Classes: ${classes} | Higher levels: ${higher}`,\n ];\n}\n\nexport function formatLookup(kind: string, data: any, bonus: number | null = null) {\n const name = data.name;\n const bonusText = bonus !== null ? `modifier +${bonus}; ` : \"\";\n if (kind === \"item\") {\n const damage = data.damage\n ? `${data.damage.damage_dice ?? \"?\"} ${data.damage.damage_type?.name ?? \"damage\"}`\n : \"no weapon damage\";\n const range =\n data.range?.normal != null\n ? data.range.long != null\n ? `${data.range.normal}-${data.range.long} ft`\n : `${data.range.normal} ft`\n : \"melee\";\n const props = compactText((data.properties ?? []).map((x: any) => x.name).join(\", \"), 90);\n const ac = data.armor_category\n ? `AC ${data.armor_class?.base ?? \"?\"}${data.armor_class?.dex_bonus ? \"+ Dex\" : \"\"}`\n : \"\";\n const itemParts = [\n `${bonusText}${bonus !== null ? `attack/damage +${bonus}` : \"\"}`,\n damage,\n `range ${range}`,\n ac,\n `weight ${data.weight ?? \"?\"} lb`,\n `cost ${data.cost?.quantity ?? \"?\"} ${data.cost?.unit ?? \"gp\"}`,\n `properties ${props || \"none\"}`,\n ].filter((part) => part.trim());\n return `${name}: ${itemParts.join(\"; \")}`;\n }\n if (kind === \"class\") {\n const saves = (data.saving_throws ?? []).map((x: any) => x.name).join(\", \") || \"none listed\";\n const profs = compactText((data.proficiencies ?? []).map((x: any) => x.name).join(\", \"), 140);\n return `${name}: ${bonusText}Hit Die d${data.hit_die}; saves ${saves}; proficiencies ${profs || \"none listed\"}`;\n }\n if (kind === \"feat\") {\n const prereq =\n (data.prerequisites ?? [])\n .map((x: any) => `${x.ability_score?.name ?? \"ability\"} ${x.minimum_score ?? \"?\"}`)\n .join(\", \") || \"none listed\";\n return `${name}: ${bonusText}prerequisite ${prereq}; ${compactText((data.desc ?? []).join(\" \"), 220)}`;\n }\n if (kind === \"ability\") {\n const skills = compactText((data.skills ?? []).map((x: any) => x.name).join(\", \"), 100);\n return `${name}: ${bonusText}score ${data.full_name ?? name}; skills ${skills || \"none listed\"}; ${compactText((data.desc ?? []).join(\" \"), 180)}`;\n }\n if (kind === \"race\" || kind === \"subrace\") {\n const bonuses =\n (data.ability_bonuses ?? [])\n .map(\n (b: any) =>\n `${b.ability_score?.name ?? b.ability_score?.index?.toUpperCase() ?? \"ability\"} +${b.bonus}`,\n )\n .join(\", \") || \"none listed\";\n const traits = compactText((data.traits ?? data.racial_traits ?? []).map((x: any) => x.name).join(\", \"));\n const languages = compactText((data.languages ?? []).map((x: any) => x.name).join(\", \"), 80);\n const parent = data.race?.name ? `; parent race ${data.race.name}` : \"\";\n return `${name}: ${bonusText}bonuses ${bonuses}; speed ${data.speed ?? \"?\"} ft; size ${data.size ?? \"?\"}${parent}; languages ${languages || \"not listed\"}; traits ${traits || \"none listed\"}`;\n }\n if (kind === \"rule\" || kind === \"rules\") {\n // desc may be a markdown string (rule-sections) or array\n const rawDesc = Array.isArray(data.desc) ? data.desc.join(\" \") : String(data.desc ?? \"\");\n const cleaned = rawDesc\n .replace(/\\|/g, \" \")\n .replace(/#{1,6}\\s*/g, \"\")\n .replace(/\\n+/g, \" \");\n const body = compactText(cleaned, 280);\n const subsections = Array.isArray(data.subsections)\n ? compactText(data.subsections.map((s: any) => s.name).join(\", \"), 100)\n : \"\";\n const subNote = subsections ? ` | See also: ${subsections}` : \"\";\n return `${name}: ${body || \"no description\"}${subNote}`;\n }\n return name;\n}\n",[187],"0db2918d-b81c-4003-a453-320a66075935","deno.json","2c8aa57e-a3c0-11f1-9adc-1607ee4eb77e",4,["D",1788018120139],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/98f62cee78e85bfc47c62ed703777c6bc8794f1c/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": true,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"include\": [\"deno:/https/esm.town/**/*\"],\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}",[194],"e07c06d3-2f34-4c78-84e4-65c3157b2b52","db.ts","82592d08-a4d9-11f1-854e-1607ee4eb77e",108,["D",1788144274905],5,"// SQLite persistence layer\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\nimport type { Character } from \"./types.ts\";\n\nexport async function ensureTables() {\n await sqlite.execute(\n `CREATE TABLE IF NOT EXISTS characters (\n username TEXT PRIMARY KEY, race TEXT, subrace TEXT, class TEXT, level INTEGER,\n str INTEGER, dex INTEGER, con INTEGER, int INTEGER, wis INTEGER, cha INTEGER,\n speed INTEGER, hp_max INTEGER, hp_current INTEGER, proficiency INTEGER, traits TEXT\n )`,\n );\n await sqlite.execute(\n `CREATE TABLE IF NOT EXISTS character_backups (\n username TEXT PRIMARY KEY, race TEXT, subrace TEXT, class TEXT, level INTEGER,\n str INTEGER, dex INTEGER, con INTEGER, int INTEGER, wis INTEGER, cha INTEGER,\n speed INTEGER, hp_max INTEGER, hp_current INTEGER, proficiency INTEGER, traits TEXT\n )`,\n );\n for (const table of [\"characters\", \"character_backups\"]) {\n for (const column of [\"spells\", \"items\", \"feats\", \"abilities\"]) {\n try {\n await sqlite.execute(`ALTER TABLE ${table} ADD COLUMN ${column} TEXT DEFAULT '[]'`);\n } catch (_) {\n /* column already exists */\n }\n }\n try {\n await sqlite.execute(`ALTER TABLE ${table} ADD COLUMN xp INTEGER DEFAULT 0`);\n } catch (_) {\n /* column already exists */\n }\n }\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS oauth_states (state TEXT PRIMARY KEY, expires_at INTEGER)`);\n await sqlite.execute(\n `CREATE TABLE IF NOT EXISTS broadcasters (\n broadcaster_id TEXT PRIMARY KEY, login TEXT, display_name TEXT, subscription_id TEXT, connected_at INTEGER\n )`,\n );\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS welcomed_users (username TEXT PRIMARY KEY, welcomed_at INTEGER)`);\n await sqlite.execute(\n `CREATE TABLE IF NOT EXISTS creation_sessions (\n username TEXT PRIMARY KEY, step TEXT, race TEXT, subrace TEXT, class TEXT, scores TEXT, updated_at INTEGER\n )`,\n );\n await sqlite.execute(\n `CREATE TABLE IF NOT EXISTS encounters (\n broadcaster_id TEXT PRIMARY KEY, round INTEGER, current_index INTEGER, active INTEGER, entries TEXT, updated_at INTEGER\n )`,\n );\n await sqlite.execute(\n `CREATE TABLE IF NOT EXISTS activity_logs (\n id INTEGER PRIMARY KEY AUTOINCREMENT, username TEXT, broadcaster_id TEXT, action TEXT, detail TEXT, created_at INTEGER\n )`,\n );\n await sqlite.execute(\n `CREATE TABLE IF NOT EXISTS channel_settings (\n broadcaster_id TEXT PRIMARY KEY, enabled INTEGER NOT NULL DEFAULT 1, updated_at INTEGER\n )`,\n );\n await sqlite.execute(\n `CREATE TABLE IF NOT EXISTS duel_challenges (\n broadcaster_id TEXT, challenger TEXT, defender TEXT, created_at INTEGER,\n PRIMARY KEY (broadcaster_id, challenger, defender)\n )`,\n );\n try {\n await sqlite.execute(`ALTER TABLE duel_challenges ADD COLUMN mode TEXT DEFAULT 'auto'`);\n } catch (_) {\n /* column already exists */\n }\n await sqlite.execute(\n `CREATE TABLE IF NOT EXISTS duels (\n broadcaster_id TEXT PRIMARY KEY, challenger TEXT, defender TEXT, current_turn TEXT,\n challenger_hp INTEGER, defender_hp INTEGER, active INTEGER, updated_at INTEGER\n )`,\n );\n await sqlite.execute(\n `CREATE TABLE IF NOT EXISTS parties (\n broadcaster_id TEXT, party_name TEXT, owner TEXT, created_at INTEGER,\n PRIMARY KEY (broadcaster_id, party_name)\n )`,\n );\n await sqlite.execute(\n `CREATE TABLE IF NOT EXISTS party_members (\n broadcaster_id TEXT, party_name TEXT, username TEXT, joined_at INTEGER,\n PRIMARY KEY (broadcaster_id, party_name, username)\n )`,\n );\n await sqlite.execute(\n `CREATE TABLE IF NOT EXISTS party_duel_challenges (\n broadcaster_id TEXT, challenger_party TEXT, defender_party TEXT,\n challenger_owner TEXT, defender_owner TEXT, created_at INTEGER,\n PRIMARY KEY (broadcaster_id, challenger_party, defender_party)\n )`,\n );\n try {\n await sqlite.execute(`ALTER TABLE party_duel_challenges ADD COLUMN mode TEXT DEFAULT 'auto'`);\n } catch (_) {\n /* column already exists */\n }\n await sqlite.execute(\n `CREATE TABLE IF NOT EXISTS party_duels (\n broadcaster_id TEXT PRIMARY KEY, challenger_party TEXT, defender_party TEXT,\n current_side TEXT, current_index INTEGER, challenger_members TEXT, defender_members TEXT,\n challenger_hp TEXT, defender_hp TEXT, active INTEGER, updated_at INTEGER\n )`,\n );\n await sqlite.execute(\n `CREATE TABLE IF NOT EXISTS monster_duels (\n broadcaster_id TEXT PRIMARY KEY, player TEXT, monster_name TEXT, monster_cr TEXT,\n monster_ac INTEGER, monster_hp INTEGER, monster_hp_max INTEGER, monster_attack INTEGER,\n monster_damage_die INTEGER, monster_damage_bonus INTEGER, current_turn TEXT, active INTEGER, updated_at INTEGER\n )`,\n );\n await sqlite.execute(\n `CREATE TABLE IF NOT EXISTS party_monster_duels (\n broadcaster_id TEXT PRIMARY KEY,\n party_name TEXT,\n members TEXT,\n member_hp TEXT,\n current_index INTEGER,\n monster_name TEXT,\n monster_cr TEXT,\n monster_ac INTEGER,\n monster_hp INTEGER,\n monster_hp_max INTEGER,\n monster_attack INTEGER,\n monster_damage_die INTEGER,\n monster_damage_bonus INTEGER,\n active INTEGER,\n updated_at INTEGER\n )`,\n );\n}\n\nexport async function getPartyMonsterDuel(broadcasterId: string) {\n const res = await sqlite.execute(\n \"SELECT * FROM party_monster_duels WHERE broadcaster_id = ? AND active = 1\",\n [broadcasterId],\n );\n if (!res.rows.length) return null;\n const r = res.rows[0];\n return {\n ...r,\n current_index: Number(r.current_index),\n members: JSON.parse(r.members || \"[]\") as string[],\n member_hp: JSON.parse(r.member_hp || \"{}\") as Record,\n };\n}\n\nexport function rowToCharacter(r: any): Character {\n return {\n username: r.username,\n race: r.race,\n subrace: r.subrace,\n cls: r.class,\n level: r.level,\n xp: Number(r.xp ?? 0),\n scores: { STR: r.str, DEX: r.dex, CON: r.con, INT: r.int, WIS: r.wis, CHA: r.cha },\n speed: r.speed,\n hpMax: r.hp_max,\n hpCurrent: r.hp_current,\n proficiency: r.proficiency,\n traits: JSON.parse(r.traits || \"[]\"),\n spells: JSON.parse(r.spells || \"[]\"),\n items: JSON.parse(r.items || \"[]\"),\n feats: JSON.parse(r.feats || \"[]\"),\n abilities: JSON.parse(r.abilities || \"[]\"),\n };\n}\n\nexport async function getCharacter(username: string) {\n const res = await sqlite.execute(\"SELECT * FROM characters WHERE username = ?\", [username]);\n return res.rows.length ? rowToCharacter(res.rows[0]) : null;\n}\n\nexport async function saveCharacter(c: Character) {\n await sqlite.execute(\n `INSERT OR REPLACE INTO characters\n (username,race,subrace,class,level,xp,str,dex,con,int,wis,cha,speed,hp_max,hp_current,proficiency,traits,spells,items,feats,abilities)\n VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)`,\n [\n c.username,\n c.race,\n c.subrace,\n c.cls,\n c.level,\n c.xp ?? 0,\n c.scores.STR,\n c.scores.DEX,\n c.scores.CON,\n c.scores.INT,\n c.scores.WIS,\n c.scores.CHA,\n c.speed,\n c.hpMax,\n c.hpCurrent,\n c.proficiency,\n JSON.stringify(c.traits),\n JSON.stringify(c.spells),\n JSON.stringify(c.items),\n JSON.stringify(c.feats),\n JSON.stringify(c.abilities),\n ],\n );\n}\n\nexport async function adjustHp(username: string, delta: number) {\n const c = await getCharacter(username);\n if (!c) return null;\n c.hpCurrent = Math.max(0, Math.min(c.hpMax, c.hpCurrent + delta));\n await sqlite.execute(\"UPDATE characters SET hp_current = ? WHERE username = ?\", [c.hpCurrent, username]);\n return c;\n}\n\nexport async function backupCharacter(username: string) {\n const c = await getCharacter(username);\n if (!c) return false;\n await sqlite.execute(\n `INSERT OR REPLACE INTO character_backups\n (username,race,subrace,class,level,xp,str,dex,con,int,wis,cha,speed,hp_max,hp_current,proficiency,traits,spells,items,feats,abilities)\n VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)`,\n [\n c.username,\n c.race,\n c.subrace,\n c.cls,\n c.level,\n c.xp ?? 0,\n c.scores.STR,\n c.scores.DEX,\n c.scores.CON,\n c.scores.INT,\n c.scores.WIS,\n c.scores.CHA,\n c.speed,\n c.hpMax,\n c.hpCurrent,\n c.proficiency,\n JSON.stringify(c.traits),\n JSON.stringify(c.spells),\n JSON.stringify(c.items),\n JSON.stringify(c.feats),\n JSON.stringify(c.abilities),\n ],\n );\n return true;\n}\n\nexport async function loadBackup(username: string) {\n const res = await sqlite.execute(\"SELECT * FROM character_backups WHERE username = ?\", [username]);\n if (!res.rows.length) return null;\n const c = rowToCharacter(res.rows[0]);\n await saveCharacter(c);\n return c;\n}\n\nexport async function resetCharacter(username: string) {\n await sqlite.execute(\"DELETE FROM characters WHERE username = ?\", [username]);\n}\n\nexport async function getCreationSession(username: string) {\n const res = await sqlite.execute(\"SELECT * FROM creation_sessions WHERE username = ?\", [username]);\n if (!res.rows.length) return null;\n const r = res.rows[0];\n return {\n username,\n step: r.step,\n race: r.race,\n subrace: r.subrace,\n cls: r.class,\n scores: r.scores ? JSON.parse(r.scores) : null,\n };\n}\n\nexport async function saveCreationSession(s: any) {\n await sqlite.execute(\n \"INSERT OR REPLACE INTO creation_sessions (username,step,race,subrace,class,scores,updated_at) VALUES (?,?,?,?,?,?,?)\",\n [\n s.username,\n s.step,\n s.race ?? null,\n s.subrace ?? null,\n s.cls ?? null,\n s.scores ? JSON.stringify(s.scores) : null,\n Date.now(),\n ],\n );\n}\n\nexport async function clearCreationSession(username: string) {\n await sqlite.execute(\"DELETE FROM creation_sessions WHERE username = ?\", [username]);\n}\n\nexport async function getConnections() {\n const res = await sqlite.execute(\"SELECT display_name, login FROM broadcasters ORDER BY connected_at ASC\");\n return res.rows.map((r: any) => r.display_name || r.login);\n}\n\nexport async function isChannelEnabled(broadcasterId: string) {\n const res = await sqlite.execute(\"SELECT enabled FROM channel_settings WHERE broadcaster_id = ?\", [broadcasterId]);\n return !res.rows.length || Number(res.rows[0].enabled) === 1;\n}\n\nexport async function setChannelEnabled(broadcasterId: string, enabled: boolean) {\n await sqlite.execute(\n \"INSERT OR REPLACE INTO channel_settings (broadcaster_id, enabled, updated_at) VALUES (?,?,?)\",\n [broadcasterId, enabled ? 1 : 0, Date.now()],\n );\n}\n\nexport async function getDuel(broadcasterId: string) {\n const res = await sqlite.execute(\"SELECT * FROM duels WHERE broadcaster_id = ? AND active = 1\", [broadcasterId]);\n return res.rows.length ? res.rows[0] : null;\n}\n\nexport async function getMonsterDuel(broadcasterId: string) {\n const res = await sqlite.execute(\"SELECT * FROM monster_duels WHERE broadcaster_id = ? AND active = 1\", [\n broadcasterId,\n ]);\n return res.rows.length ? res.rows[0] : null;\n}\n\nexport async function getParty(broadcasterId: string, partyName: string) {\n const res = await sqlite.execute(\"SELECT * FROM parties WHERE broadcaster_id = ? AND party_name = ?\", [\n broadcasterId,\n partyName.toLowerCase(),\n ]);\n return res.rows.length ? res.rows[0] : null;\n}\n\nexport async function getPartyMembers(broadcasterId: string, partyName: string) {\n const res = await sqlite.execute(\n \"SELECT username FROM party_members WHERE broadcaster_id = ? AND party_name = ? ORDER BY joined_at ASC\",\n [broadcasterId, partyName.toLowerCase()],\n );\n return res.rows.map((r: any) => String(r.username));\n}\n\nexport async function getPartyDuel(broadcasterId: string) {\n const res = await sqlite.execute(\"SELECT * FROM party_duels WHERE broadcaster_id = ? AND active = 1\", [\n broadcasterId,\n ]);\n if (!res.rows.length) return null;\n const r = res.rows[0];\n return {\n ...r,\n current_index: Number(r.current_index),\n challenger_members: JSON.parse(r.challenger_members || \"[]\"),\n defender_members: JSON.parse(r.defender_members || \"[]\"),\n challenger_hp: JSON.parse(r.challenger_hp || \"{}\"),\n defender_hp: JSON.parse(r.defender_hp || \"{}\"),\n };\n}\n\nexport async function getEncounter(broadcasterId: string) {\n const res = await sqlite.execute(\"SELECT * FROM encounters WHERE broadcaster_id = ?\", [broadcasterId]);\n if (!res.rows.length) return null;\n const r = res.rows[0];\n return {\n broadcasterId,\n round: Number(r.round),\n currentIndex: Number(r.current_index),\n active: Boolean(r.active),\n entries: JSON.parse(r.entries || \"[]\") as Array<{ name: string; initiative: number }>,\n };\n}\n\nexport async function saveEncounter(e: any) {\n await sqlite.execute(\n \"INSERT OR REPLACE INTO encounters (broadcaster_id,round,current_index,active,entries,updated_at) VALUES (?,?,?,?,?,?)\",\n [e.broadcasterId, e.round, e.currentIndex, e.active ? 1 : 0, JSON.stringify(e.entries), Date.now()],\n );\n}\n\nexport async function recordActivity(username: string, broadcasterId: string, action: string, detail: string) {\n await sqlite.execute(\n \"INSERT INTO activity_logs (username,broadcaster_id,action,detail,created_at) VALUES (?,?,?,?,?)\",\n [username, broadcasterId, action.slice(0, 40), detail.replace(/\\s+/g, \" \").trim().slice(0, 220), Date.now()],\n );\n await sqlite.execute(\n \"DELETE FROM activity_logs WHERE id NOT IN (SELECT id FROM activity_logs ORDER BY id DESC LIMIT 5000)\",\n );\n}\n\nexport async function getRecentLogs(broadcasterId?: string, limit = 200) {\n const safeLimit = Math.max(1, Math.min(500, Math.floor(limit)));\n const query = broadcasterId\n ? `SELECT username,broadcaster_id,action,detail,created_at FROM activity_logs WHERE broadcaster_id = ? ORDER BY id DESC LIMIT ${safeLimit}`\n : `SELECT username,broadcaster_id,action,detail,created_at FROM activity_logs ORDER BY id DESC LIMIT ${safeLimit}`;\n const res = await sqlite.execute(query, broadcasterId ? [broadcasterId] : []);\n return res.rows;\n}\n\nexport { sqlite };\n",[201],"c237da47-833e-44d5-8860-67cd98e42ce0","data.ts","799fb39e-a4d9-11f1-8231-1607ee4eb77e",107,["D",1788144274843],6,"// Static D&D 5e (2014) baseline data\n\nimport type { Ability, Race, ClassData } from \"./types.ts\";\n\nexport const races: Record = {\n Human: {\n subraces: [\"Standard\", \"Variant\"],\n bonuses: { STR: 1, DEX: 1, CON: 1, INT: 1, WIS: 1, CHA: 1 },\n speed: 30,\n traits: [\"Extra Language\"],\n },\n Elf: {\n subraces: [\"High Elf\", \"Wood Elf\", \"Drow\"],\n bonuses: { DEX: 2 },\n speed: 30,\n traits: [\"Darkvision\", \"Keen Senses\", \"Fey Ancestry\", \"Trance\"],\n },\n Dwarf: {\n subraces: [\"Hill Dwarf\", \"Mountain Dwarf\"],\n bonuses: { CON: 2 },\n speed: 25,\n traits: [\"Darkvision\", \"Dwarven Resilience\", \"Dwarven Combat Training\"],\n },\n Halfling: {\n subraces: [\"Lightfoot\", \"Stout\"],\n bonuses: { DEX: 2 },\n speed: 25,\n traits: [\"Lucky\", \"Brave\", \"Halfling Nimbleness\"],\n },\n Dragonborn: {\n subraces: [],\n bonuses: { STR: 2, CHA: 1 },\n speed: 30,\n traits: [\"Draconic Ancestry\", \"Breath Weapon\", \"Damage Resistance\"],\n },\n Gnome: {\n subraces: [\"Forest Gnome\", \"Rock Gnome\"],\n bonuses: { INT: 2 },\n speed: 25,\n traits: [\"Darkvision\", \"Gnome Cunning\"],\n },\n \"Half-Elf\": {\n subraces: [],\n bonuses: { CHA: 2 },\n speed: 30,\n traits: [\"Darkvision\", \"Fey Ancestry\", \"Skill Versatility\"],\n },\n \"Half-Orc\": {\n subraces: [],\n bonuses: { STR: 2, CON: 1 },\n speed: 30,\n traits: [\"Darkvision\", \"Relentless Endurance\", \"Savage Attacks\"],\n },\n Tiefling: {\n subraces: [\"Asmodeus\", \"Baalzebul\", \"Dispater\", \"Mammon\", \"Mephistopheles\"],\n bonuses: { INT: 1, CHA: 2 },\n speed: 30,\n traits: [\"Darkvision\", \"Hellish Resistance\", \"Infernal Legacy\"],\n },\n};\n\nexport const subraceBonuses: Record>> = {\n \"High Elf\": { INT: 1 },\n \"Wood Elf\": { WIS: 1 },\n Drow: { CHA: 1 },\n \"Hill Dwarf\": { WIS: 1 },\n \"Mountain Dwarf\": { STR: 2 },\n Lightfoot: { CHA: 1 },\n Stout: { CON: 1 },\n \"Forest Gnome\": { DEX: 1 },\n \"Rock Gnome\": { CON: 1 },\n};\n\nexport const classes: Record = {\n Barbarian: {\n priority: [\"STR\", \"CON\", \"DEX\", \"WIS\", \"CHA\", \"INT\"],\n savingThrows: [\"STR\", \"CON\"],\n hitDie: 12,\n calling: \"a fury-wreathed reaver\",\n },\n Fighter: {\n priority: [\"STR\", \"CON\", \"DEX\", \"WIS\", \"CHA\", \"INT\"],\n savingThrows: [\"STR\", \"CON\"],\n hitDie: 10,\n calling: \"a battle-tested champion\",\n },\n Paladin: {\n priority: [\"STR\", \"CHA\", \"CON\", \"WIS\", \"DEX\", \"INT\"],\n savingThrows: [\"WIS\", \"CHA\"],\n hitDie: 10,\n calling: \"a sworn guardian of a sacred oath\",\n },\n Ranger: {\n priority: [\"DEX\", \"WIS\", \"CON\", \"STR\", \"CHA\", \"INT\"],\n savingThrows: [\"STR\", \"DEX\"],\n hitDie: 10,\n calling: \"a tireless warden of the wild\",\n },\n Rogue: {\n priority: [\"DEX\", \"INT\", \"CON\", \"WIS\", \"CHA\", \"STR\"],\n savingThrows: [\"DEX\", \"INT\"],\n hitDie: 8,\n calling: \"a shadow-swift opportunist\",\n },\n Monk: {\n priority: [\"DEX\", \"WIS\", \"CON\", \"STR\", \"INT\", \"CHA\"],\n savingThrows: [\"STR\", \"DEX\"],\n hitDie: 8,\n calling: \"a disciplined master of body and spirit\",\n },\n Bard: {\n priority: [\"CHA\", \"DEX\", \"CON\", \"WIS\", \"INT\", \"STR\"],\n savingThrows: [\"DEX\", \"CHA\"],\n hitDie: 8,\n calling: \"a silver-tongued keeper of legends\",\n },\n Sorcerer: {\n priority: [\"CHA\", \"CON\", \"DEX\", \"WIS\", \"INT\", \"STR\"],\n savingThrows: [\"CON\", \"CHA\"],\n hitDie: 6,\n calling: \"a spellcaster born with dangerous power\",\n },\n Warlock: {\n priority: [\"CHA\", \"CON\", \"DEX\", \"WIS\", \"INT\", \"STR\"],\n savingThrows: [\"WIS\", \"CHA\"],\n hitDie: 8,\n calling: \"a pact-bound seeker of forbidden secrets\",\n },\n Cleric: {\n priority: [\"WIS\", \"STR\", \"CON\", \"CHA\", \"DEX\", \"INT\"],\n savingThrows: [\"WIS\", \"CHA\"],\n hitDie: 8,\n calling: \"a divine vessel carrying a god's will\",\n },\n Druid: {\n priority: [\"WIS\", \"CON\", \"DEX\", \"INT\", \"CHA\", \"STR\"],\n savingThrows: [\"INT\", \"WIS\"],\n hitDie: 8,\n calling: \"a shape-shifting voice of the wild\",\n },\n Wizard: {\n priority: [\"INT\", \"CON\", \"DEX\", \"WIS\", \"CHA\", \"STR\"],\n savingThrows: [\"INT\", \"WIS\"],\n hitDie: 6,\n calling: \"a scholar who bends reality through study\",\n },\n};\n\nexport const abilityNames: Ability[] = [\"STR\", \"DEX\", \"CON\", \"INT\", \"WIS\", \"CHA\"];\n\n/** Solo monsters with numeric CR for level banding. */\nexport type SoloMonster = {\n name: string;\n cr: string;\n crValue: number;\n ac: number;\n hp: number;\n attack: number;\n die: number;\n bonus: number;\n};\n\nexport const SOLO_MONSTERS: SoloMonster[] = [\n // CR 1/8 – 1/4 (levels ~1)\n { name: \"Giant Rat\", cr: \"1/8\", crValue: 0.125, ac: 12, hp: 7, attack: 4, die: 4, bonus: 2 },\n { name: \"Stirge\", cr: \"1/8\", crValue: 0.125, ac: 14, hp: 2, attack: 5, die: 4, bonus: 3 },\n { name: \"Kobold Skirmisher\", cr: \"1/8\", crValue: 0.125, ac: 12, hp: 5, attack: 4, die: 4, bonus: 2 },\n { name: \"Goblin Scavenger\", cr: \"1/4\", crValue: 0.25, ac: 15, hp: 7, attack: 4, die: 6, bonus: 2 },\n { name: \"Skeleton Guard\", cr: \"1/4\", crValue: 0.25, ac: 13, hp: 13, attack: 4, die: 6, bonus: 2 },\n { name: \"Zombie Shambler\", cr: \"1/4\", crValue: 0.25, ac: 8, hp: 22, attack: 3, die: 6, bonus: 1 },\n { name: \"Wolf\", cr: \"1/4\", crValue: 0.25, ac: 13, hp: 11, attack: 4, die: 4, bonus: 2 },\n { name: \"Drow Scout\", cr: \"1/4\", crValue: 0.25, ac: 15, hp: 13, attack: 4, die: 6, bonus: 2 },\n // CR 1/2\n { name: \"Wolf Pack Scout\", cr: \"1/2\", crValue: 0.5, ac: 13, hp: 18, attack: 4, die: 6, bonus: 2 },\n { name: \"Shadow\", cr: \"1/2\", crValue: 0.5, ac: 12, hp: 16, attack: 4, die: 6, bonus: 2 },\n { name: \"Cockatrice\", cr: \"1/2\", crValue: 0.5, ac: 11, hp: 27, attack: 3, die: 4, bonus: 1 },\n { name: \"Gnoll Hunter\", cr: \"1/2\", crValue: 0.5, ac: 15, hp: 22, attack: 4, die: 6, bonus: 2 },\n { name: \"Orc Raider\", cr: \"1/2\", crValue: 0.5, ac: 13, hp: 15, attack: 5, die: 8, bonus: 3 },\n { name: \"Thug\", cr: \"1/2\", crValue: 0.5, ac: 11, hp: 32, attack: 4, die: 6, bonus: 2 },\n // CR 1\n { name: \"Dire Wolf\", cr: \"1\", crValue: 1, ac: 14, hp: 37, attack: 5, die: 6, bonus: 3 },\n { name: \"Harpy\", cr: \"1\", crValue: 1, ac: 11, hp: 38, attack: 3, die: 6, bonus: 1 },\n { name: \"Imp\", cr: \"1\", crValue: 1, ac: 13, hp: 10, attack: 5, die: 4, bonus: 3 },\n { name: \"Quasit\", cr: \"1\", crValue: 1, ac: 13, hp: 7, attack: 4, die: 4, bonus: 3 },\n { name: \"Specter\", cr: \"1\", crValue: 1, ac: 12, hp: 22, attack: 4, die: 6, bonus: 2 },\n { name: \"Bugbear\", cr: \"1\", crValue: 1, ac: 16, hp: 27, attack: 4, die: 8, bonus: 2 },\n { name: \"Giant Spider\", cr: \"1\", crValue: 1, ac: 14, hp: 26, attack: 5, die: 8, bonus: 3 },\n { name: \"Yuan-ti Pureblood\", cr: \"1\", crValue: 1, ac: 11, hp: 40, attack: 3, die: 6, bonus: 1 },\n // CR 2\n { name: \"Ogre Brute\", cr: \"2\", crValue: 2, ac: 11, hp: 59, attack: 6, die: 10, bonus: 4 },\n { name: \"Gargoyle\", cr: \"2\", crValue: 2, ac: 15, hp: 52, attack: 4, die: 6, bonus: 2 },\n { name: \"Gelatinous Cube\", cr: \"2\", crValue: 2, ac: 6, hp: 84, attack: 4, die: 6, bonus: 2 },\n { name: \"Gibbering Mouther\", cr: \"2\", crValue: 2, ac: 9, hp: 67, attack: 2, die: 6, bonus: 0 },\n { name: \"Grick\", cr: \"2\", crValue: 2, ac: 14, hp: 54, attack: 4, die: 8, bonus: 2 },\n { name: \"Mimic\", cr: \"2\", crValue: 2, ac: 12, hp: 58, attack: 5, die: 8, bonus: 3 },\n { name: \"Will-o'-Wisp\", cr: \"2\", crValue: 2, ac: 19, hp: 22, attack: 4, die: 8, bonus: 0 },\n { name: \"Ettercap\", cr: \"2\", crValue: 2, ac: 13, hp: 44, attack: 4, die: 8, bonus: 2 },\n // CR 3\n { name: \"Owlbear\", cr: \"3\", crValue: 3, ac: 13, hp: 59, attack: 7, die: 10, bonus: 4 },\n { name: \"Manticore\", cr: \"3\", crValue: 3, ac: 14, hp: 68, attack: 5, die: 6, bonus: 3 },\n { name: \"Minotaur\", cr: \"3\", crValue: 3, ac: 14, hp: 76, attack: 6, die: 12, bonus: 4 },\n { name: \"Phase Spider\", cr: \"3\", crValue: 3, ac: 13, hp: 32, attack: 4, die: 10, bonus: 2 },\n { name: \"Werewolf\", cr: \"3\", crValue: 3, ac: 12, hp: 58, attack: 4, die: 8, bonus: 2 },\n { name: \"Wight\", cr: \"3\", crValue: 3, ac: 14, hp: 45, attack: 4, die: 6, bonus: 2 },\n { name: \"Basilisk\", cr: \"3\", crValue: 3, ac: 15, hp: 52, attack: 5, die: 6, bonus: 3 },\n { name: \"Displacer Beast\", cr: \"3\", crValue: 3, ac: 13, hp: 85, attack: 6, die: 6, bonus: 4 },\n // CR 4\n { name: \"Ettin\", cr: \"4\", crValue: 4, ac: 12, hp: 85, attack: 7, die: 8, bonus: 5 },\n { name: \"Black Pudding\", cr: \"4\", crValue: 4, ac: 7, hp: 85, attack: 5, die: 6, bonus: 3 },\n { name: \"Couatl\", cr: \"4\", crValue: 4, ac: 16, hp: 97, attack: 8, die: 6, bonus: 5 },\n { name: \"Elephant\", cr: \"4\", crValue: 4, ac: 12, hp: 76, attack: 8, die: 8, bonus: 5 },\n { name: \"Ghost\", cr: \"4\", crValue: 4, ac: 11, hp: 45, attack: 5, die: 6, bonus: 3 },\n { name: \"Lamia\", cr: \"4\", crValue: 4, ac: 13, hp: 97, attack: 5, die: 10, bonus: 3 },\n { name: \"Red Dragon Wyrmling\", cr: \"4\", crValue: 4, ac: 17, hp: 75, attack: 6, die: 10, bonus: 4 },\n { name: \"Succubus\", cr: \"4\", crValue: 4, ac: 15, hp: 66, attack: 5, die: 6, bonus: 3 },\n // CR 5\n { name: \"Troll\", cr: \"5\", crValue: 5, ac: 15, hp: 84, attack: 7, die: 6, bonus: 4 },\n { name: \"Young Dragon\", cr: \"5\", crValue: 5, ac: 17, hp: 75, attack: 7, die: 10, bonus: 4 },\n { name: \"Bulette\", cr: \"5\", crValue: 5, ac: 17, hp: 94, attack: 7, die: 12, bonus: 4 },\n { name: \"Elemental Earth\", cr: \"5\", crValue: 5, ac: 17, hp: 126, attack: 8, die: 8, bonus: 5 },\n { name: \"Flesh Golem\", cr: \"5\", crValue: 5, ac: 9, hp: 93, attack: 7, die: 8, bonus: 4 },\n { name: \"Hill Giant Scout\", cr: \"5\", crValue: 5, ac: 13, hp: 105, attack: 8, die: 10, bonus: 5 },\n { name: \"Night Hag\", cr: \"5\", crValue: 5, ac: 17, hp: 112, attack: 7, die: 8, bonus: 4 },\n { name: \"Shambling Mound\", cr: \"5\", crValue: 5, ac: 15, hp: 136, attack: 7, die: 8, bonus: 4 },\n { name: \"Unicorn\", cr: \"5\", crValue: 5, ac: 12, hp: 67, attack: 7, die: 8, bonus: 4 },\n { name: \"Vampire Spawn\", cr: \"5\", crValue: 5, ac: 15, hp: 82, attack: 6, die: 6, bonus: 3 },\n // CR 6\n { name: \"Hill Giant\", cr: \"6\", crValue: 6, ac: 13, hp: 105, attack: 8, die: 10, bonus: 5 },\n { name: \"Mammoth\", cr: \"6\", crValue: 6, ac: 13, hp: 126, attack: 10, die: 10, bonus: 7 },\n { name: \"Medusa\", cr: \"6\", crValue: 6, ac: 15, hp: 127, attack: 5, die: 6, bonus: 2 },\n { name: \"Cyclops\", cr: \"6\", crValue: 6, ac: 14, hp: 138, attack: 9, die: 10, bonus: 6 },\n { name: \"Wyvern\", cr: \"6\", crValue: 6, ac: 13, hp: 110, attack: 7, die: 6, bonus: 4 },\n { name: \"Young White Dragon\", cr: \"6\", crValue: 6, ac: 17, hp: 133, attack: 7, die: 10, bonus: 4 },\n // CR 7\n { name: \"Chimera\", cr: \"7\", crValue: 7, ac: 14, hp: 114, attack: 8, die: 10, bonus: 4 },\n { name: \"Giant Ape\", cr: \"7\", crValue: 7, ac: 12, hp: 157, attack: 9, die: 10, bonus: 6 },\n { name: \"Oni\", cr: \"7\", crValue: 7, ac: 16, hp: 110, attack: 7, die: 8, bonus: 4 },\n { name: \"Shield Guardian\", cr: \"7\", crValue: 7, ac: 17, hp: 142, attack: 7, die: 6, bonus: 4 },\n { name: \"Stone Giant\", cr: \"7\", crValue: 7, ac: 17, hp: 126, attack: 9, die: 8, bonus: 6 },\n { name: \"Young Black Dragon\", cr: \"7\", crValue: 7, ac: 18, hp: 127, attack: 7, die: 10, bonus: 4 },\n // CR 8\n { name: \"Frost Giant\", cr: \"8\", crValue: 8, ac: 15, hp: 138, attack: 9, die: 12, bonus: 6 },\n { name: \"Fomorian\", cr: \"8\", crValue: 8, ac: 14, hp: 149, attack: 9, die: 8, bonus: 6 },\n { name: \"Hydra (young)\", cr: \"8\", crValue: 8, ac: 15, hp: 172, attack: 8, die: 10, bonus: 5 },\n { name: \"Tyrannosaurus Rex\", cr: \"8\", crValue: 8, ac: 13, hp: 136, attack: 10, die: 12, bonus: 7 },\n { name: \"Young Green Dragon\", cr: \"8\", crValue: 8, ac: 18, hp: 136, attack: 7, die: 10, bonus: 4 },\n { name: \"Mind Flayer\", cr: \"8\", crValue: 8, ac: 15, hp: 71, attack: 7, die: 10, bonus: 4 },\n // CR 9\n { name: \"Fire Giant\", cr: \"9\", crValue: 9, ac: 18, hp: 162, attack: 10, die: 10, bonus: 7 },\n { name: \"Cloud Giant\", cr: \"9\", crValue: 9, ac: 14, hp: 200, attack: 12, die: 12, bonus: 8 },\n { name: \"Glabrezu\", cr: \"9\", crValue: 9, ac: 17, hp: 157, attack: 10, die: 10, bonus: 6 },\n { name: \"Young Blue Dragon\", cr: \"9\", crValue: 9, ac: 18, hp: 152, attack: 9, die: 10, bonus: 5 },\n { name: \"Treant\", cr: \"9\", crValue: 9, ac: 16, hp: 138, attack: 10, die: 10, bonus: 6 },\n // CR 10\n { name: \"Stone Golem\", cr: \"10\", crValue: 10, ac: 17, hp: 178, attack: 10, die: 10, bonus: 6 },\n { name: \"Aboleth\", cr: \"10\", crValue: 10, ac: 17, hp: 135, attack: 9, die: 6, bonus: 5 },\n { name: \"Deva\", cr: \"10\", crValue: 10, ac: 17, hp: 136, attack: 8, die: 6, bonus: 4 },\n { name: \"Guardian Naga\", cr: \"10\", crValue: 10, ac: 18, hp: 127, attack: 8, die: 8, bonus: 4 },\n { name: \"Young Red Dragon\", cr: \"10\", crValue: 10, ac: 18, hp: 178, attack: 10, die: 10, bonus: 6 },\n { name: \"Death Slaad\", cr: \"10\", crValue: 10, ac: 18, hp: 170, attack: 9, die: 10, bonus: 5 },\n // CR 11\n { name: \"Behir\", cr: \"11\", crValue: 11, ac: 17, hp: 168, attack: 10, die: 10, bonus: 6 },\n { name: \"Horned Devil\", cr: \"11\", crValue: 11, ac: 18, hp: 178, attack: 10, die: 10, bonus: 6 },\n { name: \"Remorhaz\", cr: \"11\", crValue: 11, ac: 17, hp: 195, attack: 11, die: 10, bonus: 7 },\n { name: \"Roc\", cr: \"11\", crValue: 11, ac: 15, hp: 248, attack: 13, die: 10, bonus: 9 },\n { name: \"Efreeti\", cr: \"11\", crValue: 11, ac: 17, hp: 200, attack: 10, die: 10, bonus: 6 },\n // CR 12\n { name: \"Adult Dragon Wyrmling-Guard\", cr: \"12\", crValue: 12, ac: 18, hp: 200, attack: 11, die: 12, bonus: 7 },\n { name: \"Archmage Shade\", cr: \"12\", crValue: 12, ac: 15, hp: 99, attack: 6, die: 8, bonus: 2 },\n { name: \"Erinyes\", cr: \"12\", crValue: 12, ac: 18, hp: 153, attack: 8, die: 8, bonus: 4 },\n { name: \"Kraken Spawn\", cr: \"12\", crValue: 12, ac: 16, hp: 230, attack: 12, die: 10, bonus: 8 },\n { name: \"Purple Worm Juvenile\", cr: \"12\", crValue: 12, ac: 18, hp: 220, attack: 12, die: 12, bonus: 8 },\n];\n\n/**\n * Pick a monster appropriate for the player's level.\n * Tuned so solo heroes win often (~60–75%) without trivializing fights.\n */\nexport function pickMonsterForLevel(level: number): SoloMonster {\n const lv = Math.max(1, Math.min(20, Math.floor(level || 1)));\n // Softer curve than true 5e deadly encounters — stream-friendly.\n // L1 → ~0.25–0.5 | L4 → ~1 | L8 → ~2 | L12 → ~3.5 | L20 → ~5.5\n const targetCr = Math.max(0.125, Math.min(10, (lv + 1) / 4));\n const minCr = 0.125;\n const maxCr = Math.min(12, targetCr * 1.25 + 0.25);\n\n let pool = SOLO_MONSTERS.filter((m) => m.crValue >= minCr && m.crValue <= maxCr);\n if (!pool.length) {\n pool = [...SOLO_MONSTERS]\n .sort((a, b) => Math.abs(a.crValue - targetCr) - Math.abs(b.crValue - targetCr))\n .slice(0, 5);\n }\n\n // Weight toward monsters at or below target CR (easier wins more often).\n const weights = pool.map((m) => {\n if (m.crValue <= targetCr) return 3;\n if (m.crValue <= targetCr * 1.15) return 1.2;\n return 0.4;\n });\n const totalW = weights.reduce((a, b) => a + b, 0);\n let roll = Math.random() * totalW;\n let base = pool[0];\n for (let i = 0; i < pool.length; i++) {\n roll -= weights[i];\n if (roll <= 0) {\n base = pool[i];\n break;\n }\n }\n\n // Player-favoring scale: lower HP, slight AC softener, modest attack growth.\n const hpScale = 0.55 + (lv / 20) * 0.25; // ~0.55–0.80\n return {\n ...base,\n hp: Math.max(6, Math.round(base.hp * hpScale)),\n attack: Math.max(2, Math.round(base.attack * 0.9 + (lv - 1) * 0.08)),\n bonus: Math.max(0, Math.round(base.bonus * 0.85 + (lv - 1) * 0.05)),\n ac: Math.min(18, Math.max(10, base.ac - 1 + Math.floor((lv - 1) / 8))),\n };\n}\n\nexport const knownBotAccounts = new Set([\n \"nightbot\",\n \"streamelements\",\n \"streamlabs\",\n \"moobot\",\n \"fossabot\",\n \"wizebot\",\n \"deepbot\",\n \"coebot\",\n \"ankhbot\",\n]);\n\nexport const lookupResources: Record = {\n spell: \"spells\",\n item: \"equipment\",\n class: \"classes\",\n feat: \"feats\",\n ability: \"ability-scores\",\n race: \"races\",\n subrace: \"subraces\",\n rule: \"rule-sections\",\n rules: \"rule-sections\",\n};\n\nexport const MAX_LOOKUP_MESSAGE_LENGTH = 300;\n",[209],"cedeb3d7-5de8-48a2-804a-c14a206857ae",["D",1788144274844],[28],"588c0f60-bd8d-4ae8-b026-36313ad6e429","characters.ts","8571f1d2-a4d9-11f1-8da9-1607ee4eb77e",96,["D",1788143288436],"// Character generation, leveling, and guided creation wizard\n\nimport type { Ability, Character } from \"./types.ts\";\nimport { races, subraceBonuses, classes, abilityNames } from \"./data.ts\";\nimport {\n pick,\n modifier,\n rollStat,\n formatRaceName,\n formatStatLine,\n} from \"./utils.ts\";\nimport {\n getCharacter,\n saveCharacter,\n getCreationSession,\n saveCreationSession,\n clearCreationSession,\n} from \"./db.ts\";\nimport { sendChatMessage } from \"./twitch.ts\";\n\nexport function generateCharacter(username: string): Character {\n const race = pick(Object.keys(races));\n const cls = pick(Object.keys(classes));\n const raceData = races[race];\n const classData = classes[cls];\n const subrace = raceData.subraces.length ? pick(raceData.subraces) : null;\n const scores = Array.from({ length: 6 }, rollStat).sort((a, b) => b - a);\n const abilityScores = {} as Record;\n classData.priority.forEach((ability, i) => (abilityScores[ability] = scores[i]));\n const bonuses: Partial> = {\n ...raceData.bonuses,\n ...(subrace ? subraceBonuses[subrace] : {}),\n };\n if (race === \"Human\" && subrace === \"Variant\") {\n for (const a of abilityNames) delete bonuses[a];\n bonuses[classData.priority[0]] = 1;\n bonuses[classData.priority[1]] = 1;\n }\n if (race === \"Half-Elf\") {\n const choices = classData.priority.filter((a) => a !== \"CHA\").slice(0, 2);\n bonuses[choices[0]] = 1;\n bonuses[choices[1]] = 1;\n }\n for (const a of abilityNames) {\n abilityScores[a] = Math.min(20, abilityScores[a] + (bonuses[a] ?? 0));\n }\n const hpMax = Math.max(1, classData.hitDie + modifier(abilityScores.CON));\n return {\n username,\n race,\n subrace,\n cls,\n level: 1,\n xp: 0,\n scores: abilityScores,\n speed: raceData.speed,\n hpMax,\n hpCurrent: hpMax,\n proficiency: 2,\n traits: raceData.traits,\n spells: [],\n items: [],\n feats: [],\n abilities: [],\n };\n}\n\nexport function customCharacterFromSession(s: any): Character {\n const raceData = races[s.race];\n const bonuses: Partial> = {\n ...raceData.bonuses,\n ...(s.subrace ? subraceBonuses[s.subrace] ?? {} : {}),\n };\n const scores = {} as Record;\n const rolled = s.scores as number[];\n classes[s.cls].priority.forEach((a: Ability, i: number) => {\n scores[a] = Math.min(20, rolled[i] + (bonuses[a] ?? 0));\n });\n const hp = Math.max(1, classes[s.cls].hitDie + modifier(scores.CON));\n return {\n username: s.username,\n race: s.race,\n subrace: s.subrace || null,\n cls: s.cls,\n level: 1,\n xp: 0,\n scores,\n speed: raceData.speed,\n hpMax: hp,\n hpCurrent: hp,\n proficiency: 2,\n traits: raceData.traits,\n spells: [],\n items: [],\n feats: [],\n abilities: [],\n };\n}\n\n/** 5e-style XP for common solo-monster CRs used by the bot. */\nexport function xpForMonsterCr(cr: string): number {\n const table: Record = {\n \"0\": 10,\n \"1/8\": 25,\n \"1/4\": 50,\n \"1/2\": 100,\n \"1\": 200,\n \"2\": 450,\n \"3\": 700,\n \"4\": 1100,\n \"5\": 1800,\n \"6\": 2300,\n \"7\": 2900,\n \"8\": 3900,\n \"9\": 5000,\n \"10\": 5900,\n \"11\": 7200,\n \"12\": 8400,\n };\n return table[String(cr).trim()] ?? 100;\n}\n\n/**\n * Award XP for defeating a monster (never for PvP).\n * Optionally auto-levels when XP crosses 5e thresholds.\n */\nexport async function awardMonsterXp(\n username: string,\n cr: string,\n): Promise<{ gained: number; total: number; leveledTo?: number } | null> {\n const c = await getCharacter(username);\n if (!c) return null;\n const gained = xpForMonsterCr(cr);\n c.xp = (c.xp ?? 0) + gained;\n\n // 5e cumulative XP thresholds (levels 1–12 enough for bot content)\n const thresholds = [0, 300, 900, 2700, 6500, 14000, 23000, 34000, 48000, 64000, 85000, 100000];\n let newLevel = c.level;\n for (let lv = thresholds.length; lv >= 1; lv--) {\n if (c.xp >= thresholds[lv - 1]) {\n newLevel = Math.min(20, lv);\n break;\n }\n }\n let leveledTo: number | undefined;\n if (newLevel > c.level) {\n const classData = classes[c.cls];\n const perLevelHp = Math.max(1, Math.floor(classData.hitDie / 2) + 1 + modifier(c.scores.CON));\n const baseHp = Math.max(1, classData.hitDie + modifier(c.scores.CON));\n const oldHpMax = c.hpMax;\n c.level = newLevel;\n c.hpMax = baseHp + (newLevel - 1) * perLevelHp;\n c.hpCurrent = Math.max(0, Math.min(c.hpMax, c.hpCurrent + (c.hpMax - oldHpMax)));\n c.proficiency = Math.floor((newLevel - 1) / 4) + 2;\n leveledTo = newLevel;\n }\n await saveCharacter(c);\n return { gained, total: c.xp, leveledTo };\n}\n\nexport async function adjustLevel(username: string, delta: number) {\n const c = await getCharacter(username);\n if (!c) return { error: \"no character\" as const };\n if (!Number.isInteger(delta) || delta === 0) return { error: \"invalid amount\" as const };\n const oldLevel = c.level;\n const newLevel = Math.max(1, Math.min(20, oldLevel + delta));\n if (newLevel === oldLevel) {\n return { error: (delta > 0 ? \"max level\" : \"min level\") as const };\n }\n const classData = classes[c.cls];\n const perLevelHp = Math.max(1, Math.floor(classData.hitDie / 2) + 1 + modifier(c.scores.CON));\n const baseHp = Math.max(1, classData.hitDie + modifier(c.scores.CON));\n const oldHpMax = c.hpMax;\n c.level = newLevel;\n c.hpMax = baseHp + (newLevel - 1) * perLevelHp;\n c.hpCurrent = Math.max(0, Math.min(c.hpMax, c.hpCurrent + (c.hpMax - oldHpMax)));\n c.proficiency = Math.floor((newLevel - 1) / 4) + 2;\n await saveCharacter(c);\n const asi = [4, 8, 12, 16, 19].includes(newLevel) ? \" Ability Score Improvement/feat available.\" : \"\";\n return { c, oldLevel, delta: newLevel - oldLevel, hpGain: c.hpMax - oldHpMax, asi };\n}\n\nexport async function handleCreationCommand(\n username: string,\n display: string,\n broadcasterId: string,\n chatMessage: string,\n) {\n if (chatMessage === \"!newchar\") {\n await saveCreationSession({ username, step: \"race\" });\n await sendChatMessage(\n `@${display} New character started. Choose a race: ${Object.keys(races).join(\", \")}. Reply !answer . Type !cancel to stop.`,\n broadcasterId,\n );\n return true;\n }\n if (chatMessage === \"!cancel\") {\n const active = await getCreationSession(username);\n if (!active) return false;\n await clearCreationSession(username);\n await sendChatMessage(`@${display} Character creation cancelled.`, broadcasterId);\n return true;\n }\n if (!chatMessage.startsWith(\"!answer \")) return false;\n const s = await getCreationSession(username);\n if (!s) return false;\n const answer = chatMessage.slice(8).trim();\n\n if (s.step === \"race\") {\n const race = Object.keys(races).find((x) => x.toLowerCase() === answer.toLowerCase());\n if (!race) {\n await sendChatMessage(`@${display} Choose a race from: ${Object.keys(races).join(\", \")}.`, broadcasterId);\n return true;\n }\n s.race = race;\n if (races[race].subraces.length) {\n s.step = \"subrace\";\n await saveCreationSession(s);\n await sendChatMessage(\n `@${display} Choose a ${race} subrace: ${races[race].subraces.join(\", \")}. Reply !answer .`,\n broadcasterId,\n );\n } else {\n s.step = \"class\";\n await saveCreationSession(s);\n await sendChatMessage(\n `@${display} Choose a class: ${Object.keys(classes).join(\", \")}. Reply !answer .`,\n broadcasterId,\n );\n }\n return true;\n }\n\n if (s.step === \"subrace\") {\n const subrace = races[s.race].subraces.find((x) => x.toLowerCase() === answer.toLowerCase());\n if (!subrace) {\n await sendChatMessage(\n `@${display} Choose a subrace from: ${races[s.race].subraces.join(\", \")}.`,\n broadcasterId,\n );\n return true;\n }\n s.subrace = subrace;\n s.step = \"class\";\n await saveCreationSession(s);\n await sendChatMessage(\n `@${display} Choose a class: ${Object.keys(classes).join(\", \")}. Reply !answer .`,\n broadcasterId,\n );\n return true;\n }\n\n if (s.step === \"class\") {\n const cls = Object.keys(classes).find((x) => x.toLowerCase() === answer.toLowerCase());\n if (!cls) {\n await sendChatMessage(`@${display} Choose a class from: ${Object.keys(classes).join(\", \")}.`, broadcasterId);\n return true;\n }\n s.cls = cls;\n s.step = \"scores\";\n await saveCreationSession(s);\n await sendChatMessage(\n `@${display} Enter 6 scores in order of importance, or use standard: !answer 15 14 13 12 10 8. ${cls} priority: ${classes[cls].priority.join(\", \")}.`,\n broadcasterId,\n );\n return true;\n }\n\n if (s.step === \"scores\") {\n const scores =\n answer.toLowerCase() === \"standard\"\n ? [15, 14, 13, 12, 10, 8]\n : answer.split(/[ ,]+/).map(Number);\n if (scores.length !== 6 || scores.some((n: number) => !Number.isInteger(n) || n < 3 || n > 18)) {\n await sendChatMessage(\n `@${display} Enter exactly 6 whole-number scores from 3 to 18, such as !answer 15 14 13 12 10 8.`,\n broadcasterId,\n );\n return true;\n }\n s.scores = scores;\n s.step = \"confirm\";\n await saveCreationSession(s);\n const preview = customCharacterFromSession(s);\n await sendChatMessage(\n `@${display} Confirm: level 1 ${formatRaceName(preview.race, preview.subrace)} ${preview.cls}, ${formatStatLine(preview)}. Reply !answer yes to save or !answer no to restart.`,\n broadcasterId,\n );\n return true;\n }\n\n if (s.step === \"confirm\") {\n if (answer.toLowerCase() === \"yes\") {\n const c = customCharacterFromSession(s);\n await saveCharacter(c);\n await clearCreationSession(username);\n await sendChatMessage(\n `@${display} Character saved! Use !char, !levelup, !savechar, and !loadchar.`,\n broadcasterId,\n );\n } else if (answer.toLowerCase() === \"no\") {\n await clearCreationSession(username);\n await sendChatMessage(`@${display} Character discarded. Start again with !newchar.`, broadcasterId);\n } else {\n await sendChatMessage(`@${display} Reply !answer yes to save or !answer no to discard.`, broadcasterId);\n }\n return true;\n }\n\n return false;\n}\n",[220],"4dc32a2a-818c-4125-a0f4-b44eb38ee632","README.md","a9ce1e16-a4d9-11f1-939e-1607ee4eb77e",93,["D",1788142376585],"# GuildScribe — Modular Split\n\nThis is the original monolithic Val Town script broken into smaller modules so each file stays under Val Town’s ~80 000 character limit.\n\n## File map\n\n| File | Role |\n|------|------|\n| **main.ts** | Entry point (`export default`). HTTP routes + chat command dispatcher. **Point Val Town at this file.** |\n| **types.ts** | Shared TypeScript types (`Ability`, `Race`, `Character`, …) |\n| **data.ts** | Static data: races, classes, monsters, lookup resource map |\n| **utils.ts** | Pure helpers: dice, formatting, narration, bot detection |\n| **db.ts** | SQLite schema + all persistence helpers |\n| **characters.ts** | Character generation, leveling, guided `!newchar` wizard |\n| **combat.ts** | Duels, party duels, monster duels, initiative tracker |\n| **lookups.ts** | dnd5eapi.co lookups + response formatting |\n| **twitch.ts** | Twitch tokens, chat send, EventSub verification |\n| **pages.ts** | HTML page renderers (guide, logs, character sheet, donate) |\n\n## Val Town usage\n\n1. Create a new Val (or open your existing GuildScribe val).\n2. Upload / paste each `.ts` file as a sibling module in the same val project.\n3. Set the **HTTP handler** (or main entry) to `main.ts`.\n4. Keep the same environment variables:\n - `TWITCH_CLIENT_ID`\n - `TWITCH_CLIENT_SECRET`\n - `TWITCH_BOT_ID`\n - `EVENTSUB_SECRET`\n - (optional) `BOT_USERNAMES`\n\nRelative imports (`./db.ts`, etc.) work in Deno / Val Town as long as all files live in the same project.\n\n## Note\n\n`original.ts` is kept only as a reference copy of the pre-split source. You can delete it after verifying the modular version works.\n",[227],"3093561c-20ac-43b7-8cb7-664f2c560131","AGENTS.md","2c7af9b2-a3c0-11f1-a077-1607ee4eb77e",["D",1788018120020],"You are an advanced assistant specialized in generating Val Town code.\n\n## Core Guidelines\n\n- Ask clarifying questions when requirements are ambiguous\n- Provide complete, functional solutions rather than skeleton implementations\n- Test your logic against edge cases before presenting the final solution\n- Ensure all code follows Val Town's specific platform requirements\n- If a section of code that you're working on is getting too complex, consider\n refactoring it into subcomponents\n\n## Code Standards\n\n- Generate code in TypeScript or TSX\n- Add appropriate TypeScript types and interfaces for all data structures\n- Prefer official SDKs or libraries than writing API calls directly\n- Ask the user to supply API or library documentation if you are at all unsure\n about it\n- **Never bake in secrets into the code** - always use environment variables\n- Include comments explaining complex logic (avoid commenting obvious\n operations)\n- Follow modern ES6+ conventions and functional programming practices if\n possible\n\n## Types of triggers\n\n### 1. HTTP Trigger\n\n- Create web APIs and endpoints\n- Handle HTTP requests and responses\n- Example structure:\n\n```ts\nexport default async function (req: Request) {\n return new Response(\"Hello World\");\n}\n```\n\nFiles that are HTTP triggers have http in their name like `foobar.http.tsx`\n\n### 2. Cron Triggers\n\n- Run on a schedule\n- Use cron expressions for timing\n- Example structure:\n\n```ts\nexport default async function () {\n // Scheduled task code\n}\n```\n\nFiles that are Cron triggers have cron in their name like `foobar.cron.tsx`\n\n### 3. Email Triggers\n\n- Process incoming emails\n- Handle email-based workflows\n- Example structure:\n\n```ts\nexport default async function (email: Email) {\n // Process email\n}\n```\n\nFiles that are Email triggers have email in their name like `foobar.email.tsx`\n\n## Val Town Standard Libraries\n\nVal Town provides several hosted services and utility functions.\n\n### Blob Storage\n\n```ts\nimport { blob } from \"https://esm.town/v/std/blob/main.ts\";\nawait blob.setJSON(\"myKey\", { hello: \"world\" });\nlet blobDemo = await blob.getJSON(\"myKey\");\nlet appKeys = await blob.list(\"app_\");\nawait blob.delete(\"myKey\");\n```\n\n### SQLite\n\n```ts\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\nconst TABLE_NAME = \"todo_app_users_2\";\n// Create table - do this before usage and change table name when modifying schema\nawait sqlite.execute(`CREATE TABLE IF NOT EXISTS ${TABLE_NAME} (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL\n)`);\n// Query data\nconst result = await sqlite.execute(\n `SELECT * FROM ${TABLE_NAME} WHERE id = ?`,\n [1],\n);\n```\n\n### OpenAI\n\n```ts\nimport { OpenAI } from \"https://esm.town/v/std/openai\";\nconst openai = new OpenAI();\nconst completion = await openai.chat.completions.create({\n messages: [\n { role: \"user\", content: \"Say hello in a creative way\" },\n ],\n model: \"gpt-4o-mini\",\n max_tokens: 30,\n});\n```\n\n### Email\n\n```ts\nimport { email } from \"https://esm.town/v/std/email\";\n// By default emails the owner of the val\nawait email({\n subject: \"Hi\",\n text: \"Hi\",\n html: \"

Hi

\",\n});\n```\n\n## Val Town Utility Functions\n\nVal Town provides several utility functions to help with common project tasks.\n\n### Importing Utilities\n\nAlways import utilities with version pins to avoid breaking changes:\n\n```ts\nimport {\n parseProject,\n readFile,\n serveFile,\n} from \"https://esm.town/v/std/utils@85-main/index.ts\";\n```\n\n### Available Utilities\n\n#### **serveFile** - Serve project files with proper content types\n\nFor example, in Hono:\n\n```ts\n// serve all files in frontend/ and shared/\napp.get(\"/frontend/*\", (c) => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", (c) => serveFile(c.req.path, import.meta.url));\n```\n\n#### **readFile** - Read files from within the project:\n\n```ts\n// Read a file from the project\nconst fileContent = await readFile(\"/frontend/index.html\", import.meta.url);\n```\n\n#### **listFiles** - List all files in the project\n\n```ts\nconst files = await listFiles(import.meta.url);\n```\n\n#### **parseProject** - Extract information about the current project from import.meta.url\n\nThis is useful for including info for linking back to a val, ie in \"view source\"\nurls:\n\n```ts\nconst projectVal = parseProject(import.meta.url);\nconsole.log(projectVal.username); // Owner of the project\nconsole.log(projectVal.name); // Project name\nconsole.log(projectVal.version); // Version number\nconsole.log(projectVal.branch); // Branch name\nconsole.log(projectVal.links.self.project); // URL to the project page\n```\n\nHowever, it's _extremely importing_ to note that `parseProject` and other\nStandard Library utilities ONLY RUN ON THE SERVER. If you need access to this\ndata on the client, run it in the server and pass it to the client by splicing\nit into the HTML page or by making an API request for it.\n\n## Val Town Platform Specifics\n\n- **Redirects:** Use\n `return new Response(null, { status: 302, headers: { Location: \"/place/to/redirect\" }})`\n instead of `Response.redirect` which is broken\n- **Images:** Avoid external images or base64 images. Use emojis, unicode\n symbols, or icon fonts/libraries instead\n- **AI Image:** To inline generate an AI image use:\n `

`\n- **Storage:** DO NOT use the Deno KV module for storage\n- **Browser APIs:** DO NOT use the `alert()`, `prompt()`, or `confirm()` methods\n- **Weather Data:** Use open-meteo for weather data (doesn't require API keys)\n unless otherwise specified\n- **View Source:** Add a view source link by importing & using\n `import.meta.url.replace(\"esm.sh\", \"val.town)\"` (or passing this data to the\n client) and include `target=\"_top\"` attribute\n- **Error Debugging:** Add\n `` to HTML to capture\n client-side errors\n- **Error Handling:** Only use try...catch when there's a clear local\n resolution; Avoid catches that merely log or return 500s. Let errors bubble up\n with full context\n- **Environment Variables:** Use `Deno.env.get('keyname')` when you need to, but\n generally prefer APIs that don't require keys\n- **Imports:** Use `https://esm.sh` for npm and Deno dependencies to ensure\n compatibility on server and browser\n- **Storage Strategy:** Only use backend storage if explicitly required; prefer\n simple static client-side sites\n- **React Configuration:** When using React libraries, pin versions with\n `?deps=react@18.2.0,react-dom@18.2.0` and start the file with\n `/** @jsxImportSource https://esm.sh/react@18.2.0 */`\n- Ensure all React dependencies and sub-dependencies are pinned to the same\n version\n- **Styling:** Default to using TailwindCSS via\n `` unless otherwise\n specified\n\n## Project Structure and Design Patterns\n\n### Recommended Directory Structure\n\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Schema definitions\n│ │ ├── queries.ts # DB query functions\n│ │ └── README.md\n│ └── routes/ # Route modules\n│ ├── [route].ts\n│ └── static.ts # Static file serving\n│ ├── index.ts # Main entry point\n│ └── README.md\n├── frontend/\n│ ├── components/\n│ │ ├── App.tsx\n│ │ └── [Component].tsx\n│ ├── favicon.svg\n│ ├── index.html # Main HTML template\n│ ├── index.tsx # Frontend JS entry point\n│ ├── README.md\n│ └── style.css\n├── README.md\n└── shared/\n ├── README.md\n └── utils.ts # Shared types and functions\n```\n\n### Backend (Hono) Best Practices\n\n- Hono is the recommended API framework\n- Main entry point should be `backend/index.ts`\n- **Static asset serving:** Use the utility functions to read and serve project\n files:\n ```ts\n import {\n readFile,\n serveFile,\n } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\n // serve all files in frontend/ and shared/\n app.get(\"/frontend/*\", (c) => serveFile(c.req.path, import.meta.url));\n app.get(\"/shared/*\", (c) => serveFile(c.req.path, import.meta.url));\n\n // For index.html, often you'll want to bootstrap with initial data\n app.get(\"/\", async (c) => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n\n // Inject data to avoid extra round-trips\n const initialData = await fetchInitialData();\n const dataScript = ``;\n\n html = html.replace(\"\", `${dataScript}`);\n return c.html(html);\n });\n ```\n- Create RESTful API routes for CRUD operations\n- Always include this snippet at the top-level Hono app to re-throwing errors to\n see full stack traces:\n ```ts\n // Unwrap Hono errors to see original error details\n app.onError((err, c) => {\n throw err;\n });\n ```\n\n### Database Patterns\n\n- Run migrations on startup or comment out for performance\n- Change table names when modifying schemas rather than altering\n- Export clear query functions with proper TypeScript typing\n\n## Common Gotchas and Solutions\n\n1. **Environment Limitations:**\n - Val Town runs on Deno in a serverless context, not Node.js\n - Code in `shared/` must work in both frontend and backend environments\n - Cannot use `Deno` keyword in shared code\n - Use `https://esm.sh` for imports that work in both environments\n\n2. **SQLite Peculiarities:**\n - Limited support for ALTER TABLE operations\n - Create new tables with updated schemas and copy data when needed\n - Always run table creation before querying\n\n3. **React Configuration:**\n - All React dependencies must be pinned to 18.2.0\n - Always include `@jsxImportSource https://esm.sh/react@18.2.0` at the top of\n React files\n - Rendering issues often come from mismatched React versions\n\n4. **File Handling:**\n - Val Town only supports text files, not binary\n - Use the provided utilities to read files across branches and forks\n - For files in the project, use `readFile` helpers\n\n5. **API Design:**\n - `fetch` handler is the entry point for HTTP vals\n - Run the Hono app with\n `export default app.fetch // This is the entry point for HTTP vals`",[234],"722e7a17-a099-4f29-8e69-2679535add68",".vtignore","2c724ea2-a3c0-11f1-bf9f-1607ee4eb77e",1,["D",1788018119974],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor",[240],"pulls","branches","forks","envVars",{"_253":213,"_255":61},"connections",{"_253":61,"_254":61},"count","unfilledCount","emptyCount",{"_43":239,"_32":240,"_30":241,"_146":-5,"_41":42,"_40":242,"_148":124,"_38":310,"_13":61,"_33":20,"_35":244,"_24":25,"_152":-5,"_271":311,"_27":312},{"_43":233,"_32":234,"_30":235,"_146":-5,"_41":42,"_40":166,"_148":25,"_38":307,"_13":61,"_33":20,"_35":237,"_24":25,"_152":-5,"_271":308,"_27":309},{"_43":226,"_32":227,"_30":228,"_146":-5,"_41":42,"_40":229,"_148":25,"_38":304,"_13":205,"_33":20,"_35":231,"_24":25,"_152":-5,"_271":305,"_27":306},{"_43":219,"_32":220,"_30":221,"_146":-5,"_41":42,"_40":222,"_148":25,"_38":301,"_13":150,"_33":34,"_35":224,"_24":25,"_152":-5,"_271":302,"_27":303},{"_43":216,"_32":28,"_30":31,"_146":-5,"_41":42,"_40":14,"_148":25,"_38":298,"_13":213,"_33":34,"_35":37,"_24":25,"_152":-5,"_271":299,"_27":300},{"_43":208,"_32":209,"_30":210,"_146":-5,"_41":42,"_40":211,"_148":25,"_38":295,"_13":213,"_33":34,"_35":214,"_24":25,"_152":-5,"_271":296,"_27":297},{"_43":200,"_32":201,"_30":202,"_146":-5,"_41":42,"_40":203,"_148":25,"_38":292,"_13":205,"_33":34,"_35":206,"_24":25,"_152":-5,"_271":293,"_27":294},{"_43":193,"_32":194,"_30":195,"_146":-5,"_41":42,"_40":196,"_148":124,"_38":289,"_13":61,"_33":20,"_35":198,"_24":25,"_152":-5,"_271":290,"_27":291},{"_43":186,"_32":187,"_30":188,"_146":-5,"_41":42,"_40":189,"_148":25,"_38":286,"_13":150,"_33":34,"_35":191,"_24":25,"_152":-5,"_271":287,"_27":288},{"_43":176,"_32":177,"_30":178,"_146":-5,"_41":42,"_40":179,"_148":25,"_38":283,"_13":181,"_33":182,"_35":183,"_24":25,"_152":184,"_271":284,"_27":285},{"_43":169,"_32":170,"_30":171,"_146":-5,"_41":42,"_40":172,"_148":25,"_38":280,"_13":166,"_33":34,"_35":174,"_24":25,"_152":-5,"_271":281,"_27":282},{"_43":161,"_32":162,"_30":163,"_146":-5,"_41":42,"_40":164,"_148":25,"_38":277,"_13":166,"_33":34,"_35":167,"_24":25,"_152":-5,"_271":278,"_27":279},{"_43":154,"_32":155,"_30":156,"_146":-5,"_41":42,"_40":157,"_148":25,"_38":274,"_13":150,"_33":34,"_35":159,"_24":25,"_152":-5,"_271":275,"_27":276},{"_43":143,"_32":144,"_30":145,"_146":-5,"_41":42,"_40":147,"_148":25,"_38":270,"_13":150,"_33":34,"_35":151,"_24":25,"_152":-5,"_271":272,"_27":273},["D",1788143288555],"children",[],[144],["D",1788143288555],[],[155],["D",1788139249104],[],[162],["D",1788139249091],[],[170],["D",1788144274871],[],[177],["D",1788143831431],[],[187],["D",1788018120139],[],[194],["D",1788144274905],[],[201],["D",1788144274843],[],[209],["D",1788144274844],[],[28],["D",1788143288436],[],[220],["D",1788142376585],[],[227],["D",1788018120020],[],[234],["D",1788018119974],[],[240],["D",1787995257440],["D",1789500119686],{"_98":97,"_106":102},{"_98":97,"_99":100,"_101":102,"_18":55,"_103":104,"_105":25},{"_13":87,"_32":88,"_43":42,"_89":44,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":45,"_96":97},"ctx",{"_80":-5,"_126":351,"_352":353,"_354":355,"_356":25,"_357":25,"_358":25,"_359":124,"_360":-5,"_361":-7,"_362":-7,"_363":61,"_364":25,"_365":25,"_366":-5,"_367":25,"_368":25,"_369":25,"_370":-5},"ENV",{"_322":323,"_324":325,"_326":88,"_327":328,"_329":330,"_331":332,"_333":334,"_335":336,"_337":338,"_339":340,"_341":342,"_343":344,"_345":346,"_347":348,"_349":350},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v110