giime 1.1.5 → 1.1.6

package/lib/watermark/src/user.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @file 防篡改且零闪烁的用户 ID 解析引擎（首屏先读 sso_user_id + 服务端接口静默比对纠偏）
+ * @description
+ * 两步走极简方案：
+ * 1. **第一步（0ms 首屏直出）**：默认直接读取 Cookie 中的 `sso_user_id` 立即渲染水印，首帧即展示完整水印，绝不等待接口、绝不闪烁；
+ * 2. **第二步（后台接口核验纠偏）**：
+ *    - 被动监听宿主项目（如 `gsmp`）自身发起的 `/basic/v1/user/getCurrentUser`（或 `/sso/getUserInfo`）接口响应；
+ *    - 若宿主页面在 `1200ms` 内未调用过该接口，则自动携带 `token` 请求一次 `/guard/basic/v1/user/getCurrentUser`；
+ *    - 拿到服务端返回的真实 `data.id` 后与当前水印上的 `userId` 比对：**一致则跳过重绘（零闪烁），不一致（如用户修改了 `sso_user_id` 或初始未写入）则立即更新水印并修复 `sso_user_id` Cookie**。
+ */
+import type { NormalizedWatermarkConfig } from './types';
+/**
+ * 过滤无效的脏字符串（如 'undefined' / 'null' / 'NaN'）
+ */
+export declare const sanitizeUserId: (raw: unknown) => string;
+/**
+ * 安全读取指定名称的 Cookie
+ */
+export declare const getCookieValue: (name: string) => string;
+/**
+ * 获取当前登录凭证 `token`
+ */
+export declare const getAuthToken: () => string;
+/**
+ * 判断当前是否已经完成了针对当前 token 的服务端真实身份核验
+ */
+export declare const hasServerVerifiedUser: () => boolean;
+/**
+ * 注册当服务端返回真实 userId 时的回调
+ */
+export declare const onServerUserResolved: (listener: (userId: string) => void) => (() => void);
+/**
+ * 写入经服务端核验的用户 ID，若 sso_user_id Cookie 被修改或缺失则自动同步修复
+ */
+export declare const setVerifiedServerUserId: (id: unknown, tokenSnapshot?: string) => void;
+/**
+ * 清空闭包缓存的服务端用户 ID（用于账号切换或单元测试重置）
+ */
+export declare const resetVerifiedServerUserCache: () => void;
+/**
+ * 从 `/basic/v1/user/getCurrentUser` 或 `/sso/getUserInfo` 响应 JSON 中提取真实用户 ID
+ */
+export declare const extractUserIdFromApiResponse: (payload: any) => string;
+/**
+ * 安装轻量级只读网络响应观察器（同时支持 XMLHttpRequest 与 window.fetch）：
+ * 当宿主项目（如 gsmp 进页面时）自己发起 getCurrentUser 请求，直接读取其返回的真实 `data.id`，零额外请求开销
+ */
+export declare const installUserResponseObserver: () => void;
+/**
+ * 推导当前环境下请求 `/basic/v1/user/getCurrentUser` 的候选接口地址列表
+ */
+export declare const resolveUserApiCandidates: (config?: Pick<NormalizedWatermarkConfig, 'userApiUrl' | 'env'>) => string[];
+/**
+ * 主动向服务端请求 `/guard/basic/v1/user/getCurrentUser` 校验 `token` 并获取真实 `userId`（仅在宿主未发起该请求时作为兜底调用）
+ */
+export declare const fetchServerVerifiedUserId: (config?: Pick<NormalizedWatermarkConfig, 'userApiUrl' | 'env' | 'autoFetchUser'>) => Promise<string>;
+/**
+ * 同步解析当前用于渲染的用户 ID：
+ * 1. 配置项显式传入的 `getUserId()` 或 `userId`
+ * 2. 若已完成服务端接口核验，则取服务端返回的真实 `verifiedServerUserId`
+ * 3. 默认首屏先读 Cookie 中的 `sso_user_id`（0ms 同步直出，不闪烁）
+ */
+export declare const resolveWatermarkUserId: (config?: Pick<NormalizedWatermarkConfig, 'userId' | 'getUserId'>) => string;
+/**
+ * 格式化水印日期（严格对齐 gsmp 格式：YYYY年MM月DD日）
+ */
+export declare const formatWatermarkDate: (date?: Date) => string;
+/**
+ * 构建最终展示的水印文案（默认：`吉客印-${userId}-${YYYY年MM月DD日}`）
+ */
+export declare const buildWatermarkText: (config: Pick<NormalizedWatermarkConfig, 'prefix' | 'text' | 'userId' | 'getUserId'>, resolvedUserId?: string, dateStr?: string) => string;

package/lib/watermark/vue2.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @file Vue 2 专用入口 (@giime/watermark/vue2)
+ * @description
+ * 支持两种用法：
+ * 1. 一行代码引入即自动生效：`import '../watermark/vue2'`
+ * 2. 插件注册传参：`import { watermarkVue2Plugin } from '../watermark/vue2'; Vue.use(watermarkVue2Plugin, { store })`
+ */
+import watermarkVue2Plugin from './src/adapters/vue2';
+export * from './src/adapters/vue2';
+export default watermarkVue2Plugin;

package/lib/watermark/vue3.d.ts

@@ -0,0 +1,2 @@
+export * from './src/adapters/vue3';
+export { default } from './src/adapters/vue3';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "giime",
-  "version": "1.1.5",
+  "version": "1.1.6",
   "description": "A Component Library for Vue 3",
   "keywords": [
     "giime",