@xtrable-ltd/nanoesis 0.1.11 → 0.1.13

package/dist/adapter-azure-blob.js

@@ -1,6 +1,6 @@
 import {
   contentTypeFor
-} from "./chunk-XO3CT6GL.js";
+} from "./chunk-7TB5ANIS.js";
 
 // ../../adapters/azure-blob/src/container.ts
 var InMemoryBlobContainer = class {

package/dist/{chunk-XO3CT6GL.js → chunk-7TB5ANIS.js}

@@ -43,6 +43,15 @@ var ContentParseError = class extends Error {
     this.name = "ContentParseError";
   }
 };
+var KNOWN_TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
+  "template",
+  "title",
+  "isPublished",
+  "fields",
+  "created",
+  "published",
+  "updated"
+]);
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -72,6 +81,9 @@ function parseOptionalString(raw, key) {
   return value;
 }
 function parseContentItem(raw) {
+  return parseContentItemWithDiagnostics(raw).item;
+}
+function parseContentItemWithDiagnostics(raw) {
   if (!isPlainObject(raw)) {
     throw new ContentParseError("A content item must be a JSON object.");
   }
@@ -100,7 +112,8 @@ function parseContentItem(raw) {
   const created = parseOptionalString(raw, "created");
   const published = parseOptionalString(raw, "published");
   const updated = parseOptionalString(raw, "updated");
-  return {
+  const unknownTopLevelKeys = Object.keys(raw).filter((key) => !KNOWN_TOP_LEVEL_KEYS.has(key)).sort();
+  const item = {
     title: raw.title,
     isPublished,
     fields,
@@ -109,6 +122,7 @@ function parseContentItem(raw) {
     ...published !== void 0 && { published },
     ...updated !== void 0 && { updated }
   };
+  return { item, diagnostics: { unknownTopLevelKeys } };
 }
 
 // ../engine/src/content/sort.ts
@@ -776,10 +790,15 @@ var IndexedStore = class {
         }
       }
       this.index = nextIndex;
+      let parseDiagnostics;
+      if (isContentItemPath(target)) {
+        parseDiagnostics = contentParseDiagnosticsFor(bytes);
+      }
       return {
         ...stamped !== void 0 && { stamped },
         ...stampIncomplete === true && { stampIncomplete: true },
-        ...schemaDelta !== void 0 && { schemaDelta }
+        ...schemaDelta !== void 0 && { schemaDelta },
+        ...parseDiagnostics !== void 0 && { parseDiagnostics }
       };
     });
   }
@@ -897,6 +916,20 @@ function stampTargetOf(target) {
   if (stem === "" || stem.includes("@v")) return void 0;
   return { dir, name: stem };
 }
+function isContentItemPath(target) {
+  if (!target.startsWith("content/") || !target.endsWith(".json")) return false;
+  const tail = target.slice(target.lastIndexOf("/") + 1);
+  return tail !== "_sort.json" && tail !== "_redirects.json" && tail !== "_site.json";
+}
+function contentParseDiagnosticsFor(bytes) {
+  try {
+    const text = new TextDecoder().decode(bytes);
+    const { diagnostics } = parseContentItemWithDiagnostics(JSON.parse(text));
+    return diagnostics.unknownTopLevelKeys.length > 0 ? diagnostics : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function guarded(key) {
   if (key === "" || key.startsWith(RESERVED_PREFIX)) {
     throw new Error(`Refusing to mutate a reserved key: ${key === "" ? "(root)" : key}`);
@@ -1081,8 +1114,14 @@ async function loadDir(source, dirPath, slug, treePath) {
 async function loadItem(source, filePath, slug, parentPath2) {
   const raw = await source.readText(filePath);
   try {
-    const item = parseContentItem(JSON.parse(raw));
-    return { kind: "item", slug, path: join(parentPath2, slug), item };
+    const { item, diagnostics } = parseContentItemWithDiagnostics(JSON.parse(raw));
+    return {
+      kind: "item",
+      slug,
+      path: join(parentPath2, slug),
+      item,
+      ...diagnostics.unknownTopLevelKeys.length > 0 && { parseDiagnostics: diagnostics }
+    };
   } catch (error) {
     throw new Error(`Failed to load ${filePath}: ${error.message}`);
   }
@@ -2598,6 +2637,12 @@ function guardrailsSection() {
       {
         name: "richtext values are HTML, shorttext/text are plain text",
         summary: "For a `richtext` field, write the value as HTML (`<p>...</p>` etc). For `shorttext` or `text`, write plain text \u2014 any HTML you include is escaped at render time. If the gate emits a `content.type-drift` warning, a field's type changed destructively (commonly richtext \u2192 shorttext) and the old HTML content now renders as escaped text."
+      },
+      {
+        name: "Content fields nest under `fields`, not at the top level",
+        summary: "A content/*.json item has system keys at the top level (`template`, `title`, `isPublished`, `created`, `published`, `updated`) and ALL template-specific values under `fields`. Writing `{ template, title, body, tagline }` at the top level silently drops `body`/`tagline` because the parser is tolerant of unknown keys; the page publishes with empty placeholders. After write_file, check the response for `parseDiagnostics.unknownTopLevelKeys` and the gate for `content.unknown-top-level-key` \u2014 both list what was dropped.",
+        detail: 'System keys are case-sensitive: `IsPublished` is not the same as `isPublished` (the typo silently defaults to false), and `Fields` is not `fields`. The same drop-and-flag applies. The published HTML for a tolerated-drift item will render with empty `<div class="prose"></div>` etc., which is the smoking-gun symptom.',
+        example: '<!-- WRONG (body and tagline silently dropped) -->\n{ "template": "about", "title": "Hi", "body": "...", "tagline": "..." }\n\n<!-- RIGHT -->\n{ "template": "about", "title": "Hi", "fields": { "title": "Hi", "body": "...", "tagline": "..." } }'
       }
     ]
   };
@@ -2780,6 +2825,15 @@ async function validateSite(source) {
     const owners = urlOwners.get(urlForItem(node.path)) ?? [];
     owners.push(node.path);
     urlOwners.set(urlForItem(node.path), owners);
+    const dropped = node.parseDiagnostics?.unknownTopLevelKeys ?? [];
+    if (dropped.length > 0) {
+      add(
+        "warning",
+        "content.unknown-top-level-key",
+        `"${node.path}" has top-level key${dropped.length === 1 ? "" : "s"} the parser does not recognise: ${dropped.map((k) => `"${k}"`).join(", ")}. They were dropped \u2014 content values belong under "fields" (and system keys are case-sensitive: "isPublished", not "IsPublished").`,
+        node.path
+      );
+    }
     if (templateName === void 0) {
       add(
         "error",