@thinkingcat/auth-utils 2.0.12 → 2.0.14

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from './utils/server';
 export * from './utils/redirect';
 export * from './utils/path';
 export * from './utils/license';
+export * from './utils/device-id';
 export * from './core/jwt';
 export * from './core/cookies';
 export * from './core/auth-response';

package/dist/index.js

@@ -21,6 +21,7 @@ __exportStar(require("./utils/server"), exports);
 __exportStar(require("./utils/redirect"), exports);
 __exportStar(require("./utils/path"), exports);
 __exportStar(require("./utils/license"), exports);
+__exportStar(require("./utils/device-id"), exports);
 __exportStar(require("./core/jwt"), exports);
 __exportStar(require("./core/cookies"), exports);
 __exportStar(require("./core/auth-response"), exports);

package/dist/nextauth/callbacks.d.ts

@@ -14,6 +14,7 @@ export declare function createInitialJWTToken(token: JWT, user: {
     decryptedEmail?: string | null;
     decryptedPhone?: string | null;
     refreshToken?: string | null;
+    deviceId?: string | null;
 }, account?: {
     serviceId?: string;
 } | null): JWT;

package/dist/nextauth/callbacks.js

@@ -55,6 +55,7 @@ function createInitialJWTToken(token, user, account) {
         decryptedEmail: user.decryptedEmail ?? undefined,
         decryptedPhone: user.decryptedPhone ?? undefined,
         refreshToken: user.refreshToken ?? undefined,
+        deviceId: user.deviceId ?? undefined,
         accessTokenExpires: Date.now() + (15 * 60 * 1000),
         serviceId: account?.serviceId ?? undefined,
     };
@@ -132,6 +133,7 @@ async function handleJWTCallback(token, user, account, options) {
                         return {
                             ...newJWT,
                             refreshToken,
+                            deviceId: newJWT.deviceId || token.deviceId, // Preserve deviceId
                             accessTokenExpires: Date.now() + (15 * 60 * 1000),
                         };
                     }

package/dist/nextauth/session.js

@@ -36,5 +36,6 @@ function mapTokenToSession(session, token) {
     user.isPasswordReset = token.isPasswordReset || false;
     user.decryptedEmail = token.decryptedEmail;
     user.decryptedPhone = token.decryptedPhone;
+    user.deviceId = token.deviceId;
     return session;
 }

package/dist/sso/api.d.ts

@@ -21,4 +21,5 @@ export declare function refreshSSOToken(refreshToken: string, options: {
 export declare function getRefreshTokenFromSSO(userId: string, accessToken: string, options: {
     ssoBaseURL: string;
     authServiceKey?: string;
+    serviceId?: string;
 }): Promise<string | null>;

package/dist/sso/api.js

@@ -58,7 +58,7 @@ async function refreshSSOToken(refreshToken, options) {
  * SSO 서버에서 사용자의 refresh token을 가져오는 함수
  */
 async function getRefreshTokenFromSSO(userId, accessToken, options) {
-    const { ssoBaseURL, authServiceKey } = options;
+    const { ssoBaseURL, authServiceKey, serviceId } = options;
     if (!authServiceKey) {
         return null;
     }
@@ -71,7 +71,8 @@ async function getRefreshTokenFromSSO(userId, accessToken, options) {
             },
             body: JSON.stringify({
                 userId,
-                accessToken
+                accessToken,
+                serviceId
             }),
         });
         const refreshResult = await refreshResponse.json();

package/dist/utils/device-id.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Device ID 관리 유틸리티
+ * 브라우저별로 고유한 ID를 생성하고 localStorage에 저장
+ */
+/**
+ * 현재 기기의 고유 ID를 가져옵니다.
+ * localStorage에 저장된 ID가 있으면 반환하고, 없으면 새로 생성합니다.
+ *
+ * @param storageKey - localStorage 키 (기본값: 'device_id')
+ * @returns {string} 기기 고유 ID
+ */
+export declare function getDeviceId(storageKey?: string): string;
+/**
+ * 새로운 기기 ID를 생성합니다.
+ * 형식: {8-char-random} (예: a3f9k2m1)
+ *
+ * @returns {string} 생성된 기기 ID
+ */
+export declare function generateDeviceId(): string;
+/**
+ * 현재 기기 ID를 삭제합니다.
+ * 주로 테스트나 디버깅 용도로 사용
+ *
+ * @param storageKey - localStorage 키 (기본값: 'device_id')
+ */
+export declare function clearDeviceId(storageKey?: string): void;
+/**
+ * 기기 정보를 수집합니다 (선택적)
+ * 더 정교한 fingerprinting이 필요한 경우 사용
+ *
+ * @returns {object} 기기 정보
+ */
+export declare function getDeviceInfo(): {
+    userAgent?: undefined;
+    language?: undefined;
+    platform?: undefined;
+    screenResolution?: undefined;
+    timezone?: undefined;
+} | {
+    userAgent: any;
+    language: any;
+    platform: any;
+    screenResolution: string;
+    timezone: string;
+};

package/dist/utils/device-id.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Device ID 관리 유틸리티
+ * 브라우저별로 고유한 ID를 생성하고 localStorage에 저장
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDeviceId = getDeviceId;
+exports.generateDeviceId = generateDeviceId;
+exports.clearDeviceId = clearDeviceId;
+exports.getDeviceInfo = getDeviceInfo;
+/**
+ * 현재 기기의 고유 ID를 가져옵니다.
+ * localStorage에 저장된 ID가 있으면 반환하고, 없으면 새로 생성합니다.
+ *
+ * @param storageKey - localStorage 키 (기본값: 'device_id')
+ * @returns {string} 기기 고유 ID
+ */
+function getDeviceId(storageKey = 'device_id') {
+    // 서버 사이드에서는 빈 문자열 반환
+    if (typeof globalThis.window === 'undefined') {
+        return '';
+    }
+    try {
+        // localStorage에서 기존 ID 확인
+        const storage = globalThis.localStorage;
+        let deviceId = storage?.getItem(storageKey);
+        if (!deviceId) {
+            // 없으면 새로 생성
+            deviceId = generateDeviceId();
+            storage?.setItem(storageKey, deviceId);
+            console.log(`[DeviceID] New device ID generated: ${deviceId}`);
+        }
+        return deviceId;
+    }
+    catch (error) {
+        // localStorage 접근 실패 시 (프라이빗 모드 등)
+        console.warn('[DeviceID] Failed to access localStorage:', error);
+        return generateDeviceId();
+    }
+}
+/**
+ * 새로운 기기 ID를 생성합니다.
+ * 형식: {8-char-random} (예: a3f9k2m1)
+ *
+ * @returns {string} 생성된 기기 ID
+ */
+function generateDeviceId() {
+    // 8자리 랜덤 문자열 생성
+    return Math.random().toString(36).substring(2, 10);
+}
+/**
+ * 현재 기기 ID를 삭제합니다.
+ * 주로 테스트나 디버깅 용도로 사용
+ *
+ * @param storageKey - localStorage 키 (기본값: 'device_id')
+ */
+function clearDeviceId(storageKey = 'device_id') {
+    if (typeof globalThis.window === 'undefined') {
+        return;
+    }
+    try {
+        const storage = globalThis.localStorage;
+        storage?.removeItem(storageKey);
+        console.log('[DeviceID] Device ID cleared');
+    }
+    catch (error) {
+        console.warn('[DeviceID] Failed to clear device ID:', error);
+    }
+}
+/**
+ * 기기 정보를 수집합니다 (선택적)
+ * 더 정교한 fingerprinting이 필요한 경우 사용
+ *
+ * @returns {object} 기기 정보
+ */
+function getDeviceInfo() {
+    if (typeof globalThis.window === 'undefined') {
+        return {};
+    }
+    const nav = globalThis.navigator;
+    const scr = globalThis.screen;
+    return {
+        userAgent: nav?.userAgent || '',
+        language: nav?.language || '',
+        platform: nav?.platform || '',
+        screenResolution: scr ? `${scr.width}x${scr.height}` : '',
+        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkingcat/auth-utils",
-  "version": "2.0.12",
+  "version": "2.0.14",
   "description": "Authentication utilities for ThinkingCat SSO services with conditional logging",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",