niceeval 0.12.1 → 0.12.2-canary.31

package/dist/shared/entry-file-store.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-file-store.js","sourceRoot":"","sources":["entry-file-store.ts"],"names":[],"mappings":"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","sourcesContent":["// 逐条目原子文件原语:runner/teardown-registry.ts、sandbox/keep-registry.ts、runner/lock.ts\n// 共用的写盘纪律(临时文件 → fsync 文件 → rename → fsync 目录)与损坏容错的全目录扫描,以及\n// rename-墓碑认领互斥点。本模块语义无关——不知道登记/留存/锁各自的内容形状,也不做心跳、\n// 过期判断或 pid/host 这类判活逻辑,那些都留在各消费方自己的模块里。\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { mkdir, open, readdir, readFile, rename, unlink, type FileHandle } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { Effect } from \"effect\";\n/**\n * 持久条目从 JSON.parse 出来后仍是 unknown。每个消费域必须在读取边界提供自己的完整 decoder，\n * 才能把它带入后续业务逻辑；返回 undefined 代表该条目对该领域而言已损坏或不属于该领域。\n */\nexport type EntryDecoder<T extends {}> = (value: unknown) => T | undefined;\n/** 共享层只保留 Node I/O 的真实 unknown failure；各消费域决定哪些读取失败是可恢复的。 */\nexport type EntryFileStoreEffect<A> = Effect.Effect<A, unknown>;\nfunction nodeIo<A>(operation: (signal: AbortSignal) => Promise<A>): EntryFileStoreEffect<A> {\n    return Effect.tryPromise({ try: operation, catch: (cause) => cause });\n}\nfunction nodeSync<A>(operation: () => A): EntryFileStoreEffect<A> {\n    return Effect.try({ try: operation, catch: (cause) => cause });\n}\nfunction errnoCode(cause: unknown): string | undefined {\n    return typeof cause === \"object\" && cause !== null && \"code\" in cause && typeof cause.code === \"string\"\n        ? cause.code\n        : undefined;\n}\nfunction removeFileIfPresent(path: string): EntryFileStoreEffect<void> {\n    return nodeIo(() => unlink(path)).pipe(Effect.catchAll((cause) => errnoCode(cause) === \"ENOENT\" ? Effect.void : Effect.fail(cause)));\n}\n/** 持有 FileHandle 的 Scope；成功、失败与 interruption 都关闭它。 */\nfunction withOpenFile<A>(path: string, flags: string, use: (handle: FileHandle) => EntryFileStoreEffect<A>): EntryFileStoreEffect<A> {\n    return Effect.scoped(Effect.acquireRelease(nodeIo(() => open(path, flags)), (handle) => nodeIo(() => handle.close()).pipe(Effect.orDie)).pipe(Effect.flatMap(use)));\n}\n/** 纯哈希 entry id:parts 用 \":\" 拼接后 sha256,取十六进制前缀。不带可读前缀,只须无碰撞。 */\nexport function hashEntryId(parts: readonly string[], length = 12): string {\n    return createHash(\"sha256\").update(parts.join(\":\")).digest(\"hex\").slice(0, length);\n}\n/**\n * slug + 哈希 entry id:人可读前缀(非 `[\\w.-]` 字符替换为 `-`)拼接 `hashEntryId`,便于在目录里\n * 目测定位是哪条身份;哈希部分仍然是唯一性的权威来源,slug 只是不承载解析的展示前缀。\n */\nexport function slugHashEntryId(slugSource: string, hashParts: readonly string[], length = 12): string {\n    const slug = slugSource.replace(/[^\\w.-]/g, \"-\");\n    return `${slug}-${hashEntryId(hashParts, length)}`;\n}\n/** 原子写入一条 entry:先验证 plain JSON tree，再临时文件 → fsync 文件 → rename → fsync 目录。 */\nexport function writeEntryFileEffect(dir: string, id: string, data: unknown): EntryFileStoreEffect<void> {\n    if (!isPlainJsonTree(data)) {\n        return Effect.fail(new TypeError(\"Entry file data must be a finite, acyclic plain JSON tree\"));\n    }\n    const tmpPath = join(dir, `.${id}.${process.pid}.tmp`);\n    const finalPath = join(dir, `${id}.json`);\n    let renamed = false;\n    const writeTmp = withOpenFile(tmpPath, \"w\", (handle) => nodeIo(() => handle.writeFile(JSON.stringify(data, null, 2), \"utf-8\")).pipe(Effect.zipRight(nodeIo(() => handle.sync()))));\n    return nodeIo(() => mkdir(dir, { recursive: true })).pipe(Effect.zipRight(writeTmp.pipe(Effect.zipRight(nodeIo(() => rename(tmpPath, finalPath)).pipe(Effect.tap(() => Effect.sync(() => {\n        renamed = true;\n    })))), Effect.zipRight(fsyncDirEffect(dir)), \n    // rename 前的失败或 interruption 不能留下会被后续扫描跳过的临时残骸；rename 后\n    // tmp 已不存在，清理只会成为 no-op，不触碰已发布的最终路径。\n    Effect.ensuring(Effect.suspend(() => renamed ? Effect.void : removeFileIfPresent(tmpPath)).pipe(Effect.orDie)))));\n}\n/** unknown 只活在写入边界；通过后才允许交给 JSON.stringify 与持久层。 */\nfunction isPlainJsonTree(value: unknown, ancestors: ReadonlySet<object> = new Set()): boolean {\n    if (value === null || typeof value === \"string\" || typeof value === \"boolean\")\n        return true;\n    if (typeof value === \"number\")\n        return Number.isFinite(value);\n    if (typeof value !== \"object\")\n        return false;\n    if (ancestors.has(value))\n        return false;\n    const prototype = Object.getPrototypeOf(value);\n    if (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null)\n        return false;\n    const next = new Set(ancestors);\n    next.add(value);\n    return Array.isArray(value)\n        ? value.every((item) => isPlainJsonTree(item, next))\n        : Object.values(value).every((item) => isPlainJsonTree(item, next));\n}\n/** 读一条 entry(不存在、JSON 损坏或 decoder 拒绝都返回 undefined,不抛错)。 */\nexport function readEntryFileEffect<T extends {}>(dir: string, id: string, decode: EntryDecoder<T>): EntryFileStoreEffect<T | undefined> {\n    return nodeIo(() => readFile(join(dir, `${id}.json`), \"utf-8\")).pipe(Effect.flatMap((raw) => nodeSync(() => decode(JSON.parse(raw)))), Effect.catchAll(() => Effect.succeed(undefined)));\n}\n/**\n * 读全部 entry(目录不存在返回空集合;跳过点文件与非 `.json` 文件;JSON 损坏或 decoder 拒绝的\n * 条目跳过,不拖垮整次扫描)。\n */\nexport function readAllEntryFilesEffect<T extends {}>(dir: string, decode: EntryDecoder<T>): EntryFileStoreEffect<{\n    id: string;\n    entry: T;\n}[]> {\n    return nodeIo(() => readdir(dir)).pipe(Effect.catchAll(() => Effect.succeed([] as string[])), Effect.flatMap((files) => Effect.forEach(files, (file) => {\n        if (!file.endsWith(\".json\") || file.startsWith(\".\"))\n            return Effect.succeed(undefined);\n        const id = file.slice(0, -\".json\".length);\n        return readEntryFileEffect(dir, id, decode).pipe(Effect.map((entry) => entry === undefined ? undefined : { id, entry }));\n    })), Effect.map((entries) => entries.filter((entry): entry is {\n        id: string;\n        entry: T;\n    } => entry !== undefined)));\n}\n/**\n * 认领互斥点:用 rename 把 entry 移到本次调用独有的墓碑名,而不是直接 `unlink`。同一个源路径的\n * rename 只有一个调用者能命中——其余全部拿到 ENOENT,这把「谁先抢到」这件事和后续清理动作分开,\n * 在某些文件系统里,并发对同一路径 `unlink` 的语义并不保证「恰好一个成功」,而并发 `rename` 到\n * 各自独占的目标名没有这个歧义。抢到墓碑之后再尝试 `unlink` 墓碑并 fsync 目录,但即使墓碑清理\n * 本身失败也不放弃已经拿到的认领权——它已经不在原路径,不会被第二个认领者看到。\n *\n * 两种上层用法共用同一个操作,只是拿到 `true` 之后做的事不同:\n * - 「删除且只删一次」(收尾登记的用法):认领成功即代表删除完成,不必再写回。\n * - 「接管后立刻在原路径重建」(用例锁的过期接管用法):认领成功后原路径已空出,赢家随即在\n *   该路径写入自己的新记录;若这一步撞上 EEXIST(另一个赢家已经抢先写回),按认领失败处理即可,\n *   不需要报错。\n *\n * 返回 `true` 即拿到认领权;返回 `false` 表示 entry 已被别的调用者认领或删除(rename 源\n * ENOENT);其余错误原样抛出。\n */\nexport function claimEntryFileEffect(dir: string, id: string): EntryFileStoreEffect<boolean> {\n    const path = join(dir, `${id}.json`);\n    const claimedPath = join(dir, `.${id}.${process.pid}.${randomUUID()}.claimed`);\n    return nodeIo(() => rename(path, claimedPath)).pipe(Effect.as(true), Effect.catchAll((cause) => errnoCode(cause) === \"ENOENT\" ? Effect.succeed(false) : Effect.fail(cause)), Effect.flatMap((claimed) => claimed\n        ? removeFileIfPresent(claimedPath).pipe(Effect.zipRight(fsyncDirEffect(dir)), Effect.as(true))\n        : Effect.succeed(false)));\n}\n/** 目录 fsync,尽力而为——部分平台/文件系统不支持目录 fsync(如 Windows),静默降级。 */\nexport function fsyncDirEffect(dir: string): EntryFileStoreEffect<void> {\n    return withOpenFile(dir, \"r\", (handle) => nodeIo(() => handle.sync())).pipe(Effect.catchAll(() => Effect.void));\n}\n"]}

package/dist/shared/entry-file-store.d.cts

@@ -0,0 +1,46 @@
+import { Effect } from "effect";
+/**
+ * 持久条目从 JSON.parse 出来后仍是 unknown。每个消费域必须在读取边界提供自己的完整 decoder，
+ * 才能把它带入后续业务逻辑；返回 undefined 代表该条目对该领域而言已损坏或不属于该领域。
+ */
+export type EntryDecoder<T extends {}> = (value: unknown) => T | undefined;
+/** 共享层只保留 Node I/O 的真实 unknown failure；各消费域决定哪些读取失败是可恢复的。 */
+export type EntryFileStoreEffect<A> = Effect.Effect<A, unknown>;
+/** 纯哈希 entry id:parts 用 ":" 拼接后 sha256,取十六进制前缀。不带可读前缀,只须无碰撞。 */
+export declare function hashEntryId(parts: readonly string[], length?: number): string;
+/**
+ * slug + 哈希 entry id:人可读前缀(非 `[\w.-]` 字符替换为 `-`)拼接 `hashEntryId`,便于在目录里
+ * 目测定位是哪条身份;哈希部分仍然是唯一性的权威来源,slug 只是不承载解析的展示前缀。
+ */
+export declare function slugHashEntryId(slugSource: string, hashParts: readonly string[], length?: number): string;
+/** 原子写入一条 entry:先验证 plain JSON tree，再临时文件 → fsync 文件 → rename → fsync 目录。 */
+export declare function writeEntryFileEffect(dir: string, id: string, data: unknown): EntryFileStoreEffect<void>;
+/** 读一条 entry(不存在、JSON 损坏或 decoder 拒绝都返回 undefined,不抛错)。 */
+export declare function readEntryFileEffect<T extends {}>(dir: string, id: string, decode: EntryDecoder<T>): EntryFileStoreEffect<T | undefined>;
+/**
+ * 读全部 entry(目录不存在返回空集合;跳过点文件与非 `.json` 文件;JSON 损坏或 decoder 拒绝的
+ * 条目跳过,不拖垮整次扫描)。
+ */
+export declare function readAllEntryFilesEffect<T extends {}>(dir: string, decode: EntryDecoder<T>): EntryFileStoreEffect<{
+    id: string;
+    entry: T;
+}[]>;
+/**
+ * 认领互斥点:用 rename 把 entry 移到本次调用独有的墓碑名,而不是直接 `unlink`。同一个源路径的
+ * rename 只有一个调用者能命中——其余全部拿到 ENOENT,这把「谁先抢到」这件事和后续清理动作分开,
+ * 在某些文件系统里,并发对同一路径 `unlink` 的语义并不保证「恰好一个成功」,而并发 `rename` 到
+ * 各自独占的目标名没有这个歧义。抢到墓碑之后再尝试 `unlink` 墓碑并 fsync 目录,但即使墓碑清理
+ * 本身失败也不放弃已经拿到的认领权——它已经不在原路径,不会被第二个认领者看到。
+ *
+ * 两种上层用法共用同一个操作,只是拿到 `true` 之后做的事不同:
+ * - 「删除且只删一次」(收尾登记的用法):认领成功即代表删除完成,不必再写回。
+ * - 「接管后立刻在原路径重建」(用例锁的过期接管用法):认领成功后原路径已空出,赢家随即在
+ *   该路径写入自己的新记录;若这一步撞上 EEXIST(另一个赢家已经抢先写回),按认领失败处理即可,
+ *   不需要报错。
+ *
+ * 返回 `true` 即拿到认领权;返回 `false` 表示 entry 已被别的调用者认领或删除(rename 源
+ * ENOENT);其余错误原样抛出。
+ */
+export declare function claimEntryFileEffect(dir: string, id: string): EntryFileStoreEffect<boolean>;
+/** 目录 fsync,尽力而为——部分平台/文件系统不支持目录 fsync(如 Windows),静默降级。 */
+export declare function fsyncDirEffect(dir: string): EntryFileStoreEffect<void>;

package/dist/shared/entry-file-store.d.mts

@@ -0,0 +1,46 @@
+import { Effect } from "effect";
+/**
+ * 持久条目从 JSON.parse 出来后仍是 unknown。每个消费域必须在读取边界提供自己的完整 decoder，
+ * 才能把它带入后续业务逻辑；返回 undefined 代表该条目对该领域而言已损坏或不属于该领域。
+ */
+export type EntryDecoder<T extends {}> = (value: unknown) => T | undefined;
+/** 共享层只保留 Node I/O 的真实 unknown failure；各消费域决定哪些读取失败是可恢复的。 */
+export type EntryFileStoreEffect<A> = Effect.Effect<A, unknown>;
+/** 纯哈希 entry id:parts 用 ":" 拼接后 sha256,取十六进制前缀。不带可读前缀,只须无碰撞。 */
+export declare function hashEntryId(parts: readonly string[], length?: number): string;
+/**
+ * slug + 哈希 entry id:人可读前缀(非 `[\w.-]` 字符替换为 `-`)拼接 `hashEntryId`,便于在目录里
+ * 目测定位是哪条身份;哈希部分仍然是唯一性的权威来源,slug 只是不承载解析的展示前缀。
+ */
+export declare function slugHashEntryId(slugSource: string, hashParts: readonly string[], length?: number): string;
+/** 原子写入一条 entry:先验证 plain JSON tree，再临时文件 → fsync 文件 → rename → fsync 目录。 */
+export declare function writeEntryFileEffect(dir: string, id: string, data: unknown): EntryFileStoreEffect<void>;
+/** 读一条 entry(不存在、JSON 损坏或 decoder 拒绝都返回 undefined,不抛错)。 */
+export declare function readEntryFileEffect<T extends {}>(dir: string, id: string, decode: EntryDecoder<T>): EntryFileStoreEffect<T | undefined>;
+/**
+ * 读全部 entry(目录不存在返回空集合;跳过点文件与非 `.json` 文件;JSON 损坏或 decoder 拒绝的
+ * 条目跳过,不拖垮整次扫描)。
+ */
+export declare function readAllEntryFilesEffect<T extends {}>(dir: string, decode: EntryDecoder<T>): EntryFileStoreEffect<{
+    id: string;
+    entry: T;
+}[]>;
+/**
+ * 认领互斥点:用 rename 把 entry 移到本次调用独有的墓碑名,而不是直接 `unlink`。同一个源路径的
+ * rename 只有一个调用者能命中——其余全部拿到 ENOENT,这把「谁先抢到」这件事和后续清理动作分开,
+ * 在某些文件系统里,并发对同一路径 `unlink` 的语义并不保证「恰好一个成功」,而并发 `rename` 到
+ * 各自独占的目标名没有这个歧义。抢到墓碑之后再尝试 `unlink` 墓碑并 fsync 目录,但即使墓碑清理
+ * 本身失败也不放弃已经拿到的认领权——它已经不在原路径,不会被第二个认领者看到。
+ *
+ * 两种上层用法共用同一个操作,只是拿到 `true` 之后做的事不同:
+ * - 「删除且只删一次」(收尾登记的用法):认领成功即代表删除完成,不必再写回。
+ * - 「接管后立刻在原路径重建」(用例锁的过期接管用法):认领成功后原路径已空出,赢家随即在
+ *   该路径写入自己的新记录;若这一步撞上 EEXIST(另一个赢家已经抢先写回),按认领失败处理即可,
+ *   不需要报错。
+ *
+ * 返回 `true` 即拿到认领权;返回 `false` 表示 entry 已被别的调用者认领或删除(rename 源
+ * ENOENT);其余错误原样抛出。
+ */
+export declare function claimEntryFileEffect(dir: string, id: string): EntryFileStoreEffect<boolean>;
+/** 目录 fsync,尽力而为——部分平台/文件系统不支持目录 fsync(如 Windows),静默降级。 */
+export declare function fsyncDirEffect(dir: string): EntryFileStoreEffect<void>;

package/dist/shared/entry-file-store.d.ts

@@ -1,8 +1,11 @@
+import { Effect } from "effect";
 /**
  * 持久条目从 JSON.parse 出来后仍是 unknown。每个消费域必须在读取边界提供自己的完整 decoder，
  * 才能把它带入后续业务逻辑；返回 undefined 代表该条目对该领域而言已损坏或不属于该领域。
  */
-export type EntryDecoder<T> = (value: unknown) => T | undefined;
+export type EntryDecoder<T extends {}> = (value: unknown) => T | undefined;
+/** 共享层只保留 Node I/O 的真实 unknown failure；各消费域决定哪些读取失败是可恢复的。 */
+export type EntryFileStoreEffect<A> = Effect.Effect<A, unknown>;
 /** 纯哈希 entry id:parts 用 ":" 拼接后 sha256,取十六进制前缀。不带可读前缀,只须无碰撞。 */
 export declare function hashEntryId(parts: readonly string[], length?: number): string;
 /**
@@ -11,14 +14,14 @@ export declare function hashEntryId(parts: readonly string[], length?: number):
  */
 export declare function slugHashEntryId(slugSource: string, hashParts: readonly string[], length?: number): string;
 /** 原子写入一条 entry:先验证 plain JSON tree，再临时文件 → fsync 文件 → rename → fsync 目录。 */
-export declare function writeEntryFile(dir: string, id: string, data: unknown): Promise<void>;
+export declare function writeEntryFileEffect(dir: string, id: string, data: unknown): EntryFileStoreEffect<void>;
 /** 读一条 entry(不存在、JSON 损坏或 decoder 拒绝都返回 undefined,不抛错)。 */
-export declare function readEntryFile<T>(dir: string, id: string, decode: EntryDecoder<T>): Promise<T | undefined>;
+export declare function readEntryFileEffect<T extends {}>(dir: string, id: string, decode: EntryDecoder<T>): EntryFileStoreEffect<T | undefined>;
 /**
  * 读全部 entry(目录不存在返回空集合;跳过点文件与非 `.json` 文件;JSON 损坏或 decoder 拒绝的
  * 条目跳过,不拖垮整次扫描)。
  */
-export declare function readAllEntryFiles<T>(dir: string, decode: EntryDecoder<T>): Promise<{
+export declare function readAllEntryFilesEffect<T extends {}>(dir: string, decode: EntryDecoder<T>): EntryFileStoreEffect<{
     id: string;
     entry: T;
 }[]>;
@@ -38,6 +41,6 @@ export declare function readAllEntryFiles<T>(dir: string, decode: EntryDecoder<T
  * 返回 `true` 即拿到认领权;返回 `false` 表示 entry 已被别的调用者认领或删除(rename 源
  * ENOENT);其余错误原样抛出。
  */
-export declare function claimEntryFile(dir: string, id: string): Promise<boolean>;
+export declare function claimEntryFileEffect(dir: string, id: string): EntryFileStoreEffect<boolean>;
 /** 目录 fsync,尽力而为——部分平台/文件系统不支持目录 fsync(如 Windows),静默降级。 */
-export declare function fsyncDir(dir: string): Promise<void>;
+export declare function fsyncDirEffect(dir: string): EntryFileStoreEffect<void>;

package/dist/shared/entry-file-store.js

@@ -0,0 +1,18 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./entry-file-store.cjs");
+const __niceevalExport0 = __niceevalCanonical["claimEntryFileEffect"];
+export { __niceevalExport0 as claimEntryFileEffect };
+const __niceevalExport1 = __niceevalCanonical["fsyncDirEffect"];
+export { __niceevalExport1 as fsyncDirEffect };
+const __niceevalExport2 = __niceevalCanonical["hashEntryId"];
+export { __niceevalExport2 as hashEntryId };
+const __niceevalExport3 = __niceevalCanonical["readAllEntryFilesEffect"];
+export { __niceevalExport3 as readAllEntryFilesEffect };
+const __niceevalExport4 = __niceevalCanonical["readEntryFileEffect"];
+export { __niceevalExport4 as readEntryFileEffect };
+const __niceevalExport5 = __niceevalCanonical["slugHashEntryId"];
+export { __niceevalExport5 as slugHashEntryId };
+const __niceevalExport6 = __niceevalCanonical["writeEntryFileEffect"];
+export { __niceevalExport6 as writeEntryFileEffect };
+//# sourceMappingURL=entry-file-store.js.map

package/dist/shared/entry-file-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-file-store.js","sources":[],"names":[],"mappings":""}

package/dist/shared/external-cause.cjs

@@ -0,0 +1,278 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeExternalCause = normalizeExternalCause;
+exports.isExternalCause = isExternalCause;
+exports.externalCauseText = externalCauseText;
+exports.externalCauseMessageChain = externalCauseMessageChain;
+const MAX_CAUSE_DEPTH = 5;
+const ABSENT = Object.freeze({ _tag: "Absent" });
+const THROWN_VALUE_TYPES = new Set([
+    "null",
+    "undefined",
+    "string",
+    "number",
+    "boolean",
+    "bigint",
+    "symbol",
+    "function",
+    "object",
+]);
+function isExternalCauseValueType(value) {
+    return typeof value === "string" && THROWN_VALUE_TYPES.has(value);
+}
+function safeString(value) {
+    try {
+        return String(value);
+    }
+    catch {
+        return "[unprintable thrown value]";
+    }
+}
+function field(value, key) {
+    try {
+        return Reflect.get(value, key);
+    }
+    catch {
+        return undefined;
+    }
+}
+function constructorName(value) {
+    try {
+        const name = Object.getPrototypeOf(value)?.constructor?.name;
+        return typeof name === "string" && name !== "" ? name : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function scalarFact(value) {
+    return typeof value === "string" || typeof value === "number"
+        ? Object.freeze({ _tag: "Present", value })
+        : ABSENT;
+}
+function numberFact(value) {
+    return typeof value === "number" && Number.isFinite(value)
+        ? Object.freeze({ _tag: "Present", value })
+        : ABSENT;
+}
+function stringFact(value) {
+    return typeof value === "string" && value !== ""
+        ? Object.freeze({ _tag: "Present", value })
+        : ABSENT;
+}
+function failureClassFact(value) {
+    const tag = field(value, "_tag");
+    if (tag !== "NiceevalClassifiedError")
+        return ABSENT;
+    const candidate = field(value, "class");
+    if (typeof candidate !== "object" || candidate === null)
+        return ABSENT;
+    const retryable = field(candidate, "retryable");
+    const reason = field(candidate, "reason");
+    const scope = field(candidate, "scope");
+    if (typeof retryable !== "boolean")
+        return ABSENT;
+    if (retryable && typeof reason !== "string")
+        return ABSENT;
+    if (reason !== undefined && typeof reason !== "string")
+        return ABSENT;
+    if (scope !== undefined && scope !== "attempt" && scope !== "eval" && scope !== "experiment")
+        return ABSENT;
+    return Object.freeze({
+        _tag: "Present",
+        value: Object.freeze({
+            retryable,
+            ...(reason !== undefined ? { reason } : {}),
+            ...(scope !== undefined ? { scope } : {}),
+        }),
+    });
+}
+/** 已归一化快照再次跨模块边界时，也只接受完整 ADT；绝不原样保留调用者对象。 */
+function snapshotFact(value, accepts) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const tag = field(value, "_tag");
+    if (tag === "Absent")
+        return ABSENT;
+    const candidate = field(value, "value");
+    if (tag !== "Present" || !accepts(candidate))
+        return undefined;
+    return Object.freeze({ _tag: "Present", value: candidate });
+}
+function isExternalCauseScalar(value) {
+    return typeof value === "string" || typeof value === "number";
+}
+function isFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value !== "";
+}
+function isFailureClassSnapshot(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const retryable = field(value, "retryable");
+    const reason = field(value, "reason");
+    const scope = field(value, "scope");
+    return typeof retryable === "boolean" &&
+        (!retryable || typeof reason === "string") &&
+        (reason === undefined || typeof reason === "string") &&
+        (scope === undefined || scope === "attempt" || scope === "eval" || scope === "experiment");
+}
+function snapshotFailureClass(value) {
+    const fact = snapshotFact(value, isFailureClassSnapshot);
+    if (fact === undefined || fact._tag !== "Present")
+        return fact;
+    return Object.freeze({
+        _tag: "Present",
+        value: Object.freeze({
+            retryable: fact.value.retryable,
+            ...(fact.value.reason !== undefined ? { reason: fact.value.reason } : {}),
+            ...(fact.value.scope !== undefined ? { scope: fact.value.scope } : {}),
+        }),
+    });
+}
+function snapshotLink(value, depth, ancestors) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const tag = field(value, "_tag");
+    if (tag === "Absent")
+        return ABSENT;
+    if (tag === "Truncated") {
+        const reason = field(value, "reason");
+        return reason === "cycle" || reason === "depth"
+            ? Object.freeze({ _tag: "Truncated", reason })
+            : undefined;
+    }
+    if (tag !== "Cause" || depth + 1 >= MAX_CAUSE_DEPTH)
+        return undefined;
+    const nested = field(value, "value");
+    if (typeof nested !== "object" || nested === null || ancestors.has(nested))
+        return undefined;
+    const nextAncestors = new Set(ancestors);
+    nextAncestors.add(value);
+    const normalized = snapshotCause(nested, depth + 1, nextAncestors);
+    return normalized === undefined
+        ? undefined
+        : Object.freeze({ _tag: "Cause", value: normalized });
+}
+/** 对已归一化快照做完整结构解码、复制和冻结；undefined 表示走普通 throwable 归一。 */
+function snapshotCause(value, depth, ancestors) {
+    const tag = field(value, "_tag");
+    if (tag === "ThrownValue") {
+        const valueType = field(value, "valueType");
+        const message = field(value, "message");
+        const cause = snapshotLink(field(value, "cause"), depth, ancestors);
+        if (!isExternalCauseValueType(valueType) || typeof message !== "string" || cause?._tag !== "Absent") {
+            return undefined;
+        }
+        return Object.freeze({ _tag: "ThrownValue", valueType, message, cause: ABSENT });
+    }
+    if (tag !== "Error" && tag !== "Object")
+        return undefined;
+    const name = field(value, "name");
+    const message = field(value, "message");
+    const code = snapshotFact(field(value, "code"), isExternalCauseScalar);
+    const status = snapshotFact(field(value, "status"), isFiniteNumber);
+    const stack = snapshotFact(field(value, "stack"), isNonEmptyString);
+    const failureClass = snapshotFailureClass(field(value, "failureClass"));
+    const cause = snapshotLink(field(value, "cause"), depth, ancestors);
+    if (typeof name !== "string" || name === "" || typeof message !== "string" ||
+        code === undefined || status === undefined || stack === undefined || failureClass === undefined || cause === undefined)
+        return undefined;
+    return Object.freeze({ _tag: tag, name, message, code, status, stack, failureClass, cause });
+}
+function isError(value) {
+    try {
+        return value instanceof Error;
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeObject(value, depth, ancestors) {
+    const nameValue = field(value, "name");
+    const name = typeof nameValue === "string" && nameValue !== ""
+        ? nameValue
+        : constructorName(value) ?? "Object";
+    const messageValue = field(value, "message");
+    const message = typeof messageValue === "string" && messageValue !== "" ? messageValue : safeString(value);
+    const rawCause = field(value, "cause");
+    let cause = ABSENT;
+    if (rawCause !== undefined && rawCause !== null) {
+        if (depth + 1 >= MAX_CAUSE_DEPTH) {
+            cause = { _tag: "Truncated", reason: "depth" };
+        }
+        else if (typeof rawCause === "object" && (rawCause === value || ancestors.has(rawCause))) {
+            cause = { _tag: "Truncated", reason: "cycle" };
+        }
+        else {
+            const nextAncestors = new Set(ancestors);
+            nextAncestors.add(value);
+            cause = { _tag: "Cause", value: normalizeCause(rawCause, depth + 1, nextAncestors) };
+        }
+    }
+    return Object.freeze({
+        _tag: isError(value) ? "Error" : "Object",
+        name,
+        message,
+        code: scalarFact(field(value, "code") ?? field(value, "errorCode")),
+        status: numberFact(field(value, "status") ?? field(value, "statusCode") ?? field(value, "httpStatus")),
+        stack: stringFact(field(value, "stack")),
+        failureClass: failureClassFact(value),
+        cause,
+    });
+}
+function normalizeCause(value, depth, ancestors) {
+    if (typeof value === "object" && value !== null) {
+        // 已经是快照也必须重新解码并深冻结，避免跨 package / JSON 往返的可变伪对象进入状态。
+        return snapshotCause(value, depth, ancestors) ?? normalizeObject(value, depth, ancestors);
+    }
+    return Object.freeze({
+        _tag: "ThrownValue",
+        valueType: value === null ? "null" : typeof value,
+        message: safeString(value),
+        cause: ABSENT,
+    });
+}
+/** 动态 throwable 进入内部状态的唯一正规化边界。 */
+function normalizeExternalCause(value) {
+    return normalizeCause(value, 0, new Set());
+}
+/** 已正规化快照的结构守卫；接收跨 package 副本的纯数据 ADT。 */
+function isExternalCause(value) {
+    return typeof value === "object" && value !== null && snapshotCause(value, 0, new Set()) !== undefined;
+}
+function causeLabel(cause) {
+    const code = cause.code._tag === "Present" ? ` (${String(cause.code.value)})` : "";
+    return `${cause.name}${code}: ${cause.message}`;
+}
+/** 与 formatThrown 相同的可行动文本口径，但输入已经是强类型快照。 */
+function externalCauseText(cause) {
+    if (cause._tag === "ThrownValue")
+        return cause.message;
+    const first = cause.stack._tag === "Present" ? cause.stack.value : `${cause.name}: ${cause.message}`;
+    const suffix = [];
+    let link = cause.cause;
+    while (link._tag === "Cause") {
+        const nested = link.value;
+        suffix.push(`  caused by: ${nested._tag === "ThrownValue" ? nested.message : causeLabel(nested)}`);
+        link = nested.cause;
+    }
+    if (link._tag === "Truncated")
+        suffix.push(`  caused by: [${link.reason} truncated]`);
+    return suffix.length === 0 ? first : `${first}\n${suffix.join("\n")}`;
+}
+/** 分类器与单行错误摘要共用的 message 链，不读取 stack 或任意原始对象字段。 */
+function externalCauseMessageChain(cause) {
+    const messages = [cause.message];
+    let link = cause.cause;
+    while (link._tag === "Cause") {
+        messages.push(link.value.message);
+        link = link.value.cause;
+    }
+    if (link._tag === "Truncated")
+        messages.push(`[${link.reason} truncated]`);
+    return messages.filter((message) => message !== "").join(" · ");
+}
+//# sourceMappingURL=external-cause.cjs.map

package/dist/shared/external-cause.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-cause.js","sourceRoot":"","sources":["external-cause.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 外部 throwable 的有界快照。`unknown` 只存在于 normalizeExternalCause 的输入边界；\n * 进入领域对象后，字段缺席、cause 截断与非 Error 抛出值都有显式 ADT 分支。\n */\nimport type { FailureClass } from \"./failure-class.ts\";\nexport type ExternalCauseScalar = string | number;\nexport type ExternalCauseFact<Value> = {\n    readonly _tag: \"Absent\";\n} | {\n    readonly _tag: \"Present\";\n    readonly value: Value;\n};\nexport type ExternalCauseLink = {\n    readonly _tag: \"Absent\";\n} | {\n    readonly _tag: \"Cause\";\n    readonly value: ExternalCause;\n} | {\n    readonly _tag: \"Truncated\";\n    readonly reason: \"cycle\" | \"depth\";\n};\ninterface ExternalObjectFacts {\n    readonly name: string;\n    readonly message: string;\n    readonly code: ExternalCauseFact<ExternalCauseScalar>;\n    readonly status: ExternalCauseFact<number>;\n    readonly stack: ExternalCauseFact<string>;\n    readonly failureClass: ExternalCauseFact<FailureClass>;\n    readonly cause: ExternalCauseLink;\n}\nexport type ExternalCause = ({\n    readonly _tag: \"Error\";\n} & ExternalObjectFacts) | ({\n    readonly _tag: \"Object\";\n} & ExternalObjectFacts) | {\n    readonly _tag: \"ThrownValue\";\n    readonly valueType: \"null\" | \"undefined\" | \"string\" | \"number\" | \"boolean\" | \"bigint\" | \"symbol\" | \"function\" | \"object\";\n    readonly message: string;\n    readonly cause: {\n        readonly _tag: \"Absent\";\n    };\n};\nconst MAX_CAUSE_DEPTH = 5;\nconst ABSENT = Object.freeze({ _tag: \"Absent\" as const });\ntype ExternalCauseValueType = Extract<ExternalCause, {\n    readonly _tag: \"ThrownValue\";\n}>[\"valueType\"];\nconst THROWN_VALUE_TYPES = new Set<ExternalCauseValueType>([\n    \"null\",\n    \"undefined\",\n    \"string\",\n    \"number\",\n    \"boolean\",\n    \"bigint\",\n    \"symbol\",\n    \"function\",\n    \"object\",\n]);\nfunction isExternalCauseValueType(value: unknown): value is ExternalCauseValueType {\n    return typeof value === \"string\" && THROWN_VALUE_TYPES.has(value as ExternalCauseValueType);\n}\nfunction safeString(value: unknown): string {\n    try {\n        return String(value);\n    }\n    catch {\n        return \"[unprintable thrown value]\";\n    }\n}\nfunction field(value: object, key: string): unknown {\n    try {\n        return Reflect.get(value, key);\n    }\n    catch {\n        return undefined;\n    }\n}\nfunction constructorName(value: object): string | undefined {\n    try {\n        const name = Object.getPrototypeOf(value)?.constructor?.name;\n        return typeof name === \"string\" && name !== \"\" ? name : undefined;\n    }\n    catch {\n        return undefined;\n    }\n}\nfunction scalarFact(value: unknown): ExternalCauseFact<ExternalCauseScalar> {\n    return typeof value === \"string\" || typeof value === \"number\"\n        ? Object.freeze({ _tag: \"Present\" as const, value })\n        : ABSENT;\n}\nfunction numberFact(value: unknown): ExternalCauseFact<number> {\n    return typeof value === \"number\" && Number.isFinite(value)\n        ? Object.freeze({ _tag: \"Present\" as const, value })\n        : ABSENT;\n}\nfunction stringFact(value: unknown): ExternalCauseFact<string> {\n    return typeof value === \"string\" && value !== \"\"\n        ? Object.freeze({ _tag: \"Present\" as const, value })\n        : ABSENT;\n}\nfunction failureClassFact(value: object): ExternalCauseFact<FailureClass> {\n    const tag = field(value, \"_tag\");\n    if (tag !== \"NiceevalClassifiedError\")\n        return ABSENT;\n    const candidate = field(value, \"class\");\n    if (typeof candidate !== \"object\" || candidate === null)\n        return ABSENT;\n    const retryable = field(candidate, \"retryable\");\n    const reason = field(candidate, \"reason\");\n    const scope = field(candidate, \"scope\");\n    if (typeof retryable !== \"boolean\")\n        return ABSENT;\n    if (retryable && typeof reason !== \"string\")\n        return ABSENT;\n    if (reason !== undefined && typeof reason !== \"string\")\n        return ABSENT;\n    if (scope !== undefined && scope !== \"attempt\" && scope !== \"eval\" && scope !== \"experiment\")\n        return ABSENT;\n    return Object.freeze({\n        _tag: \"Present\" as const,\n        value: Object.freeze({\n            retryable,\n            ...(reason !== undefined ? { reason } : {}),\n            ...(scope !== undefined ? { scope } : {}),\n        }) as FailureClass,\n    });\n}\n/** 已归一化快照再次跨模块边界时，也只接受完整 ADT；绝不原样保留调用者对象。 */\nfunction snapshotFact<Value>(value: unknown, accepts: (candidate: unknown) => candidate is Value): ExternalCauseFact<Value> | undefined {\n    if (typeof value !== \"object\" || value === null)\n        return undefined;\n    const tag = field(value, \"_tag\");\n    if (tag === \"Absent\")\n        return ABSENT;\n    const candidate = field(value, \"value\");\n    if (tag !== \"Present\" || !accepts(candidate))\n        return undefined;\n    return Object.freeze({ _tag: \"Present\" as const, value: candidate });\n}\nfunction isExternalCauseScalar(value: unknown): value is ExternalCauseScalar {\n    return typeof value === \"string\" || typeof value === \"number\";\n}\nfunction isFiniteNumber(value: unknown): value is number {\n    return typeof value === \"number\" && Number.isFinite(value);\n}\nfunction isNonEmptyString(value: unknown): value is string {\n    return typeof value === \"string\" && value !== \"\";\n}\nfunction isFailureClassSnapshot(value: unknown): value is FailureClass {\n    if (typeof value !== \"object\" || value === null)\n        return false;\n    const retryable = field(value, \"retryable\");\n    const reason = field(value, \"reason\");\n    const scope = field(value, \"scope\");\n    return typeof retryable === \"boolean\" &&\n        (!retryable || typeof reason === \"string\") &&\n        (reason === undefined || typeof reason === \"string\") &&\n        (scope === undefined || scope === \"attempt\" || scope === \"eval\" || scope === \"experiment\");\n}\nfunction snapshotFailureClass(value: unknown): ExternalCauseFact<FailureClass> | undefined {\n    const fact = snapshotFact(value, isFailureClassSnapshot);\n    if (fact === undefined || fact._tag !== \"Present\")\n        return fact;\n    return Object.freeze({\n        _tag: \"Present\" as const,\n        value: Object.freeze({\n            retryable: fact.value.retryable,\n            ...(fact.value.reason !== undefined ? { reason: fact.value.reason } : {}),\n            ...(fact.value.scope !== undefined ? { scope: fact.value.scope } : {}),\n        }) as FailureClass,\n    });\n}\nfunction snapshotLink(value: unknown, depth: number, ancestors: ReadonlySet<object>): ExternalCauseLink | undefined {\n    if (typeof value !== \"object\" || value === null)\n        return undefined;\n    const tag = field(value, \"_tag\");\n    if (tag === \"Absent\")\n        return ABSENT;\n    if (tag === \"Truncated\") {\n        const reason = field(value, \"reason\");\n        return reason === \"cycle\" || reason === \"depth\"\n            ? Object.freeze({ _tag: \"Truncated\" as const, reason })\n            : undefined;\n    }\n    if (tag !== \"Cause\" || depth + 1 >= MAX_CAUSE_DEPTH)\n        return undefined;\n    const nested = field(value, \"value\");\n    if (typeof nested !== \"object\" || nested === null || ancestors.has(nested))\n        return undefined;\n    const nextAncestors = new Set(ancestors);\n    nextAncestors.add(value);\n    const normalized = snapshotCause(nested, depth + 1, nextAncestors);\n    return normalized === undefined\n        ? undefined\n        : Object.freeze({ _tag: \"Cause\" as const, value: normalized });\n}\n/** 对已归一化快照做完整结构解码、复制和冻结；undefined 表示走普通 throwable 归一。 */\nfunction snapshotCause(value: object, depth: number, ancestors: ReadonlySet<object>): ExternalCause | undefined {\n    const tag = field(value, \"_tag\");\n    if (tag === \"ThrownValue\") {\n        const valueType = field(value, \"valueType\");\n        const message = field(value, \"message\");\n        const cause = snapshotLink(field(value, \"cause\"), depth, ancestors);\n        if (!isExternalCauseValueType(valueType) || typeof message !== \"string\" || cause?._tag !== \"Absent\") {\n            return undefined;\n        }\n        return Object.freeze({ _tag: \"ThrownValue\" as const, valueType, message, cause: ABSENT });\n    }\n    if (tag !== \"Error\" && tag !== \"Object\")\n        return undefined;\n    const name = field(value, \"name\");\n    const message = field(value, \"message\");\n    const code = snapshotFact(field(value, \"code\"), isExternalCauseScalar);\n    const status = snapshotFact(field(value, \"status\"), isFiniteNumber);\n    const stack = snapshotFact(field(value, \"stack\"), isNonEmptyString);\n    const failureClass = snapshotFailureClass(field(value, \"failureClass\"));\n    const cause = snapshotLink(field(value, \"cause\"), depth, ancestors);\n    if (typeof name !== \"string\" || name === \"\" || typeof message !== \"string\" ||\n        code === undefined || status === undefined || stack === undefined || failureClass === undefined || cause === undefined)\n        return undefined;\n    return Object.freeze({ _tag: tag, name, message, code, status, stack, failureClass, cause });\n}\nfunction isError(value: object): boolean {\n    try {\n        return value instanceof Error;\n    }\n    catch {\n        return false;\n    }\n}\nfunction normalizeObject(value: object, depth: number, ancestors: ReadonlySet<object>): ExternalCause {\n    const nameValue = field(value, \"name\");\n    const name = typeof nameValue === \"string\" && nameValue !== \"\"\n        ? nameValue\n        : constructorName(value) ?? \"Object\";\n    const messageValue = field(value, \"message\");\n    const message = typeof messageValue === \"string\" && messageValue !== \"\" ? messageValue : safeString(value);\n    const rawCause = field(value, \"cause\");\n    let cause: ExternalCauseLink = ABSENT;\n    if (rawCause !== undefined && rawCause !== null) {\n        if (depth + 1 >= MAX_CAUSE_DEPTH) {\n            cause = { _tag: \"Truncated\", reason: \"depth\" };\n        }\n        else if (typeof rawCause === \"object\" && (rawCause === value || ancestors.has(rawCause))) {\n            cause = { _tag: \"Truncated\", reason: \"cycle\" };\n        }\n        else {\n            const nextAncestors = new Set(ancestors);\n            nextAncestors.add(value);\n            cause = { _tag: \"Cause\", value: normalizeCause(rawCause, depth + 1, nextAncestors) };\n        }\n    }\n    return Object.freeze({\n        _tag: isError(value) ? \"Error\" as const : \"Object\" as const,\n        name,\n        message,\n        code: scalarFact(field(value, \"code\") ?? field(value, \"errorCode\")),\n        status: numberFact(field(value, \"status\") ?? field(value, \"statusCode\") ?? field(value, \"httpStatus\")),\n        stack: stringFact(field(value, \"stack\")),\n        failureClass: failureClassFact(value),\n        cause,\n    });\n}\nfunction normalizeCause(value: unknown, depth: number, ancestors: ReadonlySet<object>): ExternalCause {\n    if (typeof value === \"object\" && value !== null) {\n        // 已经是快照也必须重新解码并深冻结，避免跨 package / JSON 往返的可变伪对象进入状态。\n        return snapshotCause(value, depth, ancestors) ?? normalizeObject(value, depth, ancestors);\n    }\n    return Object.freeze({\n        _tag: \"ThrownValue\" as const,\n        valueType: value === null ? \"null\" as const : typeof value,\n        message: safeString(value),\n        cause: ABSENT,\n    });\n}\n/** 动态 throwable 进入内部状态的唯一正规化边界。 */\nexport function normalizeExternalCause(value: unknown): ExternalCause {\n    return normalizeCause(value, 0, new Set());\n}\n/** 已正规化快照的结构守卫；接收跨 package 副本的纯数据 ADT。 */\nexport function isExternalCause(value: unknown): value is ExternalCause {\n    return typeof value === \"object\" && value !== null && snapshotCause(value, 0, new Set()) !== undefined;\n}\nfunction causeLabel(cause: Extract<ExternalCause, {\n    readonly _tag: \"Error\" | \"Object\";\n}>): string {\n    const code = cause.code._tag === \"Present\" ? ` (${String(cause.code.value)})` : \"\";\n    return `${cause.name}${code}: ${cause.message}`;\n}\n/** 与 formatThrown 相同的可行动文本口径，但输入已经是强类型快照。 */\nexport function externalCauseText(cause: ExternalCause): string {\n    if (cause._tag === \"ThrownValue\")\n        return cause.message;\n    const first = cause.stack._tag === \"Present\" ? cause.stack.value : `${cause.name}: ${cause.message}`;\n    const suffix: string[] = [];\n    let link = cause.cause;\n    while (link._tag === \"Cause\") {\n        const nested = link.value;\n        suffix.push(`  caused by: ${nested._tag === \"ThrownValue\" ? nested.message : causeLabel(nested)}`);\n        link = nested.cause;\n    }\n    if (link._tag === \"Truncated\")\n        suffix.push(`  caused by: [${link.reason} truncated]`);\n    return suffix.length === 0 ? first : `${first}\\n${suffix.join(\"\\n\")}`;\n}\n/** 分类器与单行错误摘要共用的 message 链，不读取 stack 或任意原始对象字段。 */\nexport function externalCauseMessageChain(cause: ExternalCause): string {\n    const messages = [cause.message];\n    let link = cause.cause;\n    while (link._tag === \"Cause\") {\n        messages.push(link.value.message);\n        link = link.value.cause;\n    }\n    if (link._tag === \"Truncated\")\n        messages.push(`[${link.reason} truncated]`);\n    return messages.filter((message) => message !== \"\").join(\" · \");\n}\n"]}

package/dist/shared/external-cause.d.cts

@@ -0,0 +1,51 @@
+/**
+ * 外部 throwable 的有界快照。`unknown` 只存在于 normalizeExternalCause 的输入边界；
+ * 进入领域对象后，字段缺席、cause 截断与非 Error 抛出值都有显式 ADT 分支。
+ */
+import type { FailureClass } from "./failure-class.cjs";
+export type ExternalCauseScalar = string | number;
+export type ExternalCauseFact<Value> = {
+    readonly _tag: "Absent";
+} | {
+    readonly _tag: "Present";
+    readonly value: Value;
+};
+export type ExternalCauseLink = {
+    readonly _tag: "Absent";
+} | {
+    readonly _tag: "Cause";
+    readonly value: ExternalCause;
+} | {
+    readonly _tag: "Truncated";
+    readonly reason: "cycle" | "depth";
+};
+interface ExternalObjectFacts {
+    readonly name: string;
+    readonly message: string;
+    readonly code: ExternalCauseFact<ExternalCauseScalar>;
+    readonly status: ExternalCauseFact<number>;
+    readonly stack: ExternalCauseFact<string>;
+    readonly failureClass: ExternalCauseFact<FailureClass>;
+    readonly cause: ExternalCauseLink;
+}
+export type ExternalCause = ({
+    readonly _tag: "Error";
+} & ExternalObjectFacts) | ({
+    readonly _tag: "Object";
+} & ExternalObjectFacts) | {
+    readonly _tag: "ThrownValue";
+    readonly valueType: "null" | "undefined" | "string" | "number" | "boolean" | "bigint" | "symbol" | "function" | "object";
+    readonly message: string;
+    readonly cause: {
+        readonly _tag: "Absent";
+    };
+};
+/** 动态 throwable 进入内部状态的唯一正规化边界。 */
+export declare function normalizeExternalCause(value: unknown): ExternalCause;
+/** 已正规化快照的结构守卫；接收跨 package 副本的纯数据 ADT。 */
+export declare function isExternalCause(value: unknown): value is ExternalCause;
+/** 与 formatThrown 相同的可行动文本口径，但输入已经是强类型快照。 */
+export declare function externalCauseText(cause: ExternalCause): string;
+/** 分类器与单行错误摘要共用的 message 链，不读取 stack 或任意原始对象字段。 */
+export declare function externalCauseMessageChain(cause: ExternalCause): string;
+export {};

package/dist/shared/external-cause.d.mts

@@ -0,0 +1,51 @@
+/**
+ * 外部 throwable 的有界快照。`unknown` 只存在于 normalizeExternalCause 的输入边界；
+ * 进入领域对象后，字段缺席、cause 截断与非 Error 抛出值都有显式 ADT 分支。
+ */
+import type { FailureClass } from "./failure-class.mjs";
+export type ExternalCauseScalar = string | number;
+export type ExternalCauseFact<Value> = {
+    readonly _tag: "Absent";
+} | {
+    readonly _tag: "Present";
+    readonly value: Value;
+};
+export type ExternalCauseLink = {
+    readonly _tag: "Absent";
+} | {
+    readonly _tag: "Cause";
+    readonly value: ExternalCause;
+} | {
+    readonly _tag: "Truncated";
+    readonly reason: "cycle" | "depth";
+};
+interface ExternalObjectFacts {
+    readonly name: string;
+    readonly message: string;
+    readonly code: ExternalCauseFact<ExternalCauseScalar>;
+    readonly status: ExternalCauseFact<number>;
+    readonly stack: ExternalCauseFact<string>;
+    readonly failureClass: ExternalCauseFact<FailureClass>;
+    readonly cause: ExternalCauseLink;
+}
+export type ExternalCause = ({
+    readonly _tag: "Error";
+} & ExternalObjectFacts) | ({
+    readonly _tag: "Object";
+} & ExternalObjectFacts) | {
+    readonly _tag: "ThrownValue";
+    readonly valueType: "null" | "undefined" | "string" | "number" | "boolean" | "bigint" | "symbol" | "function" | "object";
+    readonly message: string;
+    readonly cause: {
+        readonly _tag: "Absent";
+    };
+};
+/** 动态 throwable 进入内部状态的唯一正规化边界。 */
+export declare function normalizeExternalCause(value: unknown): ExternalCause;
+/** 已正规化快照的结构守卫；接收跨 package 副本的纯数据 ADT。 */
+export declare function isExternalCause(value: unknown): value is ExternalCause;
+/** 与 formatThrown 相同的可行动文本口径，但输入已经是强类型快照。 */
+export declare function externalCauseText(cause: ExternalCause): string;
+/** 分类器与单行错误摘要共用的 message 链，不读取 stack 或任意原始对象字段。 */
+export declare function externalCauseMessageChain(cause: ExternalCause): string;
+export {};