@scenemesh/entity-engine-aimodule 1.0.0 → 1.0.1

package/dist/utils/index.js

@@ -0,0 +1,336 @@
+/**
+ * Entity Engine AI - Utility Functions
+ *
+ * Collection of utility functions for common operations
+ */
+// Export other utility modules
+export * from './warnings';
+export * from './streaming';
+export * from './persistence';
+// Message processing utilities
+/**
+ * Extract text content from message
+ */
+export function extractMessageText(message) {
+    return message.parts
+        .filter(part => part.type === 'text')
+        .map(part => part.text)
+        .join('\n');
+}
+/**
+ * Check if message contains tool calls
+ */
+export function hasToolCalls(message) {
+    return message.parts.some(part => part.type.startsWith('tool-') || part.type === 'dynamic-tool');
+}
+/**
+ * Get tool calls list from message
+ */
+export function getToolCalls(message) {
+    return message.parts
+        .filter(part => part.type.startsWith('tool-') || part.type === 'dynamic-tool')
+        .map(part => ({
+        toolName: part.type === 'dynamic-tool'
+            ? part.toolName
+            : part.type.replace('tool-', ''),
+        state: part.state || 'unknown',
+        input: part.input,
+        output: part.output,
+    }));
+}
+/**
+ * Check if message contains file attachments
+ */
+export function hasFileAttachments(message) {
+    return message.parts.some(part => part.type === 'file');
+}
+/**
+ * Get file attachments list from message
+ */
+export function getFileAttachments(message) {
+    return message.parts
+        .filter(part => part.type === 'file')
+        .map(part => part);
+}
+// Time formatting utilities
+/**
+ * Format timestamp
+ */
+export function formatTimestamp(timestamp, options) {
+    if (!timestamp)
+        return '';
+    const date = new Date(timestamp);
+    const { format = 'short', includeDate = false } = options || {};
+    switch (format) {
+        case 'short':
+            return date.toLocaleTimeString([], {
+                hour: '2-digit',
+                minute: '2-digit',
+                ...(includeDate && {
+                    month: 'short',
+                    day: 'numeric'
+                })
+            });
+        case 'long':
+            return date.toLocaleString();
+        case 'relative':
+            return formatRelativeTime(timestamp);
+        default:
+            return date.toLocaleTimeString();
+    }
+}
+/**
+ * Format relative time
+ */
+export function formatRelativeTime(timestamp) {
+    const now = Date.now();
+    const diff = now - timestamp;
+    const minute = 60 * 1000;
+    const hour = minute * 60;
+    const day = hour * 24;
+    const week = day * 7;
+    const month = day * 30;
+    const year = day * 365;
+    if (diff < minute) {
+        return 'Just now';
+    }
+    else if (diff < hour) {
+        const minutes = Math.floor(diff / minute);
+        return `${minutes}m ago`;
+    }
+    else if (diff < day) {
+        const hours = Math.floor(diff / hour);
+        return `${hours}h ago`;
+    }
+    else if (diff < week) {
+        const days = Math.floor(diff / day);
+        return `${days}d ago`;
+    }
+    else if (diff < month) {
+        const weeks = Math.floor(diff / week);
+        return `${weeks}w ago`;
+    }
+    else if (diff < year) {
+        const months = Math.floor(diff / month);
+        return `${months}mo ago`;
+    }
+    else {
+        const years = Math.floor(diff / year);
+        return `${years}y ago`;
+    }
+}
+// File processing utilities
+/**
+ * Format file size
+ */
+export function formatFileSize(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return parseFloat((bytes / Math.pow(k, i)).toFixed(1)) + ' ' + sizes[i];
+}
+/**
+ * Get file extension
+ */
+export function getFileExtension(filename) {
+    return filename.split('.').pop()?.toLowerCase() || '';
+}
+/**
+ * Check if file type is accepted
+ */
+export function isFileTypeAccepted(file, acceptedTypes) {
+    return acceptedTypes.some(type => {
+        if (type.endsWith('/*')) {
+            return file.type.startsWith(type.slice(0, -1));
+        }
+        return file.type === type;
+    });
+}
+/**
+ * Create file URL
+ */
+export function createFileUrl(file) {
+    return URL.createObjectURL(file);
+}
+/**
+ * Revoke file URL
+ */
+export function revokeFileUrl(url) {
+    URL.revokeObjectURL(url);
+}
+// String processing utilities
+/**
+ * Truncate text
+ */
+export function truncateText(text, maxLength) {
+    if (text.length <= maxLength)
+        return text;
+    return text.slice(0, maxLength - 3) + '...';
+}
+/**
+ * Highlight search terms
+ */
+export function highlightSearchTerms(text, searchTerms) {
+    if (!searchTerms.length)
+        return text;
+    let highlightedText = text;
+    searchTerms.forEach(term => {
+        const regex = new RegExp(`(${term})`, 'gi');
+        highlightedText = highlightedText.replace(regex, '<mark>$1</mark>');
+    });
+    return highlightedText;
+}
+/**
+ * Convert camelCase to space-separated
+ */
+export function camelToSpaced(str) {
+    return str.replace(/([A-Z])/g, ' $1').trim();
+}
+// Data validation utilities
+/**
+ * Check if string is valid URL
+ */
+export function isValidUrl(string) {
+    try {
+        new URL(string);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if string is valid JSON
+ */
+export function isValidJson(string) {
+    try {
+        JSON.parse(string);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Safe JSON parse
+ */
+export function safeJsonParse(string, fallback) {
+    try {
+        return JSON.parse(string);
+    }
+    catch {
+        return fallback;
+    }
+}
+// CSS class name utilities
+/**
+ * Combine CSS class names (simplified clsx)
+ */
+export function cn(...classes) {
+    return classes.filter(Boolean).join(' ');
+}
+// Error handling utilities
+/**
+ * Safely execute async function
+ */
+export async function safeAsync(fn, fallback) {
+    try {
+        const data = await fn();
+        return { data };
+    }
+    catch (error) {
+        return {
+            error: error instanceof Error ? error : new Error(String(error)),
+            ...(fallback !== undefined && { data: fallback })
+        };
+    }
+}
+/**
+ * Create error message
+ */
+export function createErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    return 'An unknown error occurred';
+}
+// Performance utilities
+/**
+ * Debounce function
+ */
+export function debounce(func, delay) {
+    let timeoutId;
+    return function debouncedFunction(...args) {
+        clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => func.apply(this, args), delay);
+    };
+}
+/**
+ * Throttle function
+ */
+export function throttle(func, delay) {
+    let inThrottle;
+    return function throttledFunction(...args) {
+        if (!inThrottle) {
+            func.apply(this, args);
+            inThrottle = true;
+            setTimeout(() => inThrottle = false, delay);
+        }
+    };
+}
+// Local storage utilities
+/**
+ * Safe localStorage operations
+ */
+export const storage = {
+    get(key, fallback) {
+        if (typeof window === 'undefined')
+            return fallback || null;
+        try {
+            const item = localStorage.getItem(key);
+            return item ? JSON.parse(item) : (fallback || null);
+        }
+        catch {
+            return fallback || null;
+        }
+    },
+    set(key, value) {
+        if (typeof window === 'undefined')
+            return false;
+        try {
+            localStorage.setItem(key, JSON.stringify(value));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    remove(key) {
+        if (typeof window === 'undefined')
+            return false;
+        try {
+            localStorage.removeItem(key);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    clear() {
+        if (typeof window === 'undefined')
+            return false;
+        try {
+            localStorage.clear();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+};
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

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

package/dist/utils/persistence.d.ts

@@ -0,0 +1,99 @@
+/**
+ * 🎯 Entity Engine AIUI - Message Persistence Utils
+ *
+ * 消息持久化工具，支持消息验证、ID生成和存储管理
+ */
+import type { z } from 'zod';
+import type { UIMessage } from 'ai';
+/**
+ * ID生成器选项
+ */
+export interface IdGeneratorOptions {
+    prefix?: string;
+    size?: number;
+}
+/**
+ * 创建ID生成器
+ */
+export declare function createIdGenerator(options?: IdGeneratorOptions): () => string;
+/**
+ * 生成唯一ID
+ */
+export declare function generateId(): string;
+/**
+ * 消息验证选项
+ */
+export interface ValidateUIMessagesOptions<T extends Record<string, any> = any> {
+    messages: UIMessage[];
+    tools?: T;
+    dataPartsSchema?: z.ZodSchema;
+    metadataSchema?: z.ZodSchema;
+}
+/**
+ * 验证UI消息
+ */
+export declare function validateUIMessages<T extends Record<string, any>>({ messages, tools, dataPartsSchema, metadataSchema, }: ValidateUIMessagesOptions<T>): Promise<UIMessage[]>;
+/**
+ * 类型验证错误类
+ */
+export declare class TypeValidationError extends Error {
+    readonly details?: any | undefined;
+    constructor(message: string, details?: any | undefined);
+}
+/**
+ * 消息存储接口
+ */
+export interface MessageStore {
+    createChat(): Promise<string>;
+    loadChat(id: string): Promise<UIMessage[]>;
+    saveChat(options: {
+        chatId: string;
+        messages: UIMessage[];
+    }): Promise<void>;
+    deleteChat(id: string): Promise<void>;
+    listChats(): Promise<Array<{
+        id: string;
+        title?: string;
+        updatedAt: Date;
+    }>>;
+}
+/**
+ * 内存消息存储（用于开发和测试）
+ */
+export declare class InMemoryMessageStore implements MessageStore {
+    private chats;
+    private metadata;
+    createChat(): Promise<string>;
+    loadChat(id: string): Promise<UIMessage[]>;
+    saveChat({ chatId, messages }: {
+        chatId: string;
+        messages: UIMessage[];
+    }): Promise<void>;
+    deleteChat(id: string): Promise<void>;
+    listChats(): Promise<Array<{
+        id: string;
+        title?: string;
+        updatedAt: Date;
+    }>>;
+    private extractTitle;
+}
+/**
+ * 本地存储消息存储
+ */
+export declare class LocalStorageMessageStore implements MessageStore {
+    private readonly keyPrefix;
+    createChat(): Promise<string>;
+    loadChat(id: string): Promise<UIMessage[]>;
+    saveChat({ chatId, messages }: {
+        chatId: string;
+        messages: UIMessage[];
+    }): Promise<void>;
+    deleteChat(id: string): Promise<void>;
+    listChats(): Promise<Array<{
+        id: string;
+        title?: string;
+        updatedAt: Date;
+    }>>;
+    private extractTitle;
+}
+//# sourceMappingURL=persistence.d.ts.map

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

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