@utilarium/dreadcabinet 0.0.16-dev.0 → 0.0.17-dev.0

package/dist/defaults.js

@@ -9,7 +9,12 @@ const applyDefaults = (config, features, defaults)=>{
         var _ref;
         configWithDefaults.recursive = config.recursive === undefined ? (_ref = defaults === null || defaults === void 0 ? void 0 : defaults.recursive) !== null && _ref !== void 0 ? _ref : DEFAULT_RECURSIVE : config.recursive;
         configWithDefaults.inputDirectory = config.inputDirectory || (defaults === null || defaults === void 0 ? void 0 : defaults.inputDirectory) || DEFAULT_INPUT_DIRECTORY;
-        configWithDefaults.concurrency = config.concurrency || (defaults === null || defaults === void 0 ? void 0 : defaults.concurrency) || DEFAULT_CONCURRENCY;
+        // Ensure concurrency is a valid positive integer, otherwise use default
+        if (config.concurrency === undefined || !Number.isInteger(config.concurrency) || config.concurrency < 1) {
+            configWithDefaults.concurrency = (defaults === null || defaults === void 0 ? void 0 : defaults.concurrency) || DEFAULT_CONCURRENCY;
+        } else {
+            configWithDefaults.concurrency = config.concurrency;
+        }
     }
     if (features.includes('output')) {
         configWithDefaults.outputDirectory = config.outputDirectory || (defaults === null || defaults === void 0 ? void 0 : defaults.outputDirectory) || DEFAULT_OUTPUT_DIRECTORY;

package/dist/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sources":["../src/defaults.ts"],"sourcesContent":["import { Config } from './dreadcabinet';\nimport { DEFAULT_CONCURRENCY, DEFAULT_EXTENSIONS, DEFAULT_INPUT_DIRECTORY, DEFAULT_INPUT_FILENAME_OPTIONS, DEFAULT_INPUT_STRUCTURE, DEFAULT_OUTPUT_DIRECTORY, DEFAULT_OUTPUT_FILENAME_OPTIONS, DEFAULT_OUTPUT_STRUCTURE, DEFAULT_RECURSIVE, DEFAULT_TIMEZONE } from './constants';\nimport { DefaultOptions, Feature } from './dreadcabinet';\n\nexport const applyDefaults = (config: Partial<Config>, features: Feature[], defaults: DefaultOptions): Config => {\n    const configWithDefaults = {\n        ...config,\n    }\n\n    configWithDefaults.timezone = config.timezone || (defaults?.timezone || DEFAULT_TIMEZONE);\n    if (features.includes('input')) {\n        configWithDefaults.recursive = config.recursive === undefined ? (defaults?.recursive ?? DEFAULT_RECURSIVE) : config.recursive;\n        configWithDefaults.inputDirectory = config.inputDirectory || (defaults?.inputDirectory || DEFAULT_INPUT_DIRECTORY);\n        configWithDefaults.concurrency = config.concurrency || (defaults?.concurrency || DEFAULT_CONCURRENCY);\n    }\n    if (features.includes('output')) {\n        configWithDefaults.outputDirectory = config.outputDirectory || (defaults?.outputDirectory || DEFAULT_OUTPUT_DIRECTORY);\n    }\n    if (features.includes('structured-output')) {\n        configWithDefaults.outputStructure = config.outputStructure || (defaults?.outputStructure || DEFAULT_OUTPUT_STRUCTURE);\n        configWithDefaults.outputFilenameOptions = config.outputFilenameOptions || (defaults?.outputFilenameOptions || DEFAULT_OUTPUT_FILENAME_OPTIONS);\n    }\n    if (features.includes('extensions')) {\n        configWithDefaults.extensions = config.extensions || (defaults?.extensions || DEFAULT_EXTENSIONS);\n    }\n\n    if (features.includes('structured-input')) {\n        configWithDefaults.inputStructure = config.inputStructure || (defaults?.inputStructure || DEFAULT_INPUT_STRUCTURE);\n        configWithDefaults.inputFilenameOptions = config.inputFilenameOptions || (defaults?.inputFilenameOptions || DEFAULT_INPUT_FILENAME_OPTIONS);\n    }\n\n    return configWithDefaults as Config;\n}\n\n"],"names":["applyDefaults","config","features","defaults","configWithDefaults","timezone","DEFAULT_TIMEZONE","includes","recursive","undefined","DEFAULT_RECURSIVE","inputDirectory","DEFAULT_INPUT_DIRECTORY","concurrency","DEFAULT_CONCURRENCY","outputDirectory","DEFAULT_OUTPUT_DIRECTORY","outputStructure","DEFAULT_OUTPUT_STRUCTURE","outputFilenameOptions","DEFAULT_OUTPUT_FILENAME_OPTIONS","extensions","DEFAULT_EXTENSIONS","inputStructure","DEFAULT_INPUT_STRUCTURE","inputFilenameOptions","DEFAULT_INPUT_FILENAME_OPTIONS"],"mappings":"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"}
+{"version":3,"file":"defaults.js","sources":["../src/defaults.ts"],"sourcesContent":["import { Config } from './dreadcabinet';\nimport { DEFAULT_CONCURRENCY, DEFAULT_EXTENSIONS, DEFAULT_INPUT_DIRECTORY, DEFAULT_INPUT_FILENAME_OPTIONS, DEFAULT_INPUT_STRUCTURE, DEFAULT_OUTPUT_DIRECTORY, DEFAULT_OUTPUT_FILENAME_OPTIONS, DEFAULT_OUTPUT_STRUCTURE, DEFAULT_RECURSIVE, DEFAULT_TIMEZONE } from './constants';\nimport { DefaultOptions, Feature } from './dreadcabinet';\n\nexport const applyDefaults = (config: Partial<Config>, features: Feature[], defaults: DefaultOptions): Config => {\n    const configWithDefaults = {\n        ...config,\n    }\n\n    configWithDefaults.timezone = config.timezone || (defaults?.timezone || DEFAULT_TIMEZONE);\n    if (features.includes('input')) {\n        configWithDefaults.recursive = config.recursive === undefined ? (defaults?.recursive ?? DEFAULT_RECURSIVE) : config.recursive;\n        configWithDefaults.inputDirectory = config.inputDirectory || (defaults?.inputDirectory || DEFAULT_INPUT_DIRECTORY);\n        // Ensure concurrency is a valid positive integer, otherwise use default\n        if (config.concurrency === undefined || !Number.isInteger(config.concurrency) || config.concurrency < 1) {\n            configWithDefaults.concurrency = defaults?.concurrency || DEFAULT_CONCURRENCY;\n        } else {\n            configWithDefaults.concurrency = config.concurrency;\n        }\n    }\n    if (features.includes('output')) {\n        configWithDefaults.outputDirectory = config.outputDirectory || (defaults?.outputDirectory || DEFAULT_OUTPUT_DIRECTORY);\n    }\n    if (features.includes('structured-output')) {\n        configWithDefaults.outputStructure = config.outputStructure || (defaults?.outputStructure || DEFAULT_OUTPUT_STRUCTURE);\n        configWithDefaults.outputFilenameOptions = config.outputFilenameOptions || (defaults?.outputFilenameOptions || DEFAULT_OUTPUT_FILENAME_OPTIONS);\n    }\n    if (features.includes('extensions')) {\n        configWithDefaults.extensions = config.extensions || (defaults?.extensions || DEFAULT_EXTENSIONS);\n    }\n\n    if (features.includes('structured-input')) {\n        configWithDefaults.inputStructure = config.inputStructure || (defaults?.inputStructure || DEFAULT_INPUT_STRUCTURE);\n        configWithDefaults.inputFilenameOptions = config.inputFilenameOptions || (defaults?.inputFilenameOptions || DEFAULT_INPUT_FILENAME_OPTIONS);\n    }\n\n    return configWithDefaults as Config;\n}\n\n"],"names":["applyDefaults","config","features","defaults","configWithDefaults","timezone","DEFAULT_TIMEZONE","includes","recursive","undefined","DEFAULT_RECURSIVE","inputDirectory","DEFAULT_INPUT_DIRECTORY","concurrency","Number","isInteger","DEFAULT_CONCURRENCY","outputDirectory","DEFAULT_OUTPUT_DIRECTORY","outputStructure","DEFAULT_OUTPUT_STRUCTURE","outputFilenameOptions","DEFAULT_OUTPUT_FILENAME_OPTIONS","extensions","DEFAULT_EXTENSIONS","inputStructure","DEFAULT_INPUT_STRUCTURE","inputFilenameOptions","DEFAULT_INPUT_FILENAME_OPTIONS"],"mappings":"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"}

package/dist/dreadcabinet.cjs

@@ -156,7 +156,12 @@ const applyDefaults = (config, features, defaults)=>{
         var _ref;
         configWithDefaults.recursive = config.recursive === undefined ? (_ref = defaults === null || defaults === void 0 ? void 0 : defaults.recursive) !== null && _ref !== void 0 ? _ref : DEFAULT_RECURSIVE : config.recursive;
         configWithDefaults.inputDirectory = config.inputDirectory || (defaults === null || defaults === void 0 ? void 0 : defaults.inputDirectory) || DEFAULT_INPUT_DIRECTORY;
-        configWithDefaults.concurrency = config.concurrency || (defaults === null || defaults === void 0 ? void 0 : defaults.concurrency) || DEFAULT_CONCURRENCY;
+        // Ensure concurrency is a valid positive integer, otherwise use default
+        if (config.concurrency === undefined || !Number.isInteger(config.concurrency) || config.concurrency < 1) {
+            configWithDefaults.concurrency = (defaults === null || defaults === void 0 ? void 0 : defaults.concurrency) || DEFAULT_CONCURRENCY;
+        } else {
+            configWithDefaults.concurrency = config.concurrency;
+        }
     }
     if (features.includes('output')) {
         configWithDefaults.outputDirectory = config.outputDirectory || (defaults === null || defaults === void 0 ? void 0 : defaults.outputDirectory) || DEFAULT_OUTPUT_DIRECTORY;
@@ -183,7 +188,9 @@ const read = async (args, features)=>{
     config.timezone = args.timezone;
     if (features.includes('input')) {
         config.inputDirectory = args.inputDirectory;
+        config.recursive = args.recursive;
         config.limit = args.limit;
+        config.concurrency = args.concurrency;
     }
     if (features.includes('structured-input')) {
         config.inputStructure = args.inputStructure;
@@ -808,7 +815,7 @@ const create$5 = (parameters)=>{
     };
     const today = ()=>{
         // Return today's date formatted as YYYY-M-D in the specified timezone
-        return dayjs().tz(timezone).format('YYYY-M-D');
+        return dayjs().tz(timezone).format(DATE_FORMAT_YEAR_MONTH_DAY);
     };
     const date = (date)=>{
         let value;
@@ -974,27 +981,37 @@ const create$4 = (params)=>{
         pattern: '*.*'
     })=>{
         try {
-            let filesProcessed = 0;
+            // NOTE: glob loads all matching files into memory before processing.
+            // For directories with millions of files, this can cause out-of-memory errors.
+            // Consider using streaming glob or incremental processing for very large directories.
             const files = await glob.glob(options.pattern, {
                 cwd: directory,
                 nodir: true
             });
             const concurrency = options.concurrency || 1;
-            let index = 0;
+            const limit = options.limit || files.length;
+            // Use a queue-based approach to avoid race conditions
+            const fileQueue = files.slice(0, limit);
+            let filesProcessed = 0;
             async function worker() {
-                while(index < files.length && (!options.limit || filesProcessed < options.limit)){
-                    const i = index++;
-                    if (options.limit && filesProcessed >= options.limit) break;
-                    await callback(path__namespace.join(directory, files[i]));
+                while(fileQueue.length > 0 && filesProcessed < limit){
+                    // Atomically get next file from queue
+                    const file = fileQueue.shift();
+                    if (!file) break;
+                    await callback(path__namespace.join(directory, file));
+                    // Atomically increment counter
                     filesProcessed++;
+                    if (filesProcessed >= limit) {
+                        break;
+                    }
                 }
             }
             const workers = Array.from({
                 length: concurrency
             }, ()=>worker());
             await Promise.all(workers);
-            if (options.limit && filesProcessed >= options.limit) {
-                log(`Reached limit of ${options.limit} files, stopping`);
+            if (filesProcessed >= limit) {
+                log(`Reached limit of ${limit} files, stopping`);
             }
         } catch (err) {
             throw new Error(`Failed to glob pattern ${options.pattern} in ${directory}: ${err.message}`);
@@ -1030,15 +1047,10 @@ const create$4 = (params)=>{
 };
 
 const validate = async (config, options)=>{
-    const logger = console;
     const storage = create$4({
-        log: logger.debug
+        log: options.logger.debug
     });
     const validateInputDirectory = async (inputDirectory)=>{
-        // eslint-disable-next-line no-console
-        const storage = create$4({
-            log: console.log
-        });
         if (!storage.isDirectoryReadable(inputDirectory)) {
             throw new Error(`Input directory does not exist: ${inputDirectory}`);
         }
@@ -1057,7 +1069,7 @@ const validate = async (config, options)=>{
         }
     };
     const validateOutputFilenameOptions = (outputFilenameOptions, outputStructure)=>{
-        if (outputFilenameOptions) {
+        if (outputFilenameOptions && outputFilenameOptions.length > 0) {
             var _options_allowed;
             // Check if first argument contains commas - likely a comma-separated list
             if (outputFilenameOptions[0].includes(',')) {
@@ -1088,7 +1100,7 @@ const validate = async (config, options)=>{
         }
     };
     const validateInputFilenameOptions = (inputFilenameOptions, inputStructure)=>{
-        if (inputFilenameOptions) {
+        if (inputFilenameOptions && inputFilenameOptions.length > 0) {
             var _options_allowed;
             // Check if first argument contains commas - likely a comma-separated list
             if (inputFilenameOptions[0].includes(',')) {
@@ -1138,6 +1150,11 @@ const validate = async (config, options)=>{
             throw new ArgumentError('--limit', 'Limit must be greater than 0');
         }
     }
+    if (options.features.includes('input') && config.concurrency !== undefined) {
+        if (!Number.isInteger(config.concurrency) || config.concurrency < 1) {
+            throw new ArgumentError('--concurrency', 'Concurrency must be a positive integer');
+        }
+    }
     if (options.features.includes('output') && config.outputDirectory) {
         await validateOutputDirectory(config.outputDirectory);
     }
@@ -1188,7 +1205,7 @@ const getFilePattern = (features, extensions, logger)=>{
 };
 // Helper function to parse date string based on expected format
 // Returns null if parsing fails
-const parseDateFromString = (dateStr, format, shouldParseTime, year, month, day)=>{
+const parseDateFromString = (dateStr, format, shouldParseTime, timezone, year, month, day)=>{
     // Basic validation
     if (!dateStr) return null;
     try {
@@ -1270,11 +1287,41 @@ const parseDateFromString = (dateStr, format, shouldParseTime, year, month, day)
         if (mo < 0 || mo > 11 || d < 1 || d > 31 || h < 0 || h > 23 || mi < 0 || mi > 59) {
             throw new Error(`Invalid date components in date string "${dateStr}" with format ${format}: Y:${y} M:${mo + 1} D:${d} H:${h} m:${mi}`);
         }
-        const date = new Date(Date.UTC(y, mo, d, h, mi));
-        // Double check components as Date object might adjust invalid dates (e.g. Feb 30th -> Mar 2nd)
-        if (date.getUTCFullYear() !== y || date.getUTCMonth() !== mo || date.getUTCDate() !== d || date.getUTCHours() !== h || date.getUTCMinutes() !== mi) {
-            // console.debug(`Date validation failed for Y:${y} M:${mo} D:${d} H:${h} m:${mi}. JS Date adjusted it.`);
-            return null;
+        // Create timezone-aware date
+        // For UTC timezone, use Date.UTC for efficiency and exact matching
+        // For other timezones, use timezone-aware parsing
+        let date;
+        if (timezone === 'UTC' || timezone === 'Etc/UTC') {
+            date = new Date(Date.UTC(y, mo, d, h, mi));
+            // Validate that Date didn't adjust invalid dates (e.g., Feb 30 -> Mar 2)
+            if (date.getUTCFullYear() !== y || date.getUTCMonth() !== mo || date.getUTCDate() !== d || date.getUTCHours() !== h || date.getUTCMinutes() !== mi) {
+                return null;
+            }
+        } else {
+            // Use timezone-aware parsing for non-UTC timezones
+            const dates = create$5({
+                timezone
+            });
+            const monthStr = String(mo + 1).padStart(2, '0');
+            const dayStr = String(d).padStart(2, '0');
+            const hourStr = String(h).padStart(2, '0');
+            const minuteStr = String(mi).padStart(2, '0');
+            const dateStrFormatted = `${y}-${monthStr}-${dayStr}T${hourStr}:${minuteStr}:00`;
+            try {
+                date = dates.date(dateStrFormatted);
+                // Validate that the date components match in the timezone context
+                const formattedYear = parseInt(dates.format(date, 'YYYY'), 10);
+                const formattedMonth = parseInt(dates.format(date, 'M'), 10);
+                const formattedDay = parseInt(dates.format(date, 'D'), 10);
+                const formattedHour = parseInt(dates.format(date, 'H'), 10);
+                const formattedMinute = parseInt(dates.format(date, 'm'), 10);
+                // Check if date was adjusted (e.g., Feb 30 -> Mar 2)
+                if (formattedYear !== y || formattedMonth !== mo + 1 || formattedDay !== d || formattedHour !== h || formattedMinute !== mi) {
+                    return null;
+                }
+            } catch  {
+                return null;
+            }
         }
         return date;
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
@@ -1332,7 +1379,7 @@ const calculateDateRange = (timezone, startDate, endDate)=>{
     return range;
 };
 // Parse date from file path based on the input structure
-const parseDateFromFilePath = (relativePath, filename, structure, shouldParseTime, logger)=>{
+const parseDateFromFilePath = (relativePath, filename, structure, shouldParseTime, timezone, logger)=>{
     const pathParts = relativePath.split(path__namespace.sep);
     const filenameWithoutExt = path__namespace.basename(filename, path__namespace.extname(filename));
     let parsedDate = null;
@@ -1342,14 +1389,14 @@ const parseDateFromFilePath = (relativePath, filename, structure, shouldParseTim
     switch(structure){
         case 'none':
             // Filename format: YYYY-M-D-HHmm...
-            parsedDate = parseDateFromString(filenameWithoutExt, 'YYYY-M-D-HHmm', shouldParseTime);
+            parsedDate = parseDateFromString(filenameWithoutExt, 'YYYY-M-D-HHmm', shouldParseTime, timezone);
             break;
         case 'year':
             // Path: YYYY / M-D-HHmm...
             if (pathParts.length >= 1) {
                 year = parseInt(pathParts[0], 10);
                 if (!isNaN(year)) {
-                    parsedDate = parseDateFromString(filenameWithoutExt, 'M-D-HHmm', shouldParseTime, year);
+                    parsedDate = parseDateFromString(filenameWithoutExt, 'M-D-HHmm', shouldParseTime, timezone, year);
                 } else {
                     logger.warn(`Invalid year format in path: ${pathParts[0]}`);
                 }
@@ -1364,7 +1411,7 @@ const parseDateFromFilePath = (relativePath, filename, structure, shouldParseTim
                 const monthDir = parseInt(pathParts[1], 10); // Month from dir (1-indexed)
                 if (!isNaN(year) && !isNaN(monthDir) && monthDir >= 1 && monthDir <= 12) {
                     month = monthDir - 1; // Adjust month for Date object (0-indexed)
-                    parsedDate = parseDateFromString(filenameWithoutExt, 'D-HHmm', shouldParseTime, year, month);
+                    parsedDate = parseDateFromString(filenameWithoutExt, 'D-HHmm', shouldParseTime, timezone, year, month);
                 } else {
                     logger.warn(`Invalid year/month format in path: ${pathParts[0]}/${pathParts[1]}`);
                 }
@@ -1380,7 +1427,7 @@ const parseDateFromFilePath = (relativePath, filename, structure, shouldParseTim
                 day = parseInt(pathParts[2], 10); // Day from dir (1-indexed)
                 if (!isNaN(year) && !isNaN(monthDir) && monthDir >= 1 && monthDir <= 12 && !isNaN(day) && day >= 1 && day <= 31) {
                     month = monthDir - 1; // Adjust month (0-indexed)
-                    parsedDate = parseDateFromString(filenameWithoutExt, 'HHmm', shouldParseTime, year, month, day);
+                    parsedDate = parseDateFromString(filenameWithoutExt, 'HHmm', shouldParseTime, timezone, year, month, day);
                 } else {
                     logger.warn(`Invalid year/month/day format in path: ${pathParts[0]}/${pathParts[1]}/${pathParts[2]}`);
                 }
@@ -1395,7 +1442,7 @@ const parseDateFromFilePath = (relativePath, filename, structure, shouldParseTim
     return parsedDate;
 };
 // Process a single file from the structured input
-const processStructuredFile = async (filePath, inputDirectory, structure, shouldParseTime, callback, pattern, dateRange, logger)=>{
+const processStructuredFile = async (filePath, inputDirectory, structure, shouldParseTime, timezone, callback, pattern, dateRange, logger)=>{
     // Skip if filePath somehow points to the inputDirectory itself or is not a file
     if (filePath === inputDirectory || !path__namespace.extname(filePath) && pattern.endsWith('*.*')) {
         return false;
@@ -1408,7 +1455,7 @@ const processStructuredFile = async (filePath, inputDirectory, structure, should
         return false;
     }
     try {
-        const parsedDate = parseDateFromFilePath(relativePath, filename, structure, shouldParseTime, logger);
+        const parsedDate = parseDateFromFilePath(relativePath, filename, structure, shouldParseTime, timezone, logger);
         if (parsedDate) {
             // Apply date range filtering
             if (isDateInRange(parsedDate, dateRange)) {
@@ -1441,10 +1488,10 @@ const process$2 = async (inputStructure, inputFilenameOptions, extensions, timez
     let fileCount = 0;
     // Validate date range dates if provided
     if ((dateRange === null || dateRange === void 0 ? void 0 : dateRange.start) && (!dateRange.start || isNaN(dateRange.start.getTime()))) {
-        logger.warn(`Invalid start date provided in dateRange: ${dateRange.start}`);
+        throw new Error(`Invalid start date provided in dateRange: ${dateRange.start}`);
     }
     if ((dateRange === null || dateRange === void 0 ? void 0 : dateRange.end) && (!dateRange.end || isNaN(dateRange.end.getTime()))) {
-        logger.warn(`Invalid end date provided in dateRange: ${dateRange.end}`);
+        throw new Error(`Invalid end date provided in dateRange: ${dateRange.end}`);
     }
     // Structured Input Logic
     const structure = inputStructure !== null && inputStructure !== void 0 ? inputStructure : 'none'; // Default to 'none' if not specified
@@ -1459,7 +1506,7 @@ const process$2 = async (inputStructure, inputFilenameOptions, extensions, timez
     const filePattern = getFilePattern(features, extensions || [], logger);
     logger.debug('Processing Structured Input with pattern %s from %s', filePattern, inputDirectory);
     await storage.forEachFileIn(inputDirectory, async (filePath)=>{
-        const processed = await processStructuredFile(filePath, inputDirectory, structure, shouldParseTime, callback, filePattern, dateRange, logger);
+        const processed = await processStructuredFile(filePath, inputDirectory, structure, shouldParseTime, timezone, callback, filePattern, dateRange, logger);
         if (processed) {
             fileCount++;
         }
@@ -1578,8 +1625,9 @@ const create$2 = (config, options)=>{
         }
     }
     function sanitizeFilenameString(str) {
-        // Replace any character that is not alphanumeric, hyphen, underscore, or dot with an underscore
-        return str.replace(/[^a-zA-Z0-9\-_.]/g, '_')// Replace multiple consecutive underscores with a single underscore
+        // Replace any character that is not alphanumeric (including unicode), hyphen, underscore, or dot with an underscore
+        // Use \p{L} for unicode letters and \p{N} for unicode numbers
+        return str.replace(/[^\p{L}\p{N}\-_.]/gu, '_')// Replace multiple consecutive underscores with a single underscore
         .replace(/_+/g, '_')// Remove leading and trailing underscores
         .replace(/^_+|_+$/g, '')// Ensure the string is not empty
         .replace(/^$/, 'untitled');
@@ -1609,7 +1657,7 @@ const create$2 = (config, options)=>{
         }
         return parts.join('-');
     }
-    function constructOutputDirectory(creationTime) {
+    async function constructOutputDirectory(creationTime) {
         // Throw this error to ensure that we don't success if outputDirectory or outputStructure are not set
         if (!outputDirectory) {
             throw new Error('Unable to Create Output: Output directory is not set');
@@ -1635,7 +1683,7 @@ const create$2 = (config, options)=>{
             default:
                 outputPath = outputDirectory;
         }
-        storage.createDirectory(outputPath);
+        await storage.createDirectory(outputPath);
         return outputPath;
     }
     return {