[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_381":382,"_383":384},"routes/_app.x.$handle.$name",{"_96":95,"_31":43,"_105":86,"_26":51,"_13":14,"_106":-5,"_11":107,"_108":109,"_110":111,"_112":113,"_114":115,"_20":-5,"_116":-5,"_117":-5,"_118":24,"_119":120,"_121":122,"_123":-5,"_124":-5,"_125":126},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_41":42,"_31":43,"_36":44,"_45":-5,"_46":24,"_47":48,"_49":48,"_50":51,"_52":-5,"_18":53,"_54":-5,"_55":24,"_56":-5,"_57":-5,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":-5,"_69":70,"_71":70,"_72":73,"_74":73,"_75":73,"_76":70,"_77":70,"_78":79,"_80":81,"_82":83,"_84":24},"version",239,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":24,"_26":27,"_28":27},"file",{"_29":30,"_31":27,"_32":33,"_34":35,"_36":37,"_38":14,"_39":40,"_23":24},"previous","deleted",false,"deletedHere","path","customcommands.ts","latestPath","fileId","bdaaf546-a8ce-11f1-9bc5-1607ee4eb77e","name","fileType","script","content","// Custom commands & chat triggers — lets a broadcaster/mod add their own\n// !commands and passive keyword auto-responses without touching code.\n//\n// NOTE: this reuses the \"!dndbot\" word already used for on/off/status/leave\n// (see main.ts) as a second-level namespace. Those exact phrases are matched\n// and handled earlier in main.ts and never reach this module, so there's no\n// collision — but keep any new subcommand word here off that list too.\n//\n// !dndbot add (mod) create a new !name → response\n// !dndbot edit (mod) change an existing one\n// !dndbot remove (mod) delete one\n// !dndbot cooldown (mod) per-command cooldown (0-3600s)\n// !dndbot list anyone — list configured command names\n//\n// !trigger add (mod) fire whenever\n// appears in chat (no !)\n// !trigger remove (mod)\n// !trigger cooldown (mod)\n// !trigger list anyone\n//\n// Responses support a few placeholders:\n// {user} display name of whoever triggered it\n// {target} the first @mentioned user in a !command's arguments (falls\n// back to {user} for triggers, which have no arguments)\n// {count} how many times this command/trigger has now fired\n// {random:a|b|c} picks one option at random (max 5 per response)\n\nimport { pick, compactText } from \"./utils.ts\";\nimport { sendChatMessage, sendChatMessages } from \"./twitch.ts\";\nimport {\n addCustomCommand,\n addCustomTrigger,\n deleteCustomCommand,\n deleteCustomTrigger,\n listCustomCommands,\n listCustomTriggers,\n markCustomTriggerUsed,\n editCustomCommand,\n setCustomCommandCooldown,\n setCustomTriggerCooldown,\n useCustomCommand,\n} from \"./db.ts\";\n\nconst MAX_CUSTOM_RESPONSE_LEN = 400;\nconst MAX_COOLDOWN_SECONDS = 3600;\nconst MAX_RANDOM_BLOCKS = 5;\n\n// Every built-in command word (and a few words reserved for future/adjacent\n// features, e.g. undocumented or not-yet-loaded modules) so custom commands\n// can never shadow or be confused with the bot's own commands.\nconst RESERVED_NAMES = new Set([\n \"roll\", \"r\", \"d20\", \"bg3roll\", \"bg3\", \"bg3companion\", \"bg3origin\", \"bg3loot\", \"bg3camp\",\n \"createchar\", \"newchar\", \"answer\", \"cancel\", \"char\", \"hp\", \"savechar\", \"loadchar\", \"resetchar\",\n \"levelup\", \"spell\", \"item\", \"class\", \"feat\", \"ability\", \"race\", \"subrace\", \"rule\", \"rules\",\n \"dndduel\", \"turn\", \"party\", \"dndbot\", \"dndbothelp\", \"logs\", \"connections\", \"help\", \"link\", \"guide\",\n \"cmd\", \"trigger\", \"command\", \"commands\", \"hug\", \"map\", \"mod\", \"admin\", \"bot\",\n]);\n\nconst NAME_RE = /^[a-z0-9_-]{2,25}$/;\n\nexport function sanitizeCommandName(raw: string): string | null {\n const name = raw.trim().toLowerCase().replace(/^!/, \"\");\n return NAME_RE.test(name) ? name : null;\n}\n\nexport function sanitizeTriggerKeyword(raw: string): string | null {\n const keyword = raw.trim().toLowerCase().replace(/\\s+/g, \" \");\n if (!/^[\\p{L}\\p{N} '!?.-]{2,40}$/u.test(keyword)) return null;\n if (keyword.split(\" \").length > 5) return null;\n return keyword;\n}\n\nfunction applyTemplate(response: string, vars: { user: string; target?: string; count?: number }): string {\n let randomBlocks = 0;\n let out = response.replace(/\\{random:([^{}]{1,200})\\}/gi, (_match, options: string) => {\n randomBlocks++;\n if (randomBlocks > MAX_RANDOM_BLOCKS) return \"\";\n const choices = options.split(\"|\").map((s) => s.trim()).filter(Boolean);\n return choices.length ? pick(choices) : \"\";\n });\n out = out.replaceAll(\"{user}\", vars.user);\n out = out.replaceAll(\"{target}\", vars.target ?? vars.user);\n out = out.replaceAll(\"{count}\", String(vars.count ?? \"\"));\n return out;\n}\n\nfunction buildKeywordRegex(keyword: string): RegExp {\n const escaped = keyword.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\").replace(/\\s+/g, \"\\\\s+\");\n return new RegExp(`\\\\b${escaped}\\\\b`, \"i\");\n}\n\nfunction parseCooldownSeconds(raw: string | undefined): number | null {\n const seconds = Number.parseInt(raw ?? \"\", 10);\n return Number.isFinite(seconds) && seconds >= 0 && seconds <= MAX_COOLDOWN_SECONDS ? seconds : null;\n}\n\nasync function requireModerator(display: string, broadcasterId: string, isModerator: boolean, what: string) {\n if (isModerator) return true;\n await sendChatMessage(`@${display} only the broadcaster or a moderator can manage ${what}.`, broadcasterId);\n return false;\n}\n\nasync function handleDndbotCustomCommandSubcommand(\n chatMessage: string,\n display: string,\n broadcasterId: string,\n isModerator: boolean,\n): Promise {\n const parts = chatMessage.trim().split(/\\s+/);\n const action = (parts[1] ?? \"\").toLowerCase();\n\n if (action === \"list\" || action === \"\") {\n const rows = await listCustomCommands(broadcasterId);\n await sendChatMessages(\n rows.length\n ? `@${display} Custom commands (${rows.length}): ${rows.map((r: any) => `!${r.name}`).join(\", \")}`\n : `@${display} no custom commands yet.${isModerator ? \" Add one with !dndbot add .\" : \"\"}`,\n broadcasterId,\n );\n return true;\n }\n\n if (action === \"add\" || action === \"edit\") {\n if (!(await requireModerator(display, broadcasterId, isModerator, \"custom commands\"))) return true;\n const match = chatMessage.match(/^!dndbot\\s+(?:add|edit)\\s+!?(\\S+)\\s+([\\s\\S]+)$/i);\n if (!match) {\n await sendChatMessage(`@${display} usage: !dndbot ${action} `, broadcasterId);\n return true;\n }\n const name = sanitizeCommandName(match[1]);\n const response = compactText(match[2], MAX_CUSTOM_RESPONSE_LEN);\n if (!name) {\n await sendChatMessage(`@${display} command names must be 2-25 characters: letters, numbers, - or _.`, broadcasterId);\n return true;\n }\n if (RESERVED_NAMES.has(name)) {\n await sendChatMessage(`@${display} !${name} is a built-in command and can't be added or edited.`, broadcasterId);\n return true;\n }\n if (!response) {\n await sendChatMessage(`@${display} give the command a response, e.g. !dndbot add hello Welcome to the guild hall, {user}!`, broadcasterId);\n return true;\n }\n if (action === \"add\") {\n const result = await addCustomCommand(broadcasterId, name, response, display);\n if (!result.ok) {\n await sendChatMessage(\n result.error === \"exists\"\n ? `@${display} !${name} already exists — use !dndbot edit ${name} to change it.`\n : `@${display} this channel's custom command limit (${result.max}) is reached — remove one with !dndbot remove first.`,\n broadcasterId,\n );\n return true;\n }\n await sendChatMessage(`@${display} added !${name}.`, broadcasterId);\n } else {\n const updated = await editCustomCommand(broadcasterId, name, response);\n await sendChatMessage(\n updated ? `@${display} updated !${name}.` : `@${display} !${name} doesn't exist yet — use !dndbot add ${name} .`,\n broadcasterId,\n );\n }\n return true;\n }\n\n if (action === \"remove\" || action === \"delete\") {\n if (!(await requireModerator(display, broadcasterId, isModerator, \"custom commands\"))) return true;\n const name = sanitizeCommandName(parts[2] ?? \"\");\n if (!name) {\n await sendChatMessage(`@${display} usage: !dndbot remove `, broadcasterId);\n return true;\n }\n const removed = await deleteCustomCommand(broadcasterId, name);\n await sendChatMessage(removed ? `@${display} removed !${name}.` : `@${display} !${name} doesn't exist.`, broadcasterId);\n return true;\n }\n\n if (action === \"cooldown\") {\n if (!(await requireModerator(display, broadcasterId, isModerator, \"custom commands\"))) return true;\n const name = sanitizeCommandName(parts[2] ?? \"\");\n const seconds = parseCooldownSeconds(parts[3]);\n if (!name || seconds === null) {\n await sendChatMessage(`@${display} usage: !dndbot cooldown `, broadcasterId);\n return true;\n }\n const updated = await setCustomCommandCooldown(broadcasterId, name, seconds * 1000);\n await sendChatMessage(\n updated ? `@${display} !${name} cooldown set to ${seconds}s.` : `@${display} !${name} doesn't exist.`,\n broadcasterId,\n );\n return true;\n }\n\n await sendChatMessage(\n `@${display} Custom commands: !dndbot add | !dndbot edit | !dndbot remove | !dndbot cooldown | !dndbot list — add/edit/remove/cooldown are mod-only`,\n broadcasterId,\n );\n return true;\n}\n\nasync function handleTriggerSubcommand(\n chatMessage: string,\n display: string,\n broadcasterId: string,\n isModerator: boolean,\n): Promise {\n const parts = chatMessage.trim().split(/\\s+/);\n const action = (parts[1] ?? \"\").toLowerCase();\n\n if (action === \"list\" || action === \"\") {\n const rows = await listCustomTriggers(broadcasterId);\n await sendChatMessages(\n rows.length\n ? `@${display} Chat triggers (${rows.length}): ${rows.map((r: any) => `\"${r.keyword}\"`).join(\", \")}`\n : `@${display} no chat triggers yet.${isModerator ? \" Add one with !trigger add .\" : \"\"}`,\n broadcasterId,\n );\n return true;\n }\n\n if (action === \"add\") {\n if (!(await requireModerator(display, broadcasterId, isModerator, \"triggers\"))) return true;\n const match =\n chatMessage.match(/^!trigger\\s+add\\s+\"([^\"]{2,40})\"\\s+([\\s\\S]+)$/i) ??\n chatMessage.match(/^!trigger\\s+add\\s+(\\S+)\\s+([\\s\\S]+)$/i);\n if (!match) {\n await sendChatMessage(\n `@${display} usage: !trigger add (wrap multi-word keywords in quotes)`,\n broadcasterId,\n );\n return true;\n }\n const keyword = sanitizeTriggerKeyword(match[1]);\n const response = compactText(match[2], MAX_CUSTOM_RESPONSE_LEN);\n if (!keyword) {\n await sendChatMessage(`@${display} keywords must be 2-40 characters, up to 5 words.`, broadcasterId);\n return true;\n }\n if (!response) {\n await sendChatMessage(`@${display} give the trigger a response.`, broadcasterId);\n return true;\n }\n const result = await addCustomTrigger(broadcasterId, keyword, response, display);\n if (!result.ok) {\n await sendChatMessage(\n result.error === \"exists\"\n ? `@${display} a trigger for \"${keyword}\" already exists — remove it first with !trigger remove ${keyword}.`\n : `@${display} this channel's trigger limit (${result.max}) is reached.`,\n broadcasterId,\n );\n return true;\n }\n await sendChatMessage(`@${display} added trigger for \"${keyword}\".`, broadcasterId);\n return true;\n }\n\n if (action === \"remove\" || action === \"delete\") {\n if (!(await requireModerator(display, broadcasterId, isModerator, \"triggers\"))) return true;\n const rawKeyword = chatMessage.replace(/^!trigger\\s+(?:remove|delete)\\s+/i, \"\").replace(/^\"|\"$/g, \"\").trim();\n const keyword = sanitizeTriggerKeyword(rawKeyword);\n if (!keyword) {\n await sendChatMessage(`@${display} usage: !trigger remove `, broadcasterId);\n return true;\n }\n const removed = await deleteCustomTrigger(broadcasterId, keyword);\n await sendChatMessage(\n removed ? `@${display} removed trigger \"${keyword}\".` : `@${display} no trigger found for \"${keyword}\".`,\n broadcasterId,\n );\n return true;\n }\n\n if (action === \"cooldown\") {\n if (!(await requireModerator(display, broadcasterId, isModerator, \"triggers\"))) return true;\n const cdMatch =\n chatMessage.match(/^!trigger\\s+cooldown\\s+\"([^\"]{2,40})\"\\s+(\\d+)$/i) ??\n chatMessage.match(/^!trigger\\s+cooldown\\s+(\\S+)\\s+(\\d+)$/i);\n const keyword = cdMatch ? sanitizeTriggerKeyword(cdMatch[1]) : null;\n const seconds = cdMatch ? parseCooldownSeconds(cdMatch[2]) : null;\n if (!keyword || seconds === null) {\n await sendChatMessage(`@${display} usage: !trigger cooldown `, broadcasterId);\n return true;\n }\n const updated = await setCustomTriggerCooldown(broadcasterId, keyword, seconds * 1000);\n await sendChatMessage(\n updated ? `@${display} trigger \"${keyword}\" cooldown set to ${seconds}s.` : `@${display} no trigger found for \"${keyword}\".`,\n broadcasterId,\n );\n return true;\n }\n\n await sendChatMessage(\n `@${display} Chat triggers: !trigger add | !trigger remove | !trigger cooldown | !trigger list — add/remove/cooldown are mod-only`,\n broadcasterId,\n );\n return true;\n}\n\n/**\n * Handles !dndbot add/edit/remove/cooldown/list and !trigger ... management\n * syntax. Returns false if the message is neither — in particular, call this\n * only after main.ts's own !dndbot on/off/status/leave checks have already\n * had a chance to match and return early.\n */\nexport async function handleCustomCommandManagement(\n chatMessage: string,\n display: string,\n broadcasterId: string,\n isModerator: boolean,\n): Promise {\n if (/^!dndbot(?:\\s|$)/i.test(chatMessage)) return await handleDndbotCustomCommandSubcommand(chatMessage, display, broadcasterId, isModerator);\n if (/^!trigger(?:\\s|$)/i.test(chatMessage)) return await handleTriggerSubcommand(chatMessage, display, broadcasterId, isModerator);\n return false;\n}\n\n/**\n * Fallback for any \"!something\" that didn't match a built-in command. Only\n * call this after every built-in handler has already declined the message.\n */\nexport async function handleCustomCommandInvocation(\n chatMessage: string,\n display: string,\n broadcasterId: string,\n): Promise {\n const match = chatMessage.trim().match(/^!(\\S+)(?:\\s+(.*))?$/);\n if (!match) return false;\n const name = match[1].toLowerCase();\n if (RESERVED_NAMES.has(name)) return false;\n const result = await useCustomCommand(broadcasterId, name);\n if (!result) return false; // no such custom command — silently ignore, like any unknown command\n if (result.onCooldown) return true; // known command, just cooling down — swallow silently\n\n const args = (match[2] ?? \"\").trim();\n const targetMatch = args.match(/@(\\S+)/);\n const target = targetMatch ? targetMatch[1].replace(/[,:]+$/, \"\") : undefined;\n const text = applyTemplate(String(result.row.response ?? \"\"), {\n user: display,\n target,\n count: Number(result.row.uses ?? 0),\n });\n await sendChatMessages(text, broadcasterId);\n return true;\n}\n\n/**\n * Passive keyword matching for ordinary (non-\"!\") chat messages. Fires at\n * most one trigger per message, skipping any still on cooldown.\n */\nexport async function handleTriggerMatch(\n chatMessage: string,\n display: string,\n broadcasterId: string,\n): Promise {\n const text = chatMessage.trim();\n if (!text) return false;\n const triggers = await listCustomTriggers(broadcasterId);\n if (!triggers.length) return false;\n const lower = text.toLowerCase();\n const now = Date.now();\n for (const row of triggers) {\n const keyword = String(row.keyword ?? \"\");\n if (!keyword || !buildKeywordRegex(keyword).test(lower)) continue;\n const cooldownMs = Number(row.cooldown_ms ?? 0);\n const lastUsedAt = Number(row.last_used_at ?? 0);\n if (cooldownMs > 0 && now - lastUsedAt < cooldownMs) continue; // on cooldown — see if another trigger matches\n await markCustomTriggerUsed(broadcasterId, keyword);\n const rendered = applyTemplate(String(row.response ?? \"\"), { user: display, count: Number(row.uses ?? 0) + 1 });\n await sendChatMessages(rendered, broadcasterId);\n return true;\n }\n return false;\n}\n","createdAt",["D",1788574132390],"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",{"_96":95,"_104":100},"org",{"_96":95,"_97":98,"_99":100,"_18":53,"_101":102,"_103":24},"branch",{"_13":85,"_31":86,"_41":40,"_87":42,"_88":-5,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":43,"_94":95},"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",{"_41":42,"_31":43,"_36":376,"_45":-5,"_46":24,"_47":48,"_49":48,"_50":51,"_52":-5,"_18":53,"_54":-5,"_55":24,"_56":-5,"_57":-5,"_58":59,"_60":61,"_62":63,"_64":65,"_66":377,"_68":-5,"_69":70,"_71":70,"_72":73,"_74":73,"_75":73,"_76":70,"_77":70,"_78":378,"_80":379,"_82":380,"_84":24},"tree",[299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,317],"files",[299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,317],"counts",{"_288":59,"_289":284,"_290":59,"_291":292,"_293":294},"contents",[127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles",true,"grants","orgs","customDomains",{},{"_41":281,"_31":282,"_29":283,"_149":-5,"_39":40,"_38":284,"_151":122,"_36":285,"_13":59,"_32":20,"_34":286,"_23":24,"_155":-5,"_26":287},{"_41":275,"_31":276,"_29":277,"_149":-5,"_39":40,"_38":186,"_151":24,"_36":278,"_13":59,"_32":20,"_34":279,"_23":24,"_155":-5,"_26":280},{"_41":268,"_31":269,"_29":270,"_149":-5,"_39":40,"_38":271,"_151":24,"_36":272,"_13":178,"_32":20,"_34":273,"_23":24,"_155":-5,"_26":274},{"_41":260,"_31":261,"_29":262,"_149":-5,"_39":40,"_38":263,"_151":24,"_36":264,"_13":265,"_32":33,"_34":266,"_23":24,"_155":-5,"_26":267},{"_41":253,"_31":254,"_29":255,"_149":-5,"_39":40,"_38":256,"_151":122,"_36":257,"_13":210,"_32":33,"_34":258,"_23":24,"_155":-5,"_26":259},{"_41":246,"_31":247,"_29":248,"_149":-5,"_39":40,"_38":249,"_151":122,"_36":250,"_13":210,"_32":33,"_34":251,"_23":24,"_155":-5,"_26":252},{"_41":239,"_31":240,"_29":241,"_149":-5,"_39":40,"_38":242,"_151":24,"_36":243,"_13":162,"_32":33,"_34":244,"_23":24,"_155":-5,"_26":245},{"_41":232,"_31":233,"_29":234,"_149":-5,"_39":40,"_38":235,"_151":24,"_36":236,"_13":153,"_32":33,"_34":237,"_23":24,"_155":-5,"_26":238},{"_41":229,"_31":27,"_29":30,"_149":-5,"_39":40,"_38":14,"_151":24,"_36":230,"_13":59,"_32":33,"_34":35,"_23":24,"_155":-5,"_26":231},{"_41":221,"_31":222,"_29":223,"_149":-5,"_39":40,"_38":224,"_151":24,"_36":225,"_13":226,"_32":33,"_34":227,"_23":24,"_155":-5,"_26":228},{"_41":214,"_31":215,"_29":216,"_149":-5,"_39":40,"_38":217,"_151":24,"_36":218,"_13":170,"_32":33,"_34":219,"_23":24,"_155":-5,"_26":220},{"_41":207,"_31":208,"_29":209,"_149":-5,"_39":40,"_38":210,"_151":122,"_36":211,"_13":59,"_32":20,"_34":212,"_23":24,"_155":-5,"_26":213},{"_41":199,"_31":200,"_29":201,"_149":-5,"_39":40,"_38":202,"_151":24,"_36":203,"_13":204,"_32":33,"_34":205,"_23":24,"_155":-5,"_26":206},{"_41":189,"_31":190,"_29":191,"_149":-5,"_39":40,"_38":192,"_151":24,"_36":193,"_13":194,"_32":195,"_34":196,"_23":24,"_155":197,"_26":198},{"_41":181,"_31":182,"_29":183,"_149":-5,"_39":40,"_38":184,"_151":122,"_36":185,"_13":186,"_32":33,"_34":187,"_23":24,"_155":-5,"_26":188},{"_41":173,"_31":174,"_29":175,"_149":-5,"_39":40,"_38":176,"_151":24,"_36":177,"_13":178,"_32":33,"_34":179,"_23":24,"_155":-5,"_26":180},{"_41":165,"_31":166,"_29":167,"_149":-5,"_39":40,"_38":168,"_151":24,"_36":169,"_13":170,"_32":33,"_34":171,"_23":24,"_155":-5,"_26":172},{"_41":157,"_31":158,"_29":159,"_149":-5,"_39":40,"_38":160,"_151":24,"_36":161,"_13":162,"_32":33,"_34":163,"_23":24,"_155":-5,"_26":164},{"_41":146,"_31":147,"_29":148,"_149":-5,"_39":40,"_38":150,"_151":24,"_36":152,"_13":153,"_32":33,"_34":154,"_23":24,"_155":-5,"_26":156},"26751ec0-a427-4326-a164-c08cfc08b4a9","utils.ts","7c7a4070-a4d9-11f1-90df-1607ee4eb77e","parentId",226,"latest",["D",1788404439941],10,"// Pure helpers and small shared utilities\n\nimport type { Ability, Character } from \"./types.ts\";\nimport { abilityNames, abilityAliases, abilityFullNames, skillAbilities, knownBotAccounts } from \"./data.ts\";\n\nexport const pick = (items: T[]): T => items[Math.floor(Math.random() * items.length)];\n\nexport const modifier = (score: number) => Math.floor((score - 10) / 2);\n\nexport function rollStat() {\n const d = Array.from({ length: 4 }, () => 1 + Math.floor(Math.random() * 6)).sort((a, b) => b - a);\n return d[0] + d[1] + d[2];\n}\n\nexport function formatRaceName(race: string, subrace: string | null) {\n if (!subrace) return race.trim();\n const nr = race.trim().toLowerCase();\n const ns = subrace.trim().toLowerCase();\n return ns === nr || ns.endsWith(` ${nr}`) ? subrace.trim() : `${subrace.trim()} ${race.trim()}`;\n}\n\nexport function escapeHtml(value: string) {\n return value.replace(/[&<>'\"]/g, (c) => ({ \"&\": \"&\", \"<\": \"<\", \">\": \">\", \"'\": \"'\", '\"': \""\" }[c]!));\n}\n\nexport function formatStatLine(c: Character) {\n return `Lv${c.level} XP ${c.xp ?? 0} | ${abilityNames\n .map((a) => `${a} ${c.scores[a]}(${modifier(c.scores[a]) >= 0 ? \"+\" : \"\"}${modifier(c.scores[a])})`)\n .join(\" \")} | HP ${c.hpCurrent}/${c.hpMax} | Speed ${c.speed}ft | Prof +${c.proficiency}`;\n}\n\nexport function duelNarration(stage: string) {\n const lines: Record = {\n challenge: [\"The arena gates swing open.\", \"The gauntlet has been thrown.\", \"Fate calls for a showdown.\"],\n accept: [\"The crowd roars—the duel is on.\", \"Steel meets destiny.\", \"The initiative gods have been consulted.\"],\n decline: [\"The challenge fades into the tavern gossip.\", \"Wisdom wins this round.\", \"The duel is postponed by fate.\"],\n hit: [\"A clean strike finds its mark.\", \"That hit had advantage from destiny.\", \"The dice have chosen violence.\"],\n miss: [\"The attack misses wide; the boots remain unharmed.\", \"The blade finds only air.\", \"The dice requested a dramatic near miss.\"],\n critical: [\"A critical hit! The bards are taking notes.\", \"Natural twenty—legendary timing.\", \"The D20 of Fate has opened the vault.\"],\n defeat: [\"A character falls, but the story continues.\", \"The HP bar has entered the underworld.\", \"A dramatic collapse worthy of the final act.\"],\n victory: [\"Victory belongs to the last character standing.\", \"The winner claims the tavern bragging rights.\", \"The campaign chronicle gains a new legend.\"],\n };\n const pool = lines[stage] ?? lines.hit;\n return pool[Math.floor(Math.random() * pool.length)];\n}\n\nexport function combatStats(c: Character) {\n const ability = Math.max(c.scores.STR, c.scores.DEX);\n const mod = modifier(ability);\n return { attack: 10 + mod + c.proficiency, mod, die: 8 };\n}\n\nexport function isBotAccount(username: string, userId: string, botUserId: string) {\n const normalized = username.toLowerCase();\n const configured = (Deno.env.get(\"BOT_USERNAMES\") ?? \"\")\n .split(\",\")\n .map((x) => x.trim().toLowerCase())\n .filter(Boolean);\n return (\n userId === botUserId ||\n knownBotAccounts.has(normalized) ||\n configured.includes(normalized) ||\n normalized.endsWith(\"bot\")\n );\n}\n\nexport function hasModeratorBadge(event: any) {\n const badges = [...(event?.badges ?? []), ...(event?.source_badges ?? [])];\n return badges.some((badge: any) => badge.set_id === \"moderator\" || badge.set_id === \"broadcaster\");\n}\n\nexport type CheckKind =\n | { type: \"save\"; ability: Ability; label: string }\n | { type: \"skill\"; ability: Ability; label: string };\n\n/**\n * Resolve chat input like \"dex\", \"dexterity\", or \"stealth\" to a saving-throw\n * ability or a skill (and its governing ability). Returns null for anything\n * that isn't a recognized ability/skill name (e.g. a dice expression).\n */\nexport function resolveCheckKind(input: string): CheckKind | null {\n const key = input.trim().toLowerCase();\n if (!key) return null;\n\n const ability = abilityAliases[key];\n if (ability) {\n return { type: \"save\", ability, label: `${abilityFullNames[ability]} Saving Throw` };\n }\n\n const collapsed = key.replace(/\\s+/g, \"\");\n const skillEntry = Object.entries(skillAbilities).find(([name]) => name.replace(/\\s+/g, \"\") === collapsed);\n if (skillEntry) {\n const [name, skillAbility] = skillEntry;\n const label = name\n .split(\" \")\n .map((word, i) => (i > 0 && word === \"of\" ? word : word.charAt(0).toUpperCase() + word.slice(1)))\n .join(\" \");\n return { type: \"skill\", ability: skillAbility, label: `${label} Check` };\n }\n\n return null;\n}\n\nexport function rollDice(input = \"1d20\", customLabel?: string) {\n const expression = input.trim() || \"1d20\";\n const m = expression.match(/^(\\d+)d(\\d+)([+-]\\d+)?$/i);\n if (!m) return null;\n const n = +m[1],\n sides = +m[2],\n mod = m[3] ? +m[3] : 0;\n if (n > 100 || sides > 1000) return null;\n const rolls = Array.from({ length: n }, () => 1 + Math.floor(Math.random() * sides));\n const rawTotal = rolls.reduce((a, b) => a + b, 0);\n const total = rawTotal + mod;\n const label = customLabel ?? (expression.toLowerCase() === \"1d20\" ? \"D20 of Fate\" : \"Dice roll\");\n const rawD20 = n === 1 && sides === 20 ? rolls[0] : null;\n const puns =\n rawD20 === 20\n ? [\n \"Natural 20! The bards are already writing the song.\",\n \"Critical success! Even the dice wanted to be legendary.\",\n \"The gods have stamped this roll approved.\",\n \"A natural 20—today, the dungeon fears you.\",\n \"Fate has opened the treasure chest of victory.\",\n ]\n : rawD20 === 1\n ? [\n \"Natural 1! The floor wins this round.\",\n \"Critical fumble! Somewhere, a goblin just gained confidence.\",\n \"The dice have requested a short rest.\",\n \"A natural 1—excellent roleplay opportunity incoming.\",\n \"Fate rolled a banana peel under your boots.\",\n ]\n : total >= 17\n ? [\n \"That roll arrived wearing a hero’s cape.\",\n \"The adventure is leaning dramatically in your favor.\",\n \"Even the dungeon master raised an eyebrow at that one.\",\n \"A mighty swing of the fate hammer.\",\n \"The prophecy is looking unusually promising.\",\n ]\n : total <= 4\n ? [\n \"That roll took a wrong turn at the tavern.\",\n \"The dungeon master is trying very hard not to smile.\",\n \"Fate has assigned you a side quest.\",\n \"The dice are demanding better snacks.\",\n \"That result has strong mimic-energy.\",\n ]\n : [\n \"Fate has spoken—no rerolling destiny.\",\n \"The dungeon master may now pretend this was planned.\",\n \"That roll wandered in from a side quest.\",\n \"Somewhere, a bard is composing a song about this.\",\n \"Your modifiers are doing the heavy lifting.\",\n \"The goblins are taking notes.\",\n \"The prophecy remains open.\",\n \"Fate rolled over and asked for advantage.\",\n \"The initiative order has noticed you.\",\n \"A perfectly serviceable bit of adventuring.\",\n \"The dice have offered a plot twist.\",\n \"The tavern is buying the next round.\",\n ];\n const pun = puns[Math.floor(Math.random() * puns.length)];\n return `🎲 ${label}: ${expression} → [${rolls.join(\", \")}]${mod ? (mod > 0 ? `+${mod}` : mod) : \"\"} = ${total}. ${pun}`;\n}\n\n// Yes/No fate questions, e.g. \"!roll is enya going to die this time?\" — a\n// separate flavor pool from the dice puns above since these need to echo\n// the asker's question back into a verdict rather than a roll total.\nconst FATE_YES: Array<(q: string) => string> = [\n (q) => `🎲 Natural 20! The fates favor a YES on \"${q}\"`,\n (q) => `📜 You cast Augury and receive a weal omen — YES, regarding \"${q}\"`,\n (q) => `🔮 The crystal ball clears... it shows YES for \"${q}\"`,\n (q) => `⚖️ The DM rolls behind the screen, smirks, and says YES to \"${q}\"`,\n (q) => `🃏 You draw from the Deck of Many Things: the Sun. YES — \"${q}\" comes to pass`,\n (q) => `👁️ The beholder's central eye blinks in approval: YES on \"${q}\"`,\n (q) => `✨ The bones fall in a favorable pattern. YES, so it is written — \"${q}\"`,\n (q) => `🗡️ Even a rogue with disadvantage nails this one. YES to \"${q}\"`,\n];\n\nconst FATE_NO: Array<(q: string) => string> = [\n (q) => `💀 Natural 1! Critical fumble — the answer is NO on \"${q}\"`,\n (q) => `📜 Augury returns a woe omen. NO, regarding \"${q}\"`,\n (q) => `🔮 The crystal ball clouds over... NO for \"${q}\"`,\n (q) => `⚖️ The DM shakes their head slowly. NO to \"${q}\"`,\n (q) => `🃏 You draw from the Deck of Many Things: the Void. NO — \"${q}\" will not come to pass`,\n (q) => `👁️ The beholder's central eye narrows: NO on \"${q}\"`,\n (q) => `✨ The bones scatter unfavorably. NO, so it is written — \"${q}\"`,\n (q) => `🛡️ Even a paladin's Lay on Hands can't save this one. NO to \"${q}\"`,\n];\n\nconst MAX_FATE_QUESTION_LEN = 200;\n\n/** A 50/50 D&D-flavored yes/no verdict for a chat-supplied question. */\nexport function rollFate(question: string): string {\n const q = question.trim();\n const displayQuestion = q.length > MAX_FATE_QUESTION_LEN ? q.slice(0, MAX_FATE_QUESTION_LEN) + \"…\" : q;\n const pool = Math.random() < 0.5 ? FATE_YES : FATE_NO;\n const flavor = pool[Math.floor(Math.random() * pool.length)];\n return flavor(displayQuestion);\n}\n\n// !hug — an undocumented, purely warm/supportive command. No dice, no\n// mechanics, no game state. Kept out of !dndbothelp and the guide on\n// purpose (like !connections) so it stays a small, genuine gesture rather\n// than a \"feature\" people grind or spam for a reaction.\nconst HUG_LINES: string[] = [\n \"You're doing better than you think.\",\n \"Whatever today looked like, you showed up — that counts.\",\n \"Take your time. There's no clock on this.\",\n \"You're allowed to have a hard day.\",\n \"You're not alone in this, even when it feels that way.\",\n \"You've got people in your corner.\",\n \"Rest is productive too.\",\n \"You matter, plain and simple.\",\n \"Small steps still count as moving forward.\",\n \"Someone's glad you're here.\",\n \"It's okay to not have it all figured out yet.\",\n \"You're allowed to be proud of the quiet wins too.\",\n];\n\n/** A gentle, sincere hug — optionally directed at another chatter. */\nexport function rollHug(display: string, target?: string | null): string {\n const line = pick(HUG_LINES);\n return target\n ? `🤗 @${display} wraps @${target} in a warm hug. \"${line}\"`\n : `🤗 The guild wraps @${display} in a warm hug. \"${line}\"`;\n}\n\n// Auto thank-you for new and renewed Twitch subscriptions — see main.ts's\n// EventSub handling for \"channel.subscribe\" / \"channel.subscription.message\".\nconst SUB_TIER_NAMES: Record = {\n \"1000\": \"Tier 1\",\n \"2000\": \"Tier 2\",\n \"3000\": \"Tier 3\",\n Prime: \"Prime\",\n};\n\nfunction subTierLabel(tier?: string | null): string {\n if (!tier) return \"\";\n const label = SUB_TIER_NAMES[tier];\n return label ? ` (${label})` : \"\";\n}\n\nconst NEW_SUB_LINES: Array<(name: string, tier: string) => string> = [\n (name, tier) => `⚔️ @${name} has sworn fealty to the guild${tier}! Welcome to the ranks, adventurer — may your rolls be ever favorable.`,\n (name, tier) => `📜 A new name is inked into the guild roster: @${name}${tier}. The hall is a little brighter for it.`,\n (name, tier) => `🛡️ @${name} raises the guild banner for the first time${tier}. Glory and good company await.`,\n (name, tier) => `🎲 @${name} has joined the party${tier}! Grab a seat by the fire — the story's better with you in it.`,\n (name, tier) => `🏰 The gates open for a new adventurer: welcome, @${name}${tier}. Here's to the campaign ahead.`,\n (name, tier) => `✨ @${name} takes up the guild's oath${tier}. May your natural 20s find you often.`,\n];\n\nconst RESUB_LINES: Array<(name: string, months: number, tier: string) => string> = [\n (name, months, tier) => `🔥 @${name} renews their pact with the guild${tier} — ${months} month${months === 1 ? \"\" : \"s\"} strong and still adventuring.`,\n (name, months, tier) => `📖 Another chapter for @${name}${tier}: ${months} month${months === 1 ? \"\" : \"s\"} in the guild, and the story keeps going.`,\n (name, months, tier) => `🛡️ @${name} re-ups their oath to the guild${tier} — ${months} month${months === 1 ? \"\" : \"s\"} of loyalty, and counting.`,\n (name, months, tier) => `🎉 @${name} has stuck with the guild for ${months} month${months === 1 ? \"\" : \"s\"}${tier}. That's a real friendship roll, not just a lucky one.`,\n (name, months, tier) => `⚔️ ${months} month${months === 1 ? \"\" : \"s\"} deep and @${name} is still here${tier} — the guild remembers its own.`,\n];\n\n/** Thank-you for a brand-new subscription (channel.subscribe). */\nexport function rollNewSubThankYou(displayName: string, tier?: string | null): string {\n return pick(NEW_SUB_LINES)(displayName, subTierLabel(tier));\n}\n\n/** Thank-you for a renewed/resub with a shared message (channel.subscription.message). */\nexport function rollResubThankYou(displayName: string, months: number, tier?: string | null): string {\n const safeMonths = Number.isFinite(months) && months > 0 ? Math.floor(months) : 1;\n return pick(RESUB_LINES)(displayName, safeMonths, subTierLabel(tier));\n}\n\nconst GIFT_SUB_LINES: Array<(name: string, count: number, tier: string) => string> = [\n (name, count, tier) => `🎁 @${name} just gifted ${count} membership${count === 1 ? \"\" : \"s\"} to the guild${tier}! A round of applause for the guild's newest patron of generosity.`,\n (name, count, tier) => `💰 @${name} paid ${count} adventurer${count === 1 ? \"'s\" : \"s'\"} way into the guild${tier}. That's the kind of coin a bard writes songs about.`,\n (name, count, tier) => `✨ @${name} sponsored ${count} new guild membership${count === 1 ? \"\" : \"s\"}${tier} — true guild patronage.`,\n (name, count, tier) => `🛡️ @${name} covered the guild dues for ${count} adventurer${count === 1 ? \"\" : \"s\"}${tier}. The hall remembers acts like this.`,\n];\n\nconst ANON_GIFT_SUB_LINES: Array<(count: number, tier: string) => string> = [\n (count, tier) => `🎁 A mysterious benefactor just gifted ${count} membership${count === 1 ? \"\" : \"s\"} to the guild${tier}, no name given. The guild thanks you all the same.`,\n (count, tier) => `💰 An anonymous patron paid the guild dues for ${count} adventurer${count === 1 ? \"\" : \"s\"}${tier}. Whoever you are — well met.`,\n];\n\nconst GIFTED_WELCOME_LINES: Array<(name: string, tier: string) => string> = [\n (name, tier) => `🎁 @${name} joins the guild courtesy of a fellow adventurer's generosity${tier}. Welcome to the ranks — your gear's already paid for.`,\n (name, tier) => `⚔️ @${name} has been sponsored into the guild${tier}! Someone believed you belonged here — now go prove them right.`,\n (name, tier) => `📜 @${name}'s name goes on the roster, gifted by a guildmate${tier}. Welcome aboard.`,\n];\n\n/** Thank-you for a gift-sub batch (channel.subscription.gift). Pass name=null for anonymous gifts. */\nexport function rollGiftSubThankYou(gifterName: string | null, count: number, tier?: string | null): string {\n const safeCount = Number.isFinite(count) && count > 0 ? Math.floor(count) : 1;\n return gifterName\n ? pick(GIFT_SUB_LINES)(gifterName, safeCount, subTierLabel(tier))\n : pick(ANON_GIFT_SUB_LINES)(safeCount, subTierLabel(tier));\n}\n\n/** Welcome for the recipient of a gifted sub (channel.subscribe with is_gift=true). */\nexport function rollGiftedSubWelcome(recipientName: string, tier?: string | null): string {\n return pick(GIFTED_WELCOME_LINES)(recipientName, subTierLabel(tier));\n}\n\nexport function compactText(value: unknown, max = 240) {\n return String(value ?? \"\")\n .replace(/\\s+/g, \" \")\n .replace(/<[^>]+>/g, \"\")\n .trim()\n .slice(0, max);\n}\n\nexport function splitChatMessage(text: string, max = 300) {\n const parts: string[] = [];\n let remaining = text.trim();\n while (remaining.length > max) {\n let cut = remaining.lastIndexOf(\" \", max);\n if (cut < 1) cut = max;\n parts.push(remaining.slice(0, cut).trim());\n remaining = remaining.slice(cut).trim();\n }\n if (remaining) parts.push(remaining);\n return parts;\n}\n\nexport function firstAlive(members: string[], hp: Record) {\n return members.findIndex((name) => Number(hp[name]) > 0);\n}\n\nexport function logRowText(r: any) {\n return `${new Date(Number(r.created_at)).toISOString()} | @${r.username} | ${r.action} | ${r.detail}`;\n}\n","label",[147],"59577770-67f7-4ff3-8c89-931f8504f98d","types.ts","760b7a24-a4d9-11f1-9139-1607ee4eb77e",225,["D",1788404439816],7,"// Shared type definitions for GuildScribe\n\nexport type Ability = \"STR\" | \"DEX\" | \"CON\" | \"INT\" | \"WIS\" | \"CHA\";\n\nexport type Race = {\n subraces: string[];\n bonuses: Partial>;\n speed: number;\n traits: string[];\n};\n\nexport type ClassData = {\n priority: Ability[];\n savingThrows: Ability[];\n hitDie: number;\n calling: string;\n};\n\nexport type Character = {\n username: string;\n race: string;\n subrace: string | null;\n cls: string;\n level: number;\n xp: number;\n scores: Record;\n speed: number;\n hpMax: number;\n hpCurrent: number;\n proficiency: number;\n traits: string[];\n spells: string[];\n items: string[];\n feats: string[];\n abilities: string[];\n};\n\nexport type CreationSession = {\n broadcasterId: string;\n username: string;\n step: string;\n race?: string | null;\n subrace?: string | null;\n cls?: string | null;\n scores?: number[] | Record | null;\n // BG3-flavored creation only (!bg3) — unused by the standard !newchar wizard.\n subclass?: string | null;\n background?: string | null;\n alignment?: string | null;\n hook?: string | null;\n};\n",[158],"3e71c21d-9bec-4690-ae72-8ecaae2e8783","twitch.ts","9c5a8652-a4d9-11f1-b87e-1607ee4eb77e",224,["D",1788404439512],11,"// Twitch API helpers (tokens, chat, EventSub)\n\nimport { MAX_LOOKUP_MESSAGE_LENGTH } from \"./data.ts\";\nimport { splitChatMessage } from \"./utils.ts\";\n\nexport const env = (name: string) => {\n const value = Deno.env.get(name);\n if (!value) throw new Error(`Missing environment variable: ${name}`);\n return value;\n};\n\nconst CHAT_MAX = Math.min(MAX_LOOKUP_MESSAGE_LENGTH, 480);\n// Rules need more parts than other lookups; spells use sendSpellSections separately.\nconst MAX_PARTS = 5;\nconst PART_DELAY_MS = 450;\n// Twitch chat-send limits are shared by the bot account. Keep a conservative\n// global queue by default; operators can lower this after Twitch grants the\n// appropriate bot rate limit/verification.\nconst GLOBAL_CHAT_MIN_INTERVAL_MS = Math.max(50, Number(Deno.env.get(\"CHAT_GLOBAL_MIN_INTERVAL_MS\") ?? \"1600\"));\nlet nextChatSendAt = 0;\n\nasync function waitForGlobalChatSlot() {\n const now = Date.now();\n const wait = Math.max(0, nextChatSendAt - now);\n nextChatSendAt = Math.max(now, nextChatSendAt) + GLOBAL_CHAT_MIN_INTERVAL_MS;\n if (wait) await sleep(wait);\n}\n\nfunction sleep(ms: number) {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** Cap + truncate parts so multi-message lookups always finish. */\nfunction prepareParts(text: string, maxLen = CHAT_MAX, maxParts = MAX_PARTS): string[] {\n let parts = splitChatMessage(text, maxLen).map((p) => p.slice(0, maxLen));\n if (parts.length > maxParts) {\n parts = parts.slice(0, maxParts);\n const last = parts[parts.length - 1];\n parts[parts.length - 1] = last.slice(0, Math.max(0, maxLen - 12)).trimEnd() + \" …(cut)\";\n }\n return parts.filter((p) => p.length > 0);\n}\n\n/** Keep URL on the first chat part so it is never dropped. */\nfunction preferLinkInFirstPart(parts: string[]): string[] {\n if (parts.length <= 1) return parts;\n const linkMatch = parts.join(\" \").match(/https?:\\/\\/[^\\s|]+/);\n if (!linkMatch) return parts;\n const link = linkMatch[0];\n if (parts[0].includes(link)) return parts;\n const prefix = `🔗 ${link} | `;\n let first = prefix + parts[0].replace(/🔗\\s*https?:\\/\\/[^\\s|]+\\s*\\|\\s*/g, \"\");\n if (first.length > CHAT_MAX) first = first.slice(0, CHAT_MAX - 1) + \"…\";\n const rest = parts\n .slice(1)\n .map((p) => p.replace(link, \"\").replace(/\\s*\\|\\s*$/g, \"\").trim())\n .filter(Boolean);\n return [first, ...rest];\n}\n\nexport async function sendChatMessage(text: string, broadcasterId: string) {\n const message = text.slice(0, 500);\n if (!message.trim()) return true;\n try {\n await waitForGlobalChatSlot();\n const send = async (token: string) =>\n fetch(\"https://api.twitch.tv/helix/chat/messages\", {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${token}`,\n \"Client-Id\": env(\"TWITCH_CLIENT_ID\"),\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n broadcaster_id: broadcasterId,\n sender_id: env(\"TWITCH_BOT_ID\"),\n message,\n }),\n });\n\n let res = await send(await getAppToken());\n if (res.status === 401) {\n // Cached token was rejected (expired/revoked) — drop it and get a fresh one, once.\n invalidateAppToken();\n await waitForGlobalChatSlot();\n res = await send(await getAppToken());\n }\n if (!res.ok && res.status !== 429) {\n console.error(`Twitch chat send failed: ${res.status}`);\n }\n // Brief backoff on rate limit so following parts can still send\n if (res.status === 429) {\n await sleep(1100);\n return false;\n }\n return res.ok;\n } catch (err) {\n console.error(\"sendChatMessage failed\", err);\n return false;\n }\n}\n\nexport async function sendChatMessages(\n text: string,\n broadcasterId: string,\n opts?: { maxParts?: number },\n) {\n const maxParts = opts?.maxParts ?? MAX_PARTS;\n let parts = prepareParts(text, CHAT_MAX, maxParts);\n parts = preferLinkInFirstPart(parts);\n for (let i = 0; i < parts.length; i++) {\n const ok = await sendChatMessage(parts[i], broadcasterId);\n if (!ok && i < parts.length - 1) {\n await sleep(700);\n await sendChatMessage(parts[i], broadcasterId);\n }\n if (i < parts.length - 1) await sleep(PART_DELAY_MS);\n }\n}\n\nexport async function sendSpellSections(sections: string[], display: string, broadcasterId: string) {\n // Flatten sections into a limited stream of chat parts (avoid dropping mid-spell)\n const combined: string[] = [];\n for (const section of sections) {\n combined.push(...prepareParts(`@${display} ${section}`, CHAT_MAX, 3));\n }\n const parts = combined.slice(0, MAX_PARTS);\n if (combined.length > MAX_PARTS && parts.length) {\n parts[parts.length - 1] =\n parts[parts.length - 1].slice(0, Math.max(0, CHAT_MAX - 12)).trimEnd() + \" …(cut)\";\n }\n for (let i = 0; i < parts.length; i++) {\n await sendChatMessage(parts[i], broadcasterId);\n if (i < parts.length - 1) await sleep(PART_DELAY_MS);\n }\n}\n\n// App access tokens (client_credentials) are valid for ~hours, not one request —\n// cache and reuse instead of re-fetching one from Twitch on every chat send.\nlet cachedAppToken: { token: string; expiresAt: number } | null = null;\n\nexport function invalidateAppToken() {\n cachedAppToken = null;\n}\n\nexport async function getAppToken() {\n if (cachedAppToken && Date.now() < cachedAppToken.expiresAt) {\n return cachedAppToken.token;\n }\n const body = new URLSearchParams({\n client_id: env(\"TWITCH_CLIENT_ID\"),\n client_secret: env(\"TWITCH_CLIENT_SECRET\"),\n grant_type: \"client_credentials\",\n });\n const res = await fetch(\"https://id.twitch.tv/oauth2/token\", {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n body,\n });\n if (!res.ok) throw new Error(`App token failed: ${res.status} ${await res.text()}`);\n const data = await res.json();\n const expiresInMs = Number(data.expires_in ?? 0) * 1000;\n // Refresh a minute early so we never send a request with a token that\n // expires mid-flight.\n cachedAppToken = {\n token: data.access_token as string,\n expiresAt: Date.now() + Math.max(0, expiresInMs - 60_000),\n };\n return cachedAppToken.token;\n}\n\nexport async function exchangeCode(code: string, redirectUri: string) {\n const body = new URLSearchParams({\n client_id: env(\"TWITCH_CLIENT_ID\"),\n client_secret: env(\"TWITCH_CLIENT_SECRET\"),\n code,\n grant_type: \"authorization_code\",\n redirect_uri: redirectUri,\n });\n const res = await fetch(\"https://id.twitch.tv/oauth2/token\", {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n body,\n });\n if (!res.ok) throw new Error(`OAuth exchange failed: ${res.status} ${await res.text()}`);\n return await res.json();\n}\n\nasync function createEventSubSubscription(\n type: string,\n version: string,\n condition: Record,\n callbackUrl: string,\n) {\n const appToken = await getAppToken();\n const res = await fetch(\"https://api.twitch.tv/helix/eventsub/subscriptions\", {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${appToken}`,\n \"Client-Id\": env(\"TWITCH_CLIENT_ID\"),\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n type,\n version,\n condition,\n transport: {\n method: \"webhook\",\n callback: callbackUrl,\n secret: env(\"EVENTSUB_SECRET\"),\n },\n }),\n });\n const text = await res.text();\n if (!res.ok) throw new Error(`EventSub subscription failed (${type}): ${res.status} ${text}`);\n return JSON.parse(text).data[0];\n}\n\nexport async function createChatSubscription(broadcasterId: string, callbackUrl: string) {\n return createEventSubSubscription(\n \"channel.chat.message\",\n \"1\",\n { broadcaster_user_id: broadcasterId, user_id: env(\"TWITCH_BOT_ID\") },\n callbackUrl,\n );\n}\n\n// New subscriptions (channel.subscribe) and renewals shared with a message\n// in chat (channel.subscription.message) — used to power the D&D-themed\n// !hug-style auto thank-you. Both require the broadcaster to have granted\n// the \"channel:read:subscriptions\" scope during OAuth; older connections\n// made before that scope was requested will need to reconnect for these to\n// take effect. Best-effort: callers should not fail the whole connect flow\n// if these throw (e.g. scope not yet granted).\nexport async function createSubEventSubscriptions(broadcasterId: string, callbackUrl: string) {\n const [newSub, resub, gift] = await Promise.all([\n createEventSubSubscription(\"channel.subscribe\", \"1\", { broadcaster_user_id: broadcasterId }, callbackUrl),\n createEventSubSubscription(\"channel.subscription.message\", \"1\", { broadcaster_user_id: broadcasterId }, callbackUrl),\n createEventSubSubscription(\"channel.subscription.gift\", \"1\", { broadcaster_user_id: broadcasterId }, callbackUrl),\n ]);\n return { newSub, resub, gift };\n}\n\nexport async function deleteEventSubSubscription(subscriptionId: string) {\n if (!subscriptionId) return true;\n const appToken = await getAppToken();\n const res = await fetch(`https://api.twitch.tv/helix/eventsub/subscriptions?id=${encodeURIComponent(subscriptionId)}`, {\n method: \"DELETE\",\n headers: { Authorization: `Bearer ${appToken}`, \"Client-Id\": env(\"TWITCH_CLIENT_ID\") },\n });\n if (res.status === 404) return true;\n if (!res.ok) throw new Error(`EventSub deletion failed: ${res.status} ${await res.text()}`);\n return true;\n}\n\n/** Constant-time string compare — doesn't branch/short-circuit on content,\n * only on length (which isn't secret), so it doesn't leak how many leading\n * characters of the signature matched via response timing. */\nfunction timingSafeEqual(a: string, b: string): boolean {\n if (a.length !== b.length) return false;\n let diff = 0;\n for (let i = 0; i < a.length; i++) {\n diff |= a.charCodeAt(i) ^ b.charCodeAt(i);\n }\n return diff === 0;\n}\n\nexport async function verifyEventSub(req: Request, rawBody: string) {\n const id = req.headers.get(\"Twitch-Eventsub-Message-Id\") ?? \"\";\n const timestamp = req.headers.get(\"Twitch-Eventsub-Message-Timestamp\") ?? \"\";\n const received = req.headers.get(\"Twitch-Eventsub-Message-Signature\") ?? \"\";\n if (!id || !timestamp || !received) return false;\n const receivedAt = Date.parse(timestamp);\n if (!Number.isFinite(receivedAt) || Math.abs(Date.now() - receivedAt) > 10 * 60 * 1000) return false;\n const key = await crypto.subtle.importKey(\n \"raw\",\n new TextEncoder().encode(env(\"EVENTSUB_SECRET\")),\n { name: \"HMAC\", hash: \"SHA-256\" },\n false,\n [\"sign\"],\n );\n const signature = new Uint8Array(\n await crypto.subtle.sign(\"HMAC\", key, new TextEncoder().encode(id + timestamp + rawBody)),\n );\n const hex = [...signature].map((b) => b.toString(16).padStart(2, \"0\")).join(\"\");\n const expected = `sha256=${hex}`;\n return timingSafeEqual(expected, received);\n}\n",[166],"0bf7fa69-6ade-4bab-a977-be7e799db745","pages.ts","a605108c-a4d9-11f1-a673-1607ee4eb77e",237,["D",1788488650767],25,"// HTML page rendering for the web UI\n\nimport type { Character } from \"./types.ts\";\nimport { abilityNames } from \"./data.ts\";\nimport { modifier, formatRaceName, escapeHtml } from \"./utils.ts\";\nimport type { MapRow, MapToken } from \"./db.ts\";\nimport { MAP_TEMPLATES, TERRAINS, tokenColor } from \"./maps.ts\";\n\nexport function page(title: string, body: string) {\n return new Response(\n `${title}${body}`,\n { headers: { \"Content-Type\": \"text/html; charset=utf-8\" } },\n );\n}\n\nexport function renderCharacterPage(c: Character) {\n const statLine = abilityNames\n .map(\n (a) =>\n `

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

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

${escapeHtml(c.username)}

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

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

${statLine}

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

`;\n}\n\n// Not currently wired to any route — the activity log is only exposed via\n// the in-chat !logs command, which is scoped to one channel and restricted\n// to that channel's broadcaster/moderators. Kept here in case an\n// authenticated (per-channel, per-steward) web view is added later; do not\n// route this to a public GET endpoint without adding auth + per-channel scoping.\nexport function renderLogsPage(rows: any[]) {\n const lines = rows\n .map(\n (r: any) =>\n `${escapeHtml(new Date(Number(r.created_at)).toLocaleString())}${escapeHtml(r.username || \"unknown\")}${escapeHtml(r.broadcaster_id || \"\")}${escapeHtml(r.action || \"\")}${escapeHtml(r.detail || \"\")}`,\n )\n .join(\"\");\n return `

GuildScribe Activity Logs

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

Back to guide · Bot home

${lines || ``}

Timestamp	Username	Channel ID	Action	Details
No activity recorded yet.

`;\n}\n\nfunction renderMapTemplateList(): string {\n return Object.values(MAP_TEMPLATES)\n .map(\n (t) =>\n `

${escapeHtml(t.name)} — ${escapeHtml(t.label)} (${t.width}x${t.height}): ${escapeHtml(t.description)}

`,\n )\n .join(\"\");\n}\n\nexport function renderGuidePage() {\n return `

Guild hall · D&D 5e

GuildScribe Codex

Welcome to the guild hall. Herein lie the rites of character, company, dice, duels, and the archives of the SRD.

Raise your banner Support the Guild Privacy Terms

Entering the hall: Grant the scribes a voice with /mod GuildScribeBot, then use !help for the welcome guide or !dndbothelp to browse this reference from chat.

Adventurer’s parchment

Create and view

!newchar

Start a guided chat wizard. Reply with !answer <choice> to select a race, subrace, class, and ability scores. Use !cancel to abandon the wizard mid-way.

!bg3

Rolls a random Baldur's Gate 3 style race and class, then lets you assign ability scores under BG3 point-buy rules (base 8, cap 15, 27-point budget) with !answer <STR> <DEX> <CON> <INT> <WIS> <CHA>. Confirm with !answer yes to save it as your character and get a link to its page. Use !cancel to abandon.

!createchar

Immediately create a level 1 character.

!createchar @username

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

!char!char @username

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

Manage progress

!levelup!levelup +2!levelup -1

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

!hp +5!hp -3

Adjust current HP within the character’s valid range.

Save and restore

!savechar!loadchar!resetchar

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

Fate’s dice

!d20!d20 @username!roll!r

Call upon the D20 of Fate. Use !d20 @username to roll for another adventurer.

!roll NdS[+/-M]

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

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

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

!roll dex!roll strength

Ability saving throw. Uses your saved character's ability modifier, plus proficiency if your class is proficient in that save. Works with abbreviations (str, dex, con, int, wis, cha) or full names.

!roll stealth!roll animal handling

Skill check. Uses your saved character's modifier for that skill's governing ability. Add @username to roll using someone else's saved character, e.g. !roll @friend perception.

!roll <question>?

Consult fate for a yes-or-no verdict, delivered with a random D&D-flavored omen (natural 20s, Augury, a beholder's judgment, the Deck of Many Things, and more). Example: !roll is enya going to die this time?

Baldur's Gate 3

Roll a character (saved)

!bg3

Rolls a random BG3-style race and class, then lets you assign ability scores under BG3 point-buy rules (base 8, cap 15, 27-point budget) with !answer <STR> <DEX> <CON> <INT> <WIS> <CHA>. Confirm with !answer yes to save it as your character and get a link to its page — see Adventurer's parchment for the rest of the character commands.

Roll a character (flavor only)

!bg3roll

Rolls a full BG3-flavored character in one line: race (with subrace where BG3 has one, like High Elf or Lolth-Sworn Drow), class and subclass, background, alignment, a BG3-style 27-point point-buy ability spread weighted toward the class's primary stat, and a one-line origin hook straight off the Nautiloid.

Companion & origin

!bg3companion

Rolls which BG3 companion you're traveling with — their role, a one-line personality blurb, and an iconic line.

!bg3origin

Casts you as one of the six canonical BG3 Origin Characters — or the Dark Urge — for this run, with their signature hook.

Loot & camp

!bg3loot

Rolls a random magic item drop with a BG3-style rarity tier, from Common up through Legendary.

!bg3camp

Rolls a random camp-night vignette featuring one of the companions.

Knowledgebase

!bg3lookup <name>

Searches a hand-curated Baldur's Gate 3 knowledgebase — companions, origins, classes, races, locations, factions, deities, notable villains, and legendary items — and returns a short blurb with a link to bg3.wiki. Examples: !bg3lookup astarion, !bg3lookup moonrise towers.

!bg3lookup <category> <name>

Narrow the search to one category, e.g. !bg3lookup faction zhentarim or !bg3lookup location grymforge. A bare !bg3lookup lists all recognized categories.

!bg3roll, !bg3companion, !bg3origin, !bg3loot, and !bg3camp are flavor rolls only — they print straight to chat and aren't saved, and none of them touch your !createchar/!char sheet. !bg3 is different — it saves a real character (see the parchment section above). !bg3lookup is also different: it's a reference lookup against the static knowledgebase above, not a roll, so the same query always returns the same entry.

Guild archives

Consult the SRD archives by name. Optional +N upcasts a spell or adds an item attack/damage bonus. Incomplete commands (e.g. bare !rules) return usage tips.

Spells, classes & rules

!rules <topic>!rule <topic>

Summarize a rule (up to 3 messages) with a public link. Examples: !rules magic, !rules combat, !rule advantage.

!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.

Arena, wilds & the company

The initiative tracker is restricted to the broadcaster or a moderator. Duels and hunts are open to any adventurer with a saved character.

!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.

Parties

!party create <name>!party join <name>!party invite @user [name]!party accept [name]!party decline [name]!party list [name]

!party list shows each of your companies with leader and members. An invite only adds someone once they !party accept it — the party name is optional if they only have one pending invite.

!party leave <name>!party disband <name>

Create a party (you become leader and member), invite friends, and list rosters. Party name is optional on invite if you only belong to one party.

Player duels & hunts

Auto challenges resolve when accepted. Classic modes use turn-based attack. Solo !dndduel fights a level-scaled monster (auto); !dndduel monster is classic. Party hunts fight a shared monster and award XP on victory. PvP gives no XP.

Battle maps

Create & view

!map create <name> [WxH] [template]

Mod/broadcaster only. Makes a new grid map (default 10x8, up to 20x20), starting as all grass — or stamped with a template's terrain if you name one, e.g. !map create tav1 tavern or !map create tav1 14x10 tavern.

!map list!map view <name>

List every map in the channel, or post a link to one — the map page is a live, auto-refreshing visual grid.

!map delete <name>!map remove <name>

Mod/broadcaster only. Deletes the map along with its terrain and every character token on it — this can't be undone.

Templates

!map templates

Lists every ready-made layout you can stamp onto a new map with !map create <name> [WxH] <template>. A template sets its own default size (overridable) and pre-paints walls, doors, hazards, and features — a starting point you can still touch up with !map paint/!map fill afterward.

${renderMapTemplateList()}

Edit the terrain

!map terrains

Lists every terrain type (grass, forest, water, sand, mountain, road, floor, wall, door, trap, lava, void) — some, like water/wall/mountain/lava/void, block tokens from standing there.

!map fill <name> <terrain>

Mod/broadcaster only. Resets the whole grid to one terrain.

!map paint <name> <x> <y> <terrain>

Mod/broadcaster only. Sets a single cell, e.g. !map paint dungeon1 4 2 wall. Coordinates start at (1,1) in the top-left.

Place & move characters

!map addchar <name> [x y]

Puts your saved character on the map, at the coordinates you give or the first free cell otherwise.

!map addchar <name> @user [x y]

Mod/broadcaster only: place someone else's character.

!map move <name> <x> <y>!map move <name> @user <x> <y>

Move a token; the second form (moving someone else) is mod/broadcaster only.

!map removechar <name> [@user]

Take a character off the map.

Map creation, terrain painting, and moving someone else's token are restricted to the broadcaster/moderators, the same as the rest of the guild's shared state; everyone can place and move their own character.

Onboarding and support

In chat

!help

Welcome to the guild hall and a path to begin your legend.

!guide!link

Post the Guild Codex URL in chat.

!dndbothelp

List codex chapters.

Expand one of: !dndbothelp dice, !dndbothelp character, !dndbothelp party, !dndbothelp combat, !dndbothelp lookup, !dndbothelp settings.

Connect and support

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

Already connected? Reconnect your channel any time to grant newly requested permissions as GuildScribe gains features — safe to run repeatedly, and won't duplicate or lose your existing data.

Support the project through the donations page.

Moderators can review recent activity for their channel with !logs in chat.

Guild stewards (mod/broadcaster)

!dndbot on!dndbot off!dndbot status!dndbot leave!dndbot leave purge

Enable/disable the bot. The broadcaster can disconnect with !dndbot leave; add purge to delete channel data.

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

`;\n}\n\n// ── Battle maps ──\n\nexport function renderMapPage(map: MapRow, cells: Record, tokens: MapToken[], baseUrl: string) {\n const cellPx = map.width > 16 || map.height > 16 ? 28 : 36;\n const byCell = new Map(tokens.map((t) => [`${t.x},${t.y}`, t]));\n let gridCells = \"\";\n for (let y = 1; y <= map.height; y++) {\n for (let x = 1; x <= map.width; x++) {\n const terrain = cells[`${x},${y}`] ?? map.default_terrain;\n const info = TERRAINS[terrain] ?? TERRAINS.grass;\n const token = byCell.get(`${x},${y}`);\n const initials = token ? escapeHtml((token.display_name || token.username).slice(0, 2).toUpperCase()) : \"\";\n const tokenHtml = token\n ? `

${initials}

`\n : \"\";\n gridCells += `

${tokenHtml}

`;\n }\n }\n const legend = Object.entries(TERRAINS)\n .map(([k, v]) => `${escapeHtml(v.label)}${v.blocksMovement ? \" 🚫\" : \"\"}`)\n .join(\"\");\n const roster = tokens.length\n ? `

${escapeHtml(t.display_name || t.username)} — (${t.x},${t.y})

`\n : `

No characters placed yet. In chat: !map addchar ${escapeHtml(map.map_name)}

`;\n return `${escapeHtml(map.map_name)} — GuildScribe Map

← All maps

🗺️ ${escapeHtml(map.map_name)}

${map.width}×${map.height} — updated ${escapeHtml(new Date(map.updated_at).toLocaleString())}. This page auto-refreshes every 15s.

${gridCells}

${legend}

Characters on this map

${roster}

Edit from Twitch chat: !map paint ${escapeHtml(map.map_name)} x y terrain · !map addchar ${escapeHtml(map.map_name)} · !map move ${escapeHtml(map.map_name)} x y · !map removechar ${escapeHtml(map.map_name)} · full list: !dndbothelp maps

`;\n}\n\nexport function renderMapListPage(maps: MapRow[], broadcasterId: string, baseUrl: string) {\n const items = maps.length\n ? `

${escapeHtml(m.map_name)} (${m.width}×${m.height})

`\n : `

No maps yet. In chat, a moderator can start one with !map create <name> [WxH].

`;\n return `Maps — GuildScribe

🗺️ Maps in this channel

${items}

See !dndbothelp maps in chat for the full command list.

`;\n}\n",[174],"46a39247-7fc6-491f-88ab-87159927b1ec","maps.ts","a4656b02-a743-11f1-b2a7-1607ee4eb77e",238,["D",1788488650689],2,"// GuildScribe — battle maps\n//\n// Chat commands create/edit maps and place character tokens on them; a\n// public, read-only web page (see pages.ts / main.ts route \"/map\") renders\n// the grid visually. Editing (creating a map, painting terrain, deleting a\n// map, and moving someone else's token) stays behind Twitch chat identity\n// (chatterId, verified by EventSub) rather than an open web form — that\n// matches how every other piece of shared channel state in this bot\n// (parties, duels, the initiative tracker) is only ever mutated through an\n// authenticated chat command, never through an unauthenticated web request.\n\nimport { sendChatMessage } from \"./twitch.ts\";\nimport {\n createMap,\n deleteMap,\n fillMap,\n findTokenAt,\n getCharacter,\n getMap,\n getMapCells,\n getMapToken,\n getMapTokens,\n listMaps,\n removeMapToken,\n setMapCell,\n upsertMapToken,\n} from \"./db.ts\";\n\n// ── Map templates ──\n//\n// Publicly listable (!map templates), publicly usable (!map create \n// [WxH]

${escapeHtml(c.username)}

GuildScribe Activity Logs

GuildScribe Codex

Adventurer’s parchment

Create and view

Manage progress

Save and restore

Fate’s dice

Baldur's Gate 3

Roll a character (saved)

Roll a character (flavor only)

Companion & origin

Loot & camp

Knowledgebase

Guild archives

Spells, classes & rules

Equipment and abilities

Races

Arena, wilds & the company

Parties

Player duels & hunts

Battle maps

Create & view

Templates

Edit the terrain

Place & move characters

Onboarding and support

In chat

Connect and support

Guild stewards (mod/broadcaster)

🗺️ ${escapeHtml(map.map_name)}

Characters on this map

🗺️ Maps in this channel

GuildScribe Privacy Policy

How it is used

Retention

Deletion

GuildScribe Terms of Service

GuildScribe Codex

Support the Guild

Ethereum (ETH)

Bitcoin (BTC)

Connection cancelled

The Guild renews your banner

The Guild accepts your banner

Connection failed

GuildScribe

Hi

Diff · v239