webspresso 0.0.77 → 0.0.78

package/plugins/content/migration-template.js

@@ -0,0 +1,54 @@
+/**
+ * Migration template for content plugin tables.
+ * @module plugins/content/migration-template
+ */
+
+/**
+ * @param {string} [typesTable='content_types']
+ * @param {string} [entriesTable='content_entries']
+ * @returns {string}
+ */
+function generateContentMigrations(typesTable = 'content_types', entriesTable = 'content_entries') {
+  return `/**
+ * Migration: Create content_types and content_entries tables
+ * Generated by content plugin — customize table names if needed.
+ */
+
+exports.up = async function (knex) {
+  await knex.schema.createTable('${typesTable}', (table) => {
+    table.increments('id').primary();
+    table.string('slug', 128).notNullable().unique();
+    table.string('name', 255).notNullable();
+    table.text('description').nullable();
+    table.json('schema').notNullable();
+    table.json('settings').nullable();
+    table.timestamp('created_at').defaultTo(knex.fn.now()).notNullable();
+    table.timestamp('updated_at').defaultTo(knex.fn.now()).notNullable();
+  });
+
+  await knex.schema.createTable('${entriesTable}', (table) => {
+    table.increments('id').primary();
+    table.integer('content_type_id').unsigned().notNullable()
+      .references('id').inTable('${typesTable}').onDelete('CASCADE');
+    table.string('slug', 128).notNullable();
+    table.string('title', 255).nullable();
+    table.json('data').notNullable();
+    table.string('status', 32).notNullable().defaultTo('published');
+    table.string('locale', 16).nullable();
+    table.integer('revision').notNullable().defaultTo(1);
+    table.timestamp('created_at').defaultTo(knex.fn.now()).notNullable();
+    table.timestamp('updated_at').defaultTo(knex.fn.now()).notNullable();
+
+    table.unique(['content_type_id', 'slug', 'locale']);
+    table.index(['content_type_id', 'status']);
+  });
+};
+
+exports.down = async function (knex) {
+  await knex.schema.dropTableIfExists('${entriesTable}');
+  await knex.schema.dropTableIfExists('${typesTable}');
+};
+`;
+}
+
+module.exports = { generateContentMigrations };

package/plugins/content/models/content-entry.js

@@ -0,0 +1,45 @@
+/**
+ * ContentEntry model — content entries with JSON field data.
+ * @module plugins/content/models/content-entry
+ */
+
+const { defineModel } = require('../../../core/orm/model');
+const { zdb } = require('../../../core/orm');
+
+const ContentEntrySchema = zdb.schema({
+  id: zdb.id(),
+  content_type_id: zdb.foreignKey('content_types', { index: true }),
+  slug: zdb.string({ maxLength: 128, index: true }),
+  title: zdb.string({ maxLength: 255, nullable: true }),
+  data: zdb.json(),
+  status: zdb.enum(['published', 'draft'], { default: 'published', index: true }),
+  locale: zdb.string({ maxLength: 16, nullable: true, index: true }),
+  revision: zdb.integer({ default: 1 }),
+  created_at: zdb.timestamp({ auto: 'create' }),
+  updated_at: zdb.timestamp({ auto: 'update' }),
+});
+
+/**
+ * @returns {import('../../../core/orm/types').ModelDefinition}
+ */
+function createContentEntryModel() {
+  return defineModel({
+    name: 'ContentEntry',
+    table: 'content_entries',
+    schema: ContentEntrySchema,
+    scopes: { timestamps: true },
+    admin: { enabled: false },
+    relations: {
+      contentType: {
+        type: 'belongsTo',
+        model: () => require('../../../core/orm/model').getModel('ContentType'),
+        foreignKey: 'content_type_id',
+      },
+    },
+  });
+}
+
+module.exports = {
+  createContentEntryModel,
+  ContentEntrySchema,
+};

package/plugins/content/models/content-type.js

@@ -0,0 +1,36 @@
+/**
+ * ContentType model — schema-driven content type definitions.
+ * @module plugins/content/models/content-type
+ */
+
+const { defineModel } = require('../../../core/orm/model');
+const { zdb } = require('../../../core/orm');
+
+const ContentTypeSchema = zdb.schema({
+  id: zdb.id(),
+  slug: zdb.string({ unique: true, maxLength: 128, index: true }),
+  name: zdb.string({ maxLength: 255 }),
+  description: zdb.text({ nullable: true }),
+  schema: zdb.json(),
+  settings: zdb.json({ nullable: true }),
+  created_at: zdb.timestamp({ auto: 'create' }),
+  updated_at: zdb.timestamp({ auto: 'update' }),
+});
+
+/**
+ * @returns {import('../../../core/orm/types').ModelDefinition}
+ */
+function createContentTypeModel() {
+  return defineModel({
+    name: 'ContentType',
+    table: 'content_types',
+    schema: ContentTypeSchema,
+    scopes: { timestamps: true },
+    admin: { enabled: false },
+  });
+}
+
+module.exports = {
+  createContentTypeModel,
+  ContentTypeSchema,
+};

package/plugins/index.js

@@ -21,6 +21,7 @@ const { uploadPlugin, createLocalFileProvider } = require('./upload');
 const { dataExchangePlugin } = require('./data-exchange');
 const { redirectPlugin } = require('./redirect');
 const { rateLimitPlugin } = require('./rate-limit');
+const contentPlugin = require('./content');
 
 module.exports = {
   sitemapPlugin,
@@ -41,5 +42,6 @@ module.exports = {
   dataExchangePlugin,
   redirectPlugin,
   rateLimitPlugin,
+  contentPlugin,
 };
 

package/src/file-router.js

@@ -810,6 +810,13 @@ function mountPages(app, options) {
         // Create context with plugin helpers merged
         const baseHelpers = createHelpers({ req, res, locale });
         const pluginHelpers = pluginManager ? pluginManager.getHelpers() : {};
+        if (pluginManager) {
+          const contentApi = pluginManager.getPluginAPI('content');
+          if (contentApi?.createRequestHelpers) {
+            const buildHelpers = contentApi.createRequestHelpers();
+            pluginHelpers.content = buildHelpers(req);
+          }
+        }
         
         const njkTpl = loadNjkRouteTemplate(route.fullPath, isDev);
 
@@ -863,6 +870,12 @@ function mountPages(app, options) {
         await executeHook(routeHooks, 'afterMiddleware', ctx);
         
         // Execute hooks: beforeLoad
+        if (pluginManager && db) {
+          const contentApi = pluginManager.getPluginAPI('content');
+          if (contentApi?.getContentService) {
+            ctx.content = contentApi.getContentService(db);
+          }
+        }
         await executeHook(globalHooks, 'beforeLoad', ctx);
         await executeHook(routeHooks, 'beforeLoad', ctx);
         
@@ -908,10 +921,17 @@ function mountPages(app, options) {
         
         // Render the template
         const templatePath = route.file.split(path.sep).join('/');
-        const html =
+        let html =
           njkTpl.useStringRender && njkTpl.templateBody != null
             ? nunjucks.renderString(njkTpl.templateBody, renderContext, { path: route.fullPath })
             : nunjucks.render(templatePath, renderContext);
+
+        if (pluginManager) {
+          const contentApi = pluginManager.getPluginAPI('content');
+          if (contentApi?.maybeInjectInlineEdit) {
+            html = contentApi.maybeInjectInlineEdit(req, html);
+          }
+        }
         
         // Execute hooks: afterRender
         ctx.html = html;

package/templates/skills/webspresso-usage/REFERENCE-framework.md

@@ -178,7 +178,7 @@ Analytics plugin adds `fsy.analyticsHead`, `fsy.verificationTags`, etc., when co
 
 **Query builder:** `UserRepo.query().where(...).with('relation').orderBy(...).list()` / `.first()` / `.paginate()` / `.count()`. **`with()`** eager-loads relations; **`count()`** ignores builder `.limit`/`.offset` for total; see ORM docs for edge cases.
 
-**Migrations:** `webspresso db:migrate`, `db:rollback`, `db:status`, `db:make`.
+**Migrations:** `webspresso db:migrate`, `db:rollback`, `db:status`, `db:make`, `db:scaffold` (all models → create migrations).
 
 **Transactions:** `db.transaction(async (trx) => { trx.getRepository('User') })`.
 

package/templates/skills/webspresso-usage/SKILL.md

@@ -21,6 +21,7 @@ There are **three** files in this folder; open the reference that matches the ta
 | Greenfield project, `webspresso new`, `dev`, `db:migrate`, `doctor` | [`REFERENCE-framework.md`](./REFERENCE-framework.md) § CLI | Full command table there. |
 | Event bus, `kernel.createApp`, `defineFlow`, `definePlugin`, simulated `BaseRepository`, namespaced minimal views | [`REFERENCE-kernel.md`](./REFERENCE-kernel.md) | **Not** SSR **`createApp`** — [`doc/index.html#application-kernel`](../../../doc/index.html#application-kernel). |
 | Long-form narrative, all options | [`README.md`](../../../README.md), [`doc/index.html`](../../../doc/index.html) | Single-page HTML docs. |
+| System structure, feature sets, C4 map | [`docs/ARCHITECTURE.md`](../../../docs/ARCHITECTURE.md) | **Update when adding plugins, CLI commands, or extension points.** |
 
 ## CLI cheat sheet
 
@@ -40,3 +41,7 @@ There are **three** files in this folder; open the reference that matches the ta
 - **`REFERENCE-kernel.md`:** `kernel`, domain events, `dispatch` / `publish`, `registerFlow`, `definePlugin` inside the kernel.
 
 They are independent: most apps only need SSR **`createApp`**; the kernel is optional.
+
+## Architecture maintenance
+
+When you add or materially change a **plugin**, **CLI command**, **extension point**, or **request-pipeline rule**, update [`docs/ARCHITECTURE.md`](../../../docs/ARCHITECTURE.md) (feature-set section + changelog).