win-portal-auth-sdk 1.2.1 → 1.3.0

package/dist/utils/token-utils.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Token Utilities
+ *
+ * @description Utilities สำหรับจัดการ JWT tokens
+ * - Decode JWT payload
+ * - ตรวจสอบ token expiration
+ * - คำนวณเวลาที่เหลือก่อนหมดอายุ
+ */
+interface JwtPayload {
+    exp: number;
+    iat?: number;
+    sub?: string;
+    [key: string]: unknown;
+}
+/**
+ * Decode JWT token (base64 decode only, ไม่ verify signature)
+ *
+ * @param token - JWT token string
+ * @returns Decoded payload หรือ null ถ้า decode ไม่ได้
+ */
+export declare function decodeJwt(token: string): JwtPayload | null;
+/**
+ * ตรวจสอบว่า token หมดอายุหรือยัง
+ *
+ * @param token - JWT token string
+ * @returns true ถ้า token หมดอายุแล้ว
+ */
+export declare function isTokenExpired(token: string): boolean;
+/**
+ * คำนวณเวลาที่เหลือก่อน token หมดอายุ (เป็นนาที)
+ *
+ * @param token - JWT token string
+ * @returns จำนวนนาทีที่เหลือ หรือ null ถ้า decode ไม่ได้
+ */
+export declare function getTokenExpirationMinutes(token: string): number | null;
+/**
+ * ตรวจสอบว่า token ใกล้หมดอายุหรือไม่ (ตาม threshold)
+ *
+ * @param token - JWT token string
+ * @param thresholdMinutes - จำนวนนาทีก่อนหมดอายุที่จะถือว่า "ใกล้หมดอายุ" (default: 5)
+ * @returns true ถ้า token ใกล้หมดอายุ
+ */
+export declare function isTokenNearExpiration(token: string, thresholdMinutes?: number): boolean;
+/**
+ * ตรวจสอบว่า token ยังใช้งานได้หรือไม่ (ยังไม่หมดอายุ)
+ *
+ * @param token - JWT token string
+ * @returns true ถ้า token ยังใช้งานได้
+ */
+export declare function isTokenValid(token: string): boolean;
+/**
+ * แปลง duration + unit เป็นนาที
+ *
+ * @param duration - จำนวน duration
+ * @param unit - หน่วยเวลา: 'minutes', 'hours', หรือ 'days'
+ * @returns จำนวนนาที
+ */
+export declare function convertDurationToMinutes(duration: number, unit: 'minutes' | 'hours' | 'days'): number;
+export {};
+//# sourceMappingURL=token-utils.d.ts.map

package/dist/utils/token-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-utils.d.ts","sourceRoot":"","sources":["../../src/utils/token-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAmB1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CASrD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYtE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,GAAE,MAAU,GAAG,OAAO,CAO1F;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAWrG"}

package/dist/utils/token-utils.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * Token Utilities
+ *
+ * @description Utilities สำหรับจัดการ JWT tokens
+ * - Decode JWT payload
+ * - ตรวจสอบ token expiration
+ * - คำนวณเวลาที่เหลือก่อนหมดอายุ
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertDurationToMinutes = exports.isTokenValid = exports.isTokenNearExpiration = exports.getTokenExpirationMinutes = exports.isTokenExpired = exports.decodeJwt = void 0;
+/**
+ * Decode JWT token (base64 decode only, ไม่ verify signature)
+ *
+ * @param token - JWT token string
+ * @returns Decoded payload หรือ null ถ้า decode ไม่ได้
+ */
+function decodeJwt(token) {
+    try {
+        const parts = token.split('.');
+        if (parts.length !== 3) {
+            return null;
+        }
+        // Decode payload (second part)
+        const payload = parts[1];
+        // Support both browser and Node.js environments
+        const decoded = typeof window !== 'undefined'
+            ? atob(payload.replace(/-/g, '+').replace(/_/g, '/'))
+            : Buffer.from(payload.replace(/-/g, '+').replace(/_/g, '/'), 'base64').toString('utf-8');
+        return JSON.parse(decoded);
+    }
+    catch (error) {
+        console.error('[TokenUtils] Failed to decode JWT:', error);
+        return null;
+    }
+}
+exports.decodeJwt = decodeJwt;
+/**
+ * ตรวจสอบว่า token หมดอายุหรือยัง
+ *
+ * @param token - JWT token string
+ * @returns true ถ้า token หมดอายุแล้ว
+ */
+function isTokenExpired(token) {
+    const payload = decodeJwt(token);
+    if (!payload || !payload.exp) {
+        return true; // ถ้า decode ไม่ได้หรือไม่มี exp ถือว่าหมดอายุ
+    }
+    const expirationTime = payload.exp * 1000; // Convert to milliseconds
+    const now = Date.now();
+    return now >= expirationTime;
+}
+exports.isTokenExpired = isTokenExpired;
+/**
+ * คำนวณเวลาที่เหลือก่อน token หมดอายุ (เป็นนาที)
+ *
+ * @param token - JWT token string
+ * @returns จำนวนนาทีที่เหลือ หรือ null ถ้า decode ไม่ได้
+ */
+function getTokenExpirationMinutes(token) {
+    const payload = decodeJwt(token);
+    if (!payload || !payload.exp) {
+        return null;
+    }
+    const expirationTime = payload.exp * 1000; // Convert to milliseconds
+    const now = Date.now();
+    const remainingMs = expirationTime - now;
+    const remainingMinutes = Math.floor(remainingMs / (1000 * 60));
+    return remainingMinutes;
+}
+exports.getTokenExpirationMinutes = getTokenExpirationMinutes;
+/**
+ * ตรวจสอบว่า token ใกล้หมดอายุหรือไม่ (ตาม threshold)
+ *
+ * @param token - JWT token string
+ * @param thresholdMinutes - จำนวนนาทีก่อนหมดอายุที่จะถือว่า "ใกล้หมดอายุ" (default: 5)
+ * @returns true ถ้า token ใกล้หมดอายุ
+ */
+function isTokenNearExpiration(token, thresholdMinutes = 5) {
+    const remainingMinutes = getTokenExpirationMinutes(token);
+    if (remainingMinutes === null) {
+        return true; // ถ้า decode ไม่ได้ ถือว่าใกล้หมดอายุ
+    }
+    return remainingMinutes <= thresholdMinutes;
+}
+exports.isTokenNearExpiration = isTokenNearExpiration;
+/**
+ * ตรวจสอบว่า token ยังใช้งานได้หรือไม่ (ยังไม่หมดอายุ)
+ *
+ * @param token - JWT token string
+ * @returns true ถ้า token ยังใช้งานได้
+ */
+function isTokenValid(token) {
+    return !isTokenExpired(token);
+}
+exports.isTokenValid = isTokenValid;
+/**
+ * แปลง duration + unit เป็นนาที
+ *
+ * @param duration - จำนวน duration
+ * @param unit - หน่วยเวลา: 'minutes', 'hours', หรือ 'days'
+ * @returns จำนวนนาที
+ */
+function convertDurationToMinutes(duration, unit) {
+    switch (unit) {
+        case 'minutes':
+            return duration;
+        case 'hours':
+            return duration * 60;
+        case 'days':
+            return duration * 24 * 60;
+        default:
+            return duration; // fallback
+    }
+}
+exports.convertDurationToMinutes = convertDurationToMinutes;

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "win-portal-auth-sdk",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Shared authentication SDK for Win Portal applications with JWT and OAuth support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
     "dist",
     "README.md",
-    "TYPE_SAFETY.md",
     "LICENSE"
   ],
   "repository": {

package/TYPE_SAFETY.md

@@ -1,97 +0,0 @@
-# Type Safety Guide
-
-## Express Type Augmentation
-
-The SDK automatically extends Express's `Request` interface to include auth properties.
-
-### What's Included
-
-```typescript
-declare global {
-  namespace Express {
-    interface Request {
-      user?: UserProfileResponseDto | null;
-      token?: string | null;
-    }
-  }
-}
-```
-
-### Usage
-
-After installing the SDK, TypeScript will automatically recognize `req.user` and `req.token`:
-
-```typescript
-import express from 'express';
-import { authMiddleware } from 'win-portal-auth-sdk';
-
-const app = express();
-
-app.use(
-  authMiddleware({
-    baseURL: process.env.API_URL,
-    apiKey: process.env.API_KEY,
-  }),
-);
-
-app.get('/profile', (req, res) => {
-  // ✅ TypeScript knows about req.user
-  if (req.user) {
-    // ✅ Full IntelliSense for user properties
-    res.json({
-      email: req.user.email,
-      name: req.user.displayName,
-      permissions: req.user.permissions,
-    });
-  } else {
-    res.status(401).json({ error: 'Not authenticated' });
-  }
-});
-```
-
-### States
-
-- `undefined` - Middleware not applied to this route
-- `null` - Middleware applied but no token provided (when `optional: true`)
-- `UserProfileResponseDto` - Successfully authenticated
-
-### Helper Functions
-
-For guaranteed non-null user:
-
-```typescript
-import { requireAuth } from 'win-portal-auth-sdk';
-
-app.get('/protected', (req, res) => {
-  const { user } = requireAuth(req);
-  // ✅ user is guaranteed to be UserProfileResponseDto (not null)
-  res.json({ email: user.email });
-});
-```
-
-For optional auth:
-
-```typescript
-import { getAuth } from 'win-portal-auth-sdk';
-
-app.get('/optional', (req, res) => {
-  const { user, token } = getAuth(req);
-
-  if (user) {
-    res.json({ authenticated: true, email: user.email });
-  } else {
-    res.json({ authenticated: false });
-  }
-});
-```
-
-## Benefits
-
-1. **IntelliSense** - Full autocomplete for `req.user` properties
-2. **Type Safety** - Compile-time errors for typos
-3. **Better DX** - No need to cast or assert types manually
-4. **Standard Pattern** - Follows Express best practices
-
-## No Express Dependency
-
-The SDK does NOT depend on Express itself - it only augments the types when Express is present in your project. This keeps the SDK lightweight and flexible.