Function ensureFolderExists

src/utils/helpers.ts:74–118

(vault: Vault, folderPath: string)

 * Ensures a folder and its parent folders exist
 */
export async function ensureFolderExists(vault: Vault, folderPath: string): Promise<void> {
	try {
		const normalizedFolderPath = normalizePath(folderPath);
		const folders = normalizedFolderPath.split("/").filter((folder) => folder.length > 0);
		let currentPath = "";

		for (const folder of folders) {
			currentPath = currentPath ? `${currentPath}/${folder}` : folder;

			// Check on-disk existence via adapter rather than the in-memory
			// vault cache, which can be stale during startup or after external
			// filesystem changes.
			if (await vault.adapter.exists(currentPath)) {
				continue;
			}

			try {
				await vault.createFolder(currentPath);
			} catch {
				// Race condition: another call may have created the folder
				// between our exists check and createFolder.  Only re-throw
				// if the folder genuinely doesn't exist.
				if (!(await vault.adapter.exists(currentPath))) {
					throw new Error(`Failed to create folder "${currentPath}"`);
				}
			}
		}
	} catch (error) {
		const errorMessage = error instanceof Error ? error.message : String(error);
		const stack = error instanceof Error ? error.stack : undefined;
		tasknotesLogger.error("Error creating folder structure:", {
			category: "internal",
			operation: "creating-folder-structure",
			details: { stack, folderPath, normalizedPath: normalizePath(folderPath) },
			error: errorMessage,
		});

		// Create enhanced error with preserved context
		const enhancedError = new Error(`Failed to create folder "${folderPath}": ${errorMessage}`);
		if (stack) {
			enhancedError.stack = stack;
		}
		throw enhancedError;
	}
}

/**
 * Calculate duration in minutes between two ISO timestamp strings