@variojs/core 0.1.0

package/__tests__/vm/executor-timeout.test.ts

@@ -0,0 +1,117 @@
+/**
+ * Action VM 超时和步数限制测试
+ */
+
+import { describe, it, expect, vi } from 'vitest'
+import { createRuntimeContext } from '../../src/runtime/create-context.js'
+import { execute, type ExecuteOptions } from '../../src/vm/executor.js'
+import { ErrorCodes } from '../../src/errors.js'
+
+describe('Action VM 超时和步数限制', () => {
+  describe('超时保护', () => {
+    it('应该在超时时抛出错误', async () => {
+      const ctx = createRuntimeContext({})
+      
+      // 注册一个会延迟的动作
+      ctx.$methods['slow'] = async () => {
+        await new Promise(resolve => setTimeout(resolve, 100))
+      }
+      
+      const options: ExecuteOptions = {
+        timeout: 50
+      }
+      
+      try {
+        await execute([{ type: 'slow' }], ctx, options)
+        expect.fail('Should have thrown timeout error')
+      } catch (error: any) {
+        expect(error.code).toBe(ErrorCodes.ACTION_TIMEOUT)
+      }
+    })
+
+    it('应该允许正常执行在超时范围内', async () => {
+      const ctx = createRuntimeContext({ count: 0 })
+      
+      const options: ExecuteOptions = {
+        timeout: 1000
+      }
+      
+      await execute([
+        { type: 'set', path: 'count', value: 10 }
+      ], ctx, options)
+      
+      expect(ctx.count).toBe(10)
+    })
+  })
+
+  describe('步数限制', () => {
+    it('应该在超过最大步数时抛出错误', async () => {
+      const ctx = createRuntimeContext({ count: 0 })
+      
+      const options: ExecuteOptions = {
+        maxSteps: 5
+      }
+      
+      // 创建超过步数限制的动作序列
+      const actions = Array.from({ length: 10 }, () => ({
+        type: 'set' as const,
+        path: 'count',
+        value: 1
+      }))
+      
+      try {
+        await execute(actions, ctx, options)
+        expect.fail('Should have thrown max steps error')
+      } catch (error: any) {
+        expect(error.code).toBe(ErrorCodes.ACTION_MAX_STEPS_EXCEEDED)
+      }
+    })
+
+    it('应该允许正常执行在步数限制内', async () => {
+      const ctx = createRuntimeContext({ count: 0 })
+      
+      const options: ExecuteOptions = {
+        maxSteps: 100
+      }
+      
+      await execute([
+        { type: 'set', path: 'count', value: 10 }
+      ], ctx, options)
+      
+      expect(ctx.count).toBe(10)
+    })
+  })
+
+  describe('边界条件', () => {
+    it('应该处理空动作数组', async () => {
+      const ctx = createRuntimeContext({})
+      
+      await execute([], ctx)
+      
+      // 应该正常完成，不抛出错误
+      expect(true).toBe(true)
+    })
+
+    it('应该处理单个动作', async () => {
+      const ctx = createRuntimeContext({ count: 0 })
+      
+      await execute([
+        { type: 'set', path: 'count', value: 1 }
+      ], ctx)
+      
+      expect(ctx.count).toBe(1)
+    })
+
+    it('应该正确处理动作执行中的错误', async () => {
+      const ctx = createRuntimeContext({})
+      
+      ctx.$methods['error'] = async () => {
+        throw new Error('Test error')
+      }
+      
+      await expect(
+        execute([{ type: 'error' }], ctx)
+      ).rejects.toThrow('Test error')
+    })
+  })
+})

package/__tests__/vm/executor.test.ts

@@ -0,0 +1,173 @@
+/**
+ * Action VM 执行器测试
+ */
+
+import { describe, it, expect, beforeEach } from 'vitest'
+import { createRuntimeContext } from '../../src/runtime/create-context'
+import { execute } from '../../src/vm/executor'
+
+describe('Action VM', () => {
+  let ctx: ReturnType<typeof createRuntimeContext>
+  
+  beforeEach(() => {
+    // createRuntimeContext 现在会自动注册内置动作
+    ctx = createRuntimeContext({
+      user: { name: 'John', age: 30 },
+      count: 0,
+      items: [1, 2, 3]
+    })
+  })
+  
+  it('应该执行 set 动作', async () => {
+    await execute([
+      { type: 'set', path: 'count', value: 10 }
+    ], ctx)
+    
+    expect(ctx.count).toBe(10)
+  })
+  
+  it('应该执行 set 动作（表达式值）', async () => {
+    await execute([
+      { type: 'set', path: 'count', value: '{{ count + 1 }}' }
+    ], ctx)
+    
+    expect(ctx.count).toBe(1)
+  })
+  
+  it('应该执行 emit 动作', async () => {
+    const events: Array<{ event: string; data?: any }> = []
+    const ctx = createRuntimeContext({}, {
+      onEmit: (event, data) => {
+        events.push({ event, data })
+      }
+    })
+    
+    await execute([
+      { type: 'emit', event: 'test', data: { value: 123 } }
+    ], ctx)
+    
+    expect(events).toHaveLength(1)
+    expect(events[0].event).toBe('test')
+  })
+  
+  it('应该执行 if 动作', async () => {
+    await execute([
+      {
+        type: 'if',
+        cond: 'user.age > 18',
+        then: [
+          { type: 'set', path: 'isAdult', value: true }
+        ],
+        else: [
+          { type: 'set', path: 'isAdult', value: false }
+        ]
+      }
+    ], ctx)
+    
+    expect(ctx.isAdult).toBe(true)
+  })
+  
+  it('应该执行 loop 动作', async () => {
+    await execute([
+      {
+        type: 'loop',
+        var: 'item',
+        in: 'items',
+        body: [
+          { type: 'set', path: 'total', value: '{{ (total || 0) + item }}' }
+        ]
+      }
+    ], ctx)
+    
+    expect(ctx.total).toBe(6)  // 1 + 2 + 3
+  })
+  
+  it('应该执行 batch 动作', async () => {
+    await execute([
+      {
+        type: 'batch',
+        actions: [
+          { type: 'set', path: 'a', value: 1 },
+          { type: 'set', path: 'b', value: 2 }
+        ]
+      }
+    ], ctx)
+    
+    expect(ctx.a).toBe(1)
+    expect(ctx.b).toBe(2)
+  })
+  
+  it('应该执行数组操作动作', async () => {
+    await execute([
+      { type: 'push', path: 'items', value: 4 }
+    ], ctx)
+    
+    expect(ctx.items).toEqual([1, 2, 3, 4])
+    
+    await execute([
+      { type: 'pop', path: 'items' }
+    ], ctx)
+    
+    expect(ctx.items).toEqual([1, 2, 3])
+  })
+  
+  it('应该在未知动作类型时抛出错误', async () => {
+    await expect(
+      execute([{ type: 'unknown' }], ctx)
+    ).rejects.toThrow('Unknown action type')
+  })
+  
+  it('应该执行 call 动作', async () => {
+    ctx.$methods['test.method'] = async () => {
+      return 'result'
+    }
+    
+    await execute([
+      {
+        type: 'call',
+        method: 'test.method',
+        resultTo: 'result'
+      }
+    ], ctx)
+    
+    expect(ctx.result).toBe('result')
+  })
+  
+  it('应该执行 navigate 动作', async () => {
+    let navigatedTo: string | null = null
+    ctx.$methods['navigate'] = async (ctx, params: Record<string, unknown>) => {
+      navigatedTo = params.to as string
+    }
+    
+    await execute([
+      {
+        type: 'navigate',
+        to: '/test'
+      }
+    ], ctx)
+    
+    expect(navigatedTo).toBe('/test')
+  })
+  
+  it('应该执行 log 动作', async () => {
+    const logs: string[] = []
+    const originalLog = console.log
+    console.log = (...args: unknown[]) => {
+      logs.push(args.map(String).join(' '))
+    }
+    
+    try {
+      await execute([
+        {
+          type: 'log',
+          level: 'info',
+          message: 'Test message'
+        }
+      ], ctx)
+      
+      expect(logs.some(log => log.includes('Test message'))).toBe(true)
+    } finally {
+      console.log = originalLog
+    }
+  })
+})

package/__tests__/vm/handlers/array.test.ts

@@ -0,0 +1,113 @@
+/**
+ * 数组操作动作测试
+ */
+
+import { describe, it, expect, beforeEach } from 'vitest'
+import { createRuntimeContext } from '../../../src/runtime/create-context.js'
+import { execute } from '../../../src/vm/executor.js'
+import { ErrorCodes } from '../../../src/errors.js'
+
+describe('数组操作动作', () => {
+  let ctx: ReturnType<typeof createRuntimeContext>
+
+  beforeEach(() => {
+    ctx = createRuntimeContext({
+      items: [1, 2, 3],
+      todos: []
+    })
+  })
+
+  describe('push', () => {
+    it('应该添加元素到数组末尾', async () => {
+      await execute([
+        { type: 'push', path: 'items', value: 4 }
+      ], ctx)
+      
+      expect(ctx.items).toEqual([1, 2, 3, 4])
+    })
+
+    it('应该支持添加多个元素', async () => {
+      await execute([
+        { type: 'push', path: 'items', items: [4, 5] }
+      ], ctx)
+      
+      expect(ctx.items).toEqual([1, 2, 3, 4, 5])
+    })
+
+    it('应该在路径不是数组时抛出错误', async () => {
+      try {
+        await execute([
+          { type: 'push', path: 'items', value: 4 }
+        ], createRuntimeContext({ items: 'not-array' }))
+        expect.fail('Should have thrown error')
+      } catch (error: any) {
+        expect(error.code).toBe(ErrorCodes.ACTION_INVALID_PARAM)
+      }
+    })
+  })
+
+  describe('pop', () => {
+    it('应该删除数组末尾元素', async () => {
+      await execute([
+        { type: 'pop', path: 'items' }
+      ], ctx)
+      
+      expect(ctx.items).toEqual([1, 2])
+    })
+
+    it('应该处理空数组', async () => {
+      await execute([
+        { type: 'pop', path: 'todos' }
+      ], ctx)
+      
+      expect(ctx.todos).toEqual([])
+    })
+  })
+
+  describe('shift', () => {
+    it('应该删除数组首元素', async () => {
+      await execute([
+        { type: 'shift', path: 'items' }
+      ], ctx)
+      
+      expect(ctx.items).toEqual([2, 3])
+    })
+  })
+
+  describe('unshift', () => {
+    it('应该添加元素到数组开头', async () => {
+      await execute([
+        { type: 'unshift', path: 'items', value: 0 }
+      ], ctx)
+      
+      expect(ctx.items).toEqual([0, 1, 2, 3])
+    })
+  })
+
+  describe('splice', () => {
+    it('应该删除元素', async () => {
+      await execute([
+        { type: 'splice', path: 'items', start: 1, deleteCount: 1 }
+      ], ctx)
+      
+      expect(ctx.items).toEqual([1, 3])
+    })
+
+    it('应该替换元素', async () => {
+      await execute([
+        { type: 'splice', path: 'items', start: 1, deleteCount: 1, items: [99] }
+      ], ctx)
+      
+      expect(ctx.items).toEqual([1, 99, 3])
+    })
+
+    it('应该支持表达式参数', async () => {
+      ctx.count = 1
+      await execute([
+        { type: 'splice', path: 'items', start: '{{ count }}', deleteCount: 1 }
+      ], ctx)
+      
+      expect(ctx.items).toEqual([1, 3])
+    })
+  })
+})

package/__tests__/vm/handlers/call.test.ts

@@ -0,0 +1,93 @@
+/**
+ * call 指令处理器测试
+ */
+
+import { describe, it, expect, beforeEach } from 'vitest'
+import { createRuntimeContext } from '../../../src/runtime/create-context'
+import { execute } from '../../../src/vm/executor'
+import { InstructionError, ServiceError } from '../../../src/types'
+
+describe('call 指令', () => {
+  let ctx: ReturnType<typeof createRuntimeContext>
+  
+  beforeEach(() => {
+    // createRuntimeContext 现在会自动注册内置指令
+    ctx = createRuntimeContext({
+      user: { name: 'John', age: 30 },
+      result: null
+    })
+  })
+  
+  it('应该调用已注册的方法', async () => {
+    // 注册一个测试方法
+    ctx.$methods['test.method'] = async (ctx, params: Record<string, unknown>) => {
+      return { success: true, value: params.value }
+    }
+    
+    await execute([
+      {
+        type: 'call',
+        method: 'test.method',
+        params: { value: 123 }
+      }
+    ], ctx)
+  })
+  
+  it('应该将结果保存到 resultTo', async () => {
+    ctx.$methods['test.return'] = async () => {
+      return { data: 'result' }
+    }
+    
+    await execute([
+      {
+        type: 'call',
+        method: 'test.return',
+        resultTo: 'result'
+      }
+    ], ctx)
+    
+    expect(ctx.result).toEqual({ data: 'result' })
+  })
+  
+  it('应该支持表达式参数', async () => {
+    ctx.$methods['test.echo'] = async (ctx, params: Record<string, unknown>) => {
+      return params.value
+    }
+    
+    await execute([
+      {
+        type: 'call',
+        method: 'test.echo',
+        params: {
+          value: '{{ user.name }}'
+        }
+      }
+    ], ctx)
+  })
+  
+  it('应该在方法不存在时抛出错误', async () => {
+    await expect(
+      execute([
+        {
+          type: 'call',
+          method: 'nonexistent.method'
+        }
+      ], ctx)
+    ).rejects.toThrow(InstructionError)
+  })
+  
+  it('应该在方法执行失败时抛出 ServiceError', async () => {
+    ctx.$methods['test.error'] = async () => {
+      throw new Error('Test error')
+    }
+    
+    await expect(
+      execute([
+        {
+          type: 'call',
+          method: 'test.error'
+        }
+      ], ctx)
+    ).rejects.toThrow(ServiceError)
+  })
+})

package/dist/errors.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Vario 错误处理体系
+ *
+ * 统一的错误基类和错误码系统
+ */
+import type { Action } from './types.js';
+/**
+ * 错误上下文信息
+ */
+export interface ErrorContext {
+    /** Schema 路径（如 "events.click[0]"） */
+    schemaPath?: string;
+    /** 表达式字符串 */
+    expression?: string;
+    /** 动作对象 */
+    action?: Action;
+    /** 调用栈（简化版） */
+    stack?: string[];
+    /** 额外上下文信息 */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Vario 错误基类
+ *
+ * 所有 Vario 相关错误都应继承此类
+ */
+export declare class VarioError extends Error {
+    /** 错误码 */
+    readonly code: string;
+    /** 错误上下文 */
+    readonly context: ErrorContext;
+    constructor(message: string, code: string, context?: ErrorContext);
+    /**
+     * 获取友好的错误消息
+     */
+    getFriendlyMessage(): string;
+    /**
+     * 转换为 JSON（用于序列化）
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * 动作执行错误
+ */
+export declare class ActionError extends VarioError {
+    constructor(action: Action, message: string, code?: string, context?: Omit<ErrorContext, 'action'>);
+}
+/**
+ * 表达式求值错误
+ */
+export declare class ExpressionError extends VarioError {
+    constructor(expression: string, message: string, code?: string, context?: Omit<ErrorContext, 'expression'>);
+}
+/**
+ * 服务调用错误
+ */
+export declare class ServiceError extends VarioError {
+    readonly service: string;
+    readonly originalError?: Error;
+    constructor(service: string, message: string, originalError?: Error, context?: ErrorContext);
+}
+/**
+ * 批量执行错误
+ */
+export declare class BatchError extends VarioError {
+    readonly failedActions: Array<{
+        action: Action;
+        error: Error;
+    }>;
+    constructor(failedActions: Array<{
+        action: Action;
+        error: Error;
+    }>, message: string, context?: ErrorContext);
+}
+/**
+ * 错误码定义
+ */
+export declare const ErrorCodes: {
+    readonly ACTION_UNKNOWN_TYPE: "ACTION_UNKNOWN_TYPE";
+    readonly ACTION_EXECUTION_ERROR: "ACTION_EXECUTION_ERROR";
+    readonly ACTION_ABORTED: "ACTION_ABORTED";
+    readonly ACTION_TIMEOUT: "ACTION_TIMEOUT";
+    readonly ACTION_MAX_STEPS_EXCEEDED: "ACTION_MAX_STEPS_EXCEEDED";
+    readonly ACTION_MISSING_PARAM: "ACTION_MISSING_PARAM";
+    readonly ACTION_INVALID_PARAM: "ACTION_INVALID_PARAM";
+    readonly EXPRESSION_PARSE_ERROR: "EXPRESSION_PARSE_ERROR";
+    readonly EXPRESSION_VALIDATION_ERROR: "EXPRESSION_VALIDATION_ERROR";
+    readonly EXPRESSION_EVALUATION_ERROR: "EXPRESSION_EVALUATION_ERROR";
+    readonly EXPRESSION_TIMEOUT: "EXPRESSION_TIMEOUT";
+    readonly EXPRESSION_MAX_STEPS_EXCEEDED: "EXPRESSION_MAX_STEPS_EXCEEDED";
+    readonly EXPRESSION_UNSAFE_ACCESS: "EXPRESSION_UNSAFE_ACCESS";
+    readonly EXPRESSION_FUNCTION_NOT_WHITELISTED: "EXPRESSION_FUNCTION_NOT_WHITELISTED";
+    readonly SERVICE_NOT_FOUND: "SERVICE_NOT_FOUND";
+    readonly SERVICE_CALL_ERROR: "SERVICE_CALL_ERROR";
+    readonly BATCH_ERROR: "BATCH_ERROR";
+    readonly SCHEMA_VALIDATION_ERROR: "SCHEMA_VALIDATION_ERROR";
+    readonly SCHEMA_INVALID_ACTION: "SCHEMA_INVALID_ACTION";
+};
+export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,cAAc;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,UAAU;IACV,SAAgB,IAAI,EAAE,MAAM,CAAA;IAC5B,YAAY;IACZ,SAAgB,OAAO,EAAE,YAAY,CAAA;gBAGnC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,YAAiB;IAa5B;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAkB5B;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASlC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;gBAEvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAuB,EAC7B,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAM;CAQ7C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;gBAE3C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAA2B,EACjC,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,YAAY,CAAM;CAQjD;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C,SAAgB,OAAO,EAAE,MAAM,CAAA;IAC/B,SAAgB,aAAa,CAAC,EAAE,KAAK,CAAA;gBAGnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,KAAK,EACrB,OAAO,GAAE,YAAiB;CAO7B;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,UAAU;IACxC,SAAgB,aAAa,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAA;gBAGpE,aAAa,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,EACtD,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB;CAM7B;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;CA6Bb,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAA"}