@alexdevco/passport 1.0.11 → 1.0.12

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

@@ -16,4 +16,10 @@ export interface IJWTStrategy {
      * @returns Результат проверки токена.
      */
     verify(token: string): IVerifyResult;
+    /**
+     * Проверяет действительность refresh токена.
+     * @param token - Refresh токен для проверки.
+     * @returns Результат проверки токена.
+     */
+    verifyRefresh(token: string): IVerifyResult;
 }

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

@@ -6,7 +6,7 @@ export interface IPassportOptions {
     /**
      * Секретный ключ, используемый для подписи JWT токенов.
      */
-    secretKey: string;
+    secretKey?: string;
     /**
      * Публичный ключ, используемый для верификации JWT токенов.
      * Обязателен для асимметричных алгоритмов (например, RS256).

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

@@ -8,9 +8,29 @@ export interface IPayload {
      */
     sub: string | number;
     /**
-     * Имя пользователя .
+     * Роли пользователя в системе.
+     * Определяет уровень доступа и разрешения.
      */
-    name: string;
+    roles: string[];
+    /**
+     * Разрешения пользователя в системе.
+     * Определяют конкретные действия, которые пользователь может выполнять.
+     */
+    permissions: string[];
+    /**
+     * Время выпуска токена (Issued At) в секундах since Unix epoch.
+     */
+    iat: number;
+    /**
+     * Время истечения срока действия токена (Expiration Time) в секундах since Unix epoch.
+     */
+    exp: number;
+}
+export interface IRefreshPayload {
+    /**
+     * Идентификатор (Subject ID) - уникальный идентификатор пользователя.
+     */
+    sub: string | number;
     /**
      * Время выпуска токена (Issued At) в секундах since Unix epoch.
      */
@@ -51,5 +71,5 @@ export interface IVerifyResult {
     /**
      * Полезная нагрузка токена, если он действителен.
      */
-    payload?: IPayload;
+    payload?: IPayload | IRefreshPayload;
 }

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

@@ -20,6 +20,7 @@ export declare class HS256Strategy implements IJWTStrategy {
      * @returns Результат проверки токена.
      */
     verify(token: string): IVerifyResult;
+    verifyRefresh(token: string): IVerifyResult;
     /**
      * Вычисляет HMAC-подпись для переданных данных, используя секретный ключ.
      * Алгоритм шифрования: SHA-256.

package/dist/strategies/hs256.strategy.js

@@ -52,6 +52,27 @@ class HS256Strategy {
             return { valid: false, reason: 'Token is expired' };
         return { valid: true, payload };
     }
+    verifyRefresh(token) {
+        const parts = token.split(HS256Strategy.INTERNAL_SEPARATOR);
+        if (parts.length !== HS256Strategy.PARTS_LENGTH) {
+            return { valid: false, reason: 'Invalid format' };
+        }
+        const [headerB64, payloadB64, mac] = parts;
+        const serialized = (0, utils_1.serialize)([headerB64, payloadB64], HS256Strategy.INTERNAL_SEPARATOR);
+        const expectedMac = this.computeHmac(serialized);
+        if (!(0, utils_1.constantTimeEqual)(expectedMac, mac)) {
+            return { valid: false, reason: 'Invalid signature' };
+        }
+        const parsed = JSON.parse((0, utils_1.base64UrlDecode)(payloadB64));
+        if (!(0, utils_1.isRefreshPayload)(parsed))
+            return { valid: false, reason: 'Invalid payload stucture' };
+        const payload = parsed;
+        if (!Number.isFinite(payload.exp))
+            return { valid: false, reason: 'Expired error format' };
+        if ((0, utils_1.now)() > payload.exp)
+            return { valid: false, reason: 'Token is expired' };
+        return { valid: true, payload };
+    }
     /**
      * Вычисляет HMAC-подпись для переданных данных, используя секретный ключ.
      * Алгоритм шифрования: SHA-256.

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

@@ -27,6 +27,7 @@ export declare class RS256Strategy implements IJWTStrategy {
      * @returns результат проверки токена со статусом и возможной полезной нагрузкой
      */
     verify(token: string): IVerifyResult;
+    verifyRefresh(token: string): IVerifyResult;
     /**
      * Создание подписи для токена
      *

package/dist/strategies/rs256.strategy.js

@@ -59,6 +59,26 @@ class RS256Strategy {
             return { valid: false, reason: 'Token is expired' };
         return { valid: true, payload };
     }
+    verifyRefresh(token) {
+        const parts = token.split(RS256Strategy.INTERNAL_SEPARATOR);
+        if (parts.length !== RS256Strategy.PARTS_LENGTH)
+            return { valid: false, reason: 'Invalid format' };
+        const [header64, payload64, mac] = parts;
+        const serialized = (0, utils_1.serialize)([header64, payload64], RS256Strategy.INTERNAL_SEPARATOR);
+        const signatureBuffer = Buffer.from(mac, 'base64url');
+        const verify = (0, crypto_1.createVerify)(RS256Strategy.JWT_ALG).update(serialized);
+        if (!verify.verify(this.PUBLIC_KEY, signatureBuffer))
+            return { valid: false, reason: 'Invalid signature' };
+        const parsed = JSON.parse((0, utils_1.base64UrlDecode)(payload64));
+        if (!(0, utils_1.isRefreshPayload)(parsed))
+            return { valid: false, reason: 'Invalid payload stucture' };
+        const payload = parsed;
+        if (!Number.isFinite(payload.exp))
+            return { valid: false, reason: 'Expired error format' };
+        if ((0, utils_1.now)() > payload.exp)
+            return { valid: false, reason: 'Token is expired' };
+        return { valid: true, payload };
+    }
     /**
      * Создание подписи для токена
      *

package/dist/utils/checks.d.ts

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

package/dist/utils/checks.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isPayload = isPayload;
+exports.isRefreshPayload = isRefreshPayload;
 exports.isHeader = isHeader;
 /**
  * Проверяет, является ли переданный объект полезной нагрузкой токена.
@@ -15,7 +16,25 @@ exports.isHeader = isHeader;
  */
 function isPayload(data) {
     return ((typeof data.sub === 'string' || typeof data.sub === 'number') &&
-        typeof data.name === 'string' &&
+        Array.isArray(data.roles) &&
+        data.roles.every((role) => typeof role === 'string') &&
+        Array.isArray(data.permissions) &&
+        data.permissions.every((perm) => typeof perm === 'string') &&
+        typeof data.iat === 'number' &&
+        typeof data.exp === 'number');
+}
+/**
+ * Проверяет, является ли переданный объект полезной нагрузкой refresh-токена.
+ * Объект считается полезной нагрузкой refresh-токена, если:
+ * - свойство sub является строкой или числом
+ * - свойство iat является числом
+ * - свойство exp является числом
+ *
+ * @param data - проверяемый объект
+ * @returns true, если объект соответствует интерфейсу IRefreshPayload, иначе false
+ */
+function isRefreshPayload(data) {
+    return ((typeof data.sub === 'string' || typeof data.sub === 'number') &&
         typeof data.iat === 'number' &&
         typeof data.exp === 'number');
 }

package/package.json

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