@alexdevco/passport 1.0.9 → 1.0.11

package/dist/interfaces/ jwt.interface.d.ts

@@ -1,5 +1,19 @@
 import type { IPayload, IVerifyResult } from './token.interface';
+/**
+ * Интерфейс стратегии JWT.
+ * Определяет методы для генерации и верификации JWT токенов.
+ */
 export interface IJWTStrategy {
+    /**
+     * Генерирует JWT токен на основе полезной нагрузки.
+     * @param payload - Данные для включения в токен.
+     * @returns Строка с JWT токеном.
+     */
     generate(payload: IPayload): string;
+    /**
+     * Проверяет действительность JWT токена.
+     * @param token - Токен для проверки.
+     * @returns Результат проверки токена.
+     */
     verify(token: string): IVerifyResult;
 }

package/dist/interfaces/passport-async-options.interface.d.ts

@@ -1,6 +1,18 @@
 import type { FactoryProvider, ModuleMetadata } from '@nestjs/common';
 import { IPassportOptions } from './passport-options.interface';
+/**
+ * Интерфейс для асинхронной конфигурации модуля Passport.
+ * Позволяет настраивать параметры Passport с использованием фабричной функции,
+ * что особенно полезно когда параметры зависят от других сервисов или асинхронных операций.
+ */
 export interface IPassportAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    /**
+     * Фабричная функция, которая создает параметры Passport.
+     * Может возвращать параметры напрямую или через Promise.
+     */
     useFactory: (...args: any[]) => Promise<IPassportOptions> | IPassportOptions;
+    /**
+     * Опциональный массив токенов зависимостей, которые будут внедрены в useFactory.
+     */
     inject?: FactoryProvider['inject'];
 }

package/dist/interfaces/passport-options.interface.d.ts

@@ -1,5 +1,20 @@
+/**
+ * Интерфейс параметров конфигурации для модуля Passport.
+ * Определяет основные настройки, необходимые для работы с JWT токенами.
+ */
 export interface IPassportOptions {
+    /**
+     * Секретный ключ, используемый для подписи JWT токенов.
+     */
     secretKey: string;
+    /**
+     * Публичный ключ, используемый для верификации JWT токенов.
+     * Обязателен для асимметричных алгоритмов (например, RS256).
+     */
     publicKey?: string;
+    /**
+     * Алгоритм шифрования, используемый для создания и проверки токенов.
+     * Например: 'HS256', 'RS256' и т.д.
+     */
     strategy: string;
 }

package/dist/interfaces/token.interface.d.ts

@@ -1,15 +1,55 @@
+/**
+ * Интерфейс полезной нагрузки JWT токена (Payload).
+ * Содержит информацию о пользователе и метаданные токена.
+ */
 export interface IPayload {
+    /**
+     * Идентификатор (Subject ID) - уникальный идентификатор пользователя.
+     */
     sub: string | number;
+    /**
+     * Имя пользователя .
+     */
     name: string;
+    /**
+     * Время выпуска токена (Issued At) в секундах since Unix epoch.
+     */
     iat: number;
+    /**
+     * Время истечения срока действия токена (Expiration Time) в секундах since Unix epoch.
+     */
     exp: number;
 }
+/**
+ * Интерфейс заголовка JWT токена (Header).
+ * Определяет тип токена и алгоритм шифрования.
+ */
 export interface IHeader {
+    /**
+     * Алгоритм шифрования, используемый для подписи токена.
+     * Например: 'HS256', 'RS256'
+     */
     alg: string;
+    /**
+     * Тип токена, обычно 'JWT'.
+     */
     typ: string;
 }
+/**
+ * Интерфейс результата верификации токена.
+ * Содержит информацию о валидности токена и причине отказа, если он недействителен.
+ */
 export interface IVerifyResult {
+    /**
+     * Флаг, указывающий, является ли токен действительным.
+     */
     valid: boolean;
+    /**
+     * Причина, по которой токен недействителен (если применимо).
+     */
     reason?: string;
+    /**
+     * Полезная нагрузка токена, если он действителен.
+     */
     payload?: IPayload;
 }

package/dist/passport.module.d.ts

@@ -1,6 +1,18 @@
 import { type DynamicModule } from '@nestjs/common';
 import type { IPassportAsyncOptions, IPassportOptions } from './interfaces';
 export declare class PassportModule {
+    /**
+     * Регистрирует модуль паспорта с синхронными опциями конфигурации.
+     *
+     * @param options - Объект с параметрами конфигурации паспорта.
+     * @returns Динамический модуль NestJS с настроенными провайдерами и экспортируемыми сервисами.
+     */
     static register(options: IPassportOptions): DynamicModule;
+    /**
+     * Регистрирует модуль паспорта с асинхронными опциями конфигурации.
+     *
+     * @param options - Объект с асинхронными параметрами конфигурации паспорта.
+     * @returns Динамический модуль NestJS с настроенными провайдерами и экспортируемыми сервисами.
+     */
     static registerAsync(options: IPassportAsyncOptions): DynamicModule;
 }

package/dist/passport.module.js

@@ -13,6 +13,12 @@ const constants_1 = require("./constants");
 const passport_providers_1 = require("./passport.providers");
 const passport_service_1 = require("./passport.service");
 let PassportModule = PassportModule_1 = class PassportModule {
+    /**
+     * Регистрирует модуль паспорта с синхронными опциями конфигурации.
+     *
+     * @param options - Объект с параметрами конфигурации паспорта.
+     * @returns Динамический модуль NestJS с настроенными провайдерами и экспортируемыми сервисами.
+     */
     static register(options) {
         const optionsProvider = (0, passport_providers_1.createPassportOptionsProvider)(options);
         return {
@@ -21,6 +27,12 @@ let PassportModule = PassportModule_1 = class PassportModule {
             exports: [passport_service_1.PassportService, constants_1.PASSPORT_OPTIONS]
         };
     }
+    /**
+     * Регистрирует модуль паспорта с асинхронными опциями конфигурации.
+     *
+     * @param options - Объект с асинхронными параметрами конфигурации паспорта.
+     * @returns Динамический модуль NestJS с настроенными провайдерами и экспортируемыми сервисами.
+     */
     static registerAsync(options) {
         const optionProvider = (0, passport_providers_1.createPassportAsyncOptionsProvider)(options);
         return {

package/dist/passport.providers.d.ts

@@ -1,4 +1,16 @@
 import type { Provider } from '@nestjs/common';
 import type { IPassportAsyncOptions, IPassportOptions } from './interfaces';
+/**
+ * Создает провайдер для синхронных опций паспорта.
+ *
+ * @param options - Синхронные опции паспорта
+ * @returns Провайдер NestJS с замороженными опциями паспорта
+ */
 export declare function createPassportOptionsProvider(options: IPassportOptions): Provider;
+/**
+ * Создает асинхронный провайдер для опций паспорта.
+ *
+ * @param options - Асинхронные опции паспорта
+ * @returns Провайдер NestJS с асинхронно разрешенными и замороженными опциями паспорта
+ */
 export declare function createPassportAsyncOptionsProvider(options: IPassportAsyncOptions): Provider;

package/dist/passport.providers.js

@@ -3,12 +3,24 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createPassportOptionsProvider = createPassportOptionsProvider;
 exports.createPassportAsyncOptionsProvider = createPassportAsyncOptionsProvider;
 const constants_1 = require("./constants");
+/**
+ * Создает провайдер для синхронных опций паспорта.
+ *
+ * @param options - Синхронные опции паспорта
+ * @returns Провайдер NestJS с замороженными опциями паспорта
+ */
 function createPassportOptionsProvider(options) {
     return {
         provide: constants_1.PASSPORT_OPTIONS,
         useValue: Object.freeze({ ...options })
     };
 }
+/**
+ * Создает асинхронный провайдер для опций паспорта.
+ *
+ * @param options - Асинхронные опции паспорта
+ * @returns Провайдер NestJS с асинхронно разрешенными и замороженными опциями паспорта
+ */
 function createPassportAsyncOptionsProvider(options) {
     return {
         provide: constants_1.PASSPORT_OPTIONS,

package/dist/passport.service.d.ts

@@ -1,10 +1,24 @@
 import { IPassportOptions, IPayload, IVerifyResult } from './interfaces';
+/**
+ * Сервис для работы с JWT токенами.
+ * Обеспечивает генерацию и верификацию токенов с использованием заданной стратегии.
+ */
 export declare class PassportService {
     private readonly options;
     private readonly SECRET_KEY;
     private readonly PUBLIC_KEY;
     private readonly strategy;
     constructor(options: IPassportOptions);
+    /**
+     * Генерирует JWT токен на основе переданного payload
+     * @param payload - данные для включения в токен
+     * @returns JWT токен в виде строки
+     */
     generate(payload: IPayload): string;
+    /**
+     * Проверяет JWT токен и возвращает результат верификации
+     * @param token - JWT токен для проверки
+     * @returns Результат верификации токена
+     */
     verify(token: string): IVerifyResult;
 }

package/dist/passport.service.js

@@ -16,6 +16,10 @@ exports.PassportService = void 0;
 const common_1 = require("@nestjs/common");
 const constants_1 = require("./constants");
 const utils_1 = require("./utils");
+/**
+ * Сервис для работы с JWT токенами.
+ * Обеспечивает генерацию и верификацию токенов с использованием заданной стратегии.
+ */
 let PassportService = class PassportService {
     options;
     SECRET_KEY;
@@ -27,9 +31,19 @@ let PassportService = class PassportService {
         this.PUBLIC_KEY = options.publicKey;
         this.strategy = (0, utils_1.getStrategy)(options.strategy, this.SECRET_KEY, this.PUBLIC_KEY);
     }
+    /**
+     * Генерирует JWT токен на основе переданного payload
+     * @param payload - данные для включения в токен
+     * @returns JWT токен в виде строки
+     */
     generate(payload) {
         return this.strategy.generate(payload);
     }
+    /**
+     * Проверяет JWT токен и возвращает результат верификации
+     * @param token - JWT токен для проверки
+     * @returns Результат верификации токена
+     */
     verify(token) {
         return this.strategy.verify(token);
     }

package/dist/strategies/hs256.strategy.d.ts

@@ -6,7 +6,26 @@ export declare class HS256Strategy implements IJWTStrategy {
     private static readonly JWT_ALG;
     private static readonly PARTS_LENGTH;
     constructor(secret: string);
+    /**
+     * Генерирует JWT токен на основе переданной полезной нагрузки.
+     *
+     * @param payload - Полезная нагрузка для включения в токен.
+     * @returns Строка сгенерированного JWT токена.
+     */
     generate(payload: IPayload): string;
+    /**
+     * Проверяет действительность и срок действия переданного токена.
+     *
+     * @param token - Токен для проверки.
+     * @returns Результат проверки токена.
+     */
     verify(token: string): IVerifyResult;
+    /**
+     * Вычисляет HMAC-подпись для переданных данных, используя секретный ключ.
+     * Алгоритм шифрования: SHA-256.
+     *
+     * @param data - Данные, для которых необходимо вычислить подпись.
+     * @returns Подпись в виде строки шестнадцатеричного формата.
+     */
     private computeHmac;
 }

package/dist/strategies/hs256.strategy.js

@@ -11,6 +11,12 @@ class HS256Strategy {
     constructor(secret) {
         this.SECRET_KEY = secret;
     }
+    /**
+     * Генерирует JWT токен на основе переданной полезной нагрузки.
+     *
+     * @param payload - Полезная нагрузка для включения в токен.
+     * @returns Строка сгенерированного JWT токена.
+     */
     generate(payload) {
         const header = { alg: HS256Strategy.JWT_ALG, typ: 'JWT' };
         const headerB64 = (0, utils_1.base64UrlEncode)(JSON.stringify(header));
@@ -19,6 +25,12 @@ class HS256Strategy {
         const mac = this.computeHmac(serialized);
         return (0, utils_1.serialize)([serialized, mac], HS256Strategy.INTERNAL_SEPARATOR);
     }
+    /**
+     * Проверяет действительность и срок действия переданного токена.
+     *
+     * @param token - Токен для проверки.
+     * @returns Результат проверки токена.
+     */
     verify(token) {
         const parts = token.split(HS256Strategy.INTERNAL_SEPARATOR);
         if (parts.length !== HS256Strategy.PARTS_LENGTH) {
@@ -36,10 +48,17 @@ class HS256Strategy {
         const payload = parsed;
         if (!Number.isFinite(payload.exp))
             return { valid: false, reason: 'Expired error format' };
-        if (Date.now() > payload.exp)
+        if ((0, utils_1.now)() > payload.exp)
             return { valid: false, reason: 'Token is expired' };
         return { valid: true, payload };
     }
+    /**
+     * Вычисляет HMAC-подпись для переданных данных, используя секретный ключ.
+     * Алгоритм шифрования: SHA-256.
+     *
+     * @param data - Данные, для которых необходимо вычислить подпись.
+     * @returns Подпись в виде строки шестнадцатеричного формата.
+     */
     computeHmac(data) {
         return (0, crypto_1.createHmac)('sha256', this.SECRET_KEY).update(data).digest('hex');
     }

package/dist/strategies/rs256.strategy.d.ts

@@ -6,8 +6,32 @@ export declare class RS256Strategy implements IJWTStrategy {
     private static readonly INTERNAL_SEPARATOR;
     private static readonly JWT_ALG;
     private static readonly PARTS_LENGTH;
+    /**
+     * Конструктор класса RS256Strategy
+     *
+     * @param secretKey - закрытый ключ для подписи токенов
+     * @param publicKey - открытый ключ для проверки токенов
+     */
     constructor(secretKey: string, publicKey: string);
+    /**
+     * Генерация JWT токена с использованием алгоритма RS256
+     *
+     * @param payload - данные для включения в токен
+     * @returns сгенерированный JWT токен в виде строки
+     */
     generate(payload: IPayload): string;
+    /**
+     * Проверка валидности токена
+     *
+     * @param token - строка токена для проверки
+     * @returns результат проверки токена со статусом и возможной полезной нагрузкой
+     */
     verify(token: string): IVerifyResult;
+    /**
+     * Создание подписи для токена
+     *
+     * @param data - данные для шифрования
+     * @returns зашифрованная строка подписи
+     */
     private computeRSA;
 }

package/dist/strategies/rs256.strategy.js

@@ -9,10 +9,22 @@ class RS256Strategy {
     static INTERNAL_SEPARATOR = '.';
     static JWT_ALG = 'RSA-SHA256';
     static PARTS_LENGTH = 3;
+    /**
+     * Конструктор класса RS256Strategy
+     *
+     * @param secretKey - закрытый ключ для подписи токенов
+     * @param publicKey - открытый ключ для проверки токенов
+     */
     constructor(secretKey, publicKey) {
         this.SECRET_KEY = secretKey;
         this.PUBLIC_KEY = publicKey;
     }
+    /**
+     * Генерация JWT токена с использованием алгоритма RS256
+     *
+     * @param payload - данные для включения в токен
+     * @returns сгенерированный JWT токен в виде строки
+     */
     generate(payload) {
         const header = { alg: 'RS256', typ: 'JWT' };
         const headerB64 = (0, utils_1.base64UrlEncode)(JSON.stringify(header));
@@ -21,6 +33,12 @@ class RS256Strategy {
         const mac = this.computeRSA(serialized);
         return (0, utils_1.serialize)([serialized, mac], RS256Strategy.INTERNAL_SEPARATOR);
     }
+    /**
+     * Проверка валидности токена
+     *
+     * @param token - строка токена для проверки
+     * @returns результат проверки токена со статусом и возможной полезной нагрузкой
+     */
     verify(token) {
         const parts = token.split(RS256Strategy.INTERNAL_SEPARATOR);
         if (parts.length !== RS256Strategy.PARTS_LENGTH)
@@ -37,10 +55,16 @@ class RS256Strategy {
         const payload = parsed;
         if (!Number.isFinite(payload.exp))
             return { valid: false, reason: 'Expired error format' };
-        if (Date.now() > payload.exp)
+        if ((0, utils_1.now)() > payload.exp)
             return { valid: false, reason: 'Token is expired' };
         return { valid: true, payload };
     }
+    /**
+     * Создание подписи для токена
+     *
+     * @param data - данные для шифрования
+     * @returns зашифрованная строка подписи
+     */
     computeRSA(data) {
         const sign = (0, crypto_1.createSign)(RS256Strategy.JWT_ALG)
             .update(data)

package/dist/utils/base64.d.ts

@@ -1,2 +1,17 @@
+/**
+ * Кодирует буфер или строку в формат Base64URL.
+ * Base64URL - это модифицированная версия стандартного Base64,
+ * используемая в JWT токенах для безопасной передачи данных в URL.
+ *
+ * @param buf - Буфер или строка для кодирования
+ * @returns Строка в формате Base64URL
+ */
 export declare function base64UrlEncode(buf: Buffer | string): string;
+/**
+ * Декодирует строку из формата Base64URL в обычную строку.
+ * Обратная операция к base64UrlEncode.
+ *
+ * @param str - Строка в формате Base64URL для декодирования
+ * @returns Декодированная строка
+ */
 export declare function base64UrlDecode(str: string): string;

package/dist/utils/base64.js

@@ -2,16 +2,32 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.base64UrlEncode = base64UrlEncode;
 exports.base64UrlDecode = base64UrlDecode;
+/**
+ * Кодирует буфер или строку в формат Base64URL.
+ * Base64URL - это модифицированная версия стандартного Base64,
+ * используемая в JWT токенах для безопасной передачи данных в URL.
+ *
+ * @param buf - Буфер или строка для кодирования
+ * @returns Строка в формате Base64URL
+ */
 function base64UrlEncode(buf) {
     const buffer = typeof buf === 'string' ? Buffer.from(buf) : buf;
     return buffer
         .toString('base64')
-        .replace(/\+/g, '-')
-        .replace(/\//g, '_')
-        .replace(/=+$/, '');
+        .replace(/\+/g, '-') // Заменяем + на -
+        .replace(/\//g, '_') // Заменяем / на _
+        .replace(/=+$/, ''); // Удаляем символы заполнения в конце
 }
+/**
+ * Декодирует строку из формата Base64URL в обычную строку.
+ * Обратная операция к base64UrlEncode.
+ *
+ * @param str - Строка в формате Base64URL для декодирования
+ * @returns Декодированная строка
+ */
 function base64UrlDecode(str) {
-    str = str.replace(/-/g, '+').replace(/_/g, '/');
+    str = str.replace(/-/g, '+').replace(/_/g, '/'); // Восстанавливаем оригинальные символы Base64
+    // Добавляем символы заполнения, если длина не кратна 4
     while (str.length % 4)
         str += '=';
     return Buffer.from(str, 'base64').toString();

package/dist/utils/checks.d.ts

@@ -1,3 +1,23 @@
 import { IHeader, IPayload } from '../interfaces';
+/**
+ * Проверяет, является ли переданный объект полезной нагрузкой токена.
+ * Объект считается полезной нагрузкой, если:
+ * - свойство sub является строкой или числом
+ * - свойство name является строкой
+ * - свойство iat является числом
+ * - свойство exp является числом
+ *
+ * @param data - проверяемый объект
+ * @returns true, если объект соответствует интерфейсу IPayload, иначе false
+ */
 export declare function isPayload(data: any): data is IPayload;
+/**
+ * Проверяет, является ли переданный объект заголовком токена.
+ * Объект считается заголовком, если:
+ * - свойство alg является строкой
+ * - свойство typ является строкой
+ *
+ * @param data - проверяемый объект
+ * @returns true, если объект соответствует интерфейсу IHeader, иначе false
+ */
 export declare function isHeader(data: any): data is IHeader;

package/dist/utils/checks.js

@@ -2,12 +2,32 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isPayload = isPayload;
 exports.isHeader = isHeader;
+/**
+ * Проверяет, является ли переданный объект полезной нагрузкой токена.
+ * Объект считается полезной нагрузкой, если:
+ * - свойство sub является строкой или числом
+ * - свойство name является строкой
+ * - свойство iat является числом
+ * - свойство exp является числом
+ *
+ * @param data - проверяемый объект
+ * @returns true, если объект соответствует интерфейсу IPayload, иначе false
+ */
 function isPayload(data) {
     return ((typeof data.sub === 'string' || typeof data.sub === 'number') &&
         typeof data.name === 'string' &&
         typeof data.iat === 'number' &&
         typeof data.exp === 'number');
 }
+/**
+ * Проверяет, является ли переданный объект заголовком токена.
+ * Объект считается заголовком, если:
+ * - свойство alg является строкой
+ * - свойство typ является строкой
+ *
+ * @param data - проверяемый объект
+ * @returns true, если объект соответствует интерфейсу IHeader, иначе false
+ */
 function isHeader(data) {
     return typeof data.alg === 'string' && typeof data.typ === 'string';
 }

package/dist/utils/crypto.d.ts

@@ -1,4 +1,21 @@
 import { Verify } from 'crypto';
+/**
+ * Сравнивает две строки за константное время для предотвращения атак по времени
+ * @param a - первая строка для сравнения
+ * @param b - вторая строка для сравнения
+ * @returns true, если строки идентичны, false в противном случае
+ */
 export declare function constantTimeEqual(a: string, b: string): boolean;
+/**
+ * Создаёт объект для проверки подписи RSA-SHA256 на основе переданных данных
+ * @param data - данные для проверки подписи
+ * @returns объект Verify, готовый к проверке подписи
+ */
 export declare function getVerifyRSA(data: string): Verify;
+/**
+ * Объединяет массив строк в одну строку с указанным разделителем
+ * @param arr - массив строк для объединения
+ * @param separator - разделитель между элементами массива
+ * @returns объединённая строка
+ */
 export declare function serialize(arr: string[], separator: string): string;

package/dist/utils/crypto.js

@@ -4,6 +4,12 @@ exports.constantTimeEqual = constantTimeEqual;
 exports.getVerifyRSA = getVerifyRSA;
 exports.serialize = serialize;
 const crypto_1 = require("crypto");
+/**
+ * Сравнивает две строки за константное время для предотвращения атак по времени
+ * @param a - первая строка для сравнения
+ * @param b - вторая строка для сравнения
+ * @returns true, если строки идентичны, false в противном случае
+ */
 function constantTimeEqual(a, b) {
     const bufA = Buffer.from(a);
     const bufB = Buffer.from(b);
@@ -11,9 +17,20 @@ function constantTimeEqual(a, b) {
         return false;
     return (0, crypto_1.timingSafeEqual)(bufA, bufB);
 }
+/**
+ * Создаёт объект для проверки подписи RSA-SHA256 на основе переданных данных
+ * @param data - данные для проверки подписи
+ * @returns объект Verify, готовый к проверке подписи
+ */
 function getVerifyRSA(data) {
     return (0, crypto_1.createVerify)('RSA-SHA256').update(data);
 }
+/**
+ * Объединяет массив строк в одну строку с указанным разделителем
+ * @param arr - массив строк для объединения
+ * @param separator - разделитель между элементами массива
+ * @returns объединённая строка
+ */
 function serialize(arr, separator) {
     return arr.join(separator);
 }

package/dist/utils/date.d.ts

@@ -1 +1,4 @@
+/**
+ * Возвращает текущую дату в формате timestamp (в секундах)
+ */
 export declare function now(): number;

package/dist/utils/date.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.now = now;
+/**
+ * Возвращает текущую дату в формате timestamp (в секундах)
+ */
 function now() {
     return Math.floor(Date.now() / 1000);
 }

package/dist/utils/jwt.d.ts

@@ -1,6 +1,22 @@
 import { IJWTStrategy } from '../interfaces/ jwt.interface';
+/**
+ * Декодирует JWT токен без проверки подписи.
+ * Извлекает и парсит заголовок и полезную нагрузку из токена.
+ *
+ * @param token - JWT токен для декодирования
+ * @returns Объект с декодированным заголовком и полезной нагрузкой
+ */
 export declare function JwtDecode(token: string): {
     header: any;
     payload: any;
 };
+/**
+ * Создает экземпляр стратегии JWT на основе указанного типа.
+ *
+ * @param type - Тип стратегии (например, 'HS256', 'RS256')
+ * @param secretKey - Секретный ключ для подписи токенов
+ * @param publicKey - Публичный ключ для верификации токенов (обязателен для RS256)
+ * @returns Экземпляр соответствующей стратегии JWT
+ * @throws Error если указана неподдерживаемая стратегия или отсутствует публичный ключ для RS256
+ */
 export declare function getStrategy(type: string, secretKey: string, publicKey: string | null): IJWTStrategy;

package/dist/utils/jwt.js

@@ -5,6 +5,13 @@ exports.getStrategy = getStrategy;
 const constants_1 = require("../constants");
 const strategies_1 = require("../strategies");
 const base64_1 = require("./base64");
+/**
+ * Декодирует JWT токен без проверки подписи.
+ * Извлекает и парсит заголовок и полезную нагрузку из токена.
+ *
+ * @param token - JWT токен для декодирования
+ * @returns Объект с декодированным заголовком и полезной нагрузкой
+ */
 function JwtDecode(token) {
     const [header, payload] = token.split('.');
     return {
@@ -12,6 +19,15 @@ function JwtDecode(token) {
         payload: JSON.parse((0, base64_1.base64UrlDecode)(payload))
     };
 }
+/**
+ * Создает экземпляр стратегии JWT на основе указанного типа.
+ *
+ * @param type - Тип стратегии (например, 'HS256', 'RS256')
+ * @param secretKey - Секретный ключ для подписи токенов
+ * @param publicKey - Публичный ключ для верификации токенов (обязателен для RS256)
+ * @returns Экземпляр соответствующей стратегии JWT
+ * @throws Error если указана неподдерживаемая стратегия или отсутствует публичный ключ для RS256
+ */
 function getStrategy(type, secretKey, publicKey) {
     switch (type) {
         case constants_1.JWTStrategy.HS256:

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@alexdevco/passport",
-	"version": "1.0.9",
+	"version": "1.0.11",
 	"description": "Lightweight AlexDevCo authentication library",
 	"homepage": "https://github.com/alexdevcoru/passport#readme",
 	"bugs": {