xkit-utils 2.0.0-alpha.0

package/dist/index.d.ts

@@ -0,0 +1,163 @@
+/**
+ * 将平铺列表转为森林（多根树）。
+ * 1. 对每一项做浅拷贝后再挂 `children`，**不修改**入参 `list` 中的对象。
+ * 2. 浅拷贝：嵌套对象/数组仍与平铺项中的引用相同；仅 `children` 树结构是新建的。
+ */
+export declare const buildTree: <T extends Record<string, any>>(list: T[], { idField, parentIdField }?: BuildTreeConfig) => TreeNode<T>[];
+
+export declare interface BuildTreeConfig {
+    idField?: string;
+    parentIdField?: string;
+}
+
+declare type Constructor<T> = new (...args: any[]) => T;
+
+/**
+ * 将纯文本写入系统剪贴板。
+ *
+ * 优先使用 Clipboard API（`navigator.clipboard.writeText`）；在不可用或失败时
+ *（非安全上下文、权限被拒等）回退到 `document.execCommand('copy')` + 离屏 textarea，
+ * 以兼容旧浏览器与受限环境。
+ *
+ * 在非浏览器环境（如 SSR、无 DOM 的 Worker）中安全返回 `false`，不抛错。
+ */
+export declare const copyToClipboard: (text: string) => Promise<boolean>;
+
+export declare function createSSEConnection(options: SSEOptions): SSEConnection;
+
+/** 多根树的深度优先遍历（前序，子节点从左到右）。 */
+export declare class Forest<T extends Record<string, unknown> = Record<string, unknown>> {
+    readonly trees: TreeNode<T>[];
+    constructor(trees: TreeNode<T>[]);
+    [Symbol.iterator](): Generator<TreeNode<T>, void, undefined>;
+    /** 根节点数组（与构造时传入的引用相同）。 */
+    toArray(): TreeNode<T>[];
+}
+
+/**
+ * 将 `Record<string, string>` 的键值对调：key → value 变为 value → key。
+ * 若多个 key 对应同一 value，后者覆盖前者（与 `Object.fromEntries` 行为一致）。
+ * @param obj 键值对对象（value 须为 string，且通常唯一）
+ * @returns 反向映射对象，类型可推断
+ */
+export declare function invertRecord<T extends Record<string, string>>(obj: T): {
+    [V in T[keyof T]]: {
+        [K in keyof T]: T[K] extends V ? K : never;
+    }[keyof T];
+};
+
+/**
+ * 拼接路径。去除每个路径首尾的斜杠，并确保路径之间只有一个斜杠
+ * @param paths 路径
+ * @returns 拼接后的路径
+ */
+export declare function joinPaths(...paths: string[]): string;
+
+/**
+ * 解析单个 SSE 事件块（不含块之间的空行分隔）。
+ */
+export declare function parseSSEBlock(block: string): SSEMessage | null;
+
+/**
+ * 刷新 token 的回调函数，如果刷新失败，请抛出异常
+ */
+declare type RefreshHandler = () => Promise<void>;
+
+export declare type RefreshOptions = {
+    /**
+     * 刷新 token 的回调函数，如果刷新失败，请抛出异常
+     */
+    refresh: RefreshHandler;
+    /**
+     * 最大刷新次数
+     */
+    maxAttempts?: number;
+    /**
+     * 冷却时间（分钟）
+     */
+    cooldownMinutes?: number;
+    /**
+     * 刷新失败回调
+     */
+    onFail?: (error?: unknown) => void;
+};
+
+export declare class ServiceProvider {
+    private cache;
+    private factories;
+    private defaultArgs;
+    constructor(defaultArgs?: any[]);
+    register<T>(clazz: Constructor<T>, factory: (provider: ServiceProvider) => T): void;
+    get<T>(clazz: Constructor<T>): T;
+    clear(): void;
+}
+
+export declare class SSEConnection {
+    private options;
+    private retryCount;
+    private isConnecting;
+    private isConnected;
+    private abortController?;
+    constructor(options: SSEOptions);
+    setHeader(key: string, value: string): void;
+    connect(): Promise<void>;
+    private handleMessage;
+    private processStream;
+    disconnect(): void;
+    get isActive(): boolean;
+}
+
+export declare interface SSEMessage {
+    data?: string;
+    event?: string;
+    id?: string;
+    retry?: number;
+}
+
+export declare interface SSEOptions {
+    url: string;
+    headers?: Record<string, string>;
+    method?: "GET" | "POST";
+    body?: unknown;
+    onMessage?: (message: SSEMessage) => void;
+    onOpen?: () => void;
+    onError?: (error: Error) => void;
+    onClose?: () => void;
+    retryAttempts?: number;
+    retryDelay?: number;
+    onException?: (error: unknown) => void;
+}
+
+export declare class TokenRefreshManager {
+    private readonly refresh;
+    private readonly maxAttempts;
+    private readonly cooldownMinutes;
+    private readonly onFail?;
+    private tasks;
+    private refreshing;
+    private attemptCount;
+    private lastRefreshAt;
+    constructor(options: RefreshOptions);
+    private isCooldownExpired;
+    private markAttempt;
+    private clearTasks;
+    private runTasks;
+    private resetAttempts;
+    /** 复位当前实例内部的刷新队列与计数 */
+    resetState(): void;
+    /** 统一处理失败收口：复位状态并触发失败回调 */
+    handleFail(error?: unknown): void;
+    enqueueTask(task: () => void): void;
+    /**
+     * 在刷新 token 后执行任务，防止并发刷新token
+     * @param task 需要执行的任务
+     * @returns 任务的返回值
+     */
+    runAfterRefresh<T>(task: () => Promise<T> | T): Promise<T>;
+}
+
+export declare type TreeNode<T> = T & {
+    children?: TreeNode<T>[];
+};
+
+export { }

package/dist/xkit-utils.js

@@ -0,0 +1,339 @@
+//#region src/clipboard/index.ts
+/**
+* 将纯文本写入系统剪贴板。
+*
+* 优先使用 Clipboard API（`navigator.clipboard.writeText`）；在不可用或失败时
+*（非安全上下文、权限被拒等）回退到 `document.execCommand('copy')` + 离屏 textarea，
+* 以兼容旧浏览器与受限环境。
+*
+* 在非浏览器环境（如 SSR、无 DOM 的 Worker）中安全返回 `false`，不抛错。
+*/
+var copyToClipboard = async (text) => {
+	if (typeof window === "undefined" || typeof document === "undefined") return false;
+	if (navigator.clipboard?.writeText) try {
+		await navigator.clipboard.writeText(text);
+		return true;
+	} catch (err) {
+		console.error("navigator.clipboard.writeText failed", err);
+	}
+	const textArea = document.createElement("textarea");
+	textArea.value = text;
+	textArea.readOnly = true;
+	textArea.style.position = "fixed";
+	textArea.style.left = "-9999px";
+	textArea.style.top = "-9999px";
+	textArea.style.opacity = "0";
+	document.body.appendChild(textArea);
+	textArea.focus();
+	textArea.select();
+	try {
+		return document.execCommand("copy");
+	} catch (err) {
+		console.error("Fallback: copyToClipboard failed", err);
+		return false;
+	} finally {
+		textArea.remove();
+	}
+};
+//#endregion
+//#region src/record/index.ts
+/**
+* 将 `Record<string, string>` 的键值对调：key → value 变为 value → key。
+* 若多个 key 对应同一 value，后者覆盖前者（与 `Object.fromEntries` 行为一致）。
+* @param obj 键值对对象（value 须为 string，且通常唯一）
+* @returns 反向映射对象，类型可推断
+*/
+function invertRecord(obj) {
+	return Object.fromEntries(Object.entries(obj).map(([k, v]) => [v, k]));
+}
+//#endregion
+//#region src/path/index.ts
+/**
+* 拼接路径。去除每个路径首尾的斜杠，并确保路径之间只有一个斜杠
+* @param paths 路径
+* @returns 拼接后的路径
+*/
+function joinPaths(...paths) {
+	return paths.map((path) => path.replace(/(^\/+|\/+$)/g, "")).filter(Boolean).join("/");
+}
+//#endregion
+//#region src/tree/build-tree.ts
+/**
+* 将平铺列表转为森林（多根树）。
+* 1. 对每一项做浅拷贝后再挂 `children`，**不修改**入参 `list` 中的对象。
+* 2. 浅拷贝：嵌套对象/数组仍与平铺项中的引用相同；仅 `children` 树结构是新建的。
+*/
+var buildTree = (list, { idField = "id", parentIdField = "pId" } = {}) => {
+	const idToNode = /* @__PURE__ */ new Map();
+	for (const elem of list) idToNode.set(elem[idField], { ...elem });
+	for (const elem of list) {
+		const node = idToNode.get(elem[idField]);
+		const parent = idToNode.get(elem[parentIdField]);
+		if (node && parent) {
+			if (!parent.children) parent.children = [];
+			parent.children.push(node);
+		}
+	}
+	return list.filter((item) => !idToNode.get(item[parentIdField])).map((item) => idToNode.get(item[idField])).filter((n) => n != null);
+};
+//#endregion
+//#region src/tree/forest.ts
+/** 多根树的深度优先遍历（前序，子节点从左到右）。 */
+var Forest = class {
+	constructor(trees) {
+		this.trees = trees;
+	}
+	*[Symbol.iterator]() {
+		const { trees } = this;
+		for (let i = trees.length - 1; i >= 0; i--) {
+			const stack = [trees[i]];
+			while (stack.length > 0) {
+				const current = stack.pop();
+				if (current === void 0) continue;
+				yield current;
+				if (current.children && current.children.length > 0) for (let j = current.children.length - 1; j >= 0; j--) stack.push(current.children[j]);
+			}
+		}
+	}
+	/** 根节点数组（与构造时传入的引用相同）。 */
+	toArray() {
+		return this.trees;
+	}
+};
+//#endregion
+//#region src/sse/parse-sse-block.ts
+/**
+* 解析单个 SSE 事件块（不含块之间的空行分隔）。
+*/
+function parseSSEBlock(block) {
+	const message = {};
+	const lines = block.split("\n");
+	for (const line of lines) if (line.startsWith("data:")) {
+		const dataPart = line.replace(/^data:\s*/, "");
+		message.data = (message.data ?? "") + dataPart + "\n";
+	} else if (line.startsWith("event:")) message.event = line.replace(/^event:\s*/, "").trim();
+	else if (line.startsWith("id:")) message.id = line.replace(/^id:\s*/, "").trim();
+	else if (line.startsWith("retry:")) {
+		const retry = parseInt(line.replace(/^retry:\s*/, "").trim(), 10);
+		if (!isNaN(retry)) message.retry = retry;
+	}
+	if (message.data) message.data = message.data.trim();
+	if (!message.data && !message.event) return null;
+	return message;
+}
+//#endregion
+//#region src/sse/sse-connection.ts
+var SSEConnection = class {
+	options;
+	retryCount = 0;
+	isConnecting = false;
+	isConnected = false;
+	abortController;
+	constructor(options) {
+		this.options = {
+			retryAttempts: 3,
+			retryDelay: 1e3,
+			...options
+		};
+	}
+	setHeader(key, value) {
+		if (!this.options.headers) this.options.headers = {};
+		this.options.headers[key] = value;
+	}
+	async connect() {
+		if (this.isConnecting || this.isConnected) return;
+		this.isConnecting = true;
+		this.abortController = new AbortController();
+		try {
+			const headers = {
+				Accept: "text/event-stream",
+				"Cache-Control": "no-cache",
+				...this.options.headers
+			};
+			if (this.options.body) headers["Content-Type"] = "application/json";
+			const response = await fetch(this.options.url, {
+				method: this.options.method || "GET",
+				headers,
+				body: this.options.body ? JSON.stringify(this.options.body) : void 0,
+				signal: this.abortController.signal
+			});
+			if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+			if (!response.body) throw new Error("Response body is null");
+			this.isConnected = true;
+			this.isConnecting = false;
+			this.retryCount = 0;
+			this.options.onOpen?.();
+			await this.processStream(response.body);
+		} catch (error) {
+			this.isConnecting = false;
+			this.isConnected = false;
+			if (error instanceof Error) {
+				if (error.name === "AbortError") return;
+				if (error.message.includes("401")) {
+					this.options.onError?.(error);
+					return;
+				}
+			}
+			this.options.onError?.(error);
+			if (this.retryCount < this.options.retryAttempts) {
+				this.retryCount++;
+				console.log(`SSE 连接失败，${this.options.retryDelay}ms 后重试 (${this.retryCount}/${this.options.retryAttempts})`);
+				setTimeout(() => {
+					this.connect();
+				}, this.options.retryDelay);
+			} else console.error("SSE 连接失败，已达到最大重试次数");
+		}
+	}
+	handleMessage(message) {
+		if (!message) return;
+		if (message.event === "exception" || message.event === "error") try {
+			const errorObj = JSON.parse(message.data || "{}");
+			this.options.onException?.(errorObj);
+		} catch {
+			this.options.onException?.({ error: message.data });
+		}
+		else this.options.onMessage?.(message);
+	}
+	async processStream(stream) {
+		const reader = stream.getReader();
+		const decoder = new TextDecoder("utf-8");
+		let buffer = "";
+		try {
+			while (true) {
+				const { value, done } = await reader.read();
+				if (done) break;
+				const chunk = decoder.decode(value, { stream: true });
+				buffer += chunk;
+				const parts = buffer.split("\n\n");
+				buffer = parts.pop() || "";
+				for (const part of parts) this.handleMessage(parseSSEBlock(part));
+			}
+			if (buffer.trim()) this.handleMessage(parseSSEBlock(buffer));
+		} finally {
+			reader.releaseLock();
+			this.isConnected = false;
+			this.options.onClose?.();
+		}
+	}
+	disconnect() {
+		this.isConnected = false;
+		this.isConnecting = false;
+		this.abortController?.abort();
+	}
+	get isActive() {
+		return this.isConnected || this.isConnecting;
+	}
+};
+function createSSEConnection(options) {
+	return new SSEConnection(options);
+}
+//#endregion
+//#region src/token-refresh/index.ts
+var TokenRefreshManager = class {
+	refresh;
+	maxAttempts;
+	cooldownMinutes;
+	onFail;
+	tasks = [];
+	refreshing = false;
+	attemptCount = 0;
+	lastRefreshAt = 0;
+	constructor(options) {
+		this.refresh = options.refresh;
+		this.maxAttempts = options.maxAttempts ?? 3;
+		this.cooldownMinutes = options.cooldownMinutes ?? 5;
+		this.onFail = options.onFail;
+	}
+	isCooldownExpired() {
+		if (this.lastRefreshAt === 0) return true;
+		const cooldownMs = this.cooldownMinutes * 60 * 1e3;
+		return Date.now() - this.lastRefreshAt > cooldownMs;
+	}
+	markAttempt() {
+		this.attemptCount += 1;
+		this.lastRefreshAt = Date.now();
+		console.log("刷新次数=>", this.attemptCount);
+	}
+	clearTasks() {
+		this.tasks = [];
+	}
+	runTasks() {
+		this.tasks.forEach((task) => task());
+		this.tasks = [];
+	}
+	resetAttempts() {
+		this.attemptCount = 0;
+		this.lastRefreshAt = 0;
+	}
+	/** 复位当前实例内部的刷新队列与计数 */
+	resetState() {
+		this.clearTasks();
+		this.resetAttempts();
+		this.refreshing = false;
+	}
+	/** 统一处理失败收口：复位状态并触发失败回调 */
+	handleFail(error) {
+		this.resetState();
+		this.onFail?.(error);
+	}
+	enqueueTask(task) {
+		this.tasks.push(task);
+	}
+	/**
+	* 在刷新 token 后执行任务，防止并发刷新token
+	* @param task 需要执行的任务
+	* @returns 任务的返回值
+	*/
+	async runAfterRefresh(task) {
+		if (this.isCooldownExpired()) this.resetAttempts();
+		if (this.attemptCount >= this.maxAttempts) {
+			const error = /* @__PURE__ */ new Error("刷新token次数已达上限");
+			this.handleFail(error);
+			throw error;
+		}
+		if (!this.refreshing) {
+			this.refreshing = true;
+			try {
+				this.markAttempt();
+				await this.refresh();
+				this.runTasks();
+				this.refreshing = false;
+				return await task();
+			} catch (error) {
+				this.handleFail(error);
+				throw error;
+			}
+		}
+		return new Promise((resolve) => {
+			this.enqueueTask(() => resolve(task()));
+		});
+	}
+};
+//#endregion
+//#region src/service-provider/index.ts
+var ServiceProvider = class {
+	cache = /* @__PURE__ */ new Map();
+	factories = /* @__PURE__ */ new Map();
+	defaultArgs = [];
+	constructor(defaultArgs = []) {
+		this.defaultArgs = defaultArgs;
+	}
+	register(clazz, factory) {
+		this.factories.set(clazz, factory);
+	}
+	get(clazz) {
+		if (this.cache.has(clazz)) return this.cache.get(clazz);
+		let instance;
+		if (this.factories.has(clazz)) instance = this.factories.get(clazz)(this);
+		else instance = new clazz(...this.defaultArgs);
+		this.cache.set(clazz, instance);
+		return instance;
+	}
+	clear() {
+		this.cache.clear();
+	}
+};
+//#endregion
+export { Forest, SSEConnection, ServiceProvider, TokenRefreshManager, buildTree, copyToClipboard, createSSEConnection, invertRecord, joinPaths, parseSSEBlock };
+
+//# sourceMappingURL=xkit-utils.js.map

package/dist/xkit-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xkit-utils.js","names":[],"sources":["../src/clipboard/index.ts","../src/record/index.ts","../src/path/index.ts","../src/tree/build-tree.ts","../src/tree/forest.ts","../src/sse/parse-sse-block.ts","../src/sse/sse-connection.ts","../src/token-refresh/index.ts","../src/service-provider/index.ts"],"sourcesContent":["/**\n * 将纯文本写入系统剪贴板。\n *\n * 优先使用 Clipboard API（`navigator.clipboard.writeText`）；在不可用或失败时\n *（非安全上下文、权限被拒等）回退到 `document.execCommand('copy')` + 离屏 textarea，\n * 以兼容旧浏览器与受限环境。\n *\n * 在非浏览器环境（如 SSR、无 DOM 的 Worker）中安全返回 `false`，不抛错。\n */\nexport const copyToClipboard = async (text: string): Promise<boolean> => {\n  if (typeof window === \"undefined\" || typeof document === \"undefined\") {\n    return false;\n  }\n\n  if (navigator.clipboard?.writeText) {\n    try {\n      await navigator.clipboard.writeText(text);\n      return true;\n    } catch (err) {\n      console.error(\"navigator.clipboard.writeText failed\", err);\n    }\n  }\n\n  const textArea = document.createElement(\"textarea\");\n  textArea.value = text;\n  textArea.readOnly = true;\n  textArea.style.position = \"fixed\";\n  textArea.style.left = \"-9999px\";\n  textArea.style.top = \"-9999px\";\n  textArea.style.opacity = \"0\";\n\n  document.body.appendChild(textArea);\n  textArea.focus();\n  textArea.select();\n\n  try {\n    return document.execCommand(\"copy\");\n  } catch (err) {\n    console.error(\"Fallback: copyToClipboard failed\", err);\n    return false;\n  } finally {\n    textArea.remove();\n  }\n};\n","/**\n * 将 `Record<string, string>` 的键值对调：key → value 变为 value → key。\n * 若多个 key 对应同一 value，后者覆盖前者（与 `Object.fromEntries` 行为一致）。\n * @param obj 键值对对象（value 须为 string，且通常唯一）\n * @returns 反向映射对象，类型可推断\n */\nexport function invertRecord<\n  T extends Record<string, string>,\n>(\n  obj: T,\n): { [V in T[keyof T]]: { [K in keyof T]: T[K] extends V ? K : never }[keyof T] } {\n  return Object.fromEntries(\n    Object.entries(obj).map(([k, v]) => [v, k]),\n  ) as { [V in T[keyof T]]: { [K in keyof T]: T[K] extends V ? K : never }[keyof T] };\n}\n","/**\n * 拼接路径。去除每个路径首尾的斜杠，并确保路径之间只有一个斜杠\n * @param paths 路径\n * @returns 拼接后的路径\n */\nexport function joinPaths(...paths: string[]): string {\n  return paths\n    .map((path) => path.replace(/(^\\/+|\\/+$)/g, \"\"))\n    .filter(Boolean)\n    .join(\"/\");\n}\n","import type { BuildTreeConfig, TreeNode } from \"./type\";\n\n/**\n * 将平铺列表转为森林（多根树）。\n * 1. 对每一项做浅拷贝后再挂 `children`，**不修改**入参 `list` 中的对象。\n * 2. 浅拷贝：嵌套对象/数组仍与平铺项中的引用相同；仅 `children` 树结构是新建的。\n */\nexport const buildTree = <T extends Record<string, any>>(\n  list: T[],\n  { idField = \"id\", parentIdField = \"pId\" }: BuildTreeConfig = {},\n): TreeNode<T>[] => {\n  const idToNode = new Map<PropertyKey, TreeNode<T>>();\n\n  for (const elem of list) {\n    idToNode.set(elem[idField] as PropertyKey, { ...elem } as TreeNode<T>);\n  }\n\n  for (const elem of list) {\n    const node = idToNode.get(elem[idField] as PropertyKey);\n    const parent = idToNode.get(elem[parentIdField] as PropertyKey);\n    if (node && parent) {\n      if (!parent.children) parent.children = [];\n      parent.children.push(node);\n    }\n  }\n\n  return list\n    .filter((item) => !idToNode.get(item[parentIdField] as PropertyKey))\n    .map((item) => idToNode.get(item[idField] as PropertyKey))\n    .filter((n): n is TreeNode<T> => n != null);\n};\n","import type { TreeNode } from \"./type\";\n\n/** 多根树的深度优先遍历（前序，子节点从左到右）。 */\nexport class Forest<T extends Record<string, unknown> = Record<string, unknown>> {\n  constructor(readonly trees: TreeNode<T>[]) {}\n\n  *[Symbol.iterator](): Generator<TreeNode<T>, void, undefined> {\n    const { trees } = this;\n    for (let i = trees.length - 1; i >= 0; i--) {\n      const stack: TreeNode<T>[] = [trees[i]!];\n      while (stack.length > 0) {\n        const current = stack.pop();\n        if (current === undefined) continue;\n        yield current;\n        if (current.children && current.children.length > 0) {\n          for (let j = current.children.length - 1; j >= 0; j--) {\n            stack.push(current.children[j]!);\n          }\n        }\n      }\n    }\n  }\n\n  /** 根节点数组（与构造时传入的引用相同）。 */\n  toArray(): TreeNode<T>[] {\n    return this.trees;\n  }\n}\n","import type { SSEMessage } from \"./type\";\n\n/**\n * 解析单个 SSE 事件块（不含块之间的空行分隔）。\n */\nexport function parseSSEBlock(block: string): SSEMessage | null {\n  const message: SSEMessage = {};\n  const lines = block.split(\"\\n\");\n\n  for (const line of lines) {\n    if (line.startsWith(\"data:\")) {\n      const dataPart = line.replace(/^data:\\s*/, \"\");\n      message.data = (message.data ?? \"\") + dataPart + \"\\n\";\n    } else if (line.startsWith(\"event:\")) {\n      message.event = line.replace(/^event:\\s*/, \"\").trim();\n    } else if (line.startsWith(\"id:\")) {\n      message.id = line.replace(/^id:\\s*/, \"\").trim();\n    } else if (line.startsWith(\"retry:\")) {\n      const retry = parseInt(line.replace(/^retry:\\s*/, \"\").trim(), 10);\n      if (!isNaN(retry)) message.retry = retry;\n    }\n  }\n\n  if (message.data) message.data = message.data.trim();\n  if (!message.data && !message.event) return null;\n  return message;\n}\n","import { parseSSEBlock } from \"./parse-sse-block\";\nimport type { SSEMessage, SSEOptions } from \"./type\";\n\nexport class SSEConnection {\n  private options: SSEOptions;\n  private retryCount = 0;\n  private isConnecting = false;\n  private isConnected = false;\n  private abortController?: AbortController;\n\n  constructor(options: SSEOptions) {\n    this.options = {\n      retryAttempts: 3,\n      retryDelay: 1000,\n      ...options,\n    };\n  }\n\n  setHeader(key: string, value: string) {\n    if (!this.options.headers) this.options.headers = {};\n    this.options.headers[key] = value;\n  }\n\n  async connect(): Promise<void> {\n    if (this.isConnecting || this.isConnected) {\n      return;\n    }\n\n    this.isConnecting = true;\n    this.abortController = new AbortController();\n\n    try {\n      const headers: Record<string, string> = {\n        Accept: \"text/event-stream\",\n        \"Cache-Control\": \"no-cache\",\n        ...this.options.headers,\n      };\n\n      if (this.options.body) {\n        headers[\"Content-Type\"] = \"application/json\";\n      }\n\n      const response = await fetch(this.options.url, {\n        method: this.options.method || \"GET\",\n        headers,\n        body: this.options.body ? JSON.stringify(this.options.body) : undefined,\n        signal: this.abortController.signal,\n      });\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      if (!response.body) {\n        throw new Error(\"Response body is null\");\n      }\n\n      this.isConnected = true;\n      this.isConnecting = false;\n      this.retryCount = 0;\n      this.options.onOpen?.();\n\n      await this.processStream(response.body);\n    } catch (error) {\n      this.isConnecting = false;\n      this.isConnected = false;\n      if (error instanceof Error) {\n        if (error.name === \"AbortError\") {\n          return;\n        }\n        if (error.message.includes(\"401\")) {\n          this.options.onError?.(error);\n          return;\n        }\n      }\n\n      this.options.onError?.(error as Error);\n\n      if (this.retryCount < this.options.retryAttempts!) {\n        this.retryCount++;\n        console.log(\n          `SSE 连接失败，${this.options.retryDelay}ms 后重试 (${this.retryCount}/${this.options.retryAttempts})`,\n        );\n\n        setTimeout(() => {\n          void this.connect();\n        }, this.options.retryDelay);\n      } else {\n        console.error(\"SSE 连接失败，已达到最大重试次数\");\n      }\n    }\n  }\n\n  private handleMessage(message: SSEMessage | null) {\n    if (!message) return;\n    if (message.event === \"exception\" || message.event === \"error\") {\n      try {\n        const errorObj = JSON.parse(message.data || \"{}\");\n        this.options.onException?.(errorObj);\n      } catch {\n        this.options.onException?.({ error: message.data });\n      }\n    } else {\n      this.options.onMessage?.(message);\n    }\n  }\n\n  private async processStream(stream: ReadableStream<Uint8Array>): Promise<void> {\n    const reader = stream.getReader();\n    const decoder = new TextDecoder(\"utf-8\");\n    let buffer = \"\";\n\n    try {\n      while (true) {\n        const { value, done } = await reader.read();\n        if (done) break;\n\n        const chunk = decoder.decode(value, { stream: true });\n        buffer += chunk;\n\n        const parts = buffer.split(\"\\n\\n\");\n        buffer = parts.pop() || \"\";\n        for (const part of parts) {\n          this.handleMessage(parseSSEBlock(part));\n        }\n      }\n\n      if (buffer.trim()) {\n        this.handleMessage(parseSSEBlock(buffer));\n      }\n    } finally {\n      reader.releaseLock();\n      this.isConnected = false;\n      this.options.onClose?.();\n    }\n  }\n\n  disconnect(): void {\n    this.isConnected = false;\n    this.isConnecting = false;\n    this.abortController?.abort();\n  }\n\n  get isActive(): boolean {\n    return this.isConnected || this.isConnecting;\n  }\n}\n\nexport function createSSEConnection(options: SSEOptions): SSEConnection {\n  return new SSEConnection(options);\n}\n","/**\n * 刷新 token 的回调函数，如果刷新失败，请抛出异常\n */\ntype RefreshHandler = () => Promise<void>;\n\nexport type RefreshOptions = {\n  /**\n   * 刷新 token 的回调函数，如果刷新失败，请抛出异常\n   */\n  refresh: RefreshHandler;\n  /**\n   * 最大刷新次数\n   */\n  maxAttempts?: number;\n  /**\n   * 冷却时间（分钟）\n   */\n  cooldownMinutes?: number;\n  /**\n   * 刷新失败回调\n   */\n  onFail?: (error?: unknown) => void;\n};\n\nexport class TokenRefreshManager {\n  private readonly refresh: RefreshHandler;\n  private readonly maxAttempts: number;\n  private readonly cooldownMinutes: number;\n  private readonly onFail?: (error?: unknown) => void;\n\n  private tasks: Array<() => void> = [];\n  private refreshing = false;\n  private attemptCount = 0;\n  private lastRefreshAt = 0;\n\n  constructor(options: RefreshOptions) {\n    this.refresh = options.refresh;\n    this.maxAttempts = options.maxAttempts ?? 3;\n    this.cooldownMinutes = options.cooldownMinutes ?? 5;\n    this.onFail = options.onFail;\n  }\n\n  private isCooldownExpired(): boolean {\n    if (this.lastRefreshAt === 0) {\n      return true;\n    }\n    const cooldownMs = this.cooldownMinutes * 60 * 1000;\n    return Date.now() - this.lastRefreshAt > cooldownMs;\n  }\n\n  private markAttempt(): void {\n    this.attemptCount += 1;\n    this.lastRefreshAt = Date.now();\n    console.log(\"刷新次数=>\", this.attemptCount);\n  }\n\n  private clearTasks(): void {\n    this.tasks = [];\n  }\n\n  private runTasks(): void {\n    this.tasks.forEach((task) => task());\n    this.tasks = [];\n  }\n\n  private resetAttempts(): void {\n    this.attemptCount = 0;\n    this.lastRefreshAt = 0;\n  }\n\n  /** 复位当前实例内部的刷新队列与计数 */\n  resetState(): void {\n    this.clearTasks();\n    this.resetAttempts();\n    this.refreshing = false;\n  }\n\n  /** 统一处理失败收口：复位状态并触发失败回调 */\n  handleFail(error?: unknown): void {\n    this.resetState();\n    this.onFail?.(error);\n  }\n\n  enqueueTask(task: () => void): void {\n    this.tasks.push(task);\n  }\n\n  /**\n   * 在刷新 token 后执行任务，防止并发刷新token\n   * @param task 需要执行的任务\n   * @returns 任务的返回值\n   */\n  async runAfterRefresh<T>(task: () => Promise<T> | T): Promise<T> {\n    if (this.isCooldownExpired()) {\n      this.resetAttempts();\n    }\n\n    if (this.attemptCount >= this.maxAttempts) {\n      const error = new Error(\"刷新token次数已达上限\");\n      this.handleFail(error);\n      throw error;\n    }\n    if (!this.refreshing) {\n      this.refreshing = true;\n      try {\n        this.markAttempt();\n        await this.refresh();\n        this.runTasks();\n        this.refreshing = false;\n        return await task();\n      } catch (error) {\n        this.handleFail(error);\n        throw error;\n      }\n    }\n    return new Promise<T>((resolve) => {\n      this.enqueueTask(() => resolve(task()));\n    });\n  }\n}\n\n","export type Constructor<T> = new (...args: any[]) => T\n\nexport class ServiceProvider {\n  private cache = new Map<any, any>()\n  private factories = new Map<any, (provider: ServiceProvider) => any>()\n  private defaultArgs: any[] = []\n\n  constructor(defaultArgs: any[] = []) {\n    this.defaultArgs = defaultArgs\n  }\n\n  register<T>(clazz: Constructor<T>, factory: (provider: ServiceProvider) => T) {\n    this.factories.set(clazz, factory)\n  }\n\n  get<T>(clazz: Constructor<T>): T {\n    if (this.cache.has(clazz)) {\n      return this.cache.get(clazz)\n    }\n\n    let instance: T\n    if (this.factories.has(clazz)) {\n      instance = this.factories.get(clazz)!(this)\n    } else {\n      instance = new clazz(...this.defaultArgs)\n    }\n\n    this.cache.set(clazz, instance)\n    return instance\n  }\n\n  clear() {\n    this.cache.clear()\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "xkit-utils",
+  "version": "2.0.0-alpha.0",
+  "description": "Daily tools for web development",
+  "license": "MIT",
+  "type": "module",
+  "private": false,
+  "main": "./dist/xkit-utils.js",
+  "module": "./dist/xkit-utils.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/xkit-utils.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.1",
+    "happy-dom": "^20.0.2",
+    "typescript": "~5.6.3",
+    "vite": "^8.0.8",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.1.1"
+  },
+  "scripts": {
+    "build": "vite build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  }
+}