dicom-curate 0.34.0 → 0.35.0

package/README.md

@@ -287,6 +287,64 @@ export function sampleBatchCurationSpecification(): TCurationSpecification {
 }
 ```
 
+## Excluding files with preExclude and postExclude
+
+The curation specification supports two optional exclusion functions that let you skip files at different stages of processing. Both return **`true` to exclude** the file; returning `false` (or omitting the function entirely) lets the file through.
+
+### preExclude — skip before mapping
+
+`preExclude` receives a `parser` with access to the **original, unmapped DICOM tags**. Return `true` to skip the file entirely — it will not be mapped, written, or uploaded.
+
+```ts
+export function myCurationSpec(): TCurationSpecification {
+  return {
+    // ... other fields ...
+
+    // Exclude files whose PatientID doesn't match the expected study format.
+    preExclude(parser) {
+      return !/^AB\d{2}-\d{3}$/.test(parser.getDicom('PatientID'))
+    },
+  }
+}
+```
+
+### postExclude — skip after mapping
+
+`postExclude` receives a `parser` whose `getDicom()` returns **de-identified tag values** (PS315E de-identification has already run at this point), and exposes the computed output path as `parser.outputFilePath`. Return `true` to skip writing or uploading the mapped file.
+
+Note: `parser.getFilePathComp()` still returns **input** path components inside `postExclude`, the same as in `preExclude`. Only `parser.outputFilePath` reflects the post-mapping location, as a full string.
+
+```ts
+export function myCurationSpec(): TCurationSpecification {
+  return {
+    // ... other fields ...
+
+    // Exclude structured reports and files routed to an 'exclude' output folder.
+    postExclude(parser) {
+      if (parser.getDicom('Modality') === 'SR') return true
+      if (parser.outputFilePath.includes('/exclude/')) return true
+      return false
+    },
+  }
+}
+```
+
+### Behaviour notes
+
+- **Exclusions are re-evaluated on every run.** When a `preExclude` or `postExclude` is configured, the "unchanged source bytes" short-circuit is disabled so an exclusion added in a later run takes effect even if the file itself didn't change.
+- **Composition across multiple specs is OR.** When `composeSpecs` merges specs that each define `preExclude` / `postExclude`, the composed function excludes a file if **any** spec's function returns `true`. Evaluation short-circuits on the first `true`.
+- **Exceptions are fail-safe.** If an exclusion function throws, the file is treated as **included** and the error message is appended to `mapResults.errors`.
+
+### Result shape
+
+When a file is excluded, `curateOne` / `curateMany` still returns a result object for it. The `excluded` field indicates which function rejected it:
+
+```ts
+// 'pre'  — excluded by preExclude (file was never mapped)
+// 'post' — excluded by postExclude (file was mapped but not written)
+result.excluded // => 'pre' | 'post' | undefined
+```
+
 ## DICOM Conformance Notes
 
 dicom-curate

package/dist/esm/applyMappingsWorker.js

@@ -67499,38 +67499,6 @@ var require_acorn_globals = __commonJS({
 // src/curateOne.ts
 var dcmjs7 = __toESM(require_dcmjs(), 1);
 
-// src/createNestedDirectories.ts
-async function createNestedDirectories(topLevelDirectoryHandle, path) {
-  const pathSegments = path.split("/").filter((segment) => segment !== "");
-  let currentDirectoryHandle = topLevelDirectoryHandle;
-  for (const segment of pathSegments) {
-    try {
-      const entry = await currentDirectoryHandle.getDirectoryHandle(segment, {
-        create: false
-      });
-      currentDirectoryHandle = entry;
-    } catch (error2) {
-      if (error2.name === "NotFoundError") {
-        const entry = await currentDirectoryHandle.getDirectoryHandle(segment, {
-          create: true
-        });
-        currentDirectoryHandle = entry;
-      } else {
-        return false;
-      }
-    }
-  }
-  return currentDirectoryHandle;
-}
-
-// src/curateDict.ts
-var dcmjs6 = __toESM(require_dcmjs(), 1);
-var import_lodash4 = __toESM(require_lodash(), 1);
-
-// src/collectMappings.ts
-var dcmjs4 = __toESM(require_dcmjs(), 1);
-var import_lodash3 = __toESM(require_lodash(), 1);
-
 // src/config/specVersion.ts
 var specVersion = "3.0";
 
@@ -79352,11 +79320,53 @@ function composeSpecs(specOrComposedSpec) {
         return [...prev(p4), ...next(p4)];
       };
     }
+    if (spec.preExclude) {
+      const prev = final.preExclude;
+      const next = spec.preExclude;
+      final.preExclude = prev ? (p4) => prev(p4) || next(p4) : next;
+    }
+    if (spec.postExclude) {
+      const prev = final.postExclude;
+      const next = spec.postExclude;
+      final.postExclude = prev ? (p4) => prev(p4) || next(p4) : next;
+    }
   }
   final.dicomPS315EOptions = mergePs315(ps315Chain);
   return final;
 }
 
+// src/createNestedDirectories.ts
+async function createNestedDirectories(topLevelDirectoryHandle, path) {
+  const pathSegments = path.split("/").filter((segment) => segment !== "");
+  let currentDirectoryHandle = topLevelDirectoryHandle;
+  for (const segment of pathSegments) {
+    try {
+      const entry = await currentDirectoryHandle.getDirectoryHandle(segment, {
+        create: false
+      });
+      currentDirectoryHandle = entry;
+    } catch (error2) {
+      if (error2.name === "NotFoundError") {
+        const entry = await currentDirectoryHandle.getDirectoryHandle(segment, {
+          create: true
+        });
+        currentDirectoryHandle = entry;
+      } else {
+        return false;
+      }
+    }
+  }
+  return currentDirectoryHandle;
+}
+
+// src/curateDict.ts
+var dcmjs6 = __toESM(require_dcmjs(), 1);
+var import_lodash4 = __toESM(require_lodash(), 1);
+
+// src/collectMappings.ts
+var dcmjs4 = __toESM(require_dcmjs(), 1);
+var import_lodash3 = __toESM(require_lodash(), 1);
+
 // src/getParser.ts
 var dcmjs3 = __toESM(require_dcmjs(), 1);
 var import_lodash2 = __toESM(require_lodash(), 1);
@@ -79484,9 +79494,21 @@ function collectMappings(inputFilePath, dicomData, mappingOptions) {
     mappingOptions.columnMappings,
     finalSpec.additionalData
   );
+  let preExcludeError;
+  try {
+    if (finalSpec.preExclude?.(parser)) {
+      mapResults.excluded = "pre";
+      return [naturalData, mapResults];
+    }
+  } catch (e4) {
+    preExcludeError = `preExclude threw an error: ${e4 instanceof Error ? e4.message : String(e4)} \u2014 treating file as included (fail-safe)`;
+  }
   if (!mappingOptions.skipValidation) {
     mapResults.errors = finalSpec.errors(parser).filter(([, failure]) => failure).map(([message]) => message);
   }
+  if (preExcludeError) {
+    mapResults.errors.push(preExcludeError);
+  }
   if (finalSpec.additionalData?.type === "listing") {
     const { lookups, info, collect } = finalSpec.additionalData.collect(parser);
     const collectByValue = collect.map((item) => {
@@ -79538,6 +79560,19 @@ function collectMappings(inputFilePath, dicomData, mappingOptions) {
       mapResults.outputFilePath = parts.join("/");
     }
   }
+  try {
+    if (finalSpec.postExclude?.({
+      ...parser,
+      outputFilePath: mapResults.outputFilePath
+    })) {
+      mapResults.excluded = "post";
+      return [naturalData, mapResults];
+    }
+  } catch (e4) {
+    mapResults.errors.push(
+      `postExclude threw an error: ${e4 instanceof Error ? e4.message : String(e4)} \u2014 treating file as included (fail-safe)`
+    );
+  }
   if (!mappingOptions.skipModifications) {
     const dicomMap = finalSpec.modifyDicomHeader(parser);
     for (const attrPath in dicomMap) {
@@ -79804,6 +79839,12 @@ async function loadS3Client() {
 }
 
 // src/curateOne.ts
+function specHasFilter(mappingOptions) {
+  if (mappingOptions.curationSpec === "none")
+    return false;
+  const composed = composeSpecs(mappingOptions.curationSpec());
+  return !!(composed.preExclude ?? composed.postExclude);
+}
 async function curateOne({
   fileInfo,
   outputTarget,
@@ -79950,7 +79991,8 @@ async function curateOne({
     };
     return retval;
   };
-  if (canSkip && previousSourceFileInfo) {
+  const hasFilter = specHasFilter(mappingOptions);
+  if (canSkip && previousSourceFileInfo && !hasFilter) {
     return noMapResult();
   }
   let mappedDicomData;
@@ -79997,6 +80039,18 @@ async function curateOne({
         write: () => fileArrayBuffer
       };
     }
+    if (clonedMapResults.excluded) {
+      clonedMapResults.mappingRequired = false;
+      clonedMapResults.fileInfo = {
+        name: fileInfo.name,
+        size: fileInfo.size,
+        path: fileInfo.path,
+        mtime,
+        preMappedHash
+      };
+      clonedMapResults.curationTime = performance.now() - startTime;
+      return clonedMapResults;
+    }
     clonedMapResults.mappingRequired = true;
   } else {
     mappedDicomData = {

package/dist/esm/collectMappings.js

@@ -35345,6 +35345,16 @@ function composeSpecs(specOrComposedSpec) {
         return [...prev(p), ...next(p)];
       };
     }
+    if (spec.preExclude) {
+      const prev = final.preExclude;
+      const next = spec.preExclude;
+      final.preExclude = prev ? (p) => prev(p) || next(p) : next;
+    }
+    if (spec.postExclude) {
+      const prev = final.postExclude;
+      const next = spec.postExclude;
+      final.postExclude = prev ? (p) => prev(p) || next(p) : next;
+    }
   }
   final.dicomPS315EOptions = mergePs315(ps315Chain);
   return final;
@@ -35477,9 +35487,21 @@ function collectMappings(inputFilePath, dicomData, mappingOptions) {
     mappingOptions.columnMappings,
     finalSpec.additionalData
   );
+  let preExcludeError;
+  try {
+    if (finalSpec.preExclude?.(parser)) {
+      mapResults.excluded = "pre";
+      return [naturalData, mapResults];
+    }
+  } catch (e) {
+    preExcludeError = `preExclude threw an error: ${e instanceof Error ? e.message : String(e)} \u2014 treating file as included (fail-safe)`;
+  }
   if (!mappingOptions.skipValidation) {
     mapResults.errors = finalSpec.errors(parser).filter(([, failure]) => failure).map(([message]) => message);
   }
+  if (preExcludeError) {
+    mapResults.errors.push(preExcludeError);
+  }
   if (finalSpec.additionalData?.type === "listing") {
     const { lookups, info, collect } = finalSpec.additionalData.collect(parser);
     const collectByValue = collect.map((item) => {
@@ -35531,6 +35553,19 @@ function collectMappings(inputFilePath, dicomData, mappingOptions) {
       mapResults.outputFilePath = parts.join("/");
     }
   }
+  try {
+    if (finalSpec.postExclude?.({
+      ...parser,
+      outputFilePath: mapResults.outputFilePath
+    })) {
+      mapResults.excluded = "post";
+      return [naturalData, mapResults];
+    }
+  } catch (e) {
+    mapResults.errors.push(
+      `postExclude threw an error: ${e instanceof Error ? e.message : String(e)} \u2014 treating file as included (fail-safe)`
+    );
+  }
   if (!mappingOptions.skipModifications) {
     const dicomMap = finalSpec.modifyDicomHeader(parser);
     for (const attrPath in dicomMap) {

package/dist/esm/composeSpecs.js

@@ -33805,6 +33805,16 @@ function composeSpecs(specOrComposedSpec) {
         return [...prev(p), ...next(p)];
       };
     }
+    if (spec.preExclude) {
+      const prev = final.preExclude;
+      const next = spec.preExclude;
+      final.preExclude = prev ? (p) => prev(p) || next(p) : next;
+    }
+    if (spec.postExclude) {
+      const prev = final.postExclude;
+      const next = spec.postExclude;
+      final.postExclude = prev ? (p) => prev(p) || next(p) : next;
+    }
   }
   final.dicomPS315EOptions = mergePs315(ps315Chain);
   return final;

package/dist/esm/curateDict.js

@@ -35363,6 +35363,16 @@ function composeSpecs(specOrComposedSpec) {
         return [...prev(p), ...next(p)];
       };
     }
+    if (spec.preExclude) {
+      const prev = final.preExclude;
+      const next = spec.preExclude;
+      final.preExclude = prev ? (p) => prev(p) || next(p) : next;
+    }
+    if (spec.postExclude) {
+      const prev = final.postExclude;
+      const next = spec.postExclude;
+      final.postExclude = prev ? (p) => prev(p) || next(p) : next;
+    }
   }
   final.dicomPS315EOptions = mergePs315(ps315Chain);
   return final;
@@ -35495,9 +35505,21 @@ function collectMappings(inputFilePath, dicomData, mappingOptions) {
     mappingOptions.columnMappings,
     finalSpec.additionalData
   );
+  let preExcludeError;
+  try {
+    if (finalSpec.preExclude?.(parser)) {
+      mapResults.excluded = "pre";
+      return [naturalData, mapResults];
+    }
+  } catch (e) {
+    preExcludeError = `preExclude threw an error: ${e instanceof Error ? e.message : String(e)} \u2014 treating file as included (fail-safe)`;
+  }
   if (!mappingOptions.skipValidation) {
     mapResults.errors = finalSpec.errors(parser).filter(([, failure]) => failure).map(([message]) => message);
   }
+  if (preExcludeError) {
+    mapResults.errors.push(preExcludeError);
+  }
   if (finalSpec.additionalData?.type === "listing") {
     const { lookups, info, collect } = finalSpec.additionalData.collect(parser);
     const collectByValue = collect.map((item) => {
@@ -35549,6 +35571,19 @@ function collectMappings(inputFilePath, dicomData, mappingOptions) {
       mapResults.outputFilePath = parts.join("/");
     }
   }
+  try {
+    if (finalSpec.postExclude?.({
+      ...parser,
+      outputFilePath: mapResults.outputFilePath
+    })) {
+      mapResults.excluded = "post";
+      return [naturalData, mapResults];
+    }
+  } catch (e) {
+    mapResults.errors.push(
+      `postExclude threw an error: ${e instanceof Error ? e.message : String(e)} \u2014 treating file as included (fail-safe)`
+    );
+  }
   if (!mappingOptions.skipModifications) {
     const dicomMap = finalSpec.modifyDicomHeader(parser);
     for (const attrPath in dicomMap) {

package/dist/esm/curateOne.js

@@ -61208,38 +61208,6 @@ var require_dist_cjs71 = __commonJS({
 // src/curateOne.ts
 var dcmjs7 = __toESM(require_dcmjs(), 1);
 
-// src/createNestedDirectories.ts
-async function createNestedDirectories(topLevelDirectoryHandle, path) {
-  const pathSegments = path.split("/").filter((segment) => segment !== "");
-  let currentDirectoryHandle = topLevelDirectoryHandle;
-  for (const segment of pathSegments) {
-    try {
-      const entry = await currentDirectoryHandle.getDirectoryHandle(segment, {
-        create: false
-      });
-      currentDirectoryHandle = entry;
-    } catch (error2) {
-      if (error2.name === "NotFoundError") {
-        const entry = await currentDirectoryHandle.getDirectoryHandle(segment, {
-          create: true
-        });
-        currentDirectoryHandle = entry;
-      } else {
-        return false;
-      }
-    }
-  }
-  return currentDirectoryHandle;
-}
-
-// src/curateDict.ts
-var dcmjs6 = __toESM(require_dcmjs(), 1);
-var import_lodash4 = __toESM(require_lodash(), 1);
-
-// src/collectMappings.ts
-var dcmjs4 = __toESM(require_dcmjs(), 1);
-var import_lodash3 = __toESM(require_lodash(), 1);
-
 // src/config/specVersion.ts
 var specVersion = "3.0";
 
@@ -73061,11 +73029,53 @@ function composeSpecs(specOrComposedSpec) {
         return [...prev(p4), ...next(p4)];
       };
     }
+    if (spec.preExclude) {
+      const prev = final.preExclude;
+      const next = spec.preExclude;
+      final.preExclude = prev ? (p4) => prev(p4) || next(p4) : next;
+    }
+    if (spec.postExclude) {
+      const prev = final.postExclude;
+      const next = spec.postExclude;
+      final.postExclude = prev ? (p4) => prev(p4) || next(p4) : next;
+    }
   }
   final.dicomPS315EOptions = mergePs315(ps315Chain);
   return final;
 }
 
+// src/createNestedDirectories.ts
+async function createNestedDirectories(topLevelDirectoryHandle, path) {
+  const pathSegments = path.split("/").filter((segment) => segment !== "");
+  let currentDirectoryHandle = topLevelDirectoryHandle;
+  for (const segment of pathSegments) {
+    try {
+      const entry = await currentDirectoryHandle.getDirectoryHandle(segment, {
+        create: false
+      });
+      currentDirectoryHandle = entry;
+    } catch (error2) {
+      if (error2.name === "NotFoundError") {
+        const entry = await currentDirectoryHandle.getDirectoryHandle(segment, {
+          create: true
+        });
+        currentDirectoryHandle = entry;
+      } else {
+        return false;
+      }
+    }
+  }
+  return currentDirectoryHandle;
+}
+
+// src/curateDict.ts
+var dcmjs6 = __toESM(require_dcmjs(), 1);
+var import_lodash4 = __toESM(require_lodash(), 1);
+
+// src/collectMappings.ts
+var dcmjs4 = __toESM(require_dcmjs(), 1);
+var import_lodash3 = __toESM(require_lodash(), 1);
+
 // src/getParser.ts
 var dcmjs3 = __toESM(require_dcmjs(), 1);
 var import_lodash2 = __toESM(require_lodash(), 1);
@@ -73193,9 +73203,21 @@ function collectMappings(inputFilePath, dicomData, mappingOptions) {
     mappingOptions.columnMappings,
     finalSpec.additionalData
   );
+  let preExcludeError;
+  try {
+    if (finalSpec.preExclude?.(parser)) {
+      mapResults.excluded = "pre";
+      return [naturalData, mapResults];
+    }
+  } catch (e4) {
+    preExcludeError = `preExclude threw an error: ${e4 instanceof Error ? e4.message : String(e4)} \u2014 treating file as included (fail-safe)`;
+  }
   if (!mappingOptions.skipValidation) {
     mapResults.errors = finalSpec.errors(parser).filter(([, failure]) => failure).map(([message]) => message);
   }
+  if (preExcludeError) {
+    mapResults.errors.push(preExcludeError);
+  }
   if (finalSpec.additionalData?.type === "listing") {
     const { lookups, info, collect } = finalSpec.additionalData.collect(parser);
     const collectByValue = collect.map((item) => {
@@ -73247,6 +73269,19 @@ function collectMappings(inputFilePath, dicomData, mappingOptions) {
       mapResults.outputFilePath = parts.join("/");
     }
   }
+  try {
+    if (finalSpec.postExclude?.({
+      ...parser,
+      outputFilePath: mapResults.outputFilePath
+    })) {
+      mapResults.excluded = "post";
+      return [naturalData, mapResults];
+    }
+  } catch (e4) {
+    mapResults.errors.push(
+      `postExclude threw an error: ${e4 instanceof Error ? e4.message : String(e4)} \u2014 treating file as included (fail-safe)`
+    );
+  }
   if (!mappingOptions.skipModifications) {
     const dicomMap = finalSpec.modifyDicomHeader(parser);
     for (const attrPath in dicomMap) {
@@ -73513,6 +73548,12 @@ async function loadS3Client() {
 }
 
 // src/curateOne.ts
+function specHasFilter(mappingOptions) {
+  if (mappingOptions.curationSpec === "none")
+    return false;
+  const composed = composeSpecs(mappingOptions.curationSpec());
+  return !!(composed.preExclude ?? composed.postExclude);
+}
 async function curateOne({
   fileInfo,
   outputTarget,
@@ -73659,7 +73700,8 @@ async function curateOne({
     };
     return retval;
   };
-  if (canSkip && previousSourceFileInfo) {
+  const hasFilter = specHasFilter(mappingOptions);
+  if (canSkip && previousSourceFileInfo && !hasFilter) {
     return noMapResult();
   }
   let mappedDicomData;
@@ -73706,6 +73748,18 @@ async function curateOne({
         write: () => fileArrayBuffer
       };
     }
+    if (clonedMapResults.excluded) {
+      clonedMapResults.mappingRequired = false;
+      clonedMapResults.fileInfo = {
+        name: fileInfo.name,
+        size: fileInfo.size,
+        path: fileInfo.path,
+        mtime,
+        preMappedHash
+      };
+      clonedMapResults.curationTime = performance.now() - startTime;
+      return clonedMapResults;
+    }
     clonedMapResults.mappingRequired = true;
   } else {
     mappedDicomData = {

package/dist/esm/index.js

@@ -80855,6 +80855,16 @@ function composeSpecs(specOrComposedSpec) {
         return [...prev(p4), ...next(p4)];
       };
     }
+    if (spec.preExclude) {
+      const prev = final.preExclude;
+      const next = spec.preExclude;
+      final.preExclude = prev ? (p4) => prev(p4) || next(p4) : next;
+    }
+    if (spec.postExclude) {
+      const prev = final.postExclude;
+      const next = spec.postExclude;
+      final.postExclude = prev ? (p4) => prev(p4) || next(p4) : next;
+    }
   }
   final.dicomPS315EOptions = mergePs315(ps315Chain);
   return final;
@@ -81047,9 +81057,21 @@ function collectMappings(inputFilePath, dicomData, mappingOptions) {
     mappingOptions.columnMappings,
     finalSpec.additionalData
   );
+  let preExcludeError;
+  try {
+    if (finalSpec.preExclude?.(parser)) {
+      mapResults.excluded = "pre";
+      return [naturalData, mapResults];
+    }
+  } catch (e4) {
+    preExcludeError = `preExclude threw an error: ${e4 instanceof Error ? e4.message : String(e4)} \u2014 treating file as included (fail-safe)`;
+  }
   if (!mappingOptions.skipValidation) {
     mapResults.errors = finalSpec.errors(parser).filter(([, failure]) => failure).map(([message]) => message);
   }
+  if (preExcludeError) {
+    mapResults.errors.push(preExcludeError);
+  }
   if (finalSpec.additionalData?.type === "listing") {
     const { lookups, info, collect } = finalSpec.additionalData.collect(parser);
     const collectByValue = collect.map((item) => {
@@ -81101,6 +81123,19 @@ function collectMappings(inputFilePath, dicomData, mappingOptions) {
       mapResults.outputFilePath = parts.join("/");
     }
   }
+  try {
+    if (finalSpec.postExclude?.({
+      ...parser,
+      outputFilePath: mapResults.outputFilePath
+    })) {
+      mapResults.excluded = "post";
+      return [naturalData, mapResults];
+    }
+  } catch (e4) {
+    mapResults.errors.push(
+      `postExclude threw an error: ${e4 instanceof Error ? e4.message : String(e4)} \u2014 treating file as included (fail-safe)`
+    );
+  }
   if (!mappingOptions.skipModifications) {
     const dicomMap = finalSpec.modifyDicomHeader(parser);
     for (const attrPath in dicomMap) {
@@ -81367,6 +81402,12 @@ async function loadS3Client() {
 }
 
 // src/curateOne.ts
+function specHasFilter(mappingOptions) {
+  if (mappingOptions.curationSpec === "none")
+    return false;
+  const composed = composeSpecs(mappingOptions.curationSpec());
+  return !!(composed.preExclude ?? composed.postExclude);
+}
 async function curateOne({
   fileInfo,
   outputTarget,
@@ -81513,7 +81554,8 @@ async function curateOne({
     };
     return retval;
   };
-  if (canSkip && previousSourceFileInfo) {
+  const hasFilter = specHasFilter(mappingOptions);
+  if (canSkip && previousSourceFileInfo && !hasFilter) {
     return noMapResult();
   }
   let mappedDicomData;
@@ -81560,6 +81602,18 @@ async function curateOne({
         write: () => fileArrayBuffer
       };
     }
+    if (clonedMapResults.excluded) {
+      clonedMapResults.mappingRequired = false;
+      clonedMapResults.fileInfo = {
+        name: fileInfo.name,
+        size: fileInfo.size,
+        path: fileInfo.path,
+        mtime,
+        preMappedHash
+      };
+      clonedMapResults.curationTime = performance.now() - startTime;
+      return clonedMapResults;
+    }
     clonedMapResults.mappingRequired = true;
   } else {
     mappedDicomData = {

package/dist/types/types.d.ts

@@ -148,6 +148,7 @@ export type TMapResults = {
         etag?: string;
     };
     mappingRequired?: boolean;
+    excluded?: 'pre' | 'post';
     curationTime?: number;
 };
 export type TPs315EElement = {
@@ -180,6 +181,9 @@ export type TParser = {
     FILENAME: symbol;
     FILEBASENAME: symbol;
 };
+export type TPostExcludeParser = TParser & {
+    outputFilePath: string;
+};
 type TMappingInputDirect = {
     type: 'load';
     collect: Record<string, RegExp | string[]>;
@@ -220,6 +224,8 @@ export type TCurationSpecification<THost extends HostProps = HostProps> = {
         mapping: TMappedValues;
     } & (TMappingInputDirect | TMappingInputTwoPass);
     excludedFiletypes?: string[];
+    preExclude?: (parser: TParser) => boolean;
+    postExclude?: (parser: TPostExcludeParser) => boolean;
 };
 type TProgressMessageBase = {
     totalFiles?: number;