Incorporate downloading template HTML file from GitHub

Author: zachmueller

manifest.json

@@ -1,7 +1,7 @@
 {
 	"id": "commonplace-notes",
 	"name": "Commonplace Notes",
-	"version": "0.1.15",
+	"version": "0.1.16",
 	"minAppVersion": "1.0.0",
 	"description": "Publish your notes with sliding panes and link to others notes",
 	"author": "Zach Mueller",

src/main.ts

@@ -17,6 +17,7 @@ import { FrontmatterManager } from './utils/frontmatter';
 import { ContentIndexManager } from './utils/contentIndex';
 import { MappingManager } from './utils/mappings';
 import { NoticeManager } from './utils/notice';
+import { TemplateManager } from './utils/templateManager';
 import { Publisher } from './publish/publisher';
 import { Logger } from './utils/logging';
 
@@ -70,6 +71,7 @@ export default class CommonplaceNotesPlugin extends Plugin {
 	frontmatterManager: FrontmatterManager;
 	contentIndexManager: ContentIndexManager;
 	mappingManager: MappingManager;
+	templateManager: TemplateManager;
 	publisher: Publisher;
 
 	async onload() {
@@ -85,6 +87,7 @@ export default class CommonplaceNotesPlugin extends Plugin {
 		this.contentIndexManager = new ContentIndexManager(this);
 		this.mappingManager = new MappingManager(this);
 		this.publisher = new Publisher(this);
+		this.templateManager = new TemplateManager(this);
 
 		// Initialize indicator updates
 		// Targeted indicator refresh upon file open events

src/publish/local.ts

@@ -9,6 +9,12 @@ export async function publishLocalNotes(
 	profileId: string
 ): Promise<boolean> {
 	try {
+		// Ensure template exists before proceeding
+		const templateReady = await plugin.templateManager.ensureLocalTemplate();
+		if (!templateReady) {
+			throw new Error('Could not prepare template file');
+		}
+
 		const profile = plugin.settings.publishingProfiles.find(p => p.id === profileId);
 
 		if (!profile) {

src/utils/templateManager.ts

@@ -0,0 +1,65 @@
+import CommonplaceNotesPlugin from '../main';
+import { Logger } from './logging';
+import { PathUtils } from './path';
+import { NoticeManager } from './notice';
+
+export class TemplateManager {
+	private plugin: CommonplaceNotesPlugin;
+	private readonly DEFAULT_TEMPLATE_URL = 'https://raw.githubusercontent.com/zachmueller/commonplace-notes/main/templates/local-template.html';
+
+	constructor(plugin: CommonplaceNotesPlugin) {
+		this.plugin = plugin;
+	}
+
+	async ensureLocalTemplate(): Promise<boolean> {
+		const templatePath = this.plugin.profileManager.getLocalTemplateHtmlPath();
+
+		// Check if template already exists
+		if (await this.plugin.app.vault.adapter.exists(templatePath)) {
+			Logger.debug('Local template file already exists');
+			return true;
+		}
+
+		// Try to download default template
+		Logger.info('Local template not found, attempting to download default template from GitHub');
+
+		try {
+			const { success, error } = await NoticeManager.showProgress(
+				'Downloading default template from GitHub',
+				this.downloadDefaultTemplate(templatePath),
+				'Successfully downloaded default template',
+				'Failed to download template from GitHub'
+			);
+
+			return success;
+		} catch (error) {
+			Logger.error('Failed to download default template:', error);
+			NoticeManager.showNotice('Failed to download HTML template.');
+			return false;
+		}
+	}
+
+	private async downloadDefaultTemplate(templatePath: string): Promise<void> {
+		// Ensure template directory exists
+		const templateDir = this.plugin.profileManager.getTemplateDir();
+		await PathUtils.ensureDirectory(this.plugin, templateDir);
+
+		// Download the template
+		const response = await fetch(this.DEFAULT_TEMPLATE_URL);
+
+		if (!response.ok) {
+			throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+		}
+
+		const templateContent = await response.text();
+
+		// Validate that it looks like an HTML template
+		if (!templateContent.includes('{{NOTES_JSON}}')) {
+			throw new Error('Downloaded file does not appear to be a valid template');
+		}
+
+		// Write to local file
+		await this.plugin.app.vault.adapter.write(templatePath, templateContent);
+		Logger.info(`Downloaded default template to ${templatePath}`);
+	}
+}