silent-akinator-pro 2.0.0 → 3.0.0

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) Silent Tech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

package/README.md

@@ -1,18 +1,97 @@
-# 🧞 SILENT-AKINATOR PRO 🧞
-### BY SILENT TECH
+# silent-akinator-pro
 
-The most reliable Akinator API for developers.
+> 🧞 **The working Akinator API wrapper for Node.js** — fast, reliable, Cloudflare-safe. Modern Akinator client by **Silent Tech**.
 
-## 🚀 INSTALL
-`npm install silent-akinator-pro`
+[![npm](https://img.shields.io/npm/v/silent-akinator-pro.svg)](https://www.npmjs.com/package/silent-akinator-pro)
+[![downloads](https://img.shields.io/npm/dm/silent-akinator-pro.svg)](https://www.npmjs.com/package/silent-akinator-pro)
+[![license](https://img.shields.io/npm/l/silent-akinator-pro.svg)](LICENSE)
 
-## 💻 USAGE
-```javascript
+The most up-to-date **Akinator** Node.js wrapper that actually works in 2026. Bypasses the Cloudflare `403` by using the official HTML form endpoints with realistic browser headers and a full cookie jar — no third-party proxies, no API keys.
+
+## Why silent-akinator-pro?
+
+- ✅ **Working** — fixed the `403 Forbidden` / Cloudflare issue that broke every other akinator npm package
+- ⚡ **Fast** — zero heavy dependencies (only `tough-cookie`)
+- 🌍 **16 regions** — `en`, `fr`, `es`, `de`, `it`, `pt`, `ru`, `ar`, `jp`, `kr`, `cn`, `nl`, `pl`, `tr`, `il`, `id`
+- 🧒 **Child mode** supported
+- ↩️ **Undo / back / continue / win** all supported
+- 🤖 **Discord bot / Telegram bot / WhatsApp bot ready**
+- 📘 **TypeScript types** included
+- 🆓 **MIT** licensed
+
+## Install
+
+```bash
+npm install silent-akinator-pro
+```
+
+## Quick Start
+
+```js
 const { Akinator } = require('silent-akinator-pro');
-const api = new Akinator({ region: 'en', childMode: false });
 
 (async () => {
-    await api.start();
-    console.log(api.question);
+  const aki = new Akinator({ region: 'en', childMode: false });
+  await aki.start();
+
+  console.log(aki.question);
+  await aki.answer('y');           // y / n / idk / p / pn  (or 0-4)
+  console.log(aki.question);
+
+  while (!aki.guessed && aki.step < 80) {
+    await aki.answer('idk');
+  }
+
+  if (aki.guessed) {
+    console.log('Akinator thinks of:', aki.guess.name);
+    await aki.win();
+  }
 })();
 ```
+
+## API
+
+### `new Akinator({ region, childMode })`
+- `region` — `en | fr | es | de | it | pt | ru | ar | jp | kr | cn | nl | pl | tr | il | id`
+- `childMode` — `boolean`
+
+### Methods
+| Method        | Description                                  |
+|---------------|----------------------------------------------|
+| `start()`     | Begin a new game                             |
+| `answer(a)`   | `y` / `n` / `idk` / `p` / `pn`  (or `0-4`)   |
+| `back()`      | Undo the previous answer                     |
+| `continue()`  | Reject the current guess and keep playing    |
+| `win()`       | Confirm the guess and end the game           |
+
+### Properties
+`question`, `step`, `progression`, `guess`, `guessed`, `finished`.
+
+## Discord bot example
+
+```js
+const { Akinator } = require('silent-akinator-pro');
+const games = new Map();
+
+client.on('messageCreate', async (msg) => {
+  if (msg.content === '!aki') {
+    const aki = new Akinator({ region: 'en' });
+    await aki.start();
+    games.set(msg.author.id, aki);
+    msg.reply(aki.question);
+  } else if (['y','n','idk','p','pn'].includes(msg.content)) {
+    const aki = games.get(msg.author.id);
+    if (!aki) return;
+    await aki.answer(msg.content);
+    if (aki.guessed) msg.reply(`Is it **${aki.guess.name}**? (${aki.guess.description})`);
+    else msg.reply(aki.question);
+  }
+});
+```
+
+## Keywords
+akinator, akinator api, akinator nodejs, akinator wrapper, akinator client, akinator bot, akinator discord, akinator 2026, working akinator, akinator cloudflare, silent tech, silent-akinator, silent-akinator-pro, twenty questions, character guessing game, genie api.
+
+## License
+
+MIT © **Silent Tech**

package/index.d.ts

@@ -0,0 +1,26 @@
+
+export interface AkinatorOptions {
+  region?: 'en'|'ar'|'cn'|'de'|'es'|'fr'|'il'|'it'|'jp'|'kr'|'nl'|'pl'|'pt'|'ru'|'tr'|'id';
+  childMode?: boolean;
+}
+export interface AkinatorGuess {
+  id?: string; name?: string; description?: string; photo?: string; pseudo?: string;
+}
+export class Akinator {
+  constructor(opts?: AkinatorOptions);
+  region: string;
+  childMode: boolean;
+  question: string | null;
+  step: number;
+  progression: string;
+  guess: AkinatorGuess | null;
+  guessed: boolean;
+  finished: boolean;
+  start(): Promise<this>;
+  answer(a: 'y'|'n'|'idk'|'p'|'pn'|0|1|2|3|4|string|number): Promise<this>;
+  back(): Promise<this>;
+  continue(): Promise<this>;
+  win(): Promise<AkinatorGuess>;
+}
+export const REGIONS: Record<string,string>;
+export default Akinator;

package/index.js

@@ -1,86 +1,245 @@
-const axios = require('axios');
+
+'use strict';
+/*!
+ * silent-akinator-pro
+ * Working Akinator API wrapper (HTML-form endpoints, Cloudflare-safe).
+ * (c) Silent Tech — MIT
+ */
+const { CookieJar } = require('tough-cookie');
+const https = require('https');
+const { URL, URLSearchParams } = require('url');
+
+const REGIONS = {
+  en: 'en', ar: 'ar', cn: 'cn', de: 'de', es: 'es', fr: 'fr',
+  il: 'il', it: 'it', jp: 'jp', kr: 'kr', nl: 'nl', pl: 'pl',
+  pt: 'pt', ru: 'ru', tr: 'tr', id: 'id'
+};
+
+const ANSWER_MAP = {
+  y: 0, yes: 0, '0': 0,
+  n: 1, no: 1, '1': 1,
+  idk: 2, "don't know": 2, dk: 2, '2': 2,
+  p: 3, probably: 3, '3': 3,
+  pn: 4, 'probably not': 4, '4': 4
+};
+
+const UA =
+  'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 ' +
+  '(KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36';
+
+function request(method, urlStr, { headers = {}, body = null, jar } = {}) {
+  return new Promise((resolve, reject) => {
+    const u = new URL(urlStr);
+    const cookieHeader = jar ? jar.getCookieStringSync(urlStr) : '';
+    const opts = {
+      method,
+      hostname: u.hostname,
+      path: u.pathname + u.search,
+      headers: {
+        'User-Agent': UA,
+        'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+        'Accept-Language': 'en-US,en;q=0.9',
+        'Accept-Encoding': 'identity',
+        'Referer': `https://${u.hostname}/`,
+        'Origin': `https://${u.hostname}`,
+        ...(cookieHeader ? { Cookie: cookieHeader } : {}),
+        ...headers
+      }
+    };
+    if (body) {
+      opts.headers['Content-Type'] = 'application/x-www-form-urlencoded';
+      opts.headers['Content-Length'] = Buffer.byteLength(body);
+      opts.headers['X-Requested-With'] = 'XMLHttpRequest';
+    }
+    const req = https.request(opts, (res) => {
+      const chunks = [];
+      res.on('data', (c) => chunks.push(c));
+      res.on('end', () => {
+        const data = Buffer.concat(chunks).toString('utf8');
+        if (jar && res.headers['set-cookie']) {
+          for (const c of res.headers['set-cookie']) {
+            try { jar.setCookieSync(c, urlStr); } catch (_) {}
+          }
+        }
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          const next = new URL(res.headers.location, urlStr).toString();
+          return resolve(request('GET', next, { jar, headers }));
+        }
+        resolve({ status: res.statusCode, headers: res.headers, body: data });
+      });
+    });
+    req.on('error', reject);
+    if (body) req.write(body);
+    req.end();
+  });
+}
+
+function extract(html, re) {
+  const m = html.match(re);
+  return m ? m[1] : null;
+}
 
 class Akinator {
-    constructor(config = { region: 'en', childMode: false }) {
-        this.region = config.region || 'en';
-        this.childMode = config.childMode || false;
-        this.baseUrl = `https://${this.region}.akinator.com`;
-        this.session = null;
-        this.signature = null;
-        this.step = 0;
-        this.progress = 0;
-        this.question = null;
-        this.isWin = false;
-        this.sugestion_name = null;
-        this.sugestion_desc = null;
-        this.sugestion_photo = null;
-        
-        // 🚀 MOBILE SPOOFING HEADERS
-        this.headers = {
-            'User-Agent': 'Akinator/1.2.3 (Android; 13; Scale/2.0)',
-            'X-Requested-With': 'com.digidust.akinator.freemium',
-            'Accept': 'application/json',
-            'Referer': `https://${this.region}.akinator.com/`
-        };
+  constructor(opts = {}) {
+    this.region = REGIONS[(opts.region || 'en').toLowerCase()] || 'en';
+    this.childMode = !!opts.childMode;
+    this.host = `https://${this.region}.akinator.com`;
+    this.jar = new CookieJar();
+
+    this.session = null;
+    this.signature = null;
+    this.question = null;
+    this.step = 0;
+    this.progression = '0.00000';
+    this.guess = null;
+    this.guessed = false;
+    this.finished = false;
+  }
+
+  async start() {
+    // 1. warm-up to set Cloudflare cf_clearance / __cf_bm cookies
+    await request('GET', this.host + '/', { jar: this.jar });
+
+    // 2. fetch the game page (the HTML form gives us session + signature)
+    const url = `${this.host}/game?cm=${this.childMode ? 'true' : 'false'}`;
+    const r = await request('GET', url, { jar: this.jar });
+    if (r.status !== 200) {
+      throw new Error(`Akinator start failed (${r.status}). Region "${this.region}" may be blocked — try another region.`);
     }
 
-    async start() {
-        console.log("💀 SILENT TECH ENGINE v2.0: BOOTING...");
-        try {
-            const res = await axios.get(`${this.baseUrl}/new_session`, {
-                params: { childMod: this.childMode, player: 'website-desktop' },
-                headers: this.headers
-            });
-            const data = res.data.parameters;
-            this.session = data.identification.session;
-            this.signature = data.identification.signature;
-            this.question = data.step_information.question;
-            console.log("✅ SILENT TECH: Handshake Successful.");
-            return this;
-        } catch (e) {
-            throw new Error("Cloudflare Block: Akinator rejected the connection.");
-        }
+    this.session   = extract(r.body, /#session['"]?\s*value=['"]([^'"]+)/i)
+                  || extract(r.body, /name=['"]session['"][^>]*value=['"]([^'"]+)/i)
+                  || extract(r.body, /var\s+session\s*=\s*['"]([^'"]+)/i);
+    this.signature = extract(r.body, /#signature['"]?\s*value=['"]([^'"]+)/i)
+                  || extract(r.body, /name=['"]signature['"][^>]*value=['"]([^'"]+)/i)
+                  || extract(r.body, /var\s+signature\s*=\s*['"]([^'"]+)/i);
+    this.question  = extract(r.body, /<p[^>]*class=['"][^'"]*question-text[^'"]*['"][^>]*>([^<]+)<\/p>/i)
+                  || extract(r.body, /id=['"]question-label['"][^>]*>([^<]+)</i);
+    this.step = 0;
+    this.progression = '0.00000';
+
+    if (!this.session || !this.signature) {
+      throw new Error('Could not parse session/signature from Akinator page. The site layout may have changed.');
     }
+    return this;
+  }
 
-    async answer(ansId) {
-        try {
-            const res = await axios.get(`${this.baseUrl}/answer`, {
-                params: {
-                    session: this.session,
-                    signature: this.signature,
-                    step: this.step,
-                    answer: ansId
-                },
-                headers: this.headers
-            });
-            const data = res.data.parameters;
-            this.step++;
-            this.progress = parseFloat(data.progression);
-            this.question = data.question;
-
-            if (this.progress >= 95) {
-                await this.getWinner();
-            }
-            return this;
-        } catch (e) {
-            throw new Error("Lost connection to Akinator servers.");
-        }
+  _answerCode(a) {
+    if (typeof a === 'number') a = String(a);
+    const code = ANSWER_MAP[String(a).toLowerCase().trim()];
+    if (code === undefined) throw new Error(`Invalid answer "${a}". Use y / n / idk / p / pn.`);
+    return code;
+  }
+
+  async answer(a) {
+    if (this.finished) throw new Error('Game already finished.');
+    const ans = this._answerCode(a);
+    const body = new URLSearchParams({
+      step: String(this.step),
+      progression: String(this.progression),
+      sid: '1',
+      cm: this.childMode ? 'true' : 'false',
+      answer: String(ans),
+      step_last_proposition: '',
+      session: this.session,
+      signature: this.signature
+    }).toString();
+
+    const r = await request('POST', this.host + '/answer', { jar: this.jar, body });
+    let data;
+    try { data = JSON.parse(r.body); }
+    catch { throw new Error(`Akinator answer failed (status ${r.status}). Response was not JSON.`); }
+
+    if (data.completion && data.completion !== 'OK' && data.completion !== 'KO - TIMEOUT') {
+      // proposal step (Akinator wants to guess)
+      if (data.id_proposition || data.name_proposition) {
+        this.guess = {
+          id: data.id_proposition,
+          name: data.name_proposition,
+          description: data.description_proposition,
+          photo: data.photo,
+          pseudo: data.pseudo
+        };
+        this.guessed = true;
+        return this;
+      }
     }
 
-    async getWinner() {
-        const res = await axios.get(`${this.baseUrl}/list`, {
-            params: { session: this.session, signature: this.signature, step: this.step },
-            headers: this.headers
-        });
-        const elements = res.data.parameters.elements;
-        if (elements && elements.length > 0) {
-            this.isWin = true;
-            const char = elements[0].element;
-            this.sugestion_name = char.name;
-            this.sugestion_desc = char.description;
-            this.sugestion_photo = char.absolute_picture_path;
-        }
+    if (data.id_proposition || data.name_proposition) {
+      this.guess = {
+        id: data.id_proposition,
+        name: data.name_proposition,
+        description: data.description_proposition,
+        photo: data.photo,
+        pseudo: data.pseudo
+      };
+      this.guessed = true;
+      return this;
     }
+
+    this.question = data.question || this.question;
+    this.step = parseInt(data.step ?? this.step + 1, 10);
+    this.progression = data.progression || this.progression;
+    this.guessed = false;
+    this.guess = null;
+    return this;
+  }
+
+  async back() {
+    if (this.step <= 0) throw new Error('Cannot go back from step 0.');
+    const body = new URLSearchParams({
+      step: String(this.step),
+      progression: String(this.progression),
+      sid: '1',
+      cm: this.childMode ? 'true' : 'false',
+      session: this.session,
+      signature: this.signature
+    }).toString();
+    const r = await request('POST', this.host + '/cancel_answer', { jar: this.jar, body });
+    const data = JSON.parse(r.body);
+    this.question = data.question || this.question;
+    this.step = parseInt(data.step ?? Math.max(0, this.step - 1), 10);
+    this.progression = data.progression || this.progression;
+    this.guessed = false;
+    this.guess = null;
+    return this;
+  }
+
+  async continue() {
+    if (!this.guessed) throw new Error('No active guess to reject.');
+    const body = new URLSearchParams({
+      step: String(this.step),
+      progression: '10',
+      sid: '1',
+      cm: this.childMode ? 'true' : 'false',
+      session: this.session,
+      signature: this.signature
+    }).toString();
+    const r = await request('POST', this.host + '/exclude', { jar: this.jar, body });
+    const data = JSON.parse(r.body);
+    this.question = data.question || this.question;
+    this.step = parseInt(data.step ?? this.step + 1, 10);
+    this.progression = data.progression || this.progression;
+    this.guessed = false;
+    this.guess = null;
+    return this;
+  }
+
+  async win() {
+    if (!this.guessed) throw new Error('No guess to confirm.');
+    const body = new URLSearchParams({
+      sid: '1',
+      charac_name: this.guess.name || '',
+      charac_desc: this.guess.description || '',
+      session: this.session,
+      signature: this.signature,
+      pflag_photo: '0'
+    }).toString();
+    await request('POST', this.host + '/choice', { jar: this.jar, body });
+    this.finished = true;
+    return this.guess;
+  }
 }
 
-module.exports = { Akinator };
+module.exports = { Akinator, REGIONS };
+module.exports.default = Akinator;

package/package.json

@@ -1,12 +1,67 @@
 {
   "name": "silent-akinator-pro",
-  "version": "2.0.0",
-  "description": "Standalone High-Speed Akinator SDK. Bypasses Cloudflare using Mobile-Handshake logic. No dependencies required.",
+  "version": "3.0.0",
+  "description": "Akinator API wrapper for Node.js \u2014 fast, working, Cloudflare-safe. The genie that guesses any character. Modern Akinator client with full region, child-mode, undo, and guess-confirm support. (silent-tech)",
   "main": "index.js",
-  "keywords": ["akinator", "aki", "silent-tech", "baileys", "wa-bot", "cloudflare-bypass"],
-  "author": "Silent Tech",
+  "types": "index.d.ts",
+  "type": "commonjs",
+  "scripts": {
+    "test": "node test.js"
+  },
+  "keywords": [
+    "akinator",
+    "akinator-api",
+    "akinator-wrapper",
+    "akinator-client",
+    "akinator-node",
+    "akinator-js",
+    "akinator-bot",
+    "akinator-game",
+    "silent",
+    "silent-tech",
+    "silent-akinator",
+    "silent-akinator-pro",
+    "genie",
+    "guess",
+    "guessing-game",
+    "20-questions",
+    "twenty-questions",
+    "character-guess",
+    "ai-guess",
+    "game",
+    "api",
+    "wrapper",
+    "client",
+    "cloudflare-bypass",
+    "working-akinator",
+    "akinator-2025",
+    "akinator-2026",
+    "discord-bot",
+    "telegram-bot",
+    "whatsapp-bot",
+    "chatbot",
+    "fun-api"
+  ],
+  "author": "Silent Tech <silent.tech.offc@gmail.com>",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/silent-tech/silent-akinator-pro.git"
+  },
+  "homepage": "https://www.npmjs.com/package/silent-akinator-pro",
+  "bugs": {
+    "url": "https://github.com/silent-tech/silent-akinator-pro/issues"
+  },
+  "engines": {
+    "node": ">=14"
+  },
   "dependencies": {
-    "axios": "^1.6.0"
-  }
-}
+    "tough-cookie": "^4.1.4"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "README.md",
+    "LICENSE"
+  ]
+}