Function generateTaskFilename

src/utils/filenameGenerator.ts:132–191

(
	context: FilenameContext,
	settings: TaskFilenameSettings
)

 * Generates a filename based on the configured format and context
 */
export function generateTaskFilename(
	context: FilenameContext,
	settings: TaskFilenameSettings
): string {
	// Validate inputs
	if (!context || !settings) {
		throw new Error("Invalid context or settings provided");
	}

	if (!context.title || typeof context.title !== "string") {
		throw new Error("Context must have a valid title");
	}

	// Validate title content
	if (context.title.trim().length === 0) {
		throw new Error("Title cannot be empty");
	}

	const now = context.date || new Date();

	// Validate date
	if (!(now instanceof Date) || isNaN(now.getTime())) {
		throw new Error("Invalid date provided in context");
	}

	if (settings.storeTitleInFilename) {
		return sanitizeForFilename(context.title);
	}

	try {
		switch (settings.taskFilenameFormat) {
			case "title":
				return sanitizeForFilename(context.title);

			case "zettel":
				return generateZettelId(now);

			case "timestamp":
				return generateTimestampFilename(now);

			case "uuid":
				return generateUUIDFilename();

			case "custom":
				return generateCustomFilename(context, settings.customFilenameTemplate, now);

			default:
				// Fallback to zettel format
				return generateZettelId(now);
		}
	} catch (error) {
		tasknotesLogger.error("Error generating filename:", {
			category: "persistence",
			operation: "generating-filename",
			error: error,
		});
		// Fallback to safe zettel format
		return generateZettelId(now);