silent-akinator-pro 3.0.0 → 4.0.3

package/LICENSE

@@ -1,9 +1,15 @@
 MIT License
 
-Copyright (c) Silent Tech
+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:
+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 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,42 +1,45 @@
 # silent-akinator-pro
 
-> 🧞 **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.
+> **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 silent-akinator-pro?
+## Why this package
 
-- ✅ **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
+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
 
-  console.log(aki.question);
-  await aki.answer('y');           // y / n / idk / p / pn  (or 0-4)
-  console.log(aki.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);
 
   while (!aki.guessed && aki.step < 80) {
     await aki.answer('idk');
@@ -44,33 +47,29 @@ const { Akinator } = require('silent-akinator-pro');
 
   if (aki.guessed) {
     console.log('Akinator thinks of:', aki.guess.name);
-    await aki.win();
+    await aki.choice();   // confirm
   }
 })();
 ```
 
 ## 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           |
+| `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 Akinator = require('silent-akinator-pro');
 const games = new Map();
 
 client.on('messageCreate', async (msg) => {
@@ -78,20 +77,22 @@ client.on('messageCreate', async (msg) => {
     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)) {
+    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) msg.reply(`Is it **${aki.guess.name}**? (${aki.guess.description})`);
-    else msg.reply(aki.question);
+    if (aki.guessed) return msg.reply(`Is it **${aki.guess.name}**? (${aki.guess.description})`);
+    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.
+
+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

@@ -1,26 +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 interface AkinatorOptions {
-  region?: 'en'|'ar'|'cn'|'de'|'es'|'fr'|'il'|'it'|'jp'|'kr'|'nl'|'pl'|'pt'|'ru'|'tr'|'id';
-  childMode?: boolean;
+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 AkinatorGuess {
-  id?: string; name?: string; description?: string; photo?: string; pseudo?: string;
+
+export interface Guess {
+  id?: string;
+  name?: string;
+  description?: string;
+  photo?: string;
+  pseudo?: string;
+  flag_photo?: string | number;
 }
-export class Akinator {
+
+export declare class Akinator {
   constructor(opts?: AkinatorOptions);
-  region: string;
+  region: Region;
   childMode: boolean;
-  question: string | null;
+  session: string | null;
+  signature: string | null;
   step: number;
   progression: string;
-  guess: AkinatorGuess | null;
+  question: string | null;
   guessed: boolean;
+  guess: Guess | null;
   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>;
+
+  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 const REGIONS: Record<string,string>;
+
 export default Akinator;
+export const REGIONS: Region[];

package/index.js

@@ -1,245 +1,260 @@
-
 'use strict';
 /*!
  * silent-akinator-pro
- * Working Akinator API wrapper (HTML-form endpoints, Cloudflare-safe).
+ * 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 { 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 { 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, "don't know": 2, dk: 2, '2': 2,
+  idk: 2, dk: 2, "don't know": 2, '2': 2,
   p: 3, probably: 3, '3': 3,
-  pn: 4, 'probably not': 4, '4': 4
+  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();
-  });
-}
+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',
+};
 
-function extract(html, re) {
-  const m = html.match(re);
-  return m ? m[1] : null;
-}
+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 = {}) {
-    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.`);
+    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   = 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.session     = null;
+    this.signature   = null;
+    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;
+    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.`);
+    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 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 });
+
+    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(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;
-      }
-    }
+    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
+        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 this;
+      return { guess: this.guess, step: Number(this.step), progression: this.progression };
     }
 
-    this.question = data.question || this.question;
-    this.step = parseInt(data.step ?? this.step + 1, 10);
+    this.step        = parseInt(data.step ?? this.step + 1, 10);
     this.progression = data.progression || this.progression;
-    this.guessed = false;
-    this.guess = null;
-    return this;
+    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('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);
+    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.guessed = false;
-    this.guess = null;
-    return this;
+    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;
   }
 
-  async continue() {
+  /** Reject the current guess and continue playing. */
+  async exclude() {
     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);
+    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.guessed = false;
-    this.guess = null;
-    return this;
+    this.question    = data.question    || this.question;
+    this.guessed     = false;
+    this.guess       = null;
+    return { question: this.question, step: this.step, progression: this.progression };
   }
 
-  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 });
+  /** 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, REGIONS };
-module.exports.default = Akinator;
+module.exports          = Akinator;
+module.exports.default  = Akinator;
+module.exports.Akinator = Akinator;
+module.exports.REGIONS  = REGIONS;

package/package.json

@@ -1,46 +1,62 @@
 {
   "name": "silent-akinator-pro",
-  "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)",
+  "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 test.js"
   },
   "keywords": [
     "akinator",
     "akinator-api",
-    "akinator-wrapper",
+    "akinator-bot",
     "akinator-client",
+    "akinator-sdk",
+    "akinator-wrapper",
     "akinator-node",
     "akinator-js",
-    "akinator-bot",
-    "akinator-game",
-    "silent",
-    "silent-tech",
-    "silent-akinator",
-    "silent-akinator-pro",
+    "akinator-2025",
+    "akinator-2026",
+    "working-akinator",
+    "akinator-fix",
+    "akinator-cloudflare",
+    "cloudflare-bypass",
+    "akinator-403",
+    "aki-api",
+    "aki",
     "genie",
-    "guess",
-    "guessing-game",
     "20-questions",
     "twenty-questions",
+    "guessing-game",
     "character-guess",
     "ai-guess",
     "game",
-    "api",
-    "wrapper",
-    "client",
-    "cloudflare-bypass",
-    "working-akinator",
-    "akinator-2025",
-    "akinator-2026",
+    "ai-game",
+    "quiz",
+    "trivia",
+    "fun-api",
     "discord-bot",
+    "discord-akinator",
     "telegram-bot",
     "whatsapp-bot",
+    "baileys",
     "chatbot",
-    "fun-api"
+    "scraper",
+    "typescript",
+    "esm",
+    "cjs",
+    "silent",
+    "silent-tech",
+    "silent-akinator",
+    "silent-akinator-pro"
   ],
   "author": "Silent Tech <silent.tech.offc@gmail.com>",
   "license": "MIT",
@@ -48,20 +64,15 @@
     "type": "git",
     "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": ">=14"
+    "node": ">=18"
   },
   "dependencies": {
-    "tough-cookie": "^4.1.4"
-  },
-  "files": [
-    "index.js",
-    "index.d.ts",
-    "README.md",
-    "LICENSE"
-  ]
+    "undici": "^6.19.8",
+    "cheerio": "^1.0.0"
+  }
 }