@ubercode/dcmtk 0.11.0 → 0.12.0

package/dist/servers.cjs

@@ -2855,6 +2855,9 @@ var Worker = class {
     __publicField(this, "_state", "idle");
     __publicField(this, "_context");
     __publicField(this, "_pending", /* @__PURE__ */ new Set());
+    __publicField(this, "_instancePending", /* @__PURE__ */ new Set());
+    __publicField(this, "_instancesReceived", 0);
+    __publicField(this, "_instanceErrors", 0);
     __publicField(this, "_files", []);
     __publicField(this, "_fileSizes", []);
     __publicField(this, "_outputLines", []);
@@ -2892,6 +2895,9 @@ var Worker = class {
     this._fileSizes.length = 0;
     this._outputLines.length = 0;
     this._pending.clear();
+    this._instancePending.clear();
+    this._instancesReceived = 0;
+    this._instanceErrors = 0;
   }
   /** Returns the worker to idle and clears all association state. */
   endAssociation() {
@@ -2901,6 +2907,9 @@ var Worker = class {
     this._fileSizes.length = 0;
     this._outputLines.length = 0;
     this._pending.clear();
+    this._instancePending.clear();
+    this._instancesReceived = 0;
+    this._instanceErrors = 0;
     this._remoteSocket = void 0;
     this._workerSocket = void 0;
   }
@@ -2911,6 +2920,35 @@ var Worker = class {
       this._pending.delete(promise);
     });
   }
+  /** Tracks an in-flight instance parsing promise; auto-removes on completion. */
+  trackInstance(promise) {
+    this._instancePending.add(promise);
+    void promise.finally(() => {
+      this._instancePending.delete(promise);
+    });
+  }
+  /** Records a successful instance parse. */
+  recordInstanceSuccess() {
+    this._instancesReceived++;
+  }
+  /** Records a failed instance parse. */
+  recordInstanceError() {
+    this._instanceErrors++;
+  }
+  /** Awaits all in-flight instance parsing promises. */
+  async drainInstancePending() {
+    if (this._instancePending.size > 0) {
+      await Promise.all(this._instancePending);
+    }
+  }
+  /** Number of successfully parsed instances in this association. */
+  get instancesReceived() {
+    return this._instancesReceived;
+  }
+  /** Number of failed instance parses in this association. */
+  get instanceErrors() {
+    return this._instanceErrors;
+  }
   /** Records a successfully received file path and its size. */
   recordFile(filePath, size) {
     this._files.push(filePath);
@@ -3082,7 +3120,16 @@ var DicomReceiver = class _DicomReceiver extends events.EventEmitter {
     return this.on("INSTANCE_RECEIVED", listener);
   }
   /**
-   * Registers a listener for completed associations.
+   * Registers a listener for DicomInstance.open failures.
+   *
+   * @param listener - Callback receiving instance error data
+   * @returns this for chaining
+   */
+  onInstanceError(listener) {
+    return this.on("INSTANCE_ERROR", listener);
+  }
+  /**
+   * Registers a listener for completed associations (file moves done).
    *
    * @param listener - Callback receiving association data
    * @returns this for chaining
@@ -3090,6 +3137,15 @@ var DicomReceiver = class _DicomReceiver extends events.EventEmitter {
   onAssociationComplete(listener) {
     return this.on("ASSOCIATION_COMPLETE", listener);
   }
+  /**
+   * Registers a listener for fully finalized associations (all parsing done).
+   *
+   * @param listener - Callback receiving finalized data with instance counts
+   * @returns this for chaining
+   */
+  onAssociationFinalized(listener) {
+    return this.on("ASSOCIATION_FINALIZED", listener);
+  }
   /**
    * Registers a listener for new associations (bubbled from workers).
    *
@@ -3419,34 +3475,33 @@ var DicomReceiver = class _DicomReceiver extends events.EventEmitter {
       calledAE: data.calledAE,
       source: data.source
     });
-    this.emitInstanceReceived(finalPath, fileSize, data, ctx);
+    const instanceCtx = {
+      filePath: finalPath,
+      fileSize,
+      associationId: ctx.associationId,
+      associationDir: ctx.associationDir,
+      callingAE: data.callingAE,
+      calledAE: data.calledAE,
+      source: data.source
+    };
+    worker.trackInstance(this.parseAndEmitInstance(worker, instanceCtx));
   }
-  /** Parses a DICOM file and emits INSTANCE_RECEIVED or error. */
-  emitInstanceReceived(filePath, fileSize, data, ctx) {
-    void DicomInstance.open(filePath).then((openResult) => {
+  /** Parses a DICOM file and emits INSTANCE_RECEIVED or INSTANCE_ERROR. */
+  async parseAndEmitInstance(worker, ctx) {
+    try {
+      const openResult = await DicomInstance.open(ctx.filePath);
       if (!openResult.ok) {
-        this.emit("error", {
-          error: openResult.error,
-          filePath,
-          associationId: ctx.associationId,
-          associationDir: ctx.associationDir,
-          callingAE: data.callingAE,
-          calledAE: data.calledAE,
-          source: data.source
-        });
+        worker.recordInstanceError();
+        this.emit("INSTANCE_ERROR", { error: openResult.error, thrown: false, ...ctx });
         return;
       }
-      this.emit("INSTANCE_RECEIVED", {
-        filePath,
-        fileSize,
-        associationId: ctx.associationId,
-        associationDir: ctx.associationDir,
-        callingAE: data.callingAE,
-        calledAE: data.calledAE,
-        source: data.source,
-        instance: openResult.value
-      });
-    });
+      worker.recordInstanceSuccess();
+      this.emit("INSTANCE_RECEIVED", { ...ctx, instance: openResult.value });
+    } catch (thrown) {
+      const error = thrown instanceof Error ? thrown : new Error(String(thrown));
+      worker.recordInstanceError();
+      this.emit("INSTANCE_ERROR", { error, thrown: true, ...ctx });
+    }
   }
   /** Returns worker to idle pool on association complete, emits summary. */
   wireAssociationComplete(worker) {
@@ -3454,10 +3509,12 @@ var DicomReceiver = class _DicomReceiver extends events.EventEmitter {
       void this.finalizeAssociation(worker, data);
     });
   }
-  /** Awaits ALL pending file operations, emits ASSOCIATION_COMPLETE, resets worker state. */
+  /** Awaits file ops, emits ASSOCIATION_COMPLETE, awaits parsing, emits ASSOCIATION_FINALIZED. */
   async finalizeAssociation(worker, data) {
     await worker.drainPendingFiles();
     this.emitAssociationComplete(worker, data);
+    await worker.drainInstancePending();
+    this.emitAssociationFinalized(worker, data);
     worker.endAssociation();
     void this.scaleDown();
   }
@@ -3489,6 +3546,20 @@ var DicomReceiver = class _DicomReceiver extends events.EventEmitter {
       output
     });
   }
+  /** Emits ASSOCIATION_FINALIZED after all instance parsing is done. */
+  emitAssociationFinalized(worker, data) {
+    const ctx = worker.context;
+    this.emit("ASSOCIATION_FINALIZED", {
+      associationId: ctx?.associationId ?? data.associationId,
+      associationDir: ctx?.associationDir ?? "",
+      callingAE: data.callingAE,
+      calledAE: data.calledAE,
+      source: data.source,
+      files: [...worker.files],
+      instancesReceived: worker.instancesReceived,
+      instanceErrors: worker.instanceErrors
+    });
+  }
   /** Bubbles ASSOCIATION_RECEIVED from dcmrecv worker. */
   wireAssociationReceived(worker) {
     worker.dcmrecv.onEvent("ASSOCIATION_RECEIVED", (data) => {