domma-cms 0.3.0 → 0.5.2

package/server/services/adapters/MongoAdapter.js

@@ -0,0 +1,220 @@
+/**
+ * MongoAdapter — MongoDB storage adapter for Collection entries. (Pro feature)
+ *
+ * Each CMS collection maps to a MongoDB collection prefixed with `cms_`
+ * (e.g. slug "contacts" → MongoDB collection "cms_contacts").
+ *
+ * Entry format is preserved: { id, data, meta } — identical to FileAdapter output.
+ * MongoDB's _id field is stripped from all returned documents.
+ *
+ * Adapter interface:
+ *   list(slug, opts)          → { entries, total, page, limit }
+ *   get(slug, entryId)        → entry | null
+ *   insert(slug, entry)       → entry
+ *   update(slug, entryId, e)  → entry
+ *   remove(slug, entryId)     → void
+ *   clear(slug)               → void
+ *   all(slug)                 → entry[]
+ *   insertMany(slug, entries) → { imported, skipped, errors }
+ *   count(slug)               → number
+ */
+
+/** Prefix applied to all CMS collection names in MongoDB to avoid collisions. */
+const PREFIX = 'cms_';
+
+/**
+ * Strip MongoDB's internal _id from a document before returning.
+ *
+ * @param {object} doc
+ * @returns {object}
+ */
+function strip(doc) {
+    if (!doc) return null;
+    const { _id, ...rest } = doc;
+    return rest;
+}
+
+export class MongoAdapter {
+
+    /**
+     * @param {import('mongodb').Db} db  - The Db instance from connectionManager
+     */
+    constructor(db) {
+        this._db = db;
+        this._ensured = new Set();
+    }
+
+    /**
+     * Get (and cache) the MongoDB collection for a slug, creating the unique
+     * index on `id` the first time it is accessed.
+     *
+     * @param {string} slug
+     * @returns {Promise<import('mongodb').Collection>}
+     */
+    async _col(slug) {
+        const col = this._db.collection(`${PREFIX}${slug}`);
+        if (!this._ensured.has(slug)) {
+            await col.createIndex({ id: 1 }, { unique: true, sparse: false });
+            this._ensured.add(slug);
+        }
+        return col;
+    }
+
+    /**
+     * List entries with optional pagination, sorting, and search.
+     *
+     * When no search term is provided, pagination and sorting are pushed to MongoDB
+     * for efficiency. When a search term is provided, all documents are fetched and
+     * filtered in memory — identical behaviour to FileAdapter. For large collections
+     * requiring efficient full-text search, configure a MongoDB Atlas Search index.
+     *
+     * @param {string} slug
+     * @param {object} [opts]
+     * @param {number}  [opts.page=1]
+     * @param {number}  [opts.limit=50]
+     * @param {string}  [opts.sort='createdAt']
+     * @param {string}  [opts.order='desc']
+     * @param {string}  [opts.search]
+     * @returns {Promise<{ entries: object[], total: number, page: number, limit: number }>}
+     */
+    async list(slug, { page = 1, limit = 50, sort = 'createdAt', order = 'desc', search } = {}) {
+        const col = await this._col(slug);
+
+        const sortField = sort === 'createdAt' ? 'meta.createdAt' : `data.${sort}`;
+        const sortDir   = order === 'desc' ? -1 : 1;
+
+        if (search) {
+            // Fetch all and filter in memory to avoid $where (often disabled in Atlas).
+            const all = await col
+                .find({}, { projection: { _id: 0 } })
+                .sort({ [sortField]: sortDir })
+                .toArray();
+
+            const term    = search.toLowerCase();
+            const matched = all.filter(entry =>
+                Object.values(entry.data || {}).some(v => String(v).toLowerCase().includes(term))
+            );
+
+            const total  = matched.length;
+            const offset = (page - 1) * limit;
+            return { entries: matched.slice(offset, offset + limit), total, page, limit };
+        }
+
+        const total  = await col.countDocuments({});
+        const offset = (page - 1) * limit;
+
+        const docs = await col
+            .find({}, { projection: { _id: 0 } })
+            .sort({ [sortField]: sortDir })
+            .skip(offset)
+            .limit(limit)
+            .toArray();
+
+        return { entries: docs, total, page, limit };
+    }
+
+    /**
+     * Get a single entry by CMS entry ID.
+     *
+     * @param {string} slug
+     * @param {string} entryId
+     * @returns {Promise<object|null>}
+     */
+    async get(slug, entryId) {
+        const col = await this._col(slug);
+        const doc = await col.findOne({ id: entryId }, { projection: { _id: 0 } });
+        return doc || null;
+    }
+
+    /**
+     * Insert a pre-built entry (with id and meta already set by collections.js).
+     *
+     * @param {string} slug
+     * @param {object} entry
+     * @returns {Promise<object>}
+     */
+    async insert(slug, entry) {
+        const col = await this._col(slug);
+        await col.insertOne({ ...entry });
+        return entry;
+    }
+
+    /**
+     * Replace an existing entry's data and meta.
+     *
+     * @param {string} slug
+     * @param {string} entryId
+     * @param {object} updated  - Full updated entry object
+     * @returns {Promise<object>}
+     * @throws {Error} If entry not found
+     */
+    async update(slug, entryId, updated) {
+        const col    = await this._col(slug);
+        const result = await col.replaceOne({ id: entryId }, { ...updated });
+        if (result.matchedCount === 0) throw new Error('Entry not found');
+        return updated;
+    }
+
+    /**
+     * Delete a single entry by CMS entry ID.
+     *
+     * @param {string} slug
+     * @param {string} entryId
+     * @returns {Promise<void>}
+     * @throws {Error} If entry not found
+     */
+    async remove(slug, entryId) {
+        const col    = await this._col(slug);
+        const result = await col.deleteOne({ id: entryId });
+        if (result.deletedCount === 0) throw new Error('Entry not found');
+    }
+
+    /**
+     * Delete all entries in a collection.
+     *
+     * @param {string} slug
+     * @returns {Promise<void>}
+     */
+    async clear(slug) {
+        const col = await this._col(slug);
+        await col.deleteMany({});
+    }
+
+    /**
+     * Return all entries (used for export).
+     *
+     * @param {string} slug
+     * @returns {Promise<object[]>}
+     */
+    async all(slug) {
+        const col = await this._col(slug);
+        return col.find({}, { projection: { _id: 0 } }).toArray();
+    }
+
+    /**
+     * Bulk-insert pre-built entries (already validated by collections.js).
+     *
+     * @param {string}   slug
+     * @param {object[]} entries
+     * @returns {Promise<{ imported: number, skipped: number, errors: string[] }>}
+     */
+    async insertMany(slug, entries) {
+        if (entries.length === 0) return { imported: 0, skipped: 0, errors: [] };
+        const col = await this._col(slug);
+        await col.insertMany(entries.map(e => ({ ...e })));
+        return { imported: entries.length, skipped: 0, errors: [] };
+    }
+
+    /**
+     * Count total entries in a collection.
+     *
+     * @param {string} slug
+     * @returns {Promise<number>}
+     */
+    async count(slug) {
+        const col = await this._col(slug);
+        return col.countDocuments({});
+    }
+}
+
+export default MongoAdapter;

package/server/services/blocks.js

@@ -0,0 +1,162 @@
+/**
+ * Blocks Service
+ * Seeds default block templates for built-in forms.
+ * Never overwrites existing files — user customisations are preserved.
+ */
+import {access, writeFile} from 'fs/promises';
+import path from 'path';
+import {fileURLToPath} from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const BLOCKS_DIR = path.resolve(__dirname, '../../content/blocks');
+
+/**
+ * Write a block file only if it does not already exist.
+ *
+ * @param {string} name    - Block name (without .html extension)
+ * @param {string} content - HTML template content
+ */
+async function seedBlock(name, content) {
+    const filePath = path.join(BLOCKS_DIR, `${name}.html`);
+    try {
+        await access(filePath);
+        // File exists — leave it alone
+    } catch {
+        await writeFile(filePath, content.trim() + '\n', 'utf8');
+    }
+}
+
+// ---------------------------------------------------------------------------
+// Default block templates
+// ---------------------------------------------------------------------------
+
+const BLOCKS = {
+
+    /**
+     * contact-card — for the Contacts form
+     * Fields: full_name, phone_number, email_address
+     */
+    'contact-card': `
+<div class="card mb-3">
+  <div class="card-body">
+    <div style="display:flex;justify-content:space-between;align-items:flex-start;gap:1rem;flex-wrap:wrap;">
+      <div>
+        <h4 style="margin:0 0 .5rem;font-size:1.05rem;">{{full_name}}</h4>
+        <div style="display:flex;flex-direction:column;gap:.3rem;font-size:.875rem;">
+          <span><strong>Email:</strong> {{email_address}}</span>
+          <span><strong>Phone:</strong> {{phone_number}}</span>
+        </div>
+      </div>
+      <small class="text-muted" style="white-space:nowrap;">{{_createdAt}}</small>
+    </div>
+  </div>
+</div>
+`,
+
+    /**
+     * enquiry-card — for the Enquiries form
+     * Fields: full_name, email, phone, subject, message
+     */
+    'enquiry-card': `
+<div class="card mb-3">
+  <div class="card-header" style="display:flex;justify-content:space-between;align-items:center;gap:.75rem;flex-wrap:wrap;">
+    <div>
+      <strong style="font-size:1rem;">{{subject}}</strong>
+      <span class="text-muted" style="font-size:.8rem;margin-left:.6rem;">from {{full_name}}</span>
+    </div>
+    <small class="text-muted">{{_createdAt}}</small>
+  </div>
+  <div class="card-body">
+    <p style="margin:0 0 1rem;line-height:1.65;">{{message}}</p>
+    <div style="display:flex;gap:1.5rem;font-size:.8rem;color:var(--dm-text-muted,#888);flex-wrap:wrap;">
+      <span><strong>Email:</strong> {{email}}</span>
+      <span><strong>Phone:</strong> {{phone}}</span>
+    </div>
+  </div>
+</div>
+`,
+
+    /**
+     * feedback-card — for the Feedback form
+     * Fields: name, email, rating, category, subject, message, recommend
+     */
+    'feedback-card': `
+<div class="card mb-3">
+  <div class="card-header" style="display:flex;justify-content:space-between;align-items:center;gap:.75rem;flex-wrap:wrap;">
+    <div style="display:flex;align-items:center;gap:.65rem;flex-wrap:wrap;">
+      <strong>{{subject}}</strong>
+      <span class="badge badge-secondary" style="text-transform:capitalize;">{{category}}</span>
+      <span class="badge badge-info" style="text-transform:capitalize;">{{rating}}</span>
+    </div>
+    <small class="text-muted">{{_createdAt}}</small>
+  </div>
+  <div class="card-body">
+    <p style="margin:0 0 1rem;line-height:1.65;">{{message}}</p>
+    <div style="display:flex;justify-content:space-between;align-items:center;flex-wrap:wrap;gap:.5rem;font-size:.8rem;color:var(--dm-text-muted,#888);">
+      <span>{{name}} &mdash; {{email}}</span>
+      <span>Would recommend: <strong>{{recommend}}</strong></span>
+    </div>
+  </div>
+</div>
+`,
+
+    /**
+     * note-card — for the Notes form
+     * Fields: title, content, category, tags
+     */
+    'note-card': `
+<div class="card mb-3">
+  <div class="card-header" style="display:flex;justify-content:space-between;align-items:center;gap:.75rem;flex-wrap:wrap;">
+    <div style="display:flex;align-items:center;gap:.6rem;flex-wrap:wrap;">
+      <strong style="font-size:1rem;">{{title}}</strong>
+      <span class="badge badge-secondary" style="text-transform:capitalize;">{{category}}</span>
+    </div>
+    <small class="text-muted">{{_createdAt}}</small>
+  </div>
+  <div class="card-body">
+    <p style="margin:0 0 .75rem;line-height:1.7;white-space:pre-line;">{{content}}</p>
+    <small class="text-muted">Tags: {{tags}}</small>
+  </div>
+</div>
+`,
+
+    /**
+     * todo-item — for the To-Do form
+     * Fields: title, description, status, priority, due_date, assigned_to
+     */
+    'todo-item': `
+<div class="card mb-2">
+  <div class="card-body" style="display:flex;align-items:flex-start;gap:1rem;flex-wrap:wrap;">
+    <div style="flex:1;min-width:0;">
+      <div style="display:flex;align-items:center;gap:.6rem;flex-wrap:wrap;margin-bottom:.4rem;">
+        <strong style="font-size:.975rem;">{{title}}</strong>
+        <span class="badge badge-warning" style="text-transform:capitalize;">{{priority}}</span>
+        <span class="badge badge-success" style="text-transform:capitalize;">{{status}}</span>
+      </div>
+      <p style="margin:0 0 .5rem;font-size:.875rem;line-height:1.55;color:var(--dm-text-muted,#888);">{{description}}</p>
+      <div style="display:flex;gap:1.5rem;font-size:.8rem;color:var(--dm-text-muted,#888);flex-wrap:wrap;">
+        <span><strong>Due:</strong> {{due_date}}</span>
+        <span><strong>Assigned to:</strong> {{assigned_to}}</span>
+      </div>
+    </div>
+  </div>
+</div>
+`,
+
+};
+
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+
+/**
+ * Seed all default block templates into content/blocks/.
+ * Skips any file that already exists to preserve user customisations.
+ */
+export async function seedDefaultBlocks() {
+    for (const [name, content] of Object.entries(BLOCKS)) {
+        await seedBlock(name, content);
+    }
+    const names = Object.keys(BLOCKS).join(', ');
+    console.log(`[blocks] Seeded default blocks: ${names}`);
+}