@nuasite/cms-marker 0.0.53 → 0.0.54

package/src/utils.ts

@@ -0,0 +1,99 @@
+import { createHash } from 'node:crypto'
+import type { ManifestEntry, SourceContext } from './types'
+
+/**
+ * Generate a SHA256 hash of the given content
+ */
+export function sha256(content: string): string {
+	return createHash('sha256').update(content, 'utf8').digest('hex')
+}
+
+/**
+ * Generate a short hash (first 12 characters of SHA256)
+ * Used for stableId to keep it reasonably short but still unique
+ */
+export function shortHash(content: string): string {
+	return sha256(content).substring(0, 12)
+}
+
+/**
+ * Generate a stable ID for an element based on its content and context.
+ * This ID survives rebuilds as long as the content and structure remain similar.
+ *
+ * Components:
+ * - tag name
+ * - first 50 chars of text content
+ * - source path (if available)
+ * - parent tag
+ * - sibling index
+ */
+export function generateStableId(
+	tag: string,
+	text: string,
+	sourcePath?: string,
+	context?: SourceContext,
+): string {
+	const components = [
+		tag,
+		text.substring(0, 50).trim(),
+		sourcePath || '',
+		context?.parentTag || '',
+		context?.siblingIndex?.toString() || '',
+	]
+
+	return shortHash(components.join('|'))
+}
+
+/**
+ * Generate a hash of the source snippet for conflict detection.
+ * If the source file changes, this hash will differ from what's stored in manifest.
+ */
+export function generateSourceHash(sourceSnippet: string): string {
+	return sha256(sourceSnippet)
+}
+
+/**
+ * Generate a content hash for the entire manifest (all entries).
+ * Used for quick drift detection without comparing individual entries.
+ */
+export function generateManifestContentHash(entries: Record<string, ManifestEntry>): string {
+	// Sort keys for deterministic hashing
+	const sortedKeys = Object.keys(entries).sort()
+	const content = sortedKeys.map(key => {
+		const entry = entries[key]!
+		// Hash only content-relevant fields, not generated IDs
+		return `${entry.tag}|${entry.text}|${entry.html || ''}|${entry.sourcePath || ''}`
+	}).join('\n')
+
+	return sha256(content)
+}
+
+/**
+ * Generate per-source-file hashes for granular conflict detection.
+ * Maps source file path -> hash of all entries from that file.
+ */
+export function generateSourceFileHashes(entries: Record<string, ManifestEntry>): Record<string, string> {
+	// Group entries by source file
+	const entriesByFile: Record<string, ManifestEntry[]> = {}
+
+	for (const entry of Object.values(entries)) {
+		const sourcePath = entry.sourcePath
+		if (sourcePath) {
+			if (!entriesByFile[sourcePath]) {
+				entriesByFile[sourcePath] = []
+			}
+			entriesByFile[sourcePath].push(entry)
+		}
+	}
+
+	// Generate hash for each file
+	const hashes: Record<string, string> = {}
+	for (const [filePath, fileEntries] of Object.entries(entriesByFile)) {
+		// Sort entries by line number for determinism
+		const sorted = fileEntries.sort((a, b) => (a.sourceLine || 0) - (b.sourceLine || 0))
+		const content = sorted.map(e => `${e.sourceLine || 0}|${e.text}|${e.sourceSnippet || ''}`).join('\n')
+		hashes[filePath] = sha256(content)
+	}
+
+	return hashes
+}