itd-api 0.6.0 → 0.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -6
- package/dist/index.cjs +473 -9378
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +300 -4830
- package/dist/index.d.ts +300 -4830
- package/dist/index.js +350 -9259
- package/dist/index.js.map +1 -1
- package/dist/{node.cjs → node/index.cjs} +16 -14
- package/dist/node/index.cjs.map +1 -0
- package/dist/{node.d.cts → node/index.d.cts} +4 -3
- package/dist/{node.d.ts → node/index.d.ts} +4 -3
- package/dist/{node.js → node/index.js} +5 -3
- package/dist/node/index.js.map +1 -0
- package/dist/realtime/index.cjs +165 -0
- package/dist/realtime/index.cjs.map +1 -0
- package/dist/realtime/index.d.cts +51 -0
- package/dist/realtime/index.d.ts +51 -0
- package/dist/realtime/index.js +120 -0
- package/dist/realtime/index.js.map +1 -0
- package/dist/rest/index.cjs +334 -0
- package/dist/rest/index.cjs.map +1 -0
- package/dist/rest/index.d.cts +138 -0
- package/dist/rest/index.d.ts +138 -0
- package/dist/rest/index.js +238 -0
- package/dist/rest/index.js.map +1 -0
- package/dist/shared/auth-provider-BfogACAb.js +91 -0
- package/dist/shared/auth-provider-BfogACAb.js.map +1 -0
- package/dist/shared/auth-provider-CTJkKfgy.cjs +108 -0
- package/dist/shared/auth-provider-CTJkKfgy.cjs.map +1 -0
- package/dist/shared/contracts-BoT7msmq.d.cts +84 -0
- package/dist/shared/contracts-BoT7msmq.d.ts +84 -0
- package/dist/{multi-storage-Bf84xiO8.cjs → shared/cookies-DZwFq6kr.cjs} +98 -429
- package/dist/shared/cookies-DZwFq6kr.cjs.map +1 -0
- package/dist/{multi-storage-BUZaLAPO.js → shared/cookies-tX2sNwxb.js} +99 -352
- package/dist/shared/cookies-tX2sNwxb.js.map +1 -0
- package/dist/{storage-IHdXw52v.js → shared/errors-Bhrd2fJd.js} +2 -229
- package/dist/shared/errors-Bhrd2fJd.js.map +1 -0
- package/dist/{storage-DnzZPS_9.cjs → shared/errors-DfU8M5eS.cjs} +1 -288
- package/dist/shared/errors-DfU8M5eS.cjs.map +1 -0
- package/dist/shared/multi-storage--yTEqiod.cjs +150 -0
- package/dist/shared/multi-storage--yTEqiod.cjs.map +1 -0
- package/dist/shared/multi-storage-CjAPB5Kq.d.cts +72 -0
- package/dist/shared/multi-storage-CkvTUC5m.js +121 -0
- package/dist/shared/multi-storage-CkvTUC5m.js.map +1 -0
- package/dist/shared/multi-storage-DccjD7Ww.d.ts +72 -0
- package/dist/shared/options-Dg5N3r1V.cjs +189 -0
- package/dist/shared/options-Dg5N3r1V.cjs.map +1 -0
- package/dist/shared/options-DtATYdLr.js +142 -0
- package/dist/shared/options-DtATYdLr.js.map +1 -0
- package/dist/shared/render-DMp_3Nzk.d.cts +2250 -0
- package/dist/shared/render-DZrxhC5_.d.ts +2250 -0
- package/dist/shared/render-DyeHJNBw.cjs +4147 -0
- package/dist/shared/render-DyeHJNBw.cjs.map +1 -0
- package/dist/shared/render-vtLixIiU.js +3992 -0
- package/dist/shared/render-vtLixIiU.js.map +1 -0
- package/dist/shared/storage-BPJR_k4-.cjs +290 -0
- package/dist/shared/storage-BPJR_k4-.cjs.map +1 -0
- package/dist/{storage-BqMxs76Y.d.ts → shared/storage-C_eICCep.d.cts} +2 -2
- package/dist/{storage-BqMxs76Y.d.cts → shared/storage-C_eICCep.d.ts} +2 -2
- package/dist/shared/storage-D86edNCB.js +231 -0
- package/dist/shared/storage-D86edNCB.js.map +1 -0
- package/dist/shared/url-B6-bXHKt.d.cts +2083 -0
- package/dist/shared/url-B6-bXHKt.d.ts +2083 -0
- package/dist/shared/url-CYXgxqGx.js +3673 -0
- package/dist/shared/url-CYXgxqGx.js.map +1 -0
- package/dist/shared/url-yjl2c8Ie.cjs +4032 -0
- package/dist/shared/url-yjl2c8Ie.cjs.map +1 -0
- package/dist/shared/websocket-BMtihD56.d.ts +562 -0
- package/dist/shared/websocket-CbzB1Leq.js +1874 -0
- package/dist/shared/websocket-CbzB1Leq.js.map +1 -0
- package/dist/shared/websocket-D1p32SB2.d.cts +562 -0
- package/dist/shared/websocket-sYlynrr0.cjs +1945 -0
- package/dist/shared/websocket-sYlynrr0.cjs.map +1 -0
- package/dist/{web.cjs → web/index.cjs} +4 -3
- package/dist/web/index.cjs.map +1 -0
- package/dist/{web.d.cts → web/index.d.cts} +2 -2
- package/dist/{web.d.ts → web/index.d.ts} +2 -2
- package/dist/{web.js → web/index.js} +3 -2
- package/dist/web/index.js.map +1 -0
- package/package.json +40 -12
- package/dist/multi-storage-BUZaLAPO.js.map +0 -1
- package/dist/multi-storage-BUoEoW8f.d.cts +0 -154
- package/dist/multi-storage-Bf84xiO8.cjs.map +0 -1
- package/dist/multi-storage-CQSlI_kn.d.ts +0 -154
- package/dist/node.cjs.map +0 -1
- package/dist/node.js.map +0 -1
- package/dist/storage-DnzZPS_9.cjs.map +0 -1
- package/dist/storage-IHdXw52v.js.map +0 -1
- package/dist/web.cjs.map +0 -1
- package/dist/web.js.map +0 -1
|
@@ -384,233 +384,6 @@ function isItdServerError(value) {
|
|
|
384
384
|
return hasApiKind(value, ItdApiErrorKind.Server);
|
|
385
385
|
}
|
|
386
386
|
//#endregion
|
|
387
|
-
|
|
388
|
-
function isRecord(value) {
|
|
389
|
-
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
390
|
-
}
|
|
391
|
-
function requireStore(value) {
|
|
392
|
-
const store = value;
|
|
393
|
-
if (!isRecord(store)) throw new ItdConfigError("KeyValueStore должен быть объектом");
|
|
394
|
-
for (const method of [
|
|
395
|
-
"get",
|
|
396
|
-
"set",
|
|
397
|
-
"delete"
|
|
398
|
-
]) if (typeof store[method] !== "function") throw new ItdConfigError(`KeyValueStore.${method} должен быть функцией`);
|
|
399
|
-
if (store.keys !== void 0 && typeof store.keys !== "function") throw new ItdConfigError("KeyValueStore.keys должен быть функцией");
|
|
400
|
-
}
|
|
401
|
-
/** Собирает {@link KeyValueStore} из функций конкретного backend. */
|
|
402
|
-
function createKeyValueStore(handlers) {
|
|
403
|
-
requireStore(handlers);
|
|
404
|
-
return handlers;
|
|
405
|
-
}
|
|
406
|
-
/** Проверяет доступность перечисления ключей. */
|
|
407
|
-
function isEnumerableKeyValueStore(store) {
|
|
408
|
-
return typeof store.keys === "function";
|
|
409
|
-
}
|
|
410
|
-
/** @internal */
|
|
411
|
-
async function collectKeyValueStoreKeys(store, prefix) {
|
|
412
|
-
const source = await store.keys(prefix);
|
|
413
|
-
const result = [];
|
|
414
|
-
for await (const key of source) {
|
|
415
|
-
if (typeof key !== "string") throw new ItdConfigError("KeyValueStore.keys() должен возвращать только строки");
|
|
416
|
-
if (prefix === void 0 || key.startsWith(prefix)) result.push(key);
|
|
417
|
-
}
|
|
418
|
-
return result;
|
|
419
|
-
}
|
|
420
|
-
/** Key-value backend в памяти процесса. Значения сохраняются по ссылке. */
|
|
421
|
-
var MemoryKeyValueStore = class {
|
|
422
|
-
#values = /* @__PURE__ */ new Map();
|
|
423
|
-
constructor(initial) {
|
|
424
|
-
for (const [key, value] of initial ?? []) this.#values.set(key, value);
|
|
425
|
-
}
|
|
426
|
-
get(key) {
|
|
427
|
-
return this.#values.get(key);
|
|
428
|
-
}
|
|
429
|
-
set(key, value) {
|
|
430
|
-
this.#values.set(key, value);
|
|
431
|
-
}
|
|
432
|
-
delete(key) {
|
|
433
|
-
this.#values.delete(key);
|
|
434
|
-
}
|
|
435
|
-
keys(prefix = "") {
|
|
436
|
-
return [...this.#values.keys()].filter((key) => key.startsWith(prefix));
|
|
437
|
-
}
|
|
438
|
-
};
|
|
439
|
-
/** Добавляет namespace ко всем ключам, не меняя исходный backend. */
|
|
440
|
-
function withNamespace(store, namespace, separator = ":") {
|
|
441
|
-
requireStore(store);
|
|
442
|
-
if (typeof namespace !== "string" || typeof separator !== "string") throw new ItdConfigError("namespace и separator KeyValueStore должны быть строками");
|
|
443
|
-
const base = namespace.length === 0 ? "" : `${namespace}${separator}`;
|
|
444
|
-
const key = (value) => `${base}${value}`;
|
|
445
|
-
const namespaced = {
|
|
446
|
-
get: (value) => store.get(key(value)),
|
|
447
|
-
set: (value, data) => store.set(key(value), data),
|
|
448
|
-
delete: (value) => store.delete(key(value))
|
|
449
|
-
};
|
|
450
|
-
if (isEnumerableKeyValueStore(store)) namespaced.keys = async (prefix = "") => {
|
|
451
|
-
return (await collectKeyValueStoreKeys(store, key(prefix))).map((value) => value.slice(base.length));
|
|
452
|
-
};
|
|
453
|
-
return namespaced;
|
|
454
|
-
}
|
|
455
|
-
/** Преобразует значения на границе backend, сохраняя его пространство ключей. */
|
|
456
|
-
function withCodec(store, codec) {
|
|
457
|
-
requireStore(store);
|
|
458
|
-
if (!isRecord(codec) || typeof codec.encode !== "function" || typeof codec.decode !== "function") throw new ItdConfigError("codec должен содержать функции encode и decode");
|
|
459
|
-
const encoded = {
|
|
460
|
-
async get(key) {
|
|
461
|
-
const value = await store.get(key);
|
|
462
|
-
return value === void 0 ? void 0 : codec.decode(value);
|
|
463
|
-
},
|
|
464
|
-
async set(key, value) {
|
|
465
|
-
await store.set(key, await codec.encode(value));
|
|
466
|
-
},
|
|
467
|
-
delete: (key) => store.delete(key)
|
|
468
|
-
};
|
|
469
|
-
if (isEnumerableKeyValueStore(store)) encoded.keys = (prefix) => store.keys(prefix);
|
|
470
|
-
return encoded;
|
|
471
|
-
}
|
|
472
|
-
/** Создаёт запись без прототипа, чтобы любые пользовательские ключи оставались данными. */
|
|
473
|
-
function emptyRecord() {
|
|
474
|
-
return Object.create(null);
|
|
475
|
-
}
|
|
476
|
-
function copyRecord(record) {
|
|
477
|
-
const copy = emptyRecord();
|
|
478
|
-
for (const [key, value] of Object.entries(record ?? {})) copy[key] = value;
|
|
479
|
-
return copy;
|
|
480
|
-
}
|
|
481
|
-
/**
|
|
482
|
-
* Создаёт key-value backend поверх одной общей записи.
|
|
483
|
-
*
|
|
484
|
-
* Чтение выполняется один раз, а записи выстраиваются последовательно. Изменение становится
|
|
485
|
-
* видимым чтениям только после подтверждения source. Несколько экземпляров или процессов
|
|
486
|
-
* требуют внешней синхронизации со стороны source.
|
|
487
|
-
*/
|
|
488
|
-
function createRecordKeyValueStore(source) {
|
|
489
|
-
if (!isRecord(source) || typeof source.read !== "function" || typeof source.write !== "function") throw new ItdConfigError("RecordKeyValueStoreSource должен содержать read и write");
|
|
490
|
-
if (source.delete !== void 0 && typeof source.delete !== "function") throw new ItdConfigError("RecordKeyValueStoreSource.delete должен быть функцией");
|
|
491
|
-
let committed;
|
|
492
|
-
let loading;
|
|
493
|
-
let writes = Promise.resolve();
|
|
494
|
-
const load = async () => {
|
|
495
|
-
if (committed !== void 0) return committed;
|
|
496
|
-
loading ??= Promise.resolve(source.read()).then((value) => {
|
|
497
|
-
if (value !== void 0 && !isRecord(value)) throw new ItdConfigError("RecordKeyValueStoreSource.read() должен вернуть объект");
|
|
498
|
-
committed = copyRecord(value);
|
|
499
|
-
return committed;
|
|
500
|
-
}).finally(() => {
|
|
501
|
-
loading = void 0;
|
|
502
|
-
});
|
|
503
|
-
return loading;
|
|
504
|
-
};
|
|
505
|
-
/**
|
|
506
|
-
* Записывает изменение и фиксирует его только после подтверждения source.
|
|
507
|
-
*
|
|
508
|
-
* Черновик строится внутри очереди записей, от текущего зафиксированного состояния.
|
|
509
|
-
*
|
|
510
|
-
* @param apply вносит изменение в черновик; `false` — менять нечего
|
|
511
|
-
*/
|
|
512
|
-
const mutate = (apply) => {
|
|
513
|
-
const run = async () => {
|
|
514
|
-
const draft = copyRecord(await load());
|
|
515
|
-
if (!apply(draft)) return;
|
|
516
|
-
if (source.delete && Object.keys(draft).length === 0) await source.delete();
|
|
517
|
-
else await source.write(draft);
|
|
518
|
-
committed = draft;
|
|
519
|
-
};
|
|
520
|
-
writes = writes.then(run, run);
|
|
521
|
-
return writes;
|
|
522
|
-
};
|
|
523
|
-
return {
|
|
524
|
-
async get(key) {
|
|
525
|
-
const current = await load();
|
|
526
|
-
return Object.hasOwn(current, key) ? current[key] : void 0;
|
|
527
|
-
},
|
|
528
|
-
set(key, value) {
|
|
529
|
-
return mutate((draft) => {
|
|
530
|
-
draft[key] = value;
|
|
531
|
-
return true;
|
|
532
|
-
});
|
|
533
|
-
},
|
|
534
|
-
delete(key) {
|
|
535
|
-
return mutate((draft) => {
|
|
536
|
-
if (!Object.hasOwn(draft, key)) return false;
|
|
537
|
-
delete draft[key];
|
|
538
|
-
return true;
|
|
539
|
-
});
|
|
540
|
-
},
|
|
541
|
-
async keys(prefix = "") {
|
|
542
|
-
const current = await load();
|
|
543
|
-
return Object.keys(current).filter((key) => key.startsWith(prefix));
|
|
544
|
-
}
|
|
545
|
-
};
|
|
546
|
-
}
|
|
547
|
-
//#endregion
|
|
548
|
-
//#region src/core/storage.ts
|
|
549
|
-
/**
|
|
550
|
-
* Создаёт независимый снимок сессии.
|
|
551
|
-
*
|
|
552
|
-
* Сессии пересекают границу пользовательского кода и внутреннего состояния клиента.
|
|
553
|
-
* Возвращать или сохранять их по ссылке нельзя: последующая мутация объекта или массива
|
|
554
|
-
* cookie меняла бы уже сохранённую сессию без вызова `set()`.
|
|
555
|
-
*
|
|
556
|
-
* @internal
|
|
557
|
-
*/
|
|
558
|
-
function copySession(session) {
|
|
559
|
-
return {
|
|
560
|
-
...session,
|
|
561
|
-
...session.cookies ? { cookies: [...session.cookies] } : {}
|
|
562
|
-
};
|
|
563
|
-
}
|
|
564
|
-
/**
|
|
565
|
-
* Хранилище в памяти процесса — вариант по умолчанию.
|
|
566
|
-
*
|
|
567
|
-
* Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`
|
|
568
|
-
* из `itd-api/node`, для браузера — `LocalStorageTokenStorage` или
|
|
569
|
-
* `SessionStorageTokenStorage` из `itd-api/web`.
|
|
570
|
-
*/
|
|
571
|
-
var MemoryTokenStorage = class {
|
|
572
|
-
#store = new MemoryKeyValueStore();
|
|
573
|
-
constructor(initial) {
|
|
574
|
-
if (initial) this.#store.set(TOKEN_STORAGE_KEY, copySession(initial));
|
|
575
|
-
}
|
|
576
|
-
get() {
|
|
577
|
-
const session = this.#store.get(TOKEN_STORAGE_KEY);
|
|
578
|
-
return session ? copySession(session) : null;
|
|
579
|
-
}
|
|
580
|
-
set(session) {
|
|
581
|
-
this.#store.set(TOKEN_STORAGE_KEY, copySession(session));
|
|
582
|
-
}
|
|
583
|
-
clear() {
|
|
584
|
-
this.#store.delete(TOKEN_STORAGE_KEY);
|
|
585
|
-
}
|
|
586
|
-
};
|
|
587
|
-
const TOKEN_STORAGE_KEY = "session";
|
|
588
|
-
function isPromise(value) {
|
|
589
|
-
return typeof value === "object" && value !== null && typeof value.then === "function";
|
|
590
|
-
}
|
|
591
|
-
/**
|
|
592
|
-
* Создаёт доменное хранилище сессии поверх общего {@link KeyValueStore}.
|
|
593
|
-
*
|
|
594
|
-
* @example
|
|
595
|
-
* ```ts
|
|
596
|
-
* const storage = createTokenStorage(withNamespace(redisStore, 'itd'));
|
|
597
|
-
* ```
|
|
598
|
-
*/
|
|
599
|
-
function createTokenStorage(store, options = {}) {
|
|
600
|
-
const key = options.key ?? TOKEN_STORAGE_KEY;
|
|
601
|
-
if (typeof key !== "string") throw new ItdConfigError("key TokenStorage должен быть строкой");
|
|
602
|
-
const backend = createKeyValueStore(store);
|
|
603
|
-
return {
|
|
604
|
-
get() {
|
|
605
|
-
const value = backend.get(key);
|
|
606
|
-
if (isPromise(value)) return value.then((session) => session ? copySession(session) : null);
|
|
607
|
-
return value ? copySession(value) : null;
|
|
608
|
-
},
|
|
609
|
-
set: (session) => backend.set(key, copySession(session)),
|
|
610
|
-
clear: () => backend.delete(key)
|
|
611
|
-
};
|
|
612
|
-
}
|
|
613
|
-
//#endregion
|
|
614
|
-
export { isItdApiError as A, isItdStateError as B, ItdNotFoundError as C, ItdStateError as D, ItdServerError as E, isItdForbiddenError as F, isItdNotFoundError as I, isItdPhoneVerificationError as L, isItdConflictError as M, isItdError as N, ItdTimeoutError as O, isItdFileError as P, isItdRateLimitError as R, ItdNetworkError as S, ItdRateLimitError as T, isItdValidationError as V, ItdError as _, collectKeyValueStoreKeys as a, ItdFileErrorReason as b, isEnumerableKeyValueStore as c, ItdAbortError as d, ItdApiError as f, ItdConflictError as g, ItdConfigError as h, MemoryKeyValueStore as i, isItdAuthError as j, ItdValidationError as k, withCodec as l, ItdAuthError as m, copySession as n, createKeyValueStore as o, ItdApiErrorKind as p, createTokenStorage as r, createRecordKeyValueStore as s, MemoryTokenStorage as t, withNamespace as u, ItdErrorKind as v, ItdPhoneVerificationError as w, ItdForbiddenError as x, ItdFileError as y, isItdServerError as z };
|
|
387
|
+
export { isItdStateError as A, isItdError as C, isItdPhoneVerificationError as D, isItdNotFoundError as E, isItdRateLimitError as O, isItdConflictError as S, isItdForbiddenError as T, ItdStateError as _, ItdConfigError as a, isItdApiError as b, ItdErrorKind as c, ItdForbiddenError as d, ItdNetworkError as f, ItdServerError as g, ItdRateLimitError as h, ItdAuthError as i, isItdValidationError as j, isItdServerError as k, ItdFileError as l, ItdPhoneVerificationError as m, ItdApiError as n, ItdConflictError as o, ItdNotFoundError as p, ItdApiErrorKind as r, ItdError as s, ItdAbortError as t, ItdFileErrorReason as u, ItdTimeoutError as v, isItdFileError as w, isItdAuthError as x, ItdValidationError as y };
|
|
615
388
|
|
|
616
|
-
//# sourceMappingURL=
|
|
389
|
+
//# sourceMappingURL=errors-Bhrd2fJd.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors-Bhrd2fJd.js","names":[],"sources":["../../src/core/errors.ts"],"sourcesContent":["import type { ItdErrorCode } from '../types/enums.js';\n\n/** Бренд, по которому ошибки библиотеки распознаются надёжнее, чем через `instanceof`. */\nconst ITD_ERROR = Symbol.for('itd.error');\n\n/**\n * Категория ошибки. Определяет, какие поля у неё есть.\n *\n * Значение, а не только тип: категорию нужно с чем-то сравнивать в рантайме.\n */\nexport const ItdErrorKind = Object.freeze({\n /** Сервер ответил статусом ≥ 400. */\n Api: 'api',\n /** Запрос не дошёл до сервера. */\n Network: 'network',\n /** Истёк таймаут запроса. */\n Timeout: 'timeout',\n /** Запрос отменён через `AbortSignal`. */\n Abort: 'abort',\n /** Операция невозможна в текущем состоянии объекта. */\n State: 'state',\n /** Не удалось получить или подготовить содержимое вложения. */\n File: 'file',\n /** Некорректная конфигурация или аргументы — обнаружено до обращения к сети. */\n Config: 'config',\n} as const);\nexport type ItdErrorKind = (typeof ItdErrorKind)[keyof typeof ItdErrorKind];\n\n/**\n * Разновидность ошибки API — то же, что класс ошибки, но в виде данных.\n *\n * Существует потому, что `instanceof` подводит, когда в дереве зависимостей оказались\n * две копии пакета или смешаны сборки ESM и CJS: классы тогда разные, хотя ошибка та же.\n * Проверки {@link isItdValidationError} и соседние опираются на это поле, а не на класс.\n */\nexport const ItdApiErrorKind = Object.freeze({\n /** Ни одна из специализаций не подошла. */\n Generic: 'generic',\n Validation: 'validation',\n Auth: 'auth',\n Forbidden: 'forbidden',\n NotFound: 'not_found',\n Conflict: 'conflict',\n RateLimit: 'rate_limit',\n PhoneVerification: 'phone_verification',\n Server: 'server',\n} as const);\nexport type ItdApiErrorKind = (typeof ItdApiErrorKind)[keyof typeof ItdApiErrorKind];\n\n/** Ошибки по полям формы: `{ email: ['уже занят'] }`. */\nexport type ItdFieldErrors = Record<string, string[]>;\n\n/**\n * Базовый класс всех ошибок библиотеки.\n *\n * Ловить его имеет смысл, чтобы отделить проблемы обращения к итд.com от прочих исключений.\n * Для разбора конкретной причины используйте {@link isItdApiError} и поле {@link ItdApiError.code}.\n *\n * @example\n * ```ts\n * try {\n * await itd.posts.like(id);\n * } catch (e) {\n * if (isItdError(e)) console.error('итд.com:', e.message);\n * else throw e;\n * }\n * ```\n */\nexport class ItdError extends Error {\n /** @internal */\n readonly [ITD_ERROR] = true as const;\n\n /** Категория ошибки. */\n readonly kind: ItdErrorKind;\n\n constructor(kind: ItdErrorKind, message: string, options?: { cause?: unknown }) {\n super(message, options);\n this.kind = kind;\n this.name = 'ItdError';\n }\n}\n\n/** Параметры конструктора {@link ItdApiError}. */\nexport interface ItdApiErrorInit {\n /** HTTP-статус ответа. */\n status: number;\n /** Строковый код ошибки из тела ответа. */\n code: ItdErrorCode;\n /** Человекочитаемое сообщение. */\n message: string;\n /** Расширенное описание, если сервер его прислал. */\n detail?: string | undefined;\n /** Заголовок ошибки, если сервер его прислал. */\n title?: string | undefined;\n /** Ошибки по конкретным полям (сведены из `errors` и `violations`). */\n fieldErrors?: ItdFieldErrors | undefined;\n /** Идентификатор запроса из заголовков ответа, если есть. */\n requestId?: string | undefined;\n /** HTTP-метод запроса. */\n method: string;\n /** Путь запроса без базового URL. */\n path: string;\n /** Тело ответа как оно пришло — на случай, если документация разошлась с реальностью. */\n raw: unknown;\n /** Сам объект ответа. Тело уже прочитано. */\n response?: Response | undefined;\n /** Значение `Retry-After` в миллисекундах, если заголовок был. */\n retryAfter?: number | undefined;\n /** Сколько запросов разрешено в окне (`x-ratelimit-limit`). */\n rateLimit?: number | undefined;\n /** Сколько запросов осталось в окне (`x-ratelimit-remaining`). */\n rateLimitRemaining?: number | undefined;\n}\n\n/**\n * Ошибка, возвращённая сервером итд.com (HTTP-статус ≥ 400).\n *\n * API отдаёт ошибки в двух разных формах — `{ error: { … } }` и `{ code, message, violations }`.\n * Библиотека сводит обе к этому классу, поэтому разбирать форму ответа вручную не нужно.\n *\n * @example\n * ```ts\n * try {\n * await itd.users.updateMe({ username: 'занятое_имя' });\n * } catch (e) {\n * if (e instanceof ItdValidationError) {\n * console.log(e.fieldErrors.username); // ['Имя уже занято']\n * }\n * }\n * ```\n */\nexport class ItdApiError extends ItdError {\n /**\n * Разновидность ошибки: та же информация, что и класс, но пригодная для сравнения.\n *\n * Позволяет разбирать ошибку через `switch`, а проверкам вроде {@link isItdAuthError} —\n * работать даже когда в проекте оказались две копии библиотеки.\n */\n readonly apiKind: ItdApiErrorKind;\n /** HTTP-статус ответа. */\n readonly status: number;\n /** Строковый код ошибки, например `VALIDATION_ERROR`. */\n readonly code: ItdErrorCode;\n /** Расширенное описание, если сервер его прислал. */\n readonly detail: string | undefined;\n /** Заголовок ошибки, если сервер его прислал. */\n readonly title: string | undefined;\n /** Ошибки по полям. Пустой объект, если сервер их не прислал. */\n readonly fieldErrors: ItdFieldErrors;\n /** Идентификатор запроса из заголовков ответа. */\n readonly requestId: string | undefined;\n /** HTTP-метод запроса. */\n readonly method: string;\n /** Путь запроса без базового URL. */\n readonly path: string;\n /** Тело ответа как оно пришло. */\n readonly raw: unknown;\n /** Объект ответа. Тело уже прочитано и повторно прочитано быть не может. */\n readonly response: Response | undefined;\n /** Пауза из заголовка `Retry-After` в миллисекундах. Сервер итд.com его не присылает. */\n readonly retryAfter: number | undefined;\n /**\n * Сколько запросов разрешено в окне — заголовок `x-ratelimit-limit`.\n *\n * Времени сброса окна сервер не сообщает, поэтому точный момент повтора неизвестен.\n */\n readonly rateLimit: number | undefined;\n /** Сколько запросов осталось в окне — заголовок `x-ratelimit-remaining`. */\n readonly rateLimitRemaining: number | undefined;\n\n /**\n * @param apiKind разновидность; подставляется подклассами, снаружи задавать не нужно\n */\n constructor(init: ItdApiErrorInit, apiKind: ItdApiErrorKind = ItdApiErrorKind.Generic) {\n super(ItdErrorKind.Api, init.message);\n this.name = 'ItdApiError';\n this.apiKind = apiKind;\n this.status = init.status;\n this.code = init.code;\n this.detail = init.detail;\n this.title = init.title;\n this.fieldErrors = init.fieldErrors ?? {};\n this.requestId = init.requestId;\n this.method = init.method;\n this.path = init.path;\n this.raw = init.raw;\n this.response = init.response;\n this.retryAfter = init.retryAfter;\n this.rateLimit = init.rateLimit;\n this.rateLimitRemaining = init.rateLimitRemaining;\n }\n\n /**\n * Проверяет код ошибки. Удобнее, чем сравнивать строки вручную.\n *\n * @example\n * ```ts\n * if (err.hasCode('OTP_INVALID', 'MISSING_FLOW_TOKEN')) await restartOtpFlow();\n * ```\n */\n hasCode(...codes: ItdErrorCode[]): boolean {\n return codes.includes(this.code);\n }\n\n /** Имеет ли смысл повторить запрос: `429` и серверные ошибки `5xx`. */\n get isRetryable(): boolean {\n return this.status === 429 || this.status >= 500;\n }\n}\n\n/** `400` / `422` — данные не прошли валидацию. Подробности в {@link ItdApiError.fieldErrors}. */\nexport class ItdValidationError extends ItdApiError {\n constructor(init: ItdApiErrorInit) {\n super(init, ItdApiErrorKind.Validation);\n this.name = 'ItdValidationError';\n }\n}\n\n/** `401` — токен отсутствует, истёк или отозван. */\nexport class ItdAuthError extends ItdApiError {\n constructor(init: ItdApiErrorInit) {\n super(init, ItdApiErrorKind.Auth);\n this.name = 'ItdAuthError';\n }\n}\n\n/** `403` — доступ запрещён либо действие ограничено настройками приватности. */\nexport class ItdForbiddenError extends ItdApiError {\n constructor(init: ItdApiErrorInit) {\n super(init, ItdApiErrorKind.Forbidden);\n this.name = 'ItdForbiddenError';\n }\n}\n\n/** `404` — сущность не найдена. */\nexport class ItdNotFoundError extends ItdApiError {\n constructor(init: ItdApiErrorInit) {\n super(init, ItdApiErrorKind.NotFound);\n this.name = 'ItdNotFoundError';\n }\n}\n\n/** `409` — сущность уже существует. */\nexport class ItdConflictError extends ItdApiError {\n constructor(init: ItdApiErrorInit) {\n super(init, ItdApiErrorKind.Conflict);\n this.name = 'ItdConflictError';\n }\n}\n\n/**\n * `429` — превышен лимит запросов.\n *\n * Если сервер прислал `Retry-After`, пауза доступна в {@link ItdApiError.retryAfter}\n * (в миллисекундах). При включённых ретраях библиотека выдерживает её автоматически.\n */\nexport class ItdRateLimitError extends ItdApiError {\n constructor(init: ItdApiErrorInit) {\n super(init, ItdApiErrorKind.RateLimit);\n this.name = 'ItdRateLimitError';\n }\n}\n\n/**\n * Действие требует подтверждённого телефона (`PHONE_VERIFICATION_REQUIRED`).\n *\n * Подтверждение проходит через Telegram-бота: ссылка лежит в {@link verificationUrl}.\n */\nexport class ItdPhoneVerificationError extends ItdApiError {\n /** Ссылка на бота подтверждения, если удалось определить идентификатор пользователя. */\n readonly verificationUrl: string | undefined;\n\n constructor(init: ItdApiErrorInit & { userId?: string | undefined }) {\n super(init, ItdApiErrorKind.PhoneVerification);\n this.name = 'ItdPhoneVerificationError';\n this.verificationUrl = init.userId\n ? `https://t.me/itd_verification_bot?start=${encodeURIComponent(init.userId)}`\n : undefined;\n }\n}\n\n/** `5xx` — ошибка на стороне сервера. */\nexport class ItdServerError extends ItdApiError {\n constructor(init: ItdApiErrorInit) {\n super(init, ItdApiErrorKind.Server);\n this.name = 'ItdServerError';\n }\n}\n\n/** Причина ошибки получения вложения. */\nexport const ItdFileErrorReason = Object.freeze({\n /** Сетевой сбой при получении источника. */\n Network: 'network',\n /** Источник ответил ошибочным HTTP-статусом. */\n Http: 'http',\n /** Источник превысил разрешённый размер. */\n TooLarge: 'too_large',\n /** Среда или источник не предоставили поток. */\n StreamUnavailable: 'stream_unavailable',\n /** Поток источника завершился ошибкой. */\n Read: 'read',\n} as const);\nexport type ItdFileErrorReason = (typeof ItdFileErrorReason)[keyof typeof ItdFileErrorReason];\n\n/** Не удалось получить или прочитать содержимое вложения. */\nexport class ItdFileError extends ItdError {\n readonly reason: ItdFileErrorReason;\n /** Адрес источника, если файл получался по сети. */\n readonly url: string | undefined;\n /** HTTP-статус источника. */\n readonly status: number | undefined;\n /** Разрешённый размер в байтах. */\n readonly limit: number | undefined;\n /** Обнаруженный размер в байтах. */\n readonly actual: number | undefined;\n /** Имеет ли смысл повторить получение источника. */\n readonly retryable: boolean;\n\n constructor(\n message: string,\n init: {\n reason: ItdFileErrorReason;\n url?: string | undefined;\n status?: number | undefined;\n limit?: number | undefined;\n actual?: number | undefined;\n retryable?: boolean | undefined;\n cause?: unknown;\n },\n ) {\n super(ItdErrorKind.File, message, { cause: init.cause });\n this.name = 'ItdFileError';\n this.reason = init.reason;\n this.url = init.url;\n this.status = init.status;\n this.limit = init.limit;\n this.actual = init.actual;\n this.retryable = init.retryable ?? false;\n }\n}\n\n/** Запрос не дошёл до сервера: DNS, обрыв соединения, отсутствие сети. */\nexport class ItdNetworkError extends ItdError {\n /** HTTP-метод запроса. */\n readonly method: string;\n /** Путь запроса без базового URL. */\n readonly path: string;\n\n constructor(message: string, init: { method: string; path: string; cause?: unknown }) {\n super(ItdErrorKind.Network, message, { cause: init.cause });\n this.name = 'ItdNetworkError';\n this.method = init.method;\n this.path = init.path;\n }\n}\n\n/** Истёк таймаут запроса, заданный опцией `timeout`. */\nexport class ItdTimeoutError extends ItdError {\n /** Значение таймаута в миллисекундах. */\n readonly timeout: number;\n /** HTTP-метод запроса. */\n readonly method: string;\n /** Путь запроса без базового URL. */\n readonly path: string;\n\n constructor(init: { timeout: number; method: string; path: string }) {\n super(\n ItdErrorKind.Timeout,\n `Запрос ${init.method} ${init.path} превысил таймаут ${init.timeout} мс`,\n );\n this.name = 'ItdTimeoutError';\n this.timeout = init.timeout;\n this.method = init.method;\n this.path = init.path;\n }\n}\n\n/** Запрос отменён через переданный `AbortSignal`. */\nexport class ItdAbortError extends ItdError {\n constructor(message = 'Запрос отменён', options?: { cause?: unknown }) {\n super(ItdErrorKind.Abort, message, options);\n this.name = 'ItdAbortError';\n }\n}\n\n/**\n * Операция невозможна в текущем состоянии объекта.\n *\n * Например, клиент уже окончательно освобождён через `dispose()` и не может выполнять\n * новые запросы или создавать realtime-потоки.\n */\nexport class ItdStateError extends ItdError {\n constructor(message: string, options?: { cause?: unknown }) {\n super(ItdErrorKind.State, message, options);\n this.name = 'ItdStateError';\n }\n}\n\n/**\n * Некорректная конфигурация или аргументы — обнаружено до обращения к сети.\n *\n * Этим же классом сообщают о нарушенных инвариантах билдеры: например, опрос\n * с одним вариантом ответа.\n */\nexport class ItdConfigError extends ItdError {\n constructor(message: string, options?: { cause?: unknown }) {\n super(ItdErrorKind.Config, message, options);\n this.name = 'ItdConfigError';\n }\n}\n\n/** Любая ошибка, порождённая этой библиотекой. */\nexport function isItdError(value: unknown): value is ItdError {\n return typeof value === 'object' && value !== null && ITD_ERROR in value;\n}\n\n/** Ошибка, пришедшая от сервера итд.com (статус ≥ 400). */\nexport function isItdApiError(value: unknown): value is ItdApiError {\n return isItdError(value) && value.kind === ItdErrorKind.Api;\n}\n\n/** Ошибка получения или чтения вложения. */\nexport function isItdFileError(value: unknown): value is ItdFileError {\n return isItdError(value) && value.kind === ItdErrorKind.File;\n}\n\n/** Операция невозможна в текущем состоянии объекта. */\nexport function isItdStateError(value: unknown): value is ItdStateError {\n return isItdError(value) && value.kind === ItdErrorKind.State;\n}\n\n/**\n * Проверяет разновидность ошибки API.\n *\n * Намеренно не `instanceof`: две копии пакета в дереве зависимостей или смешение сборок\n * ESM и CJS дают разные классы для одной и той же ошибки, и проверка по классу молча\n * перестаёт срабатывать. Поле {@link ItdApiError.apiKind} от этого не зависит.\n */\nfunction hasApiKind(value: unknown, kind: ItdApiErrorKind): boolean {\n return isItdApiError(value) && value.apiKind === kind;\n}\n\n/** Ошибка валидации: `VALIDATION_ERROR` либо статус `400`/`422`. */\nexport function isItdValidationError(value: unknown): value is ItdValidationError {\n return hasApiKind(value, ItdApiErrorKind.Validation);\n}\n\n/** Ошибка авторизации: истёкший или отозванный токен. */\nexport function isItdAuthError(value: unknown): value is ItdAuthError {\n return hasApiKind(value, ItdApiErrorKind.Auth);\n}\n\n/** Доступ запрещён либо действие ограничено настройками приватности. */\nexport function isItdForbiddenError(value: unknown): value is ItdForbiddenError {\n return hasApiKind(value, ItdApiErrorKind.Forbidden);\n}\n\n/** Сущность не найдена. */\nexport function isItdNotFoundError(value: unknown): value is ItdNotFoundError {\n return hasApiKind(value, ItdApiErrorKind.NotFound);\n}\n\n/** Сущность уже существует. */\nexport function isItdConflictError(value: unknown): value is ItdConflictError {\n return hasApiKind(value, ItdApiErrorKind.Conflict);\n}\n\n/** Превышен лимит запросов. */\nexport function isItdRateLimitError(value: unknown): value is ItdRateLimitError {\n return hasApiKind(value, ItdApiErrorKind.RateLimit);\n}\n\n/** Действие требует подтверждённого телефона. Ссылка — в `verificationUrl`. */\nexport function isItdPhoneVerificationError(value: unknown): value is ItdPhoneVerificationError {\n return hasApiKind(value, ItdApiErrorKind.PhoneVerification);\n}\n\n/** Ошибка на стороне сервера (`5xx`). */\nexport function isItdServerError(value: unknown): value is ItdServerError {\n return hasApiKind(value, ItdApiErrorKind.Server);\n}\n"],"mappings":"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"}
|
|
@@ -384,233 +384,6 @@ function isItdServerError(value) {
|
|
|
384
384
|
return hasApiKind(value, ItdApiErrorKind.Server);
|
|
385
385
|
}
|
|
386
386
|
//#endregion
|
|
387
|
-
//#region src/core/key-value-store.ts
|
|
388
|
-
function isRecord(value) {
|
|
389
|
-
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
390
|
-
}
|
|
391
|
-
function requireStore(value) {
|
|
392
|
-
const store = value;
|
|
393
|
-
if (!isRecord(store)) throw new ItdConfigError("KeyValueStore должен быть объектом");
|
|
394
|
-
for (const method of [
|
|
395
|
-
"get",
|
|
396
|
-
"set",
|
|
397
|
-
"delete"
|
|
398
|
-
]) if (typeof store[method] !== "function") throw new ItdConfigError(`KeyValueStore.${method} должен быть функцией`);
|
|
399
|
-
if (store.keys !== void 0 && typeof store.keys !== "function") throw new ItdConfigError("KeyValueStore.keys должен быть функцией");
|
|
400
|
-
}
|
|
401
|
-
/** Собирает {@link KeyValueStore} из функций конкретного backend. */
|
|
402
|
-
function createKeyValueStore(handlers) {
|
|
403
|
-
requireStore(handlers);
|
|
404
|
-
return handlers;
|
|
405
|
-
}
|
|
406
|
-
/** Проверяет доступность перечисления ключей. */
|
|
407
|
-
function isEnumerableKeyValueStore(store) {
|
|
408
|
-
return typeof store.keys === "function";
|
|
409
|
-
}
|
|
410
|
-
/** @internal */
|
|
411
|
-
async function collectKeyValueStoreKeys(store, prefix) {
|
|
412
|
-
const source = await store.keys(prefix);
|
|
413
|
-
const result = [];
|
|
414
|
-
for await (const key of source) {
|
|
415
|
-
if (typeof key !== "string") throw new ItdConfigError("KeyValueStore.keys() должен возвращать только строки");
|
|
416
|
-
if (prefix === void 0 || key.startsWith(prefix)) result.push(key);
|
|
417
|
-
}
|
|
418
|
-
return result;
|
|
419
|
-
}
|
|
420
|
-
/** Key-value backend в памяти процесса. Значения сохраняются по ссылке. */
|
|
421
|
-
var MemoryKeyValueStore = class {
|
|
422
|
-
#values = /* @__PURE__ */ new Map();
|
|
423
|
-
constructor(initial) {
|
|
424
|
-
for (const [key, value] of initial ?? []) this.#values.set(key, value);
|
|
425
|
-
}
|
|
426
|
-
get(key) {
|
|
427
|
-
return this.#values.get(key);
|
|
428
|
-
}
|
|
429
|
-
set(key, value) {
|
|
430
|
-
this.#values.set(key, value);
|
|
431
|
-
}
|
|
432
|
-
delete(key) {
|
|
433
|
-
this.#values.delete(key);
|
|
434
|
-
}
|
|
435
|
-
keys(prefix = "") {
|
|
436
|
-
return [...this.#values.keys()].filter((key) => key.startsWith(prefix));
|
|
437
|
-
}
|
|
438
|
-
};
|
|
439
|
-
/** Добавляет namespace ко всем ключам, не меняя исходный backend. */
|
|
440
|
-
function withNamespace(store, namespace, separator = ":") {
|
|
441
|
-
requireStore(store);
|
|
442
|
-
if (typeof namespace !== "string" || typeof separator !== "string") throw new ItdConfigError("namespace и separator KeyValueStore должны быть строками");
|
|
443
|
-
const base = namespace.length === 0 ? "" : `${namespace}${separator}`;
|
|
444
|
-
const key = (value) => `${base}${value}`;
|
|
445
|
-
const namespaced = {
|
|
446
|
-
get: (value) => store.get(key(value)),
|
|
447
|
-
set: (value, data) => store.set(key(value), data),
|
|
448
|
-
delete: (value) => store.delete(key(value))
|
|
449
|
-
};
|
|
450
|
-
if (isEnumerableKeyValueStore(store)) namespaced.keys = async (prefix = "") => {
|
|
451
|
-
return (await collectKeyValueStoreKeys(store, key(prefix))).map((value) => value.slice(base.length));
|
|
452
|
-
};
|
|
453
|
-
return namespaced;
|
|
454
|
-
}
|
|
455
|
-
/** Преобразует значения на границе backend, сохраняя его пространство ключей. */
|
|
456
|
-
function withCodec(store, codec) {
|
|
457
|
-
requireStore(store);
|
|
458
|
-
if (!isRecord(codec) || typeof codec.encode !== "function" || typeof codec.decode !== "function") throw new ItdConfigError("codec должен содержать функции encode и decode");
|
|
459
|
-
const encoded = {
|
|
460
|
-
async get(key) {
|
|
461
|
-
const value = await store.get(key);
|
|
462
|
-
return value === void 0 ? void 0 : codec.decode(value);
|
|
463
|
-
},
|
|
464
|
-
async set(key, value) {
|
|
465
|
-
await store.set(key, await codec.encode(value));
|
|
466
|
-
},
|
|
467
|
-
delete: (key) => store.delete(key)
|
|
468
|
-
};
|
|
469
|
-
if (isEnumerableKeyValueStore(store)) encoded.keys = (prefix) => store.keys(prefix);
|
|
470
|
-
return encoded;
|
|
471
|
-
}
|
|
472
|
-
/** Создаёт запись без прототипа, чтобы любые пользовательские ключи оставались данными. */
|
|
473
|
-
function emptyRecord() {
|
|
474
|
-
return Object.create(null);
|
|
475
|
-
}
|
|
476
|
-
function copyRecord(record) {
|
|
477
|
-
const copy = emptyRecord();
|
|
478
|
-
for (const [key, value] of Object.entries(record ?? {})) copy[key] = value;
|
|
479
|
-
return copy;
|
|
480
|
-
}
|
|
481
|
-
/**
|
|
482
|
-
* Создаёт key-value backend поверх одной общей записи.
|
|
483
|
-
*
|
|
484
|
-
* Чтение выполняется один раз, а записи выстраиваются последовательно. Изменение становится
|
|
485
|
-
* видимым чтениям только после подтверждения source. Несколько экземпляров или процессов
|
|
486
|
-
* требуют внешней синхронизации со стороны source.
|
|
487
|
-
*/
|
|
488
|
-
function createRecordKeyValueStore(source) {
|
|
489
|
-
if (!isRecord(source) || typeof source.read !== "function" || typeof source.write !== "function") throw new ItdConfigError("RecordKeyValueStoreSource должен содержать read и write");
|
|
490
|
-
if (source.delete !== void 0 && typeof source.delete !== "function") throw new ItdConfigError("RecordKeyValueStoreSource.delete должен быть функцией");
|
|
491
|
-
let committed;
|
|
492
|
-
let loading;
|
|
493
|
-
let writes = Promise.resolve();
|
|
494
|
-
const load = async () => {
|
|
495
|
-
if (committed !== void 0) return committed;
|
|
496
|
-
loading ??= Promise.resolve(source.read()).then((value) => {
|
|
497
|
-
if (value !== void 0 && !isRecord(value)) throw new ItdConfigError("RecordKeyValueStoreSource.read() должен вернуть объект");
|
|
498
|
-
committed = copyRecord(value);
|
|
499
|
-
return committed;
|
|
500
|
-
}).finally(() => {
|
|
501
|
-
loading = void 0;
|
|
502
|
-
});
|
|
503
|
-
return loading;
|
|
504
|
-
};
|
|
505
|
-
/**
|
|
506
|
-
* Записывает изменение и фиксирует его только после подтверждения source.
|
|
507
|
-
*
|
|
508
|
-
* Черновик строится внутри очереди записей, от текущего зафиксированного состояния.
|
|
509
|
-
*
|
|
510
|
-
* @param apply вносит изменение в черновик; `false` — менять нечего
|
|
511
|
-
*/
|
|
512
|
-
const mutate = (apply) => {
|
|
513
|
-
const run = async () => {
|
|
514
|
-
const draft = copyRecord(await load());
|
|
515
|
-
if (!apply(draft)) return;
|
|
516
|
-
if (source.delete && Object.keys(draft).length === 0) await source.delete();
|
|
517
|
-
else await source.write(draft);
|
|
518
|
-
committed = draft;
|
|
519
|
-
};
|
|
520
|
-
writes = writes.then(run, run);
|
|
521
|
-
return writes;
|
|
522
|
-
};
|
|
523
|
-
return {
|
|
524
|
-
async get(key) {
|
|
525
|
-
const current = await load();
|
|
526
|
-
return Object.hasOwn(current, key) ? current[key] : void 0;
|
|
527
|
-
},
|
|
528
|
-
set(key, value) {
|
|
529
|
-
return mutate((draft) => {
|
|
530
|
-
draft[key] = value;
|
|
531
|
-
return true;
|
|
532
|
-
});
|
|
533
|
-
},
|
|
534
|
-
delete(key) {
|
|
535
|
-
return mutate((draft) => {
|
|
536
|
-
if (!Object.hasOwn(draft, key)) return false;
|
|
537
|
-
delete draft[key];
|
|
538
|
-
return true;
|
|
539
|
-
});
|
|
540
|
-
},
|
|
541
|
-
async keys(prefix = "") {
|
|
542
|
-
const current = await load();
|
|
543
|
-
return Object.keys(current).filter((key) => key.startsWith(prefix));
|
|
544
|
-
}
|
|
545
|
-
};
|
|
546
|
-
}
|
|
547
|
-
//#endregion
|
|
548
|
-
//#region src/core/storage.ts
|
|
549
|
-
/**
|
|
550
|
-
* Создаёт независимый снимок сессии.
|
|
551
|
-
*
|
|
552
|
-
* Сессии пересекают границу пользовательского кода и внутреннего состояния клиента.
|
|
553
|
-
* Возвращать или сохранять их по ссылке нельзя: последующая мутация объекта или массива
|
|
554
|
-
* cookie меняла бы уже сохранённую сессию без вызова `set()`.
|
|
555
|
-
*
|
|
556
|
-
* @internal
|
|
557
|
-
*/
|
|
558
|
-
function copySession(session) {
|
|
559
|
-
return {
|
|
560
|
-
...session,
|
|
561
|
-
...session.cookies ? { cookies: [...session.cookies] } : {}
|
|
562
|
-
};
|
|
563
|
-
}
|
|
564
|
-
/**
|
|
565
|
-
* Хранилище в памяти процесса — вариант по умолчанию.
|
|
566
|
-
*
|
|
567
|
-
* Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`
|
|
568
|
-
* из `itd-api/node`, для браузера — `LocalStorageTokenStorage` или
|
|
569
|
-
* `SessionStorageTokenStorage` из `itd-api/web`.
|
|
570
|
-
*/
|
|
571
|
-
var MemoryTokenStorage = class {
|
|
572
|
-
#store = new MemoryKeyValueStore();
|
|
573
|
-
constructor(initial) {
|
|
574
|
-
if (initial) this.#store.set(TOKEN_STORAGE_KEY, copySession(initial));
|
|
575
|
-
}
|
|
576
|
-
get() {
|
|
577
|
-
const session = this.#store.get(TOKEN_STORAGE_KEY);
|
|
578
|
-
return session ? copySession(session) : null;
|
|
579
|
-
}
|
|
580
|
-
set(session) {
|
|
581
|
-
this.#store.set(TOKEN_STORAGE_KEY, copySession(session));
|
|
582
|
-
}
|
|
583
|
-
clear() {
|
|
584
|
-
this.#store.delete(TOKEN_STORAGE_KEY);
|
|
585
|
-
}
|
|
586
|
-
};
|
|
587
|
-
const TOKEN_STORAGE_KEY = "session";
|
|
588
|
-
function isPromise(value) {
|
|
589
|
-
return typeof value === "object" && value !== null && typeof value.then === "function";
|
|
590
|
-
}
|
|
591
|
-
/**
|
|
592
|
-
* Создаёт доменное хранилище сессии поверх общего {@link KeyValueStore}.
|
|
593
|
-
*
|
|
594
|
-
* @example
|
|
595
|
-
* ```ts
|
|
596
|
-
* const storage = createTokenStorage(withNamespace(redisStore, 'itd'));
|
|
597
|
-
* ```
|
|
598
|
-
*/
|
|
599
|
-
function createTokenStorage(store, options = {}) {
|
|
600
|
-
const key = options.key ?? TOKEN_STORAGE_KEY;
|
|
601
|
-
if (typeof key !== "string") throw new ItdConfigError("key TokenStorage должен быть строкой");
|
|
602
|
-
const backend = createKeyValueStore(store);
|
|
603
|
-
return {
|
|
604
|
-
get() {
|
|
605
|
-
const value = backend.get(key);
|
|
606
|
-
if (isPromise(value)) return value.then((session) => session ? copySession(session) : null);
|
|
607
|
-
return value ? copySession(value) : null;
|
|
608
|
-
},
|
|
609
|
-
set: (session) => backend.set(key, copySession(session)),
|
|
610
|
-
clear: () => backend.delete(key)
|
|
611
|
-
};
|
|
612
|
-
}
|
|
613
|
-
//#endregion
|
|
614
387
|
Object.defineProperty(exports, "ItdAbortError", {
|
|
615
388
|
enumerable: true,
|
|
616
389
|
get: function() {
|
|
@@ -725,54 +498,6 @@ Object.defineProperty(exports, "ItdValidationError", {
|
|
|
725
498
|
return ItdValidationError;
|
|
726
499
|
}
|
|
727
500
|
});
|
|
728
|
-
Object.defineProperty(exports, "MemoryKeyValueStore", {
|
|
729
|
-
enumerable: true,
|
|
730
|
-
get: function() {
|
|
731
|
-
return MemoryKeyValueStore;
|
|
732
|
-
}
|
|
733
|
-
});
|
|
734
|
-
Object.defineProperty(exports, "MemoryTokenStorage", {
|
|
735
|
-
enumerable: true,
|
|
736
|
-
get: function() {
|
|
737
|
-
return MemoryTokenStorage;
|
|
738
|
-
}
|
|
739
|
-
});
|
|
740
|
-
Object.defineProperty(exports, "collectKeyValueStoreKeys", {
|
|
741
|
-
enumerable: true,
|
|
742
|
-
get: function() {
|
|
743
|
-
return collectKeyValueStoreKeys;
|
|
744
|
-
}
|
|
745
|
-
});
|
|
746
|
-
Object.defineProperty(exports, "copySession", {
|
|
747
|
-
enumerable: true,
|
|
748
|
-
get: function() {
|
|
749
|
-
return copySession;
|
|
750
|
-
}
|
|
751
|
-
});
|
|
752
|
-
Object.defineProperty(exports, "createKeyValueStore", {
|
|
753
|
-
enumerable: true,
|
|
754
|
-
get: function() {
|
|
755
|
-
return createKeyValueStore;
|
|
756
|
-
}
|
|
757
|
-
});
|
|
758
|
-
Object.defineProperty(exports, "createRecordKeyValueStore", {
|
|
759
|
-
enumerable: true,
|
|
760
|
-
get: function() {
|
|
761
|
-
return createRecordKeyValueStore;
|
|
762
|
-
}
|
|
763
|
-
});
|
|
764
|
-
Object.defineProperty(exports, "createTokenStorage", {
|
|
765
|
-
enumerable: true,
|
|
766
|
-
get: function() {
|
|
767
|
-
return createTokenStorage;
|
|
768
|
-
}
|
|
769
|
-
});
|
|
770
|
-
Object.defineProperty(exports, "isEnumerableKeyValueStore", {
|
|
771
|
-
enumerable: true,
|
|
772
|
-
get: function() {
|
|
773
|
-
return isEnumerableKeyValueStore;
|
|
774
|
-
}
|
|
775
|
-
});
|
|
776
501
|
Object.defineProperty(exports, "isItdApiError", {
|
|
777
502
|
enumerable: true,
|
|
778
503
|
get: function() {
|
|
@@ -845,17 +570,5 @@ Object.defineProperty(exports, "isItdValidationError", {
|
|
|
845
570
|
return isItdValidationError;
|
|
846
571
|
}
|
|
847
572
|
});
|
|
848
|
-
Object.defineProperty(exports, "withCodec", {
|
|
849
|
-
enumerable: true,
|
|
850
|
-
get: function() {
|
|
851
|
-
return withCodec;
|
|
852
|
-
}
|
|
853
|
-
});
|
|
854
|
-
Object.defineProperty(exports, "withNamespace", {
|
|
855
|
-
enumerable: true,
|
|
856
|
-
get: function() {
|
|
857
|
-
return withNamespace;
|
|
858
|
-
}
|
|
859
|
-
});
|
|
860
573
|
|
|
861
|
-
//# sourceMappingURL=
|
|
574
|
+
//# sourceMappingURL=errors-DfU8M5eS.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors-DfU8M5eS.cjs","names":[],"sources":["../../src/core/errors.ts"],"sourcesContent":["import type { ItdErrorCode } from '../types/enums.js';\n\n/** Бренд, по которому ошибки библиотеки распознаются надёжнее, чем через `instanceof`. */\nconst ITD_ERROR = Symbol.for('itd.error');\n\n/**\n * Категория ошибки. Определяет, какие поля у неё есть.\n *\n * Значение, а не только тип: категорию нужно с чем-то сравнивать в рантайме.\n */\nexport const ItdErrorKind = Object.freeze({\n /** Сервер ответил статусом ≥ 400. */\n Api: 'api',\n /** Запрос не дошёл до сервера. */\n Network: 'network',\n /** Истёк таймаут запроса. */\n Timeout: 'timeout',\n /** Запрос отменён через `AbortSignal`. */\n Abort: 'abort',\n /** Операция невозможна в текущем состоянии объекта. */\n State: 'state',\n /** Не удалось получить или подготовить содержимое вложения. */\n File: 'file',\n /** Некорректная конфигурация или аргументы — обнаружено до обращения к сети. */\n Config: 'config',\n} as const);\nexport type ItdErrorKind = (typeof ItdErrorKind)[keyof typeof ItdErrorKind];\n\n/**\n * Разновидность ошибки API — то же, что класс ошибки, но в виде данных.\n *\n * Существует потому, что `instanceof` подводит, когда в дереве зависимостей оказались\n * две копии пакета или смешаны сборки ESM и CJS: классы тогда разные, хотя ошибка та же.\n * Проверки {@link isItdValidationError} и соседние опираются на это поле, а не на класс.\n */\nexport const ItdApiErrorKind = Object.freeze({\n /** Ни одна из специализаций не подошла. */\n Generic: 'generic',\n Validation: 'validation',\n Auth: 'auth',\n Forbidden: 'forbidden',\n NotFound: 'not_found',\n Conflict: 'conflict',\n RateLimit: 'rate_limit',\n PhoneVerification: 'phone_verification',\n Server: 'server',\n} as const);\nexport type ItdApiErrorKind = (typeof ItdApiErrorKind)[keyof typeof ItdApiErrorKind];\n\n/** Ошибки по полям формы: `{ email: ['уже занят'] }`. */\nexport type ItdFieldErrors = Record<string, string[]>;\n\n/**\n * Базовый класс всех ошибок библиотеки.\n *\n * Ловить его имеет смысл, чтобы отделить проблемы обращения к итд.com от прочих исключений.\n * Для разбора конкретной причины используйте {@link isItdApiError} и поле {@link ItdApiError.code}.\n *\n * @example\n * ```ts\n * try {\n * await itd.posts.like(id);\n * } catch (e) {\n * if (isItdError(e)) console.error('итд.com:', e.message);\n * else throw e;\n * }\n * ```\n */\nexport class ItdError extends Error {\n /** @internal */\n readonly [ITD_ERROR] = true as const;\n\n /** Категория ошибки. */\n readonly kind: ItdErrorKind;\n\n constructor(kind: ItdErrorKind, message: string, options?: { cause?: unknown }) {\n super(message, options);\n this.kind = kind;\n this.name = 'ItdError';\n }\n}\n\n/** Параметры конструктора {@link ItdApiError}. */\nexport interface ItdApiErrorInit {\n /** HTTP-статус ответа. */\n status: number;\n /** Строковый код ошибки из тела ответа. */\n code: ItdErrorCode;\n /** Человекочитаемое сообщение. */\n message: string;\n /** Расширенное описание, если сервер его прислал. */\n detail?: string | undefined;\n /** Заголовок ошибки, если сервер его прислал. */\n title?: string | undefined;\n /** Ошибки по конкретным полям (сведены из `errors` и `violations`). */\n fieldErrors?: ItdFieldErrors | undefined;\n /** Идентификатор запроса из заголовков ответа, если есть. */\n requestId?: string | undefined;\n /** HTTP-метод запроса. */\n method: string;\n /** Путь запроса без базового URL. */\n path: string;\n /** Тело ответа как оно пришло — на случай, если документация разошлась с реальностью. */\n raw: unknown;\n /** Сам объект ответа. Тело уже прочитано. */\n response?: Response | undefined;\n /** Значение `Retry-After` в миллисекундах, если заголовок был. */\n retryAfter?: number | undefined;\n /** Сколько запросов разрешено в окне (`x-ratelimit-limit`). */\n rateLimit?: number | undefined;\n /** Сколько запросов осталось в окне (`x-ratelimit-remaining`). */\n rateLimitRemaining?: number | undefined;\n}\n\n/**\n * Ошибка, возвращённая сервером итд.com (HTTP-статус ≥ 400).\n *\n * API отдаёт ошибки в двух разных формах — `{ error: { … } }` и `{ code, message, violations }`.\n * Библиотека сводит обе к этому классу, поэтому разбирать форму ответа вручную не нужно.\n *\n * @example\n * ```ts\n * try {\n * await itd.users.updateMe({ username: 'занятое_имя' });\n * } catch (e) {\n * if (e instanceof ItdValidationError) {\n * console.log(e.fieldErrors.username); // ['Имя уже занято']\n * }\n * }\n * ```\n */\nexport class ItdApiError extends ItdError {\n /**\n * Разновидность ошибки: та же информация, что и класс, но пригодная для сравнения.\n *\n * Позволяет разбирать ошибку через `switch`, а проверкам вроде {@link isItdAuthError} —\n * работать даже когда в проекте оказались две копии библиотеки.\n */\n readonly apiKind: ItdApiErrorKind;\n /** HTTP-статус ответа. */\n readonly status: number;\n /** Строковый код ошибки, например `VALIDATION_ERROR`. */\n readonly code: ItdErrorCode;\n /** Расширенное описание, если сервер его прислал. */\n readonly detail: string | undefined;\n /** Заголовок ошибки, если сервер его прислал. */\n readonly title: string | undefined;\n /** Ошибки по полям. Пустой объект, если сервер их не прислал. */\n readonly fieldErrors: ItdFieldErrors;\n /** Идентификатор запроса из заголовков ответа. */\n readonly requestId: string | undefined;\n /** HTTP-метод запроса. */\n readonly method: string;\n /** Путь запроса без базового URL. */\n readonly path: string;\n /** Тело ответа как оно пришло. */\n readonly raw: unknown;\n /** Объект ответа. Тело уже прочитано и повторно прочитано быть не может. */\n readonly response: Response | undefined;\n /** Пауза из заголовка `Retry-After` в миллисекундах. Сервер итд.com его не присылает. */\n readonly retryAfter: number | undefined;\n /**\n * Сколько запросов разрешено в окне — заголовок `x-ratelimit-limit`.\n *\n * Времени сброса окна сервер не сообщает, поэтому точный момент повтора неизвестен.\n */\n readonly rateLimit: number | undefined;\n /** Сколько запросов осталось в окне — заголовок `x-ratelimit-remaining`. */\n readonly rateLimitRemaining: number | undefined;\n\n /**\n * @param apiKind разновидность; подставляется подклассами, снаружи задавать не нужно\n */\n constructor(init: ItdApiErrorInit, apiKind: ItdApiErrorKind = ItdApiErrorKind.Generic) {\n super(ItdErrorKind.Api, init.message);\n this.name = 'ItdApiError';\n this.apiKind = apiKind;\n this.status = init.status;\n this.code = init.code;\n this.detail = init.detail;\n this.title = init.title;\n this.fieldErrors = init.fieldErrors ?? {};\n this.requestId = init.requestId;\n this.method = init.method;\n this.path = init.path;\n this.raw = init.raw;\n this.response = init.response;\n this.retryAfter = init.retryAfter;\n this.rateLimit = init.rateLimit;\n this.rateLimitRemaining = init.rateLimitRemaining;\n }\n\n /**\n * Проверяет код ошибки. Удобнее, чем сравнивать строки вручную.\n *\n * @example\n * ```ts\n * if (err.hasCode('OTP_INVALID', 'MISSING_FLOW_TOKEN')) await restartOtpFlow();\n * ```\n */\n hasCode(...codes: ItdErrorCode[]): boolean {\n return codes.includes(this.code);\n }\n\n /** Имеет ли смысл повторить запрос: `429` и серверные ошибки `5xx`. */\n get isRetryable(): boolean {\n return this.status === 429 || this.status >= 500;\n }\n}\n\n/** `400` / `422` — данные не прошли валидацию. Подробности в {@link ItdApiError.fieldErrors}. */\nexport class ItdValidationError extends ItdApiError {\n constructor(init: ItdApiErrorInit) {\n super(init, ItdApiErrorKind.Validation);\n this.name = 'ItdValidationError';\n }\n}\n\n/** `401` — токен отсутствует, истёк или отозван. */\nexport class ItdAuthError extends ItdApiError {\n constructor(init: ItdApiErrorInit) {\n super(init, ItdApiErrorKind.Auth);\n this.name = 'ItdAuthError';\n }\n}\n\n/** `403` — доступ запрещён либо действие ограничено настройками приватности. */\nexport class ItdForbiddenError extends ItdApiError {\n constructor(init: ItdApiErrorInit) {\n super(init, ItdApiErrorKind.Forbidden);\n this.name = 'ItdForbiddenError';\n }\n}\n\n/** `404` — сущность не найдена. */\nexport class ItdNotFoundError extends ItdApiError {\n constructor(init: ItdApiErrorInit) {\n super(init, ItdApiErrorKind.NotFound);\n this.name = 'ItdNotFoundError';\n }\n}\n\n/** `409` — сущность уже существует. */\nexport class ItdConflictError extends ItdApiError {\n constructor(init: ItdApiErrorInit) {\n super(init, ItdApiErrorKind.Conflict);\n this.name = 'ItdConflictError';\n }\n}\n\n/**\n * `429` — превышен лимит запросов.\n *\n * Если сервер прислал `Retry-After`, пауза доступна в {@link ItdApiError.retryAfter}\n * (в миллисекундах). При включённых ретраях библиотека выдерживает её автоматически.\n */\nexport class ItdRateLimitError extends ItdApiError {\n constructor(init: ItdApiErrorInit) {\n super(init, ItdApiErrorKind.RateLimit);\n this.name = 'ItdRateLimitError';\n }\n}\n\n/**\n * Действие требует подтверждённого телефона (`PHONE_VERIFICATION_REQUIRED`).\n *\n * Подтверждение проходит через Telegram-бота: ссылка лежит в {@link verificationUrl}.\n */\nexport class ItdPhoneVerificationError extends ItdApiError {\n /** Ссылка на бота подтверждения, если удалось определить идентификатор пользователя. */\n readonly verificationUrl: string | undefined;\n\n constructor(init: ItdApiErrorInit & { userId?: string | undefined }) {\n super(init, ItdApiErrorKind.PhoneVerification);\n this.name = 'ItdPhoneVerificationError';\n this.verificationUrl = init.userId\n ? `https://t.me/itd_verification_bot?start=${encodeURIComponent(init.userId)}`\n : undefined;\n }\n}\n\n/** `5xx` — ошибка на стороне сервера. */\nexport class ItdServerError extends ItdApiError {\n constructor(init: ItdApiErrorInit) {\n super(init, ItdApiErrorKind.Server);\n this.name = 'ItdServerError';\n }\n}\n\n/** Причина ошибки получения вложения. */\nexport const ItdFileErrorReason = Object.freeze({\n /** Сетевой сбой при получении источника. */\n Network: 'network',\n /** Источник ответил ошибочным HTTP-статусом. */\n Http: 'http',\n /** Источник превысил разрешённый размер. */\n TooLarge: 'too_large',\n /** Среда или источник не предоставили поток. */\n StreamUnavailable: 'stream_unavailable',\n /** Поток источника завершился ошибкой. */\n Read: 'read',\n} as const);\nexport type ItdFileErrorReason = (typeof ItdFileErrorReason)[keyof typeof ItdFileErrorReason];\n\n/** Не удалось получить или прочитать содержимое вложения. */\nexport class ItdFileError extends ItdError {\n readonly reason: ItdFileErrorReason;\n /** Адрес источника, если файл получался по сети. */\n readonly url: string | undefined;\n /** HTTP-статус источника. */\n readonly status: number | undefined;\n /** Разрешённый размер в байтах. */\n readonly limit: number | undefined;\n /** Обнаруженный размер в байтах. */\n readonly actual: number | undefined;\n /** Имеет ли смысл повторить получение источника. */\n readonly retryable: boolean;\n\n constructor(\n message: string,\n init: {\n reason: ItdFileErrorReason;\n url?: string | undefined;\n status?: number | undefined;\n limit?: number | undefined;\n actual?: number | undefined;\n retryable?: boolean | undefined;\n cause?: unknown;\n },\n ) {\n super(ItdErrorKind.File, message, { cause: init.cause });\n this.name = 'ItdFileError';\n this.reason = init.reason;\n this.url = init.url;\n this.status = init.status;\n this.limit = init.limit;\n this.actual = init.actual;\n this.retryable = init.retryable ?? false;\n }\n}\n\n/** Запрос не дошёл до сервера: DNS, обрыв соединения, отсутствие сети. */\nexport class ItdNetworkError extends ItdError {\n /** HTTP-метод запроса. */\n readonly method: string;\n /** Путь запроса без базового URL. */\n readonly path: string;\n\n constructor(message: string, init: { method: string; path: string; cause?: unknown }) {\n super(ItdErrorKind.Network, message, { cause: init.cause });\n this.name = 'ItdNetworkError';\n this.method = init.method;\n this.path = init.path;\n }\n}\n\n/** Истёк таймаут запроса, заданный опцией `timeout`. */\nexport class ItdTimeoutError extends ItdError {\n /** Значение таймаута в миллисекундах. */\n readonly timeout: number;\n /** HTTP-метод запроса. */\n readonly method: string;\n /** Путь запроса без базового URL. */\n readonly path: string;\n\n constructor(init: { timeout: number; method: string; path: string }) {\n super(\n ItdErrorKind.Timeout,\n `Запрос ${init.method} ${init.path} превысил таймаут ${init.timeout} мс`,\n );\n this.name = 'ItdTimeoutError';\n this.timeout = init.timeout;\n this.method = init.method;\n this.path = init.path;\n }\n}\n\n/** Запрос отменён через переданный `AbortSignal`. */\nexport class ItdAbortError extends ItdError {\n constructor(message = 'Запрос отменён', options?: { cause?: unknown }) {\n super(ItdErrorKind.Abort, message, options);\n this.name = 'ItdAbortError';\n }\n}\n\n/**\n * Операция невозможна в текущем состоянии объекта.\n *\n * Например, клиент уже окончательно освобождён через `dispose()` и не может выполнять\n * новые запросы или создавать realtime-потоки.\n */\nexport class ItdStateError extends ItdError {\n constructor(message: string, options?: { cause?: unknown }) {\n super(ItdErrorKind.State, message, options);\n this.name = 'ItdStateError';\n }\n}\n\n/**\n * Некорректная конфигурация или аргументы — обнаружено до обращения к сети.\n *\n * Этим же классом сообщают о нарушенных инвариантах билдеры: например, опрос\n * с одним вариантом ответа.\n */\nexport class ItdConfigError extends ItdError {\n constructor(message: string, options?: { cause?: unknown }) {\n super(ItdErrorKind.Config, message, options);\n this.name = 'ItdConfigError';\n }\n}\n\n/** Любая ошибка, порождённая этой библиотекой. */\nexport function isItdError(value: unknown): value is ItdError {\n return typeof value === 'object' && value !== null && ITD_ERROR in value;\n}\n\n/** Ошибка, пришедшая от сервера итд.com (статус ≥ 400). */\nexport function isItdApiError(value: unknown): value is ItdApiError {\n return isItdError(value) && value.kind === ItdErrorKind.Api;\n}\n\n/** Ошибка получения или чтения вложения. */\nexport function isItdFileError(value: unknown): value is ItdFileError {\n return isItdError(value) && value.kind === ItdErrorKind.File;\n}\n\n/** Операция невозможна в текущем состоянии объекта. */\nexport function isItdStateError(value: unknown): value is ItdStateError {\n return isItdError(value) && value.kind === ItdErrorKind.State;\n}\n\n/**\n * Проверяет разновидность ошибки API.\n *\n * Намеренно не `instanceof`: две копии пакета в дереве зависимостей или смешение сборок\n * ESM и CJS дают разные классы для одной и той же ошибки, и проверка по классу молча\n * перестаёт срабатывать. Поле {@link ItdApiError.apiKind} от этого не зависит.\n */\nfunction hasApiKind(value: unknown, kind: ItdApiErrorKind): boolean {\n return isItdApiError(value) && value.apiKind === kind;\n}\n\n/** Ошибка валидации: `VALIDATION_ERROR` либо статус `400`/`422`. */\nexport function isItdValidationError(value: unknown): value is ItdValidationError {\n return hasApiKind(value, ItdApiErrorKind.Validation);\n}\n\n/** Ошибка авторизации: истёкший или отозванный токен. */\nexport function isItdAuthError(value: unknown): value is ItdAuthError {\n return hasApiKind(value, ItdApiErrorKind.Auth);\n}\n\n/** Доступ запрещён либо действие ограничено настройками приватности. */\nexport function isItdForbiddenError(value: unknown): value is ItdForbiddenError {\n return hasApiKind(value, ItdApiErrorKind.Forbidden);\n}\n\n/** Сущность не найдена. */\nexport function isItdNotFoundError(value: unknown): value is ItdNotFoundError {\n return hasApiKind(value, ItdApiErrorKind.NotFound);\n}\n\n/** Сущность уже существует. */\nexport function isItdConflictError(value: unknown): value is ItdConflictError {\n return hasApiKind(value, ItdApiErrorKind.Conflict);\n}\n\n/** Превышен лимит запросов. */\nexport function isItdRateLimitError(value: unknown): value is ItdRateLimitError {\n return hasApiKind(value, ItdApiErrorKind.RateLimit);\n}\n\n/** Действие требует подтверждённого телефона. Ссылка — в `verificationUrl`. */\nexport function isItdPhoneVerificationError(value: unknown): value is ItdPhoneVerificationError {\n return hasApiKind(value, ItdApiErrorKind.PhoneVerification);\n}\n\n/** Ошибка на стороне сервера (`5xx`). */\nexport function isItdServerError(value: unknown): value is ItdServerError {\n return hasApiKind(value, ItdApiErrorKind.Server);\n}\n"],"mappings":"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"}
|