webspresso 0.0.30 → 0.0.32

package/README.md

@@ -12,7 +12,7 @@ A minimal, file-based SSR framework for Node.js with Nunjucks templating.
 - **Lifecycle Hooks**: Global and route-level hooks for request processing
 - **Template Helpers**: Laravel-inspired helper functions available in templates
 - **Plugin System**: Extensible architecture with version control and inter-plugin communication
-- **Built-in Plugins**: Development dashboard, sitemap generator, analytics integration (Google, Yandex, Bing)
+- **Built-in Plugins**: Development dashboard, sitemap generator, SEO checker, analytics integration (Google, Yandex, Bing)
 
 ## Installation
 
@@ -527,6 +527,49 @@ Template helpers from analytics plugin:
 
 Individual helpers: `gtag()`, `gtm()`, `gtmNoscript()`, `yandexMetrika()`, `bingUET()`, `facebookPixel()`, `allAnalytics()`
 
+**SEO Checker Plugin:**
+- Client-side SEO analysis tool (inspired by django-check-seo)
+- Integrated with dev toolbar
+- 40+ SEO checks across 7 categories
+- Real-time analysis with score calculation
+- Only active in development mode
+
+```javascript
+const { seoCheckerPlugin } = require('webspresso/plugins');
+
+const { app } = createApp({
+  pagesDir: './pages',
+  plugins: [
+    seoCheckerPlugin({
+      settings: {
+        titleLength: [30, 60],        // Min/max title length
+        descriptionLength: [50, 160], // Min/max description length
+        minContentWords: 300,         // Minimum content words
+        minInternalLinks: 1,          // Minimum internal links
+        minExternalLinks: 1,          // Minimum external links
+        maxUrlLength: 75,             // Maximum URL length
+        maxUrlDepth: 3                // Maximum URL depth
+      }
+    })
+  ]
+});
+```
+
+SEO Check Categories:
+| Category | Checks |
+|----------|--------|
+| **Meta** | Title, Description, Canonical, Viewport, Robots, Charset, Lang |
+| **Headings** | H1 existence, Single H1, Hierarchy, Non-empty headings |
+| **Content** | Word count, Paragraphs, Keyword usage, Keywords early |
+| **Links** | Internal links, External links, Nofollow, Anchor text |
+| **Images** | Alt text, Descriptive alt, Dimensions, Lazy loading |
+| **Structured** | Open Graph, Twitter Card, JSON-LD, Hreflang |
+| **URL** | Length, Depth, Readability, HTTPS |
+
+The SEO Checker panel appears as a floating widget and can be opened via:
+- Dev toolbar "SEO Check" button
+- Floating toggle button (🔍) in bottom-right corner
+
 ### Creating Custom Plugins
 
 ```javascript

package/core/orm/schema-helpers.js

@@ -682,9 +682,22 @@ function extractColumnsFromSchema(schema) {
   const shape = schema.shape;
 
   for (const [key, fieldSchema] of Object.entries(shape)) {
+    let schemaToCheck = fieldSchema;
+    
+    // Handle SchemaBuilder instances - finalize them first to get metadata
+    if (fieldSchema && typeof fieldSchema._finalize === 'function') {
+      schemaToCheck = fieldSchema._finalize();
+    }
+    
+    // Also check if it's a SchemaBuilder with _baseMeta (for unfinalized builders)
+    if (fieldSchema && fieldSchema._baseMeta) {
+      columns.set(key, fieldSchema._baseMeta);
+      continue;
+    }
+    
     // Unwrap optional/nullable wrappers to get to the base schema
-    let current = fieldSchema;
-    while (current._def) {
+    let current = schemaToCheck;
+    while (current && current._def) {
       if (current._def.innerType) {
         current = current._def.innerType;
       } else if (current._def.schema) {
@@ -694,8 +707,8 @@ function extractColumnsFromSchema(schema) {
       }
     }
 
-    // Check the original field schema for metadata
-    const meta = getColumnMeta(fieldSchema) || getColumnMeta(current);
+    // Check the schema for metadata
+    const meta = getColumnMeta(schemaToCheck) || (current ? getColumnMeta(current) : null);
     if (meta) {
       columns.set(key, meta);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webspresso",
-  "version": "0.0.30",
+  "version": "0.0.32",
   "description": "Minimal, production-ready SSR framework for Node.js with file-based routing, Nunjucks templating, built-in i18n, and CLI tooling",
   "main": "index.js",
   "bin": {

package/plugins/index.js

@@ -8,6 +8,7 @@ const analyticsPlugin = require('./analytics');
 const dashboardPlugin = require('./dashboard/index');
 const schemaExplorerPlugin = require('./schema-explorer');
 const adminPanelPlugin = require('./admin-panel');
+const seoCheckerPlugin = require('./seo-checker');
 
 module.exports = {
   sitemapPlugin,
@@ -15,5 +16,6 @@ module.exports = {
   dashboardPlugin,
   schemaExplorerPlugin,
   adminPanelPlugin,
+  seoCheckerPlugin,
 };