silent-akinator-pro 2.0.1 → 4.0.3

package/LICENSE

@@ -0,0 +1,15 @@
+MIT License
+
+Copyright (c) 2026 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,52 +1,98 @@
 # silent-akinator-pro
 
-> **Silent Tech** — a modern, working Akinator API wrapper for Node.js.
-
 [![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 working Akinator API for Node.js — the only akinator wrapper that still works in 2025 / 2026** after Cloudflare blocked the legacy `api-en4.akinator.com/ws/*` endpoints. Fast, zero-config, Promise-based, fully typed. By **Silent Tech**.
+
+The genie / twenty-questions / character-guessing SDK for **Discord bots, Telegram bots, WhatsApp bots, web games, and CLIs**.
+
+## Why this package
+
+Most akinator npm packages (`aki-api`, `akinator-api-node`, older `silent-akinator`, etc.) hit JSON endpoints that now return **HTTP 403 / Cloudflare Just-a-moment**. This package uses the **real HTML form flow** the actual website uses — `POST /game`, `/answer`, `/cancel_answer`, `/exclude`, `/list`, `/choice` — no TLS spoofing, no proxies, no `curl-impersonate`. Just clean `undici` + `cheerio`.
+
+- Working in 2025 / 2026 (Cloudflare-safe)
+- 22 regions including `en`, `en_objects`, `en_animals`, `fr`, `de`, `es`, `it`, `pt`, `ru`, `ar`, `jp`, `kr`, `cn`, `nl`, `pl`, `tr`, `il`, `id`
+- Child mode supported
+- Full game lifecycle: `start`, `answer`, `back`, `win`, `exclude`, `choice`
+- TypeScript types included
+- Tiny: only `undici` + `cheerio`
+- MIT licensed
 
 ## Install
 
 ```bash
-npm install silent-akinator-pro
+npm i silent-akinator-pro
 ```
 
-## Quick Start
+## Usage
 
 ```js
-const { Akinator } = require('silent-akinator-pro');
+const Akinator = require('silent-akinator-pro');
 
 (async () => {
   const aki = new Akinator({ region: 'en', childMode: false });
   await aki.start();
+  console.log(aki.question);                   // first question
+
+  // 0=yes 1=no 2=idk 3=probably 4=probably-not
+  // (or 'y' / 'n' / 'idk' / 'p' / 'pn')
+  const r = await aki.answer('y');
+  console.log(r.question, r.progression);
 
-  console.log(aki.question);
-  await aki.answer('y');         // y / n / idk / p / pn
-  console.log(aki.question);
+  while (!aki.guessed && aki.step < 80) {
+    await aki.answer('idk');
+  }
 
-  // ...keep answering until aki.guessed === true
-  if (aki.guess) {
+  if (aki.guessed) {
     console.log('Akinator thinks of:', aki.guess.name);
+    await aki.choice();   // confirm
   }
 })();
 ```
 
 ## 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
-
-### 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; returns first question     |
+| `answer(a)`   | Submit answer (`0..4` or `y/n/idk/p/pn`)     |
+| `back()`      | Undo last answer                             |
+| `win()`       | Force Akinator to guess now                  |
+| `exclude()`   | Reject the guess and continue                |
+| `choice()`    | Confirm the guess (close session)            |
 
 ### Properties
-`question`, `step`, `progression`, `guess`, `guessed`, `finished`.
+`region`, `childMode`, `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);
+    return msg.reply(aki.question);
+  }
+  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) return msg.reply(`Is it **${aki.guess.name}**? (${aki.guess.description})`);
+    msg.reply(aki.question);
+  }
+});
+```
+
+## Keywords
+
+akinator, akinator api, working akinator, akinator 2025, akinator 2026, akinator cloudflare bypass, akinator 403 fix, akinator discord bot, akinator telegram bot, akinator whatsapp bot, twenty questions, character guessing game, genie sdk, node akinator client, aki-api alternative, silent tech, silent-akinator, silent-akinator-pro.
 
 ## License
-MIT © Silent Tech
+
+MIT (c) Silent Tech

package/index.d.ts

@@ -0,0 +1,51 @@
+export type Region =
+  | 'en' | 'en2' | 'en_objects' | 'en_animals' | 'ar' | 'cn' | 'de' | 'es'
+  | 'fr' | 'fr_objects' | 'fr_animals' | 'il' | 'it' | 'jp' | 'jp_animals'
+  | 'kr' | 'nl' | 'pl' | 'pt' | 'ru' | 'tr' | 'id';
+
+export type Answer = 0 | 1 | 2 | 3 | 4 | 'y' | 'n' | 'idk' | 'p' | 'pn'
+  | 'yes' | 'no' | 'probably' | 'probably not';
+
+export interface AkinatorOptions { region?: Region; childMode?: boolean; }
+
+export interface Question {
+  question: string;
+  step: number;
+  progression: string;
+  question_id?: string;
+  completion?: string;
+  answers?: string[];
+}
+
+export interface Guess {
+  id?: string;
+  name?: string;
+  description?: string;
+  photo?: string;
+  pseudo?: string;
+  flag_photo?: string | number;
+}
+
+export declare class Akinator {
+  constructor(opts?: AkinatorOptions);
+  region: Region;
+  childMode: boolean;
+  session: string | null;
+  signature: string | null;
+  step: number;
+  progression: string;
+  question: string | null;
+  guessed: boolean;
+  guess: Guess | null;
+  finished: boolean;
+
+  start(): Promise<Question>;
+  answer(a: Answer): Promise<Question | { guess: Guess; step: number; progression: string }>;
+  back(): Promise<Question>;
+  win(): Promise<any>;
+  exclude(): Promise<Question>;
+  choice(): Promise<Guess>;
+}
+
+export default Akinator;
+export const REGIONS: Region[];

package/index.js

@@ -0,0 +1,260 @@
+'use strict';
+/*!
+ * silent-akinator-pro
+ * Working Akinator API client (2025/2026) — bypasses Cloudflare 403 by using
+ * the real HTML form-POST flow instead of the deprecated /ws JSON endpoints.
+ *
+ * Answers: 0=yes  1=no  2=idk  3=probably  4=probably-not
+ * (c) Silent Tech — MIT
+ */
+const { request } = require('undici');
+const { load }    = require('cheerio');
+
+const REGIONS = [
+  'en','en2','en_objects','en_animals','ar','cn','de','es','fr','fr_objects',
+  'fr_animals','il','it','jp','jp_animals','kr','nl','pl','pt','ru','tr','id',
+];
+
+const ANSWER_MAP = {
+  y: 0, yes: 0, '0': 0,
+  n: 1, no: 1, '1': 1,
+  idk: 2, dk: 2, "don't know": 2, '2': 2,
+  p: 3, probably: 3, '3': 3,
+  pn: 4, 'probably not': 4, '4': 4,
+};
+
+const BASE_HEADERS = {
+  'content-type'    : 'application/x-www-form-urlencoded',
+  'user-agent'      : 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
+  'x-requested-with': 'XMLHttpRequest',
+};
+
+const form = (obj) => new URLSearchParams(
+  Object.fromEntries(Object.entries(obj).map(([k, v]) => [k, String(v)]))
+).toString();
+
+class Akinator {
+  /**
+   * @param {object}  opts
+   * @param {string}  [opts.region='en']      one of REGIONS
+   * @param {boolean} [opts.childMode=false]  safe-mode filter
+   */
+  constructor(opts = {}) {
+    const { region = 'en', childMode = false } = opts;
+    if (!REGIONS.includes(region)) {
+      throw new Error(`Invalid region "${region}". Valid: ${REGIONS.join(', ')}`);
+    }
+    this.region    = region;
+    this.childMode = !!childMode;
+    this.uri       = `https://${region}.akinator.com`;
+    this.headers   = { ...BASE_HEADERS };
+
+    this.session     = null;
+    this.signature   = null;
+    this.step        = 0;
+    this.progression = '0.00000';
+    this.question    = null;
+    this.guessed     = false;
+    this.guess       = null;
+    this.finished    = false;
+  }
+
+  _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 or 0..4.`);
+    }
+    return code;
+  }
+
+  /** Start a new game. Resolves with the first question. */
+  async start() {
+    const res = await request(`${this.uri}/game`, {
+      method: 'POST',
+      headers: this.headers,
+      body: form({ cm: this.childMode, sid: 1 }),
+      maxRedirections: 5,
+    });
+    if (res.statusCode !== 200) {
+      throw new Error(`Akinator /game returned ${res.statusCode}`);
+    }
+    const html = await res.body.text();
+    const $    = load(html);
+
+    this.session   = $('#askSoundlike > #session').attr('value')
+                  || $('#session').attr('value');
+    this.signature = $('#askSoundlike > #signature').attr('value')
+                  || $('#signature').attr('value');
+    this.question  = $('#question-label').text().trim()
+                  || $('.bubble-body .question-text').text().trim();
+
+    if (!this.session || !this.signature) {
+      throw new Error('Failed to parse session/signature from Akinator response.');
+    }
+    this.step        = 0;
+    this.progression = '0.00000';
+    return {
+      question: this.question,
+      step: this.step,
+      progression: this.progression,
+      answers: ['yes', 'no', 'idk', 'probably', 'probably not'],
+    };
+  }
+
+  /**
+   * Submit an answer.
+   * @param {0|1|2|3|4|string} a
+   */
+  async answer(a) {
+    if (this.finished) throw new Error('Game already finished.');
+    if (!this.session) throw new Error('Call start() first.');
+    const ans = this._answerCode(a);
+
+    const res = await request(`${this.uri}/answer`, {
+      method: 'POST',
+      headers: this.headers,
+      body: form({
+        step                : this.step,
+        progression         : this.progression,
+        sid                 : 1,
+        cm                  : this.childMode,
+        answer              : ans,
+        step_last_proposition: '',
+        session             : this.session,
+        signature           : this.signature,
+      }),
+    });
+
+    let data;
+    try { data = JSON.parse(await res.body.text()); }
+    catch { throw new Error(`/answer returned non-JSON (status ${res.statusCode}).`); }
+
+    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,
+        flag_photo  : data.flag_photo,
+      };
+      this.guessed = true;
+      return { guess: this.guess, step: Number(this.step), progression: this.progression };
+    }
+
+    this.step        = parseInt(data.step ?? this.step + 1, 10);
+    this.progression = data.progression || this.progression;
+    this.question    = data.question    || this.question;
+    this.guessed     = false;
+    this.guess       = null;
+    return {
+      question     : this.question,
+      step         : this.step,
+      progression  : this.progression,
+      question_id  : data.question_id,
+      completion   : data.completion,
+    };
+  }
+
+  /** Undo the last answer. */
+  async back() {
+    if (this.step <= 0) throw new Error('Nothing to undo.');
+    const res = await request(`${this.uri}/cancel_answer`, {
+      method: 'POST',
+      headers: this.headers,
+      body: form({
+        step       : this.step,
+        progression: this.progression,
+        sid        : 1,
+        cm         : this.childMode,
+        session    : this.session,
+        signature  : this.signature,
+      }),
+    });
+    const data = JSON.parse(await res.body.text());
+    this.step        = parseInt(data.step ?? Math.max(0, this.step - 1), 10);
+    this.progression = data.progression || this.progression;
+    this.question    = data.question    || this.question;
+    this.guessed     = false;
+    this.guess       = null;
+    return { question: this.question, step: this.step, progression: this.progression };
+  }
+
+  /** Force Akinator to make its best guess now. */
+async win() {
+  const res = await request(`${this.uri}/list`, {
+  method: 'POST',
+  headers: this.headers,
+  body: form({
+  step          : this.step,
+  progression   : this.progression,
+  sid           : 1,
+  cm            : this.childMode,
+  mode_question : 0,
+  session       : this.session,
+  signature     : this.signature,
+  }),
+  });
+  const text = await res.body.text();
+  let data;
+  try { data = JSON.parse(text); }
+  catch {
+    // /list sometimes returns HTML when progression is too low or session expired.
+    // Fall back to current guess or last known state.
+    if (this.guess) return this.guess;
+    throw new Error(`/list returned non-JSON (status ${res.statusCode}). Try answering more questions before calling win().`);
+  }
+  this.guessed = true;
+  this.guess   = data;
+  return data;
+  }
+
+  /** Reject the current guess and continue playing. */
+  async exclude() {
+    if (!this.guessed) throw new Error('No active guess to reject.');
+    const res = await request(`${this.uri}/exclude`, {
+      method: 'POST',
+      headers: this.headers,
+      body: form({
+        step       : this.step,
+        progression: this.progression,
+        sid        : 1,
+        cm         : this.childMode,
+        session    : this.session,
+        signature  : this.signature,
+      }),
+    });
+    const data = JSON.parse(await res.body.text());
+    this.step        = parseInt(data.step ?? this.step + 1, 10);
+    this.progression = data.progression || this.progression;
+    this.question    = data.question    || this.question;
+    this.guessed     = false;
+    this.guess       = null;
+    return { question: this.question, step: this.step, progression: this.progression };
+  }
+
+  /** Confirm Akinator's guess (closes the session). */
+  async choice() {
+    if (!this.guess) throw new Error('No guess to confirm.');
+    await request(`${this.uri}/choice`, {
+      method: 'POST',
+      headers: this.headers,
+      body: form({
+        sid         : 1,
+        charac_name : this.guess.name        || '',
+        charac_desc : this.guess.description || '',
+        session     : this.session,
+        signature   : this.signature,
+        pflag_photo : 0,
+      }),
+    });
+    this.finished = true;
+    return this.guess;
+  }
+}
+
+module.exports          = Akinator;
+module.exports.default  = Akinator;
+module.exports.Akinator = Akinator;
+module.exports.REGIONS  = REGIONS;

package/package.json

@@ -1,34 +1,78 @@
 {
   "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": "4.0.3",
+  "description": "Working Akinator API for Node.js (2025/2026). Fast, lightweight, Cloudflare-safe akinator client / wrapper / SDK / bot library \u2014 supports 22 regions, child mode, undo, win, exclude. The genie / 20-questions / character-guessing API that actually works after the api-en4 shutdown. Drop-in replacement for aki-api and akinator-api.",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "type": "commonjs",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
-    "test": "node examples/basic.js"
+    "test": "node test.js"
   },
   "keywords": [
     "akinator",
+    "akinator-api",
+    "akinator-bot",
+    "akinator-client",
+    "akinator-sdk",
+    "akinator-wrapper",
+    "akinator-node",
+    "akinator-js",
+    "akinator-2025",
+    "akinator-2026",
+    "working-akinator",
+    "akinator-fix",
+    "akinator-cloudflare",
+    "cloudflare-bypass",
+    "akinator-403",
+    "aki-api",
+    "aki",
+    "genie",
+    "20-questions",
+    "twenty-questions",
+    "guessing-game",
+    "character-guess",
+    "ai-guess",
+    "game",
+    "ai-game",
+    "quiz",
+    "trivia",
+    "fun-api",
+    "discord-bot",
+    "discord-akinator",
+    "telegram-bot",
+    "whatsapp-bot",
+    "baileys",
+    "chatbot",
+    "scraper",
+    "typescript",
+    "esm",
+    "cjs",
     "silent",
     "silent-tech",
     "silent-akinator",
-    "game",
-    "genie",
-    "api",
-    "wrapper"
+    "silent-akinator-pro"
   ],
-  "author": "Silent Tech",
+  "author": "Silent Tech <silent.tech.offc@gmail.com>",
   "license": "MIT",
-  "dependencies": {
-    "axios": "^1.7.7",
-    "cheerio": "^1.0.0"
-  },
-  "engines": {
-    "node": ">=14"
-  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/silent-tech/silent-akinator-pro"
+    "url": "git+https://github.com/silent-tech/silent-akinator-pro.git"
   },
-  "homepage": "https://www.npmjs.com/package/silent-akinator-pro"
+  "homepage": "https://github.com/silent-tech/silent-akinator-pro#readme",
+  "bugs": {
+    "url": "https://github.com/silent-tech/silent-akinator-pro/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "undici": "^6.19.8",
+    "cheerio": "^1.0.0"
+  }
 }

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;