@overlive/emotes 0.1.0

package/dist/EmoteResolver.d.ts

@@ -0,0 +1,45 @@
+import type { EmotePlatform, MessageToken } from '@overlive/core';
+/**
+ * Fetches and caches emotes from all configured platforms,
+ * then resolves chat message text into typed tokens.
+ *
+ * Usage:
+ *   const resolver = new EmoteResolver({ channelId: '...', twitchClientId: '...' })
+ *   await resolver.warmup()
+ *   const tokens = await resolver.resolve(messageText, twitchEmoteData)
+ */
+export declare class EmoteResolver {
+    private readonly config;
+    private readonly cache;
+    private readonly platforms;
+    constructor(config: {
+        /** Twitch broadcaster user ID */
+        channelId: string;
+        /** Twitch Client-ID for emote API */
+        twitchClientId?: string;
+        twitchAccessToken?: string;
+        /** Which emote platforms to resolve. Defaults to all. */
+        platforms?: EmotePlatform[];
+    });
+    /**
+     * Pre-fetch all emote sets. Call this after connecting to warm the cache.
+     */
+    warmup(): Promise<void>;
+    /**
+     * Resolve a message string into typed tokens, injecting emote objects
+     * where emote names are found in the text.
+     *
+     * @param text      Raw message text
+     * @param twitchEmoteRanges  Optional raw Twitch emote positions from IRC
+     *                           (format: "id:start-end,start-end/id:...")
+     */
+    resolve(text: string, twitchEmoteRanges?: string): Promise<MessageToken[]>;
+    private getEmotes;
+    private fetchTwitch;
+    private fetch7TV;
+    private fetchBTTV;
+    private fetchFFZ;
+    /** Invalidate the cache — call this if emotes are updated mid-stream */
+    invalidate(): void;
+}
+//# sourceMappingURL=EmoteResolver.d.ts.map

package/dist/EmoteResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmoteResolver.d.ts","sourceRoot":"","sources":["../src/EmoteResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAWhF;;;;;;;;GAQG;AACH,qBAAa,aAAa;IAKtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;gBAG3B,MAAM,EAAE;QACvB,iCAAiC;QACjC,SAAS,EAAE,MAAM,CAAA;QACjB,qCAAqC;QACrC,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;QAC1B,yDAAyD;QACzD,SAAS,CAAC,EAAE,aAAa,EAAE,CAAA;KAC5B;IAKH;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B;;;;;;;OAOG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,YAAY,EAAE,CAAC;YAmDZ,SAAS;YAgCT,WAAW;YAiCX,QAAQ;YAgCR,SAAS;YA4BT,QAAQ;IAkCtB,wEAAwE;IACxE,UAAU,IAAI,IAAI;CAGnB"}

package/dist/EmoteResolver.js

@@ -0,0 +1,237 @@
+const CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Fetches and caches emotes from all configured platforms,
+ * then resolves chat message text into typed tokens.
+ *
+ * Usage:
+ *   const resolver = new EmoteResolver({ channelId: '...', twitchClientId: '...' })
+ *   await resolver.warmup()
+ *   const tokens = await resolver.resolve(messageText, twitchEmoteData)
+ */
+export class EmoteResolver {
+    config;
+    cache = new Map();
+    platforms;
+    constructor(config) {
+        this.config = config;
+        this.platforms = new Set(config.platforms ?? ['twitch', '7tv', 'bttv', 'ffz']);
+    }
+    /**
+     * Pre-fetch all emote sets. Call this after connecting to warm the cache.
+     */
+    async warmup() {
+        await this.getEmotes();
+    }
+    /**
+     * Resolve a message string into typed tokens, injecting emote objects
+     * where emote names are found in the text.
+     *
+     * @param text      Raw message text
+     * @param twitchEmoteRanges  Optional raw Twitch emote positions from IRC
+     *                           (format: "id:start-end,start-end/id:...")
+     */
+    async resolve(text, twitchEmoteRanges) {
+        const emotes = await this.getEmotes();
+        // Build a set of Twitch emote positions from IRC metadata if available
+        const twitchPositions = parseTwitchEmoteRanges(twitchEmoteRanges ?? '');
+        const tokens = [];
+        const words = text.split(' ');
+        let charPos = 0;
+        for (let i = 0; i < words.length; i++) {
+            const word = words[i] ?? '';
+            const wordEnd = charPos + word.length;
+            // Check if this word is at a known Twitch emote position
+            const twitchEmoteId = twitchPositions.get(charPos);
+            if (twitchEmoteId) {
+                const twitchEmote = emotes.get(`twitch:${twitchEmoteId}`) ?? emotes.get(`twitch:name:${word}`);
+                if (twitchEmote) {
+                    tokens.push({ type: 'emote', emote: twitchEmote });
+                    charPos = wordEnd + 1;
+                    continue;
+                }
+            }
+            // Check by name across all platforms
+            const emote = emotes.get(word);
+            if (emote) {
+                tokens.push({ type: 'emote', emote });
+            }
+            else if (word.startsWith('@')) {
+                tokens.push({ type: 'mention', username: word.slice(1) });
+            }
+            else if (word.startsWith('http://') || word.startsWith('https://')) {
+                tokens.push({ type: 'url', href: word, display: word });
+            }
+            else {
+                // Merge consecutive text tokens
+                const last = tokens[tokens.length - 1];
+                if (last?.type === 'text') {
+                    last.value += ` ${word}`;
+                }
+                else {
+                    tokens.push({ type: 'text', value: word });
+                }
+            }
+            charPos = wordEnd + 1;
+        }
+        return tokens;
+    }
+    // ─── Emote fetching ───────────────────────────────────────────────────────
+    async getEmotes() {
+        const cacheKey = this.config.channelId;
+        const cached = this.cache.get(cacheKey);
+        if (cached && Date.now() - cached.fetchedAt < CACHE_TTL_MS) {
+            return cached.emotes;
+        }
+        const results = await Promise.allSettled([
+            this.platforms.has('twitch') ? this.fetchTwitch() : Promise.resolve([]),
+            this.platforms.has('7tv') ? this.fetch7TV() : Promise.resolve([]),
+            this.platforms.has('bttv') ? this.fetchBTTV() : Promise.resolve([]),
+            this.platforms.has('ffz') ? this.fetchFFZ() : Promise.resolve([]),
+        ]);
+        const emoteMap = new Map();
+        for (const result of results) {
+            if (result.status === 'fulfilled') {
+                for (const emote of result.value) {
+                    // Primary key: emote name (for text matching)
+                    emoteMap.set(emote.name, emote);
+                    // Secondary key: platform:id (for IRC position matching)
+                    emoteMap.set(`${emote.platform}:${emote.id}`, emote);
+                }
+            }
+        }
+        this.cache.set(cacheKey, { emotes: emoteMap, fetchedAt: Date.now() });
+        return emoteMap;
+    }
+    async fetchTwitch() {
+        if (!this.config.twitchClientId || !this.config.twitchAccessToken)
+            return [];
+        const res = await fetch(`https://api.twitch.tv/helix/chat/emotes?broadcaster_id=${this.config.channelId}`, {
+            headers: {
+                'Client-Id': this.config.twitchClientId,
+                Authorization: `Bearer ${this.config.twitchAccessToken}`,
+            },
+        });
+        if (!res.ok)
+            return [];
+        const data = await res.json();
+        return data.data.map((e) => {
+            const emote = e;
+            const images = (emote['images'] ?? {});
+            return {
+                id: String(emote['id'] ?? ''),
+                name: String(emote['name'] ?? ''),
+                platform: 'twitch',
+                animated: String(emote['format'] ?? '').includes('animated'),
+                urls: {
+                    x1: images['url_1x'] ?? '',
+                    x2: images['url_2x'] ?? '',
+                    x4: images['url_4x'] ?? '',
+                },
+            };
+        });
+    }
+    async fetch7TV() {
+        const res = await fetch(`https://7tv.io/v3/users/twitch/${this.config.channelId}`);
+        if (!res.ok)
+            return [];
+        const data = await res.json();
+        const emoteSet = (data['emote_set'] ?? {});
+        const emotes = (emoteSet['emotes'] ?? []);
+        return emotes.map((e) => {
+            const emote = e;
+            const emoteData = (emote['data'] ?? {});
+            const host = (emoteData['host'] ?? {});
+            const hostUrl = String(host['url'] ?? '');
+            const files = (host['files'] ?? []);
+            const bySize = (size) => {
+                const f = files.find((f) => f['name'] === `${size}.webp`);
+                return f ? `https:${hostUrl}/${f['name']}` : '';
+            };
+            return {
+                id: String(emote['id'] ?? ''),
+                name: String(emote['name'] ?? ''),
+                platform: '7tv',
+                animated: Boolean(emoteData['animated']),
+                urls: { x1: bySize('1x'), x2: bySize('2x'), x4: bySize('4x') },
+            };
+        });
+    }
+    async fetchBTTV() {
+        const res = await fetch(`https://api.betterttv.net/3/cached/users/twitch/${this.config.channelId}`);
+        if (!res.ok)
+            return [];
+        const data = await res.json();
+        const channelEmotes = (data['channelEmotes'] ?? []);
+        const sharedEmotes = (data['sharedEmotes'] ?? []);
+        const all = [...channelEmotes, ...sharedEmotes];
+        return all.map((e) => {
+            const emote = e;
+            const id = String(emote['id'] ?? '');
+            return {
+                id,
+                name: String(emote['code'] ?? ''),
+                platform: 'bttv',
+                animated: String(emote['imageType'] ?? '') === 'gif',
+                urls: {
+                    x1: `https://cdn.betterttv.net/emote/${id}/1x`,
+                    x2: `https://cdn.betterttv.net/emote/${id}/2x`,
+                    x4: `https://cdn.betterttv.net/emote/${id}/3x`,
+                },
+            };
+        });
+    }
+    async fetchFFZ() {
+        const res = await fetch(`https://api.frankerfacez.com/v1/room/id/${this.config.channelId}`);
+        if (!res.ok)
+            return [];
+        const data = await res.json();
+        const sets = (data['sets'] ?? {});
+        const emotes = [];
+        for (const set of Object.values(sets)) {
+            const setData = set;
+            const setEmotes = (setData['emoticons'] ?? []);
+            for (const e of setEmotes) {
+                const emote = e;
+                const urls = (emote['urls'] ?? {});
+                emotes.push({
+                    id: String(emote['id'] ?? ''),
+                    name: String(emote['name'] ?? ''),
+                    platform: 'ffz',
+                    animated: false, // FFZ doesn't support animated emotes
+                    urls: {
+                        x1: urls['1'] ? `https:${urls['1']}` : '',
+                        x2: urls['2'] ? `https:${urls['2']}` : '',
+                        x4: urls['4'] ? `https:${urls['4']}` : '',
+                    },
+                });
+            }
+        }
+        return emotes;
+    }
+    /** Invalidate the cache — call this if emotes are updated mid-stream */
+    invalidate() {
+        this.cache.delete(this.config.channelId);
+    }
+}
+// ─── Twitch IRC emote range parser ────────────────────────────────────────────
+/**
+ * Parses Twitch IRC emote metadata into a map of startPosition → emoteId.
+ * Format: "emoteId:start-end,start-end/emoteId:start-end"
+ */
+function parseTwitchEmoteRanges(raw) {
+    const positions = new Map();
+    if (!raw)
+        return positions;
+    for (const part of raw.split('/')) {
+        const [id, ranges] = part.split(':');
+        if (!id || !ranges)
+            continue;
+        for (const range of ranges.split(',')) {
+            const [start] = range.split('-');
+            if (start !== undefined)
+                positions.set(Number(start), id);
+        }
+    }
+    return positions;
+}
+//# sourceMappingURL=EmoteResolver.js.map

package/dist/EmoteResolver.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { EmoteResolver } from './EmoteResolver.js';
+export { tokensToHtml } from './tokensToHtml.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { EmoteResolver } from './EmoteResolver.js';
+export { tokensToHtml } from './tokensToHtml.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/tokensToHtml.d.ts

@@ -0,0 +1,19 @@
+import type { MessageToken } from '@overlive/core';
+/**
+ * Render parsed chat message tokens to an XSS-safe HTML string.
+ *
+ * The output is suitable for direct insertion into a chat overlay via
+ * `innerHTML` or React's `dangerouslySetInnerHTML`. All user-supplied
+ * strings are escaped; emote URLs and mention/url tokens go through the
+ * same escape pipeline so even a maliciously crafted emote name can't
+ * inject markup.
+ *
+ * Emit shape (mostly stable CSS classes you can style):
+ *   text:    plain escaped text run
+ *   mention: <span class="overlive-mention">@user</span>
+ *   url:     <a class="overlive-url" href="..." rel="noreferrer">display</a>
+ *   cheer:   <span class="overlive-cheer">123</span>
+ *   emote:   <img class="overlive-emote" src="..." alt="name" title="name" />
+ */
+export declare function tokensToHtml(tokens: MessageToken[], fallbackText?: string): string;
+//# sourceMappingURL=tokensToHtml.d.ts.map

package/dist/tokensToHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokensToHtml.d.ts","sourceRoot":"","sources":["../src/tokensToHtml.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,YAAY,SAAK,GAAG,MAAM,CA+B9E"}

package/dist/tokensToHtml.js

@@ -0,0 +1,59 @@
+/**
+ * Render parsed chat message tokens to an XSS-safe HTML string.
+ *
+ * The output is suitable for direct insertion into a chat overlay via
+ * `innerHTML` or React's `dangerouslySetInnerHTML`. All user-supplied
+ * strings are escaped; emote URLs and mention/url tokens go through the
+ * same escape pipeline so even a maliciously crafted emote name can't
+ * inject markup.
+ *
+ * Emit shape (mostly stable CSS classes you can style):
+ *   text:    plain escaped text run
+ *   mention: <span class="overlive-mention">@user</span>
+ *   url:     <a class="overlive-url" href="..." rel="noreferrer">display</a>
+ *   cheer:   <span class="overlive-cheer">123</span>
+ *   emote:   <img class="overlive-emote" src="..." alt="name" title="name" />
+ */
+export function tokensToHtml(tokens, fallbackText = '') {
+    if (!tokens || tokens.length === 0)
+        return esc(fallbackText);
+    const parts = [];
+    for (const t of tokens) {
+        switch (t.type) {
+            case 'text':
+                parts.push(esc(t.value));
+                break;
+            case 'mention':
+                parts.push(`<span class="overlive-mention">@${esc(t.username)}</span>`);
+                break;
+            case 'url':
+                parts.push(`<a class="overlive-url" href="${esc(t.href)}" rel="noreferrer">${esc(t.display)}</a>`);
+                break;
+            case 'cheer':
+                parts.push(`<span class="overlive-cheer">${Number(t.amount) || 0}</span>`);
+                break;
+            case 'emote': {
+                const e = t.emote;
+                const url = e.urls?.x2 ?? e.urls?.x1 ?? '';
+                if (!url) {
+                    parts.push(esc(e.name));
+                    break;
+                }
+                parts.push(`<img class="overlive-emote" src="${esc(url)}" alt="${esc(e.name)}" title="${esc(e.name)}" />`);
+                break;
+            }
+        }
+    }
+    return parts.join(' ');
+}
+function esc(s) {
+    return s.replace(/[&<>"']/g, (c) => HTML_ESCAPES[c]);
+}
+const HTML_ESCAPES = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+};
+//# sourceMappingURL=tokensToHtml.js.map

package/dist/tokensToHtml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokensToHtml.js","sourceRoot":"","sources":["../src/tokensToHtml.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,YAAY,CAAC,MAAsB,EAAE,YAAY,GAAG,EAAE;IACpE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,YAAY,CAAC,CAAA;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,MAAM;gBACT,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;gBACxB,MAAK;YACP,KAAK,SAAS;gBACZ,KAAK,CAAC,IAAI,CAAC,mCAAmC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;gBACvE,MAAK;YACP,KAAK,KAAK;gBACR,KAAK,CAAC,IAAI,CACR,iCAAiC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CACvF,CAAA;gBACD,MAAK;YACP,KAAK,OAAO;gBACV,KAAK,CAAC,IAAI,CAAC,gCAAgC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBAC1E,MAAK;YACP,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAA;gBACjB,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAA;gBAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;oBAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;oBAAC,MAAK;gBAAC,CAAC;gBAC5C,KAAK,CAAC,IAAI,CACR,oCAAoC,GAAG,CAAC,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAC/F,CAAA;gBACD,MAAK;YACP,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAED,SAAS,GAAG,CAAC,CAAS;IACpB,OAAO,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAE,CAAC,CAAA;AACvD,CAAC;AAED,MAAM,YAAY,GAA2B;IAC3C,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;CACb,CAAA"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@overlive/emotes",
+  "version": "0.1.0",
+  "description": "Emote resolution for Twitch, 7TV, BTTV, and FFZ",
+  "license": "UNLICENSED",
+  "author": "fennsorenn",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fennsorenn/overlive.git",
+    "directory": "packages/emotes"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@overlive/core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}