@whispering233/ai-editor-shared 0.0.1

package/dist/utils/format.js

@@ -0,0 +1,57 @@
+// 文本格式化工具（纯函数，零 Node 依赖——client 浏览器打包安全）
+// 契约来源：doc/api/endpoints.md（会话列表 lastMessage「截断」、settings apiKeyMasked 掩码示例）
+/**
+ * ISO 8601 时间戳 → 本地化 `YYYY-MM-DD HH:mm`（schema.md 时间约定：统一 ISO 8601 字符串）
+ * 非法输入（含空串）原样返回，防御性处理
+ */
+export function formatTimestamp(iso) {
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime()))
+        return iso;
+    const pad = (n) => String(n).padStart(2, "0");
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
+/**
+ * 截断文本：返回总长（含省略号）不超过 maxLen 的字符串；未超长原样返回
+ * 用途：会话列表 lastMessage、长文本展示（endpoints.md）
+ * 边界：maxLen <= 0 返回空串；maxLen = 1 时返回单个省略号
+ */
+export function truncate(text, maxLen) {
+    if (maxLen <= 0)
+        return "";
+    if (text.length <= maxLen)
+        return text;
+    return `${text.slice(0, maxLen - 1)}…`;
+}
+/**
+ * API key 掩码展示（endpoints.md settings apiKeyMasked 示例 `sk-****1234`：保留前 3 后 4）
+ * 过短 key（<= 7 字符，前后缀重叠）整体掩码为 "****"；空串返回 "****"
+ */
+export function maskApiKey(key) {
+    if (key.length <= 7)
+        return "****";
+    return `${key.slice(0, 3)}****${key.slice(-4)}`;
+}
+/**
+ * 相对时间（会话行/概览最近更新展示）：刚刚 / n 分钟前 / n 小时前 / n 天前；
+ * ≥30 天回退绝对时间（formatTimestamp）；非法输入（含空串）原样返回
+ * 说明：从 client Dashboard/Sidebar 抽离（U4 oracle L1：两处重复实现 → shared 共享可单测）
+ */
+export function formatRelativeTime(iso) {
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime()))
+        return iso;
+    const diffMin = Math.floor((Date.now() - date.getTime()) / 60_000);
+    if (diffMin < 1)
+        return "刚刚";
+    if (diffMin < 60)
+        return `${diffMin} 分钟前`;
+    const diffHours = Math.floor(diffMin / 60);
+    if (diffHours < 24)
+        return `${diffHours} 小时前`;
+    const diffDays = Math.floor(diffHours / 24);
+    if (diffDays < 30)
+        return `${diffDays} 天前`;
+    return formatTimestamp(iso);
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,6EAA6E;AAE7E;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,GAAG,CAAC;IAC7C,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;AACtI,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,MAAc;IACnD,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3B,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACnC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,GAAG,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC;IACnE,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,MAAM,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IAC3C,IAAI,SAAS,GAAG,EAAE;QAAE,OAAO,GAAG,SAAS,MAAM,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC;IAC5C,IAAI,QAAQ,GAAG,EAAE;QAAE,OAAO,GAAG,QAAQ,KAAK,CAAC;IAC3C,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC"}

package/dist/utils/id.d.ts

@@ -0,0 +1,28 @@
+import type { EntityType } from "../types/entity.js";
+import type { OutlineNodeType } from "../types/outline.js";
+/** 实体类型 → id 前缀（endpoints.md id 约定） */
+export declare const ENTITY_ID_PREFIX: Record<EntityType, string>;
+/** 大纲节点类型 → id 前缀（endpoints.md id 约定；root 不生成 id） */
+export declare const OUTLINE_NODE_ID_PREFIX: Record<Exclude<OutlineNodeType, "root">, string>;
+/** 运行时对象 id 前缀（endpoints.md：提案 prop_/会话 sess_/工具调用 call_，下划线分隔） */
+export declare const RUNTIME_ID_PREFIX: {
+    readonly proposal: "prop_";
+    readonly session: "sess_";
+    readonly toolCall: "call_";
+};
+/** 运行时对象种类（prop_/sess_/call_） */
+export type RuntimeIdKind = keyof typeof RUNTIME_ID_PREFIX;
+/**
+ * 生成 `{prefix}{nanoid}` 形式 id（nanoid 默认 21 字符，URL 安全字母表）
+ * 示例：generateId("char-") → "char-9f3k2m..."
+ */
+export declare function generateId(prefix: string): string;
+/** 生成实体 id（按类型映射前缀：character→char-、setting→set-、location→loc-、hook→hook-） */
+export declare function generateEntityId(type: EntityType): string;
+/** 生成大纲节点 id（按类型映射前缀：volume→vol-、chapter→ch-、scene→sc-） */
+export declare function generateOutlineNodeId(type: Exclude<OutlineNodeType, "root">): string;
+/** 生成项目 id（proj- 前缀，跨启动稳定，决策 8/10） */
+export declare function generateProjectId(): string;
+/** 生成运行时对象 id（提案 prop_ / 会话 sess_ / 工具调用 call_，不落盘或仅内存） */
+export declare function generateRuntimeId(kind: RuntimeIdKind): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAKvD,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,CAInF,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX,iCAAiC;AACjC,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEzD;AAED,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,MAAM,CAEpF;AAED,sCAAsC;AACtC,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAE7D"}

package/dist/utils/id.js

@@ -0,0 +1,48 @@
+// ID 生成工具
+// 契约来源：doc/api/endpoints.md「id 约定」：{前缀}-{nanoid}；前缀表 char-/set-/loc-/hook-、
+//   sc-/ch-/vol-、proj-（连字符分隔）；prop_/sess_/call_（下划线分隔的运行时对象）
+// nanoid 为环境无关包（浏览器可用），仅在本模块引入，无副作用
+import { nanoid } from "nanoid";
+/** 实体类型 → id 前缀（endpoints.md id 约定） */
+export const ENTITY_ID_PREFIX = {
+    character: "char-",
+    setting: "set-",
+    location: "loc-",
+    hook: "hook-",
+};
+/** 大纲节点类型 → id 前缀（endpoints.md id 约定；root 不生成 id） */
+export const OUTLINE_NODE_ID_PREFIX = {
+    volume: "vol-",
+    chapter: "ch-",
+    scene: "sc-",
+};
+/** 运行时对象 id 前缀（endpoints.md：提案 prop_/会话 sess_/工具调用 call_，下划线分隔） */
+export const RUNTIME_ID_PREFIX = {
+    proposal: "prop_",
+    session: "sess_",
+    toolCall: "call_",
+};
+/**
+ * 生成 `{prefix}{nanoid}` 形式 id（nanoid 默认 21 字符，URL 安全字母表）
+ * 示例：generateId("char-") → "char-9f3k2m..."
+ */
+export function generateId(prefix) {
+    return `${prefix}${nanoid()}`;
+}
+/** 生成实体 id（按类型映射前缀：character→char-、setting→set-、location→loc-、hook→hook-） */
+export function generateEntityId(type) {
+    return generateId(ENTITY_ID_PREFIX[type]);
+}
+/** 生成大纲节点 id（按类型映射前缀：volume→vol-、chapter→ch-、scene→sc-） */
+export function generateOutlineNodeId(type) {
+    return generateId(OUTLINE_NODE_ID_PREFIX[type]);
+}
+/** 生成项目 id（proj- 前缀，跨启动稳定，决策 8/10） */
+export function generateProjectId() {
+    return generateId("proj-");
+}
+/** 生成运行时对象 id（提案 prop_ / 会话 sess_ / 工具调用 call_，不落盘或仅内存） */
+export function generateRuntimeId(kind) {
+    return generateId(RUNTIME_ID_PREFIX[kind]);
+}
+//# sourceMappingURL=id.js.map

package/dist/utils/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,4EAA4E;AAC5E,6DAA6D;AAC7D,oCAAoC;AAEpC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,uCAAuC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAA+B;IAC1D,SAAS,EAAE,OAAO;IAClB,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,MAAM;IAChB,IAAI,EAAE,OAAO;CACd,CAAC;AAEF,qDAAqD;AACrD,MAAM,CAAC,MAAM,sBAAsB,GAAqD;IACtF,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,KAAK;CACb,CAAC;AAEF,mEAAmE;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,OAAO;IACjB,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,OAAO;CACT,CAAC;AAKX;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;AAChC,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAAC,IAAgB;IAC/C,OAAO,UAAU,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,qBAAqB,CAAC,IAAsC;IAC1E,OAAO,UAAU,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,iBAAiB,CAAC,IAAmB;IACnD,OAAO,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./id.js";
+export * from "./format.js";
+export * from "./mapping.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAEA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,6 @@
+// 纯工具函数聚合出口
+// 文件划分见 doc/design/architecture.md（utils/：id.ts / validate.ts / format.ts；validate.ts 随 Zod 于 T1.4 引入）
+export * from "./id.js";
+export * from "./format.js";
+export * from "./mapping.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,uGAAuG;AACvG,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/utils/mapping.d.ts

@@ -0,0 +1,28 @@
+import type { DeltaRecord, DeltaRow, Entity, EntityRow, RelationRecord, RelationRow } from "../types/entity.js";
+import type { OutlineFileTree, OutlineTree } from "../types/outline.js";
+import type { ProjectConfig, ProjectFileConfig } from "../types/project.js";
+/** 单层键映射：snake_case → camelCase（仅用于顶层契约字段，不递归 data） */
+export declare function snakeToCamelKey(key: string): string;
+/** 单层键映射：camelCase → snake_case */
+export declare function camelToSnakeKey(key: string): string;
+/** EntityRow → Entity（created_at → createdAt、deleted_at → deletedAt；data 原样透传） */
+export declare function mapRowToEntity(row: EntityRow): Entity;
+/** Entity → EntityRow（API → 存储；deletedAt 缺失时置 null） */
+export declare function mapEntityToRow(entity: Entity): EntityRow;
+/**
+ * RelationRow → RelationRecord（字段映射；metadata NULL → undefined）
+ * 注意：存储的 updated_at / deleted_at 在 API 形态中不暴露（endpoints.md RelationRecord 仅 createdAt）；
+ * sourceName/targetName 为服务端联表填充，Row 本身不含
+ */
+export declare function mapRowToRelation(row: RelationRow): RelationRecord;
+/** DeltaRow → DeltaRecord（字段映射；changes 原样透传） */
+export declare function mapRowToDelta(row: DeltaRow): DeltaRecord;
+/** OutlineFileTree → OutlineTree（schema_version → schemaVersion；软删字段 deleted_at ↔ deletedAt 一并映射） */
+export declare function mapOutlineFileToTree(file: OutlineFileTree): OutlineTree;
+/** OutlineTree → OutlineFileTree（updatedAt ↔ updated_at、schemaVersion ↔ schema_version） */
+export declare function mapTreeToOutlineFile(tree: OutlineTree): OutlineFileTree;
+/** ProjectFileConfig → ProjectConfig（schema_version → schemaVersion、current_position → currentPosition） */
+export declare function mapProjectFileToConfig(file: ProjectFileConfig): ProjectConfig;
+/** ProjectConfig → ProjectFileConfig */
+export declare function mapConfigToProjectFile(config: ProjectConfig): ProjectFileConfig;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/utils/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../src/utils/mapping.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAChH,OAAO,KAAK,EAKV,eAAe,EAIf,WAAW,EAEZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAID,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAUrD;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAUxD;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,cAAc,CAWjE;AAID,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAWxD;AA4DD,qGAAqG;AACrG,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAQvE;AA0DD,2FAA2F;AAC3F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,CAOvE;AAID,2GAA2G;AAC3G,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAW7E;AAED,wCAAwC;AACxC,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,GAAG,iBAAiB,CAW/E"}

package/dist/utils/mapping.js

@@ -0,0 +1,223 @@
+// 文件字段 ↔ API 字段映射（endpoints.md 通用约定指定位置：@whispering233/ai-editor-shared/utils）
+// 约定（endpoints.md 第 10 行）：请求体/查询参数 snake_case，响应体 camelCase，
+//   outline.json / project.json / data.db 行内部 snake_case；
+//   **嵌套 data 对象内部字段原样透传**（如 expected_payoff 保持 snake_case，2026-08 修订），
+//   camelCase 映射仅应用于 API 顶层契约字段。
+// 两侧锚点：T1.1 定义的双套类型（*Row / OutlineFile* / ProjectFileConfig ↔ API 形态）
+/** 单层键映射：snake_case → camelCase（仅用于顶层契约字段，不递归 data） */
+export function snakeToCamelKey(key) {
+    return key.replace(/_([a-z])/g, (_m, c) => c.toUpperCase());
+}
+/** 单层键映射：camelCase → snake_case */
+export function camelToSnakeKey(key) {
+    return key.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+// ============ 实体（entities 表 ↔ API） ============
+/** EntityRow → Entity（created_at → createdAt、deleted_at → deletedAt；data 原样透传） */
+export function mapRowToEntity(row) {
+    return {
+        id: row.id,
+        type: row.type,
+        name: row.name,
+        data: row.data, // 嵌套对象原样透传（2026-08 修订），不做递归 camelCase
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        deletedAt: row.deleted_at,
+    };
+}
+/** Entity → EntityRow（API → 存储；deletedAt 缺失时置 null） */
+export function mapEntityToRow(entity) {
+    return {
+        id: entity.id,
+        type: entity.type,
+        name: entity.name,
+        data: entity.data,
+        created_at: entity.createdAt,
+        updated_at: entity.updatedAt,
+        deleted_at: entity.deletedAt ?? null,
+    };
+}
+// ============ 关系（relation_records 表 ↔ API） ============
+/**
+ * RelationRow → RelationRecord（字段映射；metadata NULL → undefined）
+ * 注意：存储的 updated_at / deleted_at 在 API 形态中不暴露（endpoints.md RelationRecord 仅 createdAt）；
+ * sourceName/targetName 为服务端联表填充，Row 本身不含
+ */
+export function mapRowToRelation(row) {
+    return {
+        id: row.id,
+        sourceType: row.source_type,
+        sourceId: row.source_id,
+        targetType: row.target_type,
+        targetId: row.target_id,
+        relationType: row.relation_type,
+        metadata: row.metadata ?? undefined,
+        createdAt: row.created_at,
+    };
+}
+// ============ Delta（delta_records 表 ↔ API） ============
+/** DeltaRow → DeltaRecord（字段映射；changes 原样透传） */
+export function mapRowToDelta(row) {
+    return {
+        id: row.id,
+        nodeId: row.node_id,
+        targetType: row.target_type,
+        targetId: row.target_id,
+        changes: row.changes,
+        description: row.description,
+        order: row.order,
+        createdAt: row.created_at,
+    };
+}
+// ============ 大纲（outline.json ↔ API，children 递归映射） ============
+/** OutlineFileVolume → OutlineVolume（递归映射 children） */
+function mapFileVolumeToVolume(file) {
+    return {
+        id: file.id,
+        type: "volume",
+        title: file.title,
+        summary: file.summary,
+        data: file.data, // 嵌套 data 原样透传（决策 23，不做递归 camelCase）
+        updatedAt: file.updated_at,
+        deleted: file.deleted,
+        deletedAt: file.deleted_at,
+        children: file.children?.map(mapFileChapterToChapter),
+    };
+}
+/** OutlineFileChapter → OutlineChapter（递归映射 children） */
+function mapFileChapterToChapter(file) {
+    return {
+        id: file.id,
+        type: "chapter",
+        title: file.title,
+        summary: file.summary,
+        data: file.data, // 嵌套 data 原样透传（决策 23）
+        updatedAt: file.updated_at,
+        deleted: file.deleted,
+        deletedAt: file.deleted_at,
+        children: file.children?.map(mapFileSceneToScene),
+    };
+}
+/** OutlineFileScene → OutlineScene（叶子，无 children） */
+function mapFileSceneToScene(file) {
+    return {
+        id: file.id,
+        type: "scene",
+        title: file.title,
+        summary: file.summary,
+        data: file.data, // 嵌套 data 原样透传（决策 23）
+        updatedAt: file.updated_at,
+        deleted: file.deleted,
+        deletedAt: file.deleted_at,
+    };
+}
+/** OutlineFileNode → OutlineNode（按 type 分派递归映射；支持决策 19「chapter 直挂 root」） */
+function mapFileNodeToNode(file) {
+    switch (file.type) {
+        case "volume":
+            return mapFileVolumeToVolume(file);
+        case "chapter":
+            return mapFileChapterToChapter(file);
+        case "scene":
+            return mapFileSceneToScene(file);
+    }
+}
+/** OutlineFileTree → OutlineTree（schema_version → schemaVersion；软删字段 deleted_at ↔ deletedAt 一并映射） */
+export function mapOutlineFileToTree(file) {
+    return {
+        id: file.id,
+        type: "root",
+        schemaVersion: file.schema_version,
+        // root.children 为 (volume|chapter) 联合（决策 19 允许直挂章），按 type 分派映射
+        children: file.children.map(mapFileNodeToNode),
+    };
+}
+/** OutlineVolume → OutlineFileVolume */
+function mapVolumeToFileVolume(node) {
+    return {
+        id: node.id,
+        type: "volume",
+        title: node.title,
+        summary: node.summary,
+        data: node.data, // 嵌套 data 原样透传（决策 23）
+        updated_at: node.updatedAt,
+        deleted: node.deleted,
+        deleted_at: node.deletedAt,
+        children: node.children?.map(mapChapterToFileChapter),
+    };
+}
+/** OutlineChapter → OutlineFileChapter */
+function mapChapterToFileChapter(node) {
+    return {
+        id: node.id,
+        type: "chapter",
+        title: node.title,
+        summary: node.summary,
+        data: node.data, // 嵌套 data 原样透传（决策 23）
+        updated_at: node.updatedAt,
+        deleted: node.deleted,
+        deleted_at: node.deletedAt,
+        children: node.children?.map(mapSceneToFileScene),
+    };
+}
+/** OutlineScene → OutlineFileScene */
+function mapSceneToFileScene(node) {
+    return {
+        id: node.id,
+        type: "scene",
+        title: node.title,
+        summary: node.summary,
+        data: node.data, // 嵌套 data 原样透传（决策 23）
+        updated_at: node.updatedAt,
+        deleted: node.deleted,
+        deleted_at: node.deletedAt,
+    };
+}
+/** OutlineNode → OutlineFileNode（按 type 分派递归映射；支持决策 19「chapter 直挂 root」） */
+function mapNodeToFileNode(node) {
+    switch (node.type) {
+        case "volume":
+            return mapVolumeToFileVolume(node);
+        case "chapter":
+            return mapChapterToFileChapter(node);
+        case "scene":
+            return mapSceneToFileScene(node);
+    }
+}
+/** OutlineTree → OutlineFileTree（updatedAt ↔ updated_at、schemaVersion ↔ schema_version） */
+export function mapTreeToOutlineFile(tree) {
+    return {
+        id: tree.id,
+        type: "root",
+        schema_version: tree.schemaVersion,
+        children: tree.children.map(mapNodeToFileNode),
+    };
+}
+// ============ 项目（project.json ↔ API） ============
+/** ProjectFileConfig → ProjectConfig（schema_version → schemaVersion、current_position → currentPosition） */
+export function mapProjectFileToConfig(file) {
+    return {
+        id: file.id,
+        name: file.name,
+        language: file.language,
+        prompt: file.prompt,
+        schemaVersion: file.schema_version,
+        currentPosition: file.current_position,
+        createdAt: file.created_at,
+        updatedAt: file.updated_at,
+    };
+}
+/** ProjectConfig → ProjectFileConfig */
+export function mapConfigToProjectFile(config) {
+    return {
+        id: config.id,
+        name: config.name,
+        language: config.language,
+        prompt: config.prompt,
+        schema_version: config.schemaVersion,
+        current_position: config.currentPosition,
+        created_at: config.createdAt,
+        updated_at: config.updatedAt,
+    };
+}
+//# sourceMappingURL=mapping.js.map

package/dist/utils/mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.js","sourceRoot":"","sources":["../../src/utils/mapping.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@whispering233/ai-editor-shared",
+  "version": "0.0.1",
+  "description": "前后端共享层：纯类型 + 常量 + 纯函数（零 Node 依赖）",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./schemas": {
+      "types": "./dist/types/api.d.ts",
+      "import": "./dist/types/api.js"
+    },
+    "./schemas/tools": {
+      "types": "./dist/types/tool.d.ts",
+      "import": "./dist/types/tool.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "prepack": "node ../../scripts/prepare-package-for-publish.mjs",
+    "postpack": "node ../../scripts/restore-package-json.mjs"
+  },
+  "dependencies": {
+    "nanoid": "^5.1.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.0"
+  }
+}