@ubercode/dcmtk 0.2.0 → 0.4.0

package/README.md

@@ -9,12 +9,13 @@
 [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D20-green.svg)](https://nodejs.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-Type-safe Node.js bindings for the [DCMTK](https://dicom.offis.de/dcmtk.php.en) (DICOM Toolkit) command-line utilities. Wraps 51 DCMTK binaries, 6 long-lived server processes, and a pooled DicomReceiver with auto-scaling workers, all with a modern async/await API, branded types, and the Result pattern for safe error handling.
+Type-safe Node.js bindings for the [DCMTK](https://dicom.offis.de/dcmtk.php.en) (DICOM Toolkit) command-line utilities. Wraps 51 DCMTK binaries, 6 long-lived server processes, a pooled DicomReceiver with auto-scaling workers, and a high-throughput DicomSender with queuing and backpressure — all with a modern async/await API, branded types, and the Result pattern for safe error handling.
 
 ## Features
 
-- **51 tool wrappers** — async functions for every DCMTK command-line binary (data conversion, network, image processing, structured reports, presentation state)
-- **6 server classes + DicomReceiver** — long-lived DICOM listeners with typed EventEmitter APIs, plus a pooled receiver with auto-scaling workers
+- **51 tool wrappers** — async functions for every DCMTK command-line binary with `verbosity` control and full CLI flag coverage
+- **Network resilience** — all 7 network tools support PDU sizing, ACSE/DIMSE/association timeouts, and hostname lookup control
+- **6 server classes + DicomReceiver + DicomSender** — long-lived DICOM listeners with typed EventEmitter APIs, a pooled receiver with auto-scaling workers, and a high-throughput sender with queuing, bucketing, and backpressure
 - **PacsClient** — high-level PACS client with Echo, Query, Retrieve, and Store operations
 - **DICOM data layer** — immutable `DicomDataset`, explicit `ChangeSet` builder, and `DicomInstance` unified file I/O
 - **Result pattern** — all fallible operations return `Result<T>` instead of throwing
@@ -63,6 +64,8 @@ const result = await echoscu({
     host: '127.0.0.1',
     port: 4242,
     calledAETitle: 'PACS',
+    verbosity: 'verbose',
+    associationTimeout: 10,
 });
 
 if (result.ok) {
@@ -103,6 +106,7 @@ if (result.ok) {
 | [PACS Client](docs/pacs-client.md)           | High-level Echo, Query, Retrieve, Store API              |
 | [DICOM Data Layer](docs/dicom-data-layer.md) | DicomDataset, ChangeSet, DicomInstance                   |
 | [Servers](docs/servers.md)                   | 6 server classes + DicomReceiver pooled receiver         |
+| [Senders](docs/senders.md)                   | DicomSender high-throughput sender with backpressure     |
 | [Utilities](docs/utilities.md)               | batch processing, retry with backoff                     |
 
 ## Tool Reference
@@ -121,15 +125,16 @@ if (result.ok) {
 
 ## Server Reference
 
-| Class           | Binary         | Description                                | Docs                                        |
-| --------------- | -------------- | ------------------------------------------ | ------------------------------------------- |
-| `Dcmrecv`       | dcmrecv        | DICOM receiver (C-STORE SCP)               | [servers.md](docs/servers.md#dcmrecv)       |
-| `StoreSCP`      | storescp       | Storage SCP with advanced options          | [servers.md](docs/servers.md#storescp)      |
-| `DcmQRSCP`      | dcmqrscp       | Query/Retrieve SCP (C-FIND, C-MOVE, C-GET) | [servers.md](docs/servers.md#dcmqrscp)      |
-| `Wlmscpfs`      | wlmscpfs       | Worklist Management SCP                    | [servers.md](docs/servers.md#wlmscpfs)      |
-| `DcmprsCP`      | dcmprscp       | Print Management SCP                       | [servers.md](docs/servers.md#dcmprscp)      |
-| `Dcmpsrcv`      | dcmpsrcv       | Viewer network receiver                    | [servers.md](docs/servers.md#dcmpsrcv)      |
-| `DicomReceiver` | dcmrecv (pool) | Pooled receiver with auto-scaling workers  | [servers.md](docs/servers.md#dicomreceiver) |
+| Class           | Binary          | Description                                | Docs                                        |
+| --------------- | --------------- | ------------------------------------------ | ------------------------------------------- |
+| `Dcmrecv`       | dcmrecv         | DICOM receiver (C-STORE SCP)               | [servers.md](docs/servers.md#dcmrecv)       |
+| `StoreSCP`      | storescp        | Storage SCP with advanced options          | [servers.md](docs/servers.md#storescp)      |
+| `DcmQRSCP`      | dcmqrscp        | Query/Retrieve SCP (C-FIND, C-MOVE, C-GET) | [servers.md](docs/servers.md#dcmqrscp)      |
+| `Wlmscpfs`      | wlmscpfs        | Worklist Management SCP                    | [servers.md](docs/servers.md#wlmscpfs)      |
+| `DcmprsCP`      | dcmprscp        | Print Management SCP                       | [servers.md](docs/servers.md#dcmprscp)      |
+| `Dcmpsrcv`      | dcmpsrcv        | Viewer network receiver                    | [servers.md](docs/servers.md#dcmpsrcv)      |
+| `DicomReceiver` | dcmrecv (pool)  | Pooled receiver with auto-scaling workers  | [servers.md](docs/servers.md#dicomreceiver) |
+| `DicomSender`   | storescu (pool) | High-throughput sender with backpressure   | [senders.md](docs/senders.md)               |
 
 ## License
 

package/dist/{DicomInstance-CQEIuF_x.d.ts → DicomInstance-CGBr3a-C.d.ts}

@@ -1,5 +1,5 @@
 import { R as Result } from './types-Cgumy1N4.js';
-import { D as DicomJsonElement, T as TagModification } from './dcmodify-B-_uUIKB.js';
+import { D as DicomJsonElement, T as TagModification } from './dcmodify-BvaIeyJg.js';
 
 /**
  * Branded types for domain primitives.
@@ -90,7 +90,7 @@ declare function createDicomTag(input: string): Result<DicomTag>;
 /**
  * Creates a validated AETitle from a raw string.
  *
- * @param input - A string expected to be 1-16 chars of letters, digits, spaces, or hyphens
+ * @param input - A string expected to be 1-16 printable ASCII chars (no backslash)
  * @returns A Result containing the branded AETitle or an error
  */
 declare function createAETitle(input: string): Result<AETitle>;

package/dist/{DicomInstance-By9zd7GM.d.cts → DicomInstance-DWOjhccQ.d.cts}

@@ -1,5 +1,5 @@
 import { R as Result } from './types-Cgumy1N4.cjs';
-import { D as DicomJsonElement, T as TagModification } from './dcmodify-Gds9u5Vj.cjs';
+import { D as DicomJsonElement, T as TagModification } from './dcmodify-B9js5K1f.cjs';
 
 /**
  * Branded types for domain primitives.
@@ -90,7 +90,7 @@ declare function createDicomTag(input: string): Result<DicomTag>;
 /**
  * Creates a validated AETitle from a raw string.
  *
- * @param input - A string expected to be 1-16 chars of letters, digits, spaces, or hyphens
+ * @param input - A string expected to be 1-16 printable ASCII chars (no backslash)
  * @returns A Result containing the branded AETitle or an error
  */
 declare function createAETitle(input: string): Result<AETitle>;

package/dist/{dcmodify-Gds9u5Vj.d.cts → dcmodify-B9js5K1f.d.cts}

@@ -94,6 +94,8 @@ interface DcmodifyOptions extends ToolBaseOptions {
     readonly insertIfMissing?: boolean | undefined;
     /** Treat 'tag not found' as success when erasing (uses -imt flag). Defaults to false. */
     readonly ignoreMissingTags?: boolean | undefined;
+    /** Verbosity level for diagnostic output. `'verbose'` maps to `-v`, `'debug'` maps to `-d`. */
+    readonly verbosity?: 'verbose' | 'debug' | undefined;
 }
 /** Result of a successful dcmodify operation. */
 interface DcmodifyResult {

package/dist/{dcmodify-B-_uUIKB.d.ts → dcmodify-BvaIeyJg.d.ts}

@@ -94,6 +94,8 @@ interface DcmodifyOptions extends ToolBaseOptions {
     readonly insertIfMissing?: boolean | undefined;
     /** Treat 'tag not found' as success when erasing (uses -imt flag). Defaults to false. */
     readonly ignoreMissingTags?: boolean | undefined;
+    /** Verbosity level for diagnostic output. `'verbose'` maps to `-v`, `'debug'` maps to `-d`. */
+    readonly verbosity?: 'verbose' | 'debug' | undefined;
 }
 /** Result of a successful dcmodify operation. */
 interface DcmodifyResult {

package/dist/dicom.cjs

@@ -30718,19 +30718,28 @@ function repairJson(raw) {
 var Dcm2jsonOptionsSchema = zod.z.object({
   timeoutMs: zod.z.number().int().positive().optional(),
   signal: zod.z.instanceof(AbortSignal).optional(),
-  directOnly: zod.z.boolean().optional()
+  directOnly: zod.z.boolean().optional(),
+  verbosity: zod.z.enum(["verbose", "debug"]).optional()
 }).strict().optional();
-async function tryXmlPath(inputPath, timeoutMs, signal) {
+var VERBOSITY_FLAGS = { verbose: "-v", debug: "-d" };
+function buildVerbosityArgs(verbosity) {
+  if (verbosity !== void 0) {
+    return [VERBOSITY_FLAGS[verbosity]];
+  }
+  return [];
+}
+async function tryXmlPath(inputPath, timeoutMs, signal, verbosity) {
   const xmlBinary = resolveBinary("dcm2xml");
   if (!xmlBinary.ok) {
     return err(xmlBinary.error);
   }
-  const xmlResult = await execCommand(xmlBinary.value, ["-nat", inputPath], { timeoutMs, signal });
+  const xmlArgs = [...buildVerbosityArgs(verbosity), "-nat", inputPath];
+  const xmlResult = await execCommand(xmlBinary.value, xmlArgs, { timeoutMs, signal });
   if (!xmlResult.ok) {
     return err(xmlResult.error);
   }
   if (xmlResult.value.exitCode !== 0) {
-    return err(createToolError("dcm2xml", ["-nat", inputPath], xmlResult.value.exitCode, xmlResult.value.stderr));
+    return err(createToolError("dcm2xml", xmlArgs, xmlResult.value.exitCode, xmlResult.value.stderr));
   }
   const jsonResult = xmlToJson(xmlResult.value.stdout);
   if (!jsonResult.ok) {
@@ -30738,17 +30747,18 @@ async function tryXmlPath(inputPath, timeoutMs, signal) {
   }
   return ok({ data: jsonResult.value, source: "xml" });
 }
-async function tryDirectPath(inputPath, timeoutMs, signal) {
+async function tryDirectPath(inputPath, timeoutMs, signal, verbosity) {
   const jsonBinary = resolveBinary("dcm2json");
   if (!jsonBinary.ok) {
     return err(jsonBinary.error);
   }
-  const result = await execCommand(jsonBinary.value, [inputPath], { timeoutMs, signal });
+  const directArgs = [...buildVerbosityArgs(verbosity), inputPath];
+  const result = await execCommand(jsonBinary.value, directArgs, { timeoutMs, signal });
   if (!result.ok) {
     return err(result.error);
   }
   if (result.value.exitCode !== 0) {
-    return err(createToolError("dcm2json", [inputPath], result.value.exitCode, result.value.stderr));
+    return err(createToolError("dcm2json", directArgs, result.value.exitCode, result.value.stderr));
   }
   try {
     const repaired = repairJson(result.value.stdout);
@@ -30765,20 +30775,22 @@ async function dcm2json(inputPath, options) {
   }
   const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
   const signal = options?.signal;
+  const verbosity = options?.verbosity;
   if (options?.directOnly === true) {
-    return tryDirectPath(inputPath, timeoutMs, signal);
+    return tryDirectPath(inputPath, timeoutMs, signal, verbosity);
   }
-  const xmlResult = await tryXmlPath(inputPath, timeoutMs, signal);
+  const xmlResult = await tryXmlPath(inputPath, timeoutMs, signal, verbosity);
   if (xmlResult.ok) {
     return xmlResult;
   }
-  return tryDirectPath(inputPath, timeoutMs, signal);
+  return tryDirectPath(inputPath, timeoutMs, signal, verbosity);
 }
 var TAG_OR_PATH_PATTERN = /^\([0-9A-Fa-f]{4},[0-9A-Fa-f]{4}\)(\[\d+\](\.\([0-9A-Fa-f]{4},[0-9A-Fa-f]{4}\)(\[\d+\])?)*)?$/;
 var TagModificationSchema = zod.z.object({
   tag: zod.z.string().regex(TAG_OR_PATH_PATTERN),
   value: zod.z.string()
 });
+var VERBOSITY_FLAGS2 = { verbose: "-v", debug: "-d" };
 var DcmodifyOptionsSchema = zod.z.object({
   timeoutMs: zod.z.number().int().positive().optional(),
   signal: zod.z.instanceof(AbortSignal).optional(),
@@ -30787,12 +30799,16 @@ var DcmodifyOptionsSchema = zod.z.object({
   erasePrivateTags: zod.z.boolean().optional(),
   noBackup: zod.z.boolean().optional(),
   insertIfMissing: zod.z.boolean().optional(),
-  ignoreMissingTags: zod.z.boolean().optional()
+  ignoreMissingTags: zod.z.boolean().optional(),
+  verbosity: zod.z.enum(["verbose", "debug"]).optional()
 }).strict().refine((data) => data.modifications.length > 0 || data.erasures !== void 0 && data.erasures.length > 0 || data.erasePrivateTags === true, {
   message: "At least one of modifications, erasures, or erasePrivateTags is required"
 });
 function buildArgs(inputPath, options) {
   const args = [];
+  if (options.verbosity !== void 0) {
+    args.push(VERBOSITY_FLAGS2[options.verbosity]);
+  }
   if (options.noBackup !== false) {
     args.push("-nb");
   }