@ubercode/dcmtk 0.8.1 → 0.9.0

package/dist/index.d.cts

@@ -4,7 +4,8 @@ import { A as AETitle, D as DicomTag, a as DicomTagPath, P as Port, S as SOPClas
 export { B as Brand, C as ChangeSet, c as DicomFilePath, d as DicomInstance, e as DicomOpenOptions, W as WalkTagEntry, f as WalkTagsOptions, g as createAETitle, h as createDicomFilePath, i as createDicomTag, j as createDicomTagPath, k as createPort, l as createSOPClassUID, m as createTransferSyntaxUID, t as tag, w as walkTags } from './DicomInstance-CxLKC-oM.cjs';
 import { z } from 'zod';
 export { A as AssociationAcknowledgedData, a as AssociationCompleteData, b as AssociationContext, c as AssociationReceivedData, d as AssociationSummary, e as AssociationTracker, C as CStoreRequestData, f as CannotStartListenerData, g as ConfigErrorData, D as DCMPRSCP_FATAL_EVENTS, h as DCMPRSCP_PATTERNS, i as DCMPSRCV_FATAL_EVENTS, j as DCMPSRCV_PATTERNS, k as DCMQRSCP_FATAL_EVENTS, l as DCMQRSCP_PATTERNS, m as DCMRECV_FATAL_EVENTS, n as DCMRECV_PATTERNS, o as DatabaseReadyData, p as DcmQRSCP, q as DcmQRSCPEventMap, r as DcmQRSCPOptions, s as DcmprsCP, t as DcmprsCPEventMap, u as DcmprsCPOptions, v as DcmprscpEvent, w as DcmprscpEventValue, x as Dcmpsrcv, y as DcmpsrcvEvent, z as DcmpsrcvEventMap, B as DcmpsrcvEventValue, E as DcmpsrcvOptions, F as DcmqrscpEvent, G as DcmqrscpEventValue, H as Dcmrecv, I as DcmrecvEvent, J as DcmrecvEventMap, K as DcmrecvEventValue, L as DcmrecvOptions, M as DcmtkProcess, N as DcmtkProcessConfig, O as DcmtkProcessEventMap, P as DicomReceiver, Q as DicomReceiverEventMap, R as DicomReceiverOptions, S as EventPattern, T as FileDeletedData, U as FileReceivedData, V as FilenameMode, W as FilenameModeValue, X as LineParser, Y as LineParserEventMap, Z as MultiLineConfig, _ as PoolAssociationReceivedData, $ as PoolCStoreRequestData, a0 as PoolEchoRequestData, a1 as PoolRefusingAssociationData, a2 as PoolStatus, a3 as PreferredTransferSyntax, a4 as PreferredTransferSyntaxValue, a5 as PrintAssociationAcknowledgedData, a6 as PrintAssociationReceivedData, a7 as PrintCannotStartListenerData, a8 as ProcessState, a9 as ProcessStateValue, aa as QRAssociationAcknowledgedData, ab as QRAssociationReceivedData, ac as QRCFindRequestData, ad as QRCGetRequestData, ae as QRCMoveRequestData, af as QRCStoreRequestData, ag as QRCannotStartListenerData, ah as QRListeningData, ai as ReceiverAssociationAcknowledgedData, aj as ReceiverAssociationData, ak as ReceiverAssociationReceivedData, al as ReceiverCStoreRequestData, am as ReceiverCannotStartListenerData, an as ReceiverConfigErrorData, ao as ReceiverDatabaseReadyData, ap as ReceiverEchoRequestData, aq as ReceiverErrorData, ar as ReceiverFileData, as as ReceiverListeningData, at as RefusingAssociationData, au as STORESCP_FATAL_EVENTS, av as STORESCP_PATTERNS, aw as StorageMode, ax as StorageModeValue, ay as StoreSCP, az as StoreSCPEventMap, aA as StoreSCPOptions, aB as StoreSCPPreset, aC as StoreSCPPresetName, aD as StoredFileData, aE as StorescpEvent, aF as StorescpEventValue, aG as StoringFileData, aH as SubdirectoryCreatedData, aI as SubdirectoryMode, aJ as SubdirectoryModeValue, aK as TrackedFile, aL as WLMSCPFS_FATAL_EVENTS, aM as WLMSCPFS_PATTERNS, aN as WlmAssociationAcknowledgedData, aO as WlmAssociationReceivedData, aP as WlmCFindRequestData, aQ as WlmCannotStartListenerData, aR as WlmListeningData, aS as Wlmscpfs, aT as WlmscpfsEvent, aU as WlmscpfsEventMap, aV as WlmscpfsEventValue, aW as WlmscpfsOptions } from './index-B13DmBRs.cjs';
-export { b as DcmodifyOptions, c as DcmodifyResult, D as DicomJsonElement, a as DicomJsonModel, T as TagModification, d as ToolBaseOptions, e as dcmodify, x as xmlToJson } from './dcmodify-Cf-RPHF3.cjs';
+import { T as TagModification } from './dcmodify-Cf-RPHF3.cjs';
+export { b as DcmodifyOptions, c as DcmodifyResult, D as DicomJsonElement, a as DicomJsonModel, d as ToolBaseOptions, e as dcmodify, x as xmlToJson } from './dcmodify-Cf-RPHF3.cjs';
 export { DictionaryEntry, SOPClassName, SOP_CLASSES, TagSegment, VR, VRCategoryName, VRMetadata, VRValue, VR_CATEGORY, VR_CATEGORY_NAME, VR_META, getVRCategory, isBinaryVR, isNumericVR, isStringVR, lookupTag, lookupTagByKeyword, lookupTagByName, segmentsToModifyPath, segmentsToString, sopClassNameFromUID, tagPathToSegments } from './dicom.cjs';
 import { ProposedTransferSyntaxValue } from './tools.cjs';
 export { Cda2dcmOptions, Cda2dcmResult, ColorConversion, ColorConversionValue, Dcm2cdaOptions, Dcm2cdaResult, Dcm2jsonOptions, Dcm2jsonResult, Dcm2jsonSource, Dcm2pdfOptions, Dcm2pdfResult, Dcm2pnmOptions, Dcm2pnmOutputFormat, Dcm2pnmOutputFormatValue, Dcm2pnmResult, Dcm2xmlCharset, Dcm2xmlCharsetValue, Dcm2xmlOptions, Dcm2xmlResult, DcmcjpegOptions, DcmcjpegResult, DcmcjplsOptions, DcmcjplsResult, DcmconvOptions, DcmconvResult, DcmcrleOptions, DcmcrleResult, DcmdecapOptions, DcmdecapResult, DcmdjpegOptions, DcmdjpegResult, DcmdjplsOptions, DcmdjplsResult, DcmdrleOptions, DcmdrleResult, DcmdspfnOptions, DcmdspfnResult, DcmdumpFormat, DcmdumpFormatValue, DcmdumpOptions, DcmdumpResult, DcmencapOptions, DcmencapResult, DcmftestOptions, DcmftestResult, DcmgpdirOptions, DcmgpdirResult, Dcmj2pnmOptions, Dcmj2pnmOutputFormat, Dcmj2pnmOutputFormatValue, Dcmj2pnmResult, DcmmkcrvOptions, DcmmkcrvResult, DcmmkdirOptions, DcmmkdirResult, DcmmklutOptions, DcmmklutResult, Dcmp2pgmOptions, Dcmp2pgmResult, DcmprscuOptions, DcmprscuResult, DcmpschkOptions, DcmpschkResult, DcmpsmkOptions, DcmpsmkResult, DcmpsprtOptions, DcmpsprtResult, DcmqridxOptions, DcmqridxResult, DcmquantOptions, DcmquantResult, DcmscaleOptions, DcmscaleResult, DcmsendOptions, DcmsendResult, Dcod2lumOptions, Dcod2lumResult, DconvlumOptions, DconvlumResult, DrtdumpOptions, DrtdumpResult, Dsr2xmlOptions, Dsr2xmlResult, DsrdumpOptions, DsrdumpResult, Dump2dcmOptions, Dump2dcmResult, EchoscuOptions, EchoscuResult, FindscuOptions, FindscuResult, GetQueryModel, GetQueryModelValue, GetscuOptions, GetscuResult, Img2dcmInputFormat, Img2dcmInputFormatValue, Img2dcmOptions, Img2dcmResult, JplsColorConversion, JplsColorConversionValue, Json2dcmOptions, Json2dcmResult, LutType, LutTypeValue, MoveQueryModel, MoveQueryModelValue, MovescuOptions, MovescuResult, Pdf2dcmOptions, Pdf2dcmResult, ProposedTransferSyntax, QueryModel, QueryModelValue, Stl2dcmOptions, Stl2dcmResult, StorescuOptions, StorescuResult, TermscuOptions, TermscuResult, TransferSyntax, TransferSyntaxValue, Xml2dcmOptions, Xml2dcmResult, Xml2dsrOptions, Xml2dsrResult, cda2dcm, dcm2cda, dcm2json, dcm2pdf, dcm2pnm, dcm2xml, dcmcjpeg, dcmcjpls, dcmconv, dcmcrle, dcmdecap, dcmdjpeg, dcmdjpls, dcmdrle, dcmdspfn, dcmdump, dcmencap, dcmftest, dcmgpdir, dcmj2pnm, dcmmkcrv, dcmmkdir, dcmmklut, dcmp2pgm, dcmprscu, dcmpschk, dcmpsmk, dcmpsprt, dcmqridx, dcmquant, dcmscale, dcmsend, dcod2lum, dconvlum, drtdump, dsr2xml, dsrdump, dump2dcm, echoscu, findscu, getscu, img2dcm, json2dcm, movescu, pdf2dcm, stl2dcm, storescu, termscu, xml2dcm, xml2dsr } from './tools.cjs';
@@ -1014,4 +1015,230 @@ declare class PacsClient {
     private executeCMove;
 }
 
-export { AETitle, AETitleSchema, DEFAULT_BLOCK_TIMEOUT_MS, DEFAULT_DICOM_PORT, DEFAULT_DRAIN_TIMEOUT_MS, DEFAULT_PARSE_CONCURRENCY, DEFAULT_START_TIMEOUT_MS, DEFAULT_TIMEOUT_MS, type DcmsendSendOptions, DcmtkProcessResult, DicomDataset, DicomSend, type DicomSendEventMap, type DicomSendOptions, DicomSender, type DicomSenderEventMap, type DicomSenderOptions, DicomTag, DicomTagPath, DicomTagPathSchema, DicomTagSchema, ExecOptions, type FindDcmtkPathOptions, type ImageFilter, MAX_BLOCK_LINES, MAX_CHANGESET_OPERATIONS, MAX_EVENT_PATTERNS, MAX_TRAVERSAL_DEPTH, PDU_SIZE, PacsClient, type PacsClientConfig, type PacsEchoOptions, type PacsEchoResult, type PacsMethodOptions, type PacsQueryOptions, type PacsQueryResult, type PacsRetrieveOptions, type PacsRetrieveResult, type PacsStoreOptions, type PacsStoreResult, Port, PortSchema, ProposedTransferSyntaxValue, QueryLevel, type QueryLevelValue, REQUIRED_BINARIES, Result, RetrieveMode, type RetrieveModeValue, SOPClassUID, type SendOptions, type SendResult, type SenderBucketFlushedData, type SenderErrorData, SenderHealth, type SenderHealthChangedData, type SenderHealthValue, SenderMode, type SenderModeValue, type SenderSendCompleteData, type SenderSendFailedData, type SenderStatus, type SeriesFilter, SpawnOptions, type StudyFilter, TransferSyntaxUID, UIDSchema, UNIX_SEARCH_PATHS, WINDOWS_SEARCH_PATHS, type WorklistFilter, clearDcmtkPathCache, execCommand, findDcmtkPath, parseAETitle, parseDicomTag, parseDicomTagPath, parsePort, parseSOPClassUID, parseTransferSyntaxUID, spawnCommand };
+/**
+ * Types for the DicomHammer load testing tool.
+ *
+ * @module testing/types
+ */
+
+/** Phases of a DicomHammer run. */
+declare const HammerPhase: {
+    /** File generation phase (copy + modify). */
+    readonly GENERATE: "generate";
+    /** File sending phase (dcmsend). */
+    readonly SEND: "send";
+};
+type HammerPhaseValue = (typeof HammerPhase)[keyof typeof HammerPhase];
+/** Options for {@link DicomHammer.create}. */
+interface DicomHammerOptions {
+    /** Path to the template DICOM file to copy and modify. */
+    readonly sourceFile: string;
+    /** Target SCP hostname or IP. */
+    readonly host: string;
+    /** Target SCP port (1-65535). */
+    readonly port: number;
+    /** Calling AE title. Defaults to `'HAMMER'`. */
+    readonly callingAETitle?: string | undefined;
+    /** Called AE title. Defaults to `'ANY-SCP'`. */
+    readonly calledAETitle?: string | undefined;
+    /** Number of DICOM file copies to generate. Range 1-100000. Defaults to 100. */
+    readonly fileCount?: number | undefined;
+    /** Max parallel operations for both generate and send phases. Range 1-64. Defaults to 4. */
+    readonly concurrency?: number | undefined;
+    /** Delay in milliseconds between each send. 0 means flood. Defaults to 0. */
+    readonly delayMs?: number | undefined;
+    /** Institution Name tag value to stamp on each copy. */
+    readonly institution?: string | undefined;
+    /** Erase all private tags from generated copies. Defaults to false. */
+    readonly erasePrivateTags?: boolean | undefined;
+    /** Additional tag modifications to apply to each copy. */
+    readonly modifications?: readonly TagModification[] | undefined;
+    /** Per-send timeout in milliseconds. */
+    readonly timeoutMs?: number | undefined;
+    /** AbortSignal for cancellation. */
+    readonly signal?: AbortSignal | undefined;
+    /** Directory for generated files. Defaults to `os.tmpdir()`. */
+    readonly outputDir?: string | undefined;
+    /** Pass `--no-halt` to dcmsend (continue on errors). Defaults to true. */
+    readonly noHalt?: boolean | undefined;
+}
+/** Result of the file generation phase. */
+interface GenerateResult {
+    /** Paths to all generated DICOM files. */
+    readonly files: readonly string[];
+    /** Duration of file generation in milliseconds. */
+    readonly durationMs: number;
+    /** Directory containing generated files. */
+    readonly outputDir: string;
+}
+/** A single send failure. */
+interface HammerError {
+    /** Path to the file that failed to send. */
+    readonly file: string;
+    /** The error that occurred. */
+    readonly error: Error;
+}
+/** Result of the send phase. */
+interface HammerSendResult {
+    /** Number of successfully sent files. */
+    readonly succeeded: number;
+    /** Number of failed sends. */
+    readonly failed: number;
+    /** Total files attempted. */
+    readonly totalFiles: number;
+    /** Duration of send phase in milliseconds. */
+    readonly durationMs: number;
+    /** Throughput in files per second. */
+    readonly filesPerSec: number;
+    /** Throughput in bytes per second. */
+    readonly bytesPerSec: number;
+    /** Total bytes sent (succeeded files only). */
+    readonly totalBytes: number;
+    /** Details of each failed send. */
+    readonly errors: readonly HammerError[];
+}
+/** Combined result of generate + send phases. */
+interface HammerResult {
+    /** Number of successfully sent files. */
+    readonly succeeded: number;
+    /** Number of failed sends. */
+    readonly failed: number;
+    /** Total files attempted. */
+    readonly totalFiles: number;
+    /** Total duration (generate + send) in milliseconds. */
+    readonly durationMs: number;
+    /** Duration of the generate phase in milliseconds. */
+    readonly generateDurationMs: number;
+    /** Duration of the send phase in milliseconds. */
+    readonly sendDurationMs: number;
+    /** Throughput in files per second (send phase only). */
+    readonly filesPerSec: number;
+    /** Throughput in bytes per second (send phase only). */
+    readonly bytesPerSec: number;
+    /** Total bytes sent (succeeded files only). */
+    readonly totalBytes: number;
+    /** Details of each failed send. */
+    readonly errors: readonly HammerError[];
+}
+/** Event map for DicomHammer typed events. */
+interface DicomHammerEventMap {
+    FILE_GENERATED: [{
+        readonly index: number;
+        readonly total: number;
+        readonly filePath: string;
+    }];
+    SEND_COMPLETE: [{
+        readonly index: number;
+        readonly total: number;
+        readonly file: string;
+        readonly durationMs: number;
+    }];
+    SEND_FAILED: [{
+        readonly index: number;
+        readonly total: number;
+        readonly file: string;
+        readonly error: Error;
+    }];
+    PROGRESS: [{
+        readonly phase: HammerPhaseValue;
+        readonly completed: number;
+        readonly total: number;
+        readonly percent: number;
+    }];
+    RUN_COMPLETE: [HammerResult];
+    error: [{
+        readonly error: Error;
+    }];
+}
+
+/**
+ * DICOM load testing tool.
+ *
+ * Generates N copies of a template DICOM file with unique UIDs, sends them
+ * to a target SCP with configurable concurrency, and reports throughput.
+ *
+ * @module testing/DicomHammer
+ */
+
+/**
+ * DICOM load testing tool.
+ *
+ * Generates modified copies of a template DICOM file and sends them to a
+ * target SCP to stress test its capacity.
+ *
+ * @example
+ * ```ts
+ * const result = DicomHammer.create({
+ *     sourceFile: '/path/to/template.dcm',
+ *     host: '127.0.0.1',
+ *     port: 8104,
+ *     fileCount: 1000,
+ *     concurrency: 8,
+ * });
+ * if (!result.ok) { console.error(result.error.message); return; }
+ * const hammer = result.value;
+ *
+ * hammer.onProgress(data => console.log(`${data.phase}: ${data.completed}/${data.total}`));
+ * const runResult = await hammer.run();
+ * if (runResult.ok) console.log(`${runResult.value.filesPerSec} files/sec`);
+ * await hammer.cleanup();
+ * ```
+ */
+declare class DicomHammer extends EventEmitter<DicomHammerEventMap> {
+    private readonly opts;
+    private generatedDir;
+    private generatedFiles;
+    private constructor();
+    /**
+     * Creates a DicomHammer instance.
+     *
+     * @param options - Configuration for file generation and sending
+     * @returns A Result containing the DicomHammer or a validation error
+     */
+    static create(options: DicomHammerOptions): Result<DicomHammer>;
+    /**
+     * Generates modified copies of the source DICOM file.
+     *
+     * Each copy receives unique Study/Series/SOP Instance UIDs, a unique
+     * accession number, and any custom modifications.
+     */
+    generate(): Promise<Result<GenerateResult>>;
+    /** Generates a single modified copy. Extracted for function size compliance. */
+    private generateOneFile;
+    /**
+     * Sends files to the target SCP.
+     *
+     * @param files - Files to send. Defaults to previously generated files.
+     */
+    send(files?: readonly string[]): Promise<Result<HammerSendResult>>;
+    /** Tracks a single send result for progress reporting. */
+    private trackSendProgress;
+    /** Assembles the final HammerSendResult. */
+    private buildSendResult;
+    /** Sends a single file, with optional delay. */
+    private sendOneFile;
+    /** Gets the file size in bytes, returning 0 on error. */
+    private getFileSize;
+    /**
+     * Generates files and sends them in one call.
+     *
+     * @returns Combined result with timing for both phases
+     */
+    run(): Promise<Result<HammerResult>>;
+    /** Removes all generated files and the output directory. */
+    cleanup(): Promise<Result<void>>;
+    /** Emits a PROGRESS event. */
+    private emitProgress;
+    /** Registers a listener for FILE_GENERATED events. */
+    onFileGenerated(listener: (data: DicomHammerEventMap['FILE_GENERATED'][0]) => void): this;
+    /** Registers a listener for SEND_COMPLETE events. */
+    onSendComplete(listener: (data: DicomHammerEventMap['SEND_COMPLETE'][0]) => void): this;
+    /** Registers a listener for SEND_FAILED events. */
+    onSendFailed(listener: (data: DicomHammerEventMap['SEND_FAILED'][0]) => void): this;
+    /** Registers a listener for PROGRESS events. */
+    onProgress(listener: (data: DicomHammerEventMap['PROGRESS'][0]) => void): this;
+    /** Registers a listener for RUN_COMPLETE events. */
+    onRunComplete(listener: (data: DicomHammerEventMap['RUN_COMPLETE'][0]) => void): this;
+}
+
+export { AETitle, AETitleSchema, DEFAULT_BLOCK_TIMEOUT_MS, DEFAULT_DICOM_PORT, DEFAULT_DRAIN_TIMEOUT_MS, DEFAULT_PARSE_CONCURRENCY, DEFAULT_START_TIMEOUT_MS, DEFAULT_TIMEOUT_MS, type DcmsendSendOptions, DcmtkProcessResult, DicomDataset, DicomHammer, type DicomHammerEventMap, type DicomHammerOptions, DicomSend, type DicomSendEventMap, type DicomSendOptions, DicomSender, type DicomSenderEventMap, type DicomSenderOptions, DicomTag, DicomTagPath, DicomTagPathSchema, DicomTagSchema, ExecOptions, type FindDcmtkPathOptions, type GenerateResult, type HammerError, HammerPhase, type HammerPhaseValue, type HammerResult, type HammerSendResult, type ImageFilter, MAX_BLOCK_LINES, MAX_CHANGESET_OPERATIONS, MAX_EVENT_PATTERNS, MAX_TRAVERSAL_DEPTH, PDU_SIZE, PacsClient, type PacsClientConfig, type PacsEchoOptions, type PacsEchoResult, type PacsMethodOptions, type PacsQueryOptions, type PacsQueryResult, type PacsRetrieveOptions, type PacsRetrieveResult, type PacsStoreOptions, type PacsStoreResult, Port, PortSchema, ProposedTransferSyntaxValue, QueryLevel, type QueryLevelValue, REQUIRED_BINARIES, Result, RetrieveMode, type RetrieveModeValue, SOPClassUID, type SendOptions, type SendResult, type SenderBucketFlushedData, type SenderErrorData, SenderHealth, type SenderHealthChangedData, type SenderHealthValue, SenderMode, type SenderModeValue, type SenderSendCompleteData, type SenderSendFailedData, type SenderStatus, type SeriesFilter, SpawnOptions, type StudyFilter, TagModification, TransferSyntaxUID, UIDSchema, UNIX_SEARCH_PATHS, WINDOWS_SEARCH_PATHS, type WorklistFilter, clearDcmtkPathCache, execCommand, findDcmtkPath, parseAETitle, parseDicomTag, parseDicomTagPath, parsePort, parseSOPClassUID, parseTransferSyntaxUID, spawnCommand };

package/dist/index.d.ts

@@ -4,7 +4,8 @@ import { A as AETitle, D as DicomTag, a as DicomTagPath, P as Port, S as SOPClas
 export { B as Brand, C as ChangeSet, c as DicomFilePath, d as DicomInstance, e as DicomOpenOptions, W as WalkTagEntry, f as WalkTagsOptions, g as createAETitle, h as createDicomFilePath, i as createDicomTag, j as createDicomTagPath, k as createPort, l as createSOPClassUID, m as createTransferSyntaxUID, t as tag, w as walkTags } from './DicomInstance-BKUiir0G.js';
 import { z } from 'zod';
 export { A as AssociationAcknowledgedData, a as AssociationCompleteData, b as AssociationContext, c as AssociationReceivedData, d as AssociationSummary, e as AssociationTracker, C as CStoreRequestData, f as CannotStartListenerData, g as ConfigErrorData, D as DCMPRSCP_FATAL_EVENTS, h as DCMPRSCP_PATTERNS, i as DCMPSRCV_FATAL_EVENTS, j as DCMPSRCV_PATTERNS, k as DCMQRSCP_FATAL_EVENTS, l as DCMQRSCP_PATTERNS, m as DCMRECV_FATAL_EVENTS, n as DCMRECV_PATTERNS, o as DatabaseReadyData, p as DcmQRSCP, q as DcmQRSCPEventMap, r as DcmQRSCPOptions, s as DcmprsCP, t as DcmprsCPEventMap, u as DcmprsCPOptions, v as DcmprscpEvent, w as DcmprscpEventValue, x as Dcmpsrcv, y as DcmpsrcvEvent, z as DcmpsrcvEventMap, B as DcmpsrcvEventValue, E as DcmpsrcvOptions, F as DcmqrscpEvent, G as DcmqrscpEventValue, H as Dcmrecv, I as DcmrecvEvent, J as DcmrecvEventMap, K as DcmrecvEventValue, L as DcmrecvOptions, M as DcmtkProcess, N as DcmtkProcessConfig, O as DcmtkProcessEventMap, P as DicomReceiver, Q as DicomReceiverEventMap, R as DicomReceiverOptions, S as EventPattern, T as FileDeletedData, U as FileReceivedData, V as FilenameMode, W as FilenameModeValue, X as LineParser, Y as LineParserEventMap, Z as MultiLineConfig, _ as PoolAssociationReceivedData, $ as PoolCStoreRequestData, a0 as PoolEchoRequestData, a1 as PoolRefusingAssociationData, a2 as PoolStatus, a3 as PreferredTransferSyntax, a4 as PreferredTransferSyntaxValue, a5 as PrintAssociationAcknowledgedData, a6 as PrintAssociationReceivedData, a7 as PrintCannotStartListenerData, a8 as ProcessState, a9 as ProcessStateValue, aa as QRAssociationAcknowledgedData, ab as QRAssociationReceivedData, ac as QRCFindRequestData, ad as QRCGetRequestData, ae as QRCMoveRequestData, af as QRCStoreRequestData, ag as QRCannotStartListenerData, ah as QRListeningData, ai as ReceiverAssociationAcknowledgedData, aj as ReceiverAssociationData, ak as ReceiverAssociationReceivedData, al as ReceiverCStoreRequestData, am as ReceiverCannotStartListenerData, an as ReceiverConfigErrorData, ao as ReceiverDatabaseReadyData, ap as ReceiverEchoRequestData, aq as ReceiverErrorData, ar as ReceiverFileData, as as ReceiverListeningData, at as RefusingAssociationData, au as STORESCP_FATAL_EVENTS, av as STORESCP_PATTERNS, aw as StorageMode, ax as StorageModeValue, ay as StoreSCP, az as StoreSCPEventMap, aA as StoreSCPOptions, aB as StoreSCPPreset, aC as StoreSCPPresetName, aD as StoredFileData, aE as StorescpEvent, aF as StorescpEventValue, aG as StoringFileData, aH as SubdirectoryCreatedData, aI as SubdirectoryMode, aJ as SubdirectoryModeValue, aK as TrackedFile, aL as WLMSCPFS_FATAL_EVENTS, aM as WLMSCPFS_PATTERNS, aN as WlmAssociationAcknowledgedData, aO as WlmAssociationReceivedData, aP as WlmCFindRequestData, aQ as WlmCannotStartListenerData, aR as WlmListeningData, aS as Wlmscpfs, aT as WlmscpfsEvent, aU as WlmscpfsEventMap, aV as WlmscpfsEventValue, aW as WlmscpfsOptions } from './index-CCgNgve7.js';
-export { b as DcmodifyOptions, c as DcmodifyResult, D as DicomJsonElement, a as DicomJsonModel, T as TagModification, d as ToolBaseOptions, e as dcmodify, x as xmlToJson } from './dcmodify-CHvwChFu.js';
+import { T as TagModification } from './dcmodify-CHvwChFu.js';
+export { b as DcmodifyOptions, c as DcmodifyResult, D as DicomJsonElement, a as DicomJsonModel, d as ToolBaseOptions, e as dcmodify, x as xmlToJson } from './dcmodify-CHvwChFu.js';
 export { DictionaryEntry, SOPClassName, SOP_CLASSES, TagSegment, VR, VRCategoryName, VRMetadata, VRValue, VR_CATEGORY, VR_CATEGORY_NAME, VR_META, getVRCategory, isBinaryVR, isNumericVR, isStringVR, lookupTag, lookupTagByKeyword, lookupTagByName, segmentsToModifyPath, segmentsToString, sopClassNameFromUID, tagPathToSegments } from './dicom.js';
 import { ProposedTransferSyntaxValue } from './tools.js';
 export { Cda2dcmOptions, Cda2dcmResult, ColorConversion, ColorConversionValue, Dcm2cdaOptions, Dcm2cdaResult, Dcm2jsonOptions, Dcm2jsonResult, Dcm2jsonSource, Dcm2pdfOptions, Dcm2pdfResult, Dcm2pnmOptions, Dcm2pnmOutputFormat, Dcm2pnmOutputFormatValue, Dcm2pnmResult, Dcm2xmlCharset, Dcm2xmlCharsetValue, Dcm2xmlOptions, Dcm2xmlResult, DcmcjpegOptions, DcmcjpegResult, DcmcjplsOptions, DcmcjplsResult, DcmconvOptions, DcmconvResult, DcmcrleOptions, DcmcrleResult, DcmdecapOptions, DcmdecapResult, DcmdjpegOptions, DcmdjpegResult, DcmdjplsOptions, DcmdjplsResult, DcmdrleOptions, DcmdrleResult, DcmdspfnOptions, DcmdspfnResult, DcmdumpFormat, DcmdumpFormatValue, DcmdumpOptions, DcmdumpResult, DcmencapOptions, DcmencapResult, DcmftestOptions, DcmftestResult, DcmgpdirOptions, DcmgpdirResult, Dcmj2pnmOptions, Dcmj2pnmOutputFormat, Dcmj2pnmOutputFormatValue, Dcmj2pnmResult, DcmmkcrvOptions, DcmmkcrvResult, DcmmkdirOptions, DcmmkdirResult, DcmmklutOptions, DcmmklutResult, Dcmp2pgmOptions, Dcmp2pgmResult, DcmprscuOptions, DcmprscuResult, DcmpschkOptions, DcmpschkResult, DcmpsmkOptions, DcmpsmkResult, DcmpsprtOptions, DcmpsprtResult, DcmqridxOptions, DcmqridxResult, DcmquantOptions, DcmquantResult, DcmscaleOptions, DcmscaleResult, DcmsendOptions, DcmsendResult, Dcod2lumOptions, Dcod2lumResult, DconvlumOptions, DconvlumResult, DrtdumpOptions, DrtdumpResult, Dsr2xmlOptions, Dsr2xmlResult, DsrdumpOptions, DsrdumpResult, Dump2dcmOptions, Dump2dcmResult, EchoscuOptions, EchoscuResult, FindscuOptions, FindscuResult, GetQueryModel, GetQueryModelValue, GetscuOptions, GetscuResult, Img2dcmInputFormat, Img2dcmInputFormatValue, Img2dcmOptions, Img2dcmResult, JplsColorConversion, JplsColorConversionValue, Json2dcmOptions, Json2dcmResult, LutType, LutTypeValue, MoveQueryModel, MoveQueryModelValue, MovescuOptions, MovescuResult, Pdf2dcmOptions, Pdf2dcmResult, ProposedTransferSyntax, QueryModel, QueryModelValue, Stl2dcmOptions, Stl2dcmResult, StorescuOptions, StorescuResult, TermscuOptions, TermscuResult, TransferSyntax, TransferSyntaxValue, Xml2dcmOptions, Xml2dcmResult, Xml2dsrOptions, Xml2dsrResult, cda2dcm, dcm2cda, dcm2json, dcm2pdf, dcm2pnm, dcm2xml, dcmcjpeg, dcmcjpls, dcmconv, dcmcrle, dcmdecap, dcmdjpeg, dcmdjpls, dcmdrle, dcmdspfn, dcmdump, dcmencap, dcmftest, dcmgpdir, dcmj2pnm, dcmmkcrv, dcmmkdir, dcmmklut, dcmp2pgm, dcmprscu, dcmpschk, dcmpsmk, dcmpsprt, dcmqridx, dcmquant, dcmscale, dcmsend, dcod2lum, dconvlum, drtdump, dsr2xml, dsrdump, dump2dcm, echoscu, findscu, getscu, img2dcm, json2dcm, movescu, pdf2dcm, stl2dcm, storescu, termscu, xml2dcm, xml2dsr } from './tools.js';
@@ -1014,4 +1015,230 @@ declare class PacsClient {
     private executeCMove;
 }
 
-export { AETitle, AETitleSchema, DEFAULT_BLOCK_TIMEOUT_MS, DEFAULT_DICOM_PORT, DEFAULT_DRAIN_TIMEOUT_MS, DEFAULT_PARSE_CONCURRENCY, DEFAULT_START_TIMEOUT_MS, DEFAULT_TIMEOUT_MS, type DcmsendSendOptions, DcmtkProcessResult, DicomDataset, DicomSend, type DicomSendEventMap, type DicomSendOptions, DicomSender, type DicomSenderEventMap, type DicomSenderOptions, DicomTag, DicomTagPath, DicomTagPathSchema, DicomTagSchema, ExecOptions, type FindDcmtkPathOptions, type ImageFilter, MAX_BLOCK_LINES, MAX_CHANGESET_OPERATIONS, MAX_EVENT_PATTERNS, MAX_TRAVERSAL_DEPTH, PDU_SIZE, PacsClient, type PacsClientConfig, type PacsEchoOptions, type PacsEchoResult, type PacsMethodOptions, type PacsQueryOptions, type PacsQueryResult, type PacsRetrieveOptions, type PacsRetrieveResult, type PacsStoreOptions, type PacsStoreResult, Port, PortSchema, ProposedTransferSyntaxValue, QueryLevel, type QueryLevelValue, REQUIRED_BINARIES, Result, RetrieveMode, type RetrieveModeValue, SOPClassUID, type SendOptions, type SendResult, type SenderBucketFlushedData, type SenderErrorData, SenderHealth, type SenderHealthChangedData, type SenderHealthValue, SenderMode, type SenderModeValue, type SenderSendCompleteData, type SenderSendFailedData, type SenderStatus, type SeriesFilter, SpawnOptions, type StudyFilter, TransferSyntaxUID, UIDSchema, UNIX_SEARCH_PATHS, WINDOWS_SEARCH_PATHS, type WorklistFilter, clearDcmtkPathCache, execCommand, findDcmtkPath, parseAETitle, parseDicomTag, parseDicomTagPath, parsePort, parseSOPClassUID, parseTransferSyntaxUID, spawnCommand };
+/**
+ * Types for the DicomHammer load testing tool.
+ *
+ * @module testing/types
+ */
+
+/** Phases of a DicomHammer run. */
+declare const HammerPhase: {
+    /** File generation phase (copy + modify). */
+    readonly GENERATE: "generate";
+    /** File sending phase (dcmsend). */
+    readonly SEND: "send";
+};
+type HammerPhaseValue = (typeof HammerPhase)[keyof typeof HammerPhase];
+/** Options for {@link DicomHammer.create}. */
+interface DicomHammerOptions {
+    /** Path to the template DICOM file to copy and modify. */
+    readonly sourceFile: string;
+    /** Target SCP hostname or IP. */
+    readonly host: string;
+    /** Target SCP port (1-65535). */
+    readonly port: number;
+    /** Calling AE title. Defaults to `'HAMMER'`. */
+    readonly callingAETitle?: string | undefined;
+    /** Called AE title. Defaults to `'ANY-SCP'`. */
+    readonly calledAETitle?: string | undefined;
+    /** Number of DICOM file copies to generate. Range 1-100000. Defaults to 100. */
+    readonly fileCount?: number | undefined;
+    /** Max parallel operations for both generate and send phases. Range 1-64. Defaults to 4. */
+    readonly concurrency?: number | undefined;
+    /** Delay in milliseconds between each send. 0 means flood. Defaults to 0. */
+    readonly delayMs?: number | undefined;
+    /** Institution Name tag value to stamp on each copy. */
+    readonly institution?: string | undefined;
+    /** Erase all private tags from generated copies. Defaults to false. */
+    readonly erasePrivateTags?: boolean | undefined;
+    /** Additional tag modifications to apply to each copy. */
+    readonly modifications?: readonly TagModification[] | undefined;
+    /** Per-send timeout in milliseconds. */
+    readonly timeoutMs?: number | undefined;
+    /** AbortSignal for cancellation. */
+    readonly signal?: AbortSignal | undefined;
+    /** Directory for generated files. Defaults to `os.tmpdir()`. */
+    readonly outputDir?: string | undefined;
+    /** Pass `--no-halt` to dcmsend (continue on errors). Defaults to true. */
+    readonly noHalt?: boolean | undefined;
+}
+/** Result of the file generation phase. */
+interface GenerateResult {
+    /** Paths to all generated DICOM files. */
+    readonly files: readonly string[];
+    /** Duration of file generation in milliseconds. */
+    readonly durationMs: number;
+    /** Directory containing generated files. */
+    readonly outputDir: string;
+}
+/** A single send failure. */
+interface HammerError {
+    /** Path to the file that failed to send. */
+    readonly file: string;
+    /** The error that occurred. */
+    readonly error: Error;
+}
+/** Result of the send phase. */
+interface HammerSendResult {
+    /** Number of successfully sent files. */
+    readonly succeeded: number;
+    /** Number of failed sends. */
+    readonly failed: number;
+    /** Total files attempted. */
+    readonly totalFiles: number;
+    /** Duration of send phase in milliseconds. */
+    readonly durationMs: number;
+    /** Throughput in files per second. */
+    readonly filesPerSec: number;
+    /** Throughput in bytes per second. */
+    readonly bytesPerSec: number;
+    /** Total bytes sent (succeeded files only). */
+    readonly totalBytes: number;
+    /** Details of each failed send. */
+    readonly errors: readonly HammerError[];
+}
+/** Combined result of generate + send phases. */
+interface HammerResult {
+    /** Number of successfully sent files. */
+    readonly succeeded: number;
+    /** Number of failed sends. */
+    readonly failed: number;
+    /** Total files attempted. */
+    readonly totalFiles: number;
+    /** Total duration (generate + send) in milliseconds. */
+    readonly durationMs: number;
+    /** Duration of the generate phase in milliseconds. */
+    readonly generateDurationMs: number;
+    /** Duration of the send phase in milliseconds. */
+    readonly sendDurationMs: number;
+    /** Throughput in files per second (send phase only). */
+    readonly filesPerSec: number;
+    /** Throughput in bytes per second (send phase only). */
+    readonly bytesPerSec: number;
+    /** Total bytes sent (succeeded files only). */
+    readonly totalBytes: number;
+    /** Details of each failed send. */
+    readonly errors: readonly HammerError[];
+}
+/** Event map for DicomHammer typed events. */
+interface DicomHammerEventMap {
+    FILE_GENERATED: [{
+        readonly index: number;
+        readonly total: number;
+        readonly filePath: string;
+    }];
+    SEND_COMPLETE: [{
+        readonly index: number;
+        readonly total: number;
+        readonly file: string;
+        readonly durationMs: number;
+    }];
+    SEND_FAILED: [{
+        readonly index: number;
+        readonly total: number;
+        readonly file: string;
+        readonly error: Error;
+    }];
+    PROGRESS: [{
+        readonly phase: HammerPhaseValue;
+        readonly completed: number;
+        readonly total: number;
+        readonly percent: number;
+    }];
+    RUN_COMPLETE: [HammerResult];
+    error: [{
+        readonly error: Error;
+    }];
+}
+
+/**
+ * DICOM load testing tool.
+ *
+ * Generates N copies of a template DICOM file with unique UIDs, sends them
+ * to a target SCP with configurable concurrency, and reports throughput.
+ *
+ * @module testing/DicomHammer
+ */
+
+/**
+ * DICOM load testing tool.
+ *
+ * Generates modified copies of a template DICOM file and sends them to a
+ * target SCP to stress test its capacity.
+ *
+ * @example
+ * ```ts
+ * const result = DicomHammer.create({
+ *     sourceFile: '/path/to/template.dcm',
+ *     host: '127.0.0.1',
+ *     port: 8104,
+ *     fileCount: 1000,
+ *     concurrency: 8,
+ * });
+ * if (!result.ok) { console.error(result.error.message); return; }
+ * const hammer = result.value;
+ *
+ * hammer.onProgress(data => console.log(`${data.phase}: ${data.completed}/${data.total}`));
+ * const runResult = await hammer.run();
+ * if (runResult.ok) console.log(`${runResult.value.filesPerSec} files/sec`);
+ * await hammer.cleanup();
+ * ```
+ */
+declare class DicomHammer extends EventEmitter<DicomHammerEventMap> {
+    private readonly opts;
+    private generatedDir;
+    private generatedFiles;
+    private constructor();
+    /**
+     * Creates a DicomHammer instance.
+     *
+     * @param options - Configuration for file generation and sending
+     * @returns A Result containing the DicomHammer or a validation error
+     */
+    static create(options: DicomHammerOptions): Result<DicomHammer>;
+    /**
+     * Generates modified copies of the source DICOM file.
+     *
+     * Each copy receives unique Study/Series/SOP Instance UIDs, a unique
+     * accession number, and any custom modifications.
+     */
+    generate(): Promise<Result<GenerateResult>>;
+    /** Generates a single modified copy. Extracted for function size compliance. */
+    private generateOneFile;
+    /**
+     * Sends files to the target SCP.
+     *
+     * @param files - Files to send. Defaults to previously generated files.
+     */
+    send(files?: readonly string[]): Promise<Result<HammerSendResult>>;
+    /** Tracks a single send result for progress reporting. */
+    private trackSendProgress;
+    /** Assembles the final HammerSendResult. */
+    private buildSendResult;
+    /** Sends a single file, with optional delay. */
+    private sendOneFile;
+    /** Gets the file size in bytes, returning 0 on error. */
+    private getFileSize;
+    /**
+     * Generates files and sends them in one call.
+     *
+     * @returns Combined result with timing for both phases
+     */
+    run(): Promise<Result<HammerResult>>;
+    /** Removes all generated files and the output directory. */
+    cleanup(): Promise<Result<void>>;
+    /** Emits a PROGRESS event. */
+    private emitProgress;
+    /** Registers a listener for FILE_GENERATED events. */
+    onFileGenerated(listener: (data: DicomHammerEventMap['FILE_GENERATED'][0]) => void): this;
+    /** Registers a listener for SEND_COMPLETE events. */
+    onSendComplete(listener: (data: DicomHammerEventMap['SEND_COMPLETE'][0]) => void): this;
+    /** Registers a listener for SEND_FAILED events. */
+    onSendFailed(listener: (data: DicomHammerEventMap['SEND_FAILED'][0]) => void): this;
+    /** Registers a listener for PROGRESS events. */
+    onProgress(listener: (data: DicomHammerEventMap['PROGRESS'][0]) => void): this;
+    /** Registers a listener for RUN_COMPLETE events. */
+    onRunComplete(listener: (data: DicomHammerEventMap['RUN_COMPLETE'][0]) => void): this;
+}
+
+export { AETitle, AETitleSchema, DEFAULT_BLOCK_TIMEOUT_MS, DEFAULT_DICOM_PORT, DEFAULT_DRAIN_TIMEOUT_MS, DEFAULT_PARSE_CONCURRENCY, DEFAULT_START_TIMEOUT_MS, DEFAULT_TIMEOUT_MS, type DcmsendSendOptions, DcmtkProcessResult, DicomDataset, DicomHammer, type DicomHammerEventMap, type DicomHammerOptions, DicomSend, type DicomSendEventMap, type DicomSendOptions, DicomSender, type DicomSenderEventMap, type DicomSenderOptions, DicomTag, DicomTagPath, DicomTagPathSchema, DicomTagSchema, ExecOptions, type FindDcmtkPathOptions, type GenerateResult, type HammerError, HammerPhase, type HammerPhaseValue, type HammerResult, type HammerSendResult, type ImageFilter, MAX_BLOCK_LINES, MAX_CHANGESET_OPERATIONS, MAX_EVENT_PATTERNS, MAX_TRAVERSAL_DEPTH, PDU_SIZE, PacsClient, type PacsClientConfig, type PacsEchoOptions, type PacsEchoResult, type PacsMethodOptions, type PacsQueryOptions, type PacsQueryResult, type PacsRetrieveOptions, type PacsRetrieveResult, type PacsStoreOptions, type PacsStoreResult, Port, PortSchema, ProposedTransferSyntaxValue, QueryLevel, type QueryLevelValue, REQUIRED_BINARIES, Result, RetrieveMode, type RetrieveModeValue, SOPClassUID, type SendOptions, type SendResult, type SenderBucketFlushedData, type SenderErrorData, SenderHealth, type SenderHealthChangedData, type SenderHealthValue, SenderMode, type SenderModeValue, type SenderSendCompleteData, type SenderSendFailedData, type SenderStatus, type SeriesFilter, SpawnOptions, type StudyFilter, TagModification, TransferSyntaxUID, UIDSchema, UNIX_SEARCH_PATHS, WINDOWS_SEARCH_PATHS, type WorklistFilter, clearDcmtkPathCache, execCommand, findDcmtkPath, parseAETitle, parseDicomTag, parseDicomTagPath, parsePort, parseSOPClassUID, parseTransferSyntaxUID, spawnCommand };