@ubercode/dcmtk 0.1.4 → 0.3.0

package/dist/index.d.ts

@@ -1,13 +1,15 @@
-import { R as Result, E as ExecOptions, D as DcmtkProcessResult, S as SpawnOptions } from './types-zHhxS7d2.js';
-export { L as LineSource, P as ProcessLine, a as ResultValue, b as assertUnreachable, e as err, m as mapResult, o as ok, u as unwrap } from './types-zHhxS7d2.js';
-import { A as AETitle, D as DicomTag, a as DicomTagPath, P as Port, S as SOPClassUID, T as TransferSyntaxUID, b as DicomDataset } from './index-BZxi4104.js';
-export { B as Brand, C as ChangeSet, c as DicomFile, d as DicomFileOptions, e as DicomFilePath, f as DictionaryEntry, g as SOPClassName, h as SOP_CLASSES, i as TagSegment, V as VR, j as VRCategoryName, k as VRMetadata, l as VRValue, m as VR_CATEGORY, n as VR_CATEGORY_NAME, o as VR_META, p as createAETitle, q as createDicomFilePath, r as createDicomTag, s as createDicomTagPath, t as createPort, u as createSOPClassUID, v as createTransferSyntaxUID, w as getVRCategory, x as isBinaryVR, y as isNumericVR, z as isStringVR, E as lookupTag, F as lookupTagByKeyword, G as lookupTagByName, H as segmentsToModifyPath, I as segmentsToString, J as sopClassNameFromUID, K as tagPathToSegments } from './index-BZxi4104.js';
+import { R as Result, E as ExecOptions, D as DcmtkProcessResult, S as SpawnOptions } from './types-Cgumy1N4.js';
+export { L as LineSource, P as ProcessLine, a as ResultValue, b as assertUnreachable, e as err, m as mapResult, o as ok } from './types-Cgumy1N4.js';
+import { A as AETitle, D as DicomTag, a as DicomTagPath, P as Port, S as SOPClassUID, T as TransferSyntaxUID, b as DicomDataset } from './DicomInstance-D9plqHp5.js';
+export { B as Brand, C as ChangeSet, c as DicomFilePath, d as DicomInstance, e as createAETitle, f as createDicomFilePath, g as createDicomTag, h as createDicomTagPath, i as createPort, j as createSOPClassUID, k as createTransferSyntaxUID, t as tag } from './DicomInstance-D9plqHp5.js';
 import { z } from 'zod';
-export { A as AssociationAcknowledgedData, a as AssociationReceivedData, C as CStoreRequestData, b as CannotStartListenerData, c as ConfigErrorData, D as DCMPRSCP_FATAL_EVENTS, d as DCMPRSCP_PATTERNS, e as DCMPSRCV_FATAL_EVENTS, f as DCMPSRCV_PATTERNS, g as DCMQRSCP_FATAL_EVENTS, h as DCMQRSCP_PATTERNS, i as DCMRECV_FATAL_EVENTS, j as DCMRECV_PATTERNS, k as DatabaseReadyData, l as DcmQRSCP, m as DcmQRSCPEventMap, n as DcmQRSCPOptions, o as DcmprsCP, p as DcmprsCPEventMap, q as DcmprsCPOptions, r as DcmprscpEvent, s as DcmprscpEventValue, t as Dcmpsrcv, u as DcmpsrcvEvent, v as DcmpsrcvEventMap, w as DcmpsrcvEventValue, x as DcmpsrcvOptions, y as DcmqrscpEvent, z as DcmqrscpEventValue, B as Dcmrecv, E as DcmrecvEvent, F as DcmrecvEventMap, G as DcmrecvEventValue, H as DcmrecvOptions, I as DcmtkProcess, J as DcmtkProcessConfig, K as DcmtkProcessEventMap, L as EventPattern, M as FileDeletedData, N as FilenameMode, O as FilenameModeValue, P as LineParser, Q as LineParserEventMap, R as MultiLineConfig, S as PreferredTransferSyntax, T as PreferredTransferSyntaxValue, U as PrintAssociationAcknowledgedData, V as PrintAssociationReceivedData, W as PrintCannotStartListenerData, X as ProcessState, Y as ProcessStateValue, Z as QRAssociationAcknowledgedData, _ as QRAssociationReceivedData, $ as QRCFindRequestData, a0 as QRCGetRequestData, a1 as QRCMoveRequestData, a2 as QRCStoreRequestData, a3 as QRCannotStartListenerData, a4 as QRListeningData, a5 as ReceiverAssociationAcknowledgedData, a6 as ReceiverAssociationReceivedData, a7 as ReceiverCStoreRequestData, a8 as ReceiverCannotStartListenerData, a9 as ReceiverConfigErrorData, aa as ReceiverDatabaseReadyData, ab as ReceiverEchoRequestData, ac as ReceiverListeningData, ad as RefusingAssociationData, ae as STORESCP_FATAL_EVENTS, af as STORESCP_PATTERNS, ag as StorageMode, ah as StorageModeValue, ai as StoreSCP, aj as StoreSCPEventMap, ak as StoreSCPOptions, al as StoreSCPPreset, am as StoreSCPPresetName, an as StoredFileData, ao as StorescpEvent, ap as StorescpEventValue, aq as StoringFileData, ar as SubdirectoryCreatedData, as as SubdirectoryMode, at as SubdirectoryModeValue, au as WLMSCPFS_FATAL_EVENTS, av as WLMSCPFS_PATTERNS, aw as WlmAssociationAcknowledgedData, ax as WlmAssociationReceivedData, ay as WlmCFindRequestData, az as WlmCannotStartListenerData, aA as WlmListeningData, aB as Wlmscpfs, aC as WlmscpfsEvent, aD as WlmscpfsEventMap, aE as WlmscpfsEventValue, aF as WlmscpfsOptions } from './index-CapkWqxy.js';
-export { D as DcmodifyOptions, a as DcmodifyResult, b as DicomJsonElement, c as DicomJsonModel, T as TagModification, d as ToolBaseOptions, e as dcmodify, x as xmlToJson } from './dcmodify-Daeafqrm.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, 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';
+export { AssociationAcknowledgedData, AssociationCompleteData, AssociationContext, AssociationReceivedData, AssociationSummary, AssociationTracker, CStoreRequestData, CannotStartListenerData, ConfigErrorData, DCMPRSCP_FATAL_EVENTS, DCMPRSCP_PATTERNS, DCMPSRCV_FATAL_EVENTS, DCMPSRCV_PATTERNS, DCMQRSCP_FATAL_EVENTS, DCMQRSCP_PATTERNS, DCMRECV_FATAL_EVENTS, DCMRECV_PATTERNS, DatabaseReadyData, DcmQRSCP, DcmQRSCPEventMap, DcmQRSCPOptions, DcmprsCP, DcmprsCPEventMap, DcmprsCPOptions, DcmprscpEvent, DcmprscpEventValue, Dcmpsrcv, DcmpsrcvEvent, DcmpsrcvEventMap, DcmpsrcvEventValue, DcmpsrcvOptions, DcmqrscpEvent, DcmqrscpEventValue, Dcmrecv, DcmrecvEvent, DcmrecvEventMap, DcmrecvEventValue, DcmrecvOptions, DcmtkProcess, DcmtkProcessConfig, DcmtkProcessEventMap, DicomReceiver, DicomReceiverEventMap, DicomReceiverOptions, EventPattern, FileDeletedData, FileReceivedData, FilenameMode, FilenameModeValue, LineParser, LineParserEventMap, MultiLineConfig, PoolStatus, PreferredTransferSyntax, PreferredTransferSyntaxValue, PrintAssociationAcknowledgedData, PrintAssociationReceivedData, PrintCannotStartListenerData, ProcessState, ProcessStateValue, QRAssociationAcknowledgedData, QRAssociationReceivedData, QRCFindRequestData, QRCGetRequestData, QRCMoveRequestData, QRCStoreRequestData, QRCannotStartListenerData, QRListeningData, ReceiverAssociationAcknowledgedData, ReceiverAssociationData, ReceiverAssociationReceivedData, ReceiverCStoreRequestData, ReceiverCannotStartListenerData, ReceiverConfigErrorData, ReceiverDatabaseReadyData, ReceiverEchoRequestData, ReceiverErrorData, ReceiverFileData, ReceiverListeningData, RefusingAssociationData, STORESCP_FATAL_EVENTS, STORESCP_PATTERNS, StorageMode, StorageModeValue, StoreSCP, StoreSCPEventMap, StoreSCPOptions, StoreSCPPreset, StoreSCPPresetName, StoredFileData, StorescpEvent, StorescpEventValue, StoringFileData, SubdirectoryCreatedData, SubdirectoryMode, SubdirectoryModeValue, TrackedFile, WLMSCPFS_FATAL_EVENTS, WLMSCPFS_PATTERNS, WlmAssociationAcknowledgedData, WlmAssociationReceivedData, WlmCFindRequestData, WlmCannotStartListenerData, WlmListeningData, Wlmscpfs, WlmscpfsEvent, WlmscpfsEventMap, WlmscpfsEventValue, WlmscpfsOptions } from './servers.js';
+export { a as DcmodifyOptions, b as DcmodifyResult, D as DicomJsonElement, c as DicomJsonModel, T as TagModification, d as ToolBaseOptions, e as dcmodify, x as xmlToJson } from './dcmodify-B-_uUIKB.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';
+import { EventEmitter } from 'node:events';
 export { BatchOptions, BatchResult, RetryOptions, batch, retry } from './utils.js';
-import 'node:events';
 
 /**
  * Runtime validation schemas and parse functions.
@@ -19,7 +21,7 @@ import 'node:events';
  * @module validation
  */
 
-/** Schema for DICOM AE Titles: 1-16 chars, letters/digits/spaces/hyphens. */
+/** Schema for DICOM AE Titles: 1-16 printable ASCII chars, no backslash. */
 declare const AETitleSchema: z.ZodString;
 /** Schema for network port numbers: integer 1-65535. */
 declare const PortSchema: z.ZodNumber;
@@ -217,6 +219,318 @@ declare function execCommand(binary: string, args: readonly string[], options?:
  */
 declare function spawnCommand(binary: string, args: readonly string[], options?: SpawnOptions): Promise<Result<DcmtkProcessResult>>;
 
+/**
+ * Type definitions for the DicomSender module.
+ *
+ * Follows the project conventions: `as const` objects with union types
+ * (no traditional enums), readonly interfaces, and Result pattern.
+ *
+ * @module senders/types
+ */
+
+/** Sending mode for the DicomSender. */
+declare const SenderMode: {
+    /** One association at a time, queued FIFO. */
+    readonly SINGLE: "single";
+    /** Up to N concurrent associations, each send() gets its own. */
+    readonly MULTIPLE: "multiple";
+    /** Files accumulated into buckets, each bucket = one association. */
+    readonly BUCKET: "bucket";
+};
+type SenderModeValue = (typeof SenderMode)[keyof typeof SenderMode];
+/** Health state of the sender's backpressure algorithm. */
+declare const SenderHealth: {
+    /** All associations succeeding normally. */
+    readonly HEALTHY: "healthy";
+    /** Recent failures detected; effective concurrency reduced. */
+    readonly DEGRADED: "degraded";
+    /** Remote endpoint appears down; minimal concurrency. */
+    readonly DOWN: "down";
+};
+type SenderHealthValue = (typeof SenderHealth)[keyof typeof SenderHealth];
+/** Options for creating a DicomSender instance. */
+interface DicomSenderOptions {
+    /** Remote host or IP address (required). */
+    readonly host: string;
+    /** Remote port number, 1-65535 (required). */
+    readonly port: number;
+    /** Called AE Title of the remote SCP (max 16 chars). */
+    readonly calledAETitle?: string | undefined;
+    /** Calling AE Title of the local SCU (max 16 chars). */
+    readonly callingAETitle?: string | undefined;
+    /** Sending mode. Defaults to 'multiple'. */
+    readonly mode?: SenderModeValue | undefined;
+    /** Maximum concurrent storescu associations. Defaults to 4 (forced to 1 in single mode). */
+    readonly maxAssociations?: number | undefined;
+    /** Proposed transfer syntax for associations. */
+    readonly proposedTransferSyntax?: ProposedTransferSyntaxValue | undefined;
+    /** Maximum queued send requests before rejecting. Defaults to 1000. */
+    readonly maxQueueLength?: number | undefined;
+    /** Per-storescu timeout in milliseconds. Defaults to 30000. */
+    readonly timeoutMs?: number | undefined;
+    /** Maximum retry attempts per send (0 = no retry). Defaults to 3. */
+    readonly maxRetries?: number | undefined;
+    /** Base retry delay in milliseconds. Defaults to 1000. */
+    readonly retryDelayMs?: number | undefined;
+    /** Bucket flush timeout in milliseconds (bucket mode only). Defaults to 5000. */
+    readonly bucketFlushMs?: number | undefined;
+    /** Maximum files per bucket before auto-flush (bucket mode only). Defaults to 50. */
+    readonly maxBucketSize?: number | undefined;
+    /** AbortSignal for external cancellation. */
+    readonly signal?: AbortSignal | undefined;
+}
+/** Per-send options that can override instance defaults. */
+interface SendOptions {
+    /** Override per-storescu timeout for this send. */
+    readonly timeoutMs?: number | undefined;
+    /** Override max retries for this send. */
+    readonly maxRetries?: number | undefined;
+}
+/** Result of a successful send operation. */
+interface SendResult {
+    /** Files that were sent. */
+    readonly files: readonly string[];
+    /** Number of files sent. */
+    readonly fileCount: number;
+    /** Total send duration in milliseconds. */
+    readonly durationMs: number;
+}
+/** Snapshot of the sender's current state. */
+interface SenderStatus {
+    /** Current health state. */
+    readonly health: SenderHealthValue;
+    /** Number of active storescu associations. */
+    readonly activeAssociations: number;
+    /** Current effective max associations (adjusted by backpressure). */
+    readonly effectiveMaxAssociations: number;
+    /** Number of queued send requests. */
+    readonly queueLength: number;
+    /** Total consecutive failures. */
+    readonly consecutiveFailures: number;
+    /** Total consecutive successes. */
+    readonly consecutiveSuccesses: number;
+    /** Whether the sender is stopped. */
+    readonly stopped: boolean;
+}
+/** Data emitted with SEND_COMPLETE events. */
+interface SenderSendCompleteData {
+    /** Files that were sent. */
+    readonly files: readonly string[];
+    /** Number of files sent. */
+    readonly fileCount: number;
+    /** Total send duration in milliseconds. */
+    readonly durationMs: number;
+}
+/** Data emitted with SEND_FAILED events. */
+interface SenderSendFailedData {
+    /** Files that failed to send. */
+    readonly files: readonly string[];
+    /** The error that caused the failure. */
+    readonly error: Error;
+    /** Number of attempts made. */
+    readonly attempts: number;
+}
+/** Data emitted with HEALTH_CHANGED events. */
+interface SenderHealthChangedData {
+    /** Previous health state. */
+    readonly previousHealth: SenderHealthValue;
+    /** New health state. */
+    readonly newHealth: SenderHealthValue;
+    /** Current effective max associations. */
+    readonly effectiveMaxAssociations: number;
+    /** Current consecutive failures count. */
+    readonly consecutiveFailures: number;
+}
+/** Data emitted with BUCKET_FLUSHED events. */
+interface SenderBucketFlushedData {
+    /** Number of files in the flushed bucket. */
+    readonly fileCount: number;
+    /** Reason for the flush. */
+    readonly reason: 'timer' | 'maxSize';
+}
+/** Data emitted with error events. */
+interface SenderErrorData {
+    /** The error that occurred. */
+    readonly error: Error;
+    /** Files involved, if applicable. */
+    readonly files?: readonly string[] | undefined;
+}
+/** Typed event map for DicomSender. */
+interface DicomSenderEventMap {
+    SEND_COMPLETE: [SenderSendCompleteData];
+    SEND_FAILED: [SenderSendFailedData];
+    HEALTH_CHANGED: [SenderHealthChangedData];
+    BUCKET_FLUSHED: [SenderBucketFlushedData];
+    error: [SenderErrorData];
+}
+
+/**
+ * High-throughput DICOM sender with queuing, bucketing, and backpressure.
+ *
+ * Manages concurrent `storescu` calls with three sending modes
+ * (single, multiple, bucket), automatic retry, and adaptive
+ * backpressure to handle struggling remote endpoints.
+ *
+ * @module senders/DicomSender
+ */
+
+/**
+ * High-throughput DICOM sender with queuing, bucketing, and backpressure.
+ *
+ * Manages concurrent `storescu` calls with three sending modes:
+ * - **single**: One association at a time (FIFO queue).
+ * - **multiple**: Up to N concurrent associations.
+ * - **bucket**: Accumulates files into buckets, each flushed as one association.
+ *
+ * @example
+ * ```ts
+ * const result = DicomSender.create({
+ *     host: '192.168.1.100',
+ *     port: 104,
+ *     calledAETitle: 'PACS',
+ *     mode: 'multiple',
+ *     maxAssociations: 8,
+ * });
+ * if (!result.ok) { console.error(result.error.message); return; }
+ * const sender = result.value;
+ *
+ * sender.onSendComplete(data => console.log('Sent:', data.fileCount, 'files'));
+ * sender.onSendFailed(data => console.error('Failed:', data.error.message));
+ *
+ * await sender.send(['/path/to/file1.dcm', '/path/to/file2.dcm']);
+ * await sender.stop();
+ * ```
+ */
+declare class DicomSender extends EventEmitter<DicomSenderEventMap> {
+    private readonly options;
+    private readonly mode;
+    private readonly configuredMaxAssociations;
+    private readonly maxQueueLength;
+    private readonly defaultTimeoutMs;
+    private readonly defaultMaxRetries;
+    private readonly retryDelayMs;
+    private readonly bucketFlushMs;
+    private readonly maxBucketSize;
+    private readonly queue;
+    private activeAssociations;
+    private isStopped;
+    private health;
+    private effectiveMaxAssociations;
+    private consecutiveFailures;
+    private consecutiveSuccesses;
+    private currentBucket;
+    private bucketTimer;
+    private abortHandler;
+    private constructor();
+    /**
+     * Creates a new DicomSender instance.
+     *
+     * @param options - Configuration options
+     * @returns A Result containing the instance or a validation error
+     */
+    static create(options: DicomSenderOptions): Result<DicomSender>;
+    /**
+     * Sends one or more DICOM files to the remote endpoint.
+     *
+     * In single/multiple mode, files are sent as one storescu call.
+     * In bucket mode, files are accumulated into a bucket and flushed
+     * when the bucket reaches maxBucketSize or the flush timer fires.
+     *
+     * The returned promise resolves when the files are actually sent
+     * (not just queued). Callers can await for confirmation or
+     * fire-and-forget with `void sender.send(files)`.
+     *
+     * @param files - One or more DICOM file paths
+     * @param options - Per-send overrides
+     * @returns A Result containing the send result or an error
+     */
+    send(files: readonly string[], options?: SendOptions): Promise<Result<SendResult>>;
+    /**
+     * Flushes the current bucket immediately (bucket mode only).
+     * In single/multiple mode this is a no-op.
+     */
+    flush(): void;
+    /**
+     * Gracefully stops the sender. Rejects all queued items and
+     * waits for active associations to complete.
+     */
+    stop(): Promise<void>;
+    /** Current sender status. */
+    get status(): SenderStatus;
+    /**
+     * Registers a typed listener for a DicomSender-specific event.
+     *
+     * @param event - The event name from DicomSenderEventMap
+     * @param listener - Callback receiving typed event data
+     * @returns this for chaining
+     */
+    onEvent<K extends keyof DicomSenderEventMap>(event: K, listener: (...args: DicomSenderEventMap[K]) => void): this;
+    /**
+     * Registers a listener for successful sends.
+     *
+     * @param listener - Callback receiving send complete data
+     * @returns this for chaining
+     */
+    onSendComplete(listener: (data: SenderSendCompleteData) => void): this;
+    /**
+     * Registers a listener for failed sends.
+     *
+     * @param listener - Callback receiving send failed data
+     * @returns this for chaining
+     */
+    onSendFailed(listener: (data: SenderSendFailedData) => void): this;
+    /**
+     * Registers a listener for health state changes.
+     *
+     * @param listener - Callback receiving health change data
+     * @returns this for chaining
+     */
+    onHealthChanged(listener: (data: SenderHealthChangedData) => void): this;
+    /**
+     * Registers a listener for bucket flushes (bucket mode only).
+     *
+     * @param listener - Callback receiving bucket flush data
+     * @returns this for chaining
+     */
+    onBucketFlushed(listener: (data: SenderBucketFlushedData) => void): this;
+    /** Enqueues a send and dispatches immediately if capacity allows. */
+    private enqueueSend;
+    /** Drains queued entries up to available capacity. */
+    private drainQueue;
+    /** Adds files to the current bucket and triggers flush if full. */
+    private enqueueBucket;
+    /** Counts total files in the current bucket. */
+    private countBucketFiles;
+    /** Flushes the current bucket: combines all files, dispatches as one send. */
+    private flushBucketInternal;
+    /** Resets the bucket flush timer. */
+    private resetBucketTimer;
+    /** Clears the bucket flush timer. */
+    private clearBucketTimer;
+    /** Executes a single queue entry: calls storescu with retry. */
+    private executeEntry;
+    /** Attempts storescu up to maxAttempts times. Returns undefined on success, or the last error. */
+    private attemptSend;
+    /** Calls storescu with the configured options. */
+    private callStorescu;
+    /** Handles a successful send: updates state, emits event, resolves promise. */
+    private handleSendSuccess;
+    /** Records a successful send and adjusts health upward if needed. */
+    private recordSuccess;
+    /** Records a failed send and adjusts health downward if needed. */
+    private recordFailure;
+    /** Emits a HEALTH_CHANGED event. */
+    private emitHealthChanged;
+    /** Rejects all queued entries with the given message. */
+    private rejectQueue;
+    /** Rejects all bucket entries with the given message. */
+    private rejectBucket;
+    /** Waits for all active associations to complete. */
+    private waitForActive;
+    /** Wires an AbortSignal to stop the sender. */
+    private wireAbortSignal;
+}
+
 /**
  * Type definitions for the high-level PACS client API.
  *
@@ -512,4 +826,4 @@ 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, DcmtkProcessResult, DicomDataset, 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, QueryLevel, type QueryLevelValue, REQUIRED_BINARIES, Result, RetrieveMode, type RetrieveModeValue, SOPClassUID, 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 };
+export { AETitle, AETitleSchema, DEFAULT_BLOCK_TIMEOUT_MS, DEFAULT_DICOM_PORT, DEFAULT_DRAIN_TIMEOUT_MS, DEFAULT_PARSE_CONCURRENCY, DEFAULT_START_TIMEOUT_MS, DEFAULT_TIMEOUT_MS, DcmtkProcessResult, DicomDataset, 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 };