weaver-e10-builder 1.2.5 → 1.5.2

package/dist/services/matrix-rows.js.map

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

package/dist/services/org-department.d.ts

@@ -0,0 +1,114 @@
+/**
+ * 组织架构 — 部门的新建与删除。
+ *
+ * 新建部门是**四步链**，每一步的产出喂给下一步，缺一不可：
+ *
+ *   ① GET  `/api/bs/hrm/organization/getForm`      取**保存报文模板**（含现生成的 targetId）
+ *   ② POST `/api/hrm/form/core/getFormLayout`      取 `formLayout.id` 与 `formLayoutMultiple.id`
+ *   ③ POST `/api/hrm/form/core/saveFormData`       落表单数据，回吐 `recordId`
+ *   ④ POST `/api/bs/hrm/organization/saveForm`     部门落进组织树
+ *
+ * ⚠ **① 给的模板不能直接当 ④ 的报文发** —— 形状对不上：
+ *   ① 的 `data.parent` 是 `[]`、`data.subcompany` 是**对象数组**，
+ *   而 ④ 要的是 `parent: ""`（或父部门 id 字符串）与 `subcompany: "<机构id>"`。
+ *   转换集中在 `buildSaveFormPayload`，别在命令层现拼。
+ *
+ * 删除是单步：`POST /api/bs/hrm/department/delete`。
+ */
+/** 保存报文里的组织类型。建部门固定 `department`。 */
+export declare const ORG_TYPE_DEPARTMENT = "department";
+/**
+ * 解析当前登录用户所在机构 ID。
+ *
+ * `teamsCheck` 的 `body.currentUser.department`：优先 `subCompanyId`（公司级机构），
+ * 没有就退回 `department.id`（部分环境只有部门 id）。
+ *
+ * 与 `workflow-create-workflow.ts` 原先内联的那份同源 —— 那边已改为引用这里。
+ */
+export declare function resolveCurrentUserSubCompany(baseUrl: string, eteamsId: string): Promise<string>;
+/**
+ * `teamsCheck` 拿当前登录用户。取不到就返回 `{}`（调用方各自兜底，这里不抛）。
+ *
+ * 人员导入要用 `currentUser.id` 当 `customParam.employeeId`，部门那两处要 `department`，
+ * 所以把请求这次抽出来共用 —— 不然同一份 teamsCheck 会有三处复制。
+ */
+export declare function fetchCurrentUser(baseUrl: string, eteamsId: string): Promise<any>;
+/** ① 的返回里那份模板（只列用得到的键）。 */
+export interface OrgFormTemplate {
+    targetId: string;
+    formId: string;
+    versionId: string;
+    subcompanyId: string;
+    rightList: string[];
+    hideFieldList: string[];
+    disporder: number;
+    virtualid: string;
+}
+/**
+ * 从 ① `getForm` 的返回里抽出模板。
+ *
+ * 抽不出来就抛 —— **不编默认值**：这四个 id 全是平台现生成的，
+ * 硬凑一个只会让后面的步骤以看不懂的方式失败。
+ */
+export declare function extractOrgFormTemplate(response: any): OrgFormTemplate;
+/** ③ `saveFormData` 的报文。`presetDataId` 就是模板里的 `targetId`。 */
+export declare function buildSaveFormDataPayload(tpl: Pick<OrgFormTemplate, 'targetId' | 'formId'>, formLayoutId: string, multipleLayoutId: string): Record<string, unknown>;
+/** ③ 的返回里取 `recordId`（④ 要用）。取不到就抛，不编。 */
+export declare function extractRecordId(response: any): string;
+export interface CreateDepartmentInput {
+    name: string;
+    /** 部门编号。不传就沿用模板里的值（或空）。 */
+    code?: string;
+    /** 父部门 id。**顶层部门传机构 id**（= `subcompany`），与 `getForm` 的 `parentId` 同一个值。 */
+    parentId: string;
+    /** 所属机构 id。不传就用模板里带的那个。 */
+    subcompanyId?: string;
+    /** 直管上级部门名（可选，界面上的「上级部门」展示字段）。 */
+    supDepartment?: string;
+    /** 部门全称。不传用 name。 */
+    fullname?: string;
+    recordId: string;
+}
+/**
+ * ④ `organization/saveForm` 的报文 —— 把 ① 的模板**转成**平台实际收的形状。
+ *
+ * 转换点（这三处是踩过的坑，别改回去）：
+ * - `parent`：模板给的是数组（顶层时为空数组）→ 要 `""` 或父部门 id **字符串**
+ * - `subcompany`：模板给的是对象数组 → 要机构 id **字符串**
+ * - `formdata.objectId` / `formdataId`：都等于 `targetId`
+ */
+export declare function buildSaveFormPayload(tpl: OrgFormTemplate, input: CreateDepartmentInput): Record<string, unknown>;
+/** 删除部门的报文。`parent` 是它的**父**（顶层部门的父就是机构 id）。 */
+export declare function buildDeleteDepartmentPayload(id: string, parent: string): Record<string, unknown>;
+/**
+ * 编辑部门时读当前状态：`getForm` 带 **`id=`**（不是 `parentId=`）。
+ *
+ * 同一个端点两种用法：带 `parentId` 给**新建模板**，带 `id` 给**这个部门的完整现状**。
+ * 返回的 `data` 就是编辑报文的模板。
+ *
+ * ⚠ 这个读接口**不过滤已删记录** —— 删除是软删（`isDelete: true`），删完再读仍能读出来。
+ * 所以它不能用来判断「部门还在不在」，判删除要看 `isDelete` 字段或用组织树列表。
+ */
+export declare function getOrgDetailPath(id: string): string;
+export interface EditDepartmentInput {
+    /** 新名字。不传保持原值。 */
+    name?: string;
+    code?: string;
+    /** 新父部门 id。不传保持原值。 */
+    parentId?: string;
+    disporder?: number;
+    fullname?: string;
+}
+/**
+ * **编辑**部门的报文（`organization/saveForm`，与新建同一个端点但形状不同）。
+ *
+ * 编辑是「**当前完整状态 + 改动**」，不是只发改动，所以必须先用 `getOrgDetailPath` 把现状读回来。
+ * 与新建那版的差异（照着抓包对的）：
+ * - 认 `id`，**没有** `targetId` / `formdata` / `formdataId` / `recordId`
+ * - 带 `tenantKey` / `creator` / `subcompanyid` / `datarank` / `createTime` / `updateTime` /
+ *   `isTop` / `status` / `isDelete` / `usersettings` —— 这些**原样回传**，别自己造
+ * - `advanceForm` 是 `false`（新建时是 `true`）
+ * - `parent` 要的是**父的 id 字符串**；模板给的是数组，顶层部门则回填 `subcompanyid`
+ */
+export declare function buildUpdateDepartmentPayload(detail: any, input: EditDepartmentInput): Record<string, unknown>;
+//# sourceMappingURL=org-department.d.ts.map

package/dist/services/org-department.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-department.d.ts","sourceRoot":"","sources":["../../src/services/org-department.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,qCAAqC;AACrC,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAsB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGrG;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAStF;AAED,2BAA2B;AAC3B,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,GAAG,GAAG,eAAe,CAyBrE;AAED,6DAA6D;AAC7D,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,QAAQ,CAAC,EACjD,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB;AAED,yCAAyC;AACzC,wBAAgB,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,CAKrD;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiChH;AAED,gDAAgD;AAChD,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEhG;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,MAAM,WAAW,mBAAmB;IAClC,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoC7G"}

package/dist/services/org-department.js

@@ -0,0 +1,209 @@
+/**
+ * 组织架构 — 部门的新建与删除。
+ *
+ * 新建部门是**四步链**，每一步的产出喂给下一步，缺一不可：
+ *
+ *   ① GET  `/api/bs/hrm/organization/getForm`      取**保存报文模板**（含现生成的 targetId）
+ *   ② POST `/api/hrm/form/core/getFormLayout`      取 `formLayout.id` 与 `formLayoutMultiple.id`
+ *   ③ POST `/api/hrm/form/core/saveFormData`       落表单数据，回吐 `recordId`
+ *   ④ POST `/api/bs/hrm/organization/saveForm`     部门落进组织树
+ *
+ * ⚠ **① 给的模板不能直接当 ④ 的报文发** —— 形状对不上：
+ *   ① 的 `data.parent` 是 `[]`、`data.subcompany` 是**对象数组**，
+ *   而 ④ 要的是 `parent: ""`（或父部门 id 字符串）与 `subcompany: "<机构id>"`。
+ *   转换集中在 `buildSaveFormPayload`，别在命令层现拼。
+ *
+ * 删除是单步：`POST /api/bs/hrm/department/delete`。
+ */
+/** 保存报文里的组织类型。建部门固定 `department`。 */
+export const ORG_TYPE_DEPARTMENT = 'department';
+/**
+ * 解析当前登录用户所在机构 ID。
+ *
+ * `teamsCheck` 的 `body.currentUser.department`：优先 `subCompanyId`（公司级机构），
+ * 没有就退回 `department.id`（部分环境只有部门 id）。
+ *
+ * 与 `workflow-create-workflow.ts` 原先内联的那份同源 —— 那边已改为引用这里。
+ */
+export async function resolveCurrentUserSubCompany(baseUrl, eteamsId) {
+    const dep = (await fetchCurrentUser(baseUrl, eteamsId))?.department;
+    return String(dep?.subCompanyId || dep?.id || '');
+}
+/**
+ * `teamsCheck` 拿当前登录用户。取不到就返回 `{}`（调用方各自兜底，这里不抛）。
+ *
+ * 人员导入要用 `currentUser.id` 当 `customParam.employeeId`，部门那两处要 `department`，
+ * 所以把请求这次抽出来共用 —— 不然同一份 teamsCheck 会有三处复制。
+ */
+export async function fetchCurrentUser(baseUrl, eteamsId) {
+    try {
+        const resp = await fetch(`${baseUrl}/api/baseserver/layout/teamsCheck?clientType=not_xinchuang&client=WEB&domainName=${encodeURIComponent(baseUrl)}`, { method: 'POST', headers: { accept: 'application/json', 'content-type': 'application/json', eteamsid: eteamsId } });
+        const body = await resp.json();
+        return body?.currentUser ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * 从 ① `getForm` 的返回里抽出模板。
+ *
+ * 抽不出来就抛 —— **不编默认值**：这四个 id 全是平台现生成的，
+ * 硬凑一个只会让后面的步骤以看不懂的方式失败。
+ */
+export function extractOrgFormTemplate(response) {
+    const d = response?.data?.data ?? response?.data;
+    if (!d || typeof d !== 'object')
+        throw new Error('getForm 返回结构异常（拿不到模板）');
+    const targetId = String(d.targetId ?? '');
+    const formId = String(d.formdata?.formId ?? d.formId ?? '');
+    const versionId = String(d.formdata?.versionId ?? d.versionId ?? '');
+    const subcompanyId = String(d.subcompany?.[0]?.id ?? d.subcompany ?? '');
+    if (!targetId || !formId) {
+        // 实测：mulinquan 的 data 里带 `formdata`（含 formId/versionId），eteams 的**不带** ——
+        // 同一端点、同样的参数，差别在租户的部门表单配置。缺 formId 就没法走 ③④，直接说清。
+        throw new Error(`getForm 模板缺少关键 id（targetId=${targetId || '空'} formId=${formId || '空'}）：`
+            + '该环境未返回部门表单配置（formdata.formId），当前无法在该环境建部门');
+    }
+    return {
+        targetId,
+        formId,
+        versionId,
+        subcompanyId,
+        rightList: Array.isArray(d.rightList) ? d.rightList.map(String) : [],
+        hideFieldList: Array.isArray(d.hideFieldList) ? d.hideFieldList.map(String) : [],
+        disporder: Number(d.disporder ?? 0),
+        virtualid: String(d.virtualid ?? '1'),
+    };
+}
+/** ③ `saveFormData` 的报文。`presetDataId` 就是模板里的 `targetId`。 */
+export function buildSaveFormDataPayload(tpl, formLayoutId, multipleLayoutId) {
+    return {
+        module: 'hrm',
+        formData: {
+            module: 'hrm',
+            presetDataId: tpl.targetId,
+            dataDetails: [],
+            asyncTableData: false,
+            client: 'pc',
+            dataStatus: 'submit',
+            form: { id: tpl.formId },
+            formLayout: { id: formLayoutId },
+            multipleLayoutId,
+        },
+    };
+}
+/** ③ 的返回里取 `recordId`（④ 要用）。取不到就抛，不编。 */
+export function extractRecordId(response) {
+    const d = response?.data ?? {};
+    const id = d.recordId ?? d.dataId ?? d.id ?? d.formDataId ?? '';
+    if (!id)
+        throw new Error('saveFormData 未返回 recordId（部门树那步会缺参数）');
+    return String(id);
+}
+/**
+ * ④ `organization/saveForm` 的报文 —— 把 ① 的模板**转成**平台实际收的形状。
+ *
+ * 转换点（这三处是踩过的坑，别改回去）：
+ * - `parent`：模板给的是数组（顶层时为空数组）→ 要 `""` 或父部门 id **字符串**
+ * - `subcompany`：模板给的是对象数组 → 要机构 id **字符串**
+ * - `formdata.objectId` / `formdataId`：都等于 `targetId`
+ */
+export function buildSaveFormPayload(tpl, input) {
+    // 所属机构取模板里的（或显式传入）—— **不要用 parentId 顶替**：
+    // 建子部门时 parentId 是父部门 id，拿它当 subcompany 会把子部门挂到错误的机构下。
+    const subcompanyId = input.subcompanyId || tpl.subcompanyId;
+    const isTopLevel = !input.parentId || input.parentId === subcompanyId;
+    return {
+        // 顶层部门时 parent 是空串（不是机构 id）；挂在某个部门下时才写该部门 id
+        parent: isTopLevel ? '' : input.parentId,
+        subcompany: subcompanyId,
+        targetId: tpl.targetId,
+        advanceForm: true,
+        hideFieldList: tpl.hideFieldList,
+        virtualid: tpl.virtualid,
+        formdata: {
+            objectId: tpl.targetId,
+            formId: tpl.formId,
+            isEditable: true,
+            module: 'hrm',
+            versionId: tpl.versionId,
+            advanceForm: true,
+        },
+        type: ORG_TYPE_DEPARTMENT,
+        disporder: tpl.disporder,
+        rightList: tpl.rightList,
+        coadjutant: '',
+        code: input.code ?? '',
+        name: input.name,
+        ...(input.supDepartment ? { supDepartment: input.supDepartment } : {}),
+        ...(input.fullname ? { fullname: input.fullname } : {}),
+        formdataId: tpl.targetId,
+        recordId: input.recordId,
+        isMobile: false,
+    };
+}
+/** 删除部门的报文。`parent` 是它的**父**（顶层部门的父就是机构 id）。 */
+export function buildDeleteDepartmentPayload(id, parent) {
+    return { id, parent, virtualId: '1', isMobile: false };
+}
+/**
+ * 编辑部门时读当前状态：`getForm` 带 **`id=`**（不是 `parentId=`）。
+ *
+ * 同一个端点两种用法：带 `parentId` 给**新建模板**，带 `id` 给**这个部门的完整现状**。
+ * 返回的 `data` 就是编辑报文的模板。
+ *
+ * ⚠ 这个读接口**不过滤已删记录** —— 删除是软删（`isDelete: true`），删完再读仍能读出来。
+ * 所以它不能用来判断「部门还在不在」，判删除要看 `isDelete` 字段或用组织树列表。
+ */
+export function getOrgDetailPath(id) {
+    return `/api/bs/hrm/organization/getForm?id=${encodeURIComponent(id)}&flag=department&virtualId=1&isMobile=false`;
+}
+/**
+ * **编辑**部门的报文（`organization/saveForm`，与新建同一个端点但形状不同）。
+ *
+ * 编辑是「**当前完整状态 + 改动**」，不是只发改动，所以必须先用 `getOrgDetailPath` 把现状读回来。
+ * 与新建那版的差异（照着抓包对的）：
+ * - 认 `id`，**没有** `targetId` / `formdata` / `formdataId` / `recordId`
+ * - 带 `tenantKey` / `creator` / `subcompanyid` / `datarank` / `createTime` / `updateTime` /
+ *   `isTop` / `status` / `isDelete` / `usersettings` —— 这些**原样回传**，别自己造
+ * - `advanceForm` 是 `false`（新建时是 `true`）
+ * - `parent` 要的是**父的 id 字符串**；模板给的是数组，顶层部门则回填 `subcompanyid`
+ */
+export function buildUpdateDepartmentPayload(detail, input) {
+    const d = detail?.data?.data ?? detail?.data ?? detail;
+    if (!d || typeof d !== 'object' || !d.id) {
+        throw new Error('getForm(id) 未返回部门详情（拿不到 id）');
+    }
+    const subcompanyid = String(d.subcompanyid ?? d.subcompany?.[0]?.id ?? '');
+    // 模板 parent 是数组：顶层部门是空数组，此时它的「父」就是所属机构
+    const templateParentId = String(d.parent?.[0]?.id ?? d.parent?.[0] ?? '');
+    const parent = input.parentId ?? (templateParentId || subcompanyid);
+    const payload = {
+        parent,
+        code: input.code ?? String(d.code ?? ''),
+        tenantKey: d.tenantKey,
+        type: d.type,
+        usersettings: d.usersettings ?? [],
+        coadjutant: Array.isArray(d.coadjutant) ? '' : (d.coadjutant ?? ''),
+        id: String(d.id),
+        virtualid: String(d.virtualid ?? '1'),
+        disporder: input.disporder ?? d.disporder ?? 0,
+        creator: d.creator,
+        subcompanyid,
+        advanceForm: false,
+        datarank: d.datarank,
+        isDelete: Boolean(d.isDelete),
+        hideFieldList: d.hideFieldList ?? [],
+        updateTime: d.updateTime,
+        rightList: d.rightList ?? [],
+        createTime: d.createTime,
+        isTop: Boolean(d.isTop),
+        name: input.name ?? String(d.name ?? ''),
+        fullname: input.fullname ?? String(d.fullname ?? ''),
+        status: Boolean(d.status),
+        isMobile: false,
+    };
+    return payload;
+}
+//# sourceMappingURL=org-department.js.map

package/dist/services/org-department.js.map

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

package/dist/services/org-employee.d.ts

@@ -0,0 +1,191 @@
+import type { ApiClient } from '../core/client.js';
+export interface ImportParam {
+    bizId: string;
+    moduleName: string;
+    functionName: string;
+    handlerName: string;
+    serviceName: string;
+    dataType: string;
+}
+/**
+ * 抽 ⓪ 的返回。**抽不到就抛** —— 这几个值是 `bizId` 和 ④ 报文的主体，
+ * 编一个默认值只会在很远的地方以看不懂的方式失败。
+ */
+export declare function extractImportParam(resp: any): ImportParam;
+/** 上传要用的文件元数据 —— 平台按这几个值认文件，得是**真实**的。 */
+export interface FileMeta {
+    name: string;
+    size: number;
+    md5: string;
+    lastModified: number;
+}
+/**
+ * 读文件的真实元数据。`md5` 现算（平台会拿它校验文件完整性，编不得）。
+ *
+ * `lastModified` 取文件的 mtime 毫秒数 —— 实测这个值和 `lastModifiedDate` **填同一个数**。
+ */
+export declare function readFileMeta(filePath: string): FileMeta;
+/** ① 的报文。 */
+export declare function buildPreUploadForm(meta: FileMeta, employeeId: string, fileBytes: Buffer<ArrayBuffer>): FormData;
+/** ② 的报文 = ① + `preUploadId` + `uploadType`。 */
+export declare function buildUploadForm(meta: FileMeta, employeeId: string, preUploadId: string, fileBytes: Buffer<ArrayBuffer>): FormData;
+/**
+ * ① 的返回：预上传 id。
+ *
+ * **同一个端点在不同环境返回的形状不一样** —— 实测 mulinquan 只给 `data.preUploadId`
+ * （`data` 下就三个键：`preUploadId` / `uploadType` / `permissionType`，**没有** `uploadModuleDto`、
+ * 也**没有** `fileid`），而 `data.uploadModuleDto.fileid` 是另一套环境/版本的写法。
+ * 两者语义相同（都是给 ② 当 `preUploadId` 用），所以都认；一个都没有才报错。
+ */
+export declare function extractPreUploadId(resp: any): string;
+/**
+ * ② 的返回：`data.fileid`（**小写 d**）。
+ *
+ * 这里**只认小写**、不做驼峰回退：平台给的就是 `fileid`（实测），
+ * 加个 `fileId` 的兜底等于替平台猜一个不存在的写法，真出问题时反而更难查。
+ */
+export declare function extractFileId(resp: any): string;
+/** ④ 的 `uploadSet` —— 决定「怎么导」。 */
+export interface UploadSet {
+    /** `add` 新增 / `update` 更新。 */
+    importType: string;
+    /** 更新时按哪个字段认人（如 `username`）。 */
+    empFindField: string;
+    /** 文件类型，从扩展名推。 */
+    fileType: string;
+}
+export declare function resolveUploadSet(opts?: {
+    importType?: string;
+    empFindField?: string;
+    fileType?: string;
+}): UploadSet;
+/**
+ * ④ 的报文。
+ *
+ * ⚠ `importType` 在报文里出现**两次**：顶层那个是空串、真正生效的在 `uploadSet.customObj` 里。
+ * 看着像冗余，但实测两次都是这样，照抄 —— 别「顺手清理」成一处。
+ */
+export declare function buildUploadFileIdPayload(param: ImportParam, fileId: string, set: UploadSet, now: number): Record<string, unknown>;
+/** ④ 的返回：`data.data.taskId`（**多一层 data**，这里最容易取空）。 */
+export declare function extractTaskId(resp: any): string;
+/**
+ * ⑤ 预览。
+ *
+ * `rerviewNum` 是**平台把 review 拼错了**，别改成 `reviewNum`（改了就不认）。
+ */
+export declare function buildGetExcelDataPath(param: ImportParam, taskId: string, reviewNum?: number): string;
+/** ⑥ 执行导入。 */
+export declare function buildImportExcelDataPath(param: ImportParam, taskId: string): string;
+/** ⑤ 解析出来的预览。 */
+export interface ImportPreview {
+    fileName: string;
+    sheetNames: string[];
+    /** 列名（带「（必填）」后缀 —— 那是表头富文本的一部分，不是我们加的）。 */
+    columns: string[];
+    /** 每行是「列名 → 值」的对象。 */
+    rows: Record<string, unknown>[];
+}
+/**
+ * 抽 ⑤ 的预览。
+ *
+ * ⚠ `weaTable[0].total` 实测是 **-1**，不能拿来当行数 —— 行数看 `data.length`。
+ * 而且 `rerviewNum` 限了条数，**这里看到的只是前 N 行，不是全部**。
+ */
+export declare function extractPreview(resp: any): ImportPreview;
+/**
+ * 导入任务的结果。
+ *
+ * ⚠ **⑥ `importExcelData` 的响应体只有一个 `true`**，条数、失败原因、错误文件全都不在里面。
+ * 要知道「到底导进去没有」必须再问一次 `getByTaskId`。
+ * 只看 ⑥ 就报成功，会让**整批失败**也显示成「导入已提交」。
+ */
+export interface ImportTaskResult {
+    /**
+     * 平台自己的状态码。**`0` 不是「成功」的意思，只是一个中途值** —— 同一个任务先读到
+     * `status: 0` + `msg: 成功`、几秒后变成 `-1` + 失败 1 条，**只有 `callbackData` 才是结论**。
+     * `-1` = 存在错误数据。仅用于展示，**不要拿它判完成**（用 {@link isTaskSettled}）。
+     */
+    status: number;
+    msg: string;
+    successCount: number;
+    errorCount: number;
+    /** 失败数据的下载文件 id（状态为 -1 时才有）。 */
+    errorFileId: string;
+    /** `callbackData` 解析不出条数时为 true —— 此时数字一概不可信，别拿去判断成功。 */
+    countsUnknown: boolean;
+}
+/** ⑥ 之后的进度查询。 */
+export declare function buildGetByTaskIdPath(taskId: string): string;
+/**
+ * 解析任务状态。
+ *
+ * ⚠ `callbackData` 是**一个 JSON 字符串**，要二次解析；里面 `successCount` 是**数字**
+ * （`1`）、`errorCount` 却是**字符串**（`"0"`）—— 同一段 JSON 里类型不一致，两边都过一遍 `Number`。
+ */
+export declare function parseTaskResult(resp: any): ImportTaskResult;
+/**
+ * 任务是否已到终态。
+ *
+ * **判据是 `callbackData` 能不能解出来，不是 `status`。** 踩过的坑：按 `status === 0` 判完成，
+ * 会在任务刚开始那一刻就停 —— 那时 `status: 0`、`msg: 成功`、`callbackData` 还没有，
+ * 几秒后才落成 `-1` + 失败 1 条。**中途值长得像成功，这是最坏的一种**。
+ *
+ * `status === -1` 也直接算终态（明确失败，没必要再等）；此时若条数还取不到，调用方会照实提示。
+ */
+export declare function isTaskSettled(r: ImportTaskResult): boolean;
+export declare function fetchTaskResult(client: ApiClient, baseUrl: string, taskId: string): Promise<ImportTaskResult>;
+/**
+ * 轮询到终态。超时返回 `null`（**不编一个成功出来**）—— 调用方据此如实报「还在处理」。
+ */
+export declare function waitTaskResult(client: ApiClient, baseUrl: string, taskId: string, opts?: {
+    timeoutMs?: number;
+    intervalMs?: number;
+}): Promise<ImportTaskResult | null>;
+/**
+ * 失败数据的下载地址。
+ *
+ * 这是个**跳转**：平台 302 到对象存储的签名地址，文件真身在那一步。
+ */
+export declare function buildErrorFileDownloadPath(fileId: string): string;
+/** 文件名：优先取对象存储那步 `response-content-disposition` 里的，取不到就用兜底名。 */
+export declare function fileNameFromDisposition(location: string, fallback: string): string;
+/**
+ * 下载失败数据。
+ *
+ * 两步走是**故意的**：先带鉴权拿 302，再**不带任何鉴权头**去对象存储取文件。
+ * 直接把 `eteamsid` 跟着跳转发到腾讯云域名上，等于把会话凭证递给第三方主机 —— 哪怕那是租户自己的桶，
+ * 也没有理由发。
+ *
+ * 这里不走 `ApiClient`：它把 302 一律当「会话过期」会去重新登录，而这个 302 是正常业务跳转。
+ */
+export declare function downloadErrorFile(baseUrl: string, fileId: string, eteamsId: string): Promise<{
+    bytes: Buffer;
+    fileName: string;
+}>;
+/**
+ * 一条失败原因。
+ *
+ * ⚠ **原因不是文件里的某一列，是出错单元格上的「批注」**（Excel comment）。
+ * 所以光把 xlsx 存下来、用表格软件打开看值，**看不到为什么失败** —— 得读批注。
+ * 实测形态：出错的「姓名」单元格上挂批注「姓名 重复」。
+ */
+export interface ImportErrorReason {
+    /** Excel 行号（含表头，第 1 行是表头）。 */
+    row: number;
+    /** 列号（从 1 开始）。 */
+    column: number;
+    /** 该列表头（去掉「（必填）」后缀），取不到用列字母。 */
+    header: string;
+    /** 该单元格的值。 */
+    value: string;
+    /** 批注文本 —— 这里才是原因。 */
+    reason: string;
+}
+/**
+ * 从一个错误 xlsx 的字节里把「哪一格、错在哪」抽出来。
+ *
+ * 批注是**默认就解析**的（挂在 `cell.c`），不用开任何选项 —— 这里刻意不传 `cellComments`，
+ * 那玩意儿在这版类型里没声明，传了编译不过，而它本来也不改变行为。
+ */
+export declare function parseErrorFileReasons(bytes: Buffer | Uint8Array): ImportErrorReason[];
+//# sourceMappingURL=org-employee.d.ts.map

package/dist/services/org-employee.d.ts.map

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