@ubercode/dcmtk 0.7.2 → 0.8.0

package/dist/index.d.cts

@@ -263,8 +263,10 @@ interface DicomSenderOptions {
     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;
+    /** Proposed transfer syntax(es) for associations. Pass an array to propose multiple. */
+    readonly proposedTransferSyntax?: ProposedTransferSyntaxValue | readonly ProposedTransferSyntaxValue[] | undefined;
+    /** Combine proposed transfer syntaxes into fewer presentation contexts. Maps to `+C`/`--combine`. */
+    readonly combineProposedTransferSyntaxes?: boolean | undefined;
     /** Maximum queued send requests before rejecting. Defaults to 1000. */
     readonly maxQueueLength?: number | undefined;
     /** Per-storescu timeout in milliseconds. Defaults to 30000. */
@@ -308,6 +310,10 @@ interface SendOptions {
     readonly callingAETitle?: string | undefined;
     /** Override required flag for this send. */
     readonly required?: boolean | undefined;
+    /** Override proposed transfer syntax(es) for this send. */
+    readonly proposedTransferSyntax?: ProposedTransferSyntaxValue | readonly ProposedTransferSyntaxValue[] | undefined;
+    /** Override combine proposed transfer syntaxes for this send. */
+    readonly combineProposedTransferSyntaxes?: boolean | undefined;
 }
 /** Result of a successful send operation. */
 interface SendResult {
@@ -437,24 +443,10 @@ interface DicomSenderEventMap {
  * ```
  */
 declare class DicomSender extends EventEmitter<DicomSenderEventMap> {
-    private readonly options;
-    private readonly mode;
-    private readonly configuredMaxAssociations;
-    private readonly maxQueueLength;
+    private readonly engine;
     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 readonly signal;
     private abortHandler;
     private constructor();
     /**
@@ -480,8 +472,6 @@ declare class DicomSender extends EventEmitter<DicomSenderEventMap> {
      * @returns A Result containing the send result or an error
      */
     send(files: readonly string[], options?: SendOptions): Promise<Result<SendResult>>;
-    /** Dispatches a send to the appropriate mode handler. */
-    private dispatchSend;
     /**
      * Flushes the current bucket immediately (bucket mode only).
      * In single/multiple mode this is a no-op.
@@ -530,42 +520,201 @@ declare class DicomSender extends EventEmitter<DicomSenderEventMap> {
      * @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;
-    /** Merges bucket entries into a single QueueEntry. */
-    private mergeBucketEntries;
-    /** 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 failure info. */
-    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;
+}
+
+/**
+ * High-throughput DICOM sender using the dcmsend binary.
+ *
+ * Similar interface to {@link DicomSender} but wraps `dcmsend` instead of
+ * `storescu`. `dcmsend` automatically proposes each file's native transfer
+ * syntax, avoiding the need for codec licenses when sending compressed data.
+ *
+ * @module senders/DicomSend
+ */
+
+/** Options for creating a DicomSend instance. */
+interface DicomSendOptions {
+    /** 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?: 'single' | 'multiple' | 'bucket' | undefined;
+    /** Maximum concurrent dcmsend calls. Defaults to 4 (forced to 1 in single mode). */
+    readonly maxAssociations?: number | undefined;
+    /** Maximum queued send requests before rejecting. Defaults to 1000. */
+    readonly maxQueueLength?: number | undefined;
+    /** Per-dcmsend 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;
+    /** Maximum PDU receive size (4096-131072). Maps to `--max-pdu`. */
+    readonly maxPduReceive?: number | undefined;
+    /** Maximum PDU send size (4096-131072). Maps to `--max-send-pdu`. */
+    readonly maxPduSend?: number | undefined;
+    /** Association timeout in seconds. Maps to `-to`. */
+    readonly associationTimeout?: number | undefined;
+    /** ACSE timeout in seconds. Maps to `-ta`. */
+    readonly acseTimeout?: number | undefined;
+    /** DIMSE timeout in seconds. Maps to `-td`. */
+    readonly dimseTimeout?: number | undefined;
+    /** Disable DNS hostname lookup. Maps to `-nh`. */
+    readonly noHostnameLookup?: boolean | undefined;
+    /** Verbosity level. `'verbose'` maps to `-v`, `'debug'` maps to `-d`. */
+    readonly verbosity?: 'verbose' | 'debug' | undefined;
+    /** Do not halt on first invalid input file. Maps to `--no-halt`. */
+    readonly noHalt?: boolean | undefined;
+    /** Do not propose illegal presentation contexts. Maps to `--no-illegal-proposal`. */
+    readonly noIllegalProposal?: boolean | undefined;
+    /** Decompression mode. Maps to `--decompress-never`/`--decompress-lossless`/`--decompress-lossy`. */
+    readonly decompress?: 'never' | 'lossless' | 'lossy' | undefined;
+    /** Use multiple associations (one after the other). `true` maps to `+ma`, `false` maps to `-ma`. */
+    readonly multiAssociations?: boolean | undefined;
+    /** Disable UID validity checking. Maps to `--no-uid-checks`. */
+    readonly noUidChecks?: boolean | undefined;
+    /** AbortSignal for external cancellation. */
+    readonly signal?: AbortSignal | undefined;
+}
+/** Per-send options for DicomSend. */
+interface DcmsendSendOptions {
+    /** Override per-dcmsend timeout for this send. */
+    readonly timeoutMs?: number | undefined;
+    /** Override max retries for this send. */
+    readonly maxRetries?: number | undefined;
+    /** Override called AE Title for this send. */
+    readonly calledAETitle?: string | undefined;
+    /** Override calling AE Title for this send. */
+    readonly callingAETitle?: string | undefined;
+}
+/** Typed event map for DicomSend. */
+interface DicomSendEventMap {
+    SEND_COMPLETE: [SenderSendCompleteData];
+    SEND_FAILED: [SenderSendFailedData];
+    HEALTH_CHANGED: [SenderHealthChangedData];
+    BUCKET_FLUSHED: [SenderBucketFlushedData];
+    error: [{
+        readonly error: Error;
+        readonly files?: readonly string[] | undefined;
+    }];
+}
+/**
+ * High-throughput DICOM sender wrapping the `dcmsend` binary.
+ *
+ * Unlike {@link DicomSender} (which uses `storescu`), `DicomSend` uses
+ * `dcmsend` which automatically proposes each file's native transfer
+ * syntax. This avoids the need for commercial codec licenses when
+ * sending compressed DICOM data (e.g., JPEG 2000).
+ *
+ * Supports the same three sending modes as DicomSender:
+ * - **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 = DicomSend.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 DicomSend extends EventEmitter<DicomSendEventMap> {
+    private readonly engine;
+    private readonly defaultTimeoutMs;
+    private readonly defaultMaxRetries;
+    private readonly signal;
+    private abortHandler;
+    private constructor();
+    /**
+     * Creates a new DicomSend instance.
+     *
+     * @param options - Configuration options
+     * @returns A Result containing the instance or a validation error
+     */
+    static create(options: DicomSendOptions): Result<DicomSend>;
+    /**
+     * Sends one or more DICOM files to the remote endpoint.
+     *
+     * In single/multiple mode, files are sent as one dcmsend call.
+     * In bucket mode, files are accumulated into a bucket and flushed
+     * when the bucket reaches maxBucketSize or the flush timer fires.
+     *
+     * @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?: DcmsendSendOptions): 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 DicomSend-specific event.
+     *
+     * @param event - The event name from DicomSendEventMap
+     * @param listener - Callback receiving typed event data
+     * @returns this for chaining
+     */
+    onEvent<K extends keyof DicomSendEventMap>(event: K, listener: (...args: DicomSendEventMap[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;
     /** Wires an AbortSignal to stop the sender. */
     private wireAbortSignal;
 }
@@ -865,4 +1014,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, 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 };
+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 };

package/dist/index.d.ts

@@ -263,8 +263,10 @@ interface DicomSenderOptions {
     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;
+    /** Proposed transfer syntax(es) for associations. Pass an array to propose multiple. */
+    readonly proposedTransferSyntax?: ProposedTransferSyntaxValue | readonly ProposedTransferSyntaxValue[] | undefined;
+    /** Combine proposed transfer syntaxes into fewer presentation contexts. Maps to `+C`/`--combine`. */
+    readonly combineProposedTransferSyntaxes?: boolean | undefined;
     /** Maximum queued send requests before rejecting. Defaults to 1000. */
     readonly maxQueueLength?: number | undefined;
     /** Per-storescu timeout in milliseconds. Defaults to 30000. */
@@ -308,6 +310,10 @@ interface SendOptions {
     readonly callingAETitle?: string | undefined;
     /** Override required flag for this send. */
     readonly required?: boolean | undefined;
+    /** Override proposed transfer syntax(es) for this send. */
+    readonly proposedTransferSyntax?: ProposedTransferSyntaxValue | readonly ProposedTransferSyntaxValue[] | undefined;
+    /** Override combine proposed transfer syntaxes for this send. */
+    readonly combineProposedTransferSyntaxes?: boolean | undefined;
 }
 /** Result of a successful send operation. */
 interface SendResult {
@@ -437,24 +443,10 @@ interface DicomSenderEventMap {
  * ```
  */
 declare class DicomSender extends EventEmitter<DicomSenderEventMap> {
-    private readonly options;
-    private readonly mode;
-    private readonly configuredMaxAssociations;
-    private readonly maxQueueLength;
+    private readonly engine;
     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 readonly signal;
     private abortHandler;
     private constructor();
     /**
@@ -480,8 +472,6 @@ declare class DicomSender extends EventEmitter<DicomSenderEventMap> {
      * @returns A Result containing the send result or an error
      */
     send(files: readonly string[], options?: SendOptions): Promise<Result<SendResult>>;
-    /** Dispatches a send to the appropriate mode handler. */
-    private dispatchSend;
     /**
      * Flushes the current bucket immediately (bucket mode only).
      * In single/multiple mode this is a no-op.
@@ -530,42 +520,201 @@ declare class DicomSender extends EventEmitter<DicomSenderEventMap> {
      * @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;
-    /** Merges bucket entries into a single QueueEntry. */
-    private mergeBucketEntries;
-    /** 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 failure info. */
-    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;
+}
+
+/**
+ * High-throughput DICOM sender using the dcmsend binary.
+ *
+ * Similar interface to {@link DicomSender} but wraps `dcmsend` instead of
+ * `storescu`. `dcmsend` automatically proposes each file's native transfer
+ * syntax, avoiding the need for codec licenses when sending compressed data.
+ *
+ * @module senders/DicomSend
+ */
+
+/** Options for creating a DicomSend instance. */
+interface DicomSendOptions {
+    /** 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?: 'single' | 'multiple' | 'bucket' | undefined;
+    /** Maximum concurrent dcmsend calls. Defaults to 4 (forced to 1 in single mode). */
+    readonly maxAssociations?: number | undefined;
+    /** Maximum queued send requests before rejecting. Defaults to 1000. */
+    readonly maxQueueLength?: number | undefined;
+    /** Per-dcmsend 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;
+    /** Maximum PDU receive size (4096-131072). Maps to `--max-pdu`. */
+    readonly maxPduReceive?: number | undefined;
+    /** Maximum PDU send size (4096-131072). Maps to `--max-send-pdu`. */
+    readonly maxPduSend?: number | undefined;
+    /** Association timeout in seconds. Maps to `-to`. */
+    readonly associationTimeout?: number | undefined;
+    /** ACSE timeout in seconds. Maps to `-ta`. */
+    readonly acseTimeout?: number | undefined;
+    /** DIMSE timeout in seconds. Maps to `-td`. */
+    readonly dimseTimeout?: number | undefined;
+    /** Disable DNS hostname lookup. Maps to `-nh`. */
+    readonly noHostnameLookup?: boolean | undefined;
+    /** Verbosity level. `'verbose'` maps to `-v`, `'debug'` maps to `-d`. */
+    readonly verbosity?: 'verbose' | 'debug' | undefined;
+    /** Do not halt on first invalid input file. Maps to `--no-halt`. */
+    readonly noHalt?: boolean | undefined;
+    /** Do not propose illegal presentation contexts. Maps to `--no-illegal-proposal`. */
+    readonly noIllegalProposal?: boolean | undefined;
+    /** Decompression mode. Maps to `--decompress-never`/`--decompress-lossless`/`--decompress-lossy`. */
+    readonly decompress?: 'never' | 'lossless' | 'lossy' | undefined;
+    /** Use multiple associations (one after the other). `true` maps to `+ma`, `false` maps to `-ma`. */
+    readonly multiAssociations?: boolean | undefined;
+    /** Disable UID validity checking. Maps to `--no-uid-checks`. */
+    readonly noUidChecks?: boolean | undefined;
+    /** AbortSignal for external cancellation. */
+    readonly signal?: AbortSignal | undefined;
+}
+/** Per-send options for DicomSend. */
+interface DcmsendSendOptions {
+    /** Override per-dcmsend timeout for this send. */
+    readonly timeoutMs?: number | undefined;
+    /** Override max retries for this send. */
+    readonly maxRetries?: number | undefined;
+    /** Override called AE Title for this send. */
+    readonly calledAETitle?: string | undefined;
+    /** Override calling AE Title for this send. */
+    readonly callingAETitle?: string | undefined;
+}
+/** Typed event map for DicomSend. */
+interface DicomSendEventMap {
+    SEND_COMPLETE: [SenderSendCompleteData];
+    SEND_FAILED: [SenderSendFailedData];
+    HEALTH_CHANGED: [SenderHealthChangedData];
+    BUCKET_FLUSHED: [SenderBucketFlushedData];
+    error: [{
+        readonly error: Error;
+        readonly files?: readonly string[] | undefined;
+    }];
+}
+/**
+ * High-throughput DICOM sender wrapping the `dcmsend` binary.
+ *
+ * Unlike {@link DicomSender} (which uses `storescu`), `DicomSend` uses
+ * `dcmsend` which automatically proposes each file's native transfer
+ * syntax. This avoids the need for commercial codec licenses when
+ * sending compressed DICOM data (e.g., JPEG 2000).
+ *
+ * Supports the same three sending modes as DicomSender:
+ * - **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 = DicomSend.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 DicomSend extends EventEmitter<DicomSendEventMap> {
+    private readonly engine;
+    private readonly defaultTimeoutMs;
+    private readonly defaultMaxRetries;
+    private readonly signal;
+    private abortHandler;
+    private constructor();
+    /**
+     * Creates a new DicomSend instance.
+     *
+     * @param options - Configuration options
+     * @returns A Result containing the instance or a validation error
+     */
+    static create(options: DicomSendOptions): Result<DicomSend>;
+    /**
+     * Sends one or more DICOM files to the remote endpoint.
+     *
+     * In single/multiple mode, files are sent as one dcmsend call.
+     * In bucket mode, files are accumulated into a bucket and flushed
+     * when the bucket reaches maxBucketSize or the flush timer fires.
+     *
+     * @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?: DcmsendSendOptions): 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 DicomSend-specific event.
+     *
+     * @param event - The event name from DicomSendEventMap
+     * @param listener - Callback receiving typed event data
+     * @returns this for chaining
+     */
+    onEvent<K extends keyof DicomSendEventMap>(event: K, listener: (...args: DicomSendEventMap[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;
     /** Wires an AbortSignal to stop the sender. */
     private wireAbortSignal;
 }
@@ -865,4 +1014,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, 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 };
+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 };