itd-api 0.9.1 → 0.9.3

package/dist/shared/storage-CfHKzVHf.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage-CfHKzVHf.js","names":["#store"],"sources":["../../src/session/storage.ts"],"sourcesContent":["import { ItdConfigError } from '../core/errors.js';\nimport {\n  createKeyValueStore,\n  type KeyValueStore,\n  MemoryKeyValueStore,\n} from '../core/key-value-store.js';\n\n/**\n * Сохранённая сессия.\n *\n * Кроме токенов сюда попадают cookie: refresh-токен итд.com живёт именно в cookie, и без них\n * восстановить сессию после перезапуска процесса невозможно.\n */\nexport interface ItdSession {\n  /** Токен доступа для заголовка `Authorization: Bearer`. */\n  accessToken?: string | undefined;\n  /**\n   * Refresh-токен, если удалось получить его явным значением.\n   *\n   * Обычно сервер держит его в httpOnly-cookie и наружу не отдаёт — тогда поле останется\n   * пустым, а обновление пойдёт через {@link ItdSession.cookies}.\n   */\n  refreshToken?: string | undefined;\n  /** Сырые cookie в форме `имя=значение`, привязанные к origin API. */\n  cookies?: string[] | undefined;\n  /**\n   * Идентификатор устройства для заголовка `X-Device-Id`.\n   *\n   * Сервер различает по нему записи в списке сессий, поэтому значение должно пережить\n   * перезапуск процесса — иначе каждый старт бота порождает новую сессию. Библиотека\n   * заводит его сама при первом запросе и хранит здесь.\n   */\n  deviceId?: string | undefined;\n  /** Когда сессия получена, мс с начала эпохи. Нужно для диагностики. */\n  obtainedAt?: number | undefined;\n}\n\n/**\n * Создаёт независимый снимок сессии.\n *\n * Сессии пересекают границу пользовательского кода и внутреннего состояния клиента.\n * Возвращать или сохранять их по ссылке нельзя: последующая мутация объекта или массива\n * cookie меняла бы уже сохранённую сессию без вызова `set()`.\n *\n * @internal\n */\nexport function copySession(session: ItdSession): ItdSession {\n  return {\n    ...session,\n    ...(session.cookies ? { cookies: [...session.cookies] } : {}),\n  };\n}\n\n/**\n * Хранилище сессии.\n *\n * Подключаемый компонент: библиотека не знает, где вы держите токены, и обращается к ним\n * только через этот интерфейс. Все методы могут быть как синхронными, так и асинхронными.\n *\n * @example Своё хранилище поверх AsyncStorage в React Native\n * ```ts\n * const backend = withCodec(createKeyValueStore({\n *   get: (key) => AsyncStorage.getItem(key).then((value) => value ?? undefined),\n *   set: (key, value) => AsyncStorage.setItem(key, value),\n *   delete: (key) => AsyncStorage.removeItem(key),\n * }), { encode: JSON.stringify, decode: JSON.parse });\n * const storage = createTokenStorage(withNamespace(backend, 'my-app'));\n * ```\n */\nexport interface TokenStorage {\n  /** Прочитать сессию. `null`, если её нет. */\n  get(): ItdSession | null | Promise<ItdSession | null>;\n  /** Сохранить сессию целиком. */\n  set(session: ItdSession): void | Promise<void>;\n  /** Удалить сессию. Вызывается при выходе и при неудачном обновлении токена. */\n  clear(): void | Promise<void>;\n}\n\n/**\n * Хранилище в памяти процесса — вариант по умолчанию.\n *\n * Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`\n * из `itd-api/node`, для браузера — `LocalStorageTokenStorage` или\n * `SessionStorageTokenStorage` из `itd-api/web`.\n */\nexport class MemoryTokenStorage implements TokenStorage {\n  readonly #store = new MemoryKeyValueStore<ItdSession>();\n\n  constructor(initial?: ItdSession | null) {\n    if (initial) this.#store.set(TOKEN_STORAGE_KEY, copySession(initial));\n  }\n\n  get(): ItdSession | null {\n    const session = this.#store.get(TOKEN_STORAGE_KEY);\n    return session ? copySession(session) : null;\n  }\n\n  set(session: ItdSession): void {\n    this.#store.set(TOKEN_STORAGE_KEY, copySession(session));\n  }\n\n  clear(): void {\n    this.#store.delete(TOKEN_STORAGE_KEY);\n  }\n}\n\nconst TOKEN_STORAGE_KEY = 'session';\n\n/** Настройки доменного адаптера одной сессии. */\nexport interface TokenStorageAdapterOptions {\n  /** Ключ сессии в backend. По умолчанию `session`. */\n  key?: string | undefined;\n}\n\nfunction isPromise<T>(value: T | Promise<T>): value is Promise<T> {\n  return (\n    typeof value === 'object' && value !== null && typeof (value as Promise<T>).then === 'function'\n  );\n}\n\n/**\n * Создаёт доменное хранилище сессии поверх общего {@link KeyValueStore}.\n *\n * @example\n * ```ts\n * const storage = createTokenStorage(withNamespace(redisStore, 'itd'));\n * ```\n */\nexport function createTokenStorage(\n  store: KeyValueStore<ItdSession>,\n  options: TokenStorageAdapterOptions = {},\n): TokenStorage {\n  const key = options.key ?? TOKEN_STORAGE_KEY;\n  if (typeof key !== 'string') throw new ItdConfigError('key TokenStorage должен быть строкой');\n  const backend = createKeyValueStore(store);\n  return {\n    get() {\n      const value = backend.get(key);\n      if (isPromise(value)) {\n        return value.then((session) => (session ? copySession(session) : null));\n      }\n      return value ? copySession(value) : null;\n    },\n    set: (session) => backend.set(key, copySession(session)),\n    clear: () => backend.delete(key),\n  };\n}\n"],"mappings":";;;;;;;;;;;;AA8CA,SAAgB,YAAY,SAAiC;CAC3D,OAAO;EACL,GAAG;EACH,GAAI,QAAQ,UAAU,EAAE,SAAS,CAAC,GAAG,QAAQ,OAAO,EAAE,IAAI,CAAC;CAC7D;AACF;;;;;;;;AAkCA,IAAa,qBAAb,MAAwD;CACtD,SAAkB,IAAI,oBAAgC;CAEtD,YAAY,SAA6B;EACvC,IAAI,SAAS,KAAKA,OAAO,IAAI,mBAAmB,YAAY,OAAO,CAAC;CACtE;CAEA,MAAyB;EACvB,MAAM,UAAU,KAAKA,OAAO,IAAI,iBAAiB;EACjD,OAAO,UAAU,YAAY,OAAO,IAAI;CAC1C;CAEA,IAAI,SAA2B;EAC7B,KAAKA,OAAO,IAAI,mBAAmB,YAAY,OAAO,CAAC;CACzD;CAEA,QAAc;EACZ,KAAKA,OAAO,OAAO,iBAAiB;CACtC;AACF;AAEA,MAAM,oBAAoB;AAQ1B,SAAS,UAAa,OAA4C;CAChE,OACE,OAAO,UAAU,YAAY,UAAU,QAAQ,OAAQ,MAAqB,SAAS;AAEzF;;;;;;;;;AAUA,SAAgB,mBACd,OACA,UAAsC,CAAC,GACzB;CACd,MAAM,MAAM,QAAQ,OAAO;CAC3B,IAAI,OAAO,QAAQ,UAAU,MAAM,IAAI,eAAe,sCAAsC;CAC5F,MAAM,UAAU,oBAAoB,KAAK;CACzC,OAAO;EACL,MAAM;GACJ,MAAM,QAAQ,QAAQ,IAAI,GAAG;GAC7B,IAAI,UAAU,KAAK,GACjB,OAAO,MAAM,MAAM,YAAa,UAAU,YAAY,OAAO,IAAI,IAAK;GAExE,OAAO,QAAQ,YAAY,KAAK,IAAI;EACtC;EACA,MAAM,YAAY,QAAQ,IAAI,KAAK,YAAY,OAAO,CAAC;EACvD,aAAa,QAAQ,OAAO,GAAG;CACjC;AACF"}

package/dist/shared/storage-QNVxzpDB.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage-QNVxzpDB.cjs","names":["#store","MemoryKeyValueStore","ItdConfigError","createKeyValueStore"],"sources":["../../src/session/storage.ts"],"sourcesContent":["import { ItdConfigError } from '../core/errors.js';\nimport {\n  createKeyValueStore,\n  type KeyValueStore,\n  MemoryKeyValueStore,\n} from '../core/key-value-store.js';\n\n/**\n * Сохранённая сессия.\n *\n * Кроме токенов сюда попадают cookie: refresh-токен итд.com живёт именно в cookie, и без них\n * восстановить сессию после перезапуска процесса невозможно.\n */\nexport interface ItdSession {\n  /** Токен доступа для заголовка `Authorization: Bearer`. */\n  accessToken?: string | undefined;\n  /**\n   * Refresh-токен, если удалось получить его явным значением.\n   *\n   * Обычно сервер держит его в httpOnly-cookie и наружу не отдаёт — тогда поле останется\n   * пустым, а обновление пойдёт через {@link ItdSession.cookies}.\n   */\n  refreshToken?: string | undefined;\n  /** Сырые cookie в форме `имя=значение`, привязанные к origin API. */\n  cookies?: string[] | undefined;\n  /**\n   * Идентификатор устройства для заголовка `X-Device-Id`.\n   *\n   * Сервер различает по нему записи в списке сессий, поэтому значение должно пережить\n   * перезапуск процесса — иначе каждый старт бота порождает новую сессию. Библиотека\n   * заводит его сама при первом запросе и хранит здесь.\n   */\n  deviceId?: string | undefined;\n  /** Когда сессия получена, мс с начала эпохи. Нужно для диагностики. */\n  obtainedAt?: number | undefined;\n}\n\n/**\n * Создаёт независимый снимок сессии.\n *\n * Сессии пересекают границу пользовательского кода и внутреннего состояния клиента.\n * Возвращать или сохранять их по ссылке нельзя: последующая мутация объекта или массива\n * cookie меняла бы уже сохранённую сессию без вызова `set()`.\n *\n * @internal\n */\nexport function copySession(session: ItdSession): ItdSession {\n  return {\n    ...session,\n    ...(session.cookies ? { cookies: [...session.cookies] } : {}),\n  };\n}\n\n/**\n * Хранилище сессии.\n *\n * Подключаемый компонент: библиотека не знает, где вы держите токены, и обращается к ним\n * только через этот интерфейс. Все методы могут быть как синхронными, так и асинхронными.\n *\n * @example Своё хранилище поверх AsyncStorage в React Native\n * ```ts\n * const backend = withCodec(createKeyValueStore({\n *   get: (key) => AsyncStorage.getItem(key).then((value) => value ?? undefined),\n *   set: (key, value) => AsyncStorage.setItem(key, value),\n *   delete: (key) => AsyncStorage.removeItem(key),\n * }), { encode: JSON.stringify, decode: JSON.parse });\n * const storage = createTokenStorage(withNamespace(backend, 'my-app'));\n * ```\n */\nexport interface TokenStorage {\n  /** Прочитать сессию. `null`, если её нет. */\n  get(): ItdSession | null | Promise<ItdSession | null>;\n  /** Сохранить сессию целиком. */\n  set(session: ItdSession): void | Promise<void>;\n  /** Удалить сессию. Вызывается при выходе и при неудачном обновлении токена. */\n  clear(): void | Promise<void>;\n}\n\n/**\n * Хранилище в памяти процесса — вариант по умолчанию.\n *\n * Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`\n * из `itd-api/node`, для браузера — `LocalStorageTokenStorage` или\n * `SessionStorageTokenStorage` из `itd-api/web`.\n */\nexport class MemoryTokenStorage implements TokenStorage {\n  readonly #store = new MemoryKeyValueStore<ItdSession>();\n\n  constructor(initial?: ItdSession | null) {\n    if (initial) this.#store.set(TOKEN_STORAGE_KEY, copySession(initial));\n  }\n\n  get(): ItdSession | null {\n    const session = this.#store.get(TOKEN_STORAGE_KEY);\n    return session ? copySession(session) : null;\n  }\n\n  set(session: ItdSession): void {\n    this.#store.set(TOKEN_STORAGE_KEY, copySession(session));\n  }\n\n  clear(): void {\n    this.#store.delete(TOKEN_STORAGE_KEY);\n  }\n}\n\nconst TOKEN_STORAGE_KEY = 'session';\n\n/** Настройки доменного адаптера одной сессии. */\nexport interface TokenStorageAdapterOptions {\n  /** Ключ сессии в backend. По умолчанию `session`. */\n  key?: string | undefined;\n}\n\nfunction isPromise<T>(value: T | Promise<T>): value is Promise<T> {\n  return (\n    typeof value === 'object' && value !== null && typeof (value as Promise<T>).then === 'function'\n  );\n}\n\n/**\n * Создаёт доменное хранилище сессии поверх общего {@link KeyValueStore}.\n *\n * @example\n * ```ts\n * const storage = createTokenStorage(withNamespace(redisStore, 'itd'));\n * ```\n */\nexport function createTokenStorage(\n  store: KeyValueStore<ItdSession>,\n  options: TokenStorageAdapterOptions = {},\n): TokenStorage {\n  const key = options.key ?? TOKEN_STORAGE_KEY;\n  if (typeof key !== 'string') throw new ItdConfigError('key TokenStorage должен быть строкой');\n  const backend = createKeyValueStore(store);\n  return {\n    get() {\n      const value = backend.get(key);\n      if (isPromise(value)) {\n        return value.then((session) => (session ? copySession(session) : null));\n      }\n      return value ? copySession(value) : null;\n    },\n    set: (session) => backend.set(key, copySession(session)),\n    clear: () => backend.delete(key),\n  };\n}\n"],"mappings":";;;;;;;;;;;;AA8CA,SAAgB,YAAY,SAAiC;CAC3D,OAAO;EACL,GAAG;EACH,GAAI,QAAQ,UAAU,EAAE,SAAS,CAAC,GAAG,QAAQ,OAAO,EAAE,IAAI,CAAC;CAC7D;AACF;;;;;;;;AAkCA,IAAa,qBAAb,MAAwD;CACtD,SAAkB,IAAIC,wBAAAA,oBAAgC;CAEtD,YAAY,SAA6B;EACvC,IAAI,SAAS,KAAKD,OAAO,IAAI,mBAAmB,YAAY,OAAO,CAAC;CACtE;CAEA,MAAyB;EACvB,MAAM,UAAU,KAAKA,OAAO,IAAI,iBAAiB;EACjD,OAAO,UAAU,YAAY,OAAO,IAAI;CAC1C;CAEA,IAAI,SAA2B;EAC7B,KAAKA,OAAO,IAAI,mBAAmB,YAAY,OAAO,CAAC;CACzD;CAEA,QAAc;EACZ,KAAKA,OAAO,OAAO,iBAAiB;CACtC;AACF;AAEA,MAAM,oBAAoB;AAQ1B,SAAS,UAAa,OAA4C;CAChE,OACE,OAAO,UAAU,YAAY,UAAU,QAAQ,OAAQ,MAAqB,SAAS;AAEzF;;;;;;;;;AAUA,SAAgB,mBACd,OACA,UAAsC,CAAC,GACzB;CACd,MAAM,MAAM,QAAQ,OAAO;CAC3B,IAAI,OAAO,QAAQ,UAAU,MAAM,IAAIE,eAAAA,eAAe,sCAAsC;CAC5F,MAAM,UAAUC,wBAAAA,oBAAoB,KAAK;CACzC,OAAO;EACL,MAAM;GACJ,MAAM,QAAQ,QAAQ,IAAI,GAAG;GAC7B,IAAI,UAAU,KAAK,GACjB,OAAO,MAAM,MAAM,YAAa,UAAU,YAAY,OAAO,IAAI,IAAK;GAExE,OAAO,QAAQ,YAAY,KAAK,IAAI;EACtC;EACA,MAAM,YAAY,QAAQ,IAAI,KAAK,YAAY,OAAO,CAAC;EACvD,aAAa,QAAQ,OAAO,GAAG;CACjC;AACF"}