perplex.js 0.1.6 → 0.2.0

package/LICENSE

@@ -1,20 +1,20 @@
-MIT License
-
-Copyright (c) 2025 DIDELOT Tim
-
-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, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+MIT License
+
+Copyright (c) 2025 DIDELOT Tim
+
+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, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,36 +1,36 @@
-
-# Perplex.js — Minimal Node.js client for Perplexity AI
-
-This small library provides a minimal client to query the Perplexity API.
-
-
-Features:
-- Synchronous request to the SSE endpoint `/rest/sse/perplexity_ask`.
-- Methods: `search` (returns the final response), `streamSearch` (async iterator for streaming messages).
-
-Installation:
-
-```bash
-npm install perplex.js
-```
-
-
-
-Usage (example):
-
-```js
-import { PerplexityClient } from 'perplex.js';
-const c = new PerplexityClient();
-// To use your account, manually export cookies from your browser
-// (for example using a cookie export extension) and save them
-// into `perplexity_cookies.json` as an array of {name, value, domain, ...} objects.
-// Then:
-// const cookies = JSON.parse(fs.readFileSync('./perplexity_cookies.json', 'utf8'));
-// const cookieHeader = cookies.map(c => `${c.name}=${c.value}`).join('; ');
-// const c = new PerplexityClient({ cookies: cookieHeader });
-// await c.search('What is the capital of France?');
-```
-
-Notes:
- - Authentication is performed via session cookies. This library does not require an API key.
- - Endpoints and payload formats aim to match Perplexity's publicly observed API.
+
+# Perplex.js — Minimal Node.js client for Perplexity AI
+
+This small library provides a minimal client to query the Perplexity API.
+
+
+Features:
+- Synchronous request to the SSE endpoint `/rest/sse/perplexity_ask`.
+- Methods: `search` (returns the final response), `streamSearch` (async iterator for streaming messages).
+
+Installation:
+
+```bash
+npm install perplex.js
+```
+
+
+
+Usage (example):
+
+```js
+import { PerplexityClient } from 'perplex.js';
+const c = new PerplexityClient();
+// To use your account, manually export cookies from your browser
+// (for example using a cookie export extension) and save them
+// into `perplexity_cookies.json` as an array of {name, value, domain, ...} objects.
+// Then:
+// const cookies = JSON.parse(fs.readFileSync('./perplexity_cookies.json', 'utf8'));
+// const cookieHeader = cookies.map(c => `${c.name}=${c.value}`).join('; ');
+// const c = new PerplexityClient({ cookies: cookieHeader });
+// await c.search('What is the capital of France?');
+```
+
+Notes:
+ - Authentication is performed via session cookies. This library does not require an API key.
+ - Endpoints and payload formats aim to match Perplexity's publicly observed API.

package/package.json

@@ -1,30 +1,30 @@
-{
-  "name": "perplex.js",
-  "version": "0.1.6",
-  "description": "Minimal Node.js client for the Perplexity API",
-  "type": "module",
-  "main": "src/index.js",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/xFufly/Perplex.js.git"
-  },
-  "files": [
-    "src",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "test": "node example.js",
-    "cli": "node examples/cli.js"
-  },
-  "keywords": ["perplexity", "perplexity.ai", "ai", "client"],
-  "author": "DIDELOT Tim",
-  "license": "MIT",
-  "dependencies": {
-    "undici": "^6.0.0"
-  }
-}
-
-
+{
+  "name": "perplex.js",
+  "version": "0.2.0",
+  "description": "Minimal Node.js client for the Perplexity API",
+  "type": "module",
+  "main": "src/index.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xFufly/Perplex.js.git"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node example.js",
+    "cli": "node examples/cli.js"
+  },
+  "keywords": ["perplexity", "perplexity.ai", "ai", "client"],
+  "author": "DIDELOT Tim",
+  "license": "MIT",
+  "dependencies": {
+    "undici": "^6.0.0"
+  }
+}
+
+

package/src/client.js

@@ -1,290 +1,301 @@
-import {
-    request
-} from 'undici';
-import {
-    parseSSE
-} from './sseParser.js';
-
-function defaultHeaders(cookie) {
-    const headers = {
-        'accept': 'text/event-stream, text/plain, */*',
-        'content-type': 'application/json',
-        'user-agent': 'perplexity-js/0.1',
-    };
-
-    if (cookie) headers['cookie'] = typeof cookie === 'string' ? cookie : Object.entries(cookie).map(([k, v]) => `${k}=${v}`).join('; ');
-    return headers;
-}
-
-export default class PerplexityClient {
-    constructor(options = {}) {
-        // Perplexity access is done via session cookies (or anonymously). No API key is required.
-        this.base = options.base || 'https://www.perplexity.ai';
-        this.version = options.version || '2.18';
-        // optional cookies: either string or object map
-        this.cookies = options.cookies || null;
-    }
-
-    // Static mapping of modes -> available models
-    static modelMap() {
-        return {
-            auto: [null],
-            pro: [null, 'sonar', 'gpt-4.5', 'gpt-4o', 'claude 3.7 sonnet', 'gemini 2.0 flash', 'grok-2'],
-            reasoning: [null, 'r1', 'o3-mini', 'claude 3.7 sonnet', 'gpt5', 'gpt5_thinking', 'claude37sonnetthinking'],
-            'deep research': [null],
-            copilot: ['grok41reasoning']
-        };
-    }
-
-    static getAvailableModels(mode) {
-        const map = PerplexityClient.modelMap();
-        return map[mode] || [];
-    }
-
-    static getAvailableModels(mode = 'auto') {
-        const modelPreferences = {
-            auto: [null],
-            pro: [null, 'sonar', 'gpt-4.5', 'gpt-4o', 'claude 3.7 sonnet', 'gemini 2.0 flash', 'grok-2'],
-            reasoning: [null, 'r1', 'o3-mini', 'claude 3.7 sonnet', 'gpt5', 'gpt5_thinking'],
-            'deep research': [null],
-            copilot: ['grok41reasoning']
-        };
-        return modelPreferences[mode] ?? modelPreferences.auto;
-    }
-
-    // Build the payload for the request
-    _buildPayload(query, opts = {}) {
-        const {
-            mode = 'auto', model = null, sources = ['web'], attachments = [], language = 'en-US', follow_up = null, incognito = false
-        } = opts;
-
-        const attachmentsFinal = attachments.concat(follow_up && follow_up.attachments ? follow_up.attachments : []);
-
-        const modelPreferences = {
-            auto: {
-                null: 'turbo'
-            },
-            pro: {
-                null: 'pplx_pro',
-                'sonar': 'experimental',
-                'gpt-4.5': 'gpt45',
-                'gpt-4o': 'gpt4o',
-                'claude 3.7 sonnet': 'claude2',
-                'gemini 2.0 flash': 'gemini2flash',
-                'grok-2': 'grok'
-            },
-            reasoning: {
-                null: 'pplx_reasoning',
-                'r1': 'r1',
-                'o3-mini': 'o3mini',
-                'claude 3.7 sonnet': 'claude37sonnetthinking',
-                'gpt5': 'gpt5',
-                'gpt5_thinking': 'gpt5thinking'
-            },
-            'deep research': {
-                null: 'pplx_alpha'
-            },
-            copilot: {
-                'grok41reasoning': 'grok41reasoning'
-            }
-        };
-
-        // safe lookup: try to pick the exact key, else fallback to the first available value
-        const mpForMode = modelPreferences[mode] || modelPreferences.auto;
-        let modelPref = null;
-        if (mpForMode) {
-            // if model is null, treat as null key
-            if (model == null) modelPref = mpForMode.null ?? Object.values(mpForMode)[0];
-            else if (Object.prototype.hasOwnProperty.call(mpForMode, model)) modelPref = mpForMode[model];
-            else {
-                // invalid model for the chosen mode
-                const allowed = Object.keys(mpForMode).filter(k => k !== 'null');
-                throw new Error(`Invalid model '${model}' for mode '${mode}'. Allowed: ${allowed.join(', ') || '<none>'}`);
-            }
-        }
-
-        const params = {
-            attachments: attachmentsFinal,
-            frontend_context_uuid: cryptoRandomUUID(),
-            frontend_uuid: cryptoRandomUUID(),
-            is_incognito: incognito,
-            language,
-            last_backend_uuid: follow_up ? follow_up.backend_uuid : null,
-            mode: mode === 'auto' ? 'concise' : 'copilot',
-            model_preference: modelPref,
-            source: 'default',
-            sources,
-            version: this.version
-        };
-
-        return {
-            query_str: query,
-            params
-        };
-    }
-
-    // Simple helper to generate UUID without depending on node <16 helpers
-    async _fetch(url, opts) {
-        const res = await request(url, opts);
-        const {
-            statusCode,
-            headers,
-            body
-        } = res;
-        return {
-            statusCode,
-            headers,
-            body
-        };
-    }
-
-    // Supports both: (query, opts) and positional signature:
-    // search(query, mode='auto', model=null, sources=['web'], files={}, stream=false, language='en-US', follow_up=null, incognito=false)
-    async search(...args) {
-        let query;
-        let opts = {};
-
-        if (args.length === 0) throw new Error('search requires at least a query string');
-
-        query = args[0];
-
-        // If second arg is an object, assume opts form
-        if (args.length >= 2 && typeof args[1] === 'object' && !Array.isArray(args[1])) {
-            opts = args[1];
-        } else if (args.length >= 2) {
-            // positional mapping for backwards compatibility
-            const [, mode = 'auto', model = null, sources = ['web'], files = {}, stream = false, language = 'en-US', follow_up = null, incognito = false] = args;
-            opts = {
-                mode,
-                model,
-                sources,
-                files,
-                stream,
-                language,
-                follow_up,
-                incognito
-            };
-        }
-
-        if (opts.files && Object.keys(opts.files).length) {
-            throw new Error('File upload support is not implemented in this Node client yet');
-        }
-
-        const payload = this._buildPayload(query, opts);
-        const url = `${this.base}/rest/sse/perplexity_ask`;
-
-        const {
-            statusCode,
-            headers,
-            body
-        } = await this._fetch(url, {
-            method: 'POST',
-            body: JSON.stringify(payload),
-            headers: defaultHeaders(this.cookies)
-        });
-
-        if (statusCode >= 400) {
-            const text = await body.text();
-            const err = new Error(`Request failed ${statusCode} - ${text.slice(0, 200)}`);
-            err.status = statusCode;
-            throw err;
-        }
-
-        // collect SSE messages
-        const messages = [];
-        for await (const msg of parseSSE(body)) {
-            if (msg.event === 'message') {
-                let data = msg.data;
-                try {
-                    data = JSON.parse(data);
-                } catch (e) {}
-                if (data && data.text) {
-                    try {
-                        data.text = JSON.parse(data.text);
-                    } catch (e) {}
-                }
-                messages.push(data);
-            } else if (msg.event === 'end_of_stream') {
-                break;
-            }
-        }
-
-        return messages.length ? messages[messages.length - 1] : null;
-    }
-
-    // streamSearch supports same signatures as search
-    async * streamSearch(...args) {
-        let query;
-        let opts = {};
-
-        if (args.length === 0) throw new Error('streamSearch requires at least a query string');
-
-        query = args[0];
-        if (args.length >= 2 && typeof args[1] === 'object' && !Array.isArray(args[1])) {
-            opts = args[1];
-        } else if (args.length >= 2) {
-            const [, mode = 'auto', model = null, sources = ['web'], files = {}, stream = false, language = 'en-US', follow_up = null, incognito = false] = args;
-            opts = {
-                mode,
-                model,
-                sources,
-                files,
-                stream,
-                language,
-                follow_up,
-                incognito
-            };
-        }
-
-        if (opts.files && Object.keys(opts.files).length) {
-            throw new Error('File upload support is not implemented in this Node client yet');
-        }
-
-        const payload = this._buildPayload(query, opts);
-        const url = `${this.base}/rest/sse/perplexity_ask`;
-
-        const {
-            statusCode,
-            headers,
-            body
-        } = await this._fetch(url, {
-            method: 'POST',
-            body: JSON.stringify(payload),
-            headers: defaultHeaders(this.cookies)
-        });
-
-        if (statusCode >= 400) {
-            const text = await body.text();
-            throw new Error(`Request failed ${statusCode} - ${text.slice(0, 200)}`);
-        }
-
-        for await (const msg of parseSSE(body)) {
-            if (msg.event === 'message') {
-                let data = msg.data;
-                try {
-                    data = JSON.parse(data);
-                } catch (e) {}
-                if (data && data.text) {
-                    try {
-                        data.text = JSON.parse(data.text);
-                    } catch (e) {}
-                }
-                yield data;
-            } else if (msg.event === 'end_of_stream') {
-                return;
-            }
-        }
-    }
-}
-
-function cryptoRandomUUID() {
-    // Use global crypto if available
-    if (typeof crypto !== 'undefined' && crypto.randomUUID) return crypto.randomUUID();
-
-    // Fallback simple UUID v4 generator
-    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
-        const r = Math.random() * 16 | 0;
-        const v = c === 'x' ? r : (r & 0x3 | 0x8);
-        return v.toString(16);
-    });
+import {
+    request
+} from 'undici';
+import {
+    parseSSE
+} from './sseParser.js';
+
+function defaultHeaders(cookie) {
+    const headers = {
+        'accept': 'text/event-stream, text/plain, */*',
+        'content-type': 'application/json',
+        'user-agent': 'perplexity-js/0.1',
+    };
+
+    if (cookie) headers['cookie'] = typeof cookie === 'string' ? cookie : Object.entries(cookie).map(([k, v]) => `${k}=${v}`).join('; ');
+    return headers;
+}
+
+export default class PerplexityClient {
+    constructor(options = {}) {
+        // Perplexity access is done via session cookies (or anonymously). No API key is required.
+        this.base = options.base || 'https://www.perplexity.ai';
+        this.version = options.version || '2.18';
+        // optional cookies: either string or object map
+        this.cookies = options.cookies || null;
+    }
+
+    // Static mapping of modes -> available models
+    static modelMap() {
+        return {
+            auto: [null],
+            pro: [null, 'sonar', 'gpt-4.5', 'gpt-4o', 'claude 3.7 sonnet', 'gemini 2.0 flash', 'grok-2'],
+            reasoning: [null, 'r1', 'o3-mini', 'claude 3.7 sonnet', 'gpt5', 'gpt5_thinking', 'claude37sonnetthinking'],
+            'deep research': [null],
+            copilot: [null, 'grok41nonreasoning', 'grok41reasoning', 'sonar', 'gpt52', 'gpt52_thinking', 'gemini30pro', 'gemini30flash', 'gemini30flash_high', 'kimik2thinking', 'claude45sonnet', 'claude45sonnetthinking']
+        };
+    }
+
+    static getAvailableModels(mode) {
+        const map = PerplexityClient.modelMap();
+        return map[mode] || [];
+    }
+
+    static getAvailableModels(mode = 'auto') {
+        const modelPreferences = {
+            auto: [null],
+            pro: [null, 'sonar', 'gpt-4.5', 'gpt-4o', 'claude 3.7 sonnet', 'gemini 2.0 flash', 'grok-2'],
+            reasoning: [null, 'r1', 'o3-mini', 'claude 3.7 sonnet', 'gpt5', 'gpt5_thinking'],
+            'deep research': [null],
+            copilot: [null, 'grok41nonreasoning', 'grok41reasoning', 'sonar', 'gpt52', 'gpt52_thinking', 'gemini30pro', 'gemini30flash', 'gemini30flash_high', 'kimik2thinking', 'claude45sonnet', 'claude45sonnetthinking']
+        };
+        return modelPreferences[mode] ?? modelPreferences.auto;
+    }
+
+    // Build the payload for the request
+    _buildPayload(query, opts = {}) {
+        const {
+            mode = 'auto', model = null, sources = ['web'], attachments = [], language = 'en-US', follow_up = null, incognito = false
+        } = opts;
+
+        const attachmentsFinal = attachments.concat(follow_up && follow_up.attachments ? follow_up.attachments : []);
+
+        const modelPreferences = {
+            auto: {
+                null: 'turbo'
+            },
+            pro: {
+                null: 'pplx_pro',
+                'sonar': 'experimental',
+                'gpt-4.5': 'gpt45',
+                'gpt-4o': 'gpt4o',
+                'claude 3.7 sonnet': 'claude2',
+                'gemini 2.0 flash': 'gemini2flash',
+                'grok-2': 'grok'
+            },
+            reasoning: {
+                null: 'pplx_reasoning',
+                'r1': 'r1',
+                'o3-mini': 'o3mini',
+                'claude 3.7 sonnet': 'claude37sonnetthinking',
+                'gpt5': 'gpt5',
+                'gpt5_thinking': 'gpt5thinking'
+            },
+            'deep research': {
+                null: 'pplx_alpha'
+            },
+            copilot: {
+                null: 'pplx_pro',
+                'grok41nonreasoning': 'grok41nonreasoning',
+                'grok41reasoning': 'grok41reasoning',
+                'sonar': 'experimental',
+                'gpt52': 'gpt52',
+                'gpt52_thinking': 'gpt52_thinking',
+                'gemini30pro': 'gemini30pro',
+                'gemini30flash': 'gemini30flash',
+                'gemini30flash_high': 'gemini30flash_high',
+                'kimik2thinking': 'kimik2thinking',
+                'claude45sonnet': 'claude45sonnet',
+                'claude45sonnetthinking': 'claude45sonnetthinking'
+            }
+        };
+
+        // safe lookup: try to pick the exact key, else fallback to the first available value
+        const mpForMode = modelPreferences[mode] || modelPreferences.auto;
+        let modelPref = null;
+        if (mpForMode) {
+            // if model is null, treat as null key
+            if (model == null) modelPref = mpForMode.null ?? Object.values(mpForMode)[0];
+            else if (Object.prototype.hasOwnProperty.call(mpForMode, model)) modelPref = mpForMode[model];
+            else {
+                // invalid model for the chosen mode
+                const allowed = Object.keys(mpForMode).filter(k => k !== 'null');
+                throw new Error(`Invalid model '${model}' for mode '${mode}'. Allowed: ${allowed.join(', ') || '<none>'}`);
+            }
+        }
+
+        const params = {
+            attachments: attachmentsFinal,
+            frontend_context_uuid: cryptoRandomUUID(),
+            frontend_uuid: cryptoRandomUUID(),
+            is_incognito: incognito,
+            language,
+            last_backend_uuid: follow_up ? follow_up.backend_uuid : null,
+            mode: mode === 'auto' ? 'concise' : 'copilot',
+            model_preference: modelPref,
+            source: 'default',
+            sources,
+            version: this.version
+        };
+
+        return {
+            query_str: query,
+            params
+        };
+    }
+
+    // Simple helper to generate UUID without depending on node <16 helpers
+    async _fetch(url, opts) {
+        const res = await request(url, opts);
+        const {
+            statusCode,
+            headers,
+            body
+        } = res;
+        return {
+            statusCode,
+            headers,
+            body
+        };
+    }
+
+    // Supports both: (query, opts) and positional signature:
+    // search(query, mode='auto', model=null, sources=['web'], files={}, stream=false, language='en-US', follow_up=null, incognito=false)
+    async search(...args) {
+        let query;
+        let opts = {};
+
+        if (args.length === 0) throw new Error('search requires at least a query string');
+
+        query = args[0];
+
+        // If second arg is an object, assume opts form
+        if (args.length >= 2 && typeof args[1] === 'object' && !Array.isArray(args[1])) {
+            opts = args[1];
+        } else if (args.length >= 2) {
+            // positional mapping for backwards compatibility
+            const [, mode = 'auto', model = null, sources = ['web'], files = {}, stream = false, language = 'en-US', follow_up = null, incognito = false] = args;
+            opts = {
+                mode,
+                model,
+                sources,
+                files,
+                stream,
+                language,
+                follow_up,
+                incognito
+            };
+        }
+
+        if (opts.files && Object.keys(opts.files).length) {
+            throw new Error('File upload support is not implemented in this Node client yet');
+        }
+
+        const payload = this._buildPayload(query, opts);
+        const url = `${this.base}/rest/sse/perplexity_ask`;
+
+        const {
+            statusCode,
+            headers,
+            body
+        } = await this._fetch(url, {
+            method: 'POST',
+            body: JSON.stringify(payload),
+            headers: defaultHeaders(this.cookies)
+        });
+
+        if (statusCode >= 400) {
+            const text = await body.text();
+            const err = new Error(`Request failed ${statusCode} - ${text.slice(0, 200)}`);
+            err.status = statusCode;
+            throw err;
+        }
+
+        // collect SSE messages
+        const messages = [];
+        for await (const msg of parseSSE(body)) {
+            if (msg.event === 'message') {
+                let data = msg.data;
+                try {
+                    data = JSON.parse(data);
+                } catch (e) {}
+                if (data && data.text) {
+                    try {
+                        data.text = JSON.parse(data.text);
+                    } catch (e) {}
+                }
+                messages.push(data);
+            } else if (msg.event === 'end_of_stream') {
+                break;
+            }
+        }
+
+        return messages.length ? messages[messages.length - 1] : null;
+    }
+
+    // streamSearch supports same signatures as search
+    async * streamSearch(...args) {
+        let query;
+        let opts = {};
+
+        if (args.length === 0) throw new Error('streamSearch requires at least a query string');
+
+        query = args[0];
+        if (args.length >= 2 && typeof args[1] === 'object' && !Array.isArray(args[1])) {
+            opts = args[1];
+        } else if (args.length >= 2) {
+            const [, mode = 'auto', model = null, sources = ['web'], files = {}, stream = false, language = 'en-US', follow_up = null, incognito = false] = args;
+            opts = {
+                mode,
+                model,
+                sources,
+                files,
+                stream,
+                language,
+                follow_up,
+                incognito
+            };
+        }
+
+        if (opts.files && Object.keys(opts.files).length) {
+            throw new Error('File upload support is not implemented in this Node client yet');
+        }
+
+        const payload = this._buildPayload(query, opts);
+        const url = `${this.base}/rest/sse/perplexity_ask`;
+
+        const {
+            statusCode,
+            headers,
+            body
+        } = await this._fetch(url, {
+            method: 'POST',
+            body: JSON.stringify(payload),
+            headers: defaultHeaders(this.cookies)
+        });
+
+        if (statusCode >= 400) {
+            const text = await body.text();
+            throw new Error(`Request failed ${statusCode} - ${text.slice(0, 200)}`);
+        }
+
+        for await (const msg of parseSSE(body)) {
+            if (msg.event === 'message') {
+                let data = msg.data;
+                try {
+                    data = JSON.parse(data);
+                } catch (e) {}
+                if (data && data.text) {
+                    try {
+                        data.text = JSON.parse(data.text);
+                    } catch (e) {}
+                }
+                yield data;
+            } else if (msg.event === 'end_of_stream') {
+                return;
+            }
+        }
+    }
+}
+
+function cryptoRandomUUID() {
+    // Use global crypto if available
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) return crypto.randomUUID();
+
+    // Fallback simple UUID v4 generator
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
+        const r = Math.random() * 16 | 0;
+        const v = c === 'x' ? r : (r & 0x3 | 0x8);
+        return v.toString(16);
+    });
 }

package/src/index.js

@@ -1,7 +1,7 @@
-import PerplexityClient from './client.js';
-
-// Provide a convenient alias `Client` to match common naming
-const Client = PerplexityClient;
-
-export { PerplexityClient, Client };
-export default PerplexityClient;
+import PerplexityClient from './client.js';
+
+// Provide a convenient alias `Client` to match common naming
+const Client = PerplexityClient;
+
+export { PerplexityClient, Client };
+export default PerplexityClient;

package/src/sseParser.js

@@ -1,48 +1,48 @@
-// Minimal SSE parser that yields {event, data} objects from a ReadableStream body
-export async function* parseSSE(body) {
-    const reader = body[Symbol.asyncIterator] ? body[Symbol.asyncIterator]() : body.getReader();
-
-    let decoder = new TextDecoder('utf-8');
-    let buffer = '';
-
-    for await (const chunk of body) {
-        buffer += typeof chunk === 'string' ? chunk : decoder.decode(chunk, {
-            stream: true
-        });
-
-        let idx;
-        while ((idx = buffer.indexOf('\r\n\r\n')) !== -1) {
-            const raw = buffer.slice(0, idx);
-            buffer = buffer.slice(idx + 4);
-
-            const lines = raw.split(/\r\n/).filter(Boolean);
-            let event = 'message';
-            let data = '';
-
-            for (const line of lines) {
-                if (line.startsWith('event:')) event = line.slice(6).trim();
-                else if (line.startsWith('data:')) data += (data ? '\n' : '') + line.slice(5).trim();
-            }
-
-            yield {
-                event,
-                data
-            };
-        }
-    }
-
-    if (buffer.trim()) {
-        // last partial
-        const lines = buffer.split(/\r\n/).filter(Boolean);
-        let event = 'message';
-        let data = '';
-        for (const line of lines) {
-            if (line.startsWith('event:')) event = line.slice(6).trim();
-            else if (line.startsWith('data:')) data += (data ? '\n' : '') + line.slice(5).trim();
-        }
-        yield {
-            event,
-            data
-        };
-    }
+// Minimal SSE parser that yields {event, data} objects from a ReadableStream body
+export async function* parseSSE(body) {
+    const reader = body[Symbol.asyncIterator] ? body[Symbol.asyncIterator]() : body.getReader();
+
+    let decoder = new TextDecoder('utf-8');
+    let buffer = '';
+
+    for await (const chunk of body) {
+        buffer += typeof chunk === 'string' ? chunk : decoder.decode(chunk, {
+            stream: true
+        });
+
+        let idx;
+        while ((idx = buffer.indexOf('\r\n\r\n')) !== -1) {
+            const raw = buffer.slice(0, idx);
+            buffer = buffer.slice(idx + 4);
+
+            const lines = raw.split(/\r\n/).filter(Boolean);
+            let event = 'message';
+            let data = '';
+
+            for (const line of lines) {
+                if (line.startsWith('event:')) event = line.slice(6).trim();
+                else if (line.startsWith('data:')) data += (data ? '\n' : '') + line.slice(5).trim();
+            }
+
+            yield {
+                event,
+                data
+            };
+        }
+    }
+
+    if (buffer.trim()) {
+        // last partial
+        const lines = buffer.split(/\r\n/).filter(Boolean);
+        let event = 'message';
+        let data = '';
+        for (const line of lines) {
+            if (line.startsWith('event:')) event = line.slice(6).trim();
+            else if (line.startsWith('data:')) data += (data ? '\n' : '') + line.slice(5).trim();
+        }
+        yield {
+            event,
+            data
+        };
+    }
 }