silent-akinator-pro 2.0.1 → 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,8 +1,23 @@
 # silent-akinator-pro
 
-> **Silent Tech** — a modern, working Akinator API wrapper for Node.js.
+> 🧞 **The working Akinator API wrapper for Node.js** — fast, reliable, Cloudflare-safe. Modern Akinator client by **Silent Tech**.
 
 [![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)
+
+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
 
@@ -20,12 +35,16 @@ const { Akinator } = require('silent-akinator-pro');
   await aki.start();
 
   console.log(aki.question);
-  await aki.answer('y');         // y / n / idk / p / pn
+  await aki.answer('y');           // y / n / idk / p / pn  (or 0-4)
   console.log(aki.question);
 
-  // ...keep answering until aki.guessed === true
-  if (aki.guess) {
+  while (!aki.guessed && aki.step < 80) {
+    await aki.answer('idk');
+  }
+
+  if (aki.guessed) {
     console.log('Akinator thinks of:', aki.guess.name);
+    await aki.win();
   }
 })();
 ```
@@ -33,20 +52,46 @@ const { Akinator } = require('silent-akinator-pro');
 ## API
 
 ### `new Akinator({ region, childMode })`
-- `region` — `en`, `ar`, `cn`, `de`, `es`, `fr`, `il`, `it`, `jp`, `kr`, `nl`, `pl`, `pt`, `ru`, `tr`, `id`
-- `childMode` — boolean, filters adult content
+- `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 |
+| 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
+
+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

@@ -0,0 +1,245 @@
+
+'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(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.`);
+    }
+
+    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;
+  }
+
+  _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;
+      }
+    }
+
+    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, REGIONS };
+module.exports.default = Akinator;

package/package.json

@@ -1,34 +1,67 @@
 {
   "name": "silent-akinator-pro",
-  "version": "2.0.1",
-  "description": "Silent Tech \u2014 A modern, working Akinator API wrapper for Node.js. Play the genie game programmatically.",
-  "main": "src/index.js",
-  "types": "src/index.d.ts",
+  "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",
+  "types": "index.d.ts",
+  "type": "commonjs",
   "scripts": {
-    "test": "node examples/basic.js"
+    "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",
-    "game",
+    "silent-akinator-pro",
     "genie",
+    "guess",
+    "guessing-game",
+    "20-questions",
+    "twenty-questions",
+    "character-guess",
+    "ai-guess",
+    "game",
     "api",
-    "wrapper"
+    "wrapper",
+    "client",
+    "cloudflare-bypass",
+    "working-akinator",
+    "akinator-2025",
+    "akinator-2026",
+    "discord-bot",
+    "telegram-bot",
+    "whatsapp-bot",
+    "chatbot",
+    "fun-api"
   ],
-  "author": "Silent Tech",
+  "author": "Silent Tech <silent.tech.offc@gmail.com>",
   "license": "MIT",
-  "dependencies": {
-    "axios": "^1.7.7",
-    "cheerio": "^1.0.0"
+  "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"
   },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/silent-tech/silent-akinator-pro"
+  "dependencies": {
+    "tough-cookie": "^4.1.4"
   },
-  "homepage": "https://www.npmjs.com/package/silent-akinator-pro"
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "README.md",
+    "LICENSE"
+  ]
 }

package/src/index.d.ts

@@ -1,33 +0,0 @@
-
-export interface AkinatorOptions {
-  region?: 'en'|'ar'|'cn'|'de'|'es'|'fr'|'il'|'it'|'jp'|'kr'|'nl'|'pl'|'pt'|'ru'|'tr'|'id';
-  childMode?: boolean;
-}
-export interface Guess {
-  id: string;
-  name: string;
-  description: string;
-  image: string;
-}
-export type AnswerInput = 'y'|'n'|'idk'|'p'|'pn'|0|1|2|3|4|string|number;
-
-export class Akinator {
-  constructor(options?: AkinatorOptions);
-  region: string;
-  childMode: boolean;
-  session: string | null;
-  signature: string | null;
-  step: number;
-  progression: string;
-  question: string | null;
-  guess: Guess | null;
-  guessed: boolean;
-  finished: boolean;
-  start(): Promise<{ question: string; step: number; progression: string }>;
-  answer(ans: AnswerInput): Promise<{ question?: string; step?: number; progression?: string; guess?: Guess }>;
-  back(): Promise<{ question: string; step: number; progression: string }>;
-  continue(): Promise<{ question: string; step: number; progression: string }>;
-  win(): Promise<{ winner: Guess | null }>;
-}
-export const REGIONS: string[];
-export default Akinator;

package/src/index.js

@@ -1,244 +0,0 @@
-
-/**
- * silent-akinator-pro
- * Silent Tech — Working Akinator API wrapper.
- *
- * Usage:
- *   const { Akinator } = require('silent-akinator-pro');
- *   const aki = new Akinator({ region: 'en', childMode: false });
- *   await aki.start();
- *   console.log(aki.question);
- *   await aki.answer('y');           // y / n / idk / p / pn
- *   if (aki.guess) console.log(aki.guess);
- */
-
-const axios = require('axios');
-const cheerio = require('cheerio');
-
-const REGIONS = ['en','ar','cn','de','es','fr','il','it','jp','kr','nl','pl','pt','ru','tr','id'];
-
-const ANSWER_MAP = {
-  // yes
-  'y': 0, 'yes': 0, 'oui': 0, '0': 0,
-  // no
-  'n': 1, 'no': 1, 'non': 1, '1': 1,
-  // don't know
-  'idk': 2, 'dk': 2, "don't know": 2, 'dont know': 2, '2': 2,
-  // probably
-  'p': 3, 'probably': 3, '3': 3,
-  // probably not
-  'pn': 4, 'probably not': 4, '4': 4
-};
-
-class Akinator {
-  constructor({ region = 'en', childMode = false } = {}) {
-    if (!REGIONS.includes(region)) {
-      throw new Error(`Invalid region "${region}". Use one of: ${REGIONS.join(', ')}`);
-    }
-    this.region    = region;
-    this.childMode = !!childMode;
-    this.baseURL   = `https://${region}.akinator.com`;
-    this.session   = null;
-    this.signature = null;
-    this.step      = 0;
-    this.progression = '0.00000';
-    this.question  = null;
-    this.guess     = null;          // { name, description, image, id }
-    this.guessed   = false;
-    this.finished  = false;
-    this._client = axios.create({
-      baseURL: this.baseURL,
-      headers: {
-        'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 SilentTech/1.0',
-        'Accept-Language': 'en-US,en;q=0.9',
-        'Origin': this.baseURL,
-        'Referer': `${this.baseURL}/game`,
-        'X-Requested-With': 'XMLHttpRequest'
-      },
-      timeout: 20000,
-      validateStatus: () => true
-    });
-  }
-
-  /** Begin a new game session. */
-  async start() {
-    const body = new URLSearchParams({
-      sid: '1',
-      cm: this.childMode ? 'true' : 'false'
-    }).toString();
-
-    const res = await this._client.post('/game', body, {
-      headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
-    });
-
-    if (res.status >= 400) {
-      throw new Error(`Failed to start game (HTTP ${res.status})`);
-    }
-
-    const html = res.data;
-    const $ = cheerio.load(html);
-
-    // session + signature live in inline JS / hidden inputs
-    const sessionMatch   = html.match(/#session['"]?\s*\)\s*\.val\(\s*['"]?(\d+)['"]?\s*\)/)
-                        || html.match(/name=['"]session['"][^>]*value=['"](\d+)['"]/);
-    const signatureMatch = html.match(/#signature['"]?\s*\)\s*\.val\(\s*['"]?(\d+)['"]?\s*\)/)
-                        || html.match(/name=['"]signature['"][^>]*value=['"](\d+)['"]/);
-
-    if (!sessionMatch || !signatureMatch) {
-      throw new Error('Akinator did not return a valid session. The site layout may have changed.');
-    }
-
-    this.session   = sessionMatch[1];
-    this.signature = signatureMatch[1];
-    this.step      = 0;
-    this.progression = '0.00000';
-    this.guess     = null;
-    this.guessed   = false;
-    this.finished  = false;
-
-    const q = $('#question-label').text().trim() || $('.question-text').text().trim();
-    this.question = q || null;
-    return { question: this.question, step: this.step, progression: this.progression };
-  }
-
-  _normalizeAnswer(a) {
-    if (typeof a === 'number') {
-      if (a < 0 || a > 4) throw new Error('Answer must be 0-4');
-      return a;
-    }
-    const k = String(a).toLowerCase().trim();
-    if (!(k in ANSWER_MAP)) {
-      throw new Error(`Unknown answer "${a}". Use y / n / idk / p / pn or 0-4.`);
-    }
-    return ANSWER_MAP[k];
-  }
-
-  /** Answer the current question. */
-  async answer(ans) {
-    if (!this.session) throw new Error('Call start() first.');
-    if (this.finished) throw new Error('Game already finished.');
-
-    const answer = this._normalizeAnswer(ans);
-
-    const body = new URLSearchParams({
-      step: String(this.step),
-      progression: String(this.progression),
-      sid: '1',
-      cm: this.childMode ? 'true' : 'false',
-      answer: String(answer),
-      step_last_proposition: '',
-      session: this.session,
-      signature: this.signature
-    }).toString();
-
-    const res = await this._client.post('/answer', body, {
-      headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
-    });
-
-    if (res.status >= 400) {
-      throw new Error(`Answer failed (HTTP ${res.status})`);
-    }
-
-    const data = typeof res.data === 'string' ? safeJSON(res.data) : res.data;
-    if (!data) throw new Error('Invalid response from Akinator.');
-
-    // Akinator decided to guess
-    if (data.id_proposition || data.id_base_proposition) {
-      this.guess = {
-        id: data.id_proposition || data.id_base_proposition,
-        name: data.name_proposition,
-        description: data.description_proposition,
-        image: data.photo
-      };
-      this.guessed = true;
-      return { guess: this.guess };
-    }
-
-    this.step        = parseInt(data.step ?? this.step + 1, 10);
-    this.progression = String(data.progression ?? this.progression);
-    this.question    = data.question || null;
-
-    return {
-      question: this.question,
-      step: this.step,
-      progression: this.progression
-    };
-  }
-
-  /** Undo the last answer. */
-  async back() {
-    if (!this.session) throw new Error('Call start() first.');
-    if (this.step <= 0) throw new Error('No previous question.');
-
-    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 res = await this._client.post('/cancel_answer', body, {
-      headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
-    });
-
-    const data = typeof res.data === 'string' ? safeJSON(res.data) : res.data;
-    if (!data) throw new Error('Invalid response from Akinator.');
-
-    this.step        = parseInt(data.step ?? Math.max(0, this.step - 1), 10);
-    this.progression = String(data.progression ?? this.progression);
-    this.question    = data.question || this.question;
-
-    return {
-      question: this.question,
-      step: this.step,
-      progression: this.progression
-    };
-  }
-
-  /** Tell Akinator the guess was wrong and continue playing. */
-  async continue() {
-    if (!this.guessed) throw new Error('No active guess to reject.');
-    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 res = await this._client.post('/exclude', body, {
-      headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
-    });
-
-    const data = typeof res.data === 'string' ? safeJSON(res.data) : res.data;
-    if (!data) throw new Error('Invalid response from Akinator.');
-
-    this.guess = null;
-    this.guessed = false;
-    this.step        = parseInt(data.step ?? this.step + 1, 10);
-    this.progression = String(data.progression ?? this.progression);
-    this.question    = data.question || null;
-
-    return {
-      question: this.question,
-      step: this.step,
-      progression: this.progression
-    };
-  }
-
-  /** Confirm the guess was correct (ends the game). */
-  async win() {
-    this.finished = true;
-    return { winner: this.guess };
-  }
-}
-
-function safeJSON(s) {
-  try { return JSON.parse(s); } catch { return null; }
-}
-
-module.exports = { Akinator, REGIONS, ANSWER_MAP };
-module.exports.default = Akinator;