@agile-team/mach-report 0.5.0 → 0.6.0

package/dist/manager.js

@@ -1,85 +1,74 @@
-// src/manager/types.ts
-var ReportAdminError = class extends Error {
-  constructor(message, url) {
-    super(message);
-    this.url = url;
-    this.name = "ReportAdminError";
+class h extends Error {
+  constructor(a, r) {
+    super(a), this.url = r, this.name = "ReportAdminError";
   }
-};
-
-// src/manager/api.ts
-var BASE = "/report/codePrintReport";
-var LOCK_BASE = "/report/codePrintReportLock";
-function unwrap(response, url) {
-  const body = response;
-  if (body && body.code != null && body.code !== 200) {
-    throw new ReportAdminError(String(body.message || "\u8BF7\u6C42\u5931\u8D25"), url);
-  }
-  return body?.data ?? body;
 }
-function createReportAdminClient(options) {
-  const { request } = options;
-  const base = options.baseUrl ?? "";
+const o = "/report/codePrintReport", d = "/report/codePrintReportLock";
+function n(s, a) {
+  const r = s;
+  if (r && r.code != null && r.code !== 200)
+    throw new h(String(r.message || "请求失败"), a);
+  return r?.data ?? r;
+}
+function $(s) {
+  const { request: a } = s, r = s.baseUrl ?? "";
   return {
     /** 模板列表（分页） */
-    async listReports(query = {}) {
-      const url = `${base}${BASE}/list`;
-      return unwrap(
-        await request({ url, method: "get", params: { current: 1, size: 20, ...query } }),
-        url
+    async listReports(e = {}) {
+      const t = `${r}${o}/list`;
+      return n(
+        await a({ url: t, method: "get", params: { current: 1, size: 20, ...e } }),
+        t
       );
     },
     /** 模板详情（content 为 jh4j 私有模板 JSON 字符串，可喂给 importJh4jTemplateContent） */
-    async getReport(id) {
-      const url = `${base}${BASE}/getById`;
-      return unwrap(await request({ url, method: "get", params: { id } }), url);
+    async getReport(e) {
+      const t = `${r}${o}/getById`;
+      return n(await a({ url: t, method: "get", params: { id: e } }), t);
     },
     /** 保存模板（jh4j：PUT，body {id, code, name, content}） */
-    async updateReport(input) {
-      const url = `${base}${BASE}/update`;
-      return unwrap(await request({ url, method: "put", data: input }), url);
+    async updateReport(e) {
+      const t = `${r}${o}/update`;
+      return n(await a({ url: t, method: "put", data: e }), t);
     },
     /** 导出模板定义包（body = ID 数组，返回 ZIP blob） */
-    async exportDefinition(ids) {
-      const url = `${base}${BASE}/exportDefinition`;
-      return request({ url, method: "post", data: ids });
+    async exportDefinition(e) {
+      const t = `${r}${o}/exportDefinition`;
+      return a({ url: t, method: "post", data: e });
     },
     /** 导入模板定义包（multipart: file + strategy） */
-    async importDefinition(file, strategy) {
-      const url = `${base}${BASE}/importDefinition`;
-      const form = new FormData();
-      form.append("file", file);
-      form.append("strategy", strategy);
-      return request({ url, method: "post", data: form });
+    async importDefinition(e, t) {
+      const c = `${r}${o}/importDefinition`, i = new FormData();
+      return i.append("file", e), i.append("strategy", t), a({ url: c, method: "post", data: i });
     },
     /** 数据集列表 */
-    async listDatasets(reportId) {
-      const url = `${base}${BASE}Ds/list`;
-      return unwrap(
-        await request({ url, method: "get", params: { reportId, current: 1, size: 999 } }),
-        url
+    async listDatasets(e) {
+      const t = `${r}${o}Ds/list`;
+      return n(
+        await a({ url: t, method: "get", params: { reportId: e, current: 1, size: 999 } }),
+        t
       );
     },
     /** 参数列表 */
-    async listParams(reportId) {
-      const url = `${base}${BASE}Param/list`;
-      return unwrap(
-        await request({ url, method: "get", params: { reportId, current: 1, size: 999 } }),
-        url
+    async listParams(e) {
+      const t = `${r}${o}Param/list`;
+      return n(
+        await a({ url: t, method: "get", params: { reportId: e, current: 1, size: 999 } }),
+        t
       );
     },
     /** 模板锁：进入设计器前获取（40s 心跳由 holdLock 驱动） */
-    async acquireLock(reportId) {
-      const url = `${base}${LOCK_BASE}/acquire`;
-      return unwrap(await request({ url, method: "post", data: { reportId } }), url);
+    async acquireLock(e) {
+      const t = `${r}${d}/acquire`;
+      return n(await a({ url: t, method: "post", data: { reportId: e } }), t);
     },
-    async lockHeartbeat(reportId) {
-      const url = `${base}${LOCK_BASE}/heartbeat`;
-      return unwrap(await request({ url, method: "post", data: { reportId } }), url);
+    async lockHeartbeat(e) {
+      const t = `${r}${d}/heartbeat`;
+      return n(await a({ url: t, method: "post", data: { reportId: e } }), t);
     },
-    async releaseLock(reportId) {
-      const url = `${base}${LOCK_BASE}/release`;
-      return unwrap(await request({ url, method: "post", data: { reportId } }), url);
+    async releaseLock(e) {
+      const t = `${r}${d}/release`;
+      return n(await a({ url: t, method: "post", data: { reportId: e } }), t);
     },
     /**
      * 持锁执行：acquire → fn（期间自动心跳）→ release（finally）。
@@ -87,33 +76,29 @@ function createReportAdminClient(options) {
      * 心跳连续失败（默认 2 次）视为锁丢失：触发 onLockLost 回调并停止心跳，
      * fn 继续执行（避免中途丢弃用户编辑），由调用方决定是否提示/中止。
      */
-    async holdLock(reportId, fn, options2 = {}) {
-      await this.acquireLock(reportId);
-      const failLimit = Math.max(1, options2.heartbeatFailLimit ?? 2);
-      let consecutiveFailures = 0;
-      let lockLost = false;
-      const timer = setInterval(() => {
-        void this.lockHeartbeat(reportId).then(() => {
-          consecutiveFailures = 0;
-        }).catch((e) => {
-          consecutiveFailures++;
-          if (!lockLost && consecutiveFailures >= failLimit) {
-            lockLost = true;
-            options2.onLockLost?.(
-              `\u6A21\u677F\u9501\u5FC3\u8DF3\u8FDE\u7EED ${consecutiveFailures} \u6B21\u5931\u8D25\uFF08${e instanceof Error ? e.message : String(e)}\uFF09\uFF0C\u9501\u53EF\u80FD\u5DF2\u88AB\u91CA\u653E`
-            );
-            clearInterval(timer);
-          }
+    async holdLock(e, t, c = {}) {
+      await this.acquireLock(e);
+      const i = Math.max(1, c.heartbeatFailLimit ?? 2);
+      let l = 0, m = !1;
+      const p = setInterval(() => {
+        this.lockHeartbeat(e).then(() => {
+          l = 0;
+        }).catch((u) => {
+          l++, !m && l >= i && (m = !0, c.onLockLost?.(
+            `模板锁心跳连续 ${l} 次失败（${u instanceof Error ? u.message : String(u)}），锁可能已被释放`
+          ), clearInterval(p));
         });
       }, 4e4);
       try {
-        return await fn();
+        return await t();
       } finally {
-        clearInterval(timer);
-        await this.releaseLock(reportId).catch(() => void 0);
+        clearInterval(p), await this.releaseLock(e).catch(() => {
+        });
       }
     }
   };
 }
-
-export { ReportAdminError, createReportAdminClient };
+export {
+  h as ReportAdminError,
+  $ as createReportAdminClient
+};

package/dist/pdf/font-loader.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 字体加载（IndexedDB 持久缓存 + 内存缓存）：
+ * 中文字体体积大（simhei ~9MB），首次 fetch 后缓存，后续导出零网络等待。
+ */
+export declare function loadFontWithCache(url: string): Promise<Uint8Array | null>;

package/dist/pdf/index.d.ts

@@ -0,0 +1,2 @@
+export * from './render-pdf';
+export * from './font-loader';

package/dist/pdf/render-pdf.d.ts

@@ -0,0 +1,25 @@
+import { RenderPlan } from '../schema/render-plan';
+import { TextMeasurer } from '../index';
+export interface PdfRenderOptions {
+    /** 嵌入字体字节（TTF，如黑体）；缺省用 Helvetica（不支持 CJK） */
+    customFontBytes?: Uint8Array | ArrayBuffer;
+    customFontName?: string;
+    /** 文本测量器（默认启发式；与分页/Canvas 注入同一实例可消除折行差异） */
+    measurer?: TextMeasurer;
+}
+/**
+ * PDF 文档句柄（不透明最小面）：结构化仅暴露 save()，
+ * 避免在公共类型面泄漏 pdf-lib 类型（引擎保持零运行时依赖声明）。
+ */
+export type PdfDocumentHandle = {
+    save(): Promise<Uint8Array>;
+};
+export interface PdfRenderResult {
+    pdfDoc: PdfDocumentHandle;
+    bytes: Uint8Array;
+    pageErrors: string[];
+    unsupportedTextCount: number;
+    /** 保真度降级清单（富文本转纯文本、图片格式不支持等），供上层提示 */
+    fidelityWarnings: string[];
+}
+export declare function renderPlanToPdf(plan: RenderPlan, options?: PdfRenderOptions): Promise<PdfRenderResult>;