mozi-bot 1.0.0

package/dist/tools/registry.js

@@ -0,0 +1,174 @@
+/**
+ * 工具注册表和策略过滤
+ */
+import { TOOL_GROUPS } from "./types.js";
+import { errorResult } from "./common.js";
+import { getChildLogger } from "../utils/logger.js";
+const logger = getChildLogger("tools");
+/** 工具注册表 */
+const toolRegistry = new Map();
+/** 注册工具 */
+export function registerTool(tool) {
+    toolRegistry.set(tool.name.toLowerCase(), tool);
+    logger.debug({ tool: tool.name }, "Tool registered");
+}
+/** 批量注册工具 */
+export function registerTools(tools) {
+    for (const tool of tools) {
+        registerTool(tool);
+    }
+}
+/** 获取工具 */
+export function getTool(name) {
+    return toolRegistry.get(name.toLowerCase());
+}
+/** 获取所有工具 */
+export function getAllTools() {
+    return Array.from(toolRegistry.values());
+}
+/** 清除所有工具 */
+export function clearTools() {
+    toolRegistry.clear();
+}
+/** 编译单个模式 */
+function compilePattern(pattern) {
+    const normalized = pattern.toLowerCase().trim();
+    if (normalized === "*")
+        return { kind: "all" };
+    if (!normalized.includes("*"))
+        return { kind: "exact", value: normalized };
+    const escaped = normalized.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+    const regexStr = escaped.replace(/\*/g, ".*");
+    return { kind: "regex", value: new RegExp(`^${regexStr}$`) };
+}
+/** 编译模式列表 */
+function compilePatterns(patterns) {
+    if (!patterns || patterns.length === 0)
+        return [];
+    return patterns.map(compilePattern);
+}
+/** 展开工具组 */
+function expandGroups(patterns) {
+    if (!patterns)
+        return [];
+    const expanded = [];
+    for (const pattern of patterns) {
+        if (pattern.startsWith("group:") && TOOL_GROUPS[pattern]) {
+            expanded.push(...TOOL_GROUPS[pattern]);
+        }
+        else {
+            expanded.push(pattern);
+        }
+    }
+    return expanded;
+}
+/** 检查是否匹配任一模式 */
+function matchesAny(name, patterns) {
+    for (const pattern of patterns) {
+        switch (pattern.kind) {
+            case "all":
+                return true;
+            case "exact":
+                if (name === pattern.value)
+                    return true;
+                break;
+            case "regex":
+                if (pattern.value.test(name))
+                    return true;
+                break;
+        }
+    }
+    return false;
+}
+/** 按策略过滤工具 */
+export function filterToolsByPolicy(tools, policy) {
+    if (!policy)
+        return tools;
+    const expandedAllow = expandGroups(policy.allow);
+    const expandedDeny = expandGroups(policy.deny);
+    const allowPatterns = compilePatterns(expandedAllow);
+    const denyPatterns = compilePatterns(expandedDeny);
+    return tools.filter((tool) => {
+        const name = tool.name.toLowerCase();
+        // 拒绝优先
+        if (matchesAny(name, denyPatterns))
+            return false;
+        // 如果没有允许列表，允许所有
+        if (allowPatterns.length === 0)
+            return true;
+        // 必须匹配允许列表
+        return matchesAny(name, allowPatterns);
+    });
+}
+// ============== 工具执行 ==============
+/** 执行单个工具调用 */
+export async function executeToolCall(toolCall, signal) {
+    const startTime = Date.now();
+    const tool = getTool(toolCall.name);
+    if (!tool) {
+        return {
+            toolCallId: toolCall.id,
+            name: toolCall.name,
+            result: errorResult(`Unknown tool: ${toolCall.name}`),
+            isError: true,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    try {
+        logger.debug({ tool: toolCall.name, args: toolCall.arguments }, "Executing tool");
+        const result = await tool.execute(toolCall.id, toolCall.arguments, signal);
+        logger.debug({ tool: toolCall.name, durationMs: Date.now() - startTime }, "Tool execution completed");
+        return {
+            toolCallId: toolCall.id,
+            name: toolCall.name,
+            result,
+            isError: result.isError ?? false,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error({ tool: toolCall.name, error }, "Tool execution failed");
+        return {
+            toolCallId: toolCall.id,
+            name: toolCall.name,
+            result: errorResult(message),
+            isError: true,
+            durationMs: Date.now() - startTime,
+        };
+    }
+}
+/** 批量执行工具调用 */
+export async function executeToolCalls(toolCalls, options) {
+    const { signal, parallel = false } = options ?? {};
+    if (parallel) {
+        return Promise.all(toolCalls.map((tc) => executeToolCall(tc, signal)));
+    }
+    const results = [];
+    for (const toolCall of toolCalls) {
+        if (signal?.aborted) {
+            results.push({
+                toolCallId: toolCall.id,
+                name: toolCall.name,
+                result: errorResult("Aborted"),
+                isError: true,
+                durationMs: 0,
+            });
+            continue;
+        }
+        results.push(await executeToolCall(toolCall, signal));
+    }
+    return results;
+}
+/** 将工具转换为 OpenAI 函数格式 */
+export function toolsToOpenAIFunctions(tools) {
+    return tools.map((tool) => ({
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.parameters,
+        },
+    }));
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"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"}

package/dist/tools/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 工具系统 - 类型定义
+ */
+import type { TSchema } from "@sinclair/typebox";
+/** 工具结果内容项 */
+export type ToolResultContent = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+};
+/** 工具执行结果 */
+export interface ToolResult {
+    content: ToolResultContent[];
+    details?: unknown;
+    isError?: boolean;
+}
+/** 工具更新回调 */
+export type ToolUpdateCallback = (partial: {
+    text?: string;
+}) => void;
+/** 工具定义 */
+export interface Tool<TParams = Record<string, unknown>> {
+    /** 工具名称 (标识符) */
+    name: string;
+    /** 工具标签 (显示名) */
+    label?: string;
+    /** 工具描述 */
+    description: string;
+    /** 参数 JSON Schema */
+    parameters: TSchema;
+    /** 执行函数 */
+    execute: (toolCallId: string, args: TParams, signal?: AbortSignal, onUpdate?: ToolUpdateCallback) => Promise<ToolResult>;
+}
+/** 工具调用 */
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/** 工具调用结果 */
+export interface ToolCallResult {
+    toolCallId: string;
+    name: string;
+    result: ToolResult;
+    isError: boolean;
+    durationMs: number;
+}
+/** 工具策略 */
+export interface ToolPolicy {
+    allow?: string[];
+    deny?: string[];
+}
+/** 工具组定义 */
+export declare const TOOL_GROUPS: Record<string, string[]>;
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,cAAc;AACd,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,aAAa;AACb,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,aAAa;AACb,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAC;AAEtE,WAAW;AACX,MAAM,WAAW,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrD,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW;IACX,OAAO,EAAE,CACP,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,kBAAkB,KAC1B,OAAO,CAAC,UAAU,CAAC,CAAC;CAC1B;AAED,WAAW;AACX,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,aAAa;AACb,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,WAAW;AACX,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,YAAY;AACZ,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAKhD,CAAC"}

package/dist/tools/types.js

@@ -0,0 +1,11 @@
+/**
+ * 工具系统 - 类型定义
+ */
+/** 工具组定义 */
+export const TOOL_GROUPS = {
+    "group:web": ["web_search", "web_fetch"],
+    "group:memory": ["memory_search", "memory_store"],
+    "group:media": ["image_analyze"],
+    "group:system": ["current_time", "calculator"],
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4DH,YAAY;AACZ,MAAM,CAAC,MAAM,WAAW,GAA6B;IACnD,WAAW,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC;IACxC,cAAc,EAAE,CAAC,eAAe,EAAE,cAAc,CAAC;IACjD,aAAa,EAAE,CAAC,eAAe,CAAC;IAChC,cAAc,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC;CAC/C,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,280 @@
+/**
+ * 核心类型定义
+ */
+/** 支持的模型 API 类型 */
+export type ModelApi = "openai-compatible" | "openai" | "anthropic" | "minimax-v1" | "anthropic-messages";
+/** 模型提供商 ID */
+export type ProviderId = "deepseek" | "minimax" | "kimi" | "stepfun" | "modelscope" | "dashscope" | "zhipu" | "openai" | "ollama" | "openrouter" | "together" | "groq" | "azure-openai" | "vllm" | "custom-openai" | "custom-anthropic";
+/** 模型定义 */
+export interface ModelDefinition {
+    id: string;
+    name: string;
+    provider: ProviderId;
+    api: ModelApi;
+    contextWindow: number;
+    maxTokens: number;
+    supportsVision: boolean;
+    supportsReasoning: boolean;
+    /** 是否支持工具调用 (默认 true) */
+    supportsToolCalls?: boolean;
+    cost?: {
+        input: number;
+        output: number;
+        cacheRead?: number;
+    };
+}
+/** 模型提供商配置 */
+export interface ProviderConfig {
+    id: ProviderId;
+    name: string;
+    baseUrl: string;
+    apiKey?: string;
+    api: ModelApi;
+    models: ModelDefinition[];
+    headers?: Record<string, string>;
+}
+/** 简化的提供商配置 (用于用户配置) */
+export interface SimpleProviderConfig {
+    baseUrl?: string;
+    apiKey?: string;
+    headers?: Record<string, string>;
+    groupId?: string;
+}
+/** 消息角色 */
+export type MessageRole = "system" | "user" | "assistant" | "tool";
+/** 消息内容类型 */
+export type ContentType = "text" | "image";
+/** 文本内容 */
+export interface TextContent {
+    type: "text";
+    text: string;
+}
+/** 图片内容 */
+export interface ImageContent {
+    type: "image";
+    url?: string;
+    base64?: string;
+    mediaType?: string;
+}
+/** 消息内容 */
+export type MessageContent = TextContent | ImageContent;
+/** 工具调用 (在 assistant 消息中) */
+export interface MessageToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/** 聊天消息 */
+export interface ChatMessage {
+    role: MessageRole;
+    content: string | MessageContent[] | null;
+    /** assistant 消息中的工具调用 */
+    tool_calls?: MessageToolCall[];
+    /** tool 消息中的工具调用 ID */
+    tool_call_id?: string;
+    /** tool 消息中的工具名称 */
+    name?: string;
+}
+/** OpenAI 工具定义 (用于请求参数) */
+export interface OpenAIToolDefinition {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: unknown;
+    };
+}
+/** 聊天完成请求 */
+export interface ChatCompletionRequest {
+    model: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    maxTokens?: number;
+    stream?: boolean;
+    topP?: number;
+    stop?: string[];
+    /** OpenAI 工具定义 */
+    tools?: OpenAIToolDefinition[];
+    /** 工具选择策略 */
+    tool_choice?: "auto" | "none" | {
+        type: "function";
+        function: {
+            name: string;
+        };
+    };
+}
+/** 聊天完成响应 */
+export interface ChatCompletionResponse {
+    id: string;
+    model: string;
+    content: string;
+    /** assistant 的工具调用 */
+    toolCalls?: MessageToolCall[];
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    finishReason: "stop" | "length" | "content_filter" | "tool_calls";
+}
+/** 流式响应块 */
+export interface StreamChunk {
+    id: string;
+    delta: string;
+    finishReason?: string;
+    /** 流式工具调用增量 */
+    toolCallDeltas?: Array<{
+        index: number;
+        id?: string;
+        type?: string;
+        function?: {
+            name?: string;
+            arguments?: string;
+        };
+    }>;
+}
+/** 通道 ID */
+export type ChannelId = "feishu" | "dingtalk" | "webchat";
+/** 聊天类型 */
+export type ChatType = "direct" | "group";
+/** 通道能力 */
+export interface ChannelCapabilities {
+    chatTypes: ChatType[];
+    supportsMedia: boolean;
+    supportsReply: boolean;
+    supportsMention: boolean;
+    supportsReaction: boolean;
+    supportsThread: boolean;
+    supportsEdit: boolean;
+    maxMessageLength: number;
+}
+/** 通道元数据 */
+export interface ChannelMeta {
+    id: ChannelId;
+    name: string;
+    description: string;
+    capabilities: ChannelCapabilities;
+}
+/** 入站消息上下文 */
+export interface InboundMessageContext {
+    channelId: ChannelId;
+    messageId: string;
+    chatId: string;
+    chatType: ChatType;
+    senderId: string;
+    senderName?: string;
+    content: string;
+    mediaUrls?: string[];
+    replyToId?: string;
+    mentions?: string[];
+    timestamp: number;
+    raw?: unknown;
+}
+/** 出站消息 */
+export interface OutboundMessage {
+    chatId: string;
+    content: string;
+    replyToId?: string;
+    mediaUrls?: string[];
+    mentions?: string[];
+}
+/** 发送结果 */
+export interface SendResult {
+    success: boolean;
+    messageId?: string;
+    error?: string;
+}
+/** 飞书配置 */
+export interface FeishuConfig {
+    appId: string;
+    appSecret: string;
+    verificationToken?: string;
+    encryptKey?: string;
+    enabled?: boolean;
+    /** 连接模式: websocket (默认，无需公网) 或 webhook (需要公网) */
+    mode?: "websocket" | "webhook";
+}
+/** 钉钉配置 */
+export interface DingtalkConfig {
+    appKey: string;
+    appSecret: string;
+    robotCode?: string;
+    enabled?: boolean;
+    /** 连接模式: stream (默认，无需公网) 或 webhook (需要公网) */
+    mode?: "stream" | "webhook";
+}
+/** Agent 配置 */
+export interface AgentConfig {
+    defaultModel: string;
+    defaultProvider: ProviderId;
+    systemPrompt?: string;
+    temperature?: number;
+    maxTokens?: number;
+    /** 工作目录 */
+    workingDirectory?: string;
+    /** 是否启用 function calling */
+    enableFunctionCalling?: boolean;
+}
+/** 会话存储配置 */
+export interface SessionStoreConfig {
+    /** 存储类型 */
+    type: "memory" | "file";
+    /** 文件存储目录 */
+    directory?: string;
+    /** 会话 TTL (毫秒) */
+    ttlMs?: number;
+}
+/** Memory 配置 */
+export interface MemoryConfig {
+    enabled?: boolean;
+    /** 存储目录 */
+    directory?: string;
+    /** 嵌入模型 */
+    embeddingModel?: string;
+    /** 嵌入提供商 */
+    embeddingProvider?: ProviderId;
+}
+/** 主配置 */
+export interface MoziConfig {
+    providers: Record<string, SimpleProviderConfig | Record<string, unknown>>;
+    channels: {
+        feishu?: FeishuConfig;
+        dingtalk?: DingtalkConfig;
+    };
+    agent: AgentConfig;
+    server: {
+        port: number;
+        host?: string;
+    };
+    logging: {
+        level: "debug" | "info" | "warn" | "error";
+    };
+    /** 会话存储配置 */
+    sessions?: SessionStoreConfig;
+    /** Memory 配置 */
+    memory?: MemoryConfig;
+}
+/** 事件类型 */
+export type EventType = "message_received" | "message_sent" | "error" | "channel_connected" | "channel_disconnected";
+/** 事件处理器 */
+export type EventHandler<T = unknown> = (data: T) => void | Promise<void>;
+/** Mozi 错误 */
+export declare class MoziError extends Error {
+    code: string;
+    details?: unknown | undefined;
+    constructor(message: string, code: string, details?: unknown | undefined);
+}
+/** 提供商错误 */
+export declare class ProviderError extends MoziError {
+    provider: ProviderId;
+    constructor(message: string, provider: ProviderId, details?: unknown);
+}
+/** 通道错误 */
+export declare class ChannelError extends MoziError {
+    channel: ChannelId;
+    constructor(message: string, channel: ChannelId, details?: unknown);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.js

@@ -0,0 +1,34 @@
+/**
+ * 核心类型定义
+ */
+// ============== 错误类型 ==============
+/** Mozi 错误 */
+export class MoziError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "MoziError";
+    }
+}
+/** 提供商错误 */
+export class ProviderError extends MoziError {
+    provider;
+    constructor(message, provider, details) {
+        super(message, "PROVIDER_ERROR", details);
+        this.provider = provider;
+        this.name = "ProviderError";
+    }
+}
+/** 通道错误 */
+export class ChannelError extends MoziError {
+    channel;
+    constructor(message, channel, details) {
+        super(message, "CHANNEL_ERROR", details);
+        this.channel = channel;
+        this.name = "ChannelError";
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwTH,qCAAqC;AAErC,cAAc;AACd,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGzB;IACA;IAHT,YACE,OAAe,EACR,IAAY,EACZ,OAAiB;QAExB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAU;QAGxB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,YAAY;AACZ,MAAM,OAAO,aAAc,SAAQ,SAAS;IAGjC;IAFT,YACE,OAAe,EACR,QAAoB,EAC3B,OAAiB;QAEjB,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;QAHnC,aAAQ,GAAR,QAAQ,CAAY;QAI3B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,WAAW;AACX,MAAM,OAAO,YAAa,SAAQ,SAAS;IAGhC;IAFT,YACE,OAAe,EACR,OAAkB,EACzB,OAAiB;QAEjB,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;QAHlC,YAAO,GAAP,OAAO,CAAW;QAIzB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/utils/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 工具函数
+ */
+/** 生成唯一 ID */
+export declare function generateId(prefix?: string): string;
+/** 安全获取环境变量 */
+export declare function getEnvVar(name: string, defaultValue?: string): string | undefined;
+/** 必需环境变量 */
+export declare function requireEnvVar(name: string): string;
+/** 延迟执行 */
+export declare function delay(ms: number): Promise<void>;
+/** 重试执行 */
+export declare function retry<T>(fn: () => Promise<T>, options?: {
+    maxRetries?: number;
+    delayMs?: number;
+    backoff?: boolean;
+    onRetry?: (error: Error, attempt: number) => void;
+}): Promise<T>;
+/** 截断字符串 */
+export declare function truncate(str: string, maxLength: number, suffix?: string): string;
+/** 安全 JSON 解析 */
+export declare function safeJsonParse<T>(str: string, defaultValue: T): T;
+/** 深度合并对象 */
+export declare function deepMerge<T extends Record<string, unknown>>(target: T, source: Partial<T>): T;
+/** 计算签名 (用于钉钉等) */
+export declare function computeHmacSha256(secret: string, data: string): string;
+/** AES 解密 (用于飞书加密消息) */
+export declare function aesDecrypt(key: string, encryptedData: string): string;
+/** 格式化时间戳 */
+export declare function formatTimestamp(ts: number): string;
+/** 判断是否为空对象 */
+export declare function isEmpty(obj: Record<string, unknown>): boolean;
+/** 移除对象中的 undefined 值 */
+export declare function removeUndefined<T extends Record<string, unknown>>(obj: T): Partial<T>;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,cAAc;AACd,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,eAAe;AACf,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjF;AAED,aAAa;AACb,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,WAAW;AACX,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,WAAW;AACX,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C,GACL,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED,YAAY;AACZ,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAQ,GAAG,MAAM,CAG/E;AAED,iBAAiB;AACjB,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAMhE;AAED,aAAa;AACb,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAyB7F;AAED,mBAAmB;AACnB,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAwB;AACxB,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAarE;AAED,aAAa;AACb,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,eAAe;AACf,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAE7D;AAED,yBAAyB;AACzB,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQrF"}