zentao-api 0.4.1 → 0.5.1

package/dist/modules/query.d.ts

@@ -52,3 +52,10 @@ export declare function getModuleNames(): string[];
  * @returns 已注册返回 `true`，否则 `false`。
  */
 export declare function isModuleName(moduleName: string): boolean;
+/**
+ * 获取对象属性。
+ *
+ * @param objectType - 对象类型。
+ * @returns 对象属性。
+ */
+export declare function getObjectProps(objectType: string): Record<string, string>;

package/dist/modules/query.js

@@ -1,3 +1,4 @@
+import { objectProps } from './object-props.js';
 import { getModuleMapState, getModulesState } from './registry-store.js';
 /**
  * 获取模块定义。
@@ -120,3 +121,12 @@ export function getModuleNames() {
 export function isModuleName(moduleName) {
     return getModuleMapState().has(moduleName.toLowerCase());
 }
+/**
+ * 获取对象属性。
+ *
+ * @param objectType - 对象类型。
+ * @returns 对象属性。
+ */
+export function getObjectProps(objectType) {
+    return objectProps[objectType];
+}

package/dist/modules/registry.d.ts

@@ -4238,4 +4238,4 @@ export declare const MODULES: readonly [{
 }];
 export { type DefineModulesOptions, defineModules, defineModuleActions, extendModuleAction, resetModuleDefinitions, } from './define.js';
 export { applyBuiltinOverrides };
-export { getModule, getModuleAction, getModuleActionParams, getModuleNames, isModuleName, } from './query.js';
+export { getModule, getModuleAction, getModuleActionParams, getModuleNames, isModuleName, getObjectProps, } from './query.js';

package/dist/modules/registry.js

@@ -16,4 +16,4 @@ export { applyBuiltinOverrides };
 // - 注册为 store 的「重置后钩子」，使 resetModuleDefinitions 还原内置基线后自动重新应用。
 setPostResetHook(applyBuiltinOverrides);
 applyBuiltinOverrides();
-export { getModule, getModuleAction, getModuleActionParams, getModuleNames, isModuleName, } from './query.js';
+export { getModule, getModuleAction, getModuleActionParams, getModuleNames, isModuleName, getObjectProps, } from './query.js';

package/dist/request/index.js

@@ -101,14 +101,15 @@ function extractApiCode(record) {
 }
 /** 判断本次调用是否携带了需要本地处理列表的选项。 */
 function hasListProcessing(options) {
-    return Boolean((options.filter && options.filter.length > 0) ||
+    return Boolean(options.convert ||
+        (options.filter && options.filter.length > 0) ||
         (options.search && options.search.length > 0) ||
         options.sort ||
         options.limit ||
         (options.pick && options.pick.length > 0));
 }
 /**
- * 对归一化后的业务数据应用本地处理（过滤 → 搜索 → 排序 → 限制数量 → 摘取）。
+ * 对归一化后的业务数据应用本地处理（转换 → 过滤 → 搜索 → 排序 → 限制数量 → 摘取）。
  *
  * - 对象列表：交由 {@link processData} 完整处理。
  * - 基本类型数组：仅 `limit` 生效（按数量截断），避免破坏原始元素。
@@ -121,6 +122,7 @@ function applyProcessing(data, options) {
             return data;
         if (data.every(isRecord)) {
             return processData(data, {
+                convert: options.convert,
                 filter: options.filter,
                 search: options.search,
                 searchFields: options.searchFields,

package/dist/types/data.d.ts

@@ -20,8 +20,10 @@ export interface DataRecordFilterGroup {
 export type SortExpr = `${string}:${'asc' | 'desc'}`;
 /** 自定义排序比较函数。 */
 export type SortFn = (a: DataRecord, b: DataRecord) => number;
-/** {@link processData} 处理列表时的选项；执行顺序为 过滤 → 搜索 → 排序 → 限制数量 → 摘取。 */
+/** {@link processData} 处理列表时的选项；执行顺序为 转换 → 过滤 → 搜索 → 排序 → 限制数量 → 摘取。 */
 export interface ProcessListOptions {
+    /** 转换函数，用于对列表中的每条记录进行转换。 */
+    convert?: (records: DataRecord[]) => DataRecord[];
     /** 过滤表达式列表，例如 `["status=active", "pri>=2"]`，多条之间按 AND 组合。 */
     filter?: string[];
     /** 模糊搜索关键词组，组内空格分隔为 OR，多组之间按 AND 组合。 */
@@ -35,8 +37,10 @@ export interface ProcessListOptions {
     /** 摘取字段路径列表。 */
     pick?: string[];
 }
-/** {@link processData} 处理单条对象时的选项。 */
+/** {@link processData} 处理单条对象时的选项；执行顺序为 转换 → 摘取。 */
 export interface ProcessSingleOptions {
+    /** 转换函数，用于对对象进行转换。 */
+    convert?: (record: DataRecord) => DataRecord;
     /** 摘取字段路径列表。 */
     pick?: string[];
 }

package/dist/utils/data.d.ts

@@ -18,7 +18,7 @@ export declare function searchData(data: DataRecord[], keywordGroups: string[],
  * 数值字段按数字比较，否则按字符串 `localeCompare`。
  */
 export declare function sortData(data: DataRecord[], sortFields: (SortExpr | SortFn)[]): DataRecord[];
-/** 处理单条对象：仅支持字段摘取。 */
+/** 处理单条对象：按 转换 → 摘取 的顺序执行。 */
 export declare function processData(data: DataRecord, options: ProcessSingleOptions): DataRecord;
-/** 处理列表：按 过滤 → 搜索 → 排序 → 限制数量 → 摘取 的顺序执行。 */
+/** 处理列表：按 转换 → 过滤 → 搜索 → 排序 → 限制数量 → 摘取 的顺序执行。 */
 export declare function processData(data: DataRecord[], options: ProcessListOptions): DataRecord[];

package/dist/version.js

@@ -1,5 +1,5 @@
-const fallbackBuild = "2026-08-04T07:16:16.980Z";
-const fallbackVersion = "0.4.1";
+const fallbackBuild = "2026-08-11T13:56:37.064Z";
+const fallbackVersion = "0.5.1";
 /**
  * 构建标识，由构建脚本通过 `__ZENTAO_API_BUILD__` 注入。
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zentao-api",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "type": "module",
   "description": "Browser and Node.js SDK for ZenTao API",
   "license": "MIT",