@ubercode/dcmtk 0.11.1 → 0.12.1

package/dist/{index--dDQfutR.d.ts → index-B5FQoIqM.d.ts}

@@ -1544,6 +1544,30 @@ interface PoolEchoRequestData {
 interface PoolRefusingAssociationData {
     readonly reason: string;
 }
+/** Data emitted with INSTANCE_ERROR events when DicomInstance.open fails. */
+interface ReceiverInstanceErrorData {
+    readonly error: Error;
+    /** Whether this was a thrown exception (true) or a Result error (false). */
+    readonly thrown: boolean;
+    readonly filePath: string;
+    readonly fileSize: number;
+    readonly associationId: string;
+    readonly associationDir: string;
+    readonly callingAE: string;
+    readonly calledAE: string;
+    readonly source: string;
+}
+/** Data emitted with ASSOCIATION_FINALIZED — all work (including parsing) is done. */
+interface ReceiverAssociationFinalizedData {
+    readonly associationId: string;
+    readonly associationDir: string;
+    readonly callingAE: string;
+    readonly calledAE: string;
+    readonly source: string;
+    readonly files: readonly string[];
+    readonly instancesReceived: number;
+    readonly instanceErrors: number;
+}
 /** Data emitted with error events. */
 interface ReceiverErrorData {
     readonly error: Error;
@@ -1559,7 +1583,9 @@ interface DicomReceiverEventMap {
     FILE_RECEIVED: [ReceiverFileReceivedData];
     FILE_STORED: [ReceiverFileStoredData];
     INSTANCE_RECEIVED: [ReceiverInstanceData];
+    INSTANCE_ERROR: [ReceiverInstanceErrorData];
     ASSOCIATION_COMPLETE: [ReceiverAssociationData];
+    ASSOCIATION_FINALIZED: [ReceiverAssociationFinalizedData];
     ASSOCIATION_RECEIVED: [PoolAssociationReceivedData];
     C_STORE_REQUEST: [PoolCStoreRequestData];
     ECHO_REQUEST: [PoolEchoRequestData];
@@ -1682,12 +1708,26 @@ declare class DicomReceiver extends EventEmitter<DicomReceiverEventMap> {
      */
     onInstanceReceived(listener: (data: ReceiverInstanceData) => void): this;
     /**
-     * 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: (data: ReceiverInstanceErrorData) => void): this;
+    /**
+     * Registers a listener for completed associations (file moves done).
      *
      * @param listener - Callback receiving association data
      * @returns this for chaining
      */
     onAssociationComplete(listener: (data: ReceiverAssociationData) => void): this;
+    /**
+     * 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: (data: ReceiverAssociationFinalizedData) => void): this;
     /**
      * Registers a listener for new associations (bubbled from workers).
      *
@@ -1759,14 +1799,16 @@ declare class DicomReceiver extends EventEmitter<DicomReceiverEventMap> {
     private handleFileReceived;
     /** Inner handler: move file, emit FILE_STORED, parse DICOM, emit INSTANCE_RECEIVED. */
     private moveAndEmitFile;
-    /** Parses a DICOM file and emits INSTANCE_RECEIVED or error. */
-    private emitInstanceReceived;
+    /** Parses a DICOM file and emits INSTANCE_RECEIVED or INSTANCE_ERROR. */
+    private parseAndEmitInstance;
     /** Returns worker to idle pool on association complete, emits summary. */
     private wireAssociationComplete;
-    /** Awaits ALL pending file operations, emits ASSOCIATION_COMPLETE, resets worker state. */
+    /** Awaits file ops, emits ASSOCIATION_COMPLETE, awaits parsing, emits ASSOCIATION_FINALIZED. */
     private finalizeAssociation;
     /** Emits the ASSOCIATION_COMPLETE event with transfer stats. */
     private emitAssociationComplete;
+    /** Emits ASSOCIATION_FINALIZED after all instance parsing is done. */
+    private emitAssociationFinalized;
     /** Bubbles ASSOCIATION_RECEIVED from dcmrecv worker. */
     private wireAssociationReceived;
     /** Bubbles C_STORE_REQUEST from dcmrecv worker. */
@@ -1783,4 +1825,4 @@ declare class DicomReceiver extends EventEmitter<DicomReceiverEventMap> {
 /** @deprecated Use ReceiverFileStoredData instead. */
 type ReceiverFileData = ReceiverFileStoredData;
 
-export { type PoolCStoreRequestData as $, type AssociationAcknowledgedData as A, type DcmpsrcvEventValue as B, type CStoreRequestData as C, DCMPRSCP_FATAL_EVENTS as D, type DcmpsrcvOptions as E, DcmqrscpEvent as F, type DcmqrscpEventValue as G, Dcmrecv as H, DcmrecvEvent as I, type DcmrecvEventMap as J, type DcmrecvEventValue as K, type DcmrecvOptions as L, DcmtkProcess as M, type DcmtkProcessConfig as N, type DcmtkProcessEventMap as O, DicomReceiver as P, type DicomReceiverEventMap as Q, type DicomReceiverOptions as R, type EventPattern as S, type FileDeletedData as T, type FileReceivedData as U, FilenameMode as V, type FilenameModeValue as W, LineParser as X, type LineParserEventMap as Y, type MultiLineConfig as Z, type PoolAssociationReceivedData as _, type AssociationCompleteData as a, type PoolEchoRequestData as a0, type PoolRefusingAssociationData as a1, type PoolStatus as a2, PreferredTransferSyntax as a3, type PreferredTransferSyntaxValue as a4, type PrintAssociationAcknowledgedData as a5, type PrintAssociationReceivedData as a6, type PrintCannotStartListenerData as a7, ProcessState as a8, type ProcessStateValue as a9, type StorageModeValue as aA, StoreSCP as aB, type StoreSCPEventMap as aC, type StoreSCPOptions as aD, StoreSCPPreset as aE, type StoreSCPPresetName as aF, type StoredFileData as aG, StorescpEvent as aH, type StorescpEventValue as aI, type StoringFileData as aJ, type SubdirectoryCreatedData as aK, SubdirectoryMode as aL, type SubdirectoryModeValue as aM, type TrackedFile as aN, WLMSCPFS_FATAL_EVENTS as aO, WLMSCPFS_PATTERNS as aP, type WlmAssociationAcknowledgedData as aQ, type WlmAssociationReceivedData as aR, type WlmCFindRequestData as aS, type WlmCannotStartListenerData as aT, type WlmListeningData as aU, Wlmscpfs as aV, WlmscpfsEvent as aW, type WlmscpfsEventMap as aX, type WlmscpfsEventValue as aY, type WlmscpfsOptions as aZ, type QRAssociationAcknowledgedData as aa, type QRAssociationReceivedData as ab, type QRCFindRequestData as ac, type QRCGetRequestData as ad, type QRCMoveRequestData as ae, type QRCStoreRequestData as af, type QRCannotStartListenerData as ag, type QRListeningData as ah, type ReceiverAssociationAcknowledgedData as ai, type ReceiverAssociationData as aj, type ReceiverAssociationReceivedData as ak, type ReceiverCStoreRequestData as al, type ReceiverCannotStartListenerData as am, type ReceiverConfigErrorData as an, type ReceiverDatabaseReadyData as ao, type ReceiverEchoRequestData as ap, type ReceiverErrorData as aq, type ReceiverFileData as ar, type ReceiverFileReceivedData as as, type ReceiverFileStoredData as at, type ReceiverInstanceData as au, type ReceiverListeningData as av, type RefusingAssociationData as aw, STORESCP_FATAL_EVENTS as ax, STORESCP_PATTERNS as ay, StorageMode as az, type AssociationContext as b, type AssociationReceivedData as c, type AssociationSummary as d, AssociationTracker as e, type CannotStartListenerData as f, type ConfigErrorData as g, DCMPRSCP_PATTERNS as h, DCMPSRCV_FATAL_EVENTS as i, DCMPSRCV_PATTERNS as j, DCMQRSCP_FATAL_EVENTS as k, DCMQRSCP_PATTERNS as l, DCMRECV_FATAL_EVENTS as m, DCMRECV_PATTERNS as n, type DatabaseReadyData as o, DcmQRSCP as p, type DcmQRSCPEventMap as q, type DcmQRSCPOptions as r, DcmprsCP as s, type DcmprsCPEventMap as t, type DcmprsCPOptions as u, DcmprscpEvent as v, type DcmprscpEventValue as w, Dcmpsrcv as x, DcmpsrcvEvent as y, type DcmpsrcvEventMap as z };
+export { type PoolCStoreRequestData as $, type AssociationAcknowledgedData as A, type DcmpsrcvEventValue as B, type CStoreRequestData as C, DCMPRSCP_FATAL_EVENTS as D, type DcmpsrcvOptions as E, DcmqrscpEvent as F, type DcmqrscpEventValue as G, Dcmrecv as H, DcmrecvEvent as I, type DcmrecvEventMap as J, type DcmrecvEventValue as K, type DcmrecvOptions as L, DcmtkProcess as M, type DcmtkProcessConfig as N, type DcmtkProcessEventMap as O, DicomReceiver as P, type DicomReceiverEventMap as Q, type DicomReceiverOptions as R, type EventPattern as S, type FileDeletedData as T, type FileReceivedData as U, FilenameMode as V, type FilenameModeValue as W, LineParser as X, type LineParserEventMap as Y, type MultiLineConfig as Z, type PoolAssociationReceivedData as _, type AssociationCompleteData as a, type WlmscpfsOptions as a$, type PoolEchoRequestData as a0, type PoolRefusingAssociationData as a1, type PoolStatus as a2, PreferredTransferSyntax as a3, type PreferredTransferSyntaxValue as a4, type PrintAssociationAcknowledgedData as a5, type PrintAssociationReceivedData as a6, type PrintCannotStartListenerData as a7, ProcessState as a8, type ProcessStateValue as a9, STORESCP_PATTERNS as aA, StorageMode as aB, type StorageModeValue as aC, StoreSCP as aD, type StoreSCPEventMap as aE, type StoreSCPOptions as aF, StoreSCPPreset as aG, type StoreSCPPresetName as aH, type StoredFileData as aI, StorescpEvent as aJ, type StorescpEventValue as aK, type StoringFileData as aL, type SubdirectoryCreatedData as aM, SubdirectoryMode as aN, type SubdirectoryModeValue as aO, type TrackedFile as aP, WLMSCPFS_FATAL_EVENTS as aQ, WLMSCPFS_PATTERNS as aR, type WlmAssociationAcknowledgedData as aS, type WlmAssociationReceivedData as aT, type WlmCFindRequestData as aU, type WlmCannotStartListenerData as aV, type WlmListeningData as aW, Wlmscpfs as aX, WlmscpfsEvent as aY, type WlmscpfsEventMap as aZ, type WlmscpfsEventValue as a_, type QRAssociationAcknowledgedData as aa, type QRAssociationReceivedData as ab, type QRCFindRequestData as ac, type QRCGetRequestData as ad, type QRCMoveRequestData as ae, type QRCStoreRequestData as af, type QRCannotStartListenerData as ag, type QRListeningData as ah, type ReceiverAssociationAcknowledgedData as ai, type ReceiverAssociationData as aj, type ReceiverAssociationFinalizedData as ak, type ReceiverAssociationReceivedData as al, type ReceiverCStoreRequestData as am, type ReceiverCannotStartListenerData as an, type ReceiverConfigErrorData as ao, type ReceiverDatabaseReadyData as ap, type ReceiverEchoRequestData as aq, type ReceiverErrorData as ar, type ReceiverFileData as as, type ReceiverFileReceivedData as at, type ReceiverFileStoredData as au, type ReceiverInstanceData as av, type ReceiverInstanceErrorData as aw, type ReceiverListeningData as ax, type RefusingAssociationData as ay, STORESCP_FATAL_EVENTS as az, type AssociationContext as b, type AssociationReceivedData as c, type AssociationSummary as d, AssociationTracker as e, type CannotStartListenerData as f, type ConfigErrorData as g, DCMPRSCP_PATTERNS as h, DCMPSRCV_FATAL_EVENTS as i, DCMPSRCV_PATTERNS as j, DCMQRSCP_FATAL_EVENTS as k, DCMQRSCP_PATTERNS as l, DCMRECV_FATAL_EVENTS as m, DCMRECV_PATTERNS as n, type DatabaseReadyData as o, DcmQRSCP as p, type DcmQRSCPEventMap as q, type DcmQRSCPOptions as r, DcmprsCP as s, type DcmprsCPEventMap as t, type DcmprsCPOptions as u, DcmprscpEvent as v, type DcmprscpEventValue as w, Dcmpsrcv as x, DcmpsrcvEvent as y, type DcmpsrcvEventMap as z };

package/dist/{index-CVDMaxd8.d.cts → index-DV8HaHEX.d.cts}

@@ -1544,6 +1544,30 @@ interface PoolEchoRequestData {
 interface PoolRefusingAssociationData {
     readonly reason: string;
 }
+/** Data emitted with INSTANCE_ERROR events when DicomInstance.open fails. */
+interface ReceiverInstanceErrorData {
+    readonly error: Error;
+    /** Whether this was a thrown exception (true) or a Result error (false). */
+    readonly thrown: boolean;
+    readonly filePath: string;
+    readonly fileSize: number;
+    readonly associationId: string;
+    readonly associationDir: string;
+    readonly callingAE: string;
+    readonly calledAE: string;
+    readonly source: string;
+}
+/** Data emitted with ASSOCIATION_FINALIZED — all work (including parsing) is done. */
+interface ReceiverAssociationFinalizedData {
+    readonly associationId: string;
+    readonly associationDir: string;
+    readonly callingAE: string;
+    readonly calledAE: string;
+    readonly source: string;
+    readonly files: readonly string[];
+    readonly instancesReceived: number;
+    readonly instanceErrors: number;
+}
 /** Data emitted with error events. */
 interface ReceiverErrorData {
     readonly error: Error;
@@ -1559,7 +1583,9 @@ interface DicomReceiverEventMap {
     FILE_RECEIVED: [ReceiverFileReceivedData];
     FILE_STORED: [ReceiverFileStoredData];
     INSTANCE_RECEIVED: [ReceiverInstanceData];
+    INSTANCE_ERROR: [ReceiverInstanceErrorData];
     ASSOCIATION_COMPLETE: [ReceiverAssociationData];
+    ASSOCIATION_FINALIZED: [ReceiverAssociationFinalizedData];
     ASSOCIATION_RECEIVED: [PoolAssociationReceivedData];
     C_STORE_REQUEST: [PoolCStoreRequestData];
     ECHO_REQUEST: [PoolEchoRequestData];
@@ -1682,12 +1708,26 @@ declare class DicomReceiver extends EventEmitter<DicomReceiverEventMap> {
      */
     onInstanceReceived(listener: (data: ReceiverInstanceData) => void): this;
     /**
-     * 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: (data: ReceiverInstanceErrorData) => void): this;
+    /**
+     * Registers a listener for completed associations (file moves done).
      *
      * @param listener - Callback receiving association data
      * @returns this for chaining
      */
     onAssociationComplete(listener: (data: ReceiverAssociationData) => void): this;
+    /**
+     * 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: (data: ReceiverAssociationFinalizedData) => void): this;
     /**
      * Registers a listener for new associations (bubbled from workers).
      *
@@ -1759,14 +1799,16 @@ declare class DicomReceiver extends EventEmitter<DicomReceiverEventMap> {
     private handleFileReceived;
     /** Inner handler: move file, emit FILE_STORED, parse DICOM, emit INSTANCE_RECEIVED. */
     private moveAndEmitFile;
-    /** Parses a DICOM file and emits INSTANCE_RECEIVED or error. */
-    private emitInstanceReceived;
+    /** Parses a DICOM file and emits INSTANCE_RECEIVED or INSTANCE_ERROR. */
+    private parseAndEmitInstance;
     /** Returns worker to idle pool on association complete, emits summary. */
     private wireAssociationComplete;
-    /** Awaits ALL pending file operations, emits ASSOCIATION_COMPLETE, resets worker state. */
+    /** Awaits file ops, emits ASSOCIATION_COMPLETE, awaits parsing, emits ASSOCIATION_FINALIZED. */
     private finalizeAssociation;
     /** Emits the ASSOCIATION_COMPLETE event with transfer stats. */
     private emitAssociationComplete;
+    /** Emits ASSOCIATION_FINALIZED after all instance parsing is done. */
+    private emitAssociationFinalized;
     /** Bubbles ASSOCIATION_RECEIVED from dcmrecv worker. */
     private wireAssociationReceived;
     /** Bubbles C_STORE_REQUEST from dcmrecv worker. */
@@ -1783,4 +1825,4 @@ declare class DicomReceiver extends EventEmitter<DicomReceiverEventMap> {
 /** @deprecated Use ReceiverFileStoredData instead. */
 type ReceiverFileData = ReceiverFileStoredData;
 
-export { type PoolCStoreRequestData as $, type AssociationAcknowledgedData as A, type DcmpsrcvEventValue as B, type CStoreRequestData as C, DCMPRSCP_FATAL_EVENTS as D, type DcmpsrcvOptions as E, DcmqrscpEvent as F, type DcmqrscpEventValue as G, Dcmrecv as H, DcmrecvEvent as I, type DcmrecvEventMap as J, type DcmrecvEventValue as K, type DcmrecvOptions as L, DcmtkProcess as M, type DcmtkProcessConfig as N, type DcmtkProcessEventMap as O, DicomReceiver as P, type DicomReceiverEventMap as Q, type DicomReceiverOptions as R, type EventPattern as S, type FileDeletedData as T, type FileReceivedData as U, FilenameMode as V, type FilenameModeValue as W, LineParser as X, type LineParserEventMap as Y, type MultiLineConfig as Z, type PoolAssociationReceivedData as _, type AssociationCompleteData as a, type PoolEchoRequestData as a0, type PoolRefusingAssociationData as a1, type PoolStatus as a2, PreferredTransferSyntax as a3, type PreferredTransferSyntaxValue as a4, type PrintAssociationAcknowledgedData as a5, type PrintAssociationReceivedData as a6, type PrintCannotStartListenerData as a7, ProcessState as a8, type ProcessStateValue as a9, type StorageModeValue as aA, StoreSCP as aB, type StoreSCPEventMap as aC, type StoreSCPOptions as aD, StoreSCPPreset as aE, type StoreSCPPresetName as aF, type StoredFileData as aG, StorescpEvent as aH, type StorescpEventValue as aI, type StoringFileData as aJ, type SubdirectoryCreatedData as aK, SubdirectoryMode as aL, type SubdirectoryModeValue as aM, type TrackedFile as aN, WLMSCPFS_FATAL_EVENTS as aO, WLMSCPFS_PATTERNS as aP, type WlmAssociationAcknowledgedData as aQ, type WlmAssociationReceivedData as aR, type WlmCFindRequestData as aS, type WlmCannotStartListenerData as aT, type WlmListeningData as aU, Wlmscpfs as aV, WlmscpfsEvent as aW, type WlmscpfsEventMap as aX, type WlmscpfsEventValue as aY, type WlmscpfsOptions as aZ, type QRAssociationAcknowledgedData as aa, type QRAssociationReceivedData as ab, type QRCFindRequestData as ac, type QRCGetRequestData as ad, type QRCMoveRequestData as ae, type QRCStoreRequestData as af, type QRCannotStartListenerData as ag, type QRListeningData as ah, type ReceiverAssociationAcknowledgedData as ai, type ReceiverAssociationData as aj, type ReceiverAssociationReceivedData as ak, type ReceiverCStoreRequestData as al, type ReceiverCannotStartListenerData as am, type ReceiverConfigErrorData as an, type ReceiverDatabaseReadyData as ao, type ReceiverEchoRequestData as ap, type ReceiverErrorData as aq, type ReceiverFileData as ar, type ReceiverFileReceivedData as as, type ReceiverFileStoredData as at, type ReceiverInstanceData as au, type ReceiverListeningData as av, type RefusingAssociationData as aw, STORESCP_FATAL_EVENTS as ax, STORESCP_PATTERNS as ay, StorageMode as az, type AssociationContext as b, type AssociationReceivedData as c, type AssociationSummary as d, AssociationTracker as e, type CannotStartListenerData as f, type ConfigErrorData as g, DCMPRSCP_PATTERNS as h, DCMPSRCV_FATAL_EVENTS as i, DCMPSRCV_PATTERNS as j, DCMQRSCP_FATAL_EVENTS as k, DCMQRSCP_PATTERNS as l, DCMRECV_FATAL_EVENTS as m, DCMRECV_PATTERNS as n, type DatabaseReadyData as o, DcmQRSCP as p, type DcmQRSCPEventMap as q, type DcmQRSCPOptions as r, DcmprsCP as s, type DcmprsCPEventMap as t, type DcmprsCPOptions as u, DcmprscpEvent as v, type DcmprscpEventValue as w, Dcmpsrcv as x, DcmpsrcvEvent as y, type DcmpsrcvEventMap as z };
+export { type PoolCStoreRequestData as $, type AssociationAcknowledgedData as A, type DcmpsrcvEventValue as B, type CStoreRequestData as C, DCMPRSCP_FATAL_EVENTS as D, type DcmpsrcvOptions as E, DcmqrscpEvent as F, type DcmqrscpEventValue as G, Dcmrecv as H, DcmrecvEvent as I, type DcmrecvEventMap as J, type DcmrecvEventValue as K, type DcmrecvOptions as L, DcmtkProcess as M, type DcmtkProcessConfig as N, type DcmtkProcessEventMap as O, DicomReceiver as P, type DicomReceiverEventMap as Q, type DicomReceiverOptions as R, type EventPattern as S, type FileDeletedData as T, type FileReceivedData as U, FilenameMode as V, type FilenameModeValue as W, LineParser as X, type LineParserEventMap as Y, type MultiLineConfig as Z, type PoolAssociationReceivedData as _, type AssociationCompleteData as a, type WlmscpfsOptions as a$, type PoolEchoRequestData as a0, type PoolRefusingAssociationData as a1, type PoolStatus as a2, PreferredTransferSyntax as a3, type PreferredTransferSyntaxValue as a4, type PrintAssociationAcknowledgedData as a5, type PrintAssociationReceivedData as a6, type PrintCannotStartListenerData as a7, ProcessState as a8, type ProcessStateValue as a9, STORESCP_PATTERNS as aA, StorageMode as aB, type StorageModeValue as aC, StoreSCP as aD, type StoreSCPEventMap as aE, type StoreSCPOptions as aF, StoreSCPPreset as aG, type StoreSCPPresetName as aH, type StoredFileData as aI, StorescpEvent as aJ, type StorescpEventValue as aK, type StoringFileData as aL, type SubdirectoryCreatedData as aM, SubdirectoryMode as aN, type SubdirectoryModeValue as aO, type TrackedFile as aP, WLMSCPFS_FATAL_EVENTS as aQ, WLMSCPFS_PATTERNS as aR, type WlmAssociationAcknowledgedData as aS, type WlmAssociationReceivedData as aT, type WlmCFindRequestData as aU, type WlmCannotStartListenerData as aV, type WlmListeningData as aW, Wlmscpfs as aX, WlmscpfsEvent as aY, type WlmscpfsEventMap as aZ, type WlmscpfsEventValue as a_, type QRAssociationAcknowledgedData as aa, type QRAssociationReceivedData as ab, type QRCFindRequestData as ac, type QRCGetRequestData as ad, type QRCMoveRequestData as ae, type QRCStoreRequestData as af, type QRCannotStartListenerData as ag, type QRListeningData as ah, type ReceiverAssociationAcknowledgedData as ai, type ReceiverAssociationData as aj, type ReceiverAssociationFinalizedData as ak, type ReceiverAssociationReceivedData as al, type ReceiverCStoreRequestData as am, type ReceiverCannotStartListenerData as an, type ReceiverConfigErrorData as ao, type ReceiverDatabaseReadyData as ap, type ReceiverEchoRequestData as aq, type ReceiverErrorData as ar, type ReceiverFileData as as, type ReceiverFileReceivedData as at, type ReceiverFileStoredData as au, type ReceiverInstanceData as av, type ReceiverInstanceErrorData as aw, type ReceiverListeningData as ax, type RefusingAssociationData as ay, STORESCP_FATAL_EVENTS as az, type AssociationContext as b, type AssociationReceivedData as c, type AssociationSummary as d, AssociationTracker as e, type CannotStartListenerData as f, type ConfigErrorData as g, DCMPRSCP_PATTERNS as h, DCMPSRCV_FATAL_EVENTS as i, DCMPSRCV_PATTERNS as j, DCMQRSCP_FATAL_EVENTS as k, DCMQRSCP_PATTERNS as l, DCMRECV_FATAL_EVENTS as m, DCMRECV_PATTERNS as n, type DatabaseReadyData as o, DcmQRSCP as p, type DcmQRSCPEventMap as q, type DcmQRSCPOptions as r, DcmprsCP as s, type DcmprsCPEventMap as t, type DcmprsCPOptions as u, DcmprscpEvent as v, type DcmprscpEventValue as w, Dcmpsrcv as x, DcmpsrcvEvent as y, type DcmpsrcvEventMap as z };

package/dist/index.cjs

@@ -31402,7 +31402,12 @@ var parser = new fastXmlParser.XMLParser({
   ignoreAttributes: false,
   attributeNamePrefix: "@_",
   parseTagValue: false,
-  isArray: (name) => ARRAY_TAG_NAMES.has(name)
+  isArray: (name) => ARRAY_TAG_NAMES.has(name),
+  // DICOM XML does not use XML entities. Disable entity processing to avoid
+  // the default expansion limit (1000) which rejects files with >1000 tags.
+  // Without this, large studies fall through to dcm2json which hangs on
+  // compressed pixel data (DCMTK bug).
+  processEntities: false
 });
 function xmlToJson(xml) {
   try {
@@ -36484,6 +36489,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", []);
@@ -36521,6 +36529,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() {
@@ -36530,6 +36541,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;
   }
@@ -36540,6 +36554,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);
@@ -36711,7 +36754,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
@@ -36719,6 +36771,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).
    *
@@ -37048,28 +37109,33 @@ var DicomReceiver = class _DicomReceiver extends events.EventEmitter {
       calledAE: data.calledAE,
       source: data.source
     });
-    this.emitInstanceReceived(finalPath, fileSize, data, ctx);
-  }
-  /** Parses a DICOM file and emits INSTANCE_RECEIVED or error. */
-  emitInstanceReceived(filePath, fileSize, data, ctx) {
-    const errorCtx = {
-      filePath,
+    const instanceCtx = {
+      filePath: finalPath,
+      fileSize,
       associationId: ctx.associationId,
       associationDir: ctx.associationDir,
       callingAE: data.callingAE,
       calledAE: data.calledAE,
       source: data.source
     };
-    void DicomInstance.open(filePath).then((openResult) => {
+    worker.trackInstance(this.parseAndEmitInstance(worker, instanceCtx));
+  }
+  /** 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, ...errorCtx });
+        worker.recordInstanceError();
+        this.emit("INSTANCE_ERROR", { error: openResult.error, thrown: false, ...ctx });
         return;
       }
-      this.emit("INSTANCE_RECEIVED", { ...errorCtx, fileSize, instance: openResult.value });
-    }).catch((thrown) => {
+      worker.recordInstanceSuccess();
+      this.emit("INSTANCE_RECEIVED", { ...ctx, instance: openResult.value });
+    } catch (thrown) {
       const error = thrown instanceof Error ? thrown : new Error(String(thrown));
-      this.emit("error", { error, ...errorCtx });
-    });
+      worker.recordInstanceError();
+      this.emit("INSTANCE_ERROR", { error, thrown: true, ...ctx });
+    }
   }
   /** Returns worker to idle pool on association complete, emits summary. */
   wireAssociationComplete(worker) {
@@ -37077,10 +37143,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();
   }
@@ -37112,6 +37180,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) => {