bunki 0.14.0 → 0.15.0

package/README.md

@@ -96,6 +96,34 @@ performance = "Performance optimization and speed"
 web = "Web development and technology"
 ```
 
+### Business Location Data
+
+Add structured business/location data with automatic validation:
+
+```markdown
+---
+title: "Restaurant Review"
+date: 2025-01-15T09:00:00-07:00
+tags: [food, review]
+business:
+  - type: Restaurant
+    name: "Blue Bottle Coffee"
+    address: "123 Main St, San Francisco, CA 94102"
+    lat: 37.7749
+    lng: -122.4194
+---
+```
+
+**Required fields:** `type`, `name`, `lat`, `lng`
+**Optional fields:** `address`, `cuisine`, `priceRange`, `telephone`, `url`, `openingHours`
+
+The validator enforces:
+- Use `business:` (not deprecated `location:`)
+- Use `lat:`/`lng:` (not deprecated `latitude:`/`longitude:`)
+- All required fields must be present
+
+Validation runs automatically during `bunki generate` and `bunki validate`.
+
 ## CSS & Tailwind
 
 To use Tailwind CSS:
@@ -718,6 +746,7 @@ export S3_PUBLIC_URL="https://img.example.com"
 bunki init [--config FILE]                 # Initialize new site
 bunki new <TITLE> [--tags TAG1,TAG2]       # Create new post
 bunki generate [--config FILE]             # Build static site
+bunki validate [--config FILE]             # Validate frontmatter
 bunki serve [--port 3000]                  # Start dev server
 bunki css [--watch]                        # Process CSS
 bunki images:push [--domain DOMAIN]        # Upload images to cloud
@@ -744,6 +773,7 @@ dist/
 ## Features
 
 - **Markdown Processing**: Frontmatter extraction, code highlighting, HTML sanitization
+- **Frontmatter Validation**: Automatic validation of business location data with clear error messages
 - **Security**: XSS protection, sanitized HTML, link hardening
 - **Performance**: Static files, optional gzip, optimized output
 - **Templating**: Nunjucks with custom filters and macros
@@ -789,7 +819,18 @@ bunki/
 
 ## Changelog
 
-### v0.8.0 (Current)
+### v0.15.0 (Current)
+
+- **Frontmatter Validation**: Automatic validation of business location data
+  - Enforces `business:` field (rejects deprecated `location:`)
+  - Enforces `lat:`/`lng:` coordinates (rejects deprecated `latitude:`/`longitude:`)
+  - Validates required fields (type, name, lat, lng)
+  - Clear error messages with suggestions for fixes
+  - New `bunki validate` command for standalone validation
+- **Enhanced Testing**: 47 tests for markdown parsing and validation
+- **Breaking Change**: Deprecated `location:`, `latitude:`, and `longitude:` fields now rejected
+
+### v0.8.0
 
 - **JSON-LD Structured Data**: Automatic Schema.org markup generation for enhanced SEO
   - BlogPosting schema for individual blog posts with author, keywords, images

package/dist/cli.js

@@ -33060,6 +33060,92 @@ function convertMarkdownToHtml(markdownContent) {
   sanitized = sanitized.replace(/javascript:/gi, "").replace(/vbscript:/gi, "");
   return sanitized;
 }
+function validateBusinessLocation(business, filePath) {
+  if (!business)
+    return null;
+  const locations = Array.isArray(business) ? business : [business];
+  for (let i = 0;i < locations.length; i++) {
+    const loc = locations[i];
+    const locIndex = locations.length > 1 ? ` (location ${i + 1})` : "";
+    if (!loc.type) {
+      return {
+        file: filePath,
+        type: "validation",
+        message: `Missing required field 'type' in business${locIndex}`,
+        suggestion: "Add 'type: Restaurant' (or Market, Park, Hotel, Museum, Cafe, Zoo, etc.) to frontmatter"
+      };
+    }
+    const validTypes = [
+      "Accommodation",
+      "Apartment",
+      "Attraction",
+      "Beach",
+      "BodyOfWater",
+      "Bridge",
+      "Building",
+      "BusStation",
+      "Cafe",
+      "Campground",
+      "CivicStructure",
+      "EventVenue",
+      "Ferry",
+      "Garden",
+      "HistoricalSite",
+      "Hotel",
+      "Hostel",
+      "Landmark",
+      "LodgingBusiness",
+      "Market",
+      "Monument",
+      "Museum",
+      "NaturalFeature",
+      "Park",
+      "Playground",
+      "Restaurant",
+      "ServiceCenter",
+      "ShoppingCenter",
+      "Store",
+      "TouristAttraction",
+      "TrainStation",
+      "Viewpoint",
+      "Zoo"
+    ];
+    if (!validTypes.includes(loc.type)) {
+      return {
+        file: filePath,
+        type: "validation",
+        message: `Invalid business type '${loc.type}' in business${locIndex}`,
+        suggestion: `Use a valid Schema.org Place type: ${validTypes.slice(0, 10).join(", ")}, etc.`
+      };
+    }
+    if (!loc.name) {
+      return {
+        file: filePath,
+        type: "validation",
+        message: `Missing required field 'name' in business${locIndex}`,
+        suggestion: `Add 'name: "Full Business Name"' to frontmatter`
+      };
+    }
+    if (loc.latitude !== undefined || loc.longitude !== undefined) {
+      return {
+        file: filePath,
+        type: "validation",
+        message: `Use 'lat' and 'lng' instead of 'latitude' and 'longitude' in business${locIndex}`,
+        suggestion: "Replace 'latitude:' with 'lat:' and 'longitude:' with 'lng:' in frontmatter"
+      };
+    }
+    const hasLatLng = loc.lat !== undefined && loc.lng !== undefined;
+    if (!hasLatLng) {
+      return {
+        file: filePath,
+        type: "validation",
+        message: `Missing required coordinates in business${locIndex}`,
+        suggestion: "Add 'lat: 47.6062' and 'lng: -122.3321' with numeric coordinates to frontmatter (REQUIRED)"
+      };
+    }
+  }
+  return null;
+}
 async function parseMarkdownFile(filePath) {
   try {
     const fileContent = await readFileAsText(filePath);
@@ -33090,6 +33176,26 @@ async function parseMarkdownFile(filePath) {
         }
       };
     }
+    if (data.location) {
+      return {
+        post: null,
+        error: {
+          file: filePath,
+          type: "validation",
+          message: "Use 'business:' instead of deprecated 'location:' field",
+          suggestion: "Replace 'location:' with 'business:' in frontmatter (business requires type, name, lat, lng)"
+        }
+      };
+    }
+    if (data.business) {
+      const validationError = validateBusinessLocation(data.business, filePath);
+      if (validationError) {
+        return {
+          post: null,
+          error: validationError
+        };
+      }
+    }
     let slug = data.slug || getBaseFilename(filePath);
     const sanitizedHtml = convertMarkdownToHtml(content);
     const pacificDate = toPacificTime(data.date);
@@ -33104,34 +33210,29 @@ async function parseMarkdownFile(filePath) {
       url: `/${postYear}/${slug}/`,
       excerpt: data.excerpt || extractExcerpt(content),
       html: sanitizedHtml,
-      ...data.location && {
-        location: {
-          name: data.location.name,
-          address: data.location.address,
-          lat: data.location.lat,
-          lng: data.location.lng
-        }
-      },
       ...data.category && { category: data.category },
       ...data.business && {
-        business: {
-          type: data.business.type,
-          name: data.business.name,
-          address: data.business.address,
-          lat: data.business.lat,
-          lng: data.business.lng,
-          ...data.business.cuisine && { cuisine: data.business.cuisine },
-          ...data.business.priceRange && {
-            priceRange: data.business.priceRange
-          },
-          ...data.business.telephone && {
-            telephone: data.business.telephone
-          },
-          ...data.business.url && { url: data.business.url },
-          ...data.business.openingHours && {
-            openingHours: data.business.openingHours
-          }
-        }
+        business: (() => {
+          const biz = Array.isArray(data.business) ? data.business[0] : data.business;
+          return {
+            type: biz.type,
+            name: biz.name,
+            address: biz.address,
+            lat: biz.lat,
+            lng: biz.lng,
+            ...biz.cuisine && { cuisine: biz.cuisine },
+            ...biz.priceRange && {
+              priceRange: biz.priceRange
+            },
+            ...biz.telephone && {
+              telephone: biz.telephone
+            },
+            ...biz.url && { url: biz.url },
+            ...biz.openingHours && {
+              openingHours: biz.openingHours
+            }
+          };
+        })()
       }
     };
     return { post, error: null };
@@ -33179,7 +33280,8 @@ async function parseMarkdownDirectory(contentDir, strictMode = false) {
 `);
       const yamlErrors = errors.filter((e) => e.type === "yaml");
       const missingFieldErrors = errors.filter((e) => e.type === "missing_field");
-      const otherErrors = errors.filter((e) => e.type !== "yaml" && e.type !== "missing_field");
+      const validationErrors = errors.filter((e) => e.type === "validation");
+      const otherErrors = errors.filter((e) => e.type !== "yaml" && e.type !== "missing_field" && e.type !== "validation");
       if (yamlErrors.length > 0) {
         console.error(`  YAML Parsing Errors (${yamlErrors.length}):`);
         yamlErrors.slice(0, 5).forEach((e) => {
@@ -33203,6 +33305,19 @@ async function parseMarkdownDirectory(contentDir, strictMode = false) {
         }
         console.error("");
       }
+      if (validationErrors.length > 0) {
+        console.error(`  Validation Errors (${validationErrors.length}):`);
+        validationErrors.slice(0, 5).forEach((e) => {
+          console.error(`    \u26A0\uFE0F  ${e.file}: ${e.message}`);
+          if (e.suggestion) {
+            console.error(`       \uD83D\uDCA1 ${e.suggestion}`);
+          }
+        });
+        if (validationErrors.length > 5) {
+          console.error(`    ... and ${validationErrors.length - 5} more`);
+        }
+        console.error("");
+      }
       if (otherErrors.length > 0) {
         console.error(`  Other Errors (${otherErrors.length}):`);
         otherErrors.slice(0, 3).forEach((e) => {
@@ -33216,6 +33331,11 @@ async function parseMarkdownDirectory(contentDir, strictMode = false) {
       console.error(`\uD83D\uDCDD Tip: Fix YAML errors by quoting titles/descriptions with colons`);
       console.error(`   Example: title: "My Post: A Guide"  (quotes required for colons)
 `);
+      if (validationErrors.length > 0) {
+        throw new Error(`\u274C Build failed: ${validationErrors.length} validation error(s) found
+` + `   Business locations must have: type, name, address, lat, lng
+` + `   Run 'bunki validate' to see all errors`);
+      }
       if (strictMode) {
         throw new Error(`Build failed: ${errors.length} parsing error(s) found (strictMode enabled)`);
       }
@@ -33571,14 +33691,23 @@ class SiteGenerator {
         const pagination = this.createPagination(yearPosts, page, pageSize, `/${year}/`);
         let jsonLd = "";
         if (page === 1) {
-          const schema = generateCollectionPageSchema({
+          const schemas = [];
+          schemas.push(generateCollectionPageSchema({
             title: `Posts from ${year}`,
             description: `Articles published in ${year}`,
             url: `${this.options.config.baseUrl}/${year}/`,
             posts: yearPosts,
             site: this.options.config
-          });
-          jsonLd = toScriptTag(schema);
+          }));
+          schemas.push(generateBreadcrumbListSchema({
+            site: this.options.config,
+            items: [
+              { name: "Home", url: `${this.options.config.baseUrl}/` },
+              { name: year, url: `${this.options.config.baseUrl}/${year}/` }
+            ]
+          }));
+          jsonLd = schemas.map((schema) => toScriptTag(schema)).join(`
+`);
         }
         const yearPageHtml = import_nunjucks.default.render("archive.njk", {
           site: this.options.config,
@@ -33677,15 +33806,24 @@ class SiteGenerator {
         const pagination = this.createPagination(tagData.posts, page, pageSize, `/tags/${tagData.slug}/`);
         let jsonLd = "";
         if (page === 1) {
+          const schemas = [];
           const description = tagData.description || `Articles tagged with ${tagName}`;
-          const schema = generateCollectionPageSchema({
+          schemas.push(generateCollectionPageSchema({
             title: `${tagName}`,
             description,
             url: `${this.options.config.baseUrl}/tags/${tagData.slug}/`,
             posts: tagData.posts,
             site: this.options.config
-          });
-          jsonLd = toScriptTag(schema);
+          }));
+          schemas.push(generateBreadcrumbListSchema({
+            site: this.options.config,
+            items: [
+              { name: "Home", url: `${this.options.config.baseUrl}/` },
+              { name: tagName, url: `${this.options.config.baseUrl}/tags/${tagData.slug}/` }
+            ]
+          }));
+          jsonLd = schemas.map((schema) => toScriptTag(schema)).join(`
+`);
         }
         const tagPageHtml = import_nunjucks.default.render("tag.njk", {
           site: this.options.config,

package/dist/index.js

@@ -30678,6 +30678,92 @@ function convertMarkdownToHtml(markdownContent) {
   sanitized = sanitized.replace(/javascript:/gi, "").replace(/vbscript:/gi, "");
   return sanitized;
 }
+function validateBusinessLocation(business, filePath) {
+  if (!business)
+    return null;
+  const locations = Array.isArray(business) ? business : [business];
+  for (let i = 0;i < locations.length; i++) {
+    const loc = locations[i];
+    const locIndex = locations.length > 1 ? ` (location ${i + 1})` : "";
+    if (!loc.type) {
+      return {
+        file: filePath,
+        type: "validation",
+        message: `Missing required field 'type' in business${locIndex}`,
+        suggestion: "Add 'type: Restaurant' (or Market, Park, Hotel, Museum, Cafe, Zoo, etc.) to frontmatter"
+      };
+    }
+    const validTypes = [
+      "Accommodation",
+      "Apartment",
+      "Attraction",
+      "Beach",
+      "BodyOfWater",
+      "Bridge",
+      "Building",
+      "BusStation",
+      "Cafe",
+      "Campground",
+      "CivicStructure",
+      "EventVenue",
+      "Ferry",
+      "Garden",
+      "HistoricalSite",
+      "Hotel",
+      "Hostel",
+      "Landmark",
+      "LodgingBusiness",
+      "Market",
+      "Monument",
+      "Museum",
+      "NaturalFeature",
+      "Park",
+      "Playground",
+      "Restaurant",
+      "ServiceCenter",
+      "ShoppingCenter",
+      "Store",
+      "TouristAttraction",
+      "TrainStation",
+      "Viewpoint",
+      "Zoo"
+    ];
+    if (!validTypes.includes(loc.type)) {
+      return {
+        file: filePath,
+        type: "validation",
+        message: `Invalid business type '${loc.type}' in business${locIndex}`,
+        suggestion: `Use a valid Schema.org Place type: ${validTypes.slice(0, 10).join(", ")}, etc.`
+      };
+    }
+    if (!loc.name) {
+      return {
+        file: filePath,
+        type: "validation",
+        message: `Missing required field 'name' in business${locIndex}`,
+        suggestion: `Add 'name: "Full Business Name"' to frontmatter`
+      };
+    }
+    if (loc.latitude !== undefined || loc.longitude !== undefined) {
+      return {
+        file: filePath,
+        type: "validation",
+        message: `Use 'lat' and 'lng' instead of 'latitude' and 'longitude' in business${locIndex}`,
+        suggestion: "Replace 'latitude:' with 'lat:' and 'longitude:' with 'lng:' in frontmatter"
+      };
+    }
+    const hasLatLng = loc.lat !== undefined && loc.lng !== undefined;
+    if (!hasLatLng) {
+      return {
+        file: filePath,
+        type: "validation",
+        message: `Missing required coordinates in business${locIndex}`,
+        suggestion: "Add 'lat: 47.6062' and 'lng: -122.3321' with numeric coordinates to frontmatter (REQUIRED)"
+      };
+    }
+  }
+  return null;
+}
 async function parseMarkdownFile(filePath) {
   try {
     const fileContent = await readFileAsText(filePath);
@@ -30708,6 +30794,26 @@ async function parseMarkdownFile(filePath) {
         }
       };
     }
+    if (data.location) {
+      return {
+        post: null,
+        error: {
+          file: filePath,
+          type: "validation",
+          message: "Use 'business:' instead of deprecated 'location:' field",
+          suggestion: "Replace 'location:' with 'business:' in frontmatter (business requires type, name, lat, lng)"
+        }
+      };
+    }
+    if (data.business) {
+      const validationError = validateBusinessLocation(data.business, filePath);
+      if (validationError) {
+        return {
+          post: null,
+          error: validationError
+        };
+      }
+    }
     let slug = data.slug || getBaseFilename(filePath);
     const sanitizedHtml = convertMarkdownToHtml(content);
     const pacificDate = toPacificTime(data.date);
@@ -30722,34 +30828,29 @@ async function parseMarkdownFile(filePath) {
       url: `/${postYear}/${slug}/`,
       excerpt: data.excerpt || extractExcerpt(content),
       html: sanitizedHtml,
-      ...data.location && {
-        location: {
-          name: data.location.name,
-          address: data.location.address,
-          lat: data.location.lat,
-          lng: data.location.lng
-        }
-      },
       ...data.category && { category: data.category },
       ...data.business && {
-        business: {
-          type: data.business.type,
-          name: data.business.name,
-          address: data.business.address,
-          lat: data.business.lat,
-          lng: data.business.lng,
-          ...data.business.cuisine && { cuisine: data.business.cuisine },
-          ...data.business.priceRange && {
-            priceRange: data.business.priceRange
-          },
-          ...data.business.telephone && {
-            telephone: data.business.telephone
-          },
-          ...data.business.url && { url: data.business.url },
-          ...data.business.openingHours && {
-            openingHours: data.business.openingHours
-          }
-        }
+        business: (() => {
+          const biz = Array.isArray(data.business) ? data.business[0] : data.business;
+          return {
+            type: biz.type,
+            name: biz.name,
+            address: biz.address,
+            lat: biz.lat,
+            lng: biz.lng,
+            ...biz.cuisine && { cuisine: biz.cuisine },
+            ...biz.priceRange && {
+              priceRange: biz.priceRange
+            },
+            ...biz.telephone && {
+              telephone: biz.telephone
+            },
+            ...biz.url && { url: biz.url },
+            ...biz.openingHours && {
+              openingHours: biz.openingHours
+            }
+          };
+        })()
       }
     };
     return { post, error: null };
@@ -30797,7 +30898,8 @@ async function parseMarkdownDirectory(contentDir, strictMode = false) {
 `);
       const yamlErrors = errors.filter((e) => e.type === "yaml");
       const missingFieldErrors = errors.filter((e) => e.type === "missing_field");
-      const otherErrors = errors.filter((e) => e.type !== "yaml" && e.type !== "missing_field");
+      const validationErrors = errors.filter((e) => e.type === "validation");
+      const otherErrors = errors.filter((e) => e.type !== "yaml" && e.type !== "missing_field" && e.type !== "validation");
       if (yamlErrors.length > 0) {
         console.error(`  YAML Parsing Errors (${yamlErrors.length}):`);
         yamlErrors.slice(0, 5).forEach((e) => {
@@ -30821,6 +30923,19 @@ async function parseMarkdownDirectory(contentDir, strictMode = false) {
         }
         console.error("");
       }
+      if (validationErrors.length > 0) {
+        console.error(`  Validation Errors (${validationErrors.length}):`);
+        validationErrors.slice(0, 5).forEach((e) => {
+          console.error(`    \u26A0\uFE0F  ${e.file}: ${e.message}`);
+          if (e.suggestion) {
+            console.error(`       \uD83D\uDCA1 ${e.suggestion}`);
+          }
+        });
+        if (validationErrors.length > 5) {
+          console.error(`    ... and ${validationErrors.length - 5} more`);
+        }
+        console.error("");
+      }
       if (otherErrors.length > 0) {
         console.error(`  Other Errors (${otherErrors.length}):`);
         otherErrors.slice(0, 3).forEach((e) => {
@@ -30834,6 +30949,11 @@ async function parseMarkdownDirectory(contentDir, strictMode = false) {
       console.error(`\uD83D\uDCDD Tip: Fix YAML errors by quoting titles/descriptions with colons`);
       console.error(`   Example: title: "My Post: A Guide"  (quotes required for colons)
 `);
+      if (validationErrors.length > 0) {
+        throw new Error(`\u274C Build failed: ${validationErrors.length} validation error(s) found
+` + `   Business locations must have: type, name, address, lat, lng
+` + `   Run 'bunki validate' to see all errors`);
+      }
       if (strictMode) {
         throw new Error(`Build failed: ${errors.length} parsing error(s) found (strictMode enabled)`);
       }
@@ -31518,14 +31638,23 @@ class SiteGenerator {
         const pagination = this.createPagination(yearPosts, page, pageSize, `/${year}/`);
         let jsonLd = "";
         if (page === 1) {
-          const schema = generateCollectionPageSchema({
+          const schemas = [];
+          schemas.push(generateCollectionPageSchema({
             title: `Posts from ${year}`,
             description: `Articles published in ${year}`,
             url: `${this.options.config.baseUrl}/${year}/`,
             posts: yearPosts,
             site: this.options.config
-          });
-          jsonLd = toScriptTag(schema);
+          }));
+          schemas.push(generateBreadcrumbListSchema({
+            site: this.options.config,
+            items: [
+              { name: "Home", url: `${this.options.config.baseUrl}/` },
+              { name: year, url: `${this.options.config.baseUrl}/${year}/` }
+            ]
+          }));
+          jsonLd = schemas.map((schema) => toScriptTag(schema)).join(`
+`);
         }
         const yearPageHtml = import_nunjucks.default.render("archive.njk", {
           site: this.options.config,
@@ -31624,15 +31753,24 @@ class SiteGenerator {
         const pagination = this.createPagination(tagData.posts, page, pageSize, `/tags/${tagData.slug}/`);
         let jsonLd = "";
         if (page === 1) {
+          const schemas = [];
           const description = tagData.description || `Articles tagged with ${tagName}`;
-          const schema = generateCollectionPageSchema({
+          schemas.push(generateCollectionPageSchema({
             title: `${tagName}`,
             description,
             url: `${this.options.config.baseUrl}/tags/${tagData.slug}/`,
             posts: tagData.posts,
             site: this.options.config
-          });
-          jsonLd = toScriptTag(schema);
+          }));
+          schemas.push(generateBreadcrumbListSchema({
+            site: this.options.config,
+            items: [
+              { name: "Home", url: `${this.options.config.baseUrl}/` },
+              { name: tagName, url: `${this.options.config.baseUrl}/tags/${tagData.slug}/` }
+            ]
+          }));
+          jsonLd = schemas.map((schema) => toScriptTag(schema)).join(`
+`);
         }
         const tagPageHtml = import_nunjucks.default.render("tag.njk", {
           site: this.options.config,

package/dist/utils/markdown-utils.d.ts

@@ -4,7 +4,7 @@ export declare function extractExcerpt(content: string, maxLength?: number): str
 export declare function convertMarkdownToHtml(markdownContent: string): string;
 export interface ParseError {
     file: string;
-    type: "yaml" | "missing_field" | "file_not_found" | "unknown";
+    type: "yaml" | "missing_field" | "file_not_found" | "unknown" | "validation";
     message: string;
     suggestion?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunki",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "An opinionated static site generator built with Bun featuring PostCSS integration and modern web development workflows",
   "main": "dist/index.js",
   "module": "dist/index.mjs",