@autional/shared 0.1.0-rc.33 → 0.1.0-rc.35

package/package.json

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

package/src/components/TenantIndexGuard.tsx

@@ -5,10 +5,11 @@
  * （不复制 4 份，违反 DRY）。
  *
  * - usePublicTenantSlugs: 调公开 tenants API（无认证端点），staleTime 5m 缓存，
- *   retry 1，任何失败返回空数组（放行语义由 TenantIndexGuard 处理）。
- * - TenantIndexGuard: index 路由守卫（P0-2），防止未知路径被贪婪渲染为
- *   Dashboard/首页。404 页由各 portal 通过 notFound prop 注入
- *   （shared 组件不能 import 具体 app 的 not-found/page）。
+ *   retry 1 + 8s 超时；失败上抛（不吞成空数组成功）——放行语义由消费方
+ *   （TenantIndexGuard / TenantRootRedirect）在失败态自行 fail-open（rc.35）。
+ * - TenantIndexGuard: 租户 slug 白名单守卫（P0-2），防止未知 slug 被贪婪渲染为
+ *   租户内容（index 首页与 /:slug/... 子路由通用）。404 页由各 portal 通过
+ *   notFound prop 注入（shared 组件不能 import 具体 app 的 not-found/page）。
  *
  * ⚠️ 依赖约束: shared 包 dependencies 无 @autional/ui，禁止 import @autional/ui
  * （会引入未声明依赖/循环依赖）。loading 默认值用内联 div 骨架，
@@ -30,11 +31,20 @@ export interface PublicTenantInfo {
 	id?: string;
 }
 
+/** 公开租户名单请求超时（ms）。跨境链路（Vercel edge → 源站）实测新连接丢 ~45%，
+ * 失败连接 edge 端要 ~31s 才吐 502；正常成功 ≤2s，8s 留 4x 余量，失败快速交给 retry。
+ * （rc.35：此前无超时 + catch 吞错 → retry 死码、失败被当"空名单"成功。） */
+export const PUBLIC_TENANTS_FETCH_TIMEOUT_MS = 8000;
+
 /**
  * 公开租户列表（无认证端点，用于校验 URL slug 有效性）。
  * 从 end-user-portal App.tsx 原样抽取。
  * - staleTime 5m（plan §5 资源列：public tenants API 有缓存）
- * - retry 1；失败返回 []（白名单空数组放行，避免 API 挂掉时全站 404）
+ * - retry 1；非 2xx / 网络错 / 超时一律上抛（不吞成空数组成功）——
+ *   error 态不落缓存，下次调用自然重试
+ * - 消费方 fail-open：名单缺失（error 态 data=undefined 或空数组）→ 不拦截
+ *   （TenantIndexGuard 渲染 children；TenantRootRedirect 漏斗 brand；
+ *   resolveSlugAgainstList 信任传入 slug）
  *
  * ⚠️ 响应契约：tenant-service ListPublicTenants 返回 dto_base.ListResponse
  * （`{code, message, items, total, pagination, timestamp}`，items 才是数组）。
@@ -44,14 +54,18 @@ export function usePublicTenantSlugs() {
 	return useQuery<Array<PublicTenantInfo>>({
 		queryKey: ['public-tenants'],
 		queryFn: async () => {
+			const controller = new AbortController();
+			const timer = setTimeout(() => controller.abort(), PUBLIC_TENANTS_FETCH_TIMEOUT_MS);
 			try {
-				const res = await fetch('/bff/tenant/api/v1/tenant/public/tenants');
-				if (!res.ok) return [];
+				const res = await fetch('/bff/tenant/api/v1/tenant/public/tenants', {
+					signal: controller.signal,
+				});
+				if (!res.ok) throw new Error(`public tenants API HTTP ${res.status}`);
 				const json = await res.json();
 				const list = json?.items ?? json?.data ?? json ?? [];
 				return Array.isArray(list) ? list : [];
-			} catch {
-				return [];
+			} finally {
+				clearTimeout(timer);
 			}
 		},
 		staleTime: 5 * 60 * 1000,
@@ -105,22 +119,19 @@ function DefaultLoadingSkeleton() {
 }
 
 /**
- * index 路由守卫（P0-2）：防止未知路径被贪婪渲染为 Dashboard/首页。
- * 逻辑与 end-user-portal 现状一致（L94-111）：
- * - URL 多段（如 /acme-corp/xyz）：basename 已剥离 slug，内部单段必为未知路由段 → notFound
- * - URL 单段（如 /not-found）：校验 slug 是否在公开租户列表 → 无效 → notFound
- * - URL 单段且 slug 有效（如 /acme-corp）→ children
+ * 租户 slug 白名单守卫（P0-2）：防止未知 slug 被贪婪渲染为租户内容。
+ * - URL 首段经 extractSlugFromPath 取为 slug（保留段/已注册业务段返回 undefined，放行）。
+ * - slug 命中公开租户列表 → children；未命中 → notFound（/nonexistent-tenant[/...] 均 404）。
+ * - 只校验 slug 一段，不看路径深度 —— 子路径合法性（/acme-corp/terms 等）由路由表决定。
+ *   2026-10-09 移除「URL 段数 > 1 → notFound」检查：它出自已废弃的动态 basename 方案
+ *   （那时 basename 剥掉 slug，内部多段 = 未知路由）；basename 改为 '/' 后它对 index
+ *   路由从未生效，却在包裹子路由处误杀 —— auth 站 /:tenantSlug/terms|privacy 曾因此恒 404。
  * - 白名单为空数组时放行（public tenants API 挂掉时退化为不拦截，与 end-user 现状一致）
  */
 export function TenantIndexGuard({ children, notFound, loading }: TenantIndexGuardProps) {
 	const { data: tenants, isLoading } = usePublicTenantSlugs();
 	const slug = useTenantSlugFromUrl();
 
-	if (typeof window !== 'undefined') {
-		const fullSegs = window.location.pathname.split('/').filter(Boolean);
-		if (fullSegs.length > 1) return <>{notFound}</>;
-	}
-
 	if (isLoading && !tenants) return <>{loading ?? <DefaultLoadingSkeleton />}</>;
 
 	if (slug && tenants && tenants.length > 0 && !tenants.some((t) => (t.name || t.slug) === slug)) {

package/src/components/TenantRootRedirect.tsx

@@ -18,7 +18,11 @@ import { usePublicTenantSlugs } from './TenantIndexGuard';
  */
 export function TenantRootRedirect() {
 	const currentTenantId = useCurrentTenantId();
-	const { data: knownTenants, isSuccess: tenantsLoaded } = usePublicTenantSlugs();
+	const {
+		data: knownTenants,
+		isSuccess: tenantsLoaded,
+		isError: tenantsError,
+	} = usePublicTenantSlugs();
 
 	const slug = useMemo(() => {
 		if (!currentTenantId || !tenantsLoaded) return undefined;
@@ -35,7 +39,8 @@ export function TenantRootRedirect() {
 		}
 		// 有会话但公开名单尚未返回：等待（名单是 slug 唯一权威，不得抢跑漏斗 brand）。
 		// 无会话（currentTenantId 空）不受此闸，立即漏斗。
-		if (currentTenantId && !tenantsLoaded) return;
+		// 名单接口彻底失败（rc.35：重试耗尽后 error 态）不等待：按无匹配处理漏斗 brand，不卡死。
+		if (currentTenantId && !tenantsLoaded && !tenantsError) return;
 		const brand = getPortalUrl('brand');
 		// 门户不可派生（如经 IP 主机访问）：保持当前页，不导航（与 EntryRouter 同约定）
 		if (!brand) return;
@@ -43,7 +48,7 @@ export function TenantRootRedirect() {
 			window.location.origin + window.location.pathname,
 		)}`;
 		traceRedirect(target, { reason: 'funnel-brand' });
-	}, [slug, currentTenantId, tenantsLoaded]);
+	}, [slug, currentTenantId, tenantsLoaded, tenantsError]);
 
 	return null;
 }

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

@@ -9,7 +9,9 @@ import { TenantIndexGuard, usePublicTenantSlugs } from '../TenantIndexGuard';
 function createQueryClient() {
 	return new QueryClient({
 		defaultOptions: {
-			queries: { retry: false, gcTime: Infinity },
+			// retryDelay 0：hook 内部 retry:1 覆盖 retry，但重试退避仍走 defaultOptions，
+			// 不设 0 时失败用例要白等默认 1s 退避
+			queries: { retry: false, retryDelay: 0, gcTime: Infinity },
 		},
 	});
 }
@@ -106,20 +108,34 @@ describe('usePublicTenantSlugs（响应契约解析）', () => {
 		await waitFor(() => expect(result).toEqual([{ id: '1', name: 'acme-corp' }]));
 	});
 
-	it('API 非 200 → 返回空数组（放行语义）', async () => {
+	it('API 非 200 → 上抛进入 error 态，不吞成空数组成功（rc.35）', async () => {
 		stubFetchNonOk();
-		let result: unknown[] | undefined;
+		let state: { isError: boolean; data: unknown[] | undefined } | undefined;
 		function Harness() {
 			const q = usePublicTenantSlugs();
-			result = q.data;
+			state = { isError: q.isError, data: q.data };
 			return null;
 		}
 		render(wrapper(<Harness />));
-		await waitFor(() => expect(result).toEqual([]));
+		await waitFor(() => expect(state?.isError).toBe(true));
+		expect(state?.data).toBeUndefined();
 	});
 
-	it('网络异常 → 返回空数组', async () => {
+	it('网络异常 → 上抛进入 error 态（retry 不再被吞错架空，rc.35）', async () => {
 		stubFetchReject();
+		let state: { isError: boolean; data: unknown[] | undefined } | undefined;
+		function Harness() {
+			const q = usePublicTenantSlugs();
+			state = { isError: q.isError, data: q.data };
+			return null;
+		}
+		render(wrapper(<Harness />));
+		await waitFor(() => expect(state?.isError).toBe(true));
+		expect(state?.data).toBeUndefined();
+	});
+
+	it('fetch 携带 AbortSignal（8s 超时接线，rc.35）', async () => {
+		stubFetch([{ id: '1', name: 'acme-corp' }]);
 		let result: unknown[] | undefined;
 		function Harness() {
 			const q = usePublicTenantSlugs();
@@ -127,7 +143,39 @@ describe('usePublicTenantSlugs（响应契约解析）', () => {
 			return null;
 		}
 		render(wrapper(<Harness />));
-		await waitFor(() => expect(result).toEqual([]));
+		await waitFor(() => expect(result).toEqual([{ id: '1', name: 'acme-corp' }]));
+		const fetchMock = fetch as unknown as ReturnType<typeof vi.fn>;
+		const init = fetchMock.mock.calls[0][1] as RequestInit;
+		expect(init.signal).toBeInstanceOf(AbortSignal);
+	});
+
+	it('超时 abort（AbortError）→ 上抛进入 error 态，不吞（rc.35）', async () => {
+		const signals: AbortSignal[] = [];
+		vi.stubGlobal(
+			'fetch',
+			vi.fn((_url: string, init?: RequestInit) => {
+				return new Promise((_resolve, reject) => {
+					signals.push(init!.signal!);
+					init!.signal!.addEventListener('abort', () =>
+						reject(new DOMException('The operation was aborted.', 'AbortError')),
+					);
+				});
+			}),
+		);
+		let isError = false;
+		function Harness() {
+			const q = usePublicTenantSlugs();
+			isError = q.isError;
+			return null;
+		}
+		render(wrapper(<Harness />));
+		// 模拟计时器到点 abort（计时器-到点→abort 是标准库行为，此处验 abort 错误的上抛路径）；
+		// hook retry:1 → 两跳都要 abort 才耗尽重试
+		await waitFor(() => expect(signals.length).toBeGreaterThan(0));
+		signals[0].dispatchEvent(new Event('abort'));
+		await waitFor(() => expect(signals.length).toBeGreaterThan(1));
+		signals[1].dispatchEvent(new Event('abort'));
+		await waitFor(() => expect(isError).toBe(true));
 	});
 
 	it('响应无 items/data 且非数组 → 返回空数组', async () => {
@@ -178,10 +226,27 @@ describe('TenantIndexGuard（P0-2 slug 白名单守卫）', () => {
 		await waitFor(() => expect(screen.getByTestId('children')).toBeInTheDocument());
 	});
 
-	it('URL 多段路径 → 直接 notFound（basename 已剥离 slug，内部必为未知段）', () => {
-		setPath('/acme-corp/xyz');
+	it('名单接口失败（重试耗尽 error）→ fail-open 渲染 children，不白屏不 404（rc.35）', async () => {
+		stubFetchReject();
+		setPath('/any-slug');
+		render(wrapper(<TenantIndexGuard notFound={notFound}>{children}</TenantIndexGuard>));
+		await waitFor(() => expect(screen.getByTestId('children')).toBeInTheDocument());
+		expect(screen.queryByTestId('notfound')).toBeNull();
+	});
+
+	it('slug 有效 + 子路径（/acme-corp/terms）→ 渲染 children（回归：子路由此前被段数检查误杀）', async () => {
+		stubFetch([{ id: '1', name: 'acme-corp' }]);
+		setPath('/acme-corp/terms');
 		render(wrapper(<TenantIndexGuard notFound={notFound}>{children}</TenantIndexGuard>));
-		expect(screen.getByTestId('notfound')).toBeInTheDocument();
+		await waitFor(() => expect(screen.getByTestId('children')).toBeInTheDocument());
+		expect(screen.queryByTestId('notfound')).toBeNull();
+	});
+
+	it('slug 无效 + 子路径（/nonexistent-tenant/terms）→ 渲染 notFound', async () => {
+		stubFetch([{ id: '1', name: 'acme-corp' }]);
+		setPath('/nonexistent-tenant/terms');
+		render(wrapper(<TenantIndexGuard notFound={notFound}>{children}</TenantIndexGuard>));
+		await waitFor(() => expect(screen.getByTestId('notfound')).toBeInTheDocument());
 		expect(screen.queryByTestId('children')).toBeNull();
 	});
 

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

@@ -34,7 +34,12 @@ import { getPortalUrl } from '../../config';
 function wrapper(children: ReactNode) {
 	return (
 		<QueryClientProvider
-			client={new QueryClient({ defaultOptions: { queries: { retry: false, gcTime: Infinity } } })}
+			client={
+				new QueryClient({
+					// retryDelay 0：hook 内部 retry:1 覆盖 retry，重试退避仍走 defaultOptions
+					defaultOptions: { queries: { retry: false, retryDelay: 0, gcTime: Infinity } },
+				})
+			}
 		>
 			{children}
 		</QueryClientProvider>
@@ -154,7 +159,7 @@ describe('TenantRootRedirect 裸根漏斗', () => {
 		expect(withoutRt(String(mockState.replace.mock.calls[0][0]))).toBe(withoutRt(expectedBrandFunnel()));
 	});
 
-	it('名单接口失败（返回空数组）→ 有会话按无匹配处理，漏斗 brand（不卡死）', async () => {
+	it('名单接口失败（error 态，rc.35 上抛）→ 有会话按无匹配处理，漏斗 brand（不卡死）', async () => {
 		mockState.currentTenantId = 't1';
 		vi.stubGlobal('fetch', vi.fn().mockRejectedValue(new Error('network down')));