@actiondock/testing 2.2.1 → 2.3.0

package/dist/runtime.d.ts

@@ -40,6 +40,10 @@ import { decodeStateKey, encodeStateKey, escapeStateSegment, unescapeStateSegmen
 export { decodeStateKey, encodeStateKey, escapeStateSegment, unescapeStateSegment };
 /**
  * 基于内存 Map 的状态存储实现，支持命名空间隔离与 TTL 自动失效，专供单元测试使用。
+ *
+ * 根命名空间读取未命中时，会按 core 生产 RuntimeStateStore 的回扫语义，
+ * 以裸 key 反查全部命名空间中的同 key 条目（多条命中时抛歧义异常，与 core 的
+ * findState 契约一致），确保测试与生产行为不分叉。
  */
 export declare class MemoryStateStore implements StateStore {
     private store;
@@ -50,6 +54,13 @@ export declare class MemoryStateStore implements StateStore {
     private nowMs;
     private qualify;
     private extractEntry;
+    /** 提取并结算条目：命中且未过期返回条目本身，已过期删除并返回 undefined */
+    private settleEntry;
+    /**
+     * 以裸 key 回扫全部命名空间，对齐 core 生产存储的 findState 契约：
+     * 多条命中抛歧义异常，零命中返回 undefined，唯一命中返回该条目。
+     */
+    private findAcrossNamespaces;
     get<T = unknown>(key: string): Promise<T | undefined>;
     set<T = unknown>(key: string, value: T, ttl?: number): Promise<void>;
     delete(key: string): Promise<boolean>;
@@ -135,8 +146,12 @@ export interface TestRuntimeOptions {
     clock?: FakeClock;
     /** 可选注入的模拟进程执行器 */
     process?: MockProcessExecutor;
-    /** 可选注入的日志记录器（默认使用 MemoryLogger） */
-    logger?: Logger;
+    /**
+     * 可选注入的日志记录器，仅接受 MemoryLogger 实例（默认新建）。
+     * 测试运行时需捕获日志供断言检索，不支持自定义 Logger 实现；
+     * 如需自定义日志行为，请直接使用 DefaultExecutionService 组装。
+     */
+    logger?: MemoryLogger;
     /** 可选注入的底层存储实例 */
     storage?: MemoryStorage;
     /** 项目静态配置元数据 */

package/dist/runtime.js

@@ -46,6 +46,10 @@ import { decodeStateKey, encodeStateKey, escapeStateSegment, unescapeStateSegmen
 export { decodeStateKey, encodeStateKey, escapeStateSegment, unescapeStateSegment };
 /**
  * 基于内存 Map 的状态存储实现，支持命名空间隔离与 TTL 自动失效，专供单元测试使用。
+ *
+ * 根命名空间读取未命中时，会按 core 生产 RuntimeStateStore 的回扫语义，
+ * 以裸 key 反查全部命名空间中的同 key 条目（多条命中时抛歧义异常，与 core 的
+ * findState 契约一致），确保测试与生产行为不分叉。
  */
 export class MemoryStateStore {
     store;
@@ -72,17 +76,67 @@ export class MemoryStateStore {
         }
         return { value: raw };
     }
-    async get(key) {
-        const qKey = this.qualify(key);
-        const raw = this.store.get(qKey);
-        if (raw === undefined)
-            return undefined;
+    /** 提取并结算条目：命中且未过期返回条目本身，已过期删除并返回 undefined */
+    settleEntry(raw) {
         const entry = this.extractEntry(raw);
         if (entry.expiresAt !== undefined && entry.expiresAt <= this.nowMs()) {
-            this.store.delete(qKey);
             return undefined;
         }
-        return (entry.value !== undefined ? structuredClone(entry.value) : undefined);
+        return entry;
+    }
+    /**
+     * 以裸 key 回扫全部命名空间，对齐 core 生产存储的 findState 契约：
+     * 多条命中抛歧义异常，零命中返回 undefined，唯一命中返回该条目。
+     */
+    findAcrossNamespaces(key) {
+        const now = this.nowMs();
+        const hits = [];
+        for (const [storeKey, raw] of this.store.entries()) {
+            let decoded;
+            try {
+                decoded = decodeStateKey(storeKey);
+            }
+            catch {
+                // 无法解码的复合键直接跳过，不影响其他条目回扫
+                continue;
+            }
+            if (decoded.key !== key) {
+                continue;
+            }
+            const entry = this.extractEntry(raw);
+            if (entry.expiresAt !== undefined && entry.expiresAt <= now) {
+                this.store.delete(storeKey);
+                continue;
+            }
+            hits.push({ storeKey, entry });
+        }
+        if (hits.length > 1) {
+            throw new Error(`Ambiguous state key '${key}': matches ${hits.length} entries (${hits
+                .map((h) => decodeStateKey(h.storeKey).namespace + ":" + key)
+                .join(", ")})`);
+        }
+        if (hits.length === 0) {
+            return undefined;
+        }
+        const value = hits[0].entry.value;
+        return (value !== undefined ? structuredClone(value) : undefined);
+    }
+    async get(key) {
+        const qKey = this.qualify(key);
+        const raw = this.store.get(qKey);
+        if (raw !== undefined) {
+            const entry = this.settleEntry(raw);
+            if (entry === undefined) {
+                this.store.delete(qKey);
+                return undefined;
+            }
+            return (entry.value !== undefined ? structuredClone(entry.value) : undefined);
+        }
+        // 根命名空间精确未命中时回扫全部命名空间，与 core RuntimeStateStore 语义对齐
+        if (!this.namespace) {
+            return this.findAcrossNamespaces(key);
+        }
+        return undefined;
     }
     async set(key, value, ttl) {
         const qKey = this.qualify(key);
@@ -364,7 +418,8 @@ export function createTestRuntime(options = {}) {
         }
     }
     const events = new TestEventSink();
-    const memoryLogger = options.logger instanceof MemoryLogger ? options.logger : new MemoryLogger();
+    // 类型已收窄为 MemoryLogger，直接使用注入实例或默认新建，不再做静默替换
+    const memoryLogger = options.logger ?? new MemoryLogger();
     const actionsMap = normalizeTestActions(options.actions, packageId);
     const executionService = new DefaultExecutionService({
         packageId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actiondock/testing",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "ActionDock Test Runtime for testing Actions with real Core execution semantics",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,8 +29,8 @@
     "test": "node ../../scripts/run-tests.ts"
   },
   "dependencies": {
-    "@actiondock/core": "^2.2.1",
-    "@actiondock/sdk": "^2.2.1"
+    "@actiondock/core": "^2.3.0",
+    "@actiondock/sdk": "^2.3.0"
   },
   "devDependencies": {
     "typescript": "^5.7.0"