@embedpdf/models 2.6.0 → 2.6.1

package/dist/index.d.ts

@@ -16,6 +16,7 @@ export * from './date';
 export * from './helpers';
 export * from './uuid';
 export * from './compound-task';
+export * from './task-sequence';
 export * from './fonts';
 /**
  * ignore will do nothing when called.

package/dist/index.js

@@ -2083,6 +2083,109 @@ class CompoundTask extends Task {
     return compound;
   }
 }
+class TaskSequence {
+  constructor(parentTask) {
+    this.parentTask = parentTask;
+    this.activeChild = null;
+    this.disposed = false;
+    const origAbort = parentTask.abort.bind(parentTask);
+    parentTask.abort = (reason) => {
+      var _a;
+      this.disposed = true;
+      (_a = this.activeChild) == null ? void 0 : _a.abort(reason);
+      origAbort(reason);
+    };
+  }
+  /**
+   * Execute a child Task and return its result as a Promise.
+   *
+   * If the parent task has been aborted, throws `TaskAbortedError` immediately.
+   * If the parent task is aborted while the child is running, the child is aborted too.
+   */
+  run(factory) {
+    return new Promise((resolve, reject) => {
+      if (this.disposed || this.parentTask.state.stage !== TaskStage.Pending) {
+        reject(new TaskAbortedError("Sequence aborted"));
+        return;
+      }
+      const child = factory();
+      this.activeChild = child;
+      child.wait(
+        (result) => {
+          this.activeChild = null;
+          resolve(result);
+        },
+        (error) => {
+          this.activeChild = null;
+          if (error.type === "abort") {
+            reject(new TaskAbortedError(error.reason));
+          } else {
+            reject(new TaskRejectedError(error.reason));
+          }
+        }
+      );
+    });
+  }
+  /**
+   * Execute a child Task and return its result as a Promise,
+   * forwarding the child's progress events to the parent task
+   * through the provided mapper function.
+   *
+   * If the parent task has been aborted, throws `TaskAbortedError` immediately.
+   * If the parent task is aborted while the child is running, the child is aborted too.
+   */
+  runWithProgress(factory, mapProgress) {
+    return new Promise((resolve, reject) => {
+      if (this.disposed || this.parentTask.state.stage !== TaskStage.Pending) {
+        reject(new TaskAbortedError("Sequence aborted"));
+        return;
+      }
+      const child = factory();
+      this.activeChild = child;
+      child.onProgress((p) => {
+        this.parentTask.progress(mapProgress(p));
+      });
+      child.wait(
+        (result) => {
+          this.activeChild = null;
+          resolve(result);
+        },
+        (error) => {
+          this.activeChild = null;
+          if (error.type === "abort") {
+            reject(new TaskAbortedError(error.reason));
+          } else {
+            reject(new TaskRejectedError(error.reason));
+          }
+        }
+      );
+    });
+  }
+  /**
+   * Execute an async function body that uses `run()` / `runWithProgress()`,
+   * automatically handling abort and error routing to the parent task.
+   *
+   * - If the body throws `TaskAbortedError`, it is silently ignored
+   *   (the parent task was already aborted via the abort override).
+   * - If the body throws `TaskRejectedError` (from a child task rejection
+   *   via `run()` / `runWithProgress()`), its `.reason` is forwarded directly
+   *   to the parent task, bypassing `mapError`.
+   * - Any other thrown error is mapped through `mapError` and used to
+   *   reject the parent task. This handles unexpected runtime exceptions
+   *   in the async body itself.
+   * - On success, the body is responsible for calling `parentTask.resolve()`.
+   */
+  execute(fn, mapError) {
+    fn().catch((err) => {
+      if (err instanceof TaskAbortedError) return;
+      if (err instanceof TaskRejectedError) {
+        this.parentTask.reject(err.reason);
+        return;
+      }
+      this.parentTask.reject(mapError(err));
+    });
+  }
+}
 function ignore() {
 }
 export {
@@ -2145,6 +2248,7 @@ export {
   Task,
   TaskAbortedError,
   TaskRejectedError,
+  TaskSequence,
   TaskStage,
   blendModeLabel,
   blendModeSelectOptions,