@autional/shared 0.1.0-rc.36 → 0.1.0-rc.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autional/shared",
-  "version": "0.1.0-rc.36",
+  "version": "0.1.0-rc.37",
   "description": "Autional shared layer — API client, auth, types, hooks, utils",
   "license": "AGPL-3.0",
   "main": "./src/index.ts",

package/src/auth/auth-queries.ts

@@ -58,8 +58,7 @@ export function usePermissionsQuery(tenantId?: string | null, enabled = true) {
 				[]) as string[];
 		},
 		staleTime: AUTH_DATA_STALE_TIME,
-		retry: 1,
-		retryDelay: 1000,
+		// 重试策略不在此声明：交给消费方的 QueryClient 默认（本包不得有 per-query 覆盖，否则会盖过默认）。
 		// 无 token 时禁止发起请求：未登录时该查询必然 401 → apiClient 401 拦截
 		// → refreshToken() 无 refresh token → onUnauthorized() 抢跑 buildLoginUrl，
 		// 与 RequireAuth 的 OAuth PKCE 触发形成时序竞争（跨域 admin 场景偶发 302 回登录页）。
@@ -92,8 +91,7 @@ export function useTenantsQuery(tenantId?: string | null, enabled = true) {
 			}>;
 		},
 		staleTime: AUTH_DATA_STALE_TIME,
-		retry: 1,
-		retryDelay: 1000,
+		// 重试策略不在此声明：交给消费方的 QueryClient 默认（本包不得有 per-query 覆盖，否则会盖过默认）。
 		// 与 usePermissionsQuery 一致：无 token 时禁止发起请求，
 		// 避免 401 → onUnauthorized 抢跑 RequireAuth 的 OAuth PKCE 流程。
 		enabled,
@@ -112,7 +110,6 @@ export function useMeQuery() {
 			return extractItem(res.data) ?? res.data;
 		},
 		staleTime: AUTH_DATA_STALE_TIME,
-		retry: 1,
-		retryDelay: 1000,
+		// 重试策略不在此声明：交给消费方的 QueryClient 默认（本包不得有 per-query 覆盖，否则会盖过默认）。
 	});
 }

package/src/components/TenantIndexGuard.tsx

@@ -5,7 +5,7 @@
  * （不复制 4 份，违反 DRY）。
  *
  * - usePublicTenantSlugs: 调公开 tenants API（无认证端点），staleTime 5m 缓存，
- *   retry 1 + 8s 超时；失败上抛（不吞成空数组成功）——放行语义由消费方
+ *   8s 超时（重试由消费方默认策略决定）；失败上抛（不吞成空数组成功）——放行语义由消费方
  *   （TenantIndexGuard / TenantRootRedirect）在失败态自行 fail-open（rc.35）。
  * - TenantIndexGuard: 租户 slug 白名单守卫（P0-2），防止未知 slug 被贪婪渲染为
  *   租户内容（index 首页与 /:slug/... 子路由通用）。404 页由各 portal 通过
@@ -32,7 +32,7 @@ export interface PublicTenantInfo {
 }
 
 /** 公开租户名单请求超时（ms）。跨境链路（Vercel edge → 源站）实测新连接丢 ~45%，
- * 失败连接 edge 端要 ~31s 才吐 502；正常成功 ≤2s，8s 留 4x 余量，失败快速交给 retry。
+ * 失败连接 edge 端要 ~31s 才吐 502；正常成功 ≤2s，8s 留 4x 余量，失败快速交由消费方的重试策略。
  * （rc.35：此前无超时 + catch 吞错 → retry 死码、失败被当"空名单"成功。） */
 export const PUBLIC_TENANTS_FETCH_TIMEOUT_MS = 8000;
 
@@ -40,7 +40,7 @@ export const PUBLIC_TENANTS_FETCH_TIMEOUT_MS = 8000;
  * 公开租户列表（无认证端点，用于校验 URL slug 有效性）。
  * 从 end-user-portal App.tsx 原样抽取。
  * - staleTime 5m（plan §5 资源列：public tenants API 有缓存）
- * - retry 1；非 2xx / 网络错 / 超时一律上抛（不吞成空数组成功）——
+ * - 非 2xx / 网络错 / 超时一律上抛（不吞成空数组成功）——
  *   error 态不落缓存，下次调用自然重试
  * - 消费方 fail-open：名单缺失（error 态 data=undefined 或空数组）→ 不拦截
  *   （TenantIndexGuard 渲染 children；TenantRootRedirect 漏斗 brand；
@@ -69,7 +69,7 @@ export function usePublicTenantSlugs() {
 			}
 		},
 		staleTime: 5 * 60 * 1000,
-		retry: 1,
+		// 重试策略交给消费方 QueryClient 默认（本包不得有 per-query 覆盖）。
 	});
 }
 

package/src/components/__tests__/TenantIndexGuard.test.tsx

@@ -9,9 +9,10 @@ import { TenantIndexGuard, usePublicTenantSlugs } from '../TenantIndexGuard';
 function createQueryClient() {
 	return new QueryClient({
 		defaultOptions: {
-			// retryDelay 0：hook 内部 retry:1 覆盖 retry，但重试退避仍走 defaultOptions，
-			// 不设 0 时失败用例要白等默认 1s 退避
-			queries: { retry: false, retryDelay: 0, gcTime: Infinity },
+			// 重试由**本测试客户端**声明（生产里由消费方 QueryClient 默认决定；本包不再声明 retry，
+			// 否则会盖过消费方默认 —— rc.35 起如此）。retry:1 + retryDelay:0 让
+			// 「重试耗尽后错误必须上抛」这一断言仍可验证，且失败用例不白等默认退避。
+			queries: { retry: 1, retryDelay: 0, gcTime: Infinity },
 		},
 	});
 }