win-portal-auth-sdk 1.1.2 → 1.3.0

package/dist/client/auth-client.d.ts

@@ -7,18 +7,90 @@
  */
 import { AxiosInstance, AxiosRequestConfig, AxiosResponse } from 'axios';
 import { AuthSdkConfig } from '../types';
-import { AuthAPI, HealthAPI, SystemConfigAPI, FilesAPI, EventLogApi, OAuthAPI, OAuthConfig, LineAPI } from './api';
+import { AuthAPI, HealthAPI, SystemConfigAPI, FilesAPI, EventLogApi, LicenseAPI, OAuthAPI, OAuthConfig, LineAPI } from './api';
+export interface RefreshTokenCallbacks {
+    /**
+     * Get refresh token from storage
+     */
+    getRefreshToken: () => string | null | Promise<string | null>;
+    /**
+     * Save refresh token to storage
+     */
+    setRefreshToken: (token: string) => void | Promise<void>;
+    /**
+     * Clear refresh token from storage
+     */
+    clearRefreshToken?: () => void | Promise<void>;
+    /**
+     * Optional: Callback when refresh fails (for logout handling)
+     */
+    onRefreshFailure?: () => void | Promise<void>;
+}
+export interface SessionExpirationCallbacks {
+    /**
+     * Callback เมื่อ session ใกล้หมดอายุ (ตาม warning_minutes จาก config)
+     * @param remainingMinutes - จำนวนนาทีที่เหลือก่อน session หมดอายุ
+     * @param expirationType - ประเภทการหมดอายุ: 'inactivity' หรือ 'lifetime'
+     */
+    onSessionExpiring?: (remainingMinutes: number, expirationType: 'inactivity' | 'lifetime') => void | Promise<void>;
+    /**
+     * Callback เมื่อ session หมดอายุแล้ว
+     */
+    onSessionExpired?: () => void | Promise<void>;
+}
+export interface SessionExpirationOptions {
+    /**
+     * Callbacks สำหรับ session expiration events
+     */
+    callbacks: SessionExpirationCallbacks;
+    /**
+     * Optional: ตรวจสอบ session expiration อัตโนมัติทุก N วินาที (default: 30)
+     */
+    checkIntervalSeconds?: number;
+}
+export interface AutomaticRefreshOptions {
+    /**
+     * Storage key for refresh token (SDK will manage localStorage automatically)
+     * If provided, SDK will handle localStorage operations automatically
+     */
+    refreshTokenKey?: string;
+    /**
+     * Custom callbacks (use if you need custom storage or want to override default behavior)
+     * If refreshTokenKey is provided, these will be ignored
+     */
+    callbacks?: RefreshTokenCallbacks;
+    /**
+     * Optional: Callback when refresh fails (for logout handling)
+     * This will be called even if refreshTokenKey is provided
+     */
+    onRefreshFailure?: () => void | Promise<void>;
+}
 export declare class AuthClient {
     private client;
     private apiKey;
     private apiKeyHeader;
     private token;
     private authType;
+    private refreshTokenCallbacks;
+    private jwtConfigPromise;
+    private refreshThresholdMinutes;
+    private automaticRefreshEnabled;
+    private lastRefreshAttempt;
+    private refreshPromise;
+    private readonly REFRESH_COOLDOWN_MS;
+    private sessionExpirationCallbacks;
+    private sessionManagementConfig;
+    private sessionManagementConfigPromise;
+    private sessionExpirationCheckInterval;
+    private sessionExpirationCheckIntervalSeconds;
+    private lastWarningTime;
+    private readonly WARNING_COOLDOWN_MS;
     readonly auth: AuthAPI;
     readonly health: HealthAPI;
     readonly systemConfig: SystemConfigAPI;
     readonly files: FilesAPI;
     readonly eventLog: EventLogApi;
+    readonly license: LicenseAPI;
     readonly line: LineAPI;
     oauth?: OAuthAPI;
     constructor(config: AuthSdkConfig);
@@ -104,5 +176,115 @@ export declare class AuthClient {
      * Get axios instance for advanced usage
      */
     getAxiosInstance(): AxiosInstance;
+    /**
+     * Enable automatic token refresh
+     * Call this after user is authenticated to enable automatic refresh
+     *
+     * @param options - Options for automatic refresh
+     *
+     * @example
+     * ```typescript
+     * // Simple: SDK manages localStorage automatically
+     * await authClient.enableAutomaticRefresh({
+     *   refreshTokenKey: 'refresh_token',
+     *   onRefreshFailure: () => window.location.href = '/login'
+     * });
+     *
+     * // Advanced: Custom callbacks
+     * await authClient.enableAutomaticRefresh({
+     *   callbacks: {
+     *     getRefreshToken: () => customStorage.get('refresh_token'),
+     *     setRefreshToken: (token) => customStorage.set('refresh_token', token),
+     *     clearRefreshToken: () => customStorage.remove('refresh_token'),
+     *     onRefreshFailure: () => window.location.href = '/login'
+     *   }
+     * });
+     * ```
+     */
+    enableAutomaticRefresh(options: AutomaticRefreshOptions): Promise<void>;
+    /**
+     * Disable automatic token refresh
+     */
+    disableAutomaticRefresh(): void;
+    /**
+     * Load JWT config from API
+     */
+    private loadJwtConfig;
+    /**
+     * Perform JWT config load
+     */
+    private performJwtConfigLoad;
+    /**
+     * Perform token refresh
+     */
+    private performRefresh;
+    /**
+     * Execute refresh token request
+     */
+    private doRefresh;
+    /**
+     * Reload JWT config (for when config changes)
+     */
+    reloadJwtConfig(): Promise<void>;
+    /**
+     * Enable session expiration monitoring
+     * จะตรวจสอบ session expiration ตาม config จาก settings/sessions และเรียก callback เมื่อใกล้หมดอายุ
+     *
+     * @param options - Options for session expiration monitoring
+     *
+     * @example
+     * ```typescript
+     * await authClient.enableSessionExpirationMonitoring({
+     *   callbacks: {
+     *     onSessionExpiring: (remainingMinutes, expirationType) => {
+     *       console.log(`Session will expire in ${remainingMinutes} minutes (${expirationType})`);
+     *       // แสดง notification หรือ dialog
+     *     },
+     *     onSessionExpired: () => {
+     *       console.log('Session expired');
+     *       // Redirect to login
+     *     }
+     *   },
+     *   checkIntervalSeconds: 30 // ตรวจสอบทุก 30 วินาที
+     * });
+     * ```
+     */
+    enableSessionExpirationMonitoring(options: SessionExpirationOptions): Promise<void>;
+    /**
+     * Disable session expiration monitoring
+     */
+    disableSessionExpirationMonitoring(): void;
+    /**
+     * Load session management config from API
+     */
+    private loadSessionManagementConfig;
+    /**
+     * Perform session management config load
+     */
+    private performSessionManagementConfigLoad;
+    /**
+     * Start session expiration monitoring interval
+     */
+    private startSessionExpirationMonitoring;
+    /**
+     * Stop session expiration monitoring interval
+     */
+    private stopSessionExpirationMonitoring;
+    /**
+     * Check session expiration and trigger callbacks if needed
+     *
+     * Note: ใช้ token expiration time เป็นตัวประมาณ session expiration
+     * เพราะเราไม่มี session creation time หรือ last activity time ใน SDK
+     * Token expiration จะถูก refresh อัตโนมัติเมื่อมีการใช้งาน (extend_on_activity)
+     */
+    private checkSessionExpiration;
+    /**
+     * Trigger expiring warning callback with cooldown
+     */
+    private triggerExpiringWarning;
+    /**
+     * Reload session management config (for when config changes)
+     */
+    reloadSessionManagementConfig(): Promise<void>;
 }
 //# sourceMappingURL=auth-client.d.ts.map

package/dist/client/auth-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-client.d.ts","sourceRoot":"","sources":["../../src/client/auth-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEnH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,QAAQ,CAAwC;IAGxD,SAAgB,IAAI,EAAE,OAAO,CAAC;IAC9B,SAAgB,MAAM,EAAE,SAAS,CAAC;IAClC,SAAgB,YAAY,EAAE,eAAe,CAAC;IAC9C,SAAgB,KAAK,EAAE,QAAQ,CAAC;IAChC,SAAgB,QAAQ,EAAE,WAAW,CAAC;IACtC,SAAgB,IAAI,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,QAAQ,CAAC;gBAEZ,MAAM,EAAE,aAAa;IA4DjC;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAW1C;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAIvF;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAIpG;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAInG;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAIrG;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAI1F;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,eAAe,IAAI,MAAM;IAMzB;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,KAAK,GAAG,OAAO,GAAG,QAAgB,GAAG,IAAI;IAMvE;;OAEG;IACH,WAAW,IAAI,KAAK,GAAG,OAAO,GAAG,QAAQ;IAIzC;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI;IAKnD;;OAEG;IACH,cAAc,IAAI,MAAM;IAOxB;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,gBAAgB,IAAI,aAAa;CAGlC"}
+{"version":3,"file":"auth-client.d.ts","sourceRoot":"","sources":["../../src/client/auth-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAA8B,MAAM,OAAO,CAAC;AAC5G,OAAO,EAAE,aAAa,EAA8C,MAAM,UAAU,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAS/H,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,eAAe,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9D;;OAEG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,YAAY,GAAG,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClH;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,SAAS,EAAE,0BAA0B,CAAC;IACtC;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,QAAQ,CAAwC;IAGxD,OAAO,CAAC,qBAAqB,CAAsC;IACnE,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,uBAAuB,CAAuB;IACtD,OAAO,CAAC,uBAAuB,CAAwB;IACvD,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAa;IAGjD,OAAO,CAAC,0BAA0B,CAA2C;IAC7E,OAAO,CAAC,uBAAuB,CAAwC;IACvE,OAAO,CAAC,8BAA8B,CAA8B;IACpE,OAAO,CAAC,8BAA8B,CAA+B;IACrE,OAAO,CAAC,qCAAqC,CAAc;IAC3D,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAa;IAGjD,SAAgB,IAAI,EAAE,OAAO,CAAC;IAC9B,SAAgB,MAAM,EAAE,SAAS,CAAC;IAClC,SAAgB,YAAY,EAAE,eAAe,CAAC;IAC9C,SAAgB,KAAK,EAAE,QAAQ,CAAC;IAChC,SAAgB,QAAQ,EAAE,WAAW,CAAC;IACtC,SAAgB,OAAO,EAAE,UAAU,CAAC;IACpC,SAAgB,IAAI,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,QAAQ,CAAC;gBAEZ,MAAM,EAAE,aAAa;IAuJjC;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAW1C;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAIvF;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAIpG;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAInG;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAIrG;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAI1F;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,eAAe,IAAI,MAAM;IAMzB;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,KAAK,GAAG,OAAO,GAAG,QAAgB,GAAG,IAAI;IAcvE;;OAEG;IACH,WAAW,IAAI,KAAK,GAAG,OAAO,GAAG,QAAQ;IAIzC;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI;IAKnD;;OAEG;IACH,cAAc,IAAI,MAAM;IAOxB;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACH,gBAAgB,IAAI,aAAa;IAIjC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC7E;;OAEG;IACH,uBAAuB,IAAI,IAAI;IAO/B;;OAEG;YACW,aAAa;IAS3B;;OAEG;YACW,oBAAoB;IAgBlC;;OAEG;YACW,cAAc;IAmB5B;;OAEG;YACW,SAAS;IAiDvB;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,iCAAiC,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzF;;OAEG;IACH,kCAAkC,IAAI,IAAI;IAO1C;;OAEG;YACW,2BAA2B;IASzC;;OAEG;YACW,kCAAkC;IAmBhD;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAaxC;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAOvC;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAwE9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;OAEG;IACG,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC;CAKrD"}