@ubercode/dcmtk 0.4.0 → 0.5.0

package/dist/servers.js

@@ -2675,8 +2675,9 @@ var DEFAULT_MAX_POOL_SIZE = 10;
 var DEFAULT_CONNECTION_TIMEOUT_MS = 1e4;
 var CONNECTION_RETRY_INTERVAL_MS = 500;
 var MAX_CONNECTION_RETRIES = 200;
+var MAX_OUTPUT_LINES_PER_ASSOCIATION = 500;
 var DicomReceiverOptionsSchema = z.object({
-  port: z.number().int().min(1).max(65535),
+  port: z.number().int().min(0).max(65535),
   storageDir: z.string().min(1).refine(isSafePath, { message: "path traversal detected in storageDir" }),
   aeTitle: z.string().min(1).max(16).refine(isValidAETitle, { message: "AE Title contains invalid characters" }).optional(),
   minPoolSize: z.number().int().min(1).max(100).optional(),
@@ -2684,6 +2685,9 @@ var DicomReceiverOptionsSchema = z.object({
   connectionTimeoutMs: z.number().int().positive().optional(),
   configFile: z.string().min(1).refine(isSafePath, { message: "path traversal detected in configFile" }).optional(),
   configProfile: z.string().min(1).optional(),
+  acseTimeout: z.number().int().positive().optional(),
+  dimseTimeout: z.number().int().positive().optional(),
+  maxPdu: z.number().int().min(4096).max(131072).optional(),
   signal: z.instanceof(AbortSignal).optional()
 }).strict().refine((data) => (data.minPoolSize ?? DEFAULT_MIN_POOL_SIZE) <= (data.maxPoolSize ?? DEFAULT_MAX_POOL_SIZE), {
   message: "minPoolSize must be <= maxPoolSize"
@@ -2812,6 +2816,57 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
   onAssociationComplete(listener) {
     return this.on("ASSOCIATION_COMPLETE", listener);
   }
+  /**
+   * Registers a listener for new associations (bubbled from workers).
+   *
+   * @param listener - Callback receiving association received data
+   * @returns this for chaining
+   */
+  onAssociationReceived(listener) {
+    return this.on("ASSOCIATION_RECEIVED", listener);
+  }
+  /**
+   * Registers a listener for C-STORE requests (bubbled from workers).
+   *
+   * @param listener - Callback receiving C-STORE request data
+   * @returns this for chaining
+   */
+  onCStoreRequest(listener) {
+    return this.on("C_STORE_REQUEST", listener);
+  }
+  /**
+   * Registers a listener for C-ECHO requests (bubbled from workers).
+   *
+   * @param listener - Callback receiving echo request data
+   * @returns this for chaining
+   */
+  onEchoRequest(listener) {
+    return this.on("ECHO_REQUEST", listener);
+  }
+  /**
+   * Registers a listener for refused associations (bubbled from workers).
+   *
+   * @param listener - Callback receiving refusing association data
+   * @returns this for chaining
+   */
+  onRefusingAssociation(listener) {
+    return this.on("REFUSING_ASSOCIATION", listener);
+  }
+  /**
+   * Routes an external socket to an idle worker.
+   *
+   * The pool must be started via `start()` before calling this method.
+   * Use this when managing your own TCP listener (e.g., protocol router).
+   *
+   * @param socket - An incoming net.Socket to route to a worker
+   */
+  handleSocket(socket) {
+    if (!this.started) {
+      socket.destroy(new Error("DicomReceiver: not started"));
+      return;
+    }
+    void this.handleConnection(socket);
+  }
   /** Current pool status. */
   get poolStatus() {
     let idle = 0;
@@ -2825,8 +2880,11 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
   // -----------------------------------------------------------------------
   // TCP proxy
   // -----------------------------------------------------------------------
-  /** Starts the TCP proxy on the configured port. */
+  /** Starts the TCP proxy on the configured port. Skips if port is 0. */
   startTcpProxy() {
+    if (this.options.port === 0) {
+      return Promise.resolve(ok(void 0));
+    }
     return new Promise((resolve) => {
       this.tcpServer = net.createServer((socket) => {
         void this.handleConnection(socket);
@@ -2879,6 +2937,7 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
     worker.associationDir = associationDir;
     worker.files = [];
     worker.fileSizes = [];
+    worker.outputLines = [];
     worker.startAt = Date.now();
     this.pipeConnection(worker, remoteSocket);
     void this.replenishPool();
@@ -2937,6 +2996,19 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
     }
     return ok(void 0);
   }
+  /** Creates a Dcmrecv instance with the pool's shared options. */
+  createDcmrecv(port, tempDir) {
+    return Dcmrecv.create({
+      port,
+      aeTitle: this.options.aeTitle ?? "DCMRECV",
+      outputDirectory: tempDir,
+      configFile: this.options.configFile,
+      configProfile: this.options.configProfile,
+      acseTimeout: this.options.acseTimeout,
+      dimseTimeout: this.options.dimseTimeout,
+      maxPdu: this.options.maxPdu
+    });
+  }
   /** Spawns a single Dcmrecv worker with an ephemeral port. */
   async spawnWorker() {
     const portResult = await allocatePort();
@@ -2945,13 +3017,7 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
     const tempDir = path.join(os.tmpdir(), `dcmrecv-pool-${String(port)}-${String(Date.now())}`);
     const mkdirResult = await ensureDirectory(tempDir);
     if (!mkdirResult.ok) return mkdirResult;
-    const createResult = Dcmrecv.create({
-      port,
-      aeTitle: this.options.aeTitle ?? "DCMRECV",
-      outputDirectory: tempDir,
-      configFile: this.options.configFile,
-      configProfile: this.options.configProfile
-    });
+    const createResult = this.createDcmrecv(port, tempDir);
     if (!createResult.ok) return createResult;
     const dcmrecv = createResult.value;
     const worker = {
@@ -2963,6 +3029,7 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
       associationDir: void 0,
       files: [],
       fileSizes: [],
+      outputLines: [],
       startAt: void 0,
       remoteSocket: void 0,
       workerSocket: void 0
@@ -3024,10 +3091,15 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
   // -----------------------------------------------------------------------
   // Worker event wiring
   // -----------------------------------------------------------------------
-  /** Wires FILE_RECEIVED and ASSOCIATION_COMPLETE events on a worker. */
+  /** Wires all events on a worker: file handling, association lifecycle, output capture. */
   wireWorkerEvents(worker) {
     this.wireFileReceived(worker);
     this.wireAssociationComplete(worker);
+    this.wireAssociationReceived(worker);
+    this.wireCStoreRequest(worker);
+    this.wireEchoRequest(worker);
+    this.wireRefusingAssociation(worker);
+    this.wireOutputCapture(worker);
   }
   /** Wires FILE_RECEIVED from dcmrecv worker to handleFileReceived. */
   wireFileReceived(worker) {
@@ -3075,6 +3147,7 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
       const assocId = worker.associationId ?? data.associationId;
       const assocDir = worker.associationDir ?? "";
       const files = [...worker.files];
+      const output = [...worker.outputLines];
       const endAt = Date.now();
       const startAt = worker.startAt ?? endAt;
       const totalBytes = sumArray(worker.fileSizes);
@@ -3092,19 +3165,65 @@ var DicomReceiver = class _DicomReceiver extends EventEmitter {
         totalBytes,
         bytesPerSecond,
         startAt,
-        endAt
+        endAt,
+        output
       });
       worker.state = "idle";
       worker.associationId = void 0;
       worker.associationDir = void 0;
       worker.files = [];
       worker.fileSizes = [];
+      worker.outputLines = [];
       worker.startAt = void 0;
       worker.remoteSocket = void 0;
       worker.workerSocket = void 0;
       void this.scaleDown();
     });
   }
+  /** Bubbles ASSOCIATION_RECEIVED from dcmrecv worker. */
+  wireAssociationReceived(worker) {
+    worker.dcmrecv.onEvent("ASSOCIATION_RECEIVED", (data) => {
+      this.emit("ASSOCIATION_RECEIVED", {
+        associationId: worker.associationId ?? "",
+        callingAE: data.callingAE,
+        calledAE: data.calledAE,
+        source: data.source
+      });
+    });
+  }
+  /** Bubbles C_STORE_REQUEST from dcmrecv worker. */
+  wireCStoreRequest(worker) {
+    worker.dcmrecv.onEvent("C_STORE_REQUEST", (data) => {
+      this.emit("C_STORE_REQUEST", {
+        associationId: worker.associationId ?? "",
+        raw: data.raw
+      });
+    });
+  }
+  /** Bubbles ECHO_REQUEST from dcmrecv worker. */
+  wireEchoRequest(worker) {
+    worker.dcmrecv.onEvent("ECHO_REQUEST", () => {
+      this.emit("ECHO_REQUEST", {
+        associationId: worker.associationId ?? ""
+      });
+    });
+  }
+  /** Bubbles REFUSING_ASSOCIATION from dcmrecv worker. */
+  wireRefusingAssociation(worker) {
+    worker.dcmrecv.onEvent("REFUSING_ASSOCIATION", (data) => {
+      this.emit("REFUSING_ASSOCIATION", {
+        reason: data.reason
+      });
+    });
+  }
+  /** Captures worker output lines during busy associations. */
+  wireOutputCapture(worker) {
+    worker.dcmrecv.on("line", ({ text }) => {
+      if (worker.state === "busy" && worker.outputLines.length < MAX_OUTPUT_LINES_PER_ASSOCIATION) {
+        worker.outputLines.push(text);
+      }
+    });
+  }
   // -----------------------------------------------------------------------
   // Abort signal
   // -----------------------------------------------------------------------