@thewaifu/dsh-bot 1.1.1

package/src/shared/mentions.js

@@ -0,0 +1,65 @@
+// "@Name" is read by one rule everywhere: the group host picks who answers with it,
+// and the client draws the same mentions in the bubbles, so what the user sees called
+// is what gets called. Pure, so both sides import it.
+
+export const ALL_WORDS = ['all', 'everyone', '所有人', '全体']
+// A letter, digit, "_" or "-" after a name means a longer word ("@Mi" in "@MiniMax"),
+// and "/", "\" or a "." that goes on into a word mean a path: DSH writes a file
+// reference as "@docs/guide.md", which must not call a Bot named Docs. A letter,
+// digit, "_", "." or "/" before "@" means an address ("a@b", "medium.com/@Writer").
+const NAME_GOES_ON = /^(?:[a-z0-9_\-/\\]|\.[a-z0-9_-])/i
+const ADDRESS_BEFORE = /[a-z0-9_./]/i
+// Code and Markdown links, with or without a title, are literal text.
+const LITERAL = /```[\s\S]*?(?:```|$)|`[^`\n]*`|\[[^\]\n]*\]\([^)\s]*(?:\s+(?:"[^"\n]*"|'[^'\n]*'))?\)/g
+
+const fitsAt = (text, at, word) => text.slice(at, at + word.length).toLowerCase() === word.toLowerCase()
+  && !NAME_GOES_ON.test(text.slice(at + word.length))
+const overlaps = (spans, start, end) => spans.some(span => start < span.end && span.start < end)
+
+// What a Bot may be named: something "@" can call without a second reading.
+export function nameProblem(name) {
+  const text = String(name ?? '').trim()
+  if (text === '') return 'A Bot needs a name'
+  if (/[@`\r\n]/.test(text)) return 'A Bot name cannot contain @, ` or a line break'
+  if (ALL_WORDS.includes(text.toLowerCase())) return `"${text}" calls everyone in a group, so it cannot be a Bot name`
+  return undefined
+}
+
+// DSH writes each referenced conversation into the message once as "@label"; that one
+// occurrence per listed label is a reference, not a call. Longest labels go first so
+// "@K notes" is never read as the label "K".
+export function referenceSpans(text, labels = []) {
+  const spans = []
+  for (const label of [...labels].sort((a, b) => b.length - a.length)) {
+    const mention = `@${label}`
+    for (let at = text.indexOf(mention); at !== -1; at = text.indexOf(mention, at + 1)) {
+      const end = at + mention.length
+      if ((at > 0 && ADDRESS_BEFORE.test(text[at - 1])) || NAME_GOES_ON.test(text.slice(end)) || overlaps(spans, at, end)) continue
+      spans.push({ start: at, end, label })
+      break
+    }
+  }
+  return spans.sort((a, b) => a.start - b.start)
+}
+
+// Every "@Name" and "@all" outside code, links and references, in order. Longest names
+// match first, so "@新 Bot 2" is never "@新 Bot"; a name may hold spaces.
+export function mentionSpans(text, bots, { references = [] } = {}) {
+  const value = String(text ?? '')
+  const skip = [
+    ...[...value.matchAll(LITERAL)].map(match => ({ start: match.index, end: match.index + match[0].length })),
+    ...referenceSpans(value, references),
+  ]
+  const byLength = bots.filter(bot => bot?.name).sort((a, b) => b.name.length - a.name.length)
+  const spans = []
+  for (let at = value.indexOf('@'); at !== -1; at = value.indexOf('@', at + 1)) {
+    if ((at > 0 && ADDRESS_BEFORE.test(value[at - 1])) || overlaps(skip, at, at + 1)) continue
+    const bot = byLength.find(candidate => fitsAt(value, at + 1, candidate.name))
+    const all = bot ? undefined : ALL_WORDS.find(word => fitsAt(value, at + 1, word))
+    if (!bot && !all) continue
+    const end = at + 1 + (bot ? bot.name.length : all.length)
+    spans.push(bot ? { start: at, end, bot } : { start: at, end, all: true })
+    at = end - 1
+  }
+  return spans
+}

package/src/shared/web-port.js

@@ -0,0 +1,26 @@
+import { createServer } from 'node:net'
+
+export const DEFAULT_WEB_PORT = 3082
+
+function canListen(port, host) {
+  return new Promise((resolve, reject) => {
+    const server = createServer()
+    server.unref()
+    server.once('error', (error) => {
+      if (error.code === 'EADDRINUSE' || error.code === 'EACCES') resolve(false)
+      else reject(error)
+    })
+    server.once('listening', () => {
+      server.close(error => error ? reject(error) : resolve(true))
+    })
+    server.listen({ port, host, exclusive: true })
+  })
+}
+
+export async function findAvailablePort(start = DEFAULT_WEB_PORT, host = '127.0.0.1') {
+  if (!Number.isInteger(start) || start < 1 || start > 65535) throw new RangeError('start must be an integer between 1 and 65535')
+  for (let port = start; port <= 65535; port += 1) {
+    if (await canListen(port, host)) return port
+  }
+  throw new Error(`no available TCP port at or above ${start}`)
+}