domma-cms 0.6.16 → 0.6.21

package/plugins/contacts/config.js

@@ -0,0 +1,6 @@
+export default {
+    scope: 'user',
+    maxPerUser: 5000,
+    // storage.adapter: 'mongodb' uses config/connections.json; 'file' uses local JSON
+    storage: {adapter: 'file'}
+};

package/plugins/contacts/data/contacts.json

@@ -0,0 +1,20 @@
+{
+  "contacts": [
+    {
+      "id": "97bbf711-84ce-41cc-898f-811936e051bc",
+      "name": "Darryl Waterhouse",
+      "email": "",
+      "phone": "+447835449292",
+      "groups": [
+        "Coders"
+      ],
+      "notes": "Ledge",
+      "favourite": true,
+      "userId": "2421ad8e-060d-4548-8878-af7011d5e08b",
+      "createdAt": "2026-03-24T16:43:39.907Z"
+    }
+  ],
+  "groups": [
+    "Coders"
+  ]
+}

package/plugins/contacts/plugin.js

@@ -0,0 +1,351 @@
+import defaultConfig from './config.js';
+import {
+    listEntries,
+    createEntry,
+    updateEntry,
+    deleteEntry,
+    getEntry,
+    getCollection,
+    createCollection
+} from '../../server/services/collections.js';
+
+const CONTACTS_SLUG = 'user-contacts';
+const GROUPS_SLUG = 'user-contact-groups';
+
+const CONTACT_FIELDS = [
+    {name: 'name', label: 'Name', type: 'text', required: true},
+    {name: 'email', label: 'Email', type: 'text', required: false},
+    {name: 'phone', label: 'Phone', type: 'text', required: false},
+    {name: 'groups', label: 'Groups', type: 'text', required: false},
+    {name: 'notes', label: 'Notes', type: 'textarea', required: false},
+    {name: 'favourite', label: 'Favourite', type: 'text', required: false},
+    {name: 'userId', label: 'User ID', type: 'text', required: false}
+];
+
+const GROUP_FIELDS = [
+    {name: 'name', label: 'Group Name', type: 'text', required: true}
+];
+
+/** Map a collection entry to the shape the admin view expects. */
+function toContact(entry) {
+    let groups = entry.data.groups;
+    if (typeof groups === 'string') {
+        try {
+            groups = JSON.parse(groups);
+        } catch {
+            groups = [];
+        }
+    }
+    return {
+        id: entry.id,
+        name: entry.data.name ?? '',
+        email: entry.data.email ?? '',
+        phone: entry.data.phone ?? '',
+        groups: Array.isArray(groups) ? groups : [],
+        notes: entry.data.notes ?? '',
+        favourite: entry.data.favourite === true || entry.data.favourite === 'true',
+        userId: entry.data.userId ?? null,
+        createdAt: entry.meta.createdAt,
+        updatedAt: entry.meta.updatedAt
+    };
+}
+
+function toGroupName(entry) {
+    return entry.data.name ?? '';
+}
+
+/**
+ * Lifecycle: create both collections on plugin enable.
+ */
+export async function onEnable({services: {collections}}) {
+    for (const [slug, title, fields, desc] of [
+        [CONTACTS_SLUG, 'Contacts', CONTACT_FIELDS, 'Contacts managed by the Contacts plugin.'],
+        [GROUPS_SLUG, 'Contact Groups', GROUP_FIELDS, 'Groups for the Contacts plugin.']
+    ]) {
+        const existing = await collections.getCollection(slug).catch(() => null);
+        if (!existing) {
+            await collections.createCollection({title, slug, description: desc, fields});
+        }
+    }
+}
+
+/**
+ * Lifecycle: remove both collections on plugin disable.
+ */
+export async function onDisable({services: {collections}}) {
+    await collections.deleteCollection(CONTACTS_SLUG).catch(() => {
+    });
+    await collections.deleteCollection(GROUPS_SLUG).catch(() => {
+    });
+}
+
+export default async function contactsPlugin(fastify, options) {
+    const {authenticate} = options.auth;
+    const config = {...defaultConfig, ...(options.settings || {})};
+    const scope = config.scope ?? 'user';
+    const storage = config.storage ?? {adapter: 'file'};
+
+    // Auto-create collections if missing.
+    for (const [slug, title, fields, desc] of [
+        [CONTACTS_SLUG, 'Contacts', CONTACT_FIELDS, 'Contacts managed by the Contacts plugin.'],
+        [GROUPS_SLUG, 'Contact Groups', GROUP_FIELDS, 'Groups for the Contacts plugin.']
+    ]) {
+        const existing = await getCollection(slug).catch(() => null);
+        if (!existing) {
+            await createCollection({title, slug, description: desc, fields, storage})
+                .catch(err => fastify.log.warn(`[contacts] Collection setup: ${err.message}`));
+        }
+    }
+
+    function userId(request) {
+        return scope === 'user' ? (request.user?.id ?? request.user?.sub ?? null) : null;
+    }
+
+    async function loadContacts(uid) {
+        const {entries} = await listEntries(CONTACTS_SLUG, {limit: 100000, sort: 'createdAt', order: 'asc'});
+        let items = entries.map(toContact);
+        if (uid) items = items.filter(c => c.userId === uid);
+        return items;
+    }
+
+    async function loadGroups() {
+        const {entries} = await listEntries(GROUPS_SLUG, {limit: 10000, sort: 'createdAt', order: 'asc'});
+        return entries.map(e => ({id: e.id, name: toGroupName(e)}));
+    }
+
+    // -------------------------------------------------------------------------
+    // Contacts CRUD
+    // -------------------------------------------------------------------------
+
+    /** GET /api/plugins/contacts/contacts — supports ?q=, ?group=, ?favourites=true */
+    fastify.get('/contacts', {preHandler: [authenticate]}, async (request, reply) => {
+        const uid = userId(request);
+        const { q, group, favourites } = request.query;
+
+        let result = await loadContacts(uid);
+
+        if (q) {
+            const query = q.toLowerCase();
+            result = result.filter(c =>
+                c.name.toLowerCase().includes(query) ||
+                c.email.toLowerCase().includes(query) ||
+                c.phone.includes(query)
+            );
+        }
+        if (group) {
+            result = result.filter(c => Array.isArray(c.groups) && c.groups.includes(group));
+        }
+        if (favourites === 'true') {
+            result = result.filter(c => c.favourite === true);
+        }
+
+        result.sort((a, b) => a.name.localeCompare(b.name));
+        return reply.send(result);
+    });
+
+    /** POST /api/plugins/contacts/contacts */
+    fastify.post('/contacts', {preHandler: [authenticate]}, async (request, reply) => {
+        const uid = userId(request);
+        const { name, email, phone, groups, notes, favourite } = request.body ?? {};
+
+        if (!name || typeof name !== 'string' || !name.trim()) {
+            return reply.code(400).send({ error: 'name is required' });
+        }
+
+        const entry = await createEntry(CONTACTS_SLUG, {
+            name: name.trim(),
+            email: email?.trim() ?? '',
+            phone: phone?.trim() ?? '',
+            groups: Array.isArray(groups) ? groups : [],
+            notes: notes?.trim() ?? '',
+            favourite: favourite === true,
+            userId: uid ?? null
+        }, {createdBy: uid, source: 'admin'});
+
+        return reply.code(201).send(toContact(entry));
+    });
+
+    /** PUT /api/plugins/contacts/contacts/:id */
+    fastify.put('/contacts/:id', {preHandler: [authenticate]}, async (request, reply) => {
+        const uid = userId(request);
+        const { id } = request.params;
+        const updates = request.body ?? {};
+
+        const entry = await getEntry(CONTACTS_SLUG, id);
+        if (!entry) return reply.code(404).send({error: 'Contact not found'});
+        if (uid && entry.data.userId !== uid) return reply.code(404).send({error: 'Contact not found'});
+
+        const merged = {...entry.data};
+        for (const key of ['name', 'email', 'phone', 'groups', 'notes', 'favourite']) {
+            if (key in updates) merged[key] = updates[key];
+        }
+
+        const updated = await updateEntry(CONTACTS_SLUG, id, merged);
+        return reply.send(toContact(updated));
+    });
+
+    /** DELETE /api/plugins/contacts/contacts/bulk — must be before /:id */
+    fastify.delete('/contacts/bulk', {preHandler: [authenticate]}, async (request, reply) => {
+        const uid = userId(request);
+        const { ids } = request.body ?? {};
+
+        if (!Array.isArray(ids) || ids.length === 0) {
+            return reply.code(400).send({ error: 'ids array is required' });
+        }
+
+        let deleted = 0;
+        for (const id of ids) {
+            const entry = await getEntry(CONTACTS_SLUG, id).catch(() => null);
+            if (!entry) continue;
+            if (uid && entry.data.userId !== uid) continue;
+            await deleteEntry(CONTACTS_SLUG, id).catch(() => {
+            });
+            deleted++;
+        }
+
+        return reply.send({ deleted });
+    });
+
+    /** DELETE /api/plugins/contacts/contacts/:id */
+    fastify.delete('/contacts/:id', {preHandler: [authenticate]}, async (request, reply) => {
+        const uid = userId(request);
+        const { id } = request.params;
+
+        const entry = await getEntry(CONTACTS_SLUG, id);
+        if (!entry) return reply.code(404).send({error: 'Contact not found'});
+        if (uid && entry.data.userId !== uid) return reply.code(404).send({error: 'Contact not found'});
+
+        await deleteEntry(CONTACTS_SLUG, id);
+        return reply.send({ ok: true });
+    });
+
+    // -------------------------------------------------------------------------
+    // Groups CRUD
+    // -------------------------------------------------------------------------
+
+    /** GET /api/plugins/contacts/groups */
+    fastify.get('/groups', {preHandler: [authenticate]}, async (request, reply) => {
+        const groups = await loadGroups();
+        return reply.send(groups.map(g => g.name));
+    });
+
+    /** POST /api/plugins/contacts/groups */
+    fastify.post('/groups', {preHandler: [authenticate]}, async (request, reply) => {
+        const { name } = request.body ?? {};
+
+        if (!name || typeof name !== 'string' || !name.trim()) {
+            return reply.code(400).send({ error: 'name is required' });
+        }
+
+        const trimmed = name.trim();
+        const existing = await loadGroups();
+        if (existing.some(g => g.name === trimmed)) {
+            return reply.code(400).send({ error: 'Group already exists' });
+        }
+
+        await createEntry(GROUPS_SLUG, {name: trimmed}, {source: 'admin'});
+        return reply.code(201).send({ name: trimmed });
+    });
+
+    /** PUT /api/plugins/contacts/groups/:name — rename + cascade */
+    fastify.put('/groups/:name', {preHandler: [authenticate]}, async (request, reply) => {
+        const oldName = decodeURIComponent(request.params.name);
+        const { newName } = request.body ?? {};
+
+        if (!newName || typeof newName !== 'string' || !newName.trim()) {
+            return reply.code(400).send({ error: 'newName is required' });
+        }
+
+        const groups = await loadGroups();
+        const grpEntry = groups.find(g => g.name === oldName);
+        if (!grpEntry) return reply.code(404).send({error: 'Group not found'});
+
+        const trimmed = newName.trim();
+        if (groups.some(g => g.name === trimmed)) {
+            return reply.code(400).send({ error: 'A group with that name already exists' });
+        }
+
+        // Rename the group entry
+        await updateEntry(GROUPS_SLUG, grpEntry.id, {name: trimmed});
+
+        // Cascade rename across all contacts
+        const {entries} = await listEntries(CONTACTS_SLUG, {limit: 100000});
+        for (const entry of entries) {
+            const grps = Array.isArray(entry.data.groups) ? entry.data.groups : [];
+            if (grps.includes(oldName)) {
+                await updateEntry(CONTACTS_SLUG, entry.id, {
+                    ...entry.data,
+                    groups: grps.map(g => (g === oldName ? trimmed : g))
+                });
+            }
+        }
+
+        return reply.send({ name: trimmed });
+    });
+
+    /** DELETE /api/plugins/contacts/groups/:name — delete + cascade */
+    fastify.delete('/groups/:name', {preHandler: [authenticate]}, async (request, reply) => {
+        const name = decodeURIComponent(request.params.name);
+
+        const groups = await loadGroups();
+        const grpEntry = groups.find(g => g.name === name);
+        if (!grpEntry) return reply.code(404).send({error: 'Group not found'});
+
+        // Remove the group entry
+        await deleteEntry(GROUPS_SLUG, grpEntry.id);
+
+        // Cascade: strip group from all contacts
+        const {entries} = await listEntries(CONTACTS_SLUG, {limit: 100000});
+        for (const entry of entries) {
+            const grps = Array.isArray(entry.data.groups) ? entry.data.groups : [];
+            if (grps.includes(name)) {
+                await updateEntry(CONTACTS_SLUG, entry.id, {
+                    ...entry.data,
+                    groups: grps.filter(g => g !== name)
+                });
+            }
+        }
+
+        return reply.send({ ok: true });
+    });
+
+    // -------------------------------------------------------------------------
+    // Import / Export
+    // -------------------------------------------------------------------------
+
+    /** GET /api/plugins/contacts/export */
+    fastify.get('/export', {preHandler: [authenticate]}, async (request, reply) => {
+        const uid = userId(request);
+        const contacts = await loadContacts(uid);
+        return reply
+            .header('Content-Disposition', 'attachment; filename="contacts.json"')
+            .send(contacts);
+    });
+
+    /** POST /api/plugins/contacts/import */
+    fastify.post('/import', {preHandler: [authenticate]}, async (request, reply) => {
+        const uid = userId(request);
+        const { contacts: incoming } = request.body ?? {};
+
+        if (!Array.isArray(incoming)) {
+            return reply.code(400).send({ error: 'contacts array is required' });
+        }
+
+        let imported = 0;
+        for (const raw of incoming) {
+            if (!raw || typeof raw.name !== 'string') continue;
+            await createEntry(CONTACTS_SLUG, {
+                name: raw.name?.trim() ?? '',
+                email: raw.email?.trim() ?? '',
+                phone: raw.phone?.trim() ?? '',
+                groups: Array.isArray(raw.groups) ? raw.groups : [],
+                notes: raw.notes?.trim() ?? '',
+                favourite: raw.favourite === true,
+                userId: uid ?? null
+            }, {source: 'import'});
+            imported++;
+        }
+
+        return reply.send({ imported });
+    });
+}

package/plugins/contacts/plugin.json

@@ -0,0 +1,23 @@
+{
+  "name": "contacts",
+  "displayName": "Contacts",
+  "version": "1.0.0",
+  "description": "Contact manager with groups, favourites, search, and import/export.",
+  "author": "Darryl Waterhouse",
+  "date": "2026-03-24",
+  "icon": "users",
+  "admin": {
+    "sidebar": [
+      { "id": "contacts", "text": "Contacts", "icon": "users", "url": "#/plugins/contacts", "section": "#/plugins/contacts" }
+    ],
+    "routes": [
+      { "path": "/plugins/contacts", "view": "plugin-contacts", "title": "Contacts - Domma CMS" }
+    ],
+    "views": {
+      "plugin-contacts": {
+        "entry": "contacts/admin/views/contacts.js",
+        "exportName": "contactsView"
+      }
+    }
+  }
+}

package/plugins/docs/admin/templates/docs.html

@@ -0,0 +1,69 @@
+<div class="docs-layout" style="display:grid;grid-template-columns:200px 260px 1fr;height:calc(100vh - 120px);gap:0;border:1px solid var(--dm-border);border-radius:var(--dm-radius);overflow:hidden;">
+
+  <!-- Folder sidebar -->
+  <div class="docs-folders" style="border-right:1px solid var(--dm-border);display:flex;flex-direction:column;">
+    <div style="padding:0.75rem;border-bottom:1px solid var(--dm-border);display:flex;align-items:center;justify-content:space-between;">
+      <span style="font-weight:600;font-size:0.85rem;">Folders</span>
+      <button id="new-folder-btn" class="btn btn-sm btn-ghost" title="New Folder">
+        <span data-icon="plus" data-icon-size="14"></span>
+      </button>
+    </div>
+    <div id="folder-sidebar" style="flex:1;overflow-y:auto;padding:0.5rem;"></div>
+  </div>
+
+  <!-- Document list -->
+  <div class="docs-list-pane" style="border-right:1px solid var(--dm-border);display:flex;flex-direction:column;">
+    <div style="padding:0.75rem;border-bottom:1px solid var(--dm-border);">
+        <input id="doc-search" class="form-input form-input-sm" placeholder="Search documents..." style="width:100%;">
+    </div>
+    <div style="padding:0.5rem;border-bottom:1px solid var(--dm-border);display:flex;gap:0.5rem;">
+      <button id="new-doc-btn" class="btn btn-sm btn-primary" style="flex:1;">
+        <span data-icon="plus" data-icon-size="14"></span> New
+      </button>
+      <button id="new-from-template-btn" class="btn btn-sm btn-outline" title="New from Template">
+        <span data-icon="layout" data-icon-size="14"></span>
+      </button>
+    </div>
+    <div id="doc-list" style="flex:1;overflow-y:auto;"></div>
+  </div>
+
+  <!-- Editor pane -->
+  <div style="display:flex;flex-direction:column;overflow:hidden;">
+
+    <!-- Placeholder when no doc is selected -->
+    <div id="editor-placeholder" style="flex:1;display:flex;align-items:center;justify-content:center;color:var(--dm-text-muted);">
+      <div style="text-align:center;">
+        <span data-icon="book-open" data-icon-size="48" style="display:block;margin-bottom:1rem;opacity:0.4;"></span>
+        <p>Select a document to start editing</p>
+      </div>
+    </div>
+
+    <!-- Editor when a doc is open -->
+    <div id="editor-pane" style="display:none;flex-direction:column;flex:1;overflow:hidden;">
+      <!-- Toolbar -->
+      <div style="padding:0.5rem 0.75rem;border-bottom:1px solid var(--dm-border);display:flex;align-items:center;gap:0.5rem;flex-shrink:0;">
+          <input id="doc-title-input" class="form-input" placeholder="Document title"
+          style="flex:1;border:none;font-weight:600;font-size:1rem;background:transparent;outline:none;padding:0.25rem;">
+        <button id="save-doc-btn" class="btn btn-sm btn-primary">
+          <span data-icon="save" data-icon-size="14"></span> Save
+        </button>
+        <button id="find-replace-btn" class="btn btn-sm btn-ghost" title="Find &amp; Replace">
+          <span data-icon="search" data-icon-size="14"></span>
+        </button>
+        <button id="version-history-btn" class="btn btn-sm btn-ghost" title="Version History">
+          <span data-icon="clock" data-icon-size="14"></span>
+        </button>
+        <button id="duplicate-doc-btn" class="btn btn-sm btn-ghost" title="Duplicate Document">
+          <span data-icon="copy" data-icon-size="14"></span>
+        </button>
+        <button id="delete-doc-btn" class="btn btn-sm btn-ghost btn-danger" title="Delete Document">
+          <span data-icon="trash" data-icon-size="14"></span>
+        </button>
+      </div>
+      <!-- Content area -->
+      <div id="doc-editor-content" style="flex:1;overflow-y:auto;padding:1rem;"></div>
+    </div>
+
+  </div>
+
+</div>