silent-akinator-pro 2.0.0 → 2.0.1

package/README.md

@@ -1,18 +1,52 @@
-# 🧞 SILENT-AKINATOR PRO 🧞
-### BY SILENT TECH
+# silent-akinator-pro
 
-The most reliable Akinator API for developers.
+> **Silent Tech** — a modern, working Akinator API wrapper for Node.js.
 
-## 🚀 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)
 
-## 💻 USAGE
-```javascript
+## 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
+  console.log(aki.question);
+
+  // ...keep answering until aki.guessed === true
+  if (aki.guess) {
+    console.log('Akinator thinks of:', aki.guess.name);
+  }
 })();
 ```
+
+## 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 |
+
+### Properties
+`question`, `step`, `progression`, `guess`, `guessed`, `finished`.
+
+## License
+MIT © Silent Tech

package/package.json

@@ -1,12 +1,34 @@
 {
   "name": "silent-akinator-pro",
-  "version": "2.0.0",
-  "description": "Standalone High-Speed Akinator SDK. Bypasses Cloudflare using Mobile-Handshake logic. No dependencies required.",
-  "main": "index.js",
-  "keywords": ["akinator", "aki", "silent-tech", "baileys", "wa-bot", "cloudflare-bypass"],
+  "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",
+  "scripts": {
+    "test": "node examples/basic.js"
+  },
+  "keywords": [
+    "akinator",
+    "silent",
+    "silent-tech",
+    "silent-akinator",
+    "game",
+    "genie",
+    "api",
+    "wrapper"
+  ],
   "author": "Silent Tech",
   "license": "MIT",
   "dependencies": {
-    "axios": "^1.6.0"
-  }
-}
+    "axios": "^1.7.7",
+    "cheerio": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=14"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/silent-tech/silent-akinator-pro"
+  },
+  "homepage": "https://www.npmjs.com/package/silent-akinator-pro"
+}

package/src/index.d.ts

@@ -0,0 +1,33 @@
+
+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

@@ -0,0 +1,244 @@
+
+/**
+ * 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;

package/index.js

@@ -1,86 +0,0 @@
-const axios = require('axios');
-
-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/`
-        };
-    }
-
-    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.");
-        }
-    }
-
-    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.");
-        }
-    }
-
-    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;
-        }
-    }
-}
-
-module.exports = { Akinator };