@owlmeans/bot 0.1.18-rc.2 → 0.1.18

package/build/helpers/rule.js

@@ -1,71 +0,0 @@
-import { BOT_KEYWORD_MAX, BOT_KEYWORDS_MAX, BotMatchMode } from '../consts.js';
-import { BOT_SPACE_PATTERN, BOT_TOKEN_PATTERN } from '../consts.local.js';
-export const createBotRuleHelper = () => {
-    /**
-     * NFKC, then a case fold: upper-casing first maps what lower-casing alone keeps apart (`ß` → `SS`
-     * → `ss`, final `ς` → `Σ` → `σ`), and NFKC again recomposes what the case mapping decomposed.
-     */
-    const fold = (text) => text.normalize('NFKC').toUpperCase().toLowerCase().normalize('NFKC');
-    const tokensOf = (text) => fold(text).match(BOT_TOKEN_PATTERN) ?? [];
-    const spacedOf = (text) => fold(text).replace(BOT_SPACE_PATTERN, ' ').trim();
-    const hasPhrase = (tokens, phrase) => {
-        for (let at = 0; at + phrase.length <= tokens.length; at++) {
-            if (phrase.every((token, offset) => tokens[at + offset] === token)) {
-                return true;
-            }
-        }
-        return false;
-    };
-    const match = (text, rules) => {
-        if (typeof text !== 'string' || text.trim() === '') {
-            return [];
-        }
-        // Folded once per message, never per rule.
-        let tokens;
-        let spaced;
-        const matchesKeyword = (mode, keyword) => {
-            if (mode === BotMatchMode.Contains) {
-                const needle = spacedOf(keyword);
-                spaced ??= spacedOf(text);
-                return needle !== '' && spaced.includes(needle);
-            }
-            const phrase = tokensOf(keyword);
-            tokens ??= tokensOf(text);
-            return phrase.length > 0 && hasPhrase(tokens, phrase);
-        };
-        return rules
-            .filter(rule => rule.enabled)
-            .map((rule) => ({
-            rule,
-            keywords: [...new Set(rule.keywords.filter(keyword => typeof keyword === 'string' && matchesKeyword(rule.mode ?? BotMatchMode.Word, keyword)))],
-        }))
-            .filter(found => found.keywords.length > 0)
-            // Array#sort is stable: rules of equal order keep the order they were given in.
-            .sort((left, right) => (left.rule.order ?? 0) - (right.rule.order ?? 0));
-    };
-    const normalizeKeywords = (list) => {
-        const seen = new Set();
-        const result = [];
-        for (const raw of list ?? []) {
-            if (typeof raw !== 'string') {
-                continue;
-            }
-            const keyword = Array.from(raw.replace(BOT_SPACE_PATTERN, ' ').trim())
-                .slice(0, BOT_KEYWORD_MAX).join('').trim();
-            const key = spacedOf(keyword);
-            if (keyword === '' || seen.has(key)) {
-                continue;
-            }
-            seen.add(key);
-            result.push(keyword);
-            if (result.length >= BOT_KEYWORDS_MAX) {
-                break;
-            }
-        }
-        return result;
-    };
-    const appliesTo = (rule, connection) => rule.connection == null || rule.connection === connection;
-    return { match, normalizeKeywords, appliesTo };
-};
-export const botRuleHelper = createBotRuleHelper();
-//# sourceMappingURL=rule.js.map

package/build/helpers/rule.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"rule.js","sourceRoot":"","sources":["../../src/helpers/rule.ts"],"names":[],"mappings":"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"}

package/src/helpers/rule/types.ts

@@ -1,26 +0,0 @@
-import type { BotMatch, BotRule } from '../../types.js'
-
-/**
- * How a message is matched against keyword groups — the ONE implementation the server's dispatch,
- * the panels and the tests share, so a rule means the same thing everywhere.
- */
-export interface BotRuleHelper {
-  /**
-   * The enabled rules whose keywords the text matches, ordered by `order` (ties keep the given
-   * order), each with the keywords (as stored) that matched.
-   *
-   * Both sides are folded the same way: NFKC, then case-folded (`ß` ≡ `ss`, `Ё` ≡ `ё`), accents
-   * kept. `word` compares whole tokens — runs of letters, combining marks, digits and `_` — and a
-   * multi-word keyword is a PHRASE that must appear as consecutive tokens; `contains` is a substring
-   * of the folded text with whitespace runs collapsed. Disabled rules never match.
-   */
-  match: (text: string, rules: readonly BotRule[]) => BotMatch[]
-  /**
-   * A keyword list as it is stored: each trimmed with inner whitespace collapsed, cut to
-   * `BOT_KEYWORD_MAX` code points, empties dropped, duplicates (by their folded form) dropped keeping
-   * the first spelling, at most `BOT_KEYWORDS_MAX` kept.
-   */
-  normalizeKeywords: (list: readonly string[]) => string[]
-  /** Whether a rule applies to a connection: its own, or a scope-wide one (`connection` null/absent). */
-  appliesTo: (rule: Pick<BotRule, 'connection'>, connection: string) => boolean
-}

package/src/helpers/rule.ts

@@ -1,89 +0,0 @@
-import { BOT_KEYWORD_MAX, BOT_KEYWORDS_MAX, BotMatchMode } from '../consts.js'
-import { BOT_SPACE_PATTERN, BOT_TOKEN_PATTERN } from '../consts.local.js'
-import type { BotMatch, BotRule } from '../types.js'
-import type { BotRuleHelper } from './rule/types.js'
-
-export const createBotRuleHelper = (): BotRuleHelper => {
-  /**
-   * NFKC, then a case fold: upper-casing first maps what lower-casing alone keeps apart (`ß` → `SS`
-   * → `ss`, final `ς` → `Σ` → `σ`), and NFKC again recomposes what the case mapping decomposed.
-   */
-  const fold = (text: string): string =>
-    text.normalize('NFKC').toUpperCase().toLowerCase().normalize('NFKC')
-
-  const tokensOf = (text: string): string[] => fold(text).match(BOT_TOKEN_PATTERN) ?? []
-
-  const spacedOf = (text: string): string => fold(text).replace(BOT_SPACE_PATTERN, ' ').trim()
-
-  const hasPhrase = (tokens: readonly string[], phrase: readonly string[]): boolean => {
-    for (let at = 0; at + phrase.length <= tokens.length; at++) {
-      if (phrase.every((token, offset) => tokens[at + offset] === token)) {
-        return true
-      }
-    }
-    return false
-  }
-
-  const match = (text: string, rules: readonly BotRule[]): BotMatch[] => {
-    if (typeof text !== 'string' || text.trim() === '') {
-      return []
-    }
-    // Folded once per message, never per rule.
-    let tokens: string[] | undefined
-    let spaced: string | undefined
-
-    const matchesKeyword = (mode: BotMatchMode, keyword: string): boolean => {
-      if (mode === BotMatchMode.Contains) {
-        const needle = spacedOf(keyword)
-        spaced ??= spacedOf(text)
-        return needle !== '' && spaced.includes(needle)
-      }
-      const phrase = tokensOf(keyword)
-      tokens ??= tokensOf(text)
-      return phrase.length > 0 && hasPhrase(tokens, phrase)
-    }
-
-    return rules
-      .filter(rule => rule.enabled)
-      .map((rule): BotMatch => ({
-        rule,
-        keywords: [...new Set(rule.keywords.filter(
-          keyword => typeof keyword === 'string' && matchesKeyword(rule.mode ?? BotMatchMode.Word, keyword)
-        ))],
-      }))
-      .filter(found => found.keywords.length > 0)
-      // Array#sort is stable: rules of equal order keep the order they were given in.
-      .sort((left, right) => (left.rule.order ?? 0) - (right.rule.order ?? 0))
-  }
-
-  const normalizeKeywords = (list: readonly string[]): string[] => {
-    const seen = new Set<string>()
-    const result: string[] = []
-
-    for (const raw of list ?? []) {
-      if (typeof raw !== 'string') {
-        continue
-      }
-      const keyword = Array.from(raw.replace(BOT_SPACE_PATTERN, ' ').trim())
-        .slice(0, BOT_KEYWORD_MAX).join('').trim()
-      const key = spacedOf(keyword)
-      if (keyword === '' || seen.has(key)) {
-        continue
-      }
-      seen.add(key)
-      result.push(keyword)
-      if (result.length >= BOT_KEYWORDS_MAX) {
-        break
-      }
-    }
-
-    return result
-  }
-
-  const appliesTo = (rule: Pick<BotRule, 'connection'>, connection: string): boolean =>
-    rule.connection == null || rule.connection === connection
-
-  return { match, normalizeKeywords, appliesTo }
-}
-
-export const botRuleHelper = createBotRuleHelper()

package/tests/rule.spec.ts

@@ -1,129 +0,0 @@
-import { describe, expect, test } from 'bun:test'
-import { BOT_KEYWORD_MAX, BOT_KEYWORDS_MAX, BotMatchMode, BotRuleAction, botRuleHelper, type BotRule } from '../src/index.js'
-
-const at = '2026-10-26T10:00:00.000Z'
-
-const rule = (id: string, keywords: string[], extra: Partial<BotRule> = {}): BotRule => ({
-  id,
-  scope: 'org-1',
-  connection: null,
-  name: id,
-  keywords,
-  mode: BotMatchMode.Word,
-  action: BotRuleAction.Delete,
-  enabled: true,
-  order: 0,
-  createdAt: at,
-  updatedAt: at,
-  ...extra,
-})
-
-const ids = (text: string, rules: BotRule[]): string[] => botRuleHelper.match(text, rules).map(found => found.rule.id)
-
-describe('botRuleHelper.match — word mode', () => {
-  test('matches whole words only, case-insensitively and across punctuation', () => {
-    const spam = rule('spam', ['casino'])
-
-    expect(ids('Visit the CASINO!', [spam])).toEqual(['spam'])
-    expect(ids('casino, now', [spam])).toEqual(['spam'])
-    expect(ids('casinos are fun', [spam])).toEqual([])
-    expect(ids('megacasino', [spam])).toEqual([])
-  })
-
-  test('a multi-word keyword is a phrase of consecutive words', () => {
-    const offer = rule('offer', ['free money'])
-
-    expect(ids('Get FREE   money now', [offer])).toEqual(['offer'])
-    expect(ids('free—money', [offer])).toEqual(['offer'])
-    expect(ids('money for free', [offer])).toEqual([])
-    expect(ids('free real money', [offer])).toEqual([])
-  })
-
-  test('is Unicode-aware: Cyrillic, accents, compatibility forms and the German sharp s', () => {
-    expect(ids('Купите СПАМ сейчас', [rule('ru', ['спам'])])).toEqual(['ru'])
-    expect(ids('ёлка', [rule('yo', ['ЁЛКА'])])).toEqual(['yo'])
-    expect(ids('Un café, por favor', [rule('es', ['CAFÉ'])])).toEqual(['es'])
-    // Accents are kept: "cafe" is not "café".
-    expect(ids('Un café', [rule('plain', ['cafe'])])).toEqual([])
-    // NFKC: the full-width form and the ligature fold onto plain letters; NFD text onto NFC.
-    expect(ids('ＣＡＳＩＮＯ night', [rule('wide', ['casino'])])).toEqual(['wide'])
-    expect(ids('finance tips', [rule('lig', ['finance'])])).toEqual(['lig'])
-    expect(ids('café au lait', [rule('nfd', ['café'])])).toEqual(['nfd'])
-    expect(ids('STRASSE gesperrt', [rule('de', ['straße'])])).toEqual(['de'])
-  })
-
-  test('a keyword with no letters or digits never matches a word', () => {
-    expect(ids('!!! now', [rule('bang', ['!!!'])])).toEqual([])
-  })
-})
-
-describe('botRuleHelper.match — contains mode', () => {
-  test('matches a folded substring, inside words too, with whitespace runs collapsed', () => {
-    const inside = rule('inside', ['casino'], { mode: BotMatchMode.Contains })
-    const punct = rule('punct', ['!!!'], { mode: BotMatchMode.Contains })
-    const spaced = rule('spaced', ['free  money'], { mode: BotMatchMode.Contains })
-
-    expect(ids('MEGACASINO.com', [inside])).toEqual(['inside'])
-    expect(ids('wow!!! ok', [punct])).toEqual(['punct'])
-    expect(ids('get free\n money', [spaced])).toEqual(['spaced'])
-    expect(ids('no match here', [inside, punct, spaced])).toEqual([])
-  })
-})
-
-describe('botRuleHelper.match — groups', () => {
-  test('skips disabled rules and answers [] for empty text', () => {
-    const off = rule('off', ['spam'], { enabled: false })
-
-    expect(ids('spam', [off])).toEqual([])
-    expect(ids('   ', [rule('on', ['spam'])])).toEqual([])
-  })
-
-  test('orders matches by rule order, ties keeping the given order', () => {
-    const rules = [
-      rule('third', ['spam'], { order: 3 }),
-      rule('first', ['spam'], { order: 1 }),
-      rule('tie-a', ['spam'], { order: 2 }),
-      rule('tie-b', ['spam'], { order: 2 }),
-    ]
-
-    expect(ids('spam', rules)).toEqual(['first', 'tie-a', 'tie-b', 'third'])
-  })
-
-  test('reports every group a message matches, each with its own matched keywords as stored', () => {
-    const abuse = rule('abuse', ['Idiot', 'stupid', 'moron'], { order: 1, action: BotRuleAction.Warn })
-    const hours = rule('hours', ['opening hours', 'open'], { order: 2, action: BotRuleAction.Reply })
-    const quiet = rule('quiet', ['delivery'], { order: 0 })
-    const found = botRuleHelper.match('You idiot, what are the OPENING hours? stupid!', [hours, quiet, abuse])
-
-    expect(found.map(match => [match.rule.id, match.keywords])).toEqual([
-      ['abuse', ['Idiot', 'stupid']],
-      ['hours', ['opening hours']],
-    ])
-  })
-})
-
-describe('botRuleHelper.normalizeKeywords', () => {
-  test('trims, collapses inner whitespace, drops empties and folded duplicates keeping the first spelling', () => {
-    expect(botRuleHelper.normalizeKeywords(['  Free   money ', '', '   ', 'free MONEY', 'Спам', 'СПАМ', 'café']))
-      .toEqual(['Free money', 'Спам', 'café'])
-  })
-
-  test('caps the keyword length (in code points) and the list size', () => {
-    const long = '😀'.repeat(BOT_KEYWORD_MAX + 10)
-    const [capped] = botRuleHelper.normalizeKeywords([long])
-    const many = botRuleHelper.normalizeKeywords(Array.from({ length: BOT_KEYWORDS_MAX + 5 }, (_, n) => `kw${n}`))
-
-    expect(Array.from(capped)).toHaveLength(BOT_KEYWORD_MAX)
-    expect(many).toHaveLength(BOT_KEYWORDS_MAX)
-    expect(many[0]).toBe('kw0')
-  })
-})
-
-describe('botRuleHelper.appliesTo', () => {
-  test('a scope-wide rule applies to every connection, an own one to its connection only', () => {
-    expect(botRuleHelper.appliesTo({ connection: null }, 'c1')).toBe(true)
-    expect(botRuleHelper.appliesTo({}, 'c1')).toBe(true)
-    expect(botRuleHelper.appliesTo({ connection: 'c1' }, 'c1')).toBe(true)
-    expect(botRuleHelper.appliesTo({ connection: 'c2' }, 'c1')).toBe(false)
-  })
-})