@ubercode/dcmtk 0.9.4 → 0.10.1

package/dist/servers.js

@@ -7,10 +7,10 @@ import * as path from 'path';
 import { join, normalize } from 'path';
 import { existsSync } from 'fs';
 import * as net from 'net';
-import * as fs from 'fs/promises';
-import { copyFile, unlink, stat, rm, mkdtemp } from 'fs/promises';
 import * as os from 'os';
 import { tmpdir } from 'os';
+import { setTimeout as setTimeout$1 } from 'timers/promises';
+import { mkdir, rm, rename, copyFile, unlink, stat, mkdtemp } from 'fs/promises';
 import { XMLParser } from 'fast-xml-parser';
 
 var __defProp = Object.defineProperty;
@@ -1249,6 +1249,44 @@ var StoreSCP = class _StoreSCP extends DcmtkProcess {
     signal.addEventListener("abort", this.abortHandler, { once: true });
   }
 };
+async function ensureDirectory(dirPath) {
+  try {
+    await mkdir(dirPath, { recursive: true });
+    return ok(void 0);
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    return err(new Error(`Failed to create directory ${dirPath}: ${msg}`));
+  }
+}
+async function moveFile(src, dest) {
+  try {
+    await rename(src, dest);
+    return ok(void 0);
+  } catch {
+    try {
+      await copyFile(src, dest);
+      await unlink(src);
+      return ok(void 0);
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      return err(new Error(`Failed to move file ${src} \u2192 ${dest}: ${msg}`));
+    }
+  }
+}
+async function statFileSafe(filePath) {
+  try {
+    const s = await stat(filePath);
+    return s.size;
+  } catch {
+    return 0;
+  }
+}
+async function removeDirSafe(dirPath) {
+  try {
+    await rm(dirPath, { recursive: true, force: true });
+  } catch {
+  }
+}
 function createDicomTag(input) {
   if (!DICOM_TAG_PATTERN.test(input)) {
     return err(new Error(`Invalid DICOM tag: "${input}". Expected format (XXXX,XXXX) where X is a hex digit`));
@@ -1312,227 +1350,6 @@ function tagPathToSegments(path2) {
   return segments;
 }
 
-// src/dicom/ChangeSet.ts
-var ERASE_PRIVATE_SENTINEL = "__ERASE_PRIVATE__";
-function isControlChar(code) {
-  if (code <= 9) return true;
-  if (code === 11 || code === 12) return true;
-  if (code >= 14 && code <= 31) return true;
-  return code === 127;
-}
-function sanitizeValue(value) {
-  let result = "";
-  for (let i = 0; i < value.length; i++) {
-    const code = value.charCodeAt(i);
-    if (!isControlChar(code)) {
-      result += value[i];
-    }
-  }
-  return result;
-}
-function buildMergedModifications(base, other, erasures) {
-  const merged = new Map(base);
-  for (const [key, value] of other) {
-    merged.set(key, value);
-  }
-  for (const key of erasures) {
-    merged.delete(key);
-  }
-  return merged;
-}
-function applyBatchEntries(initial, entries) {
-  const keys = Object.keys(entries);
-  let cs = initial;
-  for (let i = 0; i < keys.length; i++) {
-    const key = keys[i];
-    if (key === void 0) continue;
-    const value = entries[key];
-    if (value === void 0) continue;
-    cs = cs.setTag(key, value);
-  }
-  return cs;
-}
-var ChangeSet = class _ChangeSet {
-  constructor(mods, erasures) {
-    __publicField(this, "mods");
-    __publicField(this, "erased");
-    this.mods = mods;
-    this.erased = erasures;
-  }
-  /** Creates an empty ChangeSet with no modifications or erasures. */
-  static empty() {
-    return new _ChangeSet(/* @__PURE__ */ new Map(), /* @__PURE__ */ new Set());
-  }
-  /**
-   * Sets a tag value, returning a new ChangeSet.
-   *
-   * Control characters (except LF/CR) are stripped from the value.
-   * If the tag was previously erased, it is removed from the erasure set.
-   *
-   * @param path - The DICOM tag path to set (e.g. `'(0010,0010)'`)
-   * @param value - The new value for the tag
-   * @returns A new ChangeSet with the modification applied
-   * @throws Error if operation count would exceed MAX_CHANGESET_OPERATIONS
-   */
-  setTag(path2, value) {
-    const totalOps = this.mods.size + this.erased.size;
-    if (totalOps >= MAX_CHANGESET_OPERATIONS) {
-      throw new Error(`ChangeSet operation limit (${MAX_CHANGESET_OPERATIONS}) exceeded`);
-    }
-    tagPathToSegments(path2);
-    const sanitized = sanitizeValue(value);
-    const newMods = new Map(this.mods);
-    newMods.set(path2, sanitized);
-    const newErasures = new Set(this.erased);
-    newErasures.delete(path2);
-    return new _ChangeSet(newMods, newErasures);
-  }
-  /**
-   * Marks a tag for erasure, returning a new ChangeSet.
-   *
-   * If the tag was previously set, the modification is removed.
-   *
-   * @param path - The DICOM tag path to erase (e.g. `'(0010,0010)'`)
-   * @returns A new ChangeSet with the erasure applied
-   * @throws Error if operation count would exceed MAX_CHANGESET_OPERATIONS
-   */
-  eraseTag(path2) {
-    const totalOps = this.mods.size + this.erased.size;
-    if (totalOps >= MAX_CHANGESET_OPERATIONS) {
-      throw new Error(`ChangeSet operation limit (${MAX_CHANGESET_OPERATIONS}) exceeded`);
-    }
-    tagPathToSegments(path2);
-    const newMods = new Map(this.mods);
-    newMods.delete(path2);
-    const newErasures = new Set(this.erased);
-    newErasures.add(path2);
-    return new _ChangeSet(newMods, newErasures);
-  }
-  /**
-   * Marks all private tags for erasure, returning a new ChangeSet.
-   *
-   * @returns A new ChangeSet with the erase-private flag set
-   * @throws Error if operation count would exceed MAX_CHANGESET_OPERATIONS
-   */
-  erasePrivateTags() {
-    const totalOps = this.mods.size + this.erased.size;
-    if (totalOps >= MAX_CHANGESET_OPERATIONS) {
-      throw new Error(`ChangeSet operation limit (${MAX_CHANGESET_OPERATIONS}) exceeded`);
-    }
-    const newErasures = new Set(this.erased);
-    newErasures.add(ERASE_PRIVATE_SENTINEL);
-    return new _ChangeSet(new Map(this.mods), newErasures);
-  }
-  // -----------------------------------------------------------------------
-  // Convenience setters for common DICOM tags
-  // -----------------------------------------------------------------------
-  /** Sets Patient's Name (0010,0010). */
-  setPatientName(value) {
-    return this.setTag("(0010,0010)", value);
-  }
-  /** Sets Patient ID (0010,0020). */
-  setPatientID(value) {
-    return this.setTag("(0010,0020)", value);
-  }
-  /** Sets Study Date (0008,0020). */
-  setStudyDate(value) {
-    return this.setTag("(0008,0020)", value);
-  }
-  /** Sets Modality (0008,0060). */
-  setModality(value) {
-    return this.setTag("(0008,0060)", value);
-  }
-  /** Sets Accession Number (0008,0050). */
-  setAccessionNumber(value) {
-    return this.setTag("(0008,0050)", value);
-  }
-  /** Sets Study Description (0008,1030). */
-  setStudyDescription(value) {
-    return this.setTag("(0008,1030)", value);
-  }
-  /** Sets Series Description (0008,103E). */
-  setSeriesDescription(value) {
-    return this.setTag("(0008,103E)", value);
-  }
-  /** Sets Institution Name (0008,0080). */
-  setInstitutionName(value) {
-    return this.setTag("(0008,0080)", value);
-  }
-  /**
-   * Sets multiple tags at once, returning a new ChangeSet.
-   *
-   * @param entries - A record of tag path → value pairs
-   * @returns A new ChangeSet with all modifications applied
-   */
-  setBatch(entries) {
-    return applyBatchEntries(this, entries);
-  }
-  /** All pending tag modifications as a readonly map of path → value. */
-  get modifications() {
-    return this.mods;
-  }
-  /** All pending tag erasures as a readonly set of paths. */
-  get erasures() {
-    return this.erased;
-  }
-  /** Total number of operations (modifications + erasures) in this ChangeSet. */
-  get operationCount() {
-    return this.mods.size + this.erased.size;
-  }
-  /** Whether the ChangeSet has no modifications and no erasures. */
-  get isEmpty() {
-    return this.mods.size === 0 && this.erased.size === 0;
-  }
-  /** Whether the erase-all-private-tags flag is set. */
-  get erasePrivate() {
-    return this.erased.has(ERASE_PRIVATE_SENTINEL);
-  }
-  /**
-   * Merges another ChangeSet into this one, returning a new ChangeSet.
-   *
-   * The `other` ChangeSet wins on conflicts: if the same tag is modified in both,
-   * `other`'s value is used. Erasures from both sets are unioned. An erasure in
-   * `other` removes a modification from `base`.
-   *
-   * @param other - The ChangeSet to merge in
-   * @returns A new ChangeSet with merged modifications and erasures
-   */
-  merge(other) {
-    const mergedErasures = /* @__PURE__ */ new Set([...this.erased, ...other.erased]);
-    const mergedMods = buildMergedModifications(this.mods, other.mods, mergedErasures);
-    return new _ChangeSet(mergedMods, mergedErasures);
-  }
-  /**
-   * Converts modifications to dcmodify-compatible TagModification array.
-   *
-   * @returns A readonly array of TagModification objects
-   */
-  toModifications() {
-    const result = [];
-    for (const [tag, value] of this.mods) {
-      result.push({ tag, value });
-    }
-    return result;
-  }
-  /**
-   * Converts erasures to dcmodify-compatible argument strings.
-   *
-   * The erase-private sentinel is excluded — use {@link erasePrivate} to check
-   * whether `-ep` should be passed.
-   *
-   * @returns A readonly array of tag path strings for `-e` arguments
-   */
-  toErasureArgs() {
-    const result = [];
-    for (const path2 of this.erased) {
-      if (path2 !== ERASE_PRIVATE_SENTINEL) {
-        result.push(path2);
-      }
-    }
-    return result;
-  }
-};
-
 // src/dicom/walkTags.ts
 var DEFAULT_MAX_DEPTH = 16;
 function walkTags(data, options) {
@@ -1876,83 +1693,304 @@ var DicomDataset = class _DicomDataset {
     } catch (e) {
       return err(stderr(e));
     }
-    return traversePath(this.data, segments);
+    return traversePath(this.data, segments);
+  }
+  /**
+   * Finds all values matching a path with wildcard `[*]` indices.
+   *
+   * Traverses all items in wildcard sequence positions using an iterative BFS queue.
+   * The traversal is bounded to {@link MAX_TRAVERSAL_DEPTH} * 100 iterations (5 000).
+   * For extremely large datasets this may truncate results silently; callers
+   * needing completeness guarantees should verify dataset size independently.
+   *
+   * @param path - A branded DicomTagPath, e.g. `(0040,A730)[*].(0040,A160)`
+   * @returns A readonly array of all matching values (may be empty)
+   */
+  findValues(path2) {
+    let segments;
+    try {
+      segments = tagPathToSegments(path2);
+    } catch {
+      return [];
+    }
+    const result = collectWildcard(this.data, segments);
+    return result.values;
+  }
+  /**
+   * Walks all tags in this dataset, optionally filtering by VR and recursing into sequences.
+   *
+   * @param options - Optional VR filter and max depth
+   * @returns A readonly array of all matching tag entries
+   */
+  walkTags(options) {
+    return walkTags(this.data, options);
+  }
+  // -----------------------------------------------------------------------
+  // Convenience readonly getters
+  // -----------------------------------------------------------------------
+  /** Accession Number (0008,0050). */
+  get accession() {
+    return this.getString(TAGS.AccessionNumber);
+  }
+  /** Patient's Name (0010,0010). */
+  get patientName() {
+    return this.getString(TAGS.PatientName);
+  }
+  /** Patient ID (0010,0020). */
+  get patientID() {
+    return this.getString(TAGS.PatientID);
+  }
+  /** Study Date (0008,0020). */
+  get studyDate() {
+    return this.getString(TAGS.StudyDate);
+  }
+  /** Modality (0008,0060). */
+  get modality() {
+    return this.getString(TAGS.Modality);
+  }
+  /** SOP Class UID (0008,0016) as a branded SOPClassUID, or undefined if missing/invalid. */
+  get sopClassUID() {
+    const uid = this.getString(TAGS.SOPClassUID);
+    if (uid.length === 0) return void 0;
+    const result = createSOPClassUID(uid);
+    return result.ok ? result.value : void 0;
+  }
+  /** Study Instance UID (0020,000D). */
+  get studyInstanceUID() {
+    return this.getString(TAGS.StudyInstanceUID);
+  }
+  /** Series Instance UID (0020,000E). */
+  get seriesInstanceUID() {
+    return this.getString(TAGS.SeriesInstanceUID);
+  }
+  /** SOP Instance UID (0008,0018). */
+  get sopInstanceUID() {
+    return this.getString(TAGS.SOPInstanceUID);
+  }
+  /** Transfer Syntax UID (0002,0010). */
+  get transferSyntaxUID() {
+    return this.getString(TAGS.TransferSyntaxUID);
+  }
+};
+
+// src/dicom/ChangeSet.ts
+var ERASE_PRIVATE_SENTINEL = "__ERASE_PRIVATE__";
+function isControlChar(code) {
+  if (code <= 9) return true;
+  if (code === 11 || code === 12) return true;
+  if (code >= 14 && code <= 31) return true;
+  return code === 127;
+}
+function sanitizeValue(value) {
+  let result = "";
+  for (let i = 0; i < value.length; i++) {
+    const code = value.charCodeAt(i);
+    if (!isControlChar(code)) {
+      result += value[i];
+    }
+  }
+  return result;
+}
+function buildMergedModifications(base, other, erasures) {
+  const merged = new Map(base);
+  for (const [key, value] of other) {
+    merged.set(key, value);
+  }
+  for (const key of erasures) {
+    merged.delete(key);
+  }
+  return merged;
+}
+function applyBatchEntries(initial, entries) {
+  const keys = Object.keys(entries);
+  let cs = initial;
+  for (let i = 0; i < keys.length; i++) {
+    const key = keys[i];
+    if (key === void 0) continue;
+    const value = entries[key];
+    if (value === void 0) continue;
+    cs = cs.setTag(key, value);
+  }
+  return cs;
+}
+var ChangeSet = class _ChangeSet {
+  constructor(mods, erasures) {
+    __publicField(this, "mods");
+    __publicField(this, "erased");
+    this.mods = mods;
+    this.erased = erasures;
+  }
+  /** Creates an empty ChangeSet with no modifications or erasures. */
+  static empty() {
+    return new _ChangeSet(/* @__PURE__ */ new Map(), /* @__PURE__ */ new Set());
+  }
+  /**
+   * Sets a tag value, returning a new ChangeSet.
+   *
+   * Control characters (except LF/CR) are stripped from the value.
+   * If the tag was previously erased, it is removed from the erasure set.
+   *
+   * @param path - The DICOM tag path to set (e.g. `'(0010,0010)'`)
+   * @param value - The new value for the tag
+   * @returns A new ChangeSet with the modification applied
+   * @throws Error if operation count would exceed MAX_CHANGESET_OPERATIONS
+   */
+  setTag(path2, value) {
+    const totalOps = this.mods.size + this.erased.size;
+    if (totalOps >= MAX_CHANGESET_OPERATIONS) {
+      throw new Error(`ChangeSet operation limit (${MAX_CHANGESET_OPERATIONS}) exceeded`);
+    }
+    tagPathToSegments(path2);
+    const sanitized = sanitizeValue(value);
+    const newMods = new Map(this.mods);
+    newMods.set(path2, sanitized);
+    const newErasures = new Set(this.erased);
+    newErasures.delete(path2);
+    return new _ChangeSet(newMods, newErasures);
   }
   /**
-   * Finds all values matching a path with wildcard `[*]` indices.
+   * Marks a tag for erasure, returning a new ChangeSet.
    *
-   * Traverses all items in wildcard sequence positions using an iterative BFS queue.
-   * The traversal is bounded to {@link MAX_TRAVERSAL_DEPTH} * 100 iterations (5 000).
-   * For extremely large datasets this may truncate results silently; callers
-   * needing completeness guarantees should verify dataset size independently.
+   * If the tag was previously set, the modification is removed.
    *
-   * @param path - A branded DicomTagPath, e.g. `(0040,A730)[*].(0040,A160)`
-   * @returns A readonly array of all matching values (may be empty)
+   * @param path - The DICOM tag path to erase (e.g. `'(0010,0010)'`)
+   * @returns A new ChangeSet with the erasure applied
+   * @throws Error if operation count would exceed MAX_CHANGESET_OPERATIONS
    */
-  findValues(path2) {
-    let segments;
-    try {
-      segments = tagPathToSegments(path2);
-    } catch {
-      return [];
+  eraseTag(path2) {
+    const totalOps = this.mods.size + this.erased.size;
+    if (totalOps >= MAX_CHANGESET_OPERATIONS) {
+      throw new Error(`ChangeSet operation limit (${MAX_CHANGESET_OPERATIONS}) exceeded`);
     }
-    const result = collectWildcard(this.data, segments);
-    return result.values;
+    tagPathToSegments(path2);
+    const newMods = new Map(this.mods);
+    newMods.delete(path2);
+    const newErasures = new Set(this.erased);
+    newErasures.add(path2);
+    return new _ChangeSet(newMods, newErasures);
   }
   /**
-   * Walks all tags in this dataset, optionally filtering by VR and recursing into sequences.
+   * Marks all private tags for erasure, returning a new ChangeSet.
    *
-   * @param options - Optional VR filter and max depth
-   * @returns A readonly array of all matching tag entries
+   * @returns A new ChangeSet with the erase-private flag set
+   * @throws Error if operation count would exceed MAX_CHANGESET_OPERATIONS
    */
-  walkTags(options) {
-    return walkTags(this.data, options);
+  erasePrivateTags() {
+    const totalOps = this.mods.size + this.erased.size;
+    if (totalOps >= MAX_CHANGESET_OPERATIONS) {
+      throw new Error(`ChangeSet operation limit (${MAX_CHANGESET_OPERATIONS}) exceeded`);
+    }
+    const newErasures = new Set(this.erased);
+    newErasures.add(ERASE_PRIVATE_SENTINEL);
+    return new _ChangeSet(new Map(this.mods), newErasures);
   }
   // -----------------------------------------------------------------------
-  // Convenience readonly getters
+  // Convenience setters for common DICOM tags
   // -----------------------------------------------------------------------
-  /** Accession Number (0008,0050). */
-  get accession() {
-    return this.getString(TAGS.AccessionNumber);
+  /** Sets Patient's Name (0010,0010). */
+  setPatientName(value) {
+    return this.setTag("(0010,0010)", value);
   }
-  /** Patient's Name (0010,0010). */
-  get patientName() {
-    return this.getString(TAGS.PatientName);
+  /** Sets Patient ID (0010,0020). */
+  setPatientID(value) {
+    return this.setTag("(0010,0020)", value);
   }
-  /** Patient ID (0010,0020). */
-  get patientID() {
-    return this.getString(TAGS.PatientID);
+  /** Sets Study Date (0008,0020). */
+  setStudyDate(value) {
+    return this.setTag("(0008,0020)", value);
   }
-  /** Study Date (0008,0020). */
-  get studyDate() {
-    return this.getString(TAGS.StudyDate);
+  /** Sets Modality (0008,0060). */
+  setModality(value) {
+    return this.setTag("(0008,0060)", value);
   }
-  /** Modality (0008,0060). */
-  get modality() {
-    return this.getString(TAGS.Modality);
+  /** Sets Accession Number (0008,0050). */
+  setAccessionNumber(value) {
+    return this.setTag("(0008,0050)", value);
   }
-  /** SOP Class UID (0008,0016) as a branded SOPClassUID, or undefined if missing/invalid. */
-  get sopClassUID() {
-    const uid = this.getString(TAGS.SOPClassUID);
-    if (uid.length === 0) return void 0;
-    const result = createSOPClassUID(uid);
-    return result.ok ? result.value : void 0;
+  /** Sets Study Description (0008,1030). */
+  setStudyDescription(value) {
+    return this.setTag("(0008,1030)", value);
   }
-  /** Study Instance UID (0020,000D). */
-  get studyInstanceUID() {
-    return this.getString(TAGS.StudyInstanceUID);
+  /** Sets Series Description (0008,103E). */
+  setSeriesDescription(value) {
+    return this.setTag("(0008,103E)", value);
   }
-  /** Series Instance UID (0020,000E). */
-  get seriesInstanceUID() {
-    return this.getString(TAGS.SeriesInstanceUID);
+  /** Sets Institution Name (0008,0080). */
+  setInstitutionName(value) {
+    return this.setTag("(0008,0080)", value);
   }
-  /** SOP Instance UID (0008,0018). */
-  get sopInstanceUID() {
-    return this.getString(TAGS.SOPInstanceUID);
+  /**
+   * Sets multiple tags at once, returning a new ChangeSet.
+   *
+   * @param entries - A record of tag path → value pairs
+   * @returns A new ChangeSet with all modifications applied
+   */
+  setBatch(entries) {
+    return applyBatchEntries(this, entries);
   }
-  /** Transfer Syntax UID (0002,0010). */
-  get transferSyntaxUID() {
-    return this.getString(TAGS.TransferSyntaxUID);
+  /** All pending tag modifications as a readonly map of path → value. */
+  get modifications() {
+    return this.mods;
+  }
+  /** All pending tag erasures as a readonly set of paths. */
+  get erasures() {
+    return this.erased;
+  }
+  /** Total number of operations (modifications + erasures) in this ChangeSet. */
+  get operationCount() {
+    return this.mods.size + this.erased.size;
+  }
+  /** Whether the ChangeSet has no modifications and no erasures. */
+  get isEmpty() {
+    return this.mods.size === 0 && this.erased.size === 0;
+  }
+  /** Whether the erase-all-private-tags flag is set. */
+  get erasePrivate() {
+    return this.erased.has(ERASE_PRIVATE_SENTINEL);
+  }
+  /**
+   * Merges another ChangeSet into this one, returning a new ChangeSet.
+   *
+   * The `other` ChangeSet wins on conflicts: if the same tag is modified in both,
+   * `other`'s value is used. Erasures from both sets are unioned. An erasure in
+   * `other` removes a modification from `base`.
+   *
+   * @param other - The ChangeSet to merge in
+   * @returns A new ChangeSet with merged modifications and erasures
+   */
+  merge(other) {
+    const mergedErasures = /* @__PURE__ */ new Set([...this.erased, ...other.erased]);
+    const mergedMods = buildMergedModifications(this.mods, other.mods, mergedErasures);
+    return new _ChangeSet(mergedMods, mergedErasures);
+  }
+  /**
+   * Converts modifications to dcmodify-compatible TagModification array.
+   *
+   * @returns A readonly array of TagModification objects
+   */
+  toModifications() {
+    const result = [];
+    for (const [tag, value] of this.mods) {
+      result.push({ tag, value });
+    }
+    return result;
+  }
+  /**
+   * Converts erasures to dcmodify-compatible argument strings.
+   *
+   * The erase-private sentinel is excluded — use {@link erasePrivate} to check
+   * whether `-ep` should be passed.
+   *
+   * @returns A readonly array of tag path strings for `-e` arguments
+   */
+  toErasureArgs() {
+    const result = [];
+    for (const path2 of this.erased) {
+      if (path2 !== ERASE_PRIVATE_SENTINEL) {
+        result.push(path2);
+      }
+    }
+    return result;
   }
 };
 function killTree(pid) {
@@ -1969,13 +2007,14 @@ async function execCommand(binary, args, options) {
       windowsHide: true,
       signal: options?.signal
     });
-    wireSpawnListeners(child, timeoutMs, resolve);
+    wireSpawnListeners(binary, child, timeoutMs, resolve);
   });
 }
-function wireSpawnListeners(child, timeoutMs, resolve) {
+function wireSpawnListeners(binary, child, timeoutMs, resolve) {
   let stdout = "";
   let stderr6 = "";
   let settled = false;
+  const name = binary.split("/").pop() ?? binary;
   const settle = (result) => {
     if (settled) return;
     settled = true;
@@ -1984,25 +2023,25 @@ function wireSpawnListeners(child, timeoutMs, resolve) {
   };
   const timer = setTimeout(() => {
     if (child.pid !== void 0 && child.pid !== null) killTree(child.pid);
-    settle(err(new Error(`Process timed out after ${timeoutMs}ms`)));
+    settle(err(new Error(`${name} timed out after ${timeoutMs}ms (pid: ${String(child.pid ?? "unknown")})`)));
   }, timeoutMs);
   child.stdout?.on("data", (chunk) => {
     stdout += String(chunk);
     if (stdout.length + stderr6.length > MAX_OUTPUT_BYTES) {
       if (child.pid !== void 0 && child.pid !== null) killTree(child.pid);
-      settle(err(new Error(`Process output exceeded ${MAX_OUTPUT_BYTES} bytes`)));
+      settle(err(new Error(`${name} output exceeded ${MAX_OUTPUT_BYTES} bytes`)));
     }
   });
   child.stderr?.on("data", (chunk) => {
     stderr6 += String(chunk);
     if (stdout.length + stderr6.length > MAX_OUTPUT_BYTES) {
       if (child.pid !== void 0 && child.pid !== null) killTree(child.pid);
-      settle(err(new Error(`Process output exceeded ${MAX_OUTPUT_BYTES} bytes`)));
+      settle(err(new Error(`${name} output exceeded ${MAX_OUTPUT_BYTES} bytes`)));
     }
   });
   child.on("error", (error) => {
     if (child.pid !== void 0 && child.pid !== null) killTree(child.pid);
-    settle(err(new Error(`Process error: ${error.message}`)));
+    settle(err(new Error(`${name} error: ${error.message}`)));
   });
   child.on("close", (code) => {
     settle(ok({ stdout, stderr: stderr6, exitCode: code ?? 1 }));
@@ -2017,7 +2056,7 @@ async function spawnCommand(binary, args, options) {
       windowsHide: true,
       signal: options?.signal
     });
-    wireSpawnListeners(child, timeoutMs, resolve);
+    wireSpawnListeners(binary, child, timeoutMs, resolve);
   });
 }
 var PN_REPS = ["Alphabetic", "Ideographic", "Phonetic"];
@@ -2783,6 +2822,102 @@ var DicomReceiverOptionsSchema = z.object({
 }).strict().refine((data) => (data.minPoolSize ?? DEFAULT_MIN_POOL_SIZE) <= (data.maxPoolSize ?? DEFAULT_MAX_POOL_SIZE), {
   message: "minPoolSize must be <= maxPoolSize"
 });
+var Worker = class {
+  constructor(dcmrecv, port, tempDir) {
+    __publicField(this, "dcmrecv");
+    __publicField(this, "port");
+    __publicField(this, "tempDir");
+    __publicField(this, "_state", "idle");
+    __publicField(this, "_context");
+    __publicField(this, "_pending", /* @__PURE__ */ new Set());
+    __publicField(this, "_files", []);
+    __publicField(this, "_fileSizes", []);
+    __publicField(this, "_outputLines", []);
+    __publicField(this, "_remoteSocket");
+    __publicField(this, "_workerSocket");
+    this.dcmrecv = dcmrecv;
+    this.port = port;
+    this.tempDir = tempDir;
+  }
+  /** Current worker state. */
+  get state() {
+    return this._state;
+  }
+  /** Active association context, or undefined when idle. */
+  get context() {
+    return this._context;
+  }
+  /** Files moved to the association directory during the current association. */
+  get files() {
+    return this._files;
+  }
+  /** Byte sizes parallel to files[], for transfer stats. */
+  get fileSizes() {
+    return this._fileSizes;
+  }
+  /** Captured output lines during the current association. */
+  get outputLines() {
+    return this._outputLines;
+  }
+  /** Marks the worker busy with a new association context. */
+  beginAssociation(ctx) {
+    this._state = "busy";
+    this._context = ctx;
+    this._files.length = 0;
+    this._fileSizes.length = 0;
+    this._outputLines.length = 0;
+    this._pending.clear();
+  }
+  /** Returns the worker to idle and clears all association state. */
+  endAssociation() {
+    this._state = "idle";
+    this._context = void 0;
+    this._files.length = 0;
+    this._fileSizes.length = 0;
+    this._outputLines.length = 0;
+    this._pending.clear();
+    this._remoteSocket = void 0;
+    this._workerSocket = void 0;
+  }
+  /** Tracks an in-flight file handling promise; auto-removes on completion. */
+  trackFile(promise) {
+    this._pending.add(promise);
+    void promise.finally(() => {
+      this._pending.delete(promise);
+    });
+  }
+  /** Records a successfully received file path and its size. */
+  recordFile(filePath, size) {
+    this._files.push(filePath);
+    this._fileSizes.push(size);
+  }
+  /** Awaits all in-flight file handling promises. */
+  async drainPendingFiles() {
+    if (this._pending.size > 0) {
+      await Promise.all(this._pending);
+    }
+  }
+  /** Appends a line to the output buffer, respecting the cap. */
+  captureOutput(text) {
+    if (this._outputLines.length < MAX_OUTPUT_LINES_PER_ASSOCIATION) {
+      this._outputLines.push(text);
+    }
+  }
+  /** Stores the remote and worker sockets for later cleanup. */
+  setSockets(remote, worker) {
+    this._remoteSocket = remote;
+    this._workerSocket = worker;
+  }
+  /** Destroys both sockets if they exist and are not already destroyed. */
+  destroySockets() {
+    if (this._remoteSocket !== void 0 && !this._remoteSocket.destroyed) {
+      this._remoteSocket.destroy();
+    }
+    if (this._workerSocket !== void 0 && !this._workerSocket.destroyed) {
+      this._workerSocket.destroy();
+    }
+  }
+};
 function allocatePort() {
   return new Promise((resolve) => {
     const server = net.createServer();
@@ -2800,6 +2935,13 @@ function allocatePort() {
     });
   });
 }
+function sumArray(arr) {
+  let total = 0;
+  for (let i = 0; i < arr.length; i++) {
+    total += arr[i] ?? 0;
+  }
+  return total;
+}
 var DicomReceiver = class _DicomReceiver extends EventEmitter {
   constructor(options) {
     super();
@@ -2814,8 +2956,6 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
     __publicField(this, "stopping", false);
     __publicField(this, "abortHandler");
     this.setMaxListeners(20);
-    this.on("error", () => {
-    });
     this.options = options;
     this.minPoolSize = options.minPoolSize ?? DEFAULT_MIN_POOL_SIZE;
     this.maxPoolSize = options.maxPoolSize ?? DEFAULT_MAX_POOL_SIZE;
@@ -3023,14 +3163,12 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
       this.emit("error", { error: mkdirResult.error });
       return;
     }
-    worker.state = "busy";
-    worker.associationId = associationId;
-    worker.associationDir = associationDir;
-    worker.files = [];
-    worker.fileSizes = [];
-    worker.outputLines = [];
-    worker.pendingFiles = [];
-    worker.startAt = Date.now();
+    const ctx = {
+      associationId,
+      associationDir,
+      startAt: Date.now()
+    };
+    worker.beginAssociation(ctx);
     this.pipeConnection(worker, remoteSocket);
     void this.replenishPool();
   }
@@ -3040,7 +3178,7 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
     if (idle !== void 0) return idle;
     const maxRetries = Math.min(Math.ceil(this.connectionTimeoutMs / CONNECTION_RETRY_INTERVAL_MS), MAX_CONNECTION_RETRIES);
     for (let i = 0; i < maxRetries; i++) {
-      await delay(CONNECTION_RETRY_INTERVAL_MS);
+      await setTimeout$1(CONNECTION_RETRY_INTERVAL_MS);
       const found = this.getIdleWorker();
       if (found !== void 0) return found;
       if (this.stopping) return void 0;
@@ -3057,8 +3195,7 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
   /** Pipes remote socket bidirectionally to the worker's port. */
   pipeConnection(worker, remoteSocket) {
     const workerSocket = net.createConnection({ port: worker.port, host: "127.0.0.1" });
-    worker.remoteSocket = remoteSocket;
-    worker.workerSocket = workerSocket;
+    worker.setSockets(remoteSocket, workerSocket);
     const cleanup = () => {
       remoteSocket.unpipe(workerSocket);
       workerSocket.unpipe(remoteSocket);
@@ -3117,21 +3254,7 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
     const createResult = this.createDcmrecv(port, tempDir);
     if (!createResult.ok) return createResult;
     const dcmrecv = createResult.value;
-    const worker = {
-      dcmrecv,
-      port,
-      tempDir,
-      state: "idle",
-      associationId: void 0,
-      associationDir: void 0,
-      files: [],
-      fileSizes: [],
-      outputLines: [],
-      pendingFiles: [],
-      startAt: void 0,
-      remoteSocket: void 0,
-      workerSocket: void 0
-    };
+    const worker = new Worker(dcmrecv, port, tempDir);
     this.wireWorkerEvents(worker);
     const startResult = await dcmrecv.start();
     if (!startResult.ok) {
@@ -3140,14 +3263,9 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
     this.workers.set(port, worker);
     return ok(worker);
   }
-  /** Stops a single worker: stop process, clean temp dir, remove from pool. */
+  /** Stops a single worker: destroy sockets, stop process, clean temp dir, remove from pool. */
   async stopWorker(worker) {
-    if (worker.remoteSocket !== void 0 && !worker.remoteSocket.destroyed) {
-      worker.remoteSocket.destroy();
-    }
-    if (worker.workerSocket !== void 0 && !worker.workerSocket.destroyed) {
-      worker.workerSocket.destroy();
-    }
+    worker.destroySockets();
     await worker.dcmrecv.stop();
     worker.dcmrecv[Symbol.dispose]();
     await removeDirSafe(worker.tempDir);
@@ -3199,12 +3317,11 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
     this.wireRefusingAssociation(worker);
     this.wireOutputCapture(worker);
   }
-  /** Wires FILE_RECEIVED from dcmrecv worker — files are processed serially per worker. */
+  /** Wires FILE_RECEIVED from dcmrecv worker — captures context synchronously. */
   wireFileReceived(worker) {
     worker.dcmrecv.onFileReceived((data) => {
-      const assocId = worker.associationId;
-      const assocDir = worker.associationDir;
-      if (assocDir === void 0 || assocId === void 0) {
+      const ctx = worker.context;
+      if (ctx === void 0) {
         this.emit("error", {
           error: new Error(`DicomReceiver: FILE_RECEIVED with no active association (worker state: ${worker.state})`),
           filePath: data.filePath,
@@ -3214,21 +3331,21 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
         });
         return;
       }
-      const promise = this.handleFileReceived(worker, data, assocId, assocDir);
-      worker.pendingFiles.push(promise);
+      const promise = this.handleFileReceived(worker, data, ctx);
+      worker.trackFile(promise);
     });
   }
   /** Moves a received file, opens it as DicomInstance, and emits FILE_RECEIVED. */
-  async handleFileReceived(worker, data, assocId, assocDir) {
+  async handleFileReceived(worker, data, ctx) {
     try {
-      await this.moveAndEmitFile(worker, data, assocId, assocDir);
+      await this.moveAndEmitFile(worker, data, ctx);
     } catch (thrown) {
       const error = thrown instanceof Error ? thrown : new Error(String(thrown));
       this.emit("error", {
         error,
         filePath: data.filePath,
-        associationId: assocId,
-        associationDir: assocDir,
+        associationId: ctx.associationId,
+        associationDir: ctx.associationDir,
         callingAE: data.callingAE,
         calledAE: data.calledAE,
         source: data.source
@@ -3236,21 +3353,20 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
     }
   }
   /** Inner handler: move file, parse DICOM, emit FILE_RECEIVED or error. */
-  async moveAndEmitFile(worker, data, assocId, assocDir) {
+  async moveAndEmitFile(worker, data, ctx) {
     const srcPath = data.filePath;
-    const destPath = path.join(assocDir, path.basename(srcPath));
+    const destPath = path.join(ctx.associationDir, path.basename(srcPath));
     const moveResult = await moveFile(srcPath, destPath);
     const finalPath = moveResult.ok ? destPath : srcPath;
     const fileSize = await statFileSafe(finalPath);
-    worker.files.push(finalPath);
-    worker.fileSizes.push(fileSize);
+    worker.recordFile(finalPath, fileSize);
     const openResult = await DicomInstance.open(finalPath);
     if (!openResult.ok) {
       this.emit("error", {
         error: openResult.error,
         filePath: finalPath,
-        associationId: assocId,
-        associationDir: assocDir,
+        associationId: ctx.associationId,
+        associationDir: ctx.associationDir,
         callingAE: data.callingAE,
         calledAE: data.calledAE,
         source: data.source
@@ -3260,8 +3376,8 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
     this.emit("FILE_RECEIVED", {
       filePath: finalPath,
       fileSize,
-      associationId: assocId,
-      associationDir: assocDir,
+      associationId: ctx.associationId,
+      associationDir: ctx.associationDir,
       callingAE: data.callingAE,
       calledAE: data.calledAE,
       source: data.source,
@@ -3276,21 +3392,20 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
   }
   /** Awaits ALL pending file operations, emits ASSOCIATION_COMPLETE, resets worker state. */
   async finalizeAssociation(worker, data) {
-    if (worker.pendingFiles.length > 0) {
-      await Promise.all(worker.pendingFiles);
-    }
+    await worker.drainPendingFiles();
     this.emitAssociationComplete(worker, data);
-    this.resetWorker(worker);
+    worker.endAssociation();
     void this.scaleDown();
   }
   /** Emits the ASSOCIATION_COMPLETE event with transfer stats. */
   emitAssociationComplete(worker, data) {
-    const assocId = worker.associationId ?? data.associationId;
-    const assocDir = worker.associationDir ?? "";
+    const ctx = worker.context;
+    const assocId = ctx?.associationId ?? data.associationId;
+    const assocDir = ctx?.associationDir ?? "";
+    const startAt = ctx?.startAt ?? Date.now();
     const files = [...worker.files];
     const output = [...worker.outputLines];
     const endAt = Date.now();
-    const startAt = worker.startAt ?? endAt;
     const totalBytes = sumArray(worker.fileSizes);
     const elapsedMs = endAt - startAt;
     const bytesPerSecond = elapsedMs > 0 ? Math.round(totalBytes / elapsedMs * 1e3) : 0;
@@ -3310,24 +3425,11 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
       output
     });
   }
-  /** Resets worker state to idle after an association completes. */
-  resetWorker(worker) {
-    worker.state = "idle";
-    worker.associationId = void 0;
-    worker.associationDir = void 0;
-    worker.files = [];
-    worker.fileSizes = [];
-    worker.outputLines = [];
-    worker.pendingFiles = [];
-    worker.startAt = void 0;
-    worker.remoteSocket = void 0;
-    worker.workerSocket = void 0;
-  }
   /** Bubbles ASSOCIATION_RECEIVED from dcmrecv worker. */
   wireAssociationReceived(worker) {
     worker.dcmrecv.onEvent("ASSOCIATION_RECEIVED", (data) => {
       this.emit("ASSOCIATION_RECEIVED", {
-        associationId: worker.associationId ?? "",
+        associationId: worker.context?.associationId ?? "",
         callingAE: data.callingAE,
         calledAE: data.calledAE,
         source: data.source
@@ -3338,7 +3440,7 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
   wireCStoreRequest(worker) {
     worker.dcmrecv.onEvent("C_STORE_REQUEST", (data) => {
       this.emit("C_STORE_REQUEST", {
-        associationId: worker.associationId ?? "",
+        associationId: worker.context?.associationId ?? "",
         raw: data.raw
       });
     });
@@ -3347,7 +3449,7 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
   wireEchoRequest(worker) {
     worker.dcmrecv.onEvent("ECHO_REQUEST", () => {
       this.emit("ECHO_REQUEST", {
-        associationId: worker.associationId ?? ""
+        associationId: worker.context?.associationId ?? ""
       });
     });
   }
@@ -3362,8 +3464,8 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
   /** Captures worker output lines during busy associations. */
   wireOutputCapture(worker) {
     worker.dcmrecv.on("line", ({ text }) => {
-      if (worker.state === "busy" && worker.outputLines.length < MAX_OUTPUT_LINES_PER_ASSOCIATION) {
-        worker.outputLines.push(text);
+      if (worker.state === "busy") {
+        worker.captureOutput(text);
       }
     });
   }
@@ -3382,56 +3484,6 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
     signal.addEventListener("abort", this.abortHandler, { once: true });
   }
 };
-async function ensureDirectory(dirPath) {
-  try {
-    await fs.mkdir(dirPath, { recursive: true });
-    return ok(void 0);
-  } catch (e) {
-    const msg = e instanceof Error ? e.message : String(e);
-    return err(new Error(`Failed to create directory ${dirPath}: ${msg}`));
-  }
-}
-async function moveFile(src, dest) {
-  try {
-    await fs.rename(src, dest);
-    return ok(void 0);
-  } catch {
-    try {
-      await fs.copyFile(src, dest);
-      await fs.unlink(src);
-      return ok(void 0);
-    } catch (e) {
-      const msg = e instanceof Error ? e.message : String(e);
-      return err(new Error(`Failed to move file ${src} \u2192 ${dest}: ${msg}`));
-    }
-  }
-}
-async function statFileSafe(filePath) {
-  try {
-    const stat3 = await fs.stat(filePath);
-    return stat3.size;
-  } catch {
-    return 0;
-  }
-}
-function sumArray(arr) {
-  let total = 0;
-  for (let i = 0; i < arr.length; i++) {
-    total += arr[i] ?? 0;
-  }
-  return total;
-}
-async function removeDirSafe(dirPath) {
-  try {
-    await fs.rm(dirPath, { recursive: true, force: true });
-  } catch {
-  }
-}
-function delay(ms) {
-  return new Promise((resolve) => {
-    setTimeout(resolve, ms);
-  });
-}
 
 // src/events/dcmprscp.ts
 var DcmprscpEvent = {