domma-cms 0.10.0 → 0.12.0

package/plugins/garage/collections/garage-vehicles/schema.json

@@ -1,101 +0,0 @@
-{
-  "slug": "garage-vehicles",
-  "title": "Garage Vehicles",
-  "description": "Vehicle registrations managed by the Garage plugin.",
-  "plugin": "garage",
-  "fields": [
-    {
-      "name": "userId",
-      "label": "User ID",
-      "type": "text",
-      "required": true
-    },
-    {
-      "name": "registrationNumber",
-      "label": "Registration",
-      "type": "text",
-      "required": true
-    },
-    {
-      "name": "make",
-      "label": "Make",
-      "type": "text"
-    },
-    {
-      "name": "colour",
-      "label": "Colour",
-      "type": "text"
-    },
-    {
-      "name": "yearOfManufacture",
-      "label": "Year",
-      "type": "text"
-    },
-    {
-      "name": "fuelType",
-      "label": "Fuel Type",
-      "type": "text"
-    },
-    {
-      "name": "engineCapacity",
-      "label": "Engine Capacity",
-      "type": "text"
-    },
-    {
-      "name": "co2Emissions",
-      "label": "CO2 Emissions",
-      "type": "text"
-    },
-    {
-      "name": "motStatus",
-      "label": "MOT Status",
-      "type": "text"
-    },
-    {
-      "name": "motExpiryDate",
-      "label": "MOT Expiry",
-      "type": "text"
-    },
-    {
-      "name": "taxStatus",
-      "label": "Tax Status",
-      "type": "text"
-    },
-    {
-      "name": "taxDueDate",
-      "label": "Tax Due",
-      "type": "text"
-    },
-    {
-      "name": "isSaved",
-      "label": "Saved",
-      "type": "text"
-    },
-    {
-      "name": "lookupDate",
-      "label": "Lookup Date",
-      "type": "text"
-    }
-  ],
-  "api": {
-    "create": {
-      "enabled": false,
-      "access": "admin"
-    },
-    "read": {
-      "enabled": false,
-      "access": "admin"
-    },
-    "update": {
-      "enabled": false,
-      "access": "admin"
-    },
-    "delete": {
-      "enabled": false,
-      "access": "admin"
-    }
-  },
-  "storage": {
-    "adapter": "file"
-  }
-}

package/plugins/garage/config.js

@@ -1,18 +0,0 @@
-/**
- * Garage Plugin — Default Configuration
- *
- * Override any of these via config/plugins.json under "garage.settings".
- */
-export default {
-    /** DVLA Vehicle Enquiry Service API key. Obtain from developer-portal.driver-vehicle-licensing.api.gov.uk */
-    dvlaApiKey: '',
-    /** DVLA API endpoint — do not change unless DVLA updates their URL. */
-    dvlaApiUrl: 'https://driver-vehicle-licensing.api.gov.uk/vehicle-enquiry/v1/vehicles',
-    /** Per-user rate limiting for the /lookup endpoint. */
-    rateLimit: {
-        max: 10,
-        windowSeconds: 60
-    },
-    /** Maximum lookup history entries to retain per user (oldest unsaved entries are pruned first). */
-    maxHistoryItems: 100
-};

package/plugins/garage/data/vehicles.json

@@ -1,70 +0,0 @@
-[
-  {
-    "id": "d1757874-3a2d-4894-99ae-57fd934a9a8b",
-    "userId": "2421ad8e-060d-4548-8878-af7011d5e08b",
-    "registrationNumber": "GIL7698",
-    "make": "BMW",
-    "colour": "GREY",
-    "yearOfManufacture": 2017,
-    "fuelType": "DIESEL",
-    "engineCapacity": 1995,
-    "co2Emissions": 134,
-    "motStatus": "Valid",
-    "motExpiryDate": "2027-03-26",
-    "taxStatus": "Taxed",
-    "taxDueDate": "2027-03-01",
-    "isSaved": true,
-    "lookupDate": "2026-03-28T21:32:31.725Z"
-  },
-  {
-    "id": "3503abbc-5bb9-4f96-9b13-1ab389f557b4",
-    "userId": "2421ad8e-060d-4548-8878-af7011d5e08b",
-    "registrationNumber": "LF16BMV",
-    "make": "TESLA",
-    "colour": "BLUE",
-    "yearOfManufacture": 2016,
-    "fuelType": "ELECTRICITY",
-    "engineCapacity": 0,
-    "co2Emissions": 0,
-    "motStatus": "Valid",
-    "motExpiryDate": "2026-12-16",
-    "taxStatus": "Taxed",
-    "taxDueDate": "2026-12-01",
-    "isSaved": true,
-    "lookupDate": "2026-03-28T21:32:48.814Z"
-  },
-  {
-    "id": "c50c6b66-bc48-4bd1-a8fc-7dbc669f61b5",
-    "userId": "2421ad8e-060d-4548-8878-af7011d5e08b",
-    "registrationNumber": "CN64NFR",
-    "make": "FORD",
-    "colour": "RED",
-    "yearOfManufacture": 2014,
-    "fuelType": "PETROL",
-    "engineCapacity": 1242,
-    "co2Emissions": 115,
-    "motStatus": "Valid",
-    "motExpiryDate": "2027-01-25",
-    "taxStatus": "Taxed",
-    "taxDueDate": "2027-01-01",
-    "isSaved": true,
-    "lookupDate": "2026-03-28T21:32:55.731Z"
-  },
-  {
-    "id": "cfd54f2a-7bab-469d-b929-d682a1313154",
-    "userId": "2421ad8e-060d-4548-8878-af7011d5e08b",
-    "registrationNumber": "PK75SFO",
-    "make": "VOLKSWAGEN",
-    "colour": "BLUE",
-    "yearOfManufacture": 2025,
-    "fuelType": "PETROL",
-    "engineCapacity": 999,
-    "co2Emissions": 121,
-    "motStatus": "No details held by DVLA",
-    "motExpiryDate": null,
-    "taxStatus": "Taxed",
-    "taxDueDate": "2026-10-01",
-    "isSaved": true,
-    "lookupDate": "2026-03-28T21:49:25.814Z"
-  }
-]

package/plugins/garage/plugin.js

@@ -1,398 +0,0 @@
-/**
- * Garage Plugin — Backend
- *
- * Proxies DVLA vehicle lookups and stores per-user vehicle history via the
- * CMS collections service (garage-vehicles collection). Uses MongoDB when
- * configured, falls back to file-based storage automatically.
- * All routes are mounted at /api/plugins/garage/ by the plugin system.
- *
- * Routes:
- *   POST /lookup             — Proxy DVLA lookup, upsert into history
- *   GET  /vehicles           — Saved vehicles for the authenticated user
- *   GET  /history            — Full lookup history for the authenticated user
- *   PATCH /vehicles/:id/save — Toggle isSaved on a vehicle entry
- *   DELETE /vehicles/:id     — Remove a vehicle entry from history
- */
-import fs from 'fs';
-import path from 'path';
-import {fileURLToPath} from 'url';
-import {
-    createEntry,
-    deleteEntry,
-    getEntry,
-    listEntries,
-    updateEntry
-} from '../../server/services/collections.js';
-import defaultConfig from './config.js';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const COLLECTION = 'garage-vehicles';
-const VEHICLES_DATA = path.join(__dirname, '../../content/collections/garage-vehicles/data.json');
-
-/** In-memory rate limit tracker: Map<userId, { count: number, windowStart: number }> */
-const rateLimits = new Map();
-
-
-/**
- * Flatten a collection entry into the vehicle model the frontend expects.
- *
- * @param {{ id: string, data: object }} entry
- * @returns {object}
- */
-function toVehicle(entry) {
-    return {
-        id: entry.id,
-        ...entry.data,
-        isSaved: entry.data.isSaved === true || entry.data.isSaved === 'true'
-    };
-}
-
-/**
- * Check and increment the per-user rate limit.
- *
- * @param {string} userId
- * @param {{ max: number, windowSeconds: number }} config
- * @returns {{ allowed: boolean, retryAfter: number }} retryAfter is seconds until reset (0 if allowed)
- */
-function checkRateLimit(userId, config) {
-    const now = Date.now();
-    const windowMs = config.windowSeconds * 1000;
-    const entry = rateLimits.get(userId);
-
-    if (!entry || now - entry.windowStart >= windowMs) {
-        rateLimits.set(userId, {count: 1, windowStart: now});
-        return {allowed: true, retryAfter: 0};
-    }
-
-    if (entry.count >= config.max) {
-        const retryAfter = Math.ceil((entry.windowStart + windowMs - now) / 1000);
-        return {allowed: false, retryAfter};
-    }
-
-    entry.count += 1;
-    return {allowed: true, retryAfter: 0};
-}
-
-/**
- * Normalise a registration number: uppercase and strip all spaces.
- *
- * @param {string} reg
- * @returns {string}
- */
-function normaliseReg(reg) {
-    return String(reg).toUpperCase().replace(/\s+/g, '');
-}
-
-/**
- * Map a DVLA API response to our internal vehicle data shape.
- *
- * @param {string} userId
- * @param {object} dvlaData - Raw response from DVLA API
- * @returns {object}
- */
-function mapDvlaResponse(userId, dvlaData) {
-    return {
-        userId,
-        registrationNumber: dvlaData.registrationNumber ?? '',
-        make: dvlaData.make ?? '',
-        colour: dvlaData.colour ?? '',
-        yearOfManufacture: dvlaData.yearOfManufacture ?? null,
-        fuelType: dvlaData.fuelType ?? '',
-        engineCapacity: dvlaData.engineCapacity ?? null,
-        co2Emissions: dvlaData.co2Emissions ?? null,
-        motStatus: dvlaData.motStatus ?? '',
-        motExpiryDate: dvlaData.motExpiryDate ?? null,
-        taxStatus: dvlaData.taxStatus ?? '',
-        taxDueDate: dvlaData.taxDueDate ?? null,
-        isSaved: false,
-        lookupDate: new Date().toISOString()
-    };
-}
-
-/**
- * Escape HTML special characters for safe server-side rendering.
- *
- * @param {*} str
- * @returns {string}
- */
-function escHtml(str) {
-    return String(str ?? '')
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
-
-/**
- * Render a list of saved vehicle objects as a static HTML card grid.
- * Used by the [garage-vehicles /] shortcode for front-end display.
- *
- * @param {object[]} vehicles
- * @returns {string} HTML string
- */
-function renderVehiclesHtml(vehicles) {
-    const cards = vehicles.map(v => {
-        const motLv = (v.motStatus || '').toLowerCase();
-        const motCls = motLv === 'valid' ? 'badge-success' : motLv ? 'badge-danger' : 'badge-secondary';
-        const taxLv = (v.taxStatus || '').toLowerCase();
-        const taxCls = taxLv === 'taxed' ? 'badge-success' : taxLv === 'sorn' ? 'badge-warning' : taxLv ? 'badge-danger' : 'badge-secondary';
-
-        const details = [
-            v.colour,
-            v.fuelType,
-            v.engineCapacity ? `${v.engineCapacity}cc` : null,
-            v.co2Emissions ? `${v.co2Emissions}g/km` : null
-        ].filter(Boolean).join(' · ');
-
-        const motExpiry = v.motExpiryDate
-            ? `<span style="font-size:0.78rem;color:var(--dm-text-muted,#888);">Exp ${escHtml(v.motExpiryDate)}</span>` : '';
-        const taxDue = v.taxDueDate
-            ? `<span style="font-size:0.78rem;color:var(--dm-text-muted,#888);">Due ${escHtml(v.taxDueDate)}</span>` : '';
-
-        return `<div class="card" style="flex:1;min-width:260px;max-width:340px;">
-  <div class="card-header" style="display:flex;align-items:center;justify-content:space-between;gap:0.75rem;">
-    <span style="background:#FFD900;color:#000;font-family:'Arial Black',Arial,sans-serif;font-weight:900;font-size:1rem;letter-spacing:3px;padding:0.15rem 0.5rem;border-radius:4px;border:2px solid #000;">${escHtml(v.registrationNumber || '')}</span>
-    <span style="font-size:0.85rem;color:var(--dm-text-muted,#888);">${escHtml(v.make || '')}${v.yearOfManufacture ? ` · ${escHtml(String(v.yearOfManufacture))}` : ''}</span>
-  </div>
-  <div class="card-body">
-    ${details ? `<p style="font-size:0.85rem;color:var(--dm-text-muted,#888);margin:0 0 0.6rem;">${escHtml(details)}</p>` : ''}
-    <div style="display:flex;gap:0.4rem;flex-wrap:wrap;align-items:center;">
-      <span class="badge ${motCls}">MOT: ${escHtml(v.motStatus || 'Unknown')}</span>
-      ${motExpiry}
-      <span class="badge ${taxCls}">Tax: ${escHtml(v.taxStatus || 'Unknown')}</span>
-      ${taxDue}
-    </div>
-  </div>
-</div>`;
-    }).join('\n');
-
-    return `<div style="display:flex;flex-wrap:wrap;gap:1rem;">\n${cards}\n</div>`;
-}
-
-export default async function garagePlugin(fastify, options) {
-    const {authenticate} = options.auth;
-    const {registerShortcode} = options.hooks;
-    const cfg = {...defaultConfig, ...(options.settings || {})};
-    cfg.dvlaApiKey = process.env.DVLA_API_KEY || cfg.dvlaApiKey;
-
-    // --- [garage-vehicles /] shortcode --------------------------------------
-
-    /**
-     * Renders saved vehicles as a static HTML card grid on public pages.
-     * Reads data synchronously so it fits the markdown pipeline.
-     *
-     * Usage:
-     *   [garage-vehicles /]                   — all saved vehicles
-     *   [garage-vehicles user="uuid" /]        — one user's saved vehicles
-     */
-    registerShortcode('garage-vehicles', (attrStr, _body, ctx) => {
-        const attrs = ctx.parseShortcodeAttrs(attrStr);
-        const userId = attrs.user || null;
-
-        let entries;
-        try {
-            entries = JSON.parse(fs.readFileSync(VEHICLES_DATA, 'utf8'));
-        } catch {
-            return '';
-        }
-
-        let vehicles = entries
-            .filter(e => e.data && (e.data.isSaved === true || e.data.isSaved === 'true'))
-            .map(e => ({id: e.id, ...e.data, isSaved: true}));
-
-        if (userId) vehicles = vehicles.filter(v => v.userId === userId);
-        if (!vehicles.length) return '';
-
-        return renderVehiclesHtml(vehicles);
-    });
-
-    // --- POST /lookup -------------------------------------------------------
-
-    /**
-     * Proxy a DVLA vehicle lookup and upsert the result into the user's history.
-     * Returns 503 if no DVLA API key is configured.
-     * Returns 429 if the user has exceeded the rate limit.
-     */
-    fastify.post('/lookup', {preHandler: [authenticate]}, async (request, reply) => {
-        const userId = request.user.id;
-        const {registrationNumber} = request.body || {};
-
-        if (!registrationNumber || typeof registrationNumber !== 'string') {
-            return reply.status(400).send({error: 'registrationNumber is required'});
-        }
-
-        const reg = normaliseReg(registrationNumber);
-        if (!reg) {
-            return reply.status(400).send({error: 'Invalid registration number'});
-        }
-
-        const rl = checkRateLimit(userId, cfg.rateLimit);
-        if (!rl.allowed) {
-            return reply.status(429).send({
-                error: `Rate limit reached. Try again in ${rl.retryAfter} seconds.`,
-                retryAfter: rl.retryAfter
-            });
-        }
-
-        if (!cfg.dvlaApiKey) {
-            return reply.status(503).send({
-                error: 'DVLA API key not configured. Add dvlaApiKey to the Garage plugin settings in config/plugins.json.'
-            });
-        }
-
-        let dvlaData;
-        try {
-            const dvlaRes = await fetch(cfg.dvlaApiUrl, {
-                method: 'POST',
-                headers: {
-                    'x-api-key': cfg.dvlaApiKey,
-                    'Content-Type': 'application/json'
-                },
-                body: JSON.stringify({registrationNumber: reg})
-            });
-
-            if (dvlaRes.status === 404) {
-                return reply.status(404).send({error: 'Vehicle not found. Check the registration number.'});
-            }
-            if (!dvlaRes.ok) {
-                const body = await dvlaRes.text().catch(() => '');
-                fastify.log.warn({status: dvlaRes.status, body}, '[garage] DVLA API error');
-                return reply.status(502).send({error: 'DVLA API returned an error. Please try again.'});
-            }
-
-            dvlaData = await dvlaRes.json();
-        } catch (err) {
-            fastify.log.error({err}, '[garage] Failed to reach DVLA API');
-            return reply.status(502).send({error: 'Could not reach the DVLA API. Check your network connection.'});
-        }
-
-        // Upsert: update existing entry if same reg+user, otherwise create
-        const {entries: all} = await listEntries(COLLECTION, {limit: 10000});
-        const existing = all.find(e => e.data.userId === userId && e.data.registrationNumber === reg);
-
-        let vehicle;
-        if (existing) {
-            const updated = await updateEntry(COLLECTION, existing.id, {
-                ...mapDvlaResponse(userId, dvlaData),
-                isSaved: existing.data.isSaved
-            });
-            vehicle = toVehicle(updated);
-        } else {
-            const created = await createEntry(COLLECTION, mapDvlaResponse(userId, dvlaData), {createdBy: userId});
-            vehicle = toVehicle(created);
-
-            // Prune oldest unsaved entries if over the history limit
-            const {entries: fresh} = await listEntries(COLLECTION, {limit: 10000});
-            const userEntries = fresh.filter(e => e.data.userId === userId);
-            if (userEntries.length > cfg.maxHistoryItems) {
-                const unsaved = userEntries
-                    .filter(e => !e.data.isSaved)
-                    .sort((a, b) => new Date(a.data.lookupDate) - new Date(b.data.lookupDate));
-                const toDelete = unsaved.slice(0, userEntries.length - cfg.maxHistoryItems);
-                for (const entry of toDelete) {
-                    await deleteEntry(COLLECTION, entry.id);
-                }
-            }
-        }
-
-        return vehicle;
-    });
-
-    // --- GET /vehicles (saved) ----------------------------------------------
-
-    /**
-     * Return all vehicles the authenticated user has saved to their garage.
-     * Supports optional ?q= for server-side search across reg/make/colour/year/fuel.
-     */
-    fastify.get('/vehicles', {preHandler: [authenticate]}, async (request) => {
-        const userId = request.user.id;
-        const q = (request.query.q || '').toLowerCase().trim();
-
-        const {entries} = await listEntries(COLLECTION, {limit: 10000});
-        let results = entries
-            .filter(e => e.data.userId === userId && (e.data.isSaved === true || e.data.isSaved === 'true'))
-            .map(toVehicle);
-
-        if (q) {
-            results = results.filter(v => {
-                const haystack = [
-                    v.registrationNumber, v.make, v.colour,
-                    v.yearOfManufacture, v.fuelType, v.taxStatus, v.motStatus
-                ].join(' ').toLowerCase();
-                return haystack.includes(q);
-            });
-        }
-
-        return results;
-    });
-
-    // --- GET /history -------------------------------------------------------
-
-    /**
-     * Return the authenticated user's full lookup history, newest first.
-     * Supports optional ?q= search.
-     */
-    fastify.get('/history', {preHandler: [authenticate]}, async (request) => {
-        const userId = request.user.id;
-        const q = (request.query.q || '').toLowerCase().trim();
-
-        const {entries} = await listEntries(COLLECTION, {limit: 10000});
-        let results = entries
-            .filter(e => e.data.userId === userId)
-            .map(toVehicle)
-            .sort((a, b) => new Date(b.lookupDate) - new Date(a.lookupDate));
-
-        if (q) {
-            results = results.filter(v => {
-                const haystack = [
-                    v.registrationNumber, v.make, v.colour,
-                    v.yearOfManufacture, v.fuelType, v.taxStatus, v.motStatus
-                ].join(' ').toLowerCase();
-                return haystack.includes(q);
-            });
-        }
-
-        return results;
-    });
-
-    // --- PATCH /vehicles/:id/save -------------------------------------------
-
-    /**
-     * Toggle the isSaved flag on a vehicle entry.
-     * Returns 404 if the entry does not exist or belongs to another user.
-     */
-    fastify.patch('/vehicles/:id/save', {preHandler: [authenticate]}, async (request, reply) => {
-        const userId = request.user.id;
-        const {id} = request.params;
-
-        const entry = await getEntry(COLLECTION, id);
-        if (!entry || entry.data.userId !== userId) {
-            return reply.status(404).send({error: 'Vehicle not found'});
-        }
-
-        const updated = await updateEntry(COLLECTION, id, {
-            ...entry.data,
-            isSaved: !(entry.data.isSaved === true || entry.data.isSaved === 'true')
-        });
-        return toVehicle(updated);
-    });
-
-    // --- DELETE /vehicles/:id -----------------------------------------------
-
-    /**
-     * Permanently remove a vehicle entry from the user's history.
-     * Returns 404 if the entry does not exist or belongs to another user.
-     */
-    fastify.delete('/vehicles/:id', {preHandler: [authenticate]}, async (request, reply) => {
-        const userId = request.user.id;
-        const {id} = request.params;
-
-        const entry = await getEntry(COLLECTION, id);
-        if (!entry || entry.data.userId !== userId) {
-            return reply.status(404).send({error: 'Vehicle not found'});
-        }
-
-        await deleteEntry(COLLECTION, id);
-        return {ok: true};
-    });
-}

package/plugins/garage/plugin.json

@@ -1,33 +0,0 @@
-{
-  "name": "garage",
-  "displayName": "Garage",
-  "version": "1.0.0",
-  "description": "UK vehicle management with DVLA API lookup, save vehicles, and search history.",
-  "author": "Darryl Waterhouse",
-  "date": "2026-03-28",
-  "icon": "truck",
-  "admin": {
-    "sidebar": [
-      {
-        "id": "garage",
-        "text": "Garage",
-        "icon": "truck",
-        "url": "#/plugins/garage",
-        "section": "#/plugins/garage"
-      }
-    ],
-    "routes": [
-      {
-        "path": "/plugins/garage",
-        "view": "plugin-garage",
-        "title": "Garage - Domma CMS"
-      }
-    ],
-    "views": {
-      "plugin-garage": {
-        "entry": "garage/admin/views/garage.js?v=4",
-        "exportName": "garageView"
-      }
-    }
-  }
-}