跳到主要内容

dsh-data-asset-shared

已验证

@liuhange/dsh-data-asset-shared · v3.3.0 · MIT

数据资产化共享基础包 — 共享类型定义、业务常量、工具函数(基础依赖)

安装

dsh plugin add @liuhange/dsh-data-asset-shared

用 dsh --profile default --dump-config 确认 layer 已生效 —— 参见安装指南。

源码

发布到 npm 但没有公开仓库。安装前请检查包内容。

标签

说明文档

# @liuhange/dsh-data-asset-shared

Shared infrastructure for data assetization plugins.

安装

dsh plugin --profile web add @liuhange/dsh-data-asset-shared

Modules

  • BusinessRulesLoader: Loads config/business-rules.json with 5-level config degradation (CONFIG_LOADED / DEFAULT_MISSING / DEFAULT_PARSE / DEFAULT_VERSION / DEFAULT_PARTIAL)
  • FileFormatAdapter: Reads/writes CSV, JSON, TXT, XLSX formats with unknown-format degradation to TXT
  • ReportGenerator: Generates masking, cleaning, inventory, and packaging reports per spec 6.3-6.6
  • PathValidator: Validates file paths against working directory, prevents path traversal attacks
  • AuditLogger: Logs processing operations with [pluginName] message format

Usage

import { BusinessRulesLoader, FileFormatAdapter, ReportGenerator, PathValidator, AuditLogger } from '@liuhange/dsh-data-asset-shared'

const loader = new BusinessRulesLoader()
const { config, status } = loader.load()

Known Limitations and Deferred Work

  • XLSX format support is limited to text-based line reading; full binary XLSX parsing requires the xlsx library
  • Large file streaming (>10MB) is detected but not yet implemented with stream APIs