@ubercode/dcmtk 0.8.0 → 0.8.2

package/dist/{DicomInstance-BjrSIEGN.d.ts → DicomInstance-BKUiir0G.d.ts}

@@ -458,6 +458,11 @@ interface FileIOOptions {
     /** AbortSignal for external cancellation. */
     readonly signal?: AbortSignal | undefined;
 }
+/** Options for opening a DICOM file. Extends FileIOOptions with read-specific settings. */
+interface DicomOpenOptions extends FileIOOptions {
+    /** Assume the specified character set when SpecificCharacterSet (0008,0005) is absent. Maps to dcm2xml `+Ca`. */
+    readonly charsetAssume?: string | undefined;
+}
 
 /**
  * Unified DICOM object composing DicomDataset + ChangeSet + file I/O.
@@ -497,10 +502,10 @@ declare class DicomInstance {
      * Opens a DICOM file and creates a DicomInstance.
      *
      * @param path - Filesystem path to the DICOM file
-     * @param options - Timeout and abort options
+     * @param options - Timeout, abort, and charset options
      * @returns A Result containing the DicomInstance or an error
      */
-    static open(path: string, options?: FileIOOptions): Promise<Result<DicomInstance>>;
+    static open(path: string, options?: DicomOpenOptions): Promise<Result<DicomInstance>>;
     /**
      * Creates a DicomInstance from an existing DicomDataset.
      *
@@ -670,4 +675,4 @@ declare class DicomInstance {
     getMetadata(key: string): unknown;
 }
 
-export { type AETitle as A, type Brand as B, ChangeSet as C, type DicomTag as D, type Port as P, type SOPClassUID as S, type TransferSyntaxUID as T, type WalkTagEntry as W, type DicomTagPath as a, DicomDataset as b, type DicomFilePath as c, DicomInstance as d, type WalkTagsOptions as e, createAETitle as f, createDicomFilePath as g, createDicomTag as h, createDicomTagPath as i, createPort as j, createSOPClassUID as k, createTransferSyntaxUID as l, tag as t, walkTags as w };
+export { type AETitle as A, type Brand as B, ChangeSet as C, type DicomTag as D, type Port as P, type SOPClassUID as S, type TransferSyntaxUID as T, type WalkTagEntry as W, type DicomTagPath as a, DicomDataset as b, type DicomFilePath as c, DicomInstance as d, type DicomOpenOptions as e, type WalkTagsOptions as f, createAETitle as g, createDicomFilePath as h, createDicomTag as i, createDicomTagPath as j, createPort as k, createSOPClassUID as l, createTransferSyntaxUID as m, tag as t, walkTags as w };

package/dist/{DicomInstance-zsmyd7fs.d.cts → DicomInstance-CxLKC-oM.d.cts}

@@ -458,6 +458,11 @@ interface FileIOOptions {
     /** AbortSignal for external cancellation. */
     readonly signal?: AbortSignal | undefined;
 }
+/** Options for opening a DICOM file. Extends FileIOOptions with read-specific settings. */
+interface DicomOpenOptions extends FileIOOptions {
+    /** Assume the specified character set when SpecificCharacterSet (0008,0005) is absent. Maps to dcm2xml `+Ca`. */
+    readonly charsetAssume?: string | undefined;
+}
 
 /**
  * Unified DICOM object composing DicomDataset + ChangeSet + file I/O.
@@ -497,10 +502,10 @@ declare class DicomInstance {
      * Opens a DICOM file and creates a DicomInstance.
      *
      * @param path - Filesystem path to the DICOM file
-     * @param options - Timeout and abort options
+     * @param options - Timeout, abort, and charset options
      * @returns A Result containing the DicomInstance or an error
      */
-    static open(path: string, options?: FileIOOptions): Promise<Result<DicomInstance>>;
+    static open(path: string, options?: DicomOpenOptions): Promise<Result<DicomInstance>>;
     /**
      * Creates a DicomInstance from an existing DicomDataset.
      *
@@ -670,4 +675,4 @@ declare class DicomInstance {
     getMetadata(key: string): unknown;
 }
 
-export { type AETitle as A, type Brand as B, ChangeSet as C, type DicomTag as D, type Port as P, type SOPClassUID as S, type TransferSyntaxUID as T, type WalkTagEntry as W, type DicomTagPath as a, DicomDataset as b, type DicomFilePath as c, DicomInstance as d, type WalkTagsOptions as e, createAETitle as f, createDicomFilePath as g, createDicomTag as h, createDicomTagPath as i, createPort as j, createSOPClassUID as k, createTransferSyntaxUID as l, tag as t, walkTags as w };
+export { type AETitle as A, type Brand as B, ChangeSet as C, type DicomTag as D, type Port as P, type SOPClassUID as S, type TransferSyntaxUID as T, type WalkTagEntry as W, type DicomTagPath as a, DicomDataset as b, type DicomFilePath as c, DicomInstance as d, type DicomOpenOptions as e, type WalkTagsOptions as f, createAETitle as g, createDicomFilePath as h, createDicomTag as i, createDicomTagPath as j, createPort as k, createSOPClassUID as l, createTransferSyntaxUID as m, tag as t, walkTags as w };

package/dist/dicom.cjs

@@ -30784,6 +30784,7 @@ var Dcm2jsonOptionsSchema = zod.z.object({
   timeoutMs: zod.z.number().int().positive().optional(),
   signal: zod.z.instanceof(AbortSignal).optional(),
   directOnly: zod.z.boolean().optional(),
+  charsetAssume: zod.z.string().min(1).optional(),
   verbosity: zod.z.enum(["verbose", "debug"]).optional()
 }).strict().optional();
 var VERBOSITY_FLAGS = { verbose: "-v", debug: "-d" };
@@ -30793,12 +30794,19 @@ function buildVerbosityArgs(verbosity) {
   }
   return [];
 }
-async function tryXmlPath(inputPath, timeoutMs, signal, verbosity) {
+function buildXmlOpts(options) {
+  const result = {};
+  if (options?.verbosity !== void 0) result["verbosity"] = options.verbosity;
+  if (options?.charsetAssume !== void 0) result["charsetAssume"] = options.charsetAssume;
+  return result;
+}
+async function tryXmlPath(inputPath, timeoutMs, signal, opts) {
   const xmlBinary = resolveBinary("dcm2xml");
   if (!xmlBinary.ok) {
     return err(xmlBinary.error);
   }
-  const xmlArgs = [...buildVerbosityArgs(verbosity), "-nat", inputPath];
+  const charsetArgs = opts?.charsetAssume !== void 0 ? ["+Ca", opts.charsetAssume] : [];
+  const xmlArgs = [...buildVerbosityArgs(opts?.verbosity), ...charsetArgs, "-nat", inputPath];
   const xmlResult = await execCommand(xmlBinary.value, xmlArgs, { timeoutMs, signal });
   if (!xmlResult.ok) {
     return err(xmlResult.error);
@@ -30817,7 +30825,7 @@ async function tryDirectPath(inputPath, timeoutMs, signal, verbosity) {
   if (!jsonBinary.ok) {
     return err(jsonBinary.error);
   }
-  const directArgs = [...buildVerbosityArgs(verbosity), inputPath];
+  const directArgs = [...buildVerbosityArgs(verbosity), "+b", inputPath];
   const result = await execCommand(jsonBinary.value, directArgs, { timeoutMs, signal });
   if (!result.ok) {
     return err(result.error);
@@ -30844,7 +30852,7 @@ async function dcm2json(inputPath, options) {
   if (options?.directOnly === true) {
     return tryDirectPath(inputPath, timeoutMs, signal, verbosity);
   }
-  const xmlResult = await tryXmlPath(inputPath, timeoutMs, signal, verbosity);
+  const xmlResult = await tryXmlPath(inputPath, timeoutMs, signal, buildXmlOpts(options));
   if (xmlResult.ok) {
     return xmlResult;
   }
@@ -30973,7 +30981,7 @@ var DicomInstance = class _DicomInstance {
    * Opens a DICOM file and creates a DicomInstance.
    *
    * @param path - Filesystem path to the DICOM file
-   * @param options - Timeout and abort options
+   * @param options - Timeout, abort, and charset options
    * @returns A Result containing the DicomInstance or an error
    */
   static async open(path, options) {
@@ -30981,7 +30989,8 @@ var DicomInstance = class _DicomInstance {
     if (!filePathResult.ok) return err(filePathResult.error);
     const jsonResult = await dcm2json(path, {
       timeoutMs: options?.timeoutMs ?? DEFAULT_TIMEOUT_MS,
-      signal: options?.signal
+      signal: options?.signal,
+      charsetAssume: options?.charsetAssume
     });
     if (!jsonResult.ok) return err(jsonResult.error);
     const datasetResult = DicomDataset.fromJson(jsonResult.value.data);