@ph-cms/client-sdk 0.1.24 → 0.1.26

package/README.md

@@ -1302,6 +1302,18 @@ client.content        // ContentModule
 client.channel        // ChannelModule
 client.terms          // TermsModule
 client.media          // MediaModule
+
+await client.getToken() // 현재 유효한 PH-CMS access token 반환 (만료 시 자동 갱신, 없으면 null)
+```
+
+`getToken()`은 PH-CMS SDK가 아닌 외부 서비스(예: 알림 서비스)를 클라이언트에서 직접 호출할 때 Authorization 헤더에 넣을 토큰을 가져오는 데 사용합니다.
+
+```ts
+const token = await client.getToken();
+
+const res = await fetch(`${NOTIFICATION_SERVICE_URL}/notifications`, {
+  headers: { Authorization: `Bearer ${token}` },
+});
 ```
 
 `apiPrefix`는 생성 시 각 모듈에 직접 주입됩니다. 예를 들어 `apiPrefix: '/v2/api'`로 설정하면 모든 모듈의 요청 URL이 `/v2/api/contents/...`, `/v2/api/auth/...` 형태로 전송됩니다.

package/dist/auth/firebase-provider.d.ts

@@ -30,15 +30,13 @@ export declare class FirebaseAuthProvider extends BaseAuthProvider {
         expiryBufferMs?: number;
     });
     /**
-     * Returns a valid access token for PH-CMS API calls.
+     * Returns the current valid PH-CMS access token.
      *
      * 1. If a PH-CMS access token exists and is still valid, return it.
      * 2. If the PH-CMS access token is expired (or will expire within
      *    `expiryBufferMs`), attempt an automatic refresh using the stored
      *    refresh token.
-     * 3. If no PH-CMS token exists at all (or refresh failed), fall back to
-     *    the Firebase ID token (useful for the initial exchange call or if the
-     *    server supports Firebase tokens directly).
+     * 3. If no PH-CMS token exists or refresh fails, return `null`.
      */
     getToken(): Promise<string | null>;
     /**

package/dist/auth/firebase-provider.js

@@ -28,32 +28,22 @@ class FirebaseAuthProvider extends base_provider_1.BaseAuthProvider {
         this.type = 'FIREBASE';
     }
     /**
-     * Returns a valid access token for PH-CMS API calls.
+     * Returns the current valid PH-CMS access token.
      *
      * 1. If a PH-CMS access token exists and is still valid, return it.
      * 2. If the PH-CMS access token is expired (or will expire within
      *    `expiryBufferMs`), attempt an automatic refresh using the stored
      *    refresh token.
-     * 3. If no PH-CMS token exists at all (or refresh failed), fall back to
-     *    the Firebase ID token (useful for the initial exchange call or if the
-     *    server supports Firebase tokens directly).
+     * 3. If no PH-CMS token exists or refresh fails, return `null`.
      */
     async getToken() {
-        if (this.accessToken) {
-            const expired = this.isCurrentTokenExpired();
-            if (expired === true) {
-                const refreshed = await this.tryRefresh();
-                if (refreshed)
-                    return refreshed;
-                // Refresh failed — fall through to Firebase ID token fallback.
-            }
-            else {
-                // Token is valid (or unparseable — let server decide).
-                return this.accessToken;
-            }
+        if (!this.accessToken)
+            return null;
+        const expired = this.isCurrentTokenExpired();
+        if (expired === true) {
+            return this.tryRefresh();
         }
-        // Fallback to Firebase ID token if no valid PH-CMS token is available.
-        return this.getIdToken();
+        return this.accessToken;
     }
     /**
      * Clears PH-CMS tokens **and** signs the user out of Firebase.

package/dist/client.d.ts

@@ -35,6 +35,15 @@ export declare class PHCMSClient {
     private refreshQueue;
     /** Exposes the auth provider so UI layers can check token state synchronously. */
     get authProvider(): AuthProvider | undefined;
+    /**
+     * Returns the current valid PH-CMS access token.
+     *
+     * Delegates to the configured {@link AuthProvider.getToken}, which handles
+     * expiry checks and automatic refresh internally.
+     *
+     * Returns `null` when no provider is configured or no valid token exists.
+     */
+    getToken(): Promise<string | null>;
     private readonly normalizedApiPrefix;
     constructor(config: PHCMSClientConfig);
     /**

package/dist/client.js

@@ -17,6 +17,17 @@ class PHCMSClient {
     get authProvider() {
         return this.config.auth;
     }
+    /**
+     * Returns the current valid PH-CMS access token.
+     *
+     * Delegates to the configured {@link AuthProvider.getToken}, which handles
+     * expiry checks and automatic refresh internally.
+     *
+     * Returns `null` when no provider is configured or no valid token exists.
+     */
+    async getToken() {
+        return this.config.auth?.getToken() ?? null;
+    }
     constructor(config) {
         this.config = config;
         /**

package/dist/context.d.ts

@@ -22,6 +22,8 @@ export interface PHCMSContextType {
     hasToken: boolean;
     /** Manually trigger a refetch of the current user profile. */
     refreshUser: () => Promise<void>;
+    /** Returns the current valid PH-CMS access token (만료 시 자동 갱신, 없으면 null). */
+    getToken: () => Promise<string | null>;
 }
 export interface PHCMSProviderProps {
     client: PHCMSClient;

package/dist/context.js

@@ -98,6 +98,7 @@ const PHCMSInternalProvider = ({ client, channelUid, children }) => {
             hasToken,
             channelUid,
             refreshUser,
+            getToken: () => client.getToken(),
         };
     }, [client, user, isError, isLoading, hasToken, channelUid, refreshUser]);
     return react_1.default.createElement(PHCMSContext.Provider, { value: value }, children);

package/dist/hooks/useAuth.d.ts

@@ -240,6 +240,7 @@ export declare const useAuth: () => {
         username?: string;
     }, unknown>;
     logout: import("@tanstack/react-query").UseMutateAsyncFunction<void, Error, void, unknown>;
+    getToken: () => Promise<string | null>;
     loginStatus: import("@tanstack/react-query").UseMutationResult<{
         refreshToken: string;
         user: {

package/dist/hooks/useAuth.js

@@ -9,7 +9,7 @@ const AUTH_ME_QUERY_KEY = ['auth', 'me'];
  * Returns both the current auth status and the actions.
  */
 const useAuth = () => {
-    const { user, isAuthenticated, isLoading, refreshUser, channelUid } = (0, context_1.usePHCMSContext)();
+    const { user, isAuthenticated, isLoading, refreshUser, channelUid, getToken } = (0, context_1.usePHCMSContext)();
     const client = (0, context_1.usePHCMS)();
     const queryClient = (0, react_query_1.useQueryClient)();
     const loginMutation = (0, react_query_1.useMutation)({
@@ -78,6 +78,7 @@ const useAuth = () => {
         loginAnonymous: loginAnonymousMutation.mutateAsync,
         upgradeAnonymous: upgradeAnonymousMutation.mutateAsync,
         logout: logoutMutation.mutateAsync,
+        getToken,
         // Access to mutation objects for loading/error states if needed
         loginStatus: loginMutation,
         loginWithFirebaseStatus: loginWithFirebaseMutation,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ph-cms/client-sdk",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "Unified PH-CMS Client SDK (React + Core)",
   "keywords": [],
   "license": "MIT",