добавлено значение contextAsync

docs/examples/contextAsync.md

@@ -0,0 +1,60 @@
+# Пример использования значения `.contextAsync`
+
+- [Зачем нужен?](#зачем-нужен)
+- [Как использовать?](#как-использовать)
+- [Назад к методам](../guide.md#contextasync)
+
+## Зачем нужен?
+
+Это значение позволяет получить доступ к [контексту](../reference.md#context) без предварительной авторизации.
+
+## Как использовать?
+
+> Не работает при импорте класса `Safe`
+
+Представим, что мы хотим получить оценки первого предмета из доступных и чтобы не вызывать авторизацию, мы можем воспользоваться этим значением.
+
+```typescript
+import NS from "netschoolapi";
+
+const user = new NS({
+  origin: "https://example.com",
+  login: "Иванов",
+  password: "123456",
+  school: "МБОУ ...", // Название школы (полностью) или её id
+});
+
+(async function () {
+  // Получаем массив предметов
+  const { subjects } = await user.contextAsync;
+
+  // Получаем отчет "Отчет об успеваемости ученика"
+  const report = await user.grades({ subjectId: subjects[0].id });
+  console.log(report);
+})();
+```
+
+Без этого значения код выглядел бы следующим образом:
+
+```typescript
+import NS from "netschoolapi";
+
+const user = new NS({
+  origin: "https://example.com",
+  login: "Иванов",
+  password: "123456",
+  school: "МБОУ ...", // Название школы (полностью) или её id
+});
+
+(async function () {
+  // Авторизуемся
+  await user.logIn();
+
+  // Получаем массив предметов
+  const { subjects } = await user.context;
+
+  // Получаем отчет "Отчет об успеваемости ученика"
+  const report = await user.grades({ subjectId: subjects[0].id });
+  console.log(report);
+})();
+```

docs/guide.md

@@ -21,6 +21,7 @@
   - [.journal()](#journal)
 - [Дополнительно](#дополнительно)
   - [.fetch()](#fetch)
+  - [.contextAsync](#contextasync)
 
 ## Управление сессией
 
@@ -228,3 +229,13 @@
 #### Возвращает объект класса [Response](https://www.npmjs.com/package/node-fetch#class-response)
 
 #### [Пример использования](examples/fetch.md)
+
+---
+
+### .contextAsync
+
+> Это значение, а не метод, и оно не доступно в классе `Safe`.
+
+#### Возвращает объект класса [Context](reference.md#context), представляющий асинхронный контекст
+
+#### [Пример использования](examples/contextAsync.md)

src/NetSchoolApi.ts

@@ -48,6 +48,22 @@ export default class NetSchoolApi extends NS {
     });
   }
 
+  /** Контекст который доступен без авторизации */
+  get contextAsync(): Promise<NonNullable<NS["context"]>> {
+    // Если нет контекста, то создаём (через авторизацию)
+    return new Promise((resolve, reject) => {
+      if (this.context) {
+        resolve(this.context);
+      } else {
+        this.logIn()
+          .then(() => {
+            resolve(this.context as NonNullable<NS["context"]>);
+          })
+          .catch(reject);
+      }
+    });
+  }
+
   /** Открытие сессии (только если она закрыта) */
   async logIn(): Promise<Session> {
     const valid = await super.sessionValid();