jsonseo 1.0.0 → 1.0.1

package/README.md

@@ -23,7 +23,7 @@ bun add jsonseo
 ```ts
 import { JsonSeoClient } from 'jsonseo';
 
-const client = new JsonSeoClient('ВАШ_КЛЮЧ');
+const client = new JsonSeoClient('YOUR_KEY');
 
 const serp = await client.yandex({
   text: 'купить ноутбук',
@@ -462,7 +462,7 @@ try {
 
 ```ts
 const client = new JsonSeoClient({
-  apiKey: 'ВАШ_КЛЮЧ',
+  apiKey: 'YOUR_KEY',
   baseUrl: 'https://jsonseo.ru/api', // адрес API
   timeoutMs: 300_000,                // сколько ждать ответа на одну попытку
   attempts: 3,                       // всего попыток, вместе с первой

package/dist/cjs/client.d.ts

@@ -6,7 +6,7 @@ import type { BalanceResponse, DirectResponse, GeoipResponse, GoogleRegionsRespo
  * Клиент JSON SEO API.
  *
  * ```ts
- * const client = new JsonSeoClient('ВАШ_КЛЮЧ');
+ * const client = new JsonSeoClient('YOUR_KEY');
  * const serp = await client.yandex({ text: 'купить ноутбук', region: 213 });
  * ```
  */

package/dist/cjs/client.js

@@ -7,7 +7,7 @@ const http_js_1 = require("./http.js");
  * Клиент JSON SEO API.
  *
  * ```ts
- * const client = new JsonSeoClient('ВАШ_КЛЮЧ');
+ * const client = new JsonSeoClient('YOUR_KEY');
  * const serp = await client.yandex({ text: 'купить ноутбук', region: 213 });
  * ```
  */

package/dist/cjs/http.js

@@ -20,7 +20,7 @@ const KNOWN_OPTIONS = {
     fetch: true,
 };
 const KNOWN_OPTION_NAMES = Object.keys(KNOWN_OPTIONS);
-const VERSION = '1.0.0';
+const VERSION = '1.0.1';
 /**
  * Транспорт: собирает запрос, разбирает ответ и решает, повторять ли отказ.
  *
@@ -28,9 +28,18 @@ const VERSION = '1.0.0';
  */
 class HttpClient {
     constructor(options) {
-        if (typeof options.apiKey !== 'string' || options.apiKey.trim() === '') {
+        // Обрезаем ровно тот же набор, что и остальные SDK: родной trim в
+        // каждом языке свой, и один ключ принимался бы по-разному.
+        const apiKey = typeof options.apiKey === 'string' ? options.apiKey.replace(/^[ \t\n\r]+|[ \t\n\r]+$/g, '') : '';
+        if (apiKey === '') {
             throw new errors_js_1.InvalidArgumentError('Нужен API-ключ: возьмите его в личном кабинете на https://jsonseo.ru.');
         }
+        // Заголовок Authorization не переносит не-ASCII и управляющие символы:
+        // с таким ключом он не соберётся, и сервис ответит «токен не
+        // предоставлен» вместо внятной ошибки.
+        if (/[^\x20-\x7E]/.test(apiKey)) {
+            throw new errors_js_1.InvalidArgumentError('API-ключ содержит символы вне ASCII: проверьте, что он скопирован целиком и без лишних знаков.');
+        }
         // undefined из спреда частичного конфига — не настройка, а её отсутствие.
         const unknown = Object.keys(options).filter((name) => !KNOWN_OPTION_NAMES.includes(name) && options[name] !== undefined);
         if (unknown.length > 0) {
@@ -48,7 +57,7 @@ class HttpClient {
         if (!fetchImpl) {
             throw new errors_js_1.InvalidArgumentError('В этой среде нет глобального fetch. Нужен Node 18+, Bun или Deno — либо передайте свою реализацию настройкой fetch.');
         }
-        this.apiKey = options.apiKey.trim();
+        this.apiKey = apiKey;
         this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
         this.timeoutMs = options.timeoutMs ?? 300000;
         this.attempts = options.attempts ?? 3;

package/dist/esm/client.d.ts

@@ -6,7 +6,7 @@ import type { BalanceResponse, DirectResponse, GeoipResponse, GoogleRegionsRespo
  * Клиент JSON SEO API.
  *
  * ```ts
- * const client = new JsonSeoClient('ВАШ_КЛЮЧ');
+ * const client = new JsonSeoClient('YOUR_KEY');
  * const serp = await client.yandex({ text: 'купить ноутбук', region: 213 });
  * ```
  */

package/dist/esm/client.js

@@ -4,7 +4,7 @@ import { HttpClient } from './http.js';
  * Клиент JSON SEO API.
  *
  * ```ts
- * const client = new JsonSeoClient('ВАШ_КЛЮЧ');
+ * const client = new JsonSeoClient('YOUR_KEY');
  * const serp = await client.yandex({ text: 'купить ноутбук', region: 213 });
  * ```
  */

package/dist/esm/http.js

@@ -16,7 +16,7 @@ const KNOWN_OPTIONS = {
     fetch: true,
 };
 const KNOWN_OPTION_NAMES = Object.keys(KNOWN_OPTIONS);
-const VERSION = '1.0.0';
+const VERSION = '1.0.1';
 /**
  * Транспорт: собирает запрос, разбирает ответ и решает, повторять ли отказ.
  *
@@ -24,9 +24,18 @@ const VERSION = '1.0.0';
  */
 export class HttpClient {
     constructor(options) {
-        if (typeof options.apiKey !== 'string' || options.apiKey.trim() === '') {
+        // Обрезаем ровно тот же набор, что и остальные SDK: родной trim в
+        // каждом языке свой, и один ключ принимался бы по-разному.
+        const apiKey = typeof options.apiKey === 'string' ? options.apiKey.replace(/^[ \t\n\r]+|[ \t\n\r]+$/g, '') : '';
+        if (apiKey === '') {
             throw new InvalidArgumentError('Нужен API-ключ: возьмите его в личном кабинете на https://jsonseo.ru.');
         }
+        // Заголовок Authorization не переносит не-ASCII и управляющие символы:
+        // с таким ключом он не соберётся, и сервис ответит «токен не
+        // предоставлен» вместо внятной ошибки.
+        if (/[^\x20-\x7E]/.test(apiKey)) {
+            throw new InvalidArgumentError('API-ключ содержит символы вне ASCII: проверьте, что он скопирован целиком и без лишних знаков.');
+        }
         // undefined из спреда частичного конфига — не настройка, а её отсутствие.
         const unknown = Object.keys(options).filter((name) => !KNOWN_OPTION_NAMES.includes(name) && options[name] !== undefined);
         if (unknown.length > 0) {
@@ -44,7 +53,7 @@ export class HttpClient {
         if (!fetchImpl) {
             throw new InvalidArgumentError('В этой среде нет глобального fetch. Нужен Node 18+, Bun или Deno — либо передайте свою реализацию настройкой fetch.');
         }
-        this.apiKey = options.apiKey.trim();
+        this.apiKey = apiKey;
         this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
         this.timeoutMs = options.timeoutMs ?? 300000;
         this.attempts = options.attempts ?? 3;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsonseo",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Официальный SDK JSON SEO API: выдача Яндекса, Google и Bing, Вордстат, прогноз Директа и геолокация по IP",
   "license": "MIT",
   "homepage": "https://jsonseo.ru",