ikemoji 1.0.0

package/README.md

@@ -0,0 +1,46 @@
+# ikemoji
+
+Telegram Bot API 9.4 – Custom Emoji Helper
+
+- UTF-16 correct  
+- ZWJ / skin tone safe  
+- Length = 1 (Telegram requirement)  
+- Handles multiple consecutive emojis and variation selectors  
+- Telegraf compatible  
+
+---
+
+## Installation
+
+```bash
+npm install ikemoji
+
+## Usage
+
+const { emo, emoEnt, findEmo, checkEnt, mergeEntities } = require('ikemoji');
+
+const emojiMap = {
+  "😀": "5444871234567890123",
+  "🔥": "5444879876543210123"
+};
+
+// Build text + entities
+const { text, entities } = emo("Hello 😀🔥", emojiMap);
+console.log(text);      // "Hello 😀🔥"
+console.log(entities);  // [{ type: 'custom_emoji', offset: 6, length: 1, custom_emoji_id: "..." }, ...]
+
+// Extract entities only
+const onlyEntities = emoEnt("Hello 😀🔥", emojiMap);
+console.log(onlyEntities);
+
+// Find all unique emojis
+const unique = findEmo("Hello 😀🔥");
+console.log(unique);    // ["😀","🔥"]
+
+// Validate entities
+const { valid, errors } = checkEnt(entities);
+console.log(valid, errors);
+
+// Merge with other entities
+const allEntities = mergeEntities(entities, [{ type: 'bold', offset: 0, length: 5 }]);
+console.log(allEntities);

package/index.js

@@ -0,0 +1,95 @@
+/**
+ * Telegram Bot API 9.4 – Custom Emoji Helper
+ * Author: ikjava
+ * ✔ UTF-16 correct
+ * ✔ ZWJ / skin tone safe
+ * ✔ length = 1
+ * ✔ Handles multiple consecutive emojis and variation selectors
+ * ✔ Telegraf compatible
+ */
+
+const segmenter = new Intl.Segmenter('en', { granularity: 'grapheme' });
+
+function emo(text, emojiMap, options = {}) {
+  const { stripOriginal = false, skipUnmapped = true } = options;
+  const entities = [];
+  let out = '';
+  let offset = 0;
+
+  for (const { segment } of segmenter.segment(text)) {
+    const id = emojiMap[segment];
+
+    if (id) {
+      entities.push({ type: 'custom_emoji', offset, length: 1, custom_emoji_id: id });
+      if (!stripOriginal) {
+        out += segment;
+        offset += segment.length;
+      }
+    } else {
+      if (!skipUnmapped || isEmo(segment) === false) {
+        out += segment;
+        offset += segment.length;
+      }
+    }
+  }
+
+  return { text: out, entities };
+}
+
+function emoEnt(text, emojiMap) {
+  const entities = [];
+  let offset = 0;
+
+  for (const { segment } of segmenter.segment(text)) {
+    if (emojiMap[segment]) {
+      entities.push({ type: 'custom_emoji', offset, length: 1, custom_emoji_id: emojiMap[segment] });
+    }
+    offset += segment.length;
+  }
+
+  return entities;
+}
+
+function findEmo(text) {
+  const set = new Set();
+
+  for (const { segment } of segmenter.segment(text)) {
+    if (isEmo(segment)) set.add(segment);
+  }
+
+  return [...set];
+}
+
+function checkEnt(entities) {
+  const errors = [];
+
+  if (entities.length > 100) errors.push(`Too many entities (${entities.length})`);
+
+  entities.forEach((e, i) => {
+    if (e.type !== 'custom_emoji') errors.push(`Entity ${i}: invalid type`);
+    if (!e.custom_emoji_id) errors.push(`Entity ${i}: missing custom_emoji_id`);
+    if (e.length !== 1) errors.push(`Entity ${i}: length must be 1`);
+    if (typeof e.offset !== 'number' || e.offset < 0) errors.push(`Entity ${i}: invalid offset`);
+  });
+
+  return { valid: errors.length === 0, errors };
+}
+
+function isEmo(str) {
+  return /\p{Extended_Pictographic}/u.test(str);
+}
+
+function mergeEntities(baseEntities, newEntities) {
+  const all = [...baseEntities, ...newEntities];
+  all.sort((a, b) => a.offset - b.offset);
+  return all;
+}
+
+module.exports = {
+  emo,
+  emoEnt,
+  findEmo,
+  checkEnt,
+  isEmo,
+  mergeEntities
+};

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "ikemoji",
+  "version": "1.0.0",
+  "description": "Telegram Bot API 9.4 custom emoji helper - UTF-16 correct, ZWJ/skin tone safe, Telegraf compatible",
+  "main": "index.js",
+  "scripts": {
+    "test": "node test.js"
+  },
+  "keywords": [
+    "telegram",
+    "bot",
+    "custom",
+    "emoji",
+    "telegram-bot-api",
+    "telegraf",
+    "caption",
+    "9.4"
+  ],
+  "author": "Saul ikjava",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16"
+  },
+  "dependencies": {},
+  "devDependencies": {}
+}