@h-ai/core 0.1.0-alpha.69 → 0.1.0-alpha.71

package/dist/{chunk-MUQFCAQ5.js → chunk-QPG7M3S3.js}

@@ -19718,136 +19718,6 @@ var CoreConfigSchema = external_exports.strictObject({
   defaultLocale: external_exports.string().default("zh-CN")
 });
 
-// src/functions/core-function-error.ts
-function buildHaiErrorsDef(module, errorInfo, system = "hai") {
-  const result = {};
-  for (const key in errorInfo) {
-    const [codeNum, httpStatusStr] = errorInfo[key].split(":");
-    result[key] = {
-      code: `${system}:${module}:${codeNum}`,
-      httpStatus: Number(httpStatusStr),
-      system,
-      module
-    };
-  }
-  return result;
-}
-function buildHaiErrorInst(def, message, cause, suggestion) {
-  const inst = { ...def, message };
-  if (cause !== void 0)
-    inst.cause = cause;
-  if (suggestion !== void 0)
-    inst.suggestion = suggestion;
-  return inst;
-}
-var error62 = {
-  buildHaiErrorsDef,
-  buildHaiErrorInst
-};
-
-// src/core-types.ts
-var UnknownErrorDef = {
-  code: "_:_:599",
-  httpStatus: 500,
-  system: "_",
-  module: "_"
-};
-function ok(data) {
-  return { success: true, data };
-}
-function err(errorOrDef, message, cause, suggestion) {
-  if (errorOrDef instanceof Error) {
-    return {
-      success: false,
-      error: error62.buildHaiErrorInst(
-        UnknownErrorDef,
-        message || errorOrDef.message,
-        cause ?? errorOrDef,
-        suggestion
-      )
-    };
-  }
-  const nonNativeError = errorOrDef;
-  if ("message" in nonNativeError) {
-    return {
-      success: false,
-      error: nonNativeError
-    };
-  }
-  return {
-    success: false,
-    error: error62.buildHaiErrorInst(nonNativeError, message || "", cause, suggestion)
-  };
-}
-var CommonErrorInfo = {
-  // 001-099: 初始化和配置
-  NOT_INITIALIZED: "001:500",
-  INIT_FAILED: "002:500",
-  INIT_IN_PROGRESS: "004:500",
-  // 100-199: 认证 & 授权
-  UNAUTHORIZED: "100:401",
-  FORBIDDEN: "101:403",
-  TOKEN_EXPIRED: "102:401",
-  TOKEN_INVALID: "103:401",
-  // 200-299: 校验 & 参数
-  VALIDATION_ERROR: "200:400",
-  INVALID_REQUEST: "201:400",
-  PARAMETER_MISSING: "202:400",
-  // 300-399: 资源操作
-  NOT_FOUND: "300:404",
-  ALREADY_EXISTS: "301:409",
-  CONFLICT: "302:409",
-  // 400-499: 外部依赖
-  API_ERROR: "400:502",
-  NETWORK_ERROR: "401:502",
-  TIMEOUT: "402:504",
-  SERVICE_UNAVAILABLE: "403:503",
-  // 500-599: 内部错误
-  INTERNAL_ERROR: "500:500",
-  DATABASE_ERROR: "501:500",
-  UNKNOWN_ERROR: "599:500"
-};
-var HaiCommonError = error62.buildHaiErrorsDef("common", CommonErrorInfo);
-var ConfigErrorInfo = {
-  CONFIG_FILE_NOT_FOUND: "010:500",
-  CONFIG_PARSE_ERROR: "011:500",
-  CONFIG_VALIDATION_ERROR: "012:500",
-  CONFIG_ENV_VAR_MISSING: "013:500",
-  CONFIG_NOT_LOADED: "014:500"
-};
-var HaiConfigError = error62.buildHaiErrorsDef("core", ConfigErrorInfo);
-
-// src/functions/core-function-context.ts
-var storage;
-var synchronousContext = Object.freeze({});
-function installRequestContext(value) {
-  storage = value;
-}
-var requestContext = {
-  get() {
-    return storage?.getStore() ?? synchronousContext;
-  },
-  run(value, operation) {
-    const previousValue = requestContext.get();
-    const merged = Object.freeze({
-      requestId: Object.hasOwn(value, "requestId") ? value.requestId : previousValue.requestId,
-      scopeId: Object.hasOwn(value, "scopeId") ? value.scopeId : previousValue.scopeId,
-      userId: Object.hasOwn(value, "userId") ? value.userId : previousValue.userId,
-      jobId: Object.hasOwn(value, "jobId") ? value.jobId : previousValue.jobId,
-      suppressLogObservers: Object.hasOwn(value, "suppressLogObservers") ? value.suppressLogObservers : previousValue.suppressLogObservers
-    });
-    if (storage)
-      return storage.run(merged, operation);
-    const previous = synchronousContext;
-    synchronousContext = merged;
-    try {
-      return operation();
-    } finally {
-      synchronousContext = previous;
-    }
-  }
-};
-
 // messages/en-US.json
 var en_US_default = {
   $schema: "https://inlang.com/schema/inlang-message-format",
@@ -19901,7 +19771,9 @@ var en_US_default = {
   core_configValidationFailed: "Config validation failed",
   core_configNotLoaded: "Config '{name}' is not loaded",
   core_configUnsupportedInBrowser: "Browser does not support file-based config; use core.config on the server or pass browser options through core.init({ logging })",
-  core_cryptoRandomUnavailable: "Cryptographic random source is unavailable"
+  core_cryptoRandomUnavailable: "Cryptographic random source is unavailable",
+  core_runtimeStartFailed: "Module {module} failed to start",
+  core_runtimeCloseFailed: "Module {module} failed to close; retry cleanup"
 };
 
 // messages/ja-JP.json
@@ -19957,7 +19829,9 @@ var ja_JP_default = {
   core_configValidationFailed: "\u8A2D\u5B9A\u306E\u691C\u8A3C\u306B\u5931\u6557\u3057\u307E\u3057\u305F",
   core_configNotLoaded: "\u8A2D\u5B9A\u300C{name}\u300D\u304C\u8AAD\u307F\u8FBC\u307E\u308C\u3066\u3044\u307E\u305B\u3093",
   core_configUnsupportedInBrowser: "\u30D6\u30E9\u30A6\u30B6\u30FC\u306F\u30D5\u30A1\u30A4\u30EB\u30D9\u30FC\u30B9\u306E\u8A2D\u5B9A\u306B\u5BFE\u5FDC\u3057\u3066\u3044\u307E\u305B\u3093\u3002\u30B5\u30FC\u30D0\u30FC\u5074\u3067core.config\u3092\u4F7F\u7528\u3059\u308B\u304B\u3001core.init({ logging })\u3067\u30D6\u30E9\u30A6\u30B6\u30FC\u7528\u306E\u30AA\u30D7\u30B7\u30E7\u30F3\u3092\u6E21\u3057\u3066\u304F\u3060\u3055\u3044",
-  core_cryptoRandomUnavailable: "\u6697\u53F7\u5B66\u7684\u4E71\u6570\u306E\u751F\u6210\u5143\u3092\u5229\u7528\u3067\u304D\u307E\u305B\u3093"
+  core_cryptoRandomUnavailable: "\u6697\u53F7\u5B66\u7684\u4E71\u6570\u306E\u751F\u6210\u5143\u3092\u5229\u7528\u3067\u304D\u307E\u305B\u3093",
+  core_runtimeStartFailed: "\u30E2\u30B8\u30E5\u30FC\u30EB {module} \u306E\u8D77\u52D5\u306B\u5931\u6557\u3057\u307E\u3057\u305F",
+  core_runtimeCloseFailed: "\u30E2\u30B8\u30E5\u30FC\u30EB {module} \u306E\u7D42\u4E86\u306B\u5931\u6557\u3057\u307E\u3057\u305F\u3002\u5F8C\u51E6\u7406\u3092\u518D\u8A66\u884C\u3057\u3066\u304F\u3060\u3055\u3044"
 };
 
 // messages/zh-CN.json
@@ -20013,7 +19887,9 @@ var zh_CN_default2 = {
   core_configValidationFailed: "\u914D\u7F6E\u9A8C\u8BC1\u5931\u8D25",
   core_configNotLoaded: "\u914D\u7F6E '{name}' \u672A\u52A0\u8F7D",
   core_configUnsupportedInBrowser: "\u6D4F\u89C8\u5668\u73AF\u5883\u4E0D\u652F\u6301\u6587\u4EF6\u914D\u7F6E\uFF0C\u8BF7\u5728\u670D\u52A1\u7AEF\u4F7F\u7528 core.config \u6216\u901A\u8FC7 core.init({ logging }) \u4F20\u5165\u6D4F\u89C8\u5668\u7AEF\u9009\u9879",
-  core_cryptoRandomUnavailable: "\u5F53\u524D\u8FD0\u884C\u73AF\u5883\u7F3A\u5C11\u5BC6\u7801\u5B66\u5B89\u5168\u7684\u968F\u673A\u6E90"
+  core_cryptoRandomUnavailable: "\u5F53\u524D\u8FD0\u884C\u73AF\u5883\u7F3A\u5C11\u5BC6\u7801\u5B66\u5B89\u5168\u7684\u968F\u673A\u6E90",
+  core_runtimeStartFailed: "\u6A21\u5757 {module} \u542F\u52A8\u5931\u8D25",
+  core_runtimeCloseFailed: "\u6A21\u5757 {module} \u5173\u95ED\u5931\u8D25\uFF0C\u8BF7\u91CD\u8BD5\u6E05\u7406"
 };
 
 // src/i18n/core-i18n-utils.ts
@@ -20080,129 +19956,6 @@ var i18n = {
   createMessageGetter,
   coreM
 };
-var DEFAULT_LENGTH = 21;
-var SHORT_LENGTH = 10;
-var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-var NANOID_REGEX_CACHE = /* @__PURE__ */ new Map();
-function generateUUID() {
-  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
-    return crypto.randomUUID();
-  }
-  const bytes = new Uint8Array(16);
-  if (typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function") {
-    crypto.getRandomValues(bytes);
-  } else {
-    throw new Error(i18n.coreM("core_cryptoRandomUnavailable"));
-  }
-  bytes[6] = bytes[6] & 15 | 64;
-  bytes[8] = bytes[8] & 63 | 128;
-  const hex3 = Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
-  return `${hex3.slice(0, 8)}-${hex3.slice(8, 12)}-${hex3.slice(12, 16)}-${hex3.slice(16, 20)}-${hex3.slice(20)}`;
-}
-var id = {
-  /**
-   * 生成标准 nanoid（默认 21 字符）。
-   *
-   * @param length - ID 长度
-   * @returns nanoid 字符串
-   *
-   * @example
-   * ```ts
-   * const id = core.id.generate(16)
-   * ```
-   */
-  generate(length = DEFAULT_LENGTH) {
-    return nanoid$1(length);
-  },
-  /**
-   * 生成短 ID（10 字符）。
-   *
-   * @example
-   * ```ts
-   * const shortId = core.id.short()
-   * ```
-   */
-  short() {
-    return nanoid$1(SHORT_LENGTH);
-  },
-  /**
-   * 生成带前缀的 ID。
-   *
-   * @param prefix - 前缀
-   * @param length - ID 长度
-   *
-   * @example
-   * ```ts
-   * const userId = core.id.withPrefix('user_')
-   * ```
-   */
-  withPrefix(prefix, length = DEFAULT_LENGTH) {
-    return `${prefix}${nanoid$1(length)}`;
-  },
-  /**
-   * 生成 Trace ID。
-   *
-   * @example
-   * ```ts
-   * const traceId = core.id.trace()
-   * ```
-   */
-  trace() {
-    return `trace-${nanoid$1()}`;
-  },
-  /**
-   * 生成 Request ID。
-   *
-   * @example
-   * ```ts
-   * const requestId = core.id.request()
-   * ```
-   */
-  request() {
-    return `req-${nanoid$1()}`;
-  },
-  /**
-   * 生成 UUID v4。
-   *
-   * @example
-   * ```ts
-   * const uuid = core.id.uuid()
-   * ```
-   */
-  uuid() {
-    return generateUUID();
-  },
-  /**
-   * 验证是否为有效的 UUID v4。
-   *
-   * @example
-   * ```ts
-   * core.id.isValidUUID('f47ac10b-58cc-4372-a567-0e02b2c3d479')
-   * ```
-   */
-  isValidUUID(uuid3) {
-    return UUID_REGEX.test(uuid3);
-  },
-  /**
-   * 验证是否为有效的 nanoid。
-   *
-   * @param str - 待验证字符串
-   * @param length - 期望长度
-   *
-   * @example
-   * ```ts
-   * core.id.isValidNanoId('abc', 3)
-   * ```
-   */
-  isValidNanoId(str, length = DEFAULT_LENGTH) {
-    let regex = NANOID_REGEX_CACHE.get(length);
-    if (!regex) {
-      regex = new RegExp(`^[A-Za-z0-9_-]{${length}}$`);
-      NANOID_REGEX_CACHE.set(length, regex);
-    }
-    return regex.test(str);
-  }
-};
 
 // src/utils/core-util-type.ts
 function isDefined(value) {
@@ -20247,7 +20000,14 @@ var typeUtils = {
 };
 
 // src/utils/core-util-sanitize.ts
-var DEFAULT_SENSITIVE_KEY_REGEX = /(?:^|_)(?:pass|passcode|password|secret|authorization|cookie|otp|session|token)$|(?:^|_)otp_code$|(?:^|_)private_key$|(?:^|_)access_key(?:_id|_secret)?$|(?:^|_)secret_access_key$|(?:^|_)api(?:_[a-z0-9]+)*_key$|^apikey$/i;
+var CREDENTIAL_TEXT = /\b(?:Bearer|Basic)\s+[\w.~+/-]+=*|\b(?:[\w-]*[_-])?(?:password|passwd|passcode|secret|token|session(?:[_-]?id)?|authorization|cookie|csrf|credential|api[_-]?key|private[_-]?key|(?:access|refresh|id|csrf)token|(?:otp|totp|verification|verify|captcha|sms|email|auth|one[_-]?time|two[_-]?factor)[_-]?code)(?:\\?["'])?\s*[:=]\s*(?:(?:Bearer|Basic)\s+)?(?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|\\"(?:[^\\]|\\\\\\\\|\\\\\\"|\\\\[^"\\])*\\"|[^\s,;&}\]]+)/gi;
+function sanitizeText(text, secretValues = []) {
+  let result = text;
+  for (const value of [...new Set(secretValues)].filter(Boolean).sort((a, b) => b.length - a.length))
+    result = result.replaceAll(value, "[REDACTED]");
+  return result.replace(/\b[a-z][a-z\d+.-]*:\/\/[^\s<>"']+/gi, (url2) => sanitizeUrl(url2)).replace(CREDENTIAL_TEXT, (match) => match.includes("[REDACTED") ? match : "[REDACTED]");
+}
+var DEFAULT_SENSITIVE_KEY_REGEX = /(?:^|_)(?:pass|passcode|password|secret|authorization|cookie|otp|session|token)$|(?:^|_)(?:otp|totp|verification|verify|captcha|sms|email|auth|one_time|two_factor)_code$|(?:^|_)private_key$|(?:^|_)access_key(?:_id|_secret)?$|(?:^|_)secret_access_key$|(?:^|_)api(?:_[a-z0-9]+)*_key$|^apikey$/i;
 var DEFAULT_SENSITIVE_REPLACEMENT = "[REDACTED]";
 var URL_LIKE_KEY_REGEX = /(?:^|_)(?:url|uri|endpoint)(?:_|$)/;
 var SENSITIVE_KEY_CACHE_LIMIT = 512;
@@ -20345,7 +20105,8 @@ function createSanitizeSensitiveContext(options = {}) {
 }
 function sanitizeSensitiveValueWithContext(value, key, context, cache, errorPath, errorDepth = 0) {
   const isPlainObjectValue = isPlainRecord(value);
-  const isErrorDiagnostic = errorPath !== void 0 || value instanceof Error;
+  const errorValue = value instanceof Error ? value : typeof DOMException !== "undefined" && value instanceof DOMException ? value : void 0;
+  const isErrorDiagnostic = errorPath !== void 0 || errorValue !== void 0;
   if (key !== null) {
     const normalizedKey = normalizeKeyForMatching(key);
     if (typeof value === "string" && isUrlLikeNormalizedKey(normalizedKey)) {
@@ -20361,7 +20122,7 @@ function sanitizeSensitiveValueWithContext(value, key, context, cache, errorPath
     if (typeof value === "function" || typeof value === "symbol")
       return void 0;
     if (value === null || typeof value !== "object")
-      return value;
+      return typeof value === "string" ? sanitizeText(value) : value;
     const activePath = errorPath ?? /* @__PURE__ */ new WeakSet();
     if (activePath.has(value))
       return "[Circular]";
@@ -20373,14 +20134,15 @@ function sanitizeSensitiveValueWithContext(value, key, context, cache, errorPath
         return value.map((item) => sanitizeSensitiveValueWithContext(item, null, context, cache, activePath, errorDepth + 1));
       }
       const fields = { ...value };
-      if (value instanceof Error) {
-        fields.name = value.name;
-        fields.message = value.message;
-        fields.stack = value.stack;
-        if (Object.hasOwn(value, "cause"))
-          fields.cause = value.cause;
-        if (value instanceof AggregateError)
-          fields.errors = value.errors;
+      if (errorValue) {
+        fields.name = errorValue.name;
+        fields.message = errorValue.message;
+        if ("stack" in errorValue)
+          fields.stack = errorValue.stack;
+        if (Object.hasOwn(errorValue, "cause") && "cause" in errorValue)
+          fields.cause = errorValue.cause;
+        if (errorValue instanceof AggregateError)
+          fields.errors = errorValue.errors;
       }
       const sanitized = {};
       for (const [childKey, childValue] of Object.entries(fields)) {
@@ -20430,13 +20192,293 @@ var sanitize = {
   defaultSensitiveReplacement: DEFAULT_SENSITIVE_REPLACEMENT,
   isSensitiveKey,
   sanitizeUrl,
+  sanitizeText,
   sanitizeSensitiveValue,
   sanitizeSensitiveFields
 };
 
-// src/functions/core-function-log-observer.ts
-var observers = /* @__PURE__ */ new Set();
-var emitting = false;
+// src/functions/core-function-context.ts
+var storage;
+var synchronousContext = Object.freeze({});
+function installRequestContext(value) {
+  storage = value;
+}
+var requestContext = {
+  get() {
+    return storage?.getStore() ?? synchronousContext;
+  },
+  run(value, operation) {
+    const previousValue = requestContext.get();
+    const merged = Object.freeze({
+      requestId: Object.hasOwn(value, "requestId") ? value.requestId : previousValue.requestId,
+      traceId: value.traceId ?? (Object.hasOwn(value, "requestId") ? value.requestId : previousValue.traceId),
+      scopeId: Object.hasOwn(value, "scopeId") ? value.scopeId : previousValue.scopeId,
+      userId: Object.hasOwn(value, "userId") ? value.userId : previousValue.userId,
+      jobId: Object.hasOwn(value, "jobId") ? value.jobId : previousValue.jobId,
+      suppressLogObservers: Object.hasOwn(value, "suppressLogObservers") ? value.suppressLogObservers : previousValue.suppressLogObservers
+    });
+    if (storage)
+      return storage.run(merged, operation);
+    const previous = synchronousContext;
+    synchronousContext = merged;
+    try {
+      return operation();
+    } finally {
+      synchronousContext = previous;
+    }
+  }
+};
+var DEFAULT_LENGTH = 21;
+var SHORT_LENGTH = 10;
+var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+var NANOID_REGEX_CACHE = /* @__PURE__ */ new Map();
+function generateUUID() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  const bytes = new Uint8Array(16);
+  if (typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function") {
+    crypto.getRandomValues(bytes);
+  } else {
+    throw new Error(i18n.coreM("core_cryptoRandomUnavailable"));
+  }
+  bytes[6] = bytes[6] & 15 | 64;
+  bytes[8] = bytes[8] & 63 | 128;
+  const hex3 = Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+  return `${hex3.slice(0, 8)}-${hex3.slice(8, 12)}-${hex3.slice(12, 16)}-${hex3.slice(16, 20)}-${hex3.slice(20)}`;
+}
+var id = {
+  /**
+   * 生成标准 nanoid（默认 21 字符）。
+   *
+   * @param length - ID 长度
+   * @returns nanoid 字符串
+   *
+   * @example
+   * ```ts
+   * const id = core.id.generate(16)
+   * ```
+   */
+  generate(length = DEFAULT_LENGTH) {
+    return nanoid$1(length);
+  },
+  /**
+   * 生成短 ID（10 字符）。
+   *
+   * @example
+   * ```ts
+   * const shortId = core.id.short()
+   * ```
+   */
+  short() {
+    return nanoid$1(SHORT_LENGTH);
+  },
+  /**
+   * 生成带前缀的 ID。
+   *
+   * @param prefix - 前缀
+   * @param length - ID 长度
+   *
+   * @example
+   * ```ts
+   * const userId = core.id.withPrefix('user_')
+   * ```
+   */
+  withPrefix(prefix, length = DEFAULT_LENGTH) {
+    return `${prefix}${nanoid$1(length)}`;
+  },
+  /**
+   * 生成 Trace ID。
+   *
+   * @example
+   * ```ts
+   * const traceId = core.id.trace()
+   * ```
+   */
+  trace() {
+    return `trace-${nanoid$1()}`;
+  },
+  /**
+   * 生成 Request ID。
+   *
+   * @example
+   * ```ts
+   * const requestId = core.id.request()
+   * ```
+   */
+  request() {
+    return `req-${nanoid$1()}`;
+  },
+  /**
+   * 生成 UUID v4。
+   *
+   * @example
+   * ```ts
+   * const uuid = core.id.uuid()
+   * ```
+   */
+  uuid() {
+    return generateUUID();
+  },
+  /**
+   * 验证是否为有效的 UUID v4。
+   *
+   * @example
+   * ```ts
+   * core.id.isValidUUID('f47ac10b-58cc-4372-a567-0e02b2c3d479')
+   * ```
+   */
+  isValidUUID(uuid3) {
+    return UUID_REGEX.test(uuid3);
+  },
+  /**
+   * 验证是否为有效的 nanoid。
+   *
+   * @param str - 待验证字符串
+   * @param length - 期望长度
+   *
+   * @example
+   * ```ts
+   * core.id.isValidNanoId('abc', 3)
+   * ```
+   */
+  isValidNanoId(str, length = DEFAULT_LENGTH) {
+    let regex = NANOID_REGEX_CACHE.get(length);
+    if (!regex) {
+      regex = new RegExp(`^[A-Za-z0-9_-]{${length}}$`);
+      NANOID_REGEX_CACHE.set(length, regex);
+    }
+    return regex.test(str);
+  }
+};
+
+// src/functions/core-function-error.ts
+function formatMessage(error63) {
+  return error63.traceId && /^[\w.:-]{1,128}$/.test(error63.traceId) && !error63.message.endsWith(`(traceId: ${error63.traceId})`) ? `${error63.message} (traceId: ${error63.traceId})` : error63.message;
+}
+function toPublic(error63, traceId, locale) {
+  const context = requestContext.get();
+  const candidate = traceId ?? context.traceId ?? context.requestId ?? error63.traceId;
+  const safeTraceId = candidate && /^[\w.:-]{1,128}$/.test(candidate) ? candidate : id.uuid();
+  const result = {
+    code: error63.code,
+    message: (error63.httpStatus ?? 400) >= 500 ? i18n.coreM("core_errorInternal", { locale }) : sanitize.sanitizeText(error63.message),
+    traceId: safeTraceId,
+    ...error63.httpStatus !== void 0 ? { httpStatus: error63.httpStatus } : {},
+    ...error63.system ? { system: error63.system } : {},
+    ...error63.module ? { module: error63.module } : {}
+  };
+  if (error63.publicExt)
+    result.ext = sanitize.sanitizeSensitiveFields(error63.publicExt);
+  if ((error63.httpStatus === 400 || error63.httpStatus === 422) && Array.isArray(error63.cause)) {
+    result.cause = error63.cause.flatMap((item) => item && typeof item === "object" && "field" in item && typeof item.field === "string" && "message" in item && typeof item.message === "string" ? [{ field: item.field, message: sanitize.sanitizeText(item.message) }] : []);
+  }
+  result.message = formatMessage(result);
+  return result;
+}
+function buildHaiErrorsDef(module, errorInfo, system = "hai") {
+  const result = {};
+  for (const key in errorInfo) {
+    const [codeNum, httpStatusStr] = errorInfo[key].split(":");
+    result[key] = {
+      code: `${system}:${module}:${codeNum}`,
+      httpStatus: Number(httpStatusStr),
+      system,
+      module
+    };
+  }
+  return result;
+}
+function buildHaiErrorInst(def, message, cause, suggestion) {
+  const inst = { ...def, message };
+  if (cause !== void 0)
+    inst.cause = cause;
+  if (suggestion !== void 0)
+    inst.suggestion = suggestion;
+  return inst;
+}
+var error62 = {
+  buildHaiErrorsDef,
+  buildHaiErrorInst,
+  formatMessage,
+  toPublic
+};
+
+// src/core-types.ts
+var UnknownErrorDef = {
+  code: "_:_:599",
+  httpStatus: 500,
+  system: "_",
+  module: "_"
+};
+function ok(data) {
+  return { success: true, data };
+}
+function err(errorOrDef, message, cause, suggestion) {
+  if (errorOrDef instanceof Error) {
+    return {
+      success: false,
+      error: error62.buildHaiErrorInst(
+        UnknownErrorDef,
+        message || errorOrDef.message,
+        cause ?? errorOrDef,
+        suggestion
+      )
+    };
+  }
+  const nonNativeError = errorOrDef;
+  if ("message" in nonNativeError) {
+    return {
+      success: false,
+      error: nonNativeError
+    };
+  }
+  return {
+    success: false,
+    error: error62.buildHaiErrorInst(nonNativeError, message || "", cause, suggestion)
+  };
+}
+var CommonErrorInfo = {
+  // 001-099: 初始化和配置
+  NOT_INITIALIZED: "001:500",
+  INIT_FAILED: "002:500",
+  INIT_IN_PROGRESS: "004:500",
+  // 100-199: 认证 & 授权
+  UNAUTHORIZED: "100:401",
+  FORBIDDEN: "101:403",
+  TOKEN_EXPIRED: "102:401",
+  TOKEN_INVALID: "103:401",
+  // 200-299: 校验 & 参数
+  VALIDATION_ERROR: "200:400",
+  INVALID_REQUEST: "201:400",
+  PARAMETER_MISSING: "202:400",
+  // 300-399: 资源操作
+  NOT_FOUND: "300:404",
+  ALREADY_EXISTS: "301:409",
+  CONFLICT: "302:409",
+  // 400-499: 外部依赖
+  API_ERROR: "400:502",
+  NETWORK_ERROR: "401:502",
+  TIMEOUT: "402:504",
+  SERVICE_UNAVAILABLE: "403:503",
+  // 500-599: 内部错误
+  INTERNAL_ERROR: "500:500",
+  DATABASE_ERROR: "501:500",
+  UNKNOWN_ERROR: "599:500"
+};
+var HaiCommonError = error62.buildHaiErrorsDef("common", CommonErrorInfo);
+var ConfigErrorInfo = {
+  CONFIG_FILE_NOT_FOUND: "010:500",
+  CONFIG_PARSE_ERROR: "011:500",
+  CONFIG_VALIDATION_ERROR: "012:500",
+  CONFIG_ENV_VAR_MISSING: "013:500",
+  CONFIG_NOT_LOADED: "014:500"
+};
+var HaiConfigError = error62.buildHaiErrorsDef("core", ConfigErrorInfo);
+
+// src/functions/core-function-log-observer.ts
+var observers = /* @__PURE__ */ new Set();
+var emitting = false;
 function observeLogs(observer) {
   observers.add(observer);
   return () => {
@@ -20463,6 +20505,21 @@ function emitLogRecord(record2) {
 }
 function sanitizeLogFields(value, paths) {
   const result = sanitize.sanitizeSensitiveFields(value);
+  const seen = /* @__PURE__ */ new WeakSet();
+  const clean = (record2) => {
+    if (seen.has(record2))
+      return;
+    seen.add(record2);
+    for (const [key, item] of Object.entries(record2)) {
+      if (typeof item === "string")
+        record2[key] = sanitize.sanitizeText(item);
+      else if (item && typeof item === "object" && (Array.isArray(item) || Object.getPrototypeOf(item) === Object.prototype))
+        clean(item);
+    }
+  };
+  clean(result);
+  if (!result.traceId && result.requestId)
+    result.traceId = result.requestId;
   for (const path of paths)
     redactPath(result, path.match(/\*|[^.[\]"']+/g) ?? []);
   return result;
@@ -20817,6 +20874,99 @@ var object2 = {
   fromEntries
 };
 
+// src/utils/core-util-runtime.ts
+function failure2(module, phase, detail) {
+  const fields = [];
+  if (detail && typeof detail === "object" && "ext" in detail && detail.ext && typeof detail.ext === "object" && "fields" in detail.ext && Array.isArray(detail.ext.fields)) {
+    fields.push(...detail.ext.fields.filter((field) => typeof field === "string" && /^[\w.[\]-]{1,200}$/.test(field)));
+  }
+  if (detail && typeof detail === "object" && "issues" in detail && Array.isArray(detail.issues)) {
+    for (const issue2 of detail.issues) {
+      if (issue2 && typeof issue2 === "object" && "path" in issue2 && Array.isArray(issue2.path)) {
+        const path = issue2.path.filter((part) => typeof part === "string" || typeof part === "number").join(".");
+        if (/^[\w.[\]-]{1,200}$/.test(path))
+          fields.push(path);
+      }
+    }
+  }
+  const code = detail && typeof detail === "object" && "code" in detail && (typeof detail.code === "number" || typeof detail.code === "string") ? detail.code : void 0;
+  return { success: false, error: { ...HaiCommonError.INIT_FAILED, message: i18n.coreM(phase === "start" ? "core_runtimeStartFailed" : "core_runtimeCloseFailed", { params: { module } }), ext: { module, phase, ...code !== void 0 ? { code } : {}, ...fields.length ? { fields } : {} } } };
+}
+function createRuntime(definitions) {
+  const steps = definitions.map((step) => ({ ...step }));
+  const owned = [];
+  let initialized = false;
+  let starting;
+  let closing;
+  async function cleanup() {
+    initialized = false;
+    while (owned.length) {
+      const step = owned.at(-1);
+      try {
+        const result = await step.close();
+        if (result && !result.success)
+          return failure2(step.name, "close", result.error);
+        owned.pop();
+      } catch (cause) {
+        return failure2(step.name, "close", cause);
+      }
+    }
+    return { success: true, data: void 0 };
+  }
+  async function initialize() {
+    if (owned.length) {
+      const cleaned = await cleanup();
+      if (!cleaned.success)
+        return cleaned;
+    }
+    for (const step of steps) {
+      let startFailure;
+      try {
+        if (step.enabled && !step.enabled())
+          continue;
+        owned.push(step);
+        const result = await step.start();
+        if (result && !result.success)
+          startFailure = failure2(step.name, "start", result.error);
+      } catch (cause) {
+        startFailure = failure2(step.name, "start", cause);
+      }
+      if (startFailure) {
+        const cleaned = await cleanup();
+        if (!cleaned.success)
+          startFailure.error.ext = { ...startFailure.error.ext, cleanup: cleaned.error.ext };
+        return startFailure;
+      }
+    }
+    initialized = true;
+    return { success: true, data: void 0 };
+  }
+  return {
+    get isInitialized() {
+      return initialized;
+    },
+    async start() {
+      if (closing)
+        await closing;
+      if (initialized)
+        return { success: true, data: void 0 };
+      starting ??= initialize().finally(() => {
+        starting = void 0;
+      });
+      return starting;
+    },
+    close() {
+      closing ??= (async () => {
+        await starting;
+        return cleanup();
+      })().finally(() => {
+        closing = void 0;
+      });
+      return closing;
+    }
+  };
+}
+
 // src/utils/core-util-string.ts
 var LEADING_LOWERCASE_REGEX = /^[a-z]/;
 function capitalize(str) {
@@ -21137,6 +21287,7 @@ function createCore(loggerFns) {
      * ```
      */
     module: {
+      createRuntime,
       createNotInitializedKit,
       requiresSharedState
     }
@@ -21144,5 +21295,5 @@ function createCore(loggerFns) {
 }
 
 export { CoreConfigSchema, EnvSchema, HaiCommonError, HaiConfigError, LogFormatSchema, LogLevelSchema, LoggingConfigSchema, __commonJS, __toESM, createCore, emitLogRecord, err, i18n, installRequestContext, installRequestLocales, ok, requestContext, sanitize, sanitizeLogFields, typeUtils };
-//# sourceMappingURL=chunk-MUQFCAQ5.js.map
-//# sourceMappingURL=chunk-MUQFCAQ5.js.map
+//# sourceMappingURL=chunk-QPG7M3S3.js.map
+//# sourceMappingURL=chunk-QPG7M3S3.js.map