assistsx-js 0.2.2 → 0.2.3

package/dist/index.js

@@ -1407,6 +1407,17 @@ var useStepStore = defineStore("step", {
   }
 });
 
+// src/pinia-ensure.ts
+import { createPinia, getActivePinia, setActivePinia } from "pinia";
+var fallbackPinia = null;
+function ensureAssistsXPinia() {
+  if (getActivePinia() !== void 0) return;
+  if (fallbackPinia === null) {
+    fallbackPinia = createPinia();
+  }
+  setActivePinia(fallbackPinia);
+}
+
 // src/step-error.ts
 var StepError = class extends Error {
   constructor(message, data, impl, tag, originalError, currentStep) {
@@ -1768,13 +1779,31 @@ var _Step = class _Step {
     this.delayMs = _Step.delayMsDefault;
     this.tag = tag;
     this.stepId = stepId;
-    this.data = data != null ? data : {};
+    this.data = _Step.resolveStepData(data);
     this.impl = impl;
     this.delayMs = delayMs;
     this.repeatCountMax = repeatCountMax;
     this.exceptionRetryCountMax = exceptionRetryCountMax;
     this.isEnd = isEnd;
   }
+  /**
+   * 判断步骤数据是否有效（非空且为普通对象）
+   */
+  static isValidStepData(data) {
+    return data !== null && data !== void 0 && typeof data === "object" && !Array.isArray(data);
+  }
+  /**
+   * 解析步骤数据：优先使用传入值，否则使用当前值，均无效时返回空对象
+   */
+  static resolveStepData(provided, fallback) {
+    if (provided !== void 0 && _Step.isValidStepData(provided)) {
+      return provided;
+    }
+    if (fallback !== void 0 && _Step.isValidStepData(fallback)) {
+      return fallback;
+    }
+    return {};
+  }
   /**
    * 运行步骤实现
    * @param impl 步骤实现函数
@@ -1791,7 +1820,9 @@ var _Step = class _Step {
   } = {}) {
     var _a2, _b, _c, _d, _e, _f;
     this.exception = void 0;
+    ensureAssistsXPinia();
     const stepStore = useStepStore();
+    const resolvedData = _Step.resolveStepData(data);
     let implnName = impl.name;
     let currentStep;
     let nextStep;
@@ -1807,12 +1838,12 @@ var _Step = class _Step {
           console.log(`\u751F\u6210\u6B65\u9AA4ID: ${this._stepId}`);
         }
       }
-      stepStore.startStep(this._stepId, tag, data);
+      stepStore.startStep(this._stepId, tag, resolvedData);
       currentStep = new _Step({
         stepId: this._stepId,
         impl,
         tag,
-        data,
+        data: resolvedData,
         delayMs,
         exceptionRetryCountMax
       });
@@ -1921,7 +1952,7 @@ var _Step = class _Step {
       const errorMsg = JSON.stringify({
         impl: implnName,
         tag,
-        data,
+        data: resolvedData,
         error: (_f = e == null ? void 0 : e.message) != null ? _f : String(e)
       });
       stepStore.setError(errorMsg);
@@ -2064,13 +2095,12 @@ var _Step = class _Step {
     repeatCountMax = _Step.repeatCountMaxDefault,
     exceptionRetryCountMax = _Step.exceptionRetryCountMaxDefault
   } = {}) {
-    var _a2;
     _Step.assert(this.stepId);
     return new _Step({
       stepId: this.stepId,
       impl,
       tag,
-      data: (_a2 = data != null ? data : this.data) != null ? _a2 : {},
+      data: _Step.resolveStepData(data, this.data),
       delayMs,
       repeatCountMax,
       exceptionRetryCountMax
@@ -2083,13 +2113,12 @@ var _Step = class _Step {
     repeatCountMax = _Step.repeatCountMaxDefault,
     exceptionRetryCountMax = _Step.exceptionRetryCountMaxDefault
   } = {}) {
-    var _a2;
     _Step.assert(this.stepId);
     return new _Step({
       stepId: this.stepId,
       impl: void 0,
       tag,
-      data: (_a2 = data != null ? data : this.data) != null ? _a2 : {},
+      data: _Step.resolveStepData(data, this.data),
       delayMs,
       repeatCountMax,
       exceptionRetryCountMax,
@@ -2107,7 +2136,7 @@ var _Step = class _Step {
   repeat({
     stepId = this.stepId,
     tag = this.tag,
-    data = ((_a2) => (_a2 = this.data) != null ? _a2 : {})(),
+    data,
     delayMs = this.delayMs,
     repeatCountMax = this.repeatCountMax,
     exceptionRetryCountMax = this.exceptionRetryCountMax
@@ -2116,7 +2145,7 @@ var _Step = class _Step {
     this.repeatCount++;
     this.stepId = stepId;
     this.tag = tag;
-    this.data = data;
+    this.data = _Step.resolveStepData(data, this.data);
     this.delayMs = delayMs;
     this.repeatCountMax = repeatCountMax;
     this.exceptionRetryCountMax = exceptionRetryCountMax;
@@ -7736,6 +7765,17 @@ var Log = class {
     );
     return res.isSuccess();
   }
+  /**
+   * 追加日志（appendTimestampedEntry / appendLine 简写）。
+   * 默认带时间戳；`timestamped: false` 时走 appendLine。
+   */
+  async append(text, options) {
+    const { timestamped = true, maxLength, timeout } = options != null ? options : {};
+    if (timestamped) {
+      return this.appendTimestampedEntry(text, timeout);
+    }
+    return this.appendLine(text, maxLength, timeout);
+  }
   /** 替换全部内容 */
   async replaceAll(content, timeout) {
     const res = await this.asyncCall(
@@ -7941,6 +7981,7 @@ export {
   barUtils,
   callbacks,
   decodeBase64UTF8,
+  ensureAssistsXPinia,
   fileIO,
   fileUtils,
   float,