@nickyzj2023/utils 1.0.75 → 1.0.77

package/README.md

@@ -1,3 +1,5 @@
+# utils
+
 男生自用全新前端工具库，0依赖
 
 ## 安装到你的项目里
@@ -21,9 +23,11 @@ import { fetcher, to } from "@nickyzj2023/utils";
 
 const api = fetcher("https://api.example.com");
 
-const [error, data] = await to(api.get<Blog>("/blogs/hello-world"));
+const [error, data] = await to(
+  api.get<Blog>("/blogs/hello-world")
+);
 if (error) {
-  console.error(error);
+  console.log(error);
   return;
 }
 

package/dist/index.d.mts

@@ -1,9 +1,29 @@
-//#region src/ai/chatCompletions/types.d.ts
-declare namespace ChatCompletions {
+//#region src/ai/types.d.ts
+declare namespace AI {
   type Model = {
-    /** 模型名称（如果不传，会尝试从 /models 读取模型） */model?: string; /** API 基础地址 */
-    baseUrl: string; /** API 密钥（本地模型可不传） */
-    apiKey?: string;
+    baseUrl: string; /** 不传则自动使用{baseUrl}/models接口的第一个模型 */
+    model?: string;
+    apiKey?: string; /** POST /chat/completions时注入自定义请求体 */
+    customBody?: Record<string, any>;
+    /**
+     * 模型支持的消息输入类型
+     * @default ["text"]
+     * @remarks 会在调用chatCompletions前校验上下文，含有不支持的输入时抑制请求 */
+    inputs?: InputType[];
+    /**
+     * 模型的最大上下文（输入+输出）
+     * @default 128000
+     * @remarks 会在调用chatCompletions后智能调用compact（如当前上下文>最大上下文*80%时），可以在chatCompletions里自定义compact执行时机 */
+    context?: number;
+  };
+  type InputType = "text" | "image" | "video" | "audio" | "file";
+  type Message = {
+    role: "system" | "user" | "assistant" | "tool" | "function"; /** OpenRouter的思考内容字段，其他供应商的会尽可能合并到该字段内 */
+    reasoning?: string | null;
+    content: string | ContentPart[];
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+    [key: string]: unknown;
   };
   type TextContent = {
     type: "text";
@@ -18,7 +38,7 @@ declare namespace ChatCompletions {
   type AudioContent = {
     type: "input_audio";
     input_audio: {
-      /** 使用公网可访问的音频文件 URL */url?: string; /** 使用 base64 */
+      /** 使用公网可访问的音频链接 */url?: string; /** 使用base64 */
       data?: string;
       format: string;
     };
@@ -30,22 +50,22 @@ declare namespace ChatCompletions {
     };
   };
   type ContentPart = TextContent | ImageContent | AudioContent | VideoContent;
-  type Message = {
-    role: "system" | "user" | "assistant" | "tool" | "function"; /** 字节的思考字段 */
-    reasoning_content?: string | null; /** OpenRouter的思考字段 */
-    reasoning?: string | null;
-    content: string | ContentPart[];
-    name?: string;
-    tool_calls?: ToolCall[];
-    tool_call_id?: string;
-  };
   type ToolDefinition = {
     type: "function";
     function: {
       name: string;
-      description?: string;
-      parameters?: Record<string, any>;
+      description: string;
+      parameters: {
+        type: "object";
+        properties: Record<string, {
+          type: string;
+          description?: string; /** 在此处设置的required，发出请求前会自动提到外面去 */
+          required?: boolean;
+        }>;
+        required?: string[];
+      };
     };
+    handler: (...args: any) => any;
   };
   type ToolCall = {
     id: string;
@@ -55,44 +75,42 @@ declare namespace ChatCompletions {
       arguments: string;
     };
   };
-  type ExtraArgs = {
-    messages?: ChatCompletions.Message[];
-    [key: string]: any;
-  };
-  type ToolHandler = (args: any, extraArgs?: ExtraArgs) => any | Promise<any>;
-  type ToolHandlers = Record<string, ChatCompletions.ToolHandler>;
-  type Usage = {
-    prompt_tokens: number;
-    completion_tokens: number;
-    total_tokens: number;
+}
+//#endregion
+//#region src/ai/chatCompletions/types.d.ts
+declare namespace ChatCompletions {
+  /** chatCompletions的第三个参数 */
+  type Options = {
+    stream?: boolean;
+    tools?: AI.ToolDefinition[]; /** 工具运行结束后（无论成功失败）的回调，可用于打印日志 */
+    onToolHandled?: (name: string, args: string, result: any) => void;
   };
-  /** 请求非流式 /chat/completions 的响应结果 */
-  type Response = {
+  /** 非流式POST /chat/completions的响应结果 */
+  type NonStreamResponse = {
     id: string;
     object: "chat.completion";
     created: number;
     model: string;
     choices: Array<{
       index: number;
-      message: Message;
+      message: AI.Message;
       finish_reason: "stop" | "length" | "tool_calls" | "content_filter" | null;
     }>;
     usage: Usage;
     system_fingerprint?: string;
   };
-  type ExtraBody = {
-    /** 工具列表 */tools?: ToolDefinition[]; /** 工具调用函数表，key 为工具名，value 为函数 */
-    toolHandlers?: ToolHandlers; /** 是否使用流式传输，启用后函数返回异步迭代器 */
-    stream?: boolean; /** 其他额外参数 */
-    [key: string]: any;
-  };
-  /** 调用 chatCompletions 返回的结果，流式/非流式通用 */
-  type Result = {
-    /** 模型的最终回复内容（多模态时取所有 text 拼接） */content: string; /** Token 消耗情况 */
+  /** 调用chatCompletions返回的结果，流式/非流式通用 */
+  type NonStreamResult = {
+    /** 模型的最终回复内容（多模态时取所有text拼接） */content: string; /** Token 消耗情况 */
     usage: Usage; /** 原始响应中的其他字段 */
     [key: string]: any;
   };
-  /** 流式响应中的单个 SSE 数据块（OpenAI 原始格式） */
+  type Usage = {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+  };
+  /** 流式响应中的单个SSE数据块（OpenAI原始格式） */
   type StreamResponse = {
     id: string;
     object: "chat.completion.chunk";
@@ -100,28 +118,18 @@ declare namespace ChatCompletions {
     model: string;
     choices: Array<{
       index: number;
-      delta: {
-        role?: Message["role"];
-        content?: string | null; /** 字节的思考字段 */
-        reasoning_content?: string | null; /** OpenRouter的思考字段 */
-        reasoning?: string | null;
+      delta: Pick<AI.Message, "role" | "reasoning" | "content"> & {
         tool_calls?: Array<{
           index: number;
-          id?: string;
-          type?: "function";
-          function?: {
-            name?: string;
-            arguments?: string;
-          };
-        }>;
+        } & Partial<AI.ToolCall>>;
       };
       finish_reason: "stop" | "length" | "tool_calls" | "content_filter" | null;
     }>;
     usage?: Usage;
   };
-  /** 流式调用 chatCompletions 时迭代器产出的数据块 */
+  /** 流式调用chatCompletions时迭代器产出的数据块 */
   type StreamChunk = {
-    /** 模型流式返回的思考内容增量（仅在生成过程中出现） */reasoningContent?: string; /** 模型流式返回的内容增量（仅在生成过程中出现） */
+    /** 模型流式返回的思考内容增量（仅在生成过程中出现） */reasoning?: string; /** 模型流式返回的内容增量（仅在生成过程中出现） */
     content?: string; /** Token 消耗情况（仅在最后一帧出现） */
     usage?: Usage;
   };
@@ -129,22 +137,23 @@ declare namespace ChatCompletions {
 //#endregion
 //#region src/ai/chatCompletions/index.d.ts
 /**
- * 兼容 OpenAI API 的聊天补全函数
+ * 兼容OpenAI API的聊天补全函数
  * - 自动处理工具调用
- * - 同时支持普通响应和流式响应
+ * - 支持普通/流式响应
  *
- * @param model 模型配置，包含 model、baseUrl、apiKey
- * @param messages OpenAI API 兼容的消息数组
- * @param extraBody 可选的额外参数，如 tools、toolHandlers、temperature、stream 等
- * @returns 普通模式下返回 `{ content, usage, ... }`；`stream: true` 时返回异步迭代器
+ * @param model 模型配置，包含model、baseUrl、apiKey
+ * @param messages OpenAI API兼容的消息数组
+ * @param extraBody 可选的额外参数，如tools、temperature、stream等
+ * @returns 普通模式下返回`{ content, usage, ... }`；`stream: true`时返回异步迭代器
  *
  * @example
  * // 最简调用
- * // 未填写模型名，会自动使用/v1/models的第一个模型
- * const { content, usage } = await chatCompletions(
+ * // 未填写模型名，会自动使用/v1/models返回的第一个模型
+ * const { reasoning, content, usage } = await chatCompletions(
  *   { baseUrl: "http://127.0.0.1:11434/v1" },
  *   [{ role: "user", content: "你好" }],
  * );
+ * console.log(reasoning); // "The user said..."
  * console.log(content); // "你好！有什么我可以帮你的吗？"
  * console.log(usage);   // { prompt_tokens: 13, completion_tokens: 9, total_tokens: 22 }
  *
@@ -160,11 +169,9 @@ declare namespace ChatCompletions {
  *         name: "getWeather",
  *         description: "查询城市天气情况",
  *         parameters: { type: "object", properties: { city: { type: "string" } } },
+ *         handler: (args) => `${args.city}今日晴转多云，25°C`,
  *       },
  *     }],
- *     toolHandlers: {
- *       getWeather: (args) => `${args.city}今日晴转多云，25°C`,
- *     },
  *   },
  * );
  *
@@ -183,14 +190,26 @@ declare namespace ChatCompletions {
  *   }
  * }
  */
-declare function chatCompletions(model: ChatCompletions.Model, messages: ChatCompletions.Message[], extraBody: ChatCompletions.ExtraBody & {
+declare function chatCompletions(model: AI.Model, messages: AI.Message[], options: ChatCompletions.Options & {
   stream: true;
 }): Promise<AsyncGenerator<ChatCompletions.StreamChunk>>;
-declare function chatCompletions(model: ChatCompletions.Model, messages: ChatCompletions.Message[], extraBody?: ChatCompletions.ExtraBody): Promise<ChatCompletions.Result>;
+declare function chatCompletions(model: AI.Model, messages: AI.Message[], options?: ChatCompletions.Options): Promise<ChatCompletions.NonStreamResult>;
+//#endregion
+//#region src/ai/helper.d.ts
 /**
- * 辅助定义一个 chatCompletions 支持的模型配置
+ * 辅助定义一个POST /chat/completions支持的model参数
+ * @remarks 只有baseUrl字段是必须的，其他字段请查看AI.Model类型
  */
-declare const defineModel: (config: ChatCompletions.Model) => ChatCompletions.Model;
+declare const defineModel: (config: AI.Model) => AI.Model;
+/**
+ * 辅助定义一个POST /chat/completions支持的tools中的子元素
+ * @param handler 在AI请求调用工具时用到
+ */
+declare const defineTool: (name: AI.ToolDefinition["function"]["name"], description: AI.ToolDefinition["function"]["description"], properties: AI.ToolDefinition["function"]["parameters"]["properties"], handler: AI.ToolDefinition["handler"]) => AI.ToolDefinition;
+/**
+ * 从GET /models获取模型名称
+ */
+declare const getModelName: (baseUrl: string) => Promise<string>;
 //#endregion
 //#region src/dom/logger.d.ts
 /**
@@ -348,11 +367,15 @@ type Primitive = number | string | boolean | symbol | bigint | undefined | null;
 declare const isPrimitive: (value: any) => value is Primitive;
 //#endregion
 //#region src/network/fetcher.d.ts
-type RequestInit = globalThis.RequestInit & {
+type RequestInit = Omit<globalThis.RequestInit, "body"> & {
   /**
    * searchParams 查询参数对象
    */
   params?: Record<string, any>;
+  /**
+   * 请求体支持任意类型
+   */
+  body?: any;
   /**
    * 响应解析器，默认的解析方法为 response.json()
    */
@@ -818,4 +841,4 @@ declare const sleep: (time?: number) => Promise<unknown>;
  */
 declare const throttle: <T extends (...args: any[]) => any>(fn: T, delay?: number) => (this: any, ...args: Parameters<T>) => void;
 //#endregion
-export { CamelToSnake, Capitalize, type ChatCompletions, Decapitalize, DeepMapKeys, DeepMapValues, ImageCompressionOptions, LockQueue, LoggerOptions, Primitive, RequestInit, SetTtl, SnakeToCamel, camelToSnake, capitalize, chatCompletions, compactStr, debounce, decapitalize, defineModel, extractErrorMessage, fetcher, getRealURL, imageUrlToBase64, isNil, isObject, isPrimitive, logger, loopUntil, mapKeys, mapValues, mergeObjects, omit, omitBy, parseSSE, pick, pickBy, qs, randomInt, sleep, snakeToCamel, throttle, to, withCache };
+export { AI, CamelToSnake, Capitalize, type ChatCompletions, Decapitalize, DeepMapKeys, DeepMapValues, ImageCompressionOptions, LockQueue, LoggerOptions, Primitive, RequestInit, SetTtl, SnakeToCamel, camelToSnake, capitalize, chatCompletions, compactStr, debounce, decapitalize, defineModel, defineTool, extractErrorMessage, fetcher, getModelName, getRealURL, imageUrlToBase64, isNil, isObject, isPrimitive, logger, loopUntil, mapKeys, mapValues, mergeObjects, omit, omitBy, parseSSE, pick, pickBy, qs, randomInt, sleep, snakeToCamel, throttle, to, withCache };

package/dist/index.mjs

@@ -2,6 +2,6 @@ const e=e=>e==null,t=e=>e?.constructor===Object,n=e=>e==null||typeof e!=`object`
 `)),a=r?a.replace(/\r?\n/g,` `):a.replace(/\r?\n/g,`\\n`),a=a.replace(/\s+/g,` `).trim(),n>0&&a.length>n?`${a.slice(0,n)}...`:a},h=e=>{if(e instanceof Error)return e.message;if(typeof e==`string`)return e;if(t(e)){let t=e.message||e.msg;if(t)return t;for(let t of Object.values(e)){let e=h(t);if(e)return e}}return JSON.stringify(e,null,2)},g={parse:e=>{let t=new URLSearchParams(e),n={};for(let[e,r]of t)Number.isNaN(Number(r))?n[e]=r:n[e]=Number(r);return n},stringify:(e,t)=>{let{addQueryPrefix:n=!1}=t??{},r=new URLSearchParams(e).toString();return r?n?`?${r}`:r:``}},_=(n=``,r={})=>{let i=async(i,o={})=>{let s=new URL(n?`${n}${i}`:i),{params:c,parser:l,...u}=a(r,o);t(c)&&Object.entries(c).forEach(([t,n])=>{e(n)||s.searchParams.append(t,n.toString())}),(t(u.body)||Array.isArray(u.body))&&(u.body=JSON.stringify(u.body),u.headers={...u.headers,"Content-Type":`application/json`});let d=await fetch(s,u);if(!d.ok){let e=d.statusText||await d.text();try{e=h(JSON.parse(e))}catch{}throw Error(e)}return await(l?.(d)??d.json())};return{get:(e,t)=>i(e,{...t,method:`GET`}),post:(e,t,n)=>i(e,{...n,method:`POST`,body:t}),put:(e,t,n)=>i(e,{...n,method:`PUT`,body:t}),delete:(e,t)=>i(e,{...t,method:`DELETE`})}},v=async e=>{try{return[null,await e]}catch(e){return[e,void 0]}},y=async e=>{let[t,n]=await v(fetch(e,{method:`HEAD`,redirect:`manual`}));return t?e:n.headers.get(`location`)||e},b=e=>{let t=new Uint8Array(e),n=``;for(let e=0;e<t.byteLength;e++)n+=String.fromCharCode(t[e]);return btoa(n)},x=async(e,t={})=>{let{quality:n=.92,compressor:r,fetcher:i=fetch}=t;if(!e.startsWith(`http`))throw Error(`图片地址必须以http或https开头`);let a=await i(e);if(!a.ok)throw Error(`获取图片失败: ${a.statusText}`);let o=a.headers.get(`Content-Type`)||`image/jpeg`,s=await a.arrayBuffer();if(o!==`image/jpeg`&&o!==`image/png`)return`data:${o};base64,${b(s)}`;if(r)return await r(s,o,n);if(typeof OffscreenCanvas<`u`){let e=null;try{let t=new Blob([s],{type:o});e=await createImageBitmap(t);let r=new OffscreenCanvas(e.width,e.height),i=r.getContext(`2d`);if(!i)throw Error(`无法获取 OffscreenCanvas context`);return i.drawImage(e,0,0),e.close(),e=null,`data:${o};base64,${b(await(await r.convertToBlob({type:o,quality:n})).arrayBuffer())}`}catch{return e?.close(),`data:${o};base64,${b(s)}`}}return`data:${o};base64,${b(s)}`};async function*S(e){let t=e.body?.getReader();if(!t)return;let n=new TextDecoder,r=``;try{for(;;){let{value:e,done:i}=await t.read();if(i)break;r+=n.decode(e,{stream:!0});let a=r.split(`
 
 `);r=a.pop()||``;for(let e of a){let t=e.split(`
-`);for(let e of t){if(!e.startsWith(`data:`))continue;let t=e.replace(/^data:\s*/,``).trim();try{yield JSON.parse(t)}catch{yield t}}}}}finally{t.releaseLock()}}const C=async e=>{let t=(await e.get(`/models`)).data[0]?.id;if(!t)throw Error(`无法从 /models 获取模型名称`);return t},w=async(e,t,n)=>{let r=t[e.function.name];if(!r)return`没有找到工具“${e.function.name}”的处理函数`;try{let t=await r(JSON.parse(e.function.arguments),n);return typeof t==`string`?t:JSON.stringify(t)}catch(t){if(t instanceof Error&&t.name===e.function.name)throw t;return`工具“${e.function.name}”处理失败：${h(t)}`}},T=e=>typeof e==`string`?e:e.filter(e=>e.type===`text`).map(e=>e.text).join(`
-`),E=async(e,t,n,r)=>{let{baseUrl:i,apiKey:a=``,model:o}=e,s=_(i,{headers:{Authorization:`Bearer ${a}`}}),c={model:o??await C(s),messages:t,...r};for(;;){let{choices:e,usage:r,...i}=await s.post(`/chat/completions`,c),{message:a}=e?.[0]??{};if(!a)throw Error(`模型没有回复任何内容`);t.push(a);let{content:o=``,tool_calls:l=[],...u}=a,d=u?.reasoning_content||u?.reasoning;if(l.length>0&&Object.keys(n).length>0){for(let e of l){let r=await w(e,n,{messages:t});t.push({role:`tool`,content:r,tool_call_id:e.id})}continue}return{content:T(o),reasoningContent:d,usage:r,...i,...u}}},D=async function*(e,t,n,r){let{baseUrl:i,apiKey:a=``,model:o}=e,s=_(i,{headers:{Authorization:`Bearer ${a}`}}),c={model:o??await C(s),messages:t,stream:!0,...r};for(;;){let e=new Map,r=``,i=null,a,o=await s.post(`/chat/completions`,c,{parser:async e=>e});for await(let t of S(o)){t.usage&&(a=t.usage);let n=t.choices?.[0];if(!n)continue;let{delta:o}=n,{content:s,tool_calls:c}=o,l=o.reasoning_content||o.reasoning;if(l&&(yield{reasoningContent:l}),s&&(r+=s,yield{content:s}),c)for(let t of c){let n=e.get(t.index)??{id:``,type:`function`,function:{name:``,arguments:``}};t.id&&(n.id=t.id),t.function?.name&&(n.function.name+=t.function.name),t.function?.arguments&&(n.function.arguments+=t.function.arguments),e.set(t.index,n)}n.finish_reason&&(i=n.finish_reason)}let l=Array.from(e.values());if(i!==`tool_calls`&&l.length>0&&Object.keys(n).length>0){t.push({role:`assistant`,content:r,tool_calls:l});for(let e of l){let r=await w(e,n);t.push({role:`tool`,content:r,tool_call_id:e.id})}continue}t.push({role:`assistant`,content:r}),a&&(yield{usage:a});break}};async function O(e,t,n={}){let{stream:r,toolHandlers:i={},...a}=n;return(r?D:E)(e,t,i,a)}const k=e=>e;function A(e={},t=0){let{withTime:n=!0,withFileName:r=!0}=e;return(...e)=>{let i=[];if(n&&i.push(`[${new Date().toLocaleTimeString()}]`),r){let{stack:e}=Error(),n=(e?.split(`
-`)[2+t]?.trim())?.match(/^at\s+(?:.*?\s*\()?(.*?):(\d+)(?::(\d+))?\)?/);if(n?.[1]){let e=n[1].split(/[/\\]/).pop();i.push(`[${e}:${n[2]}]`)}}i.push(...e),console.log(...i)}}function j(e,...n){if(t(e)&&(`withTime`in e||`withFileName`in e))return A(e,0);A({},1)(e,...n)}const M=async(e,t)=>{let{maxRetries:n=5,shouldStop:r}=t??{},i;for(let t=0;t<n;t++)if(i=await e(t),r?.(i)===!0)return i;if(!r)return i;throw Error(`超过了最大循环次数（${n}）且未满足停止执行条件`)},N=(e,t=-1)=>{let n=new Map,r=(...r)=>{let i=JSON.stringify(r),a=Date.now(),o=n.get(i);if(o&&a<o.expiresAt)return o.value;let s=t===-1?1/0:a+t*1e3,c=e.apply({setTtl:e=>{s=a+e*1e3}},r);if(c instanceof Promise){let e=c.then(e=>(n.set(i,{value:e,expiresAt:s}),e));return n.set(i,{value:e,expiresAt:s}),e}return n.set(i,{value:c,expiresAt:s}),c};return r.clear=()=>n.clear(),r.updateTtl=e=>{t=e;let r=Date.now(),i=r+e*1e3;for(let[e,t]of n.entries())t.expiresAt>r&&(t.expiresAt=i,n.set(e,t))},r},P=(e,t)=>Math.floor(Math.random()*(t-e+1))+e,F=(e,t=300)=>{let n=null;return(...r)=>{n&&clearTimeout(n),n=setTimeout(()=>{e(...r)},t)}};var I=class{queue;constructor(){this.queue=Promise.resolve()}waitInQueue(){let e,t=new Promise(t=>{e=t}),n=this.queue.then(()=>e);return this.queue=t,n}};const L=async(e=150)=>new Promise(t=>{setTimeout(t,e)}),R=(e,t=300)=>{let n=null;return function(...r){n||=setTimeout(()=>{n=null,e.apply(this,r)},t)}};export{I as LockQueue,d as camelToSnake,f as capitalize,O as chatCompletions,m as compactStr,F as debounce,p as decapitalize,k as defineModel,h as extractErrorMessage,_ as fetcher,y as getRealURL,x as imageUrlToBase64,e as isNil,t as isObject,n as isPrimitive,j as logger,M as loopUntil,r as mapKeys,i as mapValues,a as mergeObjects,o as omit,s as omitBy,S as parseSSE,c as pick,l as pickBy,g as qs,P as randomInt,L as sleep,u as snakeToCamel,R as throttle,v as to,N as withCache};
+`);for(let e of t){if(!e.startsWith(`data:`))continue;let t=e.replace(/^data:\s*/,``).trim();try{yield JSON.parse(t)}catch{yield t}}}}}finally{t.releaseLock()}}const C=e=>({inputs:[`text`],context:128e3,...e}),w=(e,t,n,r)=>{let i=[];return{type:`function`,function:{name:e,description:t,parameters:{type:`object`,properties:l(n,e=>e===`required`?(i.push(e),!1):!0),required:i}},handler:r}},T=async e=>{let t=(await _(e).get(`/v1/models`)).data[0]?.id;if(!t)throw Error(`无法从/models获取模型名称`);return t},E=e=>[c(e,[`type`,`function`]),c(e,[`handler`])],D=async(e,t,n)=>{let r=t.find(t=>t.function.name===e.function.name)?.handler;if(!r)return`没有找到工具“${e.function.name}”的处理函数`;try{let t=await r(JSON.parse(e.function.arguments),n);return typeof t==`string`?t:JSON.stringify(t)}catch(t){if(t instanceof Error&&t.name===e.function.name)throw t;return`工具“${e.function.name}”处理失败：${h(t)}`}},O=e=>e.reasoning||e.reasoning_content,k=e=>typeof e==`string`?e:e.filter(e=>e.type===`text`).map(e=>e.text).join(`
+`),A=e=>{switch(e.type){case`text`:return`text`;case`image_url`:return`image`;case`input_audio`:return`audio`;case`video_url`:return`video`}},j=(e,t)=>{let{inputs:n=[`text`]}=e;return t.some(e=>{let{content:t}=e;if(typeof t!=`string`){if(Array.isArray(t))for(let e of t){let t=A(e);return!t||!n.includes(t)}return!0}})},M=async(e,t,n=[],r)=>{let{onToolHandled:i}=r??{};for(;;){let{choices:r,usage:a,...o}=await e.post(`/chat/completions`,{}),{message:s}=r?.[0]??{};if(!s)throw Error(`模型没有回复任何内容`);t.push(s);let{content:c=``,tool_calls:l=[],...u}=s,d=O(s);if(l.length>0&&n.length>0){for(let e of l){let r=await D(e,n,{messages:t});t.push({role:`tool`,content:r,tool_call_id:e.id}),i?.(e.function.name,e.function.arguments,r)}continue}return{content:k(c),reasoning:d,usage:a,...o,...u}}},N=async function*(e,t,n=[],r){let{onToolHandled:i}=r??{};for(;;){let r=new Map,a=``,o=null,s,c=await e.post(`/chat/completions`,{stream:!0},{parser:async e=>e});for await(let e of S(c)){e.usage&&(s=e.usage);let t=e.choices?.[0];if(!t)continue;let{delta:n}=t,{content:i,tool_calls:c}=n,l=O(n);if(l&&(yield{reasoning:l}),i&&(a+=i,yield{content:i}),c)for(let e of c){let t=r.get(e.index)??{id:``,type:`function`,function:{name:``,arguments:``}};e.id&&(t.id=e.id),e.function?.name&&(t.function.name+=e.function.name),e.function?.arguments&&(t.function.arguments+=e.function.arguments),r.set(e.index,t)}t.finish_reason&&(o=t.finish_reason)}let l=Array.from(r.values());if(o===`tool_calls`&&l.length>0&&n.length>0){t.push({role:`assistant`,content:a,tool_calls:l});for(let e of l){let r=await D(e,n,{messages:t});t.push({role:`tool`,content:r,tool_call_id:e.id}),i?.(e.function.name,e.function.arguments,r)}continue}t.push({role:`assistant`,content:a}),s&&(yield{usage:s});break}};async function P(e,t,n){let{baseUrl:r,apiKey:i=``,model:a,customBody:o,inputs:s,...c}=e,{stream:l,tools:u=[],...d}=n??{};if(j(e,t))throw Error(`当前上下文含有模型不支持的输入类型`);let f=_(r,{headers:{Authorization:`Bearer ${i}`},body:{model:a??await T(r),messages:t,tools:u?.map(e=>E(e)[0]),...o}});return(l?N:M)(f,t,u,{...d,...c})}function F(e={},t=0){let{withTime:n=!0,withFileName:r=!0}=e;return(...e)=>{let i=[];if(n&&i.push(`[${new Date().toLocaleTimeString()}]`),r){let{stack:e}=Error(),n=(e?.split(`
+`)[2+t]?.trim())?.match(/^at\s+(?:.*?\s*\()?(.*?):(\d+)(?::(\d+))?\)?/);if(n?.[1]){let e=n[1].split(/[/\\]/).pop();i.push(`[${e}:${n[2]}]`)}}i.push(...e),console.log(...i)}}function I(e,...n){if(t(e)&&(`withTime`in e||`withFileName`in e))return F(e,0);F({},1)(e,...n)}const L=async(e,t)=>{let{maxRetries:n=5,shouldStop:r}=t??{},i;for(let t=0;t<n;t++)if(i=await e(t),r?.(i)===!0)return i;if(!r)return i;throw Error(`超过了最大循环次数（${n}）且未满足停止执行条件`)},R=(e,t=-1)=>{let n=new Map,r=(...r)=>{let i=JSON.stringify(r),a=Date.now(),o=n.get(i);if(o&&a<o.expiresAt)return o.value;let s=t===-1?1/0:a+t*1e3,c=e.apply({setTtl:e=>{s=a+e*1e3}},r);if(c instanceof Promise){let e=c.then(e=>(n.set(i,{value:e,expiresAt:s}),e));return n.set(i,{value:e,expiresAt:s}),e}return n.set(i,{value:c,expiresAt:s}),c};return r.clear=()=>n.clear(),r.updateTtl=e=>{t=e;let r=Date.now(),i=r+e*1e3;for(let[e,t]of n.entries())t.expiresAt>r&&(t.expiresAt=i,n.set(e,t))},r},z=(e,t)=>Math.floor(Math.random()*(t-e+1))+e,B=(e,t=300)=>{let n=null;return(...r)=>{n&&clearTimeout(n),n=setTimeout(()=>{e(...r)},t)}};var V=class{queue;constructor(){this.queue=Promise.resolve()}waitInQueue(){let e,t=new Promise(t=>{e=t}),n=this.queue.then(()=>e);return this.queue=t,n}};const H=async(e=150)=>new Promise(t=>{setTimeout(t,e)}),U=(e,t=300)=>{let n=null;return function(...r){n||=setTimeout(()=>{n=null,e.apply(this,r)},t)}};export{V as LockQueue,d as camelToSnake,f as capitalize,P as chatCompletions,m as compactStr,B as debounce,p as decapitalize,C as defineModel,w as defineTool,h as extractErrorMessage,_ as fetcher,T as getModelName,y as getRealURL,x as imageUrlToBase64,e as isNil,t as isObject,n as isPrimitive,I as logger,L as loopUntil,r as mapKeys,i as mapValues,a as mergeObjects,o as omit,s as omitBy,S as parseSSE,c as pick,l as pickBy,g as qs,z as randomInt,H as sleep,u as snakeToCamel,U as throttle,v as to,R as withCache};

package/package.json

@@ -1,33 +1,33 @@
-{
-	"name": "@nickyzj2023/utils",
-	"version": "1.0.75",
-	"type": "module",
-	"main": "dist/index.mjs",
-	"module": "dist/index.mjs",
-	"types": "dist/index.d.mts",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.mts",
-			"import": "./dist/index.mjs"
-		}
-	},
-	"files": [
-		"dist"
-	],
-	"scripts": {
-		"build": "tsdown",
-		"docs": "typedoc",
-		"check": "biome check --diagnostic-level=error --write src/"
-	},
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/Nickyzj628/utils.git"
-	},
-	"devDependencies": {
-		"@types/node": "^25.9.3",
-		"tsdown": "^0.22.2",
-		"typedoc": "^0.28.19",
-		"typedoc-material-theme": "^1.4.1",
-		"typescript": "^6.0.3"
-	}
-}
+{
+	"name": "@nickyzj2023/utils",
+	"version": "1.0.77",
+	"type": "module",
+	"main": "dist/index.mjs",
+	"module": "dist/index.mjs",
+	"types": "dist/index.d.mts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.mts",
+			"import": "./dist/index.mjs"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "tsdown",
+		"docs": "typedoc",
+		"check": "biome check --diagnostic-level=error --write src/"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/Nickyzj628/utils.git"
+	},
+	"devDependencies": {
+		"@types/node": "^25.9.3",
+		"tsdown": "^0.22.2",
+		"typedoc": "^0.28.19",
+		"typedoc-material-theme": "^1.4.1",
+		"typescript": "^6.0.3"
+	}
+}