[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_321":322,"_323":324},"routes/_app.x.$handle.$name",{"_97":96,"_32":45,"_106":87,"_27":36,"_13":14,"_107":-5,"_11":108,"_109":110,"_111":112,"_113":114,"_115":116,"_20":-5,"_117":-5,"_118":-5,"_119":25,"_120":121,"_122":123,"_124":-5,"_125":-5,"_126":127},"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":36,"_53":-5,"_18":54,"_55":-5,"_56":25,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":64,"_65":66,"_67":68,"_69":-5,"_70":71,"_72":71,"_73":74,"_75":74,"_76":74,"_77":71,"_78":71,"_79":80,"_81":82,"_83":84,"_85":25},"version",79,"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","data.ts","latestPath","fileId","799fb39e-a4d9-11f1-8231-1607ee4eb77e","name","fileType","script","content","","// 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\nexport const SOLO_MONSTERS = [\n { name: \"Goblin Scavenger\", cr: \"1/4\", ac: 15, hp: 12, attack: 4, die: 6, bonus: 2 },\n { name: \"Dire Wolf\", cr: \"1\", ac: 14, hp: 37, attack: 5, die: 6, bonus: 3 },\n { name: \"Owlbear\", cr: \"3\", ac: 13, hp: 59, attack: 7, die: 10, bonus: 4 },\n { name: \"Troll\", cr: \"5\", ac: 15, hp: 84, attack: 7, die: 6, bonus: 4 },\n { name: \"Young Dragon\", cr: \"5\", ac: 17, hp: 75, attack: 7, die: 10, bonus: 4 },\n { name: \"Stone Golem\", cr: \"10\", ac: 17, hp: 178, attack: 10, die: 10, bonus: 6 },\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};\n\nexport const MAX_LOOKUP_MESSAGE_LENGTH = 300;\n","createdAt",["D",1788139248812],"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",{"_97":96,"_105":101},"org",{"_97":96,"_98":99,"_100":101,"_18":54,"_102":103,"_104":25},"branch",{"_13":86,"_32":87,"_43":42,"_88":44,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":45,"_95":96},"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":316,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":36,"_53":-5,"_18":54,"_55":-5,"_56":25,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":64,"_65":66,"_67":317,"_69":-5,"_70":71,"_72":71,"_73":74,"_75":74,"_76":74,"_77":71,"_78":71,"_79":318,"_81":319,"_83":320,"_85":25},"tree",[255,256,257,258,259,260,261,262,263,264,265,266,267,268,269],"files",[255,256,257,258,259,260,261,262,263,264,265,266,267,268,269],"counts",{"_244":60,"_245":150,"_246":60,"_247":248,"_249":250},"contents",[128,129,130,131,132,133,134,135,136,137,138,139,140,141,142],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles",true,"grants","orgs","customDomains",{},{"_43":238,"_32":239,"_30":240,"_146":-5,"_41":42,"_40":150,"_148":123,"_38":241,"_13":60,"_33":20,"_35":242,"_24":25,"_151":-5,"_27":243},{"_43":232,"_32":233,"_30":234,"_146":-5,"_41":42,"_40":183,"_148":25,"_38":235,"_13":60,"_33":20,"_35":236,"_24":25,"_151":-5,"_27":237},{"_43":226,"_32":227,"_30":228,"_146":-5,"_41":42,"_40":229,"_148":25,"_38":230,"_13":183,"_33":20,"_35":36,"_24":25,"_151":-5,"_27":231},{"_43":219,"_32":220,"_30":221,"_146":-5,"_41":42,"_40":222,"_148":25,"_38":223,"_13":183,"_33":34,"_35":224,"_24":25,"_151":-5,"_27":225},{"_43":212,"_32":213,"_30":214,"_146":-5,"_41":42,"_40":215,"_148":25,"_38":216,"_13":183,"_33":34,"_35":217,"_24":25,"_151":-5,"_27":218},{"_43":209,"_32":28,"_30":31,"_146":-5,"_41":42,"_40":14,"_148":25,"_38":210,"_13":183,"_33":34,"_35":37,"_24":25,"_151":-5,"_27":211},{"_43":202,"_32":203,"_30":204,"_146":-5,"_41":42,"_40":205,"_148":25,"_38":206,"_13":183,"_33":34,"_35":207,"_24":25,"_151":-5,"_27":208},{"_43":195,"_32":196,"_30":197,"_146":-5,"_41":42,"_40":198,"_148":123,"_38":199,"_13":60,"_33":20,"_35":200,"_24":25,"_151":-5,"_27":201},{"_43":186,"_32":187,"_30":188,"_146":-5,"_41":42,"_40":189,"_148":25,"_38":190,"_13":191,"_33":192,"_35":193,"_24":25,"_151":-5,"_27":194},{"_43":178,"_32":179,"_30":180,"_146":-5,"_41":42,"_40":181,"_148":25,"_38":182,"_13":183,"_33":34,"_35":184,"_24":25,"_151":-5,"_27":185},{"_43":171,"_32":172,"_30":173,"_146":-5,"_41":42,"_40":174,"_148":25,"_38":175,"_13":150,"_33":34,"_35":36,"_24":25,"_151":176,"_27":177},{"_43":165,"_32":166,"_30":167,"_146":-5,"_41":42,"_40":168,"_148":25,"_38":169,"_13":150,"_33":34,"_35":36,"_24":25,"_151":-5,"_27":170},{"_43":159,"_32":160,"_30":161,"_146":-5,"_41":42,"_40":162,"_148":25,"_38":163,"_13":150,"_33":34,"_35":36,"_24":25,"_151":-5,"_27":164},{"_43":153,"_32":154,"_30":155,"_146":-5,"_41":42,"_40":156,"_148":25,"_38":157,"_13":150,"_33":34,"_35":36,"_24":25,"_151":-5,"_27":158},{"_43":143,"_32":144,"_30":145,"_146":-5,"_41":42,"_40":147,"_148":25,"_38":149,"_13":150,"_33":34,"_35":36,"_24":25,"_151":-5,"_27":152},"d085db8f-23f4-4a79-8ce8-d4b4d87ad718","utils.ts","7c7a4070-a4d9-11f1-90df-1607ee4eb77e","parentId",59,"latest",["D",1788138950181],1,"label",[144],"a9d8abe5-f717-4399-8dc6-28c5a71366a0","types.ts","760b7a24-a4d9-11f1-9139-1607ee4eb77e",55,["D",1788138936330],[154],"5a867b06-37e6-4225-93d8-d141dc4bb947","twitch.ts","9c5a8652-a4d9-11f1-b87e-1607ee4eb77e",69,["D",1788139007885],[160],"7a2109ac-4c11-47eb-b3cd-5500daf66f59","pages.ts","a605108c-a4d9-11f1-a673-1607ee4eb77e",71,["D",1788139017387],[166],"789be817-a4fd-423d-ab83-71b1dbd8a882","main.ts","6b349c48-a4d9-11f1-b9f9-1607ee4eb77e",53,["D",1788138928779],"guildscribe",[172],"f67860c4-61e9-46a5-a2be-39aa22781145","lookups.ts","8e4689c6-a4d9-11f1-8724-1607ee4eb77e",77,["D",1788139248824],2,"// D&D 5e API lookups and formatting\n\nimport { lookupResources } from \"./data.ts\";\nimport { compactText } from \"./utils.ts\";\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 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 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 return name;\n}\n",[179],"bbac15e1-0eb6-484b-a18f-30dd065a3066","http.ts","2c8257b6-a3c0-11f1-9d3e-1607ee4eb77e",51,["D",1788056960628],47,"http","import { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\r\n\r\n// ── D&D 5e 2014 rules baseline ──\r\ntype Ability = \"STR\" | \"DEX\" | \"CON\" | \"INT\" | \"WIS\" | \"CHA\";\r\ntype Race = { subraces: string[]; bonuses: Partial>; speed: number; traits: string[] };\r\ntype ClassData = { priority: Ability[]; savingThrows: Ability[]; hitDie: number; calling: string };\r\n\r\nconst races: Record = {\r\n Human: { subraces: [\"Standard\", \"Variant\"], bonuses: { STR: 1, DEX: 1, CON: 1, INT: 1, WIS: 1, CHA: 1 }, speed: 30, traits: [\"Extra Language\"] },\r\n Elf: { subraces: [\"High Elf\", \"Wood Elf\", \"Drow\"], bonuses: { DEX: 2 }, speed: 30, traits: [\"Darkvision\", \"Keen Senses\", \"Fey Ancestry\", \"Trance\"] },\r\n Dwarf: { subraces: [\"Hill Dwarf\", \"Mountain Dwarf\"], bonuses: { CON: 2 }, speed: 25, traits: [\"Darkvision\", \"Dwarven Resilience\", \"Dwarven Combat Training\"] },\r\n Halfling: { subraces: [\"Lightfoot\", \"Stout\"], bonuses: { DEX: 2 }, speed: 25, traits: [\"Lucky\", \"Brave\", \"Halfling Nimbleness\"] },\r\n Dragonborn: { subraces: [], bonuses: { STR: 2, CHA: 1 }, speed: 30, traits: [\"Draconic Ancestry\", \"Breath Weapon\", \"Damage Resistance\"] },\r\n Gnome: { subraces: [\"Forest Gnome\", \"Rock Gnome\"], bonuses: { INT: 2 }, speed: 25, traits: [\"Darkvision\", \"Gnome Cunning\"] },\r\n \"Half-Elf\": { subraces: [], bonuses: { CHA: 2 }, speed: 30, traits: [\"Darkvision\", \"Fey Ancestry\", \"Skill Versatility\"] },\r\n \"Half-Orc\": { subraces: [], bonuses: { STR: 2, CON: 1 }, speed: 30, traits: [\"Darkvision\", \"Relentless Endurance\", \"Savage Attacks\"] },\r\n Tiefling: { subraces: [\"Asmodeus\", \"Baalzebul\", \"Dispater\", \"Mammon\", \"Mephistopheles\"], bonuses: { INT: 1, CHA: 2 }, speed: 30, traits: [\"Darkvision\", \"Hellish Resistance\", \"Infernal Legacy\"] },\r\n};\r\nconst subraceBonuses: Record>> = {\r\n \"High Elf\": { INT: 1 }, \"Wood Elf\": { WIS: 1 }, Drow: { CHA: 1 }, \"Hill Dwarf\": { WIS: 1 }, \"Mountain Dwarf\": { STR: 2 },\r\n Lightfoot: { CHA: 1 }, Stout: { CON: 1 }, \"Forest Gnome\": { DEX: 1 }, \"Rock Gnome\": { CON: 1 },\r\n};\r\nconst classes: Record = {\r\n Barbarian: { priority: [\"STR\", \"CON\", \"DEX\", \"WIS\", \"CHA\", \"INT\"], savingThrows: [\"STR\", \"CON\"], hitDie: 12, calling: \"a fury-wreathed reaver\" },\r\n Fighter: { priority: [\"STR\", \"CON\", \"DEX\", \"WIS\", \"CHA\", \"INT\"], savingThrows: [\"STR\", \"CON\"], hitDie: 10, calling: \"a battle-tested champion\" },\r\n Paladin: { priority: [\"STR\", \"CHA\", \"CON\", \"WIS\", \"DEX\", \"INT\"], savingThrows: [\"WIS\", \"CHA\"], hitDie: 10, calling: \"a sworn guardian of a sacred oath\" },\r\n Ranger: { priority: [\"DEX\", \"WIS\", \"CON\", \"STR\", \"CHA\", \"INT\"], savingThrows: [\"STR\", \"DEX\"], hitDie: 10, calling: \"a tireless warden of the wild\" },\r\n Rogue: { priority: [\"DEX\", \"INT\", \"CON\", \"WIS\", \"CHA\", \"STR\"], savingThrows: [\"DEX\", \"INT\"], hitDie: 8, calling: \"a shadow-swift opportunist\" },\r\n Monk: { priority: [\"DEX\", \"WIS\", \"CON\", \"STR\", \"INT\", \"CHA\"], savingThrows: [\"STR\", \"DEX\"], hitDie: 8, calling: \"a disciplined master of body and spirit\" },\r\n Bard: { priority: [\"CHA\", \"DEX\", \"CON\", \"WIS\", \"INT\", \"STR\"], savingThrows: [\"DEX\", \"CHA\"], hitDie: 8, calling: \"a silver-tongued keeper of legends\" },\r\n Sorcerer: { priority: [\"CHA\", \"CON\", \"DEX\", \"WIS\", \"INT\", \"STR\"], savingThrows: [\"CON\", \"CHA\"], hitDie: 6, calling: \"a spellcaster born with dangerous power\" },\r\n Warlock: { priority: [\"CHA\", \"CON\", \"DEX\", \"WIS\", \"INT\", \"STR\"], savingThrows: [\"WIS\", \"CHA\"], hitDie: 8, calling: \"a pact-bound seeker of forbidden secrets\" },\r\n Cleric: { priority: [\"WIS\", \"STR\", \"CON\", \"CHA\", \"DEX\", \"INT\"], savingThrows: [\"WIS\", \"CHA\"], hitDie: 8, calling: \"a divine vessel carrying a god's will\" },\r\n Druid: { priority: [\"WIS\", \"CON\", \"DEX\", \"INT\", \"CHA\", \"STR\"], savingThrows: [\"INT\", \"WIS\"], hitDie: 8, calling: \"a shape-shifting voice of the wild\" },\r\n Wizard: { priority: [\"INT\", \"CON\", \"DEX\", \"WIS\", \"CHA\", \"STR\"], savingThrows: [\"INT\", \"WIS\"], hitDie: 6, calling: \"a scholar who bends reality through study\" },\r\n};\r\nconst abilityNames: Ability[] = [\"STR\", \"DEX\", \"CON\", \"INT\", \"WIS\", \"CHA\"];\r\nconst pick = (items: T[]): T => items[Math.floor(Math.random() * items.length)];\r\nconst modifier = (score: number) => Math.floor((score - 10) / 2);\r\nfunction rollStat() { const d = Array.from({ length: 4 }, () => 1 + Math.floor(Math.random() * 6)).sort((a, b) => b - a); return d[0] + d[1] + d[2]; }\r\nfunction formatRaceName(race: string, subrace: string | null) { if (!subrace) return race.trim(); const nr = race.trim().toLowerCase(); const ns = subrace.trim().toLowerCase(); return ns === nr || ns.endsWith(` ${nr}`) ? subrace.trim() : `${subrace.trim()} ${race.trim()}`; }\r\nfunction escapeHtml(value: string) { return value.replace(/[&<>'\"]/g, (c) => ({ \"&\": \"&\", \"<\": \"<\", \">\": \">\", \"'\": \"'\", '\"': \""\" }[c]!)); }\r\n\r\ntype Character = { username: string; race: string; subrace: string | null; cls: string; level: number; scores: Record; speed: number; hpMax: number; hpCurrent: number; proficiency: number; traits: string[]; spells: string[]; items: string[]; feats: string[]; abilities: string[] };\r\nfunction generateCharacter(username: string): Character {\r\n const race = pick(Object.keys(races)); const cls = pick(Object.keys(classes)); const raceData = races[race]; const classData = classes[cls];\r\n const subrace = raceData.subraces.length ? pick(raceData.subraces) : null; const scores = Array.from({ length: 6 }, rollStat).sort((a, b) => b - a); const abilityScores = {} as Record;\r\n classData.priority.forEach((ability, i) => abilityScores[ability] = scores[i]);\r\n const bonuses: Partial> = { ...raceData.bonuses, ...(subrace ? subraceBonuses[subrace] : {}) };\r\n if (race === \"Human\" && subrace === \"Variant\") { for (const a of abilityNames) delete bonuses[a]; bonuses[classData.priority[0]] = 1; bonuses[classData.priority[1]] = 1; }\r\n if (race === \"Half-Elf\") { const choices = classData.priority.filter((a) => a !== \"CHA\").slice(0, 2); bonuses[choices[0]] = 1; bonuses[choices[1]] = 1; }\r\n for (const a of abilityNames) abilityScores[a] = Math.min(20, abilityScores[a] + (bonuses[a] ?? 0));\r\n const hpMax = Math.max(1, classData.hitDie + modifier(abilityScores.CON));\r\n return { username, race, subrace, cls, level: 1, scores: abilityScores, speed: raceData.speed, hpMax, hpCurrent: hpMax, proficiency: 2, traits: raceData.traits, spells: [], items: [], feats: [], abilities: [] };\r\n}\r\nfunction formatStatLine(c: Character) { return `${abilityNames.map((a) => `${a} ${c.scores[a]}(${modifier(c.scores[a]) >= 0 ? \"+\" : \"\"}${modifier(c.scores[a])})`).join(\" \")} | HP ${c.hpCurrent}/${c.hpMax} | Speed ${c.speed}ft | Prof +${c.proficiency}`; }\r\n\r\nasync function ensureTables() {\r\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS characters (username TEXT PRIMARY KEY, race TEXT, subrace TEXT, class TEXT, level INTEGER, str INTEGER, dex INTEGER, con INTEGER, int INTEGER, wis INTEGER, cha INTEGER, speed INTEGER, hp_max INTEGER, hp_current INTEGER, proficiency INTEGER, traits TEXT)`);\r\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS character_backups (username TEXT PRIMARY KEY, race TEXT, subrace TEXT, class TEXT, level INTEGER, str INTEGER, dex INTEGER, con INTEGER, int INTEGER, wis INTEGER, cha INTEGER, speed INTEGER, hp_max INTEGER, hp_current INTEGER, proficiency INTEGER, traits TEXT)`);\r\n for (const table of [\"characters\", \"character_backups\"]) for (const column of [\"spells\", \"items\", \"feats\", \"abilities\"]) { try { await sqlite.execute(`ALTER TABLE ${table} ADD COLUMN ${column} TEXT DEFAULT '[]'`); } catch (_) {} }\r\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS oauth_states (state TEXT PRIMARY KEY, expires_at INTEGER)`);\r\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS broadcasters (broadcaster_id TEXT PRIMARY KEY, login TEXT, display_name TEXT, subscription_id TEXT, connected_at INTEGER)`);\r\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS welcomed_users (username TEXT PRIMARY KEY, welcomed_at INTEGER)`);\r\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS creation_sessions (username TEXT PRIMARY KEY, step TEXT, race TEXT, subrace TEXT, class TEXT, scores TEXT, updated_at INTEGER)`);\r\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS encounters (broadcaster_id TEXT PRIMARY KEY, round INTEGER, current_index INTEGER, active INTEGER, entries TEXT, updated_at INTEGER)`);\r\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS activity_logs (id INTEGER PRIMARY KEY AUTOINCREMENT, username TEXT, broadcaster_id TEXT, action TEXT, detail TEXT, created_at INTEGER)`);\r\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS channel_settings (broadcaster_id TEXT PRIMARY KEY, enabled INTEGER NOT NULL DEFAULT 1, updated_at INTEGER)`);\r\n}\r\nfunction rowToCharacter(r: any): Character { return { username: r.username, race: r.race, subrace: r.subrace, cls: r.class, level: r.level, scores: { STR: r.str, DEX: r.dex, CON: r.con, INT: r.int, WIS: r.wis, CHA: r.cha }, speed: r.speed, hpMax: r.hp_max, hpCurrent: r.hp_current, proficiency: r.proficiency, traits: JSON.parse(r.traits || \"[]\"), spells: JSON.parse(r.spells || \"[]\"), items: JSON.parse(r.items || \"[]\"), feats: JSON.parse(r.feats || \"[]\"), abilities: JSON.parse(r.abilities || \"[]\") }; }\r\nasync function getCharacter(username: string) { const res = await sqlite.execute(\"SELECT * FROM characters WHERE username = ?\", [username]); return res.rows.length ? rowToCharacter(res.rows[0]) : null; }\r\nasync function saveCharacter(c: Character) { await sqlite.execute(`INSERT OR REPLACE INTO characters (username,race,subrace,class,level,str,dex,con,int,wis,cha,speed,hp_max,hp_current,proficiency,traits,spells,items,feats,abilities) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)`, [c.username,c.race,c.subrace,c.cls,c.level,c.scores.STR,c.scores.DEX,c.scores.CON,c.scores.INT,c.scores.WIS,c.scores.CHA,c.speed,c.hpMax,c.hpCurrent,c.proficiency,JSON.stringify(c.traits),JSON.stringify(c.spells),JSON.stringify(c.items),JSON.stringify(c.feats),JSON.stringify(c.abilities)]); }\r\nasync function adjustHp(username: string, delta: number) { const c = await getCharacter(username); if (!c) return null; c.hpCurrent = Math.max(0, Math.min(c.hpMax, c.hpCurrent + delta)); await sqlite.execute(\"UPDATE characters SET hp_current = ? WHERE username = ?\", [c.hpCurrent, username]); return c; }\r\nasync function backupCharacter(username: string) { const c = await getCharacter(username); if (!c) return false; await sqlite.execute(`INSERT OR REPLACE INTO character_backups (username,race,subrace,class,level,str,dex,con,int,wis,cha,speed,hp_max,hp_current,proficiency,traits,spells,items,feats,abilities) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)`, [c.username,c.race,c.subrace,c.cls,c.level,c.scores.STR,c.scores.DEX,c.scores.CON,c.scores.INT,c.scores.WIS,c.scores.CHA,c.speed,c.hpMax,c.hpCurrent,c.proficiency,JSON.stringify(c.traits),JSON.stringify(c.spells),JSON.stringify(c.items),JSON.stringify(c.feats),JSON.stringify(c.abilities)]); return true; }\r\nasync function loadBackup(username: string) { const res = await sqlite.execute(\"SELECT * FROM character_backups WHERE username = ?\", [username]); if (!res.rows.length) return null; const c = rowToCharacter(res.rows[0]); await saveCharacter(c); return c; }\r\nasync function resetCharacter(username: string) { await sqlite.execute(\"DELETE FROM characters WHERE username = ?\", [username]); }\r\nasync function sendWelcomeMessage(display: string, broadcasterId: string) { await sendChatMessage(`@${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.`, broadcasterId); }\r\nasync function sendIntroductionIfNeeded(username: string, display: string, broadcasterId: string) { const existing = await sqlite.execute(\"SELECT username FROM welcomed_users WHERE username = ?\", [username]); if (existing.rows.length) return; await sqlite.execute(\"INSERT OR IGNORE INTO welcomed_users (username, welcomed_at) VALUES (?, ?)\", [username, Date.now()]); await sendWelcomeMessage(display, broadcasterId); }\r\nasync function getCreationSession(username: string) { const res = await sqlite.execute(\"SELECT * FROM creation_sessions WHERE username = ?\", [username]); if (!res.rows.length) return null; const r = res.rows[0]; return { username, step: r.step, race: r.race, subrace: r.subrace, cls: r.class, scores: r.scores ? JSON.parse(r.scores) : null }; }\r\nasync function saveCreationSession(s: any) { await sqlite.execute(\"INSERT OR REPLACE INTO creation_sessions (username,step,race,subrace,class,scores,updated_at) VALUES (?,?,?,?,?,?,?)\", [s.username,s.step,s.race ?? null,s.subrace ?? null,s.cls ?? null,s.scores ? JSON.stringify(s.scores) : null,Date.now()]); }\r\nasync function clearCreationSession(username: string) { await sqlite.execute(\"DELETE FROM creation_sessions WHERE username = ?\", [username]); }\r\nasync function getConnections() { const res = await sqlite.execute(\"SELECT display_name, login FROM broadcasters ORDER BY connected_at ASC\"); return res.rows.map((r: any) => r.display_name || r.login); }\r\nasync function isChannelEnabled(broadcasterId: string) { const res = await sqlite.execute(\"SELECT enabled FROM channel_settings WHERE broadcaster_id = ?\", [broadcasterId]); return !res.rows.length || Number(res.rows[0].enabled) === 1; }\r\nasync function setChannelEnabled(broadcasterId: string, enabled: boolean) { await sqlite.execute(\"INSERT OR REPLACE INTO channel_settings (broadcaster_id, enabled, updated_at) VALUES (?,?,?)\", [broadcasterId, enabled ? 1 : 0, Date.now()]); }\r\nconst knownBotAccounts = new Set([\"nightbot\", \"streamelements\", \"streamlabs\", \"moobot\", \"fossabot\", \"wizebot\", \"deepbot\", \"coebot\", \"ankhbot\"]);\r\nfunction isBotAccount(username: string, userId: string) { const normalized = username.toLowerCase(); const configured = (Deno.env.get(\"BOT_USERNAMES\") ?? \"\").split(\",\").map((x) => x.trim().toLowerCase()).filter(Boolean); return userId === env(\"TWITCH_BOT_ID\") || knownBotAccounts.has(normalized) || configured.includes(normalized) || normalized.endsWith(\"bot\"); }\r\nfunction hasModeratorBadge(event: any) { const badges = [...(event?.badges ?? []), ...(event?.source_badges ?? [])]; return badges.some((badge: any) => badge.set_id === \"moderator\" || badge.set_id === \"broadcaster\"); }\r\nasync function recordActivity(username: string, broadcasterId: string, action: string, detail: string) { await sqlite.execute(\"INSERT INTO activity_logs (username,broadcaster_id,action,detail,created_at) VALUES (?,?,?,?,?)\", [username, broadcasterId, action.slice(0,40), detail.replace(/\\s+/g, \" \").trim().slice(0,220), Date.now()]); await sqlite.execute(\"DELETE FROM activity_logs WHERE id NOT IN (SELECT id FROM activity_logs ORDER BY id DESC LIMIT 5000)\"); }\r\nasync function getRecentLogs(broadcasterId?: string, limit = 200) { const safeLimit = Math.max(1, Math.min(500, Math.floor(limit))); const query = broadcasterId ? `SELECT username,broadcaster_id,action,detail,created_at FROM activity_logs WHERE broadcaster_id = ? ORDER BY id DESC LIMIT ${safeLimit}` : `SELECT username,broadcaster_id,action,detail,created_at FROM activity_logs ORDER BY id DESC LIMIT ${safeLimit}`; const res = await sqlite.execute(query, broadcasterId ? [broadcasterId] : []); return res.rows; }\r\nfunction logRowText(r: any) { return `${new Date(Number(r.created_at)).toISOString()} | @${r.username} | ${r.action} | ${r.detail}`; }\r\nfunction renderLogsPage(rows: any[]) { const lines = rows.map((r: any) => `${escapeHtml(new Date(Number(r.created_at)).toLocaleString())}${escapeHtml(r.username || \"unknown\")}${escapeHtml(r.broadcaster_id || \"\")}${escapeHtml(r.action || \"\")}${escapeHtml(r.detail || \"\")}`).join(\"\"); 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.

`; }\r\nasync function getEncounter(broadcasterId: string) { const res = await sqlite.execute(\"SELECT * FROM encounters WHERE broadcaster_id = ?\", [broadcasterId]); if (!res.rows.length) return null; const r = res.rows[0]; return { broadcasterId, round: Number(r.round), currentIndex: Number(r.current_index), active: Boolean(r.active), entries: JSON.parse(r.entries || \"[]\") as Array<{ name: string; initiative: number }> }; }\r\nasync function saveEncounter(e: any) { await sqlite.execute(\"INSERT OR REPLACE INTO encounters (broadcaster_id,round,current_index,active,entries,updated_at) VALUES (?,?,?,?,?,?)\", [e.broadcasterId,e.round,e.currentIndex,e.active ? 1 : 0,JSON.stringify(e.entries),Date.now()]); }\r\nfunction encounterText(e: any) { const order = e.entries.map((x: any, i: number) => `${i === e.currentIndex && e.active ? \"▶\" : \"•\"} ${x.name} ${x.initiative}`).join(\" | \"); return `Initiative R${e.round}: ${order || \"no combatants\"}`; }\r\nasync function handleInitiativeCommand(chatMessage: string, broadcasterId: string, display: string, isModerator: boolean) { if (!chatMessage.toLowerCase().startsWith(\"!turn\")) return false; if (!isModerator) { await sendChatMessage(`@${display} only the broadcaster or a moderator can manage initiative.`, broadcasterId); return true; } const parts = chatMessage.trim().split(/\\s+/); const action = (parts[1] ?? \"show\").toLowerCase(); let e = await getEncounter(broadcasterId); if (action === \"start\") { e = { broadcasterId, round: 1, currentIndex: 0, active: true, entries: [] }; await saveEncounter(e); await sendChatMessage(`@${display} combat started. Add combatants with !turn add .`, broadcasterId); return true; } if (action === \"end\" || action === \"clear\") { if (e) await sqlite.execute(\"DELETE FROM encounters WHERE broadcaster_id = ?\", [broadcasterId]); await sendChatMessage(`@${display} combat ended and initiative cleared.`, broadcasterId); return true; } if (!e || !e.active) { await sendChatMessage(`@${display} no active encounter. Start one with !turn start.`, broadcasterId); return true; } if (action === \"add\") { const match = chatMessage.match(/^!turn\\s+add\\s+(.+?)\\s+(\\d+)$/i); const initiative = match ? Number(match[2]) : NaN; if (!match || !Number.isInteger(initiative) || initiative < 0 || initiative > 50) { await sendChatMessage(`@${display} use !turn add , such as !turn add Goblin 15.`, broadcasterId); return true; } const name = match[1].replace(/^@/, \"\").trim(); const existing = e.entries.find((x: any) => x.name.toLowerCase() === name.toLowerCase()); if (existing) existing.initiative = initiative; else e.entries.push({ name, initiative }); e.entries.sort((a: any, b: any) => b.initiative - a.initiative); e.currentIndex = 0; await saveEncounter(e); await sendChatMessages(`@${display} ${encounterText(e)}`, broadcasterId); return true; } if (action === \"remove\") { const name = parts.slice(2).join(\" \").replace(/^@/, \"\"); e.entries = e.entries.filter((x: any) => x.name.toLowerCase() !== name.toLowerCase()); e.currentIndex = Math.min(e.currentIndex, Math.max(0, e.entries.length - 1)); await saveEncounter(e); await sendChatMessages(`@${display} ${encounterText(e)}`, broadcasterId); return true; } if (action === \"next\" || action === \"prev\") { if (!e.entries.length) { await sendChatMessage(`@${display} add combatants first with !turn add .`, broadcasterId); return true; } const step = action === \"next\" ? 1 : -1; const nextIndex = e.currentIndex + step; if (nextIndex >= e.entries.length) { e.currentIndex = 0; e.round += 1; } else if (nextIndex < 0) { e.currentIndex = e.entries.length - 1; e.round = Math.max(1, e.round - 1); } else e.currentIndex = nextIndex; await saveEncounter(e); await sendChatMessages(`@${display} ${encounterText(e)}`, broadcasterId); return true; } if (action === \"show\" || action === \"list\") { await sendChatMessages(`@${display} ${encounterText(e)}`, broadcasterId); return true; } await sendChatMessage(`@${display} Initiative: !turn start | !turn add | !turn show | !turn next | !turn prev | !turn remove | !turn end`, broadcasterId); return true; }\r\nfunction customCharacterFromSession(s: any): Character { const raceData = races[s.race]; const bonuses: Partial> = { ...raceData.bonuses, ...(s.subrace ? subraceBonuses[s.subrace] ?? {} : {}) }; const scores = {} as Record; const rolled = s.scores as number[]; classes[s.cls].priority.forEach((a: Ability, i: number) => scores[a] = Math.min(20, rolled[i] + (bonuses[a] ?? 0))); const hp = Math.max(1, classes[s.cls].hitDie + modifier(scores.CON)); return { username: s.username, race: s.race, subrace: s.subrace || null, cls: s.cls, level: 1, scores, speed: raceData.speed, hpMax: hp, hpCurrent: hp, proficiency: 2, traits: raceData.traits, spells: [], items: [], feats: [], abilities: [] }; }\r\nasync function handleCreationCommand(username: string, display: string, broadcasterId: string, chatMessage: string) { if (chatMessage === \"!newchar\") { await saveCreationSession({ username, step: \"race\" }); await sendChatMessage(`@${display} New character started. Choose a race: ${Object.keys(races).join(\", \")}. Reply !answer . Type !cancel to stop.`, broadcasterId); return true; } if (chatMessage === \"!cancel\") { const active = await getCreationSession(username); if (!active) return false; await clearCreationSession(username); await sendChatMessage(`@${display} Character creation cancelled.`, broadcasterId); return true; } if (!chatMessage.startsWith(\"!answer \")) return false; const s = await getCreationSession(username); if (!s) return false; const answer = chatMessage.slice(8).trim(); if (s.step === \"race\") { const race = Object.keys(races).find((x) => x.toLowerCase() === answer.toLowerCase()); if (!race) { await sendChatMessage(`@${display} Choose a race from: ${Object.keys(races).join(\", \")}.`, broadcasterId); return true; } s.race = race; if (races[race].subraces.length) { s.step = \"subrace\"; await saveCreationSession(s); await sendChatMessage(`@${display} Choose a ${race} subrace: ${races[race].subraces.join(\", \")}. Reply !answer .`, broadcasterId); } else { s.step = \"class\"; await saveCreationSession(s); await sendChatMessage(`@${display} Choose a class: ${Object.keys(classes).join(\", \")}. Reply !answer .`, broadcasterId); } return true; } if (s.step === \"subrace\") { const subrace = races[s.race].subraces.find((x) => x.toLowerCase() === answer.toLowerCase()); if (!subrace) { await sendChatMessage(`@${display} Choose a subrace from: ${races[s.race].subraces.join(\", \")}.`, broadcasterId); return true; } s.subrace = subrace; s.step = \"class\"; await saveCreationSession(s); await sendChatMessage(`@${display} Choose a class: ${Object.keys(classes).join(\", \")}. Reply !answer .`, broadcasterId); return true; } if (s.step === \"class\") { const cls = Object.keys(classes).find((x) => x.toLowerCase() === answer.toLowerCase()); if (!cls) { await sendChatMessage(`@${display} Choose a class from: ${Object.keys(classes).join(\", \")}.`, broadcasterId); return true; } s.cls = cls; s.step = \"scores\"; await saveCreationSession(s); await sendChatMessage(`@${display} Enter 6 scores in order of importance, or use standard: !answer 15 14 13 12 10 8. ${cls} priority: ${classes[cls].priority.join(\", \")}.`, broadcasterId); return true; } if (s.step === \"scores\") { const scores = answer.toLowerCase() === \"standard\" ? [15,14,13,12,10,8] : answer.split(/[ ,]+/).map(Number); if (scores.length !== 6 || scores.some((n: number) => !Number.isInteger(n) || n < 3 || n > 18)) { await sendChatMessage(`@${display} Enter exactly 6 whole-number scores from 3 to 18, such as !answer 15 14 13 12 10 8.`, broadcasterId); return true; } s.scores = scores; s.step = \"confirm\"; await saveCreationSession(s); const preview = customCharacterFromSession(s); await sendChatMessage(`@${display} Confirm: level 1 ${formatRaceName(preview.race,preview.subrace)} ${preview.cls}, ${formatStatLine(preview)}. Reply !answer yes to save or !answer no to restart.`, broadcasterId); return true; } if (s.step === \"confirm\") { if (answer.toLowerCase() === \"yes\") { const c = customCharacterFromSession(s); await saveCharacter(c); await clearCreationSession(username); await sendChatMessage(`@${display} Character saved! Use !char, !levelup, !savechar, and !loadchar.`, broadcasterId); } else if (answer.toLowerCase() === \"no\") { await clearCreationSession(username); await sendChatMessage(`@${display} Character discarded. Start again with !newchar.`, broadcasterId); } else await sendChatMessage(`@${display} Reply !answer yes to save or !answer no to discard.`, broadcasterId); return true; } return false; }\r\nfunction rollDice(input = \"1d20\") { const expression = input.trim() || \"1d20\"; const m = expression.match(/^(\\d+)d(\\d+)([+-]\\d+)?$/i); if (!m) return null; const n = +m[1], sides = +m[2], mod = m[3] ? +m[3] : 0; if (n > 100 || sides > 1000) return null; const rolls = Array.from({ length: n }, () => 1 + Math.floor(Math.random() * sides)); const rawTotal = rolls.reduce((a, b) => a + b, 0); const total = rawTotal + mod; const label = expression.toLowerCase() === \"1d20\" ? \"D20 of Fate\" : \"Dice roll\"; const rawD20 = n === 1 && sides === 20 ? rolls[0] : null; const puns = rawD20 === 20 ? [\"Natural 20! The bards are already writing the song.\", \"Critical success! Even the dice wanted to be legendary.\", \"The gods have stamped this roll approved.\", \"A natural 20—today, the dungeon fears you.\", \"Fate has opened the treasure chest of victory.\"] : rawD20 === 1 ? [\"Natural 1! The floor wins this round.\", \"Critical fumble! Somewhere, a goblin just gained confidence.\", \"The dice have requested a short rest.\", \"A natural 1—excellent roleplay opportunity incoming.\", \"Fate rolled a banana peel under your boots.\"] : total >= 17 ? [\"That roll arrived wearing a hero’s cape.\", \"The adventure is leaning dramatically in your favor.\", \"Even the dungeon master raised an eyebrow at that one.\", \"A mighty swing of the fate hammer.\", \"The prophecy is looking unusually promising.\"] : total <= 4 ? [\"That roll took a wrong turn at the tavern.\", \"The dungeon master is trying very hard not to smile.\", \"Fate has assigned you a side quest.\", \"The dice are demanding better snacks.\", \"That result has strong mimic-energy.\"] : [\"Fate has spoken—no rerolling destiny.\", \"The dungeon master may now pretend this was planned.\", \"That roll wandered in from a side quest.\", \"Somewhere, a bard is composing a song about this.\", \"Your modifiers are doing the heavy lifting.\", \"The goblins are taking notes.\", \"The prophecy remains open.\", \"Fate rolled over and asked for advantage.\", \"The initiative order has noticed you.\", \"A perfectly serviceable bit of adventuring.\", \"The dice have offered a plot twist.\", \"The tavern is buying the next round.\"]; const pun = puns[Math.floor(Math.random() * puns.length)]; return `🎲 ${label}: ${expression} → [${rolls.join(\", \")}]${mod ? (mod > 0 ? `+${mod}` : mod) : \"\"} = ${total}. ${pun}`; }\r\nasync function adjustLevel(username: string, delta: number) { const c = await getCharacter(username); if (!c) return { error: \"no character\" as const }; if (!Number.isInteger(delta) || delta === 0) return { error: \"invalid amount\" as const }; const oldLevel = c.level; const newLevel = Math.max(1, Math.min(20, oldLevel + delta)); if (newLevel === oldLevel) return { error: delta > 0 ? \"max level\" as const : \"min level\" as const }; const classData = classes[c.cls]; const perLevelHp = Math.max(1, Math.floor(classData.hitDie / 2) + 1 + modifier(c.scores.CON)); const baseHp = Math.max(1, classData.hitDie + modifier(c.scores.CON)); const oldHpMax = c.hpMax; c.level = newLevel; c.hpMax = baseHp + (newLevel - 1) * perLevelHp; c.hpCurrent = Math.max(0, Math.min(c.hpMax, c.hpCurrent + (c.hpMax - oldHpMax))); c.proficiency = Math.floor((newLevel - 1) / 4) + 2; await saveCharacter(c); const asi = [4, 8, 12, 16, 19].includes(newLevel) ? \" Ability Score Improvement/feat available.\" : \"\"; return { c, oldLevel, delta: newLevel - oldLevel, hpGain: c.hpMax - oldHpMax, asi }; }\r\n\r\nconst lookupResources: Record = { spell: \"spells\", item: \"equipment\", class: \"classes\", feat: \"feats\", ability: \"ability-scores\", race: \"races\", subrace: \"subraces\" };\r\nfunction compactText(value: unknown, max = 240) { return String(value ?? \"\").replace(/\\s+/g, \" \").replace(/<[^>]+>/g, \"\").trim().slice(0, max); }\r\nasync function lookup5e(kind: string, query: string): Promise { const resource = lookupResources[kind]; if (!resource || !query || query.length > 60) return null; const abilityAliases: Record = { strength: \"str\", dexterity: \"dex\", constitution: \"con\", intelligence: \"int\", wisdom: \"wis\", charisma: \"cha\" }; const lookupQuery = kind === \"ability\" ? (abilityAliases[query.toLowerCase().trim()] ?? query) : query; const normalized = lookupQuery.toLowerCase().trim().replace(/[^a-z0-9]+/g, \" \").replace(/\\s+/g, \" \"); const slug = normalized.replace(/ /g, \"-\"); const base = `https://www.dnd5eapi.co/api/2014/${resource}`; for (const candidate of [slug, normalized.replace(/ /g, \"-\")]) { const direct = await fetch(`${base}/${encodeURIComponent(candidate)}`); if (direct.ok) return await direct.json(); } const res = await fetch(base); if (!res.ok) return null; const list = (await res.json()).results ?? []; const comparable = (value: string) => value.toLowerCase().replace(/[^a-z0-9]/g, \"\"); const wanted = comparable(lookupQuery); const found = list.find((x: any) => comparable(x.name) === wanted) ?? list.find((x: any) => comparable(x.name).includes(wanted) || wanted.includes(comparable(x.name))); if (!found) return null; const detail = await fetch(`https://www.dnd5eapi.co${found.url}`); return detail.ok ? await detail.json() : null; }\r\nfunction formatSpellSections(data: any, bonus: number | null = null) { const upcast = bonus && bonus > 0 ? bonus : 0; const baseSlot = data.level + upcast; const slotDamage = data.damage?.damage_at_slot_level?.[String(baseSlot)]; const damage = data.damage ? `${data.damage.damage_type?.name ?? \"Damage\"} ${slotDamage ? `at slot ${baseSlot}: ${slotDamage}` : Object.entries(data.damage.damage_at_slot_level ?? {}).map(([level, dice]) => `L${level}:${dice}`).join(\"/\")}` : \"no direct damage\"; const dc = data.dc ? `${data.dc.dc_type?.name ?? \"save\"} save (${data.dc.dc_success ?? \"normal\"})` : \"no save\"; const area = data.area_of_effect ? `${data.area_of_effect.size}-ft ${data.area_of_effect.type}` : \"not listed\"; const components = (data.components ?? []).join(\"\") || \"none\"; const material = data.material ? `; material: ${compactText(data.material, 80)}` : \"\"; const classes = compactText((data.classes ?? []).map((x: any) => x.name).join(\", \"), 100) || \"none listed\"; const higher = data.higher_level?.length ? compactText(data.higher_level[0], 180) : \"none\"; return [`${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)\" : \"\"}`, `Components: ${components}${material} | Damage: ${damage} | Save: ${dc} | Area: ${area}`, `Classes: ${classes} | Higher levels: ${higher}`]; }\r\nfunction formatLookup(kind: string, data: any, bonus: number | null = null) { const name = data.name; const bonusText = bonus !== null ? `modifier +${bonus}; ` : \"\"; if (kind === \"item\") { const damage = data.damage ? `${data.damage.damage_dice ?? \"?\"} ${data.damage.damage_type?.name ?? \"damage\"}` : \"no weapon damage\"; const range = data.range?.normal != null ? (data.range.long != null ? `${data.range.normal}-${data.range.long} ft` : `${data.range.normal} ft`) : \"melee\"; const props = compactText((data.properties ?? []).map((x: any) => x.name).join(\", \"), 90); const ac = data.armor_category ? `AC ${data.armor_class?.base ?? \"?\"}${data.armor_class?.dex_bonus ? \"+ Dex\" : \"\"}` : \"\"; const itemParts = [`${bonusText}${bonus !== null ? `attack/damage +${bonus}` : \"\"}`, damage, `range ${range}`, ac, `weight ${data.weight ?? \"?\"} lb`, `cost ${data.cost?.quantity ?? \"?\"} ${data.cost?.unit ?? \"gp\"}`, `properties ${props || \"none\"}`].filter((part) => part.trim()); return `${name}: ${itemParts.join(\"; \")}`; } if (kind === \"class\") { const saves = (data.saving_throws ?? []).map((x: any) => x.name).join(\", \") || \"none listed\"; const profs = compactText((data.proficiencies ?? []).map((x: any) => x.name).join(\", \"), 140); return `${name}: ${bonusText}Hit Die d${data.hit_die}; saves ${saves}; proficiencies ${profs || \"none listed\"}`; } if (kind === \"feat\") { const prereq = (data.prerequisites ?? []).map((x: any) => `${x.ability_score?.name ?? \"ability\"} ${x.minimum_score ?? \"?\"}`).join(\", \") || \"none listed\"; return `${name}: ${bonusText}prerequisite ${prereq}; ${compactText((data.desc ?? []).join(\" \"), 220)}`; } if (kind === \"ability\") { const skills = compactText((data.skills ?? []).map((x: any) => x.name).join(\", \"), 100); return `${name}: ${bonusText}score ${data.full_name ?? name}; skills ${skills || \"none listed\"}; ${compactText((data.desc ?? []).join(\" \"), 180)}`; } if (kind === \"race\" || kind === \"subrace\") { const bonuses = (data.ability_bonuses ?? []).map((b: any) => `${b.ability_score?.name ?? b.ability_score?.index?.toUpperCase() ?? \"ability\"} +${b.bonus}`).join(\", \") || \"none listed\"; const traits = compactText((data.traits ?? data.racial_traits ?? []).map((x: any) => x.name).join(\", \")); const languages = compactText((data.languages ?? []).map((x: any) => x.name).join(\", \"), 80); const parent = data.race?.name ? `; parent race ${data.race.name}` : \"\"; return `${name}: ${bonusText}bonuses ${bonuses}; speed ${data.speed ?? \"?\"} ft; size ${data.size ?? \"?\"}${parent}; languages ${languages || \"not listed\"}; traits ${traits || \"none listed\"}`; } return name; }\r\n\r\nconst env = (name: string) => { const value = Deno.env.get(name); if (!value) throw new Error(`Missing environment variable: ${name}`); return value; };\r\nasync function sendChatMessage(text: string, broadcasterId: string) { const res = await fetch(\"https://api.twitch.tv/helix/chat/messages\", { method: \"POST\", headers: { Authorization: `Bearer ${await getAppToken()}`, \"Client-Id\": env(\"TWITCH_CLIENT_ID\"), \"Content-Type\": \"application/json\" }, body: JSON.stringify({ broadcaster_id: broadcasterId, sender_id: env(\"TWITCH_BOT_ID\"), message: text, for_source_only: true }) }); console.log(`Send message response: ${res.status} ${await res.text()}`); }\r\nconst MAX_LOOKUP_MESSAGE_LENGTH = 300;\r\nfunction splitChatMessage(text: string, max = MAX_LOOKUP_MESSAGE_LENGTH) { const parts: string[] = []; let remaining = text.trim(); while (remaining.length > max) { let cut = remaining.lastIndexOf(\" \", max); if (cut < 1) cut = max; parts.push(remaining.slice(0, cut).trim()); remaining = remaining.slice(cut).trim(); } if (remaining) parts.push(remaining); return parts; }\r\nasync function sendChatMessages(text: string, broadcasterId: string) { const parts = splitChatMessage(text); for (const part of parts) { if (part.length > MAX_LOOKUP_MESSAGE_LENGTH) throw new Error(\"Chat message splitter produced an oversized message\"); await sendChatMessage(part, broadcasterId); } }\r\nasync function sendSpellSections(sections: string[], display: string, broadcasterId: string) { for (const section of sections) { const parts = splitChatMessage(`@${display} ${section}`); for (const part of parts) { if (part.length > MAX_LOOKUP_MESSAGE_LENGTH) throw new Error(\"Spell section exceeded safe chat length\"); await sendChatMessage(part, broadcasterId); } } }\r\nasync function getAppToken() { const body = new URLSearchParams({ client_id: env(\"TWITCH_CLIENT_ID\"), client_secret: env(\"TWITCH_CLIENT_SECRET\"), grant_type: \"client_credentials\" }); const res = await fetch(\"https://id.twitch.tv/oauth2/token\", { method: \"POST\", headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" }, body }); if (!res.ok) throw new Error(`App token failed: ${res.status} ${await res.text()}`); return (await res.json()).access_token as string; }\r\nasync function exchangeCode(code: string, redirectUri: string) { const body = new URLSearchParams({ client_id: env(\"TWITCH_CLIENT_ID\"), client_secret: env(\"TWITCH_CLIENT_SECRET\"), code, grant_type: \"authorization_code\", redirect_uri: redirectUri }); const res = await fetch(\"https://id.twitch.tv/oauth2/token\", { method: \"POST\", headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" }, body }); if (!res.ok) throw new Error(`OAuth exchange failed: ${res.status} ${await res.text()}`); return await res.json(); }\r\nasync function createChatSubscription(broadcasterId: string, callbackUrl: string) { const appToken = await getAppToken(); const res = await fetch(\"https://api.twitch.tv/helix/eventsub/subscriptions\", { method: \"POST\", headers: { Authorization: `Bearer ${appToken}`, \"Client-Id\": env(\"TWITCH_CLIENT_ID\"), \"Content-Type\": \"application/json\" }, body: JSON.stringify({ type: \"channel.chat.message\", version: \"1\", condition: { broadcaster_user_id: broadcasterId, user_id: env(\"TWITCH_BOT_ID\") }, transport: { method: \"webhook\", callback: callbackUrl, secret: env(\"EVENTSUB_SECRET\") } }) }); const text = await res.text(); if (!res.ok) throw new Error(`EventSub subscription failed: ${res.status} ${text}`); return JSON.parse(text).data[0]; }\r\n\r\nasync function verifyEventSub(req: Request, rawBody: string) { const id = req.headers.get(\"Twitch-Eventsub-Message-Id\") ?? \"\"; const timestamp = req.headers.get(\"Twitch-Eventsub-Message-Timestamp\") ?? \"\"; const received = req.headers.get(\"Twitch-Eventsub-Message-Signature\") ?? \"\"; const key = await crypto.subtle.importKey(\"raw\", new TextEncoder().encode(env(\"EVENTSUB_SECRET\")), { name: \"HMAC\", hash: \"SHA-256\" }, false, [\"sign\"]); const signature = new Uint8Array(await crypto.subtle.sign(\"HMAC\", key, new TextEncoder().encode(id + timestamp + rawBody))); const hex = [...signature].map((b) => b.toString(16).padStart(2, \"0\")).join(\"\"); const expected = `sha256=${hex}`; return received.length === expected.length && [...expected].every((c, i) => c === received[i]); }\r\nfunction renderCharacterPage(c: Character) { const statLine = abilityNames.map((a) => `

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

`).join(\"\"); 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(\", \")}

`; }\r\nfunction page(title: string, body: string) { return new Response(`${title}${body}`, { headers: { \"Content-Type\": \"text/html; charset=utf-8\" } }); }\r\nfunction renderGuidePage() { 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.

!char

Display your current character summary.

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.

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.

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.

`; }\r\n\r\nexport default async function (req: Request): Promise {\r\n await ensureTables(); const url = new URL(req.url); const path = url.pathname;\r\n if (req.method === \"GET\" && (path === \"/logs\" || path === \"/activity\")) return page(\"GuildScribe Activity Logs\", renderLogsPage(await getRecentLogs()));\r\n if (req.method === \"GET\" && (path === \"/guide\" || path === \"/commands\")) return page(\"GuildScribe Bot Guide\", `

GuildScribe Bot Guide

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

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

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

Connection cancelled

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

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

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.

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

Connection failed

${escapeHtml(String(e))}

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

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

`); } const c = await getCharacter(username); if (!c) return new Response(\"No character found for that user.\", { status: 404 }); return new Response(renderCharacterPage(c), { headers: { \"Content-Type\": \"text/html; charset=utf-8\" } }); }\r\n if (req.method !== \"POST\") return new Response(\"OK\");\r\n const rawBody = await req.text(); if (!(await verifyEventSub(req, rawBody))) return new Response(\"Invalid signature\", { status: 403 }); const messageType = req.headers.get(\"Twitch-Eventsub-Message-Type\"); const body = JSON.parse(rawBody);\r\n if (messageType === \"webhook_callback_verification\") return new Response(body.challenge, { headers: { \"Content-Type\": \"text/plain\" } });\r\n if (messageType === \"notification\") { const chatMessage: string = body.event?.message?.text ?? \"\"; const chatter: string = body.event?.chatter_user_login ?? \"\"; const display: string = body.event?.chatter_user_name ?? chatter; const chatterId: string = body.event?.chatter_user_id ?? \"\"; const moderatorId: string = body.event?.moderator_user_id ?? \"\"; const eventBroadcasterId: string = body.event?.broadcaster_user_id ?? \"\"; const broadcasterId: string = body.event?.source_broadcaster_user_id ?? eventBroadcasterId; const isModerator = chatterId === broadcasterId || chatterId === eventBroadcasterId || chatterId === moderatorId || hasModeratorBadge(body.event); const baseUrl = url.origin; console.log(`[${broadcasterId}] ${chatter} said: ${chatMessage}`); if (isBotAccount(chatter, chatterId)) return new Response(\"OK\"); const botToggle = chatMessage.trim().match(/^!dndbot\\s+(on|off|status)$/i); if (botToggle) { if (!isModerator) await sendChatMessage(`@${display} only the broadcaster or a moderator can change the bot setting.`, broadcasterId); else if (botToggle[1].toLowerCase() === \"status\") await sendChatMessage(`@${display} GuildScribe is currently ${(await isChannelEnabled(broadcasterId)) ? \"on\" : \"off\"} in this channel.`, broadcasterId); else { const enabled = botToggle[1].toLowerCase() === \"on\"; await setChannelEnabled(broadcasterId, enabled); await sendChatMessage(`@${display} GuildScribe is now ${enabled ? \"on\" : \"off\"} in this channel.`, broadcasterId); } return new Response(\"OK\"); } if (!(await isChannelEnabled(broadcasterId))) return new Response(\"OK\"); if (chatMessage.startsWith(\"!\")) await recordActivity(chatter, broadcasterId, chatMessage.split(/\\s+/)[0].toLowerCase(), chatMessage); if (await handleCreationCommand(chatter, display, broadcasterId, chatMessage)) return new Response(\"OK\"); if (await handleInitiativeCommand(chatMessage, broadcasterId, display, isModerator)) return new Response(\"OK\");\r\n if (chatMessage === \"!logs\") { if (!isModerator) await sendChatMessage(`@${display} only the broadcaster or a moderator can use !logs.`, broadcasterId); else { const logs = await getRecentLogs(broadcasterId, 8); await sendChatMessages(logs.length ? `@${display} Recent activity: ${logs.reverse().map(logRowText).join(\" || \")}` : `@${display} no activity has been logged yet.`, broadcasterId); } }\r\n else if (chatMessage === \"!connections\") { if (!isModerator) await sendChatMessage(`@${display} only the broadcaster or a moderator can use !connections.`, broadcasterId); else { const names = await getConnections(); await sendChatMessages(`@${display} Connected channels (${names.length}): ${names.length ? names.join(\", \") : \"none\"}`, broadcasterId); } }\r\n else if (chatMessage === \"!help\") { await sendWelcomeMessage(display, broadcasterId); }\r\n else if (chatMessage === \"!link\") { await sendChatMessage(`@${display} GuildScribe Bot Guide https://bit.ly/4iClxxC`, broadcasterId); }\r\n else if (/^!dndbothelp(?:\\s+\\w+)?$/i.test(chatMessage)) { const category = chatMessage.split(/\\s+/)[1]?.toLowerCase(); const help = category === \"dice\" ? \"Dice: !roll | !r | !d20 (D20 of Fate) | !roll NdS[+/-M]\" : category === \"settings\" ? \"Settings (mod): !dndbot on | !dndbot off | !dndbot status\" : category === \"character\" ? \"Character: !newchar | !answer | !cancel | !createchar | !char | !levelup [+/-levels] | !hp [+/-amount] | !savechar | !loadchar | !resetchar\" : category === \"combat\" ? \"Combat: !turn start | !turn add | !turn show | !turn next | !turn prev | !turn remove | !turn end\" : category === \"lookup\" ? \"Lookups: !spell [spell] [+N] | !item [item] [+N] | !class [class] [+N] | !feat [feat] [+N] | !ability [ability] [+N] | !race [race] [+N] | !subrace [subrace] [+N]\" : `Categories: dice | character | combat | lookup | settings. Expand one with !dndbothelp .`; await sendChatMessages(`@${display} ${help}`, broadcasterId); }\r\n else if (/^!levelup(?:\\s+([+-]\\d+))?$/i.test(chatMessage)) { const match = chatMessage.match(/^!levelup(?:\\s+([+-]\\d+))?$/i)!; const delta = match[1] ? Number.parseInt(match[1], 10) : 1; const result = await adjustLevel(chatter, delta); if (\"error\" in result) { const errorText = result.error === \"no character\" ? \"you don't have a character yet — try !createchar\" : result.error === \"max level\" ? \"you're already level 20\" : result.error === \"min level\" ? \"you're already level 1\" : \"use !levelup, !levelup +2, or !levelup -1\"; await sendChatMessage(`@${display} ${errorText}`, broadcasterId); } else { const direction = result.delta > 0 ? \"advanced\" : \"reduced\"; const hpChange = result.hpGain >= 0 ? `HP +${result.hpGain}` : `HP ${result.hpGain}`; await sendChatMessage(`@${display} level ${direction} from ${result.oldLevel} to ${result.c.level}; ${hpChange}, HP ${result.c.hpCurrent}/${result.c.hpMax}, Prof +${result.c.proficiency}.${result.asi}`, broadcasterId); } }\r\n else if (/^!(spell|item|class|feat|ability|race|subrace)\\s+/i.test(chatMessage)) { const match = chatMessage.match(/^!(spell|item|class|feat|ability|race|subrace)\\s+(.+?)(?:\\s+\\+(\\d+))?$/i)!; const kind = match[1].toLowerCase(); const bonus = match[3] ? Math.min(20, Number.parseInt(match[3], 10)) : null; const data = await lookup5e(kind, match[2].trim()); if (data && kind === \"spell\") await sendSpellSections(formatSpellSections(data, bonus), display, broadcasterId); else await sendChatMessages(data ? `@${display} ${formatLookup(kind, data, bonus)}` : `@${display} couldn't find that ${kind}. Try an exact search, such as !spell fireball or !item longsword +1`, broadcasterId); }\r\n else if (/^!(?:roll|r)(?:\\s+.*)?$/i.test(chatMessage) || chatMessage.toLowerCase() === \"!d20\") { const expression = chatMessage.toLowerCase() === \"!d20\" ? \"1d20\" : chatMessage.replace(/^!(?:roll|r)\\s*/i, \"\").trim(); const result = rollDice(expression || \"1d20\"); await sendChatMessage(result ? `@${display} ${result}` : `@${display} that's not a valid roll — try !roll, !r, or !roll 2d6+3`, broadcasterId); }\r\n else if (chatMessage === \"!createchar\") { const c = generateCharacter(chatter); await saveCharacter(c); await sendChatMessage(`@${display} created a level 1 ${formatRaceName(c.race,c.subrace)} ${c.cls}! ${formatStatLine(c)} — ${baseUrl}/?user=${chatter}`, broadcasterId); }\r\n else if (chatMessage === \"!char\") { const c = await getCharacter(chatter); await sendChatMessage(c ? `@${display} ${formatRaceName(c.race,c.subrace)} ${c.cls} — ${formatStatLine(c)} — ${baseUrl}/?user=${chatter}` : `@${display} you don't have a character yet — try !createchar`, broadcasterId); }\r\n else if (chatMessage.startsWith(\"!hp \")) { const delta = Number.parseInt(chatMessage.slice(4).trim()); if (Number.isNaN(delta)) await sendChatMessage(`@${display} use !hp +5 or !hp -3`, broadcasterId); else { const c = await adjustHp(chatter, delta); await sendChatMessage(c ? `@${display} HP: ${c.hpCurrent}/${c.hpMax}` : `@${display} you don't have a character yet — try !createchar`, broadcasterId); } }\r\n else if (chatMessage === \"!savechar\") await sendChatMessage(await backupCharacter(chatter) ? `@${display} character saved!` : `@${display} no character to save — try !createchar`, broadcasterId);\r\n else if (chatMessage === \"!loadchar\") { const c = await loadBackup(chatter); await sendChatMessage(c ? `@${display} character loaded! ${formatStatLine(c)} — ${baseUrl}/?user=${chatter}` : `@${display} no saved backup found — try !savechar first`, broadcasterId); }\r\n else if (chatMessage === \"!resetchar\") { await resetCharacter(chatter); await sendChatMessage(`@${display} character reset — use !createchar to roll a new one`, broadcasterId); }\r\n }\r\n if (messageType === \"revocation\") console.log(\"Subscription revoked:\", body); return new Response(\"OK\");\r\n}\r\n\r\n// TWITCH_BOT_ID must be the numeric Twitch user ID belonging to TWITCH_BOT_TOKEN.\r\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}",[196],"5a316037-8f43-484a-98d1-4a4ef3d2a393","db.ts","82592d08-a4d9-11f1-854e-1607ee4eb77e",78,["D",1788139248820],"// 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 }\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 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 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}\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 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,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.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,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.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",[203],"1753c54e-0d1f-480b-9c51-296564738228",["D",1788139248812],[28],"6bc9499f-1c0b-41e1-bde9-51cd0c2f4322","combat.ts","8de9ca4c-a4d9-11f1-a925-1607ee4eb77e",76,["D",1788139248807],"// Duels, party combat, monster duels, and initiative tracker\n\nimport { SOLO_MONSTERS } 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\";\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\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 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 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 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 [broadcasterId, challenge.challenger, username, challenge.challenger, challenger.hpMax, defender.hpMax, Date.now()],\n );\n await sendChatMessage(\n `@${display} accepted! ${challenge.challenger} goes first. ${duelNarration(\"accept\")} Use !dndduel attack or !dndduel status.`,\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 const targetName = parts.slice(1).join(\" \").replace(/^@/, \"\").toLowerCase();\n if (!targetName) {\n await sendChatMessage(\n `@${display} use !dndduel @username, !dndduel accept, !dndduel decline, !dndduel attack, !dndduel status, or !dndduel end.`,\n broadcasterId,\n );\n return true;\n }\n if (active) {\n await sendChatMessage(`@${display} a duel is already active in this channel.`, 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) VALUES (?,?,?,?)\",\n [broadcasterId, username, targetName, Date.now()],\n );\n await sendChatMessage(\n `@${display} challenged @${targetName} to a duel! ${duelNarration(\"challenge\")} @${targetName}, type !dndduel accept or !dndduel decline.`,\n broadcasterId,\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 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 if (normalized === \"!dndduel\") {\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 challenge the wilds with !dndduel.`,\n broadcasterId,\n );\n return true;\n }\n const monster = SOLO_MONSTERS[Math.floor(Math.random() * SOLO_MONSTERS.length)];\n const playerHp = c.hpMax;\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} the D20 of Fate summons a ${monster.name} (CR ${monster.cr})! ${duelNarration(\"challenge\")} ${monster.name}: AC ${monster.ac}, HP ${monster.hp}. Your HP: ${playerHp}. Use !dndduel attack.`,\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 await sendChatMessage(\n `@${display} ${playerResult} ${active.monster_name} is defeated! ${duelNarration(\"victory\")}`,\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 const parts = chatMessage.trim().split(/\\s+/);\n const action = (parts[1] ?? \"list\").toLowerCase();\n const name = (parts[2] ?? \"\").replace(/^@/, \"\").toLowerCase().replace(/[^a-z0-9_-]/g, \"\");\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 await sqlite.execute(\"INSERT INTO parties (broadcaster_id,party_name,owner,created_at) VALUES (?,?,?,?)\", [\n broadcasterId,\n name,\n username,\n Date.now(),\n ]);\n await sqlite.execute(\n \"INSERT INTO party_members (broadcaster_id,party_name,username,joined_at) VALUES (?,?,?,?)\",\n [broadcasterId, name, username, Date.now()],\n );\n await sendChatMessage(`@${display} party ${name} created. You are the leader.`, broadcasterId);\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(username))) {\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, username, 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 (party.owner === username) {\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, username],\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();\n const partyName = (parts[3] ?? \"\").toLowerCase();\n const party = await getParty(broadcasterId, partyName);\n const members = party ? await getPartyMembers(broadcasterId, partyName) : [];\n if (!party || (party.owner !== username && !members.includes(username))) {\n await sendChatMessage(`@${display} only a party member can invite someone to that party.`, broadcasterId);\n } else if (!(await getCharacter(target))) {\n await sendChatMessage(`@${display} that player needs a saved character first.`, broadcasterId);\n } else {\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 }\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 (party.owner !== username) {\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 username = ? ORDER BY party_name\",\n [broadcasterId, username],\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 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 aHp: Record = {};\n const dHp: Record = {};\n for (const n of attackers) {\n const c = await getCharacter(n);\n if (c) aHp[n] = c.hpMax;\n }\n for (const n of defenders) {\n const c = await getCharacter(n);\n if (c) dHp[n] = c.hpMax;\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 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} party duel accepted! ${challenge.challenger_party} goes first. ${duelNarration(\"accept\")} Use !dndduel party attack.`,\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 const challengerParty = (parts[1] === \"party\" ? parts[2] : \"\").toLowerCase();\n const defenderParty = (parts[1] === \"party\" ? parts[3] : \"\").toLowerCase();\n if (!challengerParty || !defenderParty) {\n await sendChatMessage(\n `@${display} use !dndduel party

, then !dndduel party accept.`,\n broadcasterId,\n );\n return true;\n }\n if (active) {\n await sendChatMessage(`@${display} a 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 || ownParty.owner !== username || !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 (targetParty.owner === username) {\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) VALUES (?,?,?,?,?,?)\",\n [broadcasterId, challengerParty, defenderParty, username, targetParty.owner, Date.now()],\n );\n await sendChatMessage(\n `@${display} party ${challengerParty} challenged party ${defenderParty}! ${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",[213],"2ce45568-ba41-4742-99ad-7aa85d7add95","characters.ts","8571f1d2-a4d9-11f1-8da9-1607ee4eb77e",75,["D",1788139248715],"// 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 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 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\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],"97ea5a9f-416b-4808-9d7c-8e21e95a8618","README.md","a9ce1e16-a4d9-11f1-939e-1607ee4eb77e",74,["D",1788139031739],[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`",[233],"722e7a17-a099-4f29-8e69-2679535add68",".vtignore","2c724ea2-a3c0-11f1-bf9f-1607ee4eb77e",["D",1788018119974],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor",[239],"pulls","branches","forks","envVars",{"_251":253,"_254":60},"connections",{"_251":60,"_252":60},"count","unfilledCount",6,"emptyCount",{"_43":238,"_32":239,"_30":240,"_146":-5,"_41":42,"_40":150,"_148":123,"_38":313,"_13":60,"_33":20,"_35":242,"_24":25,"_151":-5,"_271":314,"_27":315},{"_43":232,"_32":233,"_30":234,"_146":-5,"_41":42,"_40":183,"_148":25,"_38":310,"_13":60,"_33":20,"_35":236,"_24":25,"_151":-5,"_271":311,"_27":312},{"_43":226,"_32":227,"_30":228,"_146":-5,"_41":42,"_40":229,"_148":25,"_38":307,"_13":183,"_33":20,"_35":36,"_24":25,"_151":-5,"_271":308,"_27":309},{"_43":219,"_32":220,"_30":221,"_146":-5,"_41":42,"_40":222,"_148":25,"_38":304,"_13":183,"_33":34,"_35":224,"_24":25,"_151":-5,"_271":305,"_27":306},{"_43":212,"_32":213,"_30":214,"_146":-5,"_41":42,"_40":215,"_148":25,"_38":301,"_13":183,"_33":34,"_35":217,"_24":25,"_151":-5,"_271":302,"_27":303},{"_43":209,"_32":28,"_30":31,"_146":-5,"_41":42,"_40":14,"_148":25,"_38":298,"_13":183,"_33":34,"_35":37,"_24":25,"_151":-5,"_271":299,"_27":300},{"_43":202,"_32":203,"_30":204,"_146":-5,"_41":42,"_40":205,"_148":25,"_38":295,"_13":183,"_33":34,"_35":207,"_24":25,"_151":-5,"_271":296,"_27":297},{"_43":195,"_32":196,"_30":197,"_146":-5,"_41":42,"_40":198,"_148":123,"_38":292,"_13":60,"_33":20,"_35":200,"_24":25,"_151":-5,"_271":293,"_27":294},{"_43":186,"_32":187,"_30":188,"_146":-5,"_41":42,"_40":189,"_148":25,"_38":289,"_13":191,"_33":192,"_35":193,"_24":25,"_151":-5,"_271":290,"_27":291},{"_43":178,"_32":179,"_30":180,"_146":-5,"_41":42,"_40":181,"_148":25,"_38":286,"_13":183,"_33":34,"_35":184,"_24":25,"_151":-5,"_271":287,"_27":288},{"_43":171,"_32":172,"_30":173,"_146":-5,"_41":42,"_40":174,"_148":25,"_38":283,"_13":150,"_33":34,"_35":36,"_24":25,"_151":176,"_271":284,"_27":285},{"_43":165,"_32":166,"_30":167,"_146":-5,"_41":42,"_40":168,"_148":25,"_38":280,"_13":150,"_33":34,"_35":36,"_24":25,"_151":-5,"_271":281,"_27":282},{"_43":159,"_32":160,"_30":161,"_146":-5,"_41":42,"_40":162,"_148":25,"_38":277,"_13":150,"_33":34,"_35":36,"_24":25,"_151":-5,"_271":278,"_27":279},{"_43":153,"_32":154,"_30":155,"_146":-5,"_41":42,"_40":156,"_148":25,"_38":274,"_13":150,"_33":34,"_35":36,"_24":25,"_151":-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":36,"_24":25,"_151":-5,"_271":272,"_27":273},["D",1788138950181],"children",[],[144],["D",1788138936330],[],[154],["D",1788139007885],[],[160],["D",1788139017387],[],[166],["D",1788138928779],[],[172],["D",1788139248824],[],[179],["D",1788056960628],[],[187],["D",1788018120139],[],[196],["D",1788139248820],[],[203],["D",1788139248812],[],[28],["D",1788139248807],[],[213],["D",1788139248715],[],[220],["D",1788139031739],[],[227],["D",1788018120020],[],[233],["D",1788018119974],[],[239],["D",1787995257440],["D",1789500119686],{"_97":96,"_105":101},{"_97":96,"_98":99,"_100":101,"_18":54,"_102":103,"_104":25},{"_13":86,"_32":87,"_43":42,"_88":44,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":45,"_95":96},"ctx",{"_79":-5,"_125":354,"_355":356,"_357":358,"_359":25,"_360":25,"_361":25,"_362":123,"_363":-5,"_364":-7,"_365":-7,"_366":60,"_367":25,"_368":25,"_369":-5,"_370":25,"_371":25,"_372":25,"_373":-5},"ENV",{"_325":326,"_327":328,"_329":87,"_330":331,"_332":333,"_334":335,"_336":337,"_338":339,"_340":341,"_342":343,"_344":345,"_346":347,"_348":349,"_350":351,"_352":353},"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 · v79