@gz-fronted/gz-pc 0.1.1-beta.1 → 0.1.1-beta.3

package/README.md

@@ -185,6 +185,7 @@ const result = await gzFetch<SaveResult, SaveParams>({
 | `showErrorMessage` | `boolean`                                                   | `true`            | 实例级错误提示开关         |
 | `auth.headerName`  | `string`                                                    | `Authorization`   | Token 请求头名称           |
 | `auth.formatToken` | `(token: string) => string`                                 | `Bearer ${token}` | Token 格式化函数           |
+| `unauthorized`     | `GzFetchUnauthorizedOptions`                                | 未开启            | 可选的 HTTP 401 统一处理   |
 | `middlewares`      | `readonly GzFetchMiddleware[]`                              | `[]`              | 请求、响应和错误中间件     |
 
 需要覆盖默认成功状态时，只在应用初始化层配置：
@@ -284,6 +285,76 @@ controller.abort();
 await promise;
 ```
 
+## HTTP 401 统一处理
+
+401 统一处理默认关闭，未显式开启时继续执行原有 HTTP 错误提示和抛错逻辑，不弹窗、
+不跳转。需要启用时，在应用初始化配置中传入 `unauthorized.enabled: true`：
+
+```ts
+configureGzFetch({
+  baseURL: '/api',
+  getToken: () => runtimeToken,
+  unauthorized: {
+    enabled: true,
+    loginUrl: '/login',
+    modalTitle: '登录失效',
+    modalMessage: '当前登录状态已失效，请重新登录。',
+  },
+});
+```
+
+配置默认值如下：
+
+| 字段             | 类型         | 默认值                                  |
+| ---------------- | ------------ | --------------------------------------- |
+| `enabled`        | `boolean`    | `false`                                 |
+| `loginUrl`       | `string`     | `/login`                                |
+| `modalTitle`     | `string`     | `登录失效`                              |
+| `modalMessage`   | `string`     | `当前登录状态已失效，请重新登录。`      |
+| `onUnauthorized` | `() => void` | 无；确认后使用 `window.location.assign` |
+
+为了让普通错误消息和 401 弹窗都继承宿主项目当前的 gg-ui 主题，需要在应用根部的
+`ConfigProvider` 内挂载一次 `GzFetchFeedbackProvider`：
+
+```tsx
+import { GzFetchFeedbackProvider } from '@gz-fronted/gz-pc/fetch';
+import { ConfigProvider } from '@chenhui996/gg-ui';
+
+<ConfigProvider themeMode={themeMode}>
+  <GzFetchFeedbackProvider>
+    <App />
+  </GzFetchFeedbackProvider>
+</ConfigProvider>;
+```
+
+该 Provider 使用 `message.useMessage()` 和受控 gg-ui `Modal`，不会在已接入的项目中
+调用脱离 React 上下文的静态反馈 API。因此主题切换时，普通错误消息和 401 弹窗都会
+继续读取宿主 `ConfigProvider` 的主题 Token，无需复制亮色或暗色样式。业务页面不需要
+维护反馈状态。未挂载该 Provider 的已有项目仍会回退到原来的静态 `message.error`，
+不会产生 breaking change。`GzFetchUnauthorizedModal` 继续保留为兼容 API，但新项目
+优先使用统一 Provider。
+
+所有由同一份 gz-pc 包创建的默认客户端和独立客户端共享一个 401 管理器。首个 401
+打开弹窗，后续并发 401 不会创建新弹窗；取消或弹窗关闭动画结束后会释放状态，后续
+独立发生的 401 可以再次打开。确认操作也有同一状态锁，不会重复执行登录跳转。
+
+业务项目需要自定义 SSO、登出或状态清理时传入 `onUnauthorized`。用户确认后优先执行
+该回调；只有未提供回调时才通过 `window.location.assign(loginUrl)` 跳转：
+
+```ts
+configureGzFetch({
+  unauthorized: {
+    enabled: true,
+    onUnauthorized: () => {
+      authService.logout();
+    },
+  },
+});
+```
+
+开启该能力后，401 仍会作为 `GzFetchError` 抛给调用方，但请求核心不会再为同一个
+401 额外调用普通 `message.error`。其他 HTTP 错误、网络错误、超时和取消请求行为不变。
+
 ## 中间件
 
 中间件的 `onRequest`、`onResponse` 和 `onError` 都按注册顺序执行，不采用洋葱

package/dist/fetch/index.cjs

@@ -1,7 +1,9 @@
 'use strict';
 
-var ggUi = require('@chenhui996/gg-ui');
 var axios = require('axios');
+var ggUi = require('@chenhui996/gg-ui');
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
@@ -9,8 +11,8 @@ var axios__default = /*#__PURE__*/_interopDefault(axios);
 
 // src/fetch/client.ts
 var GzFetchError = class extends Error {
-  constructor(message2, options) {
-    super(message2);
+  constructor(message3, options) {
+    super(message3);
     this.name = "GzFetchError";
     this.type = options.type;
     this.status = options.status;
@@ -69,6 +71,28 @@ function toGzFetchError(error) {
     originalError: error
   });
 }
+var feedbackHosts = /* @__PURE__ */ new Map();
+var activeHostId;
+var registerFeedbackHost = (hostId, host) => {
+  feedbackHosts.set(hostId, host);
+  activeHostId != null ? activeHostId : activeHostId = hostId;
+  return () => {
+    feedbackHosts.delete(hostId);
+    if (activeHostId !== hostId) {
+      return;
+    }
+    const nextHost = feedbackHosts.keys().next();
+    activeHostId = nextHost.done ? void 0 : nextHost.value;
+  };
+};
+var showFetchErrorMessage = (content) => {
+  const activeHost = activeHostId === void 0 ? void 0 : feedbackHosts.get(activeHostId);
+  if (activeHost) {
+    activeHost.showErrorMessage(content);
+    return;
+  }
+  ggUi.message.error(content);
+};
 
 // src/fetch/middleware.ts
 async function runRequestMiddlewares(initialConfig, middlewares) {
@@ -96,6 +120,103 @@ async function runErrorMiddlewares(error, context, middlewares) {
   }
 }
 
+// src/fetch/unauthorized.ts
+var DEFAULT_UNAUTHORIZED_LOGIN_URL = "/login";
+var DEFAULT_UNAUTHORIZED_MODAL_TITLE = "登录失效";
+var DEFAULT_UNAUTHORIZED_MODAL_MESSAGE = "当前登录状态已失效，请重新登录。";
+var IDLE_SNAPSHOT = { phase: "idle" };
+var snapshot = IDLE_SNAPSHOT;
+var listeners = /* @__PURE__ */ new Set();
+var modalHosts = /* @__PURE__ */ new Set();
+var emitChange = () => {
+  for (const listener of listeners) {
+    listener();
+  }
+};
+var setSnapshot = (nextSnapshot) => {
+  snapshot = nextSnapshot;
+  emitChange();
+};
+var resolveUnauthorizedOptions = (options) => {
+  var _a, _b, _c, _d;
+  return {
+    enabled: (_a = options == null ? void 0 : options.enabled) != null ? _a : false,
+    loginUrl: (_b = options == null ? void 0 : options.loginUrl) != null ? _b : DEFAULT_UNAUTHORIZED_LOGIN_URL,
+    modalTitle: (_c = options == null ? void 0 : options.modalTitle) != null ? _c : DEFAULT_UNAUTHORIZED_MODAL_TITLE,
+    modalMessage: (_d = options == null ? void 0 : options.modalMessage) != null ? _d : DEFAULT_UNAUTHORIZED_MODAL_MESSAGE,
+    ...(options == null ? void 0 : options.onUnauthorized) === void 0 ? {} : { onUnauthorized: options.onUnauthorized }
+  };
+};
+var getUnauthorizedSnapshot = () => snapshot;
+var getUnauthorizedServerSnapshot = () => IDLE_SNAPSHOT;
+var subscribeUnauthorized = (listener) => {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+};
+var registerUnauthorizedModalHost = (hostId) => {
+  modalHosts.add(hostId);
+  if (snapshot.activeHostId === void 0) {
+    setSnapshot({ ...snapshot, activeHostId: hostId });
+  }
+  return () => {
+    modalHosts.delete(hostId);
+    if (snapshot.activeHostId !== hostId) {
+      return;
+    }
+    const nextHost = modalHosts.values().next();
+    const nextHostId = nextHost.done ? void 0 : nextHost.value;
+    if (snapshot.phase === "closing") {
+      setSnapshot(
+        nextHostId === void 0 ? IDLE_SNAPSHOT : { activeHostId: nextHostId, phase: "idle" }
+      );
+      return;
+    }
+    if (nextHostId === void 0) {
+      setSnapshot(
+        snapshot.options === void 0 ? { phase: snapshot.phase } : { options: snapshot.options, phase: snapshot.phase }
+      );
+      return;
+    }
+    setSnapshot({ ...snapshot, activeHostId: nextHostId });
+  };
+};
+var openUnauthorizedModal = (options) => {
+  if (!options.enabled || snapshot.phase !== "idle") {
+    return false;
+  }
+  setSnapshot({
+    ...snapshot.activeHostId === void 0 ? {} : { activeHostId: snapshot.activeHostId },
+    options,
+    phase: "open"
+  });
+  return true;
+};
+var beginCloseUnauthorizedModal = () => {
+  if (snapshot.phase !== "open" || snapshot.options === void 0) {
+    return void 0;
+  }
+  const { options } = snapshot;
+  setSnapshot({ ...snapshot, phase: "closing" });
+  return options;
+};
+var cancelUnauthorizedModal = () => beginCloseUnauthorizedModal() !== void 0;
+var confirmUnauthorizedModal = () => beginCloseUnauthorizedModal();
+var completeUnauthorizedModal = () => {
+  if (snapshot.phase !== "closing") {
+    return;
+  }
+  setSnapshot(
+    snapshot.activeHostId === void 0 ? IDLE_SNAPSHOT : { activeHostId: snapshot.activeHostId, phase: "idle" }
+  );
+};
+var executeUnauthorizedAction = (options, navigate = (loginUrl) => window.location.assign(loginUrl)) => {
+  if (options.onUnauthorized) {
+    options.onUnauthorized();
+    return;
+  }
+  navigate(options.loginUrl);
+};
+
 // src/fetch/client.ts
 var DEFAULT_TIMEOUT = 15e3;
 var DEFAULT_AUTH_HEADER = "Authorization";
@@ -115,6 +236,7 @@ function createGzFetch(options = {}) {
   const showInstanceErrorMessage = (_b = options.showErrorMessage) != null ? _b : true;
   const headerName = (_d = (_c = options.auth) == null ? void 0 : _c.headerName) != null ? _d : DEFAULT_AUTH_HEADER;
   const formatToken = (_f = (_e = options.auth) == null ? void 0 : _e.formatToken) != null ? _f : ((token) => `Bearer ${token}`);
+  const unauthorizedOptions = resolveUnauthorizedOptions(options.unauthorized);
   const instance = axios__default.default.create({
     ...options.baseURL === void 0 ? {} : { baseURL: options.baseURL },
     timeout: (_g = options.timeout) != null ? _g : DEFAULT_TIMEOUT,
@@ -156,10 +278,14 @@ function createGzFetch(options = {}) {
       return await runResponseMiddlewares(response.data, context, middlewares);
     } catch (originalError) {
       const error = toGzFetchError(originalError);
+      const shouldHandleUnauthorized = unauthorizedOptions.enabled && error.type === "HTTP_ERROR" && error.status === 401;
+      if (shouldHandleUnauthorized) {
+        openUnauthorizedModal(unauthorizedOptions);
+      }
       await runErrorMiddlewares(error, { config: currentConfig }, middlewares);
       const shouldShowError = (_a2 = currentConfig.showErrorMessage) != null ? _a2 : showInstanceErrorMessage;
-      if (shouldShowError && error.type !== "CANCELED_ERROR") {
-        ggUi.message.error(error.message);
+      if (shouldShowError && error.type !== "CANCELED_ERROR" && !shouldHandleUnauthorized) {
+        showFetchErrorMessage(error.message);
       }
       throw error;
     }
@@ -194,8 +320,66 @@ async function gzFetch(config) {
   }
   return defaultClient(config);
 }
+var GzFetchUnauthorizedModal = () => {
+  var _a, _b, _c;
+  const hostIdRef = react.useRef(void 0);
+  (_a = hostIdRef.current) != null ? _a : hostIdRef.current = /* @__PURE__ */ Symbol("gz-fetch-unauthorized-modal-host");
+  const hostId = hostIdRef.current;
+  const [messageApi, messageContextHolder] = ggUi.message.useMessage();
+  const showErrorMessage = react.useCallback(
+    (content) => {
+      void messageApi.error(content);
+    },
+    [messageApi]
+  );
+  const snapshot2 = react.useSyncExternalStore(
+    subscribeUnauthorized,
+    getUnauthorizedSnapshot,
+    getUnauthorizedServerSnapshot
+  );
+  react.useEffect(() => registerUnauthorizedModalHost(hostId), [hostId]);
+  react.useEffect(
+    () => registerFeedbackHost(hostId, { showErrorMessage }),
+    [hostId, showErrorMessage]
+  );
+  const handleConfirm = () => {
+    const options = confirmUnauthorizedModal();
+    if (options) {
+      executeUnauthorizedAction(options);
+    }
+  };
+  return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+    messageContextHolder,
+    snapshot2.activeHostId === hostId && /* @__PURE__ */ jsxRuntime.jsx(
+      ggUi.Modal,
+      {
+        afterClose: completeUnauthorizedModal,
+        cancelText: "取消",
+        closable: true,
+        okText: "重新登录",
+        open: snapshot2.phase === "open",
+        title: (_b = snapshot2.options) == null ? void 0 : _b.modalTitle,
+        onCancel: cancelUnauthorizedModal,
+        onOk: handleConfirm,
+        children: (_c = snapshot2.options) == null ? void 0 : _c.modalMessage
+      }
+    )
+  ] });
+};
+GzFetchUnauthorizedModal.displayName = "GzFetchUnauthorizedModal";
+var GzFetchUnauthorizedModal_default = GzFetchUnauthorizedModal;
+var GzFetchFeedbackProvider = ({ children }) => {
+  return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+    /* @__PURE__ */ jsxRuntime.jsx(GzFetchUnauthorizedModal_default, {}),
+    children
+  ] });
+};
+GzFetchFeedbackProvider.displayName = "GzFetchFeedbackProvider";
+var GzFetchFeedbackProvider_default = GzFetchFeedbackProvider;
 
 exports.GzFetchError = GzFetchError;
+exports.GzFetchFeedbackProvider = GzFetchFeedbackProvider_default;
+exports.GzFetchUnauthorizedModal = GzFetchUnauthorizedModal_default;
 exports.configureGzFetch = configureGzFetch;
 exports.createGzFetch = createGzFetch;
 exports.getResponseMessage = getResponseMessage;

package/dist/fetch/index.d.cts

@@ -1,4 +1,5 @@
 import { AxiosHeaders } from 'axios';
+import { FC, PropsWithChildren } from 'react';
 
 type GzFetchErrorType = 'HTTP_ERROR' | 'NETWORK_ERROR' | 'TIMEOUT_ERROR' | 'CANCELED_ERROR' | 'UNKNOWN_ERROR';
 interface GzFetchErrorOptions {
@@ -54,6 +55,13 @@ interface GzFetchAuthOptions {
     headerName?: string;
     formatToken?: (token: string) => string;
 }
+interface GzFetchUnauthorizedOptions {
+    enabled?: boolean;
+    loginUrl?: string;
+    modalTitle?: string;
+    modalMessage?: string;
+    onUnauthorized?: () => void;
+}
 interface CreateGzFetchOptions {
     baseURL?: string;
     timeout?: number;
@@ -61,6 +69,7 @@ interface CreateGzFetchOptions {
     getToken?: () => string | undefined | Promise<string | undefined>;
     showErrorMessage?: boolean;
     auth?: GzFetchAuthOptions;
+    unauthorized?: GzFetchUnauthorizedOptions;
     middlewares?: readonly GzFetchMiddleware[];
 }
 interface GzFetchClient {
@@ -77,4 +86,8 @@ declare function createGzFetch(options?: CreateGzFetchOptions): GzFetchClient;
 declare function configureGzFetch(options: CreateGzFetchOptions): void;
 declare function gzFetch<TResponse, TRequestParams = unknown>(config: GzRequestConfig<TRequestParams>): Promise<TResponse>;
 
-export { type CreateGzFetchOptions, type GzErrorContext, type GzFetch, type GzFetchAuthOptions, type GzFetchClient, GzFetchError, type GzFetchErrorOptions, type GzFetchErrorType, type GzFetchMiddleware, type GzInternalRequestConfig, type GzRequestConfig, type GzRequestHeaders, type GzRequestMethod, type GzRequestOptions, type GzRequestParams, type GzResponseContext, type GzResponseType, configureGzFetch, createGzFetch, getResponseMessage, gzFetch, toGzFetchError };
+declare const GzFetchFeedbackProvider: FC<PropsWithChildren>;
+
+declare const GzFetchUnauthorizedModal: FC;
+
+export { type CreateGzFetchOptions, type GzErrorContext, type GzFetch, type GzFetchAuthOptions, type GzFetchClient, GzFetchError, type GzFetchErrorOptions, type GzFetchErrorType, GzFetchFeedbackProvider, type GzFetchMiddleware, GzFetchUnauthorizedModal, type GzFetchUnauthorizedOptions, type GzInternalRequestConfig, type GzRequestConfig, type GzRequestHeaders, type GzRequestMethod, type GzRequestOptions, type GzRequestParams, type GzResponseContext, type GzResponseType, configureGzFetch, createGzFetch, getResponseMessage, gzFetch, toGzFetchError };

package/dist/fetch/index.d.ts

@@ -1,4 +1,5 @@
 import { AxiosHeaders } from 'axios';
+import { FC, PropsWithChildren } from 'react';
 
 type GzFetchErrorType = 'HTTP_ERROR' | 'NETWORK_ERROR' | 'TIMEOUT_ERROR' | 'CANCELED_ERROR' | 'UNKNOWN_ERROR';
 interface GzFetchErrorOptions {
@@ -54,6 +55,13 @@ interface GzFetchAuthOptions {
     headerName?: string;
     formatToken?: (token: string) => string;
 }
+interface GzFetchUnauthorizedOptions {
+    enabled?: boolean;
+    loginUrl?: string;
+    modalTitle?: string;
+    modalMessage?: string;
+    onUnauthorized?: () => void;
+}
 interface CreateGzFetchOptions {
     baseURL?: string;
     timeout?: number;
@@ -61,6 +69,7 @@ interface CreateGzFetchOptions {
     getToken?: () => string | undefined | Promise<string | undefined>;
     showErrorMessage?: boolean;
     auth?: GzFetchAuthOptions;
+    unauthorized?: GzFetchUnauthorizedOptions;
     middlewares?: readonly GzFetchMiddleware[];
 }
 interface GzFetchClient {
@@ -77,4 +86,8 @@ declare function createGzFetch(options?: CreateGzFetchOptions): GzFetchClient;
 declare function configureGzFetch(options: CreateGzFetchOptions): void;
 declare function gzFetch<TResponse, TRequestParams = unknown>(config: GzRequestConfig<TRequestParams>): Promise<TResponse>;
 
-export { type CreateGzFetchOptions, type GzErrorContext, type GzFetch, type GzFetchAuthOptions, type GzFetchClient, GzFetchError, type GzFetchErrorOptions, type GzFetchErrorType, type GzFetchMiddleware, type GzInternalRequestConfig, type GzRequestConfig, type GzRequestHeaders, type GzRequestMethod, type GzRequestOptions, type GzRequestParams, type GzResponseContext, type GzResponseType, configureGzFetch, createGzFetch, getResponseMessage, gzFetch, toGzFetchError };
+declare const GzFetchFeedbackProvider: FC<PropsWithChildren>;
+
+declare const GzFetchUnauthorizedModal: FC;
+
+export { type CreateGzFetchOptions, type GzErrorContext, type GzFetch, type GzFetchAuthOptions, type GzFetchClient, GzFetchError, type GzFetchErrorOptions, type GzFetchErrorType, GzFetchFeedbackProvider, type GzFetchMiddleware, GzFetchUnauthorizedModal, type GzFetchUnauthorizedOptions, type GzInternalRequestConfig, type GzRequestConfig, type GzRequestHeaders, type GzRequestMethod, type GzRequestOptions, type GzRequestParams, type GzResponseContext, type GzResponseType, configureGzFetch, createGzFetch, getResponseMessage, gzFetch, toGzFetchError };

package/dist/fetch/index.js

@@ -1,10 +1,12 @@
-import { message } from '@chenhui996/gg-ui';
 import axios, { AxiosError, AxiosHeaders } from 'axios';
+import { message, Modal } from '@chenhui996/gg-ui';
+import { useRef, useCallback, useSyncExternalStore, useEffect } from 'react';
+import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 
 // src/fetch/client.ts
 var GzFetchError = class extends Error {
-  constructor(message2, options) {
-    super(message2);
+  constructor(message3, options) {
+    super(message3);
     this.name = "GzFetchError";
     this.type = options.type;
     this.status = options.status;
@@ -63,6 +65,28 @@ function toGzFetchError(error) {
     originalError: error
   });
 }
+var feedbackHosts = /* @__PURE__ */ new Map();
+var activeHostId;
+var registerFeedbackHost = (hostId, host) => {
+  feedbackHosts.set(hostId, host);
+  activeHostId != null ? activeHostId : activeHostId = hostId;
+  return () => {
+    feedbackHosts.delete(hostId);
+    if (activeHostId !== hostId) {
+      return;
+    }
+    const nextHost = feedbackHosts.keys().next();
+    activeHostId = nextHost.done ? void 0 : nextHost.value;
+  };
+};
+var showFetchErrorMessage = (content) => {
+  const activeHost = activeHostId === void 0 ? void 0 : feedbackHosts.get(activeHostId);
+  if (activeHost) {
+    activeHost.showErrorMessage(content);
+    return;
+  }
+  message.error(content);
+};
 
 // src/fetch/middleware.ts
 async function runRequestMiddlewares(initialConfig, middlewares) {
@@ -90,6 +114,103 @@ async function runErrorMiddlewares(error, context, middlewares) {
   }
 }
 
+// src/fetch/unauthorized.ts
+var DEFAULT_UNAUTHORIZED_LOGIN_URL = "/login";
+var DEFAULT_UNAUTHORIZED_MODAL_TITLE = "登录失效";
+var DEFAULT_UNAUTHORIZED_MODAL_MESSAGE = "当前登录状态已失效，请重新登录。";
+var IDLE_SNAPSHOT = { phase: "idle" };
+var snapshot = IDLE_SNAPSHOT;
+var listeners = /* @__PURE__ */ new Set();
+var modalHosts = /* @__PURE__ */ new Set();
+var emitChange = () => {
+  for (const listener of listeners) {
+    listener();
+  }
+};
+var setSnapshot = (nextSnapshot) => {
+  snapshot = nextSnapshot;
+  emitChange();
+};
+var resolveUnauthorizedOptions = (options) => {
+  var _a, _b, _c, _d;
+  return {
+    enabled: (_a = options == null ? void 0 : options.enabled) != null ? _a : false,
+    loginUrl: (_b = options == null ? void 0 : options.loginUrl) != null ? _b : DEFAULT_UNAUTHORIZED_LOGIN_URL,
+    modalTitle: (_c = options == null ? void 0 : options.modalTitle) != null ? _c : DEFAULT_UNAUTHORIZED_MODAL_TITLE,
+    modalMessage: (_d = options == null ? void 0 : options.modalMessage) != null ? _d : DEFAULT_UNAUTHORIZED_MODAL_MESSAGE,
+    ...(options == null ? void 0 : options.onUnauthorized) === void 0 ? {} : { onUnauthorized: options.onUnauthorized }
+  };
+};
+var getUnauthorizedSnapshot = () => snapshot;
+var getUnauthorizedServerSnapshot = () => IDLE_SNAPSHOT;
+var subscribeUnauthorized = (listener) => {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+};
+var registerUnauthorizedModalHost = (hostId) => {
+  modalHosts.add(hostId);
+  if (snapshot.activeHostId === void 0) {
+    setSnapshot({ ...snapshot, activeHostId: hostId });
+  }
+  return () => {
+    modalHosts.delete(hostId);
+    if (snapshot.activeHostId !== hostId) {
+      return;
+    }
+    const nextHost = modalHosts.values().next();
+    const nextHostId = nextHost.done ? void 0 : nextHost.value;
+    if (snapshot.phase === "closing") {
+      setSnapshot(
+        nextHostId === void 0 ? IDLE_SNAPSHOT : { activeHostId: nextHostId, phase: "idle" }
+      );
+      return;
+    }
+    if (nextHostId === void 0) {
+      setSnapshot(
+        snapshot.options === void 0 ? { phase: snapshot.phase } : { options: snapshot.options, phase: snapshot.phase }
+      );
+      return;
+    }
+    setSnapshot({ ...snapshot, activeHostId: nextHostId });
+  };
+};
+var openUnauthorizedModal = (options) => {
+  if (!options.enabled || snapshot.phase !== "idle") {
+    return false;
+  }
+  setSnapshot({
+    ...snapshot.activeHostId === void 0 ? {} : { activeHostId: snapshot.activeHostId },
+    options,
+    phase: "open"
+  });
+  return true;
+};
+var beginCloseUnauthorizedModal = () => {
+  if (snapshot.phase !== "open" || snapshot.options === void 0) {
+    return void 0;
+  }
+  const { options } = snapshot;
+  setSnapshot({ ...snapshot, phase: "closing" });
+  return options;
+};
+var cancelUnauthorizedModal = () => beginCloseUnauthorizedModal() !== void 0;
+var confirmUnauthorizedModal = () => beginCloseUnauthorizedModal();
+var completeUnauthorizedModal = () => {
+  if (snapshot.phase !== "closing") {
+    return;
+  }
+  setSnapshot(
+    snapshot.activeHostId === void 0 ? IDLE_SNAPSHOT : { activeHostId: snapshot.activeHostId, phase: "idle" }
+  );
+};
+var executeUnauthorizedAction = (options, navigate = (loginUrl) => window.location.assign(loginUrl)) => {
+  if (options.onUnauthorized) {
+    options.onUnauthorized();
+    return;
+  }
+  navigate(options.loginUrl);
+};
+
 // src/fetch/client.ts
 var DEFAULT_TIMEOUT = 15e3;
 var DEFAULT_AUTH_HEADER = "Authorization";
@@ -109,6 +230,7 @@ function createGzFetch(options = {}) {
   const showInstanceErrorMessage = (_b = options.showErrorMessage) != null ? _b : true;
   const headerName = (_d = (_c = options.auth) == null ? void 0 : _c.headerName) != null ? _d : DEFAULT_AUTH_HEADER;
   const formatToken = (_f = (_e = options.auth) == null ? void 0 : _e.formatToken) != null ? _f : ((token) => `Bearer ${token}`);
+  const unauthorizedOptions = resolveUnauthorizedOptions(options.unauthorized);
   const instance = axios.create({
     ...options.baseURL === void 0 ? {} : { baseURL: options.baseURL },
     timeout: (_g = options.timeout) != null ? _g : DEFAULT_TIMEOUT,
@@ -150,10 +272,14 @@ function createGzFetch(options = {}) {
       return await runResponseMiddlewares(response.data, context, middlewares);
     } catch (originalError) {
       const error = toGzFetchError(originalError);
+      const shouldHandleUnauthorized = unauthorizedOptions.enabled && error.type === "HTTP_ERROR" && error.status === 401;
+      if (shouldHandleUnauthorized) {
+        openUnauthorizedModal(unauthorizedOptions);
+      }
       await runErrorMiddlewares(error, { config: currentConfig }, middlewares);
       const shouldShowError = (_a2 = currentConfig.showErrorMessage) != null ? _a2 : showInstanceErrorMessage;
-      if (shouldShowError && error.type !== "CANCELED_ERROR") {
-        message.error(error.message);
+      if (shouldShowError && error.type !== "CANCELED_ERROR" && !shouldHandleUnauthorized) {
+        showFetchErrorMessage(error.message);
       }
       throw error;
     }
@@ -188,5 +314,61 @@ async function gzFetch(config) {
   }
   return defaultClient(config);
 }
+var GzFetchUnauthorizedModal = () => {
+  var _a, _b, _c;
+  const hostIdRef = useRef(void 0);
+  (_a = hostIdRef.current) != null ? _a : hostIdRef.current = /* @__PURE__ */ Symbol("gz-fetch-unauthorized-modal-host");
+  const hostId = hostIdRef.current;
+  const [messageApi, messageContextHolder] = message.useMessage();
+  const showErrorMessage = useCallback(
+    (content) => {
+      void messageApi.error(content);
+    },
+    [messageApi]
+  );
+  const snapshot2 = useSyncExternalStore(
+    subscribeUnauthorized,
+    getUnauthorizedSnapshot,
+    getUnauthorizedServerSnapshot
+  );
+  useEffect(() => registerUnauthorizedModalHost(hostId), [hostId]);
+  useEffect(
+    () => registerFeedbackHost(hostId, { showErrorMessage }),
+    [hostId, showErrorMessage]
+  );
+  const handleConfirm = () => {
+    const options = confirmUnauthorizedModal();
+    if (options) {
+      executeUnauthorizedAction(options);
+    }
+  };
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    messageContextHolder,
+    snapshot2.activeHostId === hostId && /* @__PURE__ */ jsx(
+      Modal,
+      {
+        afterClose: completeUnauthorizedModal,
+        cancelText: "取消",
+        closable: true,
+        okText: "重新登录",
+        open: snapshot2.phase === "open",
+        title: (_b = snapshot2.options) == null ? void 0 : _b.modalTitle,
+        onCancel: cancelUnauthorizedModal,
+        onOk: handleConfirm,
+        children: (_c = snapshot2.options) == null ? void 0 : _c.modalMessage
+      }
+    )
+  ] });
+};
+GzFetchUnauthorizedModal.displayName = "GzFetchUnauthorizedModal";
+var GzFetchUnauthorizedModal_default = GzFetchUnauthorizedModal;
+var GzFetchFeedbackProvider = ({ children }) => {
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(GzFetchUnauthorizedModal_default, {}),
+    children
+  ] });
+};
+GzFetchFeedbackProvider.displayName = "GzFetchFeedbackProvider";
+var GzFetchFeedbackProvider_default = GzFetchFeedbackProvider;
 
-export { GzFetchError, configureGzFetch, createGzFetch, getResponseMessage, gzFetch, toGzFetchError };
+export { GzFetchError, GzFetchFeedbackProvider_default as GzFetchFeedbackProvider, GzFetchUnauthorizedModal_default as GzFetchUnauthorizedModal, configureGzFetch, createGzFetch, getResponseMessage, gzFetch, toGzFetchError };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gz-fronted/gz-pc",
-  "version": "0.1.1-beta.1",
+  "version": "0.1.1-beta.3",
   "description": "Shared fetch, hooks and utility primitives for GZ frontend applications.",
   "license": "MIT",
   "type": "module",