@ats-cx/cx-core 0.1.0

package/dist/diff/project-diff.js

@@ -0,0 +1,531 @@
+import { normalizeProjectSnapshot } from "../normalize/project.js";
+const PAGE_SECTION_LABELS = Object.freeze({
+    pages: "内页",
+    cover: "封面",
+    frontFlysheet: "前扉页",
+    backFlysheet: "后扉页",
+    edge: "书侧边",
+});
+/**
+ * 对比两个 project 快照。
+ *
+ * 输出重点不是“全文 diff”，而是诊断最关心的三类变化：
+ * - 页面增删
+ * - 元素增删
+ * - 元素几何 / crop / 图片引用变化
+ *
+ * 这样一来，日志里看到 `clickCropImage`、`transformElement`、`saveProject`
+ * 之后，就能直接检查这些动作是否真的改变了 project 状态。
+ */
+export function diffProjectSnapshots(beforeRaw, afterRaw, options = {}) {
+    const before = normalizeProjectSnapshot(beforeRaw);
+    const after = normalizeProjectSnapshot(afterRaw);
+    const beforeProject = getProjectRoot(beforeRaw);
+    const afterProject = getProjectRoot(afterRaw);
+    const maxChanges = options.maxChanges || 100;
+    const beforePages = before.pages.map(enrichPageForDiff);
+    const afterPages = after.pages.map(enrichPageForDiff);
+    const beforePageMap = Object.fromEntries(beforePages.map((page) => [page.id || page.path, page]));
+    const afterPageMap = Object.fromEntries(afterPages.map((page) => [page.id || page.path, page]));
+    const beforeElementMap = Object.fromEntries(before.elements.map((element) => [element.lookupKey, element]));
+    const afterElementMap = Object.fromEntries(after.elements.map((element) => [element.lookupKey, element]));
+    const addedPages = diffAdded(afterPageMap, beforePageMap);
+    const removedPages = diffAdded(beforePageMap, afterPageMap);
+    const addedElements = diffAdded(afterElementMap, beforeElementMap);
+    const removedElements = diffAdded(beforeElementMap, afterElementMap);
+    const changedElements = diffChangedElements(beforeElementMap, afterElementMap).slice(0, maxChanges);
+    const changedProjectMeta = diffProjectMeta(before.projectMeta, after.projectMeta);
+    const pageSectionDiffs = diffPageSections(beforeProject, afterProject, maxChanges);
+    return {
+        generatedAt: new Date().toISOString(),
+        beforeSummary: summarizeSnapshot(before),
+        afterSummary: summarizeSnapshot(after),
+        pageSectionDiffs,
+        changedProjectMeta,
+        addedPages,
+        removedPages,
+        addedElements,
+        removedElements,
+        changedElements,
+        summary: {
+            addedPageCount: addedPages.length,
+            removedPageCount: removedPages.length,
+            addedElementCount: addedElements.length,
+            removedElementCount: removedElements.length,
+            changedElementCount: changedElements.length,
+            changedProjectMetaCount: changedProjectMeta.length,
+        },
+    };
+}
+/**
+ * projectMeta 顶层字段保持浅比较，但对 spec 额外展开一层，
+ * 让报告里的字段名能落成 `spec.size` 这种形式。
+ */
+function diffProjectMeta(beforeMeta, afterMeta) {
+    const { spec: beforeSpec, ...beforeBaseMeta } = beforeMeta || {};
+    const { spec: afterSpec, ...afterBaseMeta } = afterMeta || {};
+    return [
+        ...diffFlatObject(beforeBaseMeta, afterBaseMeta),
+        ...diffFlatObject(beforeSpec || {}, afterSpec || {}, "spec"),
+    ];
+}
+/**
+ * 输出按页面区域划分的 diff。
+ *
+ * 这里补的是 project 原始结构里的几个关键区域：
+ * - pages: 内页
+ * - cover: 封面
+ * - frontFlysheet / backFlysheet: 前后扉页
+ * - edge: 书侧边
+ *
+ * 这样在排查“明明改了封面或扉页，但 diff 看不出来”的 case 时，
+ * 可以直接从结构化结果里看到具体区域发生了什么变化。
+ */
+function diffPageSections(beforeProject, afterProject, maxChanges) {
+    return {
+        pages: diffCollectionSection({
+            key: "pages",
+            label: PAGE_SECTION_LABELS.pages,
+            beforeItems: toArray(beforeProject.pages),
+            afterItems: toArray(afterProject.pages),
+            beforeExists: hasOwn(beforeProject, "pages"),
+            afterExists: hasOwn(afterProject, "pages"),
+            pathPrefix: "project.pages",
+            maxChanges,
+        }),
+        cover: diffCoverSection(beforeProject.cover, afterProject.cover, maxChanges),
+        frontFlysheet: diffCollectionSection({
+            key: "frontFlysheet",
+            label: PAGE_SECTION_LABELS.frontFlysheet,
+            beforeItems: toArray(beforeProject.frontFlysheet),
+            afterItems: toArray(afterProject.frontFlysheet),
+            beforeExists: hasOwn(beforeProject, "frontFlysheet"),
+            afterExists: hasOwn(afterProject, "frontFlysheet"),
+            pathPrefix: "project.frontFlysheet",
+            maxChanges,
+        }),
+        backFlysheet: diffCollectionSection({
+            key: "backFlysheet",
+            label: PAGE_SECTION_LABELS.backFlysheet,
+            beforeItems: toArray(beforeProject.backFlysheet),
+            afterItems: toArray(afterProject.backFlysheet),
+            beforeExists: hasOwn(beforeProject, "backFlysheet"),
+            afterExists: hasOwn(afterProject, "backFlysheet"),
+            pathPrefix: "project.backFlysheet",
+            maxChanges,
+        }),
+        edge: diffCollectionSection({
+            key: "edge",
+            label: PAGE_SECTION_LABELS.edge,
+            beforeItems: toArray(beforeProject.edge),
+            afterItems: toArray(afterProject.edge),
+            beforeExists: hasOwn(beforeProject, "edge"),
+            afterExists: hasOwn(afterProject, "edge"),
+            pathPrefix: "project.edge",
+            maxChanges,
+        }),
+    };
+}
+/**
+ * 对数组型页面区域做 diff，例如 pages / frontFlysheet / backFlysheet / edge。
+ */
+function diffCollectionSection({ key, label, beforeItems, afterItems, beforeExists, afterExists, pathPrefix, maxChanges, }) {
+    const beforeMap = buildSectionItemMap(beforeItems, key, label, pathPrefix);
+    const afterMap = buildSectionItemMap(afterItems, key, label, pathPrefix);
+    const addedItems = diffAddedSectionItems(afterMap, beforeMap);
+    const removedItems = diffAddedSectionItems(beforeMap, afterMap);
+    const changedItems = diffChangedSectionItems(beforeMap, afterMap, maxChanges);
+    return {
+        key,
+        label,
+        beforeExists,
+        afterExists,
+        beforeCount: beforeItems.length,
+        afterCount: afterItems.length,
+        addedItems,
+        removedItems,
+        changedItems,
+        summary: {
+            addedItemCount: addedItems.length,
+            removedItemCount: removedItems.length,
+            changedItemCount: changedItems.length,
+        },
+    };
+}
+/**
+ * cover 不是数组节点，而是一个对象，真正可承载元素的是 `cover.containers`。
+ * 所以这里拆成两层：
+ * - 顶层 cover 元数据变化
+ * - containers 内部各区域变化
+ */
+function diffCoverSection(beforeCover, afterCover, maxChanges) {
+    const beforeMeta = normalizeCoverMeta(beforeCover);
+    const afterMeta = normalizeCoverMeta(afterCover);
+    const changedFields = diffFlatObject(beforeMeta.compareFields, afterMeta.compareFields);
+    const beforeCoverRecord = beforeCover || {};
+    const afterCoverRecord = afterCover || {};
+    const containerDiff = diffCollectionSection({
+        key: "cover",
+        label: PAGE_SECTION_LABELS.cover,
+        beforeItems: toArray(beforeCoverRecord.containers),
+        afterItems: toArray(afterCoverRecord.containers),
+        beforeExists: beforeMeta.exists && Array.isArray(beforeCoverRecord.containers),
+        afterExists: afterMeta.exists && Array.isArray(afterCoverRecord.containers),
+        pathPrefix: "project.cover.containers",
+        maxChanges,
+    });
+    return {
+        key: "cover",
+        label: PAGE_SECTION_LABELS.cover,
+        beforeExists: beforeMeta.exists,
+        afterExists: afterMeta.exists,
+        beforeCount: containerDiff.beforeCount,
+        afterCount: containerDiff.afterCount,
+        changedFields,
+        addedItems: containerDiff.addedItems,
+        removedItems: containerDiff.removedItems,
+        changedItems: containerDiff.changedItems,
+        summary: {
+            changedFieldCount: changedFields.length,
+            addedItemCount: containerDiff.summary.addedItemCount,
+            removedItemCount: containerDiff.summary.removedItemCount,
+            changedItemCount: containerDiff.summary.changedItemCount,
+        },
+    };
+}
+/**
+ * 规范化 cover 顶层字段，只比较对诊断有意义的元信息，
+ * 避免把整棵 cover 对象直接展开成噪音很多的深层 diff。
+ */
+function normalizeCoverMeta(cover) {
+    const exists = Boolean(cover) && typeof cover === "object" && !Array.isArray(cover);
+    const safeCover = (exists ? cover : {});
+    return {
+        exists,
+        compareFields: {
+            width: getFieldValue(safeCover, "width"),
+            height: getFieldValue(safeCover, "height"),
+            bgImageUrl: getFieldValue(safeCover, "bgImageUrl"),
+            bleed: cloneObject(safeCover.bleed),
+            containerCount: Array.isArray(safeCover.containers) ? safeCover.containers.length : 0,
+        },
+    };
+}
+/**
+ * 建 section item 索引时，同时保留：
+ * - record: 输出给 diff JSON 的精简结构
+ * - compareFields: 实际参与字段比较的对象
+ */
+function buildSectionItemMap(items, sectionKey, sectionLabel, pathPrefix) {
+    const map = {};
+    for (let index = 0; index < items.length; index += 1) {
+        const entry = normalizeSectionItem(items[index], index, sectionKey, sectionLabel, pathPrefix);
+        map[entry.record.lookupKey] = entry;
+    }
+    return map;
+}
+/**
+ * 规范化 pages / cover.containers / frontFlysheet / backFlysheet / edge 下的单个 item。
+ */
+function normalizeSectionItem(rawItem, index, sectionKey, sectionLabel, pathPrefix) {
+    const safeItem = rawItem && typeof rawItem === "object" && !Array.isArray(rawItem) ? rawItem : {};
+    const path = `${pathPrefix}[${index}]`;
+    const compareFields = {
+        type: getFieldValue(safeItem, "type"),
+        width: getFieldValue(safeItem, "width"),
+        height: getFieldValue(safeItem, "height"),
+        bgColor: getFieldValue(safeItem, "bgColor"),
+        bgImageUrl: getFieldValue(safeItem, "bgImageUrl"),
+        sheetLocation: getFieldValue(safeItem, "sheetLocation"),
+        elementCount: Array.isArray(safeItem.elements) ? safeItem.elements.length : 0,
+        bleed: cloneObject(safeItem.bleed),
+        backend: cloneObject(safeItem.backend),
+        template: cloneObject(safeItem.template),
+        flysheetParams: cloneObject(safeItem.flysheetParams),
+    };
+    return {
+        record: {
+            lookupKey: getFieldValue(safeItem, "id") || path,
+            id: getFieldValue(safeItem, "id"),
+            path,
+            sectionKey,
+            sectionLabel,
+            itemIndex: index,
+            itemLabel: resolveSectionItemLabel(sectionKey, safeItem, index),
+            type: compareFields.type,
+            width: compareFields.width,
+            height: compareFields.height,
+            bgColor: compareFields.bgColor,
+            bgImageUrl: compareFields.bgImageUrl,
+            sheetLocation: compareFields.sheetLocation,
+            elementCount: compareFields.elementCount,
+            bleed: compareFields.bleed,
+            backend: compareFields.backend,
+            template: compareFields.template,
+            flysheetParams: compareFields.flysheetParams,
+        },
+        compareFields,
+    };
+}
+/**
+ * 计算 section item 的新增列表。
+ */
+function diffAddedSectionItems(sourceMap, targetMap) {
+    return Object.keys(sourceMap)
+        .filter((key) => !targetMap[key])
+        .map((key) => sourceMap[key].record)
+        .slice(0, 100);
+}
+/**
+ * 计算 section item 的字段变化。
+ */
+function diffChangedSectionItems(beforeMap, afterMap, maxChanges) {
+    const changes = [];
+    for (const [lookupKey, beforeEntry] of Object.entries(beforeMap)) {
+        const afterEntry = afterMap[lookupKey];
+        if (!afterEntry) {
+            continue;
+        }
+        const fieldsChanged = diffFlatObject(beforeEntry.compareFields, afterEntry.compareFields);
+        if (!fieldsChanged.length) {
+            continue;
+        }
+        changes.push({
+            lookupKey,
+            id: afterEntry.record.id || beforeEntry.record.id || null,
+            path: afterEntry.record.path,
+            sectionKey: afterEntry.record.sectionKey,
+            sectionLabel: afterEntry.record.sectionLabel,
+            itemLabel: afterEntry.record.itemLabel,
+            type: afterEntry.record.type,
+            fieldsChanged,
+        });
+    }
+    return changes.slice(0, maxChanges);
+}
+/**
+ * 计算 source 相对 target 新增的对象。
+ */
+function diffAdded(sourceMap, targetMap) {
+    return Object.keys(sourceMap)
+        .filter((key) => !targetMap[key])
+        .map((key) => sourceMap[key])
+        .slice(0, 100);
+}
+/**
+ * 针对同一个元素，比较诊断敏感字段。
+ * 当前不追求覆盖所有业务字段，而是先覆盖最可能引发客诉的问题字段。
+ */
+function diffChangedElements(beforeMap, afterMap) {
+    const changes = [];
+    for (const [lookupKey, beforeElement] of Object.entries(beforeMap)) {
+        const afterElement = afterMap[lookupKey];
+        if (!afterElement) {
+            continue;
+        }
+        const fieldDiffs = [
+            ...diffFlatObject(beforeElement.geometry, afterElement.geometry, "geometry"),
+            ...diffFlatObject(beforeElement.crop, afterElement.crop, "crop"),
+            ...diffFlatObject({
+                type: beforeElement.type,
+                pagePath: beforeElement.pagePath,
+                pageOrder: beforeElement.pageOrder,
+                imageRef: beforeElement.imageRef,
+                imageName: beforeElement.imageName,
+            }, {
+                type: afterElement.type,
+                pagePath: afterElement.pagePath,
+                pageOrder: afterElement.pageOrder,
+                imageRef: afterElement.imageRef,
+                imageName: afterElement.imageName,
+            }),
+        ];
+        if (!fieldDiffs.length) {
+            continue;
+        }
+        changes.push({
+            lookupKey,
+            id: afterElement.id || beforeElement.id || null,
+            type: afterElement.type,
+            pagePath: afterElement.pagePath,
+            fieldsChanged: fieldDiffs,
+        });
+    }
+    return changes;
+}
+/**
+ * 对简单对象做字段级 diff。
+ * prefix 用来把字段标记成 `geometry.x`、`crop.cropLUX` 这种形式，方便后续报告直接展示。
+ */
+function diffFlatObject(beforeObject, afterObject, prefix = "") {
+    const keys = [...new Set([...Object.keys(beforeObject || {}), ...Object.keys(afterObject || {})])].sort();
+    const diffs = [];
+    for (const key of keys) {
+        const beforeValue = beforeObject ? beforeObject[key] : undefined;
+        const afterValue = afterObject ? afterObject[key] : undefined;
+        if (stableStringify(beforeValue) === stableStringify(afterValue)) {
+            continue;
+        }
+        diffs.push({
+            field: prefix ? `${prefix}.${key}` : key,
+            before: beforeValue === undefined ? null : beforeValue,
+            after: afterValue === undefined ? null : afterValue,
+        });
+    }
+    return diffs;
+}
+/**
+ * 生成稳定字符串，用于判断两个值是否等价。
+ * 这里不能直接用 JSON.stringify，因为对象 key 顺序可能不稳定。
+ */
+function stableStringify(value) {
+    if (value === null || value === undefined) {
+        return String(value);
+    }
+    if (typeof value !== "object") {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map(stableStringify).join(",")}]`;
+    }
+    const keys = Object.keys(value).sort();
+    return `{${keys.map((key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`).join(",")}}`;
+}
+/**
+ * 输出快照摘要，便于快速对比 before / after 的总体规模变化。
+ */
+function summarizeSnapshot(snapshot) {
+    const pages = snapshot.pages.map(enrichPageForDiff);
+    return {
+        projectMeta: snapshot.projectMeta,
+        imageCount: snapshot.imageCount,
+        pageCount: snapshot.pageCount,
+        elementCount: snapshot.elementCount,
+        pageCollectionCounts: snapshot.pageCollectionCounts,
+        logicalPageCollectionCounts: countBy(pages, (page) => page.logicalCollectionName),
+        elementTypeCounts: snapshot.elementTypeCounts,
+    };
+}
+/**
+ * 给页面补上对业务更友好的“区域标签”。
+ *
+ * 例如：
+ * - `project.pages[0]` -> 内页
+ * - `project.cover.containers[1]` -> 封面 / 书脊
+ * - `project.edge[0]` -> 书侧边 / 顶部侧边
+ */
+function enrichPageForDiff(page) {
+    const logicalCollectionName = resolvePageSectionName(page.path, page.collectionName);
+    return {
+        ...page,
+        logicalCollectionName,
+        logicalCollectionLabel: PAGE_SECTION_LABELS[logicalCollectionName] || page.collectionName || "unknown",
+        logicalItemLabel: resolveSectionItemLabel(logicalCollectionName, page, page.collectionIndex),
+    };
+}
+/**
+ * 从页面路径推导它属于哪个页面区域。
+ */
+function resolvePageSectionName(pagePath, fallbackCollectionName = "") {
+    if (pagePath.startsWith("project.cover")) {
+        return "cover";
+    }
+    if (pagePath.startsWith("project.frontFlysheet[")) {
+        return "frontFlysheet";
+    }
+    if (pagePath.startsWith("project.backFlysheet[")) {
+        return "backFlysheet";
+    }
+    if (pagePath.startsWith("project.edge[")) {
+        return "edge";
+    }
+    if (pagePath.startsWith("project.pages[")) {
+        return "pages";
+    }
+    return fallbackCollectionName || "unknown";
+}
+/**
+ * 把不同 section 下的 item 映射成稳定、可读的标签。
+ */
+function resolveSectionItemLabel(sectionKey, item, index) {
+    switch (sectionKey) {
+        case "cover":
+            return resolveCoverItemLabel(item.type, index);
+        case "frontFlysheet":
+            return resolveFlysheetItemLabel("前扉页", item.type, index);
+        case "backFlysheet":
+            return resolveFlysheetItemLabel("后扉页", item.type, index);
+        case "edge":
+            return resolveEdgeItemLabel(item.type, index);
+        case "pages":
+            return Number.isInteger(index) ? `第 ${index + 1} 页` : "内页";
+        default:
+            return item.type || null;
+    }
+}
+function resolveCoverItemLabel(type, index) {
+    if (type === "Full") {
+        return "封面展开面";
+    }
+    if (type === "Spine") {
+        return "书脊";
+    }
+    return Number.isInteger(index) ? `封面区域 ${index + 1}` : "封面";
+}
+function resolveFlysheetItemLabel(sectionLabel, type, index) {
+    if (type === "leftPage") {
+        return `${sectionLabel}-左页`;
+    }
+    if (type === "rightPage") {
+        return `${sectionLabel}-右页`;
+    }
+    return Number.isInteger(index) ? `${sectionLabel}-${index + 1}` : sectionLabel;
+}
+function resolveEdgeItemLabel(type, index) {
+    if (type === "headEdge") {
+        return "顶部侧边";
+    }
+    if (type === "foreEdge") {
+        return "外侧边";
+    }
+    if (type === "tailEdge") {
+        return "底部侧边";
+    }
+    return Number.isInteger(index) ? `侧边面 ${index + 1}` : PAGE_SECTION_LABELS.edge;
+}
+/**
+ * 统一拿到 project 根节点，兼容：
+ * - { project: {...}, images: [...] }
+ * - 直接传 {...projectFields}
+ */
+function getProjectRoot(rawSnapshot) {
+    if (!rawSnapshot || typeof rawSnapshot !== "object") {
+        return {};
+    }
+    const snapshot = rawSnapshot;
+    return snapshot.project && typeof snapshot.project === "object" ? snapshot.project : snapshot;
+}
+function hasOwn(source, key) {
+    return Boolean(source) && Object.prototype.hasOwnProperty.call(source, key);
+}
+function toArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+function getFieldValue(source, key) {
+    return hasOwn(source, key) ? source[key] : null;
+}
+function cloneObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    return { ...value };
+}
+function countBy(items, iteratee) {
+    const counts = {};
+    for (const item of items) {
+        const key = iteratee(item) || "unknown";
+        counts[key] = (counts[key] || 0) + 1;
+    }
+    return counts;
+}
+//# sourceMappingURL=project-diff.js.map

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+export * from "./types.js";
+export { parseApmProviderConfig } from "./apm/config.js";
+export type { ApmProviderConfig } from "./apm/config.js";
+export { createApmConfigError, ERROR_EMPTY, ERROR_MISSING, HINT, isApmConfigured, SENTENCE, } from "./apm/config-state.js";
+export type { ApmProviderState } from "./apm/config-state.js";
+export { createApmClient } from "./apm/client.js";
+export type { ApmClientDeps, ApmClient, ApmQueryParams, ApmQueryResult, FlushResult, FlushRecord, } from "./apm/client.js";
+export { ApmRequestError } from "./apm/errors.js";
+export type { ApmErrorKind, ApmRequestErrorOptions } from "./apm/errors.js";
+export { fetchLiveProject, resolveUserId } from "./apm/portal.js";
+export type { ApmPortalDeps, FetchLiveProjectParams, LiveProjectResult, ResolveUserIdParams, } from "./apm/portal.js";
+export { assertColumnName, assertSafeValue, FIXED_REQUEST_KEYS, isSiteHost, LOG_TYPES, normalizeLogTime, ORDERS, } from "./apm/values.js";
+export type { ApmOrder, LogType } from "./apm/values.js";
+export { loadConfig, machineConfigDir } from "./config.js";
+export type { ConfigSource, LoadConfigOptions } from "./config.js";
+export { loadEventSemanticsTable } from "./semantics/table-loader.js";
+export type { EventSemanticsTable } from "./semantics/table-loader.js";
+export * from "./normalize/log.js";
+export * from "./normalize/project.js";
+export * from "./semantics/resolver.js";
+export { CASE_CONFLICT_REGISTRY, WHITESPACE_KEY_ALLOWLIST, collectTopLevelKeys, validateEventSemanticsTable, } from "./semantics/table-schema.js";
+export { runDiagnosticRules } from "./rules/engine.js";
+export { diffProjectSnapshots } from "./diff/project-diff.js";
+export type { ProjectDiffResult } from "./diff/project-diff.js";
+export { createFileLogProvider, createLogProvider } from "./providers/log-provider.js";
+export type { LogFetchResult, LogProvenance, LogProvider } from "./providers/log-provider.js";
+export { createProjectProvider } from "./providers/project-provider.js";
+export type { ProjectProvider, ProjectSnapshotVersion } from "./providers/project-provider.js";
+export { createRemoteProjectProvider } from "./providers/remote-project-provider.js";
+export type { ProjectPullEntry, RemoteProjectProvider, RemoteProjectPullResult, } from "./providers/remote-project-provider.js";
+export { createSourceProvider } from "./providers/source-provider.js";
+export type { SourceProvider } from "./providers/source-provider.js";
+export { appendTrace, createRunDir, loadRun, readArtifact, writeArtifact, writeStageStatus, } from "./run/store.js";
+export type { RunHandle, RunInput, StageName, TraceEntry } from "./run/store.js";
+export { diagnosisResultSchema, validateDiagnosisResult } from "./run/result-schema.js";
+export type { DiagnosisResult } from "./run/result-schema.js";
+export { createMysqlClient } from "./db/client.js";
+export type { DbClient, DbParam, DbRow, MysqlClientConfig } from "./db/client.js";

package/dist/index.js

@@ -0,0 +1,23 @@
+export * from "./types.js";
+export { parseApmProviderConfig } from "./apm/config.js";
+export { createApmConfigError, ERROR_EMPTY, ERROR_MISSING, HINT, isApmConfigured, SENTENCE, } from "./apm/config-state.js";
+export { createApmClient } from "./apm/client.js";
+export { ApmRequestError } from "./apm/errors.js";
+export { fetchLiveProject, resolveUserId } from "./apm/portal.js";
+export { assertColumnName, assertSafeValue, FIXED_REQUEST_KEYS, isSiteHost, LOG_TYPES, normalizeLogTime, ORDERS, } from "./apm/values.js";
+export { loadConfig, machineConfigDir } from "./config.js";
+export { loadEventSemanticsTable } from "./semantics/table-loader.js";
+export * from "./normalize/log.js";
+export * from "./normalize/project.js";
+export * from "./semantics/resolver.js";
+export { CASE_CONFLICT_REGISTRY, WHITESPACE_KEY_ALLOWLIST, collectTopLevelKeys, validateEventSemanticsTable, } from "./semantics/table-schema.js";
+export { runDiagnosticRules } from "./rules/engine.js";
+export { diffProjectSnapshots } from "./diff/project-diff.js";
+export { createFileLogProvider, createLogProvider } from "./providers/log-provider.js";
+export { createProjectProvider } from "./providers/project-provider.js";
+export { createRemoteProjectProvider } from "./providers/remote-project-provider.js";
+export { createSourceProvider } from "./providers/source-provider.js";
+export { appendTrace, createRunDir, loadRun, readArtifact, writeArtifact, writeStageStatus, } from "./run/store.js";
+export { diagnosisResultSchema, validateDiagnosisResult } from "./run/result-schema.js";
+export { createMysqlClient } from "./db/client.js";
+//# sourceMappingURL=index.js.map

package/dist/normalize/log.d.ts

@@ -0,0 +1,12 @@
+import type { LogEnvelope } from "../types.js";
+/**
+ * 统一把各种日志返回结构整理成一个标准格式。
+ *
+ * 当前兼容三种输入：
+ * - 直接是数组
+ * - `{ data: { result: [...] } }`
+ * - `{ result: [...] }`
+ *
+ * 这样无论是线上 APM 原始返回，还是离线导出的局部样本，都能直接喂进分析器。
+ */
+export declare function normalizeLogEnvelope(raw: unknown, sourcePath?: string): LogEnvelope;