scribe-cms 0.0.4 → 0.0.6

package/dist/index.cjs

@@ -139,14 +139,14 @@ var SLUG_PLACEHOLDER = "{slug}";
 function isRoutableType(type) {
   return typeof type.path === "string" && type.path.length > 0;
 }
-function assertValidPathTemplate(path10, typeId) {
-  if (!path10.startsWith("/")) {
-    throw new Error(`Content type "${typeId}": path must start with / (got "${path10}")`);
+function assertValidPathTemplate(path11, typeId) {
+  if (!path11.startsWith("/")) {
+    throw new Error(`Content type "${typeId}": path must start with / (got "${path11}")`);
   }
-  const count = (path10.match(/\{slug\}/g) ?? []).length;
+  const count = (path11.match(/\{slug\}/g) ?? []).length;
   if (count !== 1) {
     throw new Error(
-      `Content type "${typeId}": path must contain exactly one {slug} (got "${path10}")`
+      `Content type "${typeId}": path must contain exactly one {slug} (got "${path11}")`
     );
   }
 }
@@ -198,6 +198,7 @@ function resolveConfig(input, baseDir) {
   const projectRoot = path3__default.default.resolve(baseDir ?? process.cwd(), raw.rootDir);
   const contentRoot = path3__default.default.resolve(projectRoot, raw.contentDir ?? "content");
   const storePath = path3__default.default.resolve(projectRoot, raw.store ?? ".scribe/store.sqlite");
+  const assetsPath = raw.assetsDir ? path3__default.default.resolve(projectRoot, raw.assetsDir) : void 0;
   const seenIds = /* @__PURE__ */ new Set();
   const types = raw.types.map((type) => {
     if (seenIds.has(type.id)) {
@@ -218,6 +219,7 @@ function resolveConfig(input, baseDir) {
   const config = {
     rootDir: contentRoot,
     storePath,
+    assetsPath,
     locales: [...raw.locales],
     defaultLocale,
     localePresets: raw.localePresets,
@@ -270,10 +272,10 @@ function introspectSchema(schema, prefix = []) {
 }
 function extractByPaths(data, paths) {
   const out = {};
-  for (const path10 of paths) {
-    const value = getAtPath(data, path10);
+  for (const path11 of paths) {
+    const value = getAtPath(data, path11);
     if (value !== void 0) {
-      setAtPath(out, path10.filter((p) => p !== "*"), value);
+      setAtPath(out, path11.filter((p) => p !== "*"), value);
     }
   }
   return out;
@@ -291,13 +293,13 @@ function mergeStructuralOntoLocale(localeData, enData, schema) {
   const translatable = pickTranslatable(localeData, schema);
   return deepMerge(structural, translatable);
 }
-function getAtPath(obj, path10) {
+function getAtPath(obj, path11) {
   let current = obj;
-  for (const segment of path10) {
+  for (const segment of path11) {
     if (segment === "*") {
       if (!Array.isArray(current)) return void 0;
       return current.map(
-        (item) => typeof item === "object" && item !== null ? getAtPath(item, path10.slice(path10.indexOf("*") + 1)) : void 0
+        (item) => typeof item === "object" && item !== null ? getAtPath(item, path11.slice(path11.indexOf("*") + 1)) : void 0
       );
     }
     if (typeof current !== "object" || current === null || Array.isArray(current)) return void 0;
@@ -305,13 +307,13 @@ function getAtPath(obj, path10) {
   }
   return current;
 }
-function setAtPath(obj, path10, value) {
-  if (path10.length === 0) return;
-  if (path10.length === 1) {
-    obj[path10[0]] = value;
+function setAtPath(obj, path11, value) {
+  if (path11.length === 0) return;
+  if (path11.length === 1) {
+    obj[path11[0]] = value;
     return;
   }
-  const [head, ...rest] = path10;
+  const [head, ...rest] = path11;
   if (!(head in obj) || typeof obj[head] !== "object" || obj[head] === null) {
     obj[head] = {};
   }
@@ -507,7 +509,7 @@ function seoFieldsFromEn(enDoc) {
     redirectTo: enDoc.redirectTo
   };
 }
-var SCHEMA_VERSION = 3;
+var SCHEMA_VERSION = 4;
 var MIGRATIONS = [
   `CREATE TABLE IF NOT EXISTS meta (
     key TEXT PRIMARY KEY,
@@ -527,20 +529,6 @@ var MIGRATIONS = [
   )`,
   `CREATE INDEX IF NOT EXISTS idx_translations_type_locale
     ON translations(content_type, locale)`,
-  `CREATE TABLE IF NOT EXISTS revisions (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    content_type TEXT NOT NULL,
-    en_slug TEXT NOT NULL,
-    locale TEXT,
-    revision_kind TEXT NOT NULL,
-    en_hash TEXT NOT NULL,
-    body_hash TEXT NOT NULL,
-    created_at TEXT NOT NULL,
-    model TEXT,
-    body_preview TEXT
-  )`,
-  `CREATE INDEX IF NOT EXISTS idx_revisions_lookup
-    ON revisions(content_type, en_slug, locale, created_at DESC)`,
   `CREATE TABLE IF NOT EXISTS slug_aliases (
     content_type TEXT NOT NULL,
     canonical_en_slug TEXT NOT NULL,
@@ -557,7 +545,19 @@ var MIGRATIONS = [
     locale_slug TEXT NOT NULL,
     captured_at TEXT NOT NULL,
     PRIMARY KEY (content_type, alias_en_slug, locale)
-  )`
+  )`,
+  `CREATE TABLE IF NOT EXISTS en_snapshots (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    content_type TEXT NOT NULL,
+    en_slug TEXT NOT NULL,
+    en_hash TEXT NOT NULL,
+    frontmatter_json TEXT NOT NULL,
+    body TEXT NOT NULL,
+    created_at TEXT NOT NULL,
+    UNIQUE (content_type, en_slug, en_hash)
+  )`,
+  `CREATE INDEX IF NOT EXISTS idx_en_snapshots_lookup
+    ON en_snapshots(content_type, en_slug, created_at DESC)`
 ];
 function resolveStorePath(config) {
   return config.storePath;
@@ -579,12 +579,19 @@ function addColumnIfMissing(db, table, column, ddlType) {
     db.exec(`ALTER TABLE ${table} ADD COLUMN ${column} ${ddlType}`);
   }
 }
+function readSchemaVersion(db) {
+  const row = db.prepare(`SELECT value FROM meta WHERE key = 'schema_version'`).get();
+  return row ? Number.parseInt(row.value, 10) || 0 : 0;
+}
 function migrate(db) {
+  const previousVersion = readSchemaVersion(db);
   for (const sql of MIGRATIONS) {
     db.exec(sql);
   }
-  addColumnIfMissing(db, "revisions", "frontmatter_json", "TEXT");
-  addColumnIfMissing(db, "revisions", "body", "TEXT");
+  if (previousVersion < 4) {
+    db.exec(`DROP TABLE IF EXISTS revisions`);
+  }
+  addColumnIfMissing(db, "translations", "snapshot_id", "INTEGER");
   db.prepare(
     `INSERT INTO meta(key, value) VALUES('schema_version', ?)
      ON CONFLICT(key) DO UPDATE SET value = excluded.value`
@@ -592,18 +599,38 @@ function migrate(db) {
 }
 
 // src/storage/translations.ts
+function getOrCreateEnSnapshot(db, input) {
+  db.prepare(
+    `INSERT OR IGNORE INTO en_snapshots (
+      content_type, en_slug, en_hash, frontmatter_json, body, created_at
+    ) VALUES (?, ?, ?, ?, ?, ?)`
+  ).run(
+    input.contentType,
+    input.enSlug,
+    input.enHash,
+    JSON.stringify(input.frontmatter),
+    input.body,
+    input.createdAt
+  );
+  const row = db.prepare(
+    `SELECT id FROM en_snapshots
+       WHERE content_type = ? AND en_slug = ? AND en_hash = ?`
+  ).get(input.contentType, input.enSlug, input.enHash);
+  return row.id;
+}
 function upsertTranslation(db, input) {
   db.prepare(
     `INSERT INTO translations (
-      content_type, en_slug, locale, slug, frontmatter_json, body, en_hash, translated_at, model
-    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      content_type, en_slug, locale, slug, frontmatter_json, body, en_hash, translated_at, model, snapshot_id
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     ON CONFLICT(content_type, en_slug, locale) DO UPDATE SET
       slug = excluded.slug,
       frontmatter_json = excluded.frontmatter_json,
       body = excluded.body,
       en_hash = excluded.en_hash,
       translated_at = excluded.translated_at,
-      model = excluded.model`
+      model = excluded.model,
+      snapshot_id = excluded.snapshot_id`
   ).run(
     input.contentType,
     input.enSlug,
@@ -613,7 +640,8 @@ function upsertTranslation(db, input) {
     input.body,
     input.enHash,
     input.translatedAt,
-    input.model
+    input.model,
+    input.snapshotId
   );
 }
 function getTranslation(db, contentType, enSlug, locale) {
@@ -632,27 +660,6 @@ function listTranslationsForEnSlug(db, contentType, enSlug) {
 function bulkLoadTranslations(db) {
   return db.prepare(`SELECT * FROM translations ORDER BY content_type, en_slug, locale`).all();
 }
-function appendRevision(db, input) {
-  const result = db.prepare(
-    `INSERT INTO revisions (
-        content_type, en_slug, locale, revision_kind, en_hash, body_hash, created_at,
-        model, body_preview, frontmatter_json, body
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
-  ).run(
-    input.contentType,
-    input.enSlug,
-    input.locale,
-    input.revisionKind,
-    input.enHash,
-    input.bodyHash,
-    input.createdAt,
-    input.model ?? null,
-    input.bodyPreview ?? null,
-    input.frontmatterJson ?? null,
-    input.body ?? null
-  );
-  return Number(result.lastInsertRowid);
-}
 
 // src/loader/normalize-en.ts
 function normalizeEnFrontmatter(data) {
@@ -1582,8 +1589,8 @@ function getRedirectSourceSlugs(project) {
 // src/sitemap/join-base-url.ts
 function joinBaseUrl(baseUrl, pathname) {
   const origin = baseUrl.replace(/\/$/, "");
-  const path10 = pathname.startsWith("/") ? pathname : `/${pathname}`;
-  return `${origin}${path10}`;
+  const path11 = pathname.startsWith("/") ? pathname : `/${pathname}`;
+  return `${origin}${path11}`;
 }
 
 // src/sitemap/generate-sitemap.ts
@@ -1727,36 +1734,6 @@ function loadConfigSync(options = {}) {
   }
   return resolveConfig(config, path3__default.default.dirname(configPath));
 }
-function sha256(input) {
-  return crypto.createHash("sha256").update(input, "utf8").digest("hex");
-}
-function computePageEnHash(translatableFrontmatter, body) {
-  const payload = JSON.stringify({ frontmatter: translatableFrontmatter, body });
-  return sha256(payload);
-}
-function computeBodyHash(body) {
-  return sha256(body);
-}
-
-// src/history/record-revision.ts
-function recordRevision(config, input) {
-  const db = openStore(config, "readwrite");
-  const id = appendRevision(db, {
-    contentType: input.contentType,
-    enSlug: input.enSlug,
-    locale: input.locale,
-    revisionKind: input.revisionKind,
-    enHash: input.enHash,
-    bodyHash: computeBodyHash(input.body),
-    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-    model: input.model,
-    bodyPreview: input.body.slice(0, 200),
-    frontmatterJson: input.frontmatter ? JSON.stringify(input.frontmatter) : null,
-    body: input.body
-  });
-  db.close();
-  return id;
-}
 function getAtPath2(obj, fieldPath) {
   let current = obj;
   for (const segment of fieldPath) {
@@ -1836,6 +1813,72 @@ function validateRelations(project) {
   }
   return issues;
 }
+var IMAGE_EXT = String.raw`(?:png|jpe?g|webp|gif|svg)`;
+var IMAGE_WEB_PATH = String.raw`\/[\w\-./]+\.${IMAGE_EXT}`;
+var MARKDOWN_IMAGE_RE = new RegExp(
+  String.raw`!\[[^\]]*\]\((${IMAGE_WEB_PATH})\)`,
+  "gi"
+);
+var HTML_SRC_RE = new RegExp(String.raw`src=["'](${IMAGE_WEB_PATH})["']`, "gi");
+function isImageWebPath(value) {
+  return new RegExp(String.raw`^${IMAGE_WEB_PATH}$`, "i").test(value);
+}
+function isSiteAssetPath(webPath) {
+  const segment = webPath.split("/")[1];
+  return Boolean(segment && !segment.includes("."));
+}
+function addImagePath(webPath, out) {
+  if (isSiteAssetPath(webPath)) out.add(webPath);
+}
+function collectBodyImagePaths(body, out) {
+  for (const re of [MARKDOWN_IMAGE_RE, HTML_SRC_RE]) {
+    for (const match of body.matchAll(re)) {
+      addImagePath(match[1], out);
+    }
+  }
+}
+function collectFrontmatterImagePaths(value, out) {
+  if (typeof value === "string") {
+    if (isImageWebPath(value)) addImagePath(value, out);
+    return;
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) collectFrontmatterImagePaths(item, out);
+    return;
+  }
+  if (value && typeof value === "object") {
+    for (const nested of Object.values(value)) {
+      collectFrontmatterImagePaths(nested, out);
+    }
+  }
+}
+function collectImagePaths(frontmatter, body) {
+  const paths = /* @__PURE__ */ new Set();
+  collectFrontmatterImagePaths(frontmatter, paths);
+  collectBodyImagePaths(body, paths);
+  return [...paths].sort();
+}
+function assetFilePath(assetsPath, webPath) {
+  return path3__default.default.join(assetsPath, webPath.replace(/^\//, ""));
+}
+function validateDocumentAssets(config, input) {
+  const assetsPath = config.assetsPath;
+  if (!assetsPath) return [];
+  const issues = [];
+  for (const webPath of collectImagePaths(input.frontmatter, input.body)) {
+    const filePath = assetFilePath(assetsPath, webPath);
+    if (fs2__default.default.existsSync(filePath)) continue;
+    issues.push({
+      level: "warning",
+      contentType: input.contentType,
+      enSlug: input.enSlug,
+      locale: input.locale,
+      field: "asset",
+      message: `Missing image asset ${webPath} (expected ${filePath})`
+    });
+  }
+  return issues;
+}
 
 // src/validate/validate-slug-suffix.ts
 function validateTranslationSlugSuffixes(config, db) {
@@ -1898,8 +1941,6 @@ function validateProject(config) {
         });
         continue;
       }
-      const payload = getTranslatablePayload(enDoc, type);
-      const currentEnHash = computePageEnHash(payload.frontmatter, payload.body);
       const crossIssues = type.crossValidate?.(enDoc.frontmatter, {
         locale: config.defaultLocale,
         defaultLocale: config.defaultLocale,
@@ -1917,29 +1958,18 @@ function validateProject(config) {
           message: issue.message
         });
       }
+      for (const issue of validateDocumentAssets(config, {
+        contentType: type.id,
+        enSlug,
+        frontmatter: enDoc.frontmatter,
+        body: enDoc.content
+      })) {
+        issues.push(issue);
+      }
       for (const locale of config.locales) {
         if (locale === config.defaultLocale) continue;
         const row = getTranslation(db, type.id, enSlug, locale);
         if (!row) continue;
-        if (row.en_hash !== currentEnHash) {
-          issues.push({
-            level: "warning",
-            contentType: type.id,
-            enSlug,
-            locale,
-            field: "en_hash",
-            message: "Translation is stale (en_hash mismatch)"
-          });
-          recordRevision(config, {
-            contentType: type.id,
-            enSlug,
-            locale,
-            revisionKind: "en_edit_detected",
-            enHash: currentEnHash,
-            body: row.body,
-            frontmatter: JSON.parse(row.frontmatter_json)
-          });
-        }
         const localeFm = JSON.parse(row.frontmatter_json);
         for (const issue of validateLocaleBuiltinFields(localeFm)) {
           issues.push({
@@ -1951,6 +1981,15 @@ function validateProject(config) {
             message: issue.message
           });
         }
+        for (const issue of validateDocumentAssets(config, {
+          contentType: type.id,
+          enSlug,
+          locale,
+          frontmatter: localeFm,
+          body: row.body
+        })) {
+          issues.push(issue);
+        }
       }
     }
     try {
@@ -2018,6 +2057,15 @@ function validateProject(config) {
   }
   return { ok: issues.every((i) => i.level !== "error"), issues };
 }
+function sha256(input) {
+  return crypto.createHash("sha256").update(input, "utf8").digest("hex");
+}
+function computePageEnHash(translatableFrontmatter, body) {
+  const payload = JSON.stringify({ frontmatter: translatableFrontmatter, body });
+  return sha256(payload);
+}
+
+// src/translate/worklist.ts
 function listEnSlugs3(rootDir, contentDir) {
   const dir = path3__default.default.join(rootDir, contentDir);
   if (!fs2__default.default.existsSync(dir)) return [];
@@ -2076,6 +2124,21 @@ function resolveLocalesFromPreset(config, preset, explicitLocales) {
   return config.locales.filter((l) => l !== config.defaultLocale);
 }
 
+// src/history/record-snapshot.ts
+function recordEnSnapshot(config, input, db) {
+  const ownDb = db ?? openStore(config, "readwrite");
+  const id = getOrCreateEnSnapshot(ownDb, {
+    contentType: input.contentType,
+    enSlug: input.enSlug,
+    enHash: input.enHash,
+    frontmatter: input.frontmatter,
+    body: input.body,
+    createdAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  if (!db) ownDb.close();
+  return id;
+}
+
 // src/translate/gemini-models.ts
 var GEMINI_MODEL_IDS = {
   "gemini-2.5-pro": "gemini-2.5-pro",
@@ -2449,6 +2512,17 @@ async function translatePage(config, item, options = {}) {
       throw new Error(`Translation validation failed: ${validated.error}`);
     }
     const writeDb = openStore(config, "readwrite");
+    const snapshotId = recordEnSnapshot(
+      config,
+      {
+        contentType: type.id,
+        enSlug: item.enSlug,
+        enHash: currentEnHash,
+        frontmatter: payload.frontmatter,
+        body: payload.body
+      },
+      writeDb
+    );
     upsertTranslation(writeDb, {
       contentType: type.id,
       enSlug: item.enSlug,
@@ -2458,19 +2532,10 @@ async function translatePage(config, item, options = {}) {
       body: result.parsed.body,
       enHash: currentEnHash,
       translatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      model: result.model
+      model: result.model,
+      snapshotId
     });
     writeDb.close();
-    recordRevision(config, {
-      contentType: type.id,
-      enSlug: item.enSlug,
-      locale: item.locale,
-      revisionKind: "translation",
-      enHash: currentEnHash,
-      body: result.parsed.body,
-      frontmatter: validated.frontmatter,
-      model: result.model
-    });
     const estimatedCostUsd = estimateTranslationCostUsd(
       normalizeGeminiDisplayName(result.model),
       result.usage.inputTokens,