webspresso 0.0.108 → 0.0.110

package/CLAUDE.md

@@ -1,54 +0,0 @@
-# Webspresso — Claude Code Assistant Guide
-
-Webspresso is a lightweight, zero-dependency-sprawl full-stack Node.js SSR & API framework.
-
-> [!IMPORTANT]
-> **Authoritative Rules & Architecture**: Always follow [AGENTS.md](AGENTS.md) and the modular topic guides in [.agents/](.agents/AGENTS.md).
-> **API & Types Ground Truth**: Inspect [index.d.ts](index.d.ts) for exact method signatures.
-
----
-
-## ⚡ Essential Commands
-
-```bash
-# Run test suite (Node >= 20 required)
-npm test
-npx vitest run tests/unit/
-npx vitest run tests/integration/
-npx vitest run tests/security/
-
-# Development & diagnostics
-npm run dev
-npx webspresso doctor
-npx webspresso db:migrate
-```
-
----
-
-## 🛡️ Critical Architecture Rules
-
-1. **100% File-Based Routing (NO `routes/` or `app.get()`)**:
-   - All endpoints live in `pages/api/...` with HTTP method extensions:
-     - `pages/api/notes.get.js` → `GET /api/notes`
-     - `pages/api/notes.post.js` → `POST /api/notes`
-     - `pages/api/notes/[id].get.js` → `GET /api/notes/:id`
-     - `pages/api/notes/[id].delete.js` → `DELETE /api/notes/:id`
-   - Contract: `module.exports = { schema: ({ z }) => ({ body, query, params }), middleware: ['auth'], handler: async (req, res) => ... }`
-
-2. **Strict Repository Pattern (NO Raw `db('table')`)**:
-   - Never run raw Knex queries (`req.db('table')`).
-   - Always use `req.db.getRepository('ModelName')` to ensure schema validation, hooks, scopes, and query caching.
-
-3. **Services Layer (NO `controllers/`)**:
-   - Place business logic in `services/domain/action.js` and invoke via `ctx.service('domain.action', input)`.
-
-4. **Zero-Dependency Native Dual Auth**:
-   - Never install `jsonwebtoken`, `passport`, or `express-session`.
-   - Use built-in `req.auth` and `webspresso/core/auth`.
-
-5. **Semantic Exceptions & Page Loaders**:
-   - Throw `NotFoundError`, `ValidationError`, `UnauthorizedError`, `ForbiddenError`.
-   - For SSR pages (`pages/name.njk`), use companion loaders `pages/name.js` exporting `async function load({ req, res, db, ctx })`. Never call `res.render()` manually.
-
-6. **Zero Regression Policy**:
-   - Always run the relevant Vitest tests before declaring any task complete.

package/core/kernel/run-demo.js

@@ -1,58 +0,0 @@
-#!/usr/bin/env node
-/**
- * Demo: PostRepository + plugin + flow. Run: node core/kernel/run-demo.js
- */
-
-const { createApp, defineFlow, BaseRepository } = require('./app');
-const sampleSeo = require('./plugins/sample-seo');
-
-class PostRepository extends BaseRepository {
-  constructor(events) {
-    super(events, { resource: 'post', source: 'orm' });
-  }
-}
-
-async function main() {
-  const app = createApp();
-
-  app.events.on('orm.post.beforeCreate', async () => {
-    console.log('[beforeCreate]');
-  });
-  app.events.on('orm.post.afterCreate', async () => {
-    console.log('[afterCreate]');
-  });
-
-  app.registerPlugin(sampleSeo);
-
-  app.registerFlow(
-    defineFlow({
-      id: 'sitemap-on-publish',
-      trigger: 'orm.post.afterCreate',
-      when: (ctx) => ctx.payload.record?.status === 'published',
-      actions: [
-        async () => {
-          console.log('[flow] Run sitemap update');
-        },
-      ],
-    }),
-  );
-
-  const posts = new PostRepository(app.events);
-
-  console.log('--- create post (published) ---');
-  await posts.create({ title: 'Hello', status: 'published' });
-
-  console.log('\n--- view render (inline plugin template) ---');
-  const html = app.view.renderView('seo::home', { title: 'Kernel' }, {
-    layout: 'seo::main',
-  });
-  console.log(html.slice(0, 120).replace(/\s+/g, ' ') + '...');
-
-  console.log('\n--- partial ---');
-  console.log(app.view.renderPartial('seo::badge', { label: 'new' }));
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/plugins/admin-panel/styles.js

@@ -1,9 +0,0 @@
-/**
- * Admin Panel Styles
- * Additional Tailwind CSS styles for admin panel
- */
-
-module.exports = `
-/* Additional styles can be added here if needed */
-/* Most styling is handled by Tailwind CSS classes */
-`;

package/plugins/data-exchange/export-xlsx.js

@@ -1,119 +0,0 @@
-/**
- * Excel (.xlsx) export using exceljs
- * @module plugins/data-exchange/export-xlsx
- */
-
-let ExcelJS = null;
-function getExcelJS() {
-  if (!ExcelJS) {
-    ExcelJS = require('exceljs');
-  }
-  return ExcelJS;
-}
-const { sanitizeForOutput } = require('../../core/orm/utils');
-const { resolveExportRecords } = require('./record-selection');
-
-/**
- * @param {import('../../core/orm/types').ModelDefinition} model
- * @param {object[]} records
- * @returns {Promise<Buffer>}
- */
-function getModelExportColumns(model, cleanRecords = []) {
-  const hiddenSet = new Set(model.hidden || []);
-  const colSet = new Set();
-  if (model.columns && typeof model.columns.keys === 'function') {
-    for (const c of model.columns.keys()) {
-      if (!hiddenSet.has(c)) colSet.add(c);
-    }
-  }
-  if (model.schema?.shape) {
-    for (const c of Object.keys(model.schema.shape)) {
-      if (!hiddenSet.has(c)) colSet.add(c);
-    }
-  }
-  if (colSet.size === 0 && cleanRecords.length > 0) {
-    for (const c of Object.keys(cleanRecords[0])) {
-      if (!hiddenSet.has(c)) colSet.add(c);
-    }
-  }
-  return Array.from(colSet);
-}
-
-/**
- * @param {import('../../core/orm/types').ModelDefinition} model
- * @param {object[]} records
- * @returns {Promise<Buffer>}
- */
-async function buildXlsxBuffer(model, records) {
-  const clean = sanitizeForOutput(records, model);
-  const columns = getModelExportColumns(model, clean);
-
-  const ExcelLib = getExcelJS();
-  const wb = new ExcelLib.Workbook();
-  const ws = wb.addWorksheet('Export', {
-    views: [{ state: 'frozen', ySplit: 1 }],
-  });
-
-  ws.addRow(columns);
-  const headerRow = ws.getRow(1);
-  headerRow.font = { bold: true };
-
-  for (const rec of clean) {
-    const rowValues = columns.map((c) => {
-      let v = rec[c];
-      if (v === null || v === undefined) return '';
-      if (typeof v === 'bigint') return v.toString();
-      if (v instanceof Date) return v.toISOString();
-      if (Buffer.isBuffer(v)) return v.toString('base64');
-      if (typeof v === 'object') v = JSON.stringify(v);
-      if (typeof v === 'string' && /^[=+\-@]/.test(v)) return ` ${v}`;
-      return v;
-    });
-    ws.addRow(rowValues);
-  }
-
-  const buf = await wb.xlsx.writeBuffer();
-  return Buffer.isBuffer(buf) ? buf : Buffer.from(buf);
-}
-
-/**
- * @param {object} opts
- * @param {import('../../core/orm/database').Database} opts.db
- * @param {number} opts.maxRows
- */
-function createExportXlsxHandler(opts) {
-  const { db, maxRows } = opts;
-
-  return async function exportXlsxHandler(req, res) {
-    try {
-      const modelName = req.params.model || req.query.model;
-      const result = await resolveExportRecords(db, modelName, req);
-      if (result.error) {
-        return res.status(result.error).json({ error: result.message });
-      }
-      const { model, records } = result;
-      if (records.length > maxRows) {
-        return res.status(400).json({
-          error: `Too many rows to export (${records.length}). Limit is ${maxRows}.`,
-        });
-      }
-      const buffer = await buildXlsxBuffer(model, records);
-      const safeName = String(model.name).replace(/[^\w.-]+/g, '_');
-      res.setHeader(
-        'Content-Type',
-        'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
-      );
-      res.setHeader('Content-Disposition', `attachment; filename="${safeName}_export.xlsx"`);
-      res.send(buffer);
-    } catch (err) {
-      console.error('[data-exchange] export xlsx:', err);
-      res.status(500).json({ error: err.message || 'Export failed' });
-    }
-  };
-}
-
-module.exports = {
-  buildXlsxBuffer,
-  createExportXlsxHandler,
-  getModelExportColumns,
-};

package/src/client-runtime/bootstrap-alpine-swup.js

@@ -1,34 +0,0 @@
-/* global Swup, SwupHeadPlugin, SwupScriptsPlugin, Alpine */
-(function () {
-  if (typeof Swup === 'undefined' || typeof SwupHeadPlugin === 'undefined' || typeof SwupScriptsPlugin === 'undefined' || typeof Alpine === 'undefined') {
-    return;
-  }
-
-  function ignoreVisit(url, ctx) {
-    var el = ctx && ctx.el;
-    if (el && el.closest && el.closest('[data-no-swup]')) return true;
-    try {
-      var u = new URL(url, window.location.origin);
-      var p = u.pathname;
-      if (p.indexOf('/_admin') === 0 || p.indexOf('/_webspresso') === 0) return true;
-    } catch (e) {
-      /* ignore */
-    }
-    return false;
-  }
-
-  var swup = new Swup({
-    containers: ['#swup'],
-    plugins: [new SwupHeadPlugin(), new SwupScriptsPlugin()],
-    ignoreVisit: ignoreVisit,
-  });
-
-  swup.hooks.on('content:replace', function () {
-    var root = document.querySelector('#swup');
-    if (root && typeof Alpine.initTree === 'function') {
-      Alpine.initTree(root);
-    }
-  });
-
-  window.__webspressoSwup = swup;
-})();