webspresso 0.0.13 → 0.0.14

package/core/orm/index.js

@@ -6,6 +6,18 @@
 
 const { createSchemaHelpers, extractColumnsFromSchema, getColumnMeta } = require('./schema-helpers');
 const { defineModel, getModel, getAllModels, hasModel, clearRegistry } = require('./model');
+
+// Create zdb instance with zod (zod is a dependency)
+let z;
+try {
+  z = require('zod');
+} catch {
+  // Zod not installed, zdb will be undefined
+  z = null;
+}
+
+// Export zdb instance directly
+const zdb = z ? createSchemaHelpers(z) : null;
 const { createRepository } = require('./repository');
 const { createQueryBuilder, QueryBuilder } = require('./query-builder');
 const { runTransaction, createTransactionContext } = require('./transaction');
@@ -110,7 +122,8 @@ module.exports = {
   // Main factory
   createDatabase,
 
-  // Schema helpers
+  // Schema helpers - zdb instance (direct export)
+  zdb,
   createSchemaHelpers,
   extractColumnsFromSchema,
   getColumnMeta,

package/core/orm/migrations/scaffold.js

@@ -142,6 +142,11 @@ function generateColumnLine(columnName, meta) {
       parts.push(`table.json('${columnName}')`);
       break;
 
+    case 'array':
+      // Array is stored as JSON in database
+      parts.push(`table.json('${columnName}')`);
+      break;
+
     case 'enum':
       const enumValues = meta.enumValues || [];
       const valuesStr = enumValues.map(v => `'${v}'`).join(', ');

package/core/orm/model.js

@@ -25,6 +25,7 @@ function defineModel(options) {
     primaryKey = 'id',
     relations = {},
     scopes = {},
+    admin = {},
   } = options;
 
   // Validate required fields
@@ -78,6 +79,13 @@ function defineModel(options) {
       tenant: scopes.tenant || null,
     },
     columns,
+    admin: {
+      enabled: admin.enabled || false,
+      label: admin.label || name,
+      icon: admin.icon || null,
+      customFields: admin.customFields || {},
+      queries: admin.queries || {},
+    },
   };
 
   // Register model

package/core/orm/schema-helpers.js

@@ -67,7 +67,15 @@ function createSchemaHelpers(z) {
     return schema.describe(encodeColumnMeta(meta));
   }
 
-  return {
+  const helpers = {
+    /**
+     * Create a Zod object schema with database metadata
+     * @param {Object} shape - Object shape with zdb fields
+     * @returns {import('zod').ZodObject}
+     */
+    schema(shape) {
+      return z.object(shape);
+    },
     /**
      * Primary key column (bigint, auto-increment)
      * @param {Partial<import('./types').ColumnMeta>} [options={}]
@@ -304,6 +312,34 @@ function createSchemaHelpers(z) {
       });
     },
 
+    /**
+     * Array column (stored as JSON in database)
+     * @param {import('zod').ZodTypeAny} [itemSchema] - Schema for array items (default: z.any())
+     * @param {Partial<import('./types').ColumnMeta>} [options={}]
+     * @returns {import('zod').ZodArray}
+     */
+    array(itemSchema, options = {}) {
+      // If first argument is options object (backward compatibility)
+      if (itemSchema && typeof itemSchema === 'object' && !itemSchema._def) {
+        options = itemSchema;
+        itemSchema = z.any();
+      }
+      
+      const { nullable = false, ...rest } = options;
+      const baseItemSchema = itemSchema || z.any();
+      let schema = z.array(baseItemSchema);
+      
+      if (nullable) {
+        schema = schema.nullable().optional();
+      }
+      
+      return withMeta(schema, {
+        type: 'array',
+        nullable,
+        ...rest,
+      });
+    },
+
     /**
      * Enum column
      * @param {string[]} values - Allowed enum values
@@ -370,6 +406,8 @@ function createSchemaHelpers(z) {
       });
     },
   };
+
+  return helpers;
 }
 
 /**

package/core/orm/seeder.js

@@ -61,6 +61,11 @@ function createSeeder(faker, knex) {
     // Smart field detection by name
     const lowerName = columnName.toLowerCase();
 
+    // Array type should be handled in generateByType (skip smart detection for arrays)
+    if (meta.type === 'array') {
+      return generateByType(columnName, meta);
+    }
+
     // Email detection
     if (lowerName.includes('email')) {
       return faker.internet.email().toLowerCase();
@@ -146,16 +151,17 @@ function createSeeder(faker, knex) {
       return faker.helpers.arrayElement(['active', 'inactive', 'pending']);
     }
 
-    // Generate by type
-    return generateByType(meta);
+    // Generate by type (pass columnName for array type detection)
+    return generateByType(columnName, meta);
   }
 
   /**
    * Generate value by column type
+   * @param {string} columnName - Column name (for smart detection, especially for arrays)
    * @param {Object} meta - Column metadata
    * @returns {*} Generated value
    */
-  function generateByType(meta) {
+  function generateByType(columnName, meta) {
     switch (meta.type) {
       case 'bigint':
       case 'integer':
@@ -186,6 +192,53 @@ function createSeeder(faker, knex) {
       case 'json':
         return { key: faker.lorem.word(), value: faker.lorem.sentence() };
 
+      case 'array':
+        // Generate a random array with 1-5 items
+        const arrayLength = faker.number.int({ min: 1, max: 5 });
+        const arrayItems = [];
+        
+        // Try to infer item type from column name
+        const lowerName = (columnName || '').toLowerCase();
+        
+        // String arrays (tags, categories, etc.)
+        if (lowerName.includes('tag') || lowerName.includes('category') || 
+            lowerName.includes('label') || lowerName.includes('keyword')) {
+          for (let i = 0; i < arrayLength; i++) {
+            arrayItems.push(faker.lorem.word());
+          }
+        }
+        // Number arrays (ids, scores, etc.)
+        else if (lowerName.includes('id') || lowerName.includes('score') || 
+                 lowerName.includes('price') || lowerName.includes('amount')) {
+          for (let i = 0; i < arrayLength; i++) {
+            arrayItems.push(faker.number.int({ min: 1, max: 100 }));
+          }
+        }
+        // Email arrays
+        else if (lowerName.includes('email')) {
+          for (let i = 0; i < arrayLength; i++) {
+            arrayItems.push(faker.internet.email().toLowerCase());
+          }
+        }
+        // URL arrays
+        else if (lowerName.includes('url') || lowerName.includes('link')) {
+          for (let i = 0; i < arrayLength; i++) {
+            arrayItems.push(faker.internet.url());
+          }
+        }
+        // Default: mixed array (strings and numbers)
+        else {
+          for (let i = 0; i < arrayLength; i++) {
+            if (faker.datatype.boolean()) {
+              arrayItems.push(faker.lorem.word());
+            } else {
+              arrayItems.push(faker.number.int({ min: 1, max: 100 }));
+            }
+          }
+        }
+        
+        return arrayItems;
+
       case 'enum':
         if (meta.enumValues && meta.enumValues.length > 0) {
           return faker.helpers.arrayElement(meta.enumValues);

package/core/orm/types.js

@@ -9,7 +9,7 @@
 // ============================================================================
 
 /**
- * @typedef {'id'|'string'|'text'|'integer'|'bigint'|'float'|'decimal'|'boolean'|'date'|'datetime'|'timestamp'|'json'|'enum'|'uuid'} ColumnType
+ * @typedef {'id'|'string'|'text'|'integer'|'bigint'|'float'|'decimal'|'boolean'|'date'|'datetime'|'timestamp'|'json'|'array'|'enum'|'uuid'} ColumnType
  */
 
 /**
@@ -75,6 +75,31 @@
  * @property {boolean} [onlyTrashed=false] - Only soft-deleted records
  */
 
+// ============================================================================
+// Admin Panel Types
+// ============================================================================
+
+/**
+ * @typedef {Object} CustomFieldConfig
+ * @property {string} type - Field renderer type (e.g., 'file-upload', 'rich-text')
+ * @property {*} [options] - Additional options for the field renderer
+ */
+
+/**
+ * @typedef {Function} QueryConfig
+ * @param {import('./repository').Repository} repo - Repository instance
+ * @returns {Promise<*>} Query result
+ */
+
+/**
+ * @typedef {Object} AdminMetadata
+ * @property {boolean} [enabled=false] - Whether model is enabled in admin panel
+ * @property {string} [label] - Display label for the model (default: model name)
+ * @property {string} [icon] - Icon for the model (emoji or icon name)
+ * @property {Object.<string, CustomFieldConfig>} [customFields={}] - Custom field configurations
+ * @property {Object.<string, QueryConfig>} [queries={}] - Custom query functions
+ */
+
 // ============================================================================
 // Model Types
 // ============================================================================
@@ -87,6 +112,7 @@
  * @property {string} [primaryKey='id'] - Primary key column name
  * @property {RelationsMap} [relations={}] - Relation definitions
  * @property {ScopeOptions} [scopes={}] - Scope options
+ * @property {AdminMetadata} [admin] - Admin panel metadata
  */
 
 /**
@@ -98,6 +124,7 @@
  * @property {RelationsMap} relations - Relation definitions
  * @property {ScopeOptions} scopes - Scope options
  * @property {Map<string, ColumnMeta>} columns - Parsed column metadata
+ * @property {AdminMetadata} [admin] - Admin panel metadata
  */
 
 // ============================================================================

package/index.js

@@ -30,7 +30,7 @@ const {
 const orm = require('./core/orm');
 
 // Built-in plugins
-const { schemaExplorerPlugin } = require('./plugins');
+const { schemaExplorerPlugin, adminPanelPlugin } = require('./plugins');
 
 module.exports = {
   // Main API
@@ -65,5 +65,6 @@ module.exports = {
   
   // Plugins
   schemaExplorerPlugin,
+  adminPanelPlugin,
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webspresso",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "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/admin-panel/admin-user-model.js

@@ -0,0 +1,42 @@
+/**
+ * Admin User Model
+ * Model definition for admin panel users
+ * @module plugins/admin-panel/admin-user-model
+ */
+
+const { defineModel } = require('../../../core/orm/model');
+const { zdb } = require('../../../core/orm');
+
+/**
+ * AdminUser model schema
+ */
+const AdminUserSchema = zdb.schema({
+  id: zdb.id(),
+  email: zdb.string({ unique: true, maxLength: 255 }),
+  password: zdb.string({ maxLength: 255 }), // Hashed password
+  name: zdb.string({ maxLength: 255 }),
+  role: zdb.string({ maxLength: 50, default: 'admin' }),
+  active: zdb.boolean({ default: true }),
+  created_at: zdb.timestamp({ auto: 'create' }),
+  updated_at: zdb.timestamp({ auto: 'update' }),
+});
+
+/**
+ * Create and register AdminUser model
+ * @returns {import('../../../core/orm/types').ModelDefinition}
+ */
+function createAdminUserModel() {
+  return defineModel({
+    name: 'AdminUser',
+    table: 'admin_users',
+    schema: AdminUserSchema,
+    scopes: {
+      timestamps: true,
+    },
+  });
+}
+
+module.exports = {
+  createAdminUserModel,
+  AdminUserSchema,
+};