domma-cms 0.15.0 → 0.16.0

package/plugins/invoice/admin/views/index.js

@@ -0,0 +1,155 @@
+/**
+ * Invoice plugin — list view.
+ */
+function escapeHtml(s) {
+    return String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;');
+}
+
+const BASE = '/api/plugins/invoice';
+
+const STATUS_BADGE = {
+    draft:     'badge-secondary',
+    sent:      'badge-info',
+    paid:      'badge-success',
+    overdue:   'badge-danger',
+    cancelled: 'badge-secondary'
+};
+
+export const indexView = {
+    templateUrl: '/plugins/invoice/admin/templates/index.html',
+
+    async onMount($container) {
+        let invoices = [];
+        let receivers = [];
+        let table = null;
+
+        function receiverName(id) {
+            const r = receivers.find((x) => x.id === id);
+            if (!r) return '—';
+            return r.company || r.name || id;
+        }
+
+        function fmt(amount, currency) {
+            try {
+                return new Intl.NumberFormat('en-GB', { style: 'currency', currency: currency || 'GBP' }).format(Number(amount) || 0);
+            } catch {
+                return `${currency || 'GBP'} ${Number(amount).toFixed(2)}`;
+            }
+        }
+
+        function buildTable(data) {
+            const el = $container.find('#invoices-table').get(0);
+            if (!el) return;
+            if (table) {
+                table.setData(data);
+                Domma.icons.scan(el);
+                return;
+            }
+            table = T.create(el, {
+                data,
+                columns: [
+                    {
+                        key: 'number', title: 'Number', sortable: true,
+                        render: (v, row) => `<a href="#/plugins/invoice/edit/${escapeHtml(row.id)}" style="font-weight:600;">${escapeHtml(v || '—')}</a>`
+                    },
+                    { key: 'receiverId', title: 'Billed To', sortable: false,
+                        render: (v) => escapeHtml(receiverName(v))
+                    },
+                    { key: 'issueDate', title: 'Issue Date', sortable: true,
+                        render: (v) => v ? escapeHtml(D(v).format('DD MMM YYYY')) : '—'
+                    },
+                    { key: 'totals', title: 'Total', sortable: false,
+                        render: (totals, row) => `<span style="font-variant-numeric:tabular-nums;">${escapeHtml(fmt(totals?.total ?? 0, row.currency))}</span>`
+                    },
+                    { key: 'status', title: 'Status', sortable: true,
+                        render: (v) => `<span class="badge ${STATUS_BADGE[v] || 'badge-secondary'}">${escapeHtml(v || 'draft')}</span>`
+                    },
+                    { key: 'id', title: 'Actions', sortable: false,
+                        render: (id) => `<div style="display:flex;gap:.4rem;">
+  <button class="btn btn-sm btn-outline edit-btn" data-id="${escapeHtml(id)}"><span data-icon="edit" data-icon-size="14"></span></button>
+  <a class="btn btn-sm btn-outline" href="${BASE}/invoices/${escapeHtml(id)}/print" target="_blank" title="Print / PDF"><span data-icon="printer" data-icon-size="14"></span></a>
+  <button class="btn btn-sm btn-danger delete-btn" data-id="${escapeHtml(id)}"><span data-icon="trash" data-icon-size="14"></span></button>
+</div>`
+                    }
+                ],
+                emptyMessage: 'No invoices yet. Click “New Invoice” to create your first.'
+            });
+
+            el.addEventListener('click', async (e) => {
+                const editBtn = e.target.closest('.edit-btn');
+                const delBtn  = e.target.closest('.delete-btn');
+                if (editBtn) R.navigate('#/plugins/invoice/edit/' + editBtn.dataset.id);
+                if (delBtn) {
+                    const id = delBtn.dataset.id;
+                    const inv = invoices.find((x) => x.id === id);
+                    const ok = await E.confirm(`Delete invoice ${inv?.number ?? ''}?`);
+                    if (!ok) return;
+                    try {
+                        await H.delete(`${BASE}/invoices/${id}`);
+                        E.toast('Invoice deleted.', { type: 'success' });
+                        await reload();
+                    } catch {
+                        E.toast('Delete failed.', { type: 'error' });
+                    }
+                }
+            });
+
+            Domma.icons.scan(el);
+        }
+
+        function refreshKpis() {
+            const counts = { total: invoices.length, outstanding: 0, paid: 0, drafts: 0 };
+            for (const i of invoices) {
+                if (i.status === 'paid') counts.paid++;
+                else if (i.status === 'draft') counts.drafts++;
+                else if (i.status === 'sent' || i.status === 'overdue') counts.outstanding++;
+            }
+            $container.find('#kpi-total').text(counts.total);
+            $container.find('#kpi-outstanding').text(counts.outstanding);
+            $container.find('#kpi-paid').text(counts.paid);
+            $container.find('#kpi-drafts').text(counts.drafts);
+        }
+
+        function applyFilters() {
+            const status = $container.find('#filter-status').val() || '';
+            const q = ($container.find('#filter-search').val() || '').toString().toLowerCase().trim();
+            let filtered = invoices;
+            if (status) filtered = filtered.filter((i) => i.status === status);
+            if (q) {
+                filtered = filtered.filter((i) =>
+                    (i.number ?? '').toLowerCase().includes(q) ||
+                    receiverName(i.receiverId).toLowerCase().includes(q)
+                );
+            }
+            buildTable(filtered);
+        }
+
+        async function reload() {
+            try {
+                const [invRes, recRes] = await Promise.all([
+                    H.get(`${BASE}/invoices`),
+                    H.get(`${BASE}/receivers`).catch(() => ({ data: [] }))
+                ]);
+                invoices  = invRes.data ?? invRes ?? [];
+                receivers = recRes.data ?? recRes ?? [];
+            } catch {
+                invoices = [];
+                receivers = [];
+                E.toast('Could not load invoices.', { type: 'error' });
+            }
+            refreshKpis();
+            applyFilters();
+        }
+
+        $container.find('#btn-new-invoice').on('click', () => R.navigate('#/plugins/invoice/new'));
+        $container.find('#filter-status').on('change', applyFilters);
+        let timer = null;
+        $container.find('#filter-search').on('input', () => {
+            clearTimeout(timer);
+            timer = setTimeout(applyFilters, 200);
+        });
+
+        await reload();
+        Domma.icons.scan();
+    }
+};

package/plugins/invoice/admin/views/issuers.js

@@ -0,0 +1,23 @@
+/**
+ * Invoice plugin — issuers CRUD view.
+ */
+import {mountPartyView} from './party-view.js?v=1';
+
+export const issuersView = {
+    templateUrl: '/plugins/invoice/admin/templates/issuers.html',
+    onMount: ($container) => mountPartyView($container, {
+        kind: 'issuer',
+        endpoint: '/api/plugins/invoice/issuers',
+        label: 'Issuer',
+        fields: [
+            { key: 'name',        label: 'Trading Name',  required: true,  type: 'text' },
+            { key: 'email',       label: 'Email',         type: 'text' },
+            { key: 'phone',       label: 'Phone',         type: 'text' },
+            { key: 'website',     label: 'Website',       type: 'text' },
+            { key: 'vatNumber',   label: 'VAT Number',    type: 'text' },
+            { key: 'logoUrl',     label: 'Logo URL',      type: 'text' },
+            { key: 'address',     label: 'Address',       type: 'textarea' },
+            { key: 'bankDetails', label: 'Bank Details',  type: 'textarea' }
+        ]
+    })
+};

package/plugins/invoice/admin/views/party-view.js

@@ -0,0 +1,148 @@
+/**
+ * Shared CRUD view for issuers and receivers.
+ * Renders a sortable table and an edit slideover driven by a fields[] config.
+ */
+function escapeHtml(s) {
+    return String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;');
+}
+
+export async function mountPartyView($container, config) {
+    let parties = [];
+    let table = null;
+
+    function buildTable(data) {
+        const el = $container.find('#party-table').get(0);
+        if (!el) return;
+        if (table) {
+            table.setData(data);
+            Domma.icons.scan(el);
+            return;
+        }
+
+        const cols = [
+            { key: 'name', title: 'Name', sortable: true,
+                render: (v, row) => `<a href="#" data-id="${escapeHtml(row.id)}" class="party-edit" style="font-weight:600;">${escapeHtml(v || '(unnamed)')}</a>`
+            }
+        ];
+        if (config.fields.some((f) => f.key === 'company')) {
+            cols.push({ key: 'company', title: 'Company', sortable: true, render: (v) => escapeHtml(v || '—') });
+        }
+        cols.push(
+            { key: 'email', title: 'Email', sortable: true, render: (v) => v ? `<a href="mailto:${escapeHtml(v)}">${escapeHtml(v)}</a>` : '—' },
+            { key: 'vatNumber', title: 'VAT', sortable: false, render: (v) => v ? `<code>${escapeHtml(v)}</code>` : '—' },
+            { key: 'id', title: 'Actions', sortable: false,
+                render: (id) => `<div style="display:flex;gap:.4rem;">
+  <button class="btn btn-sm btn-outline party-edit" data-id="${escapeHtml(id)}"><span data-icon="edit" data-icon-size="14"></span></button>
+  <button class="btn btn-sm btn-danger party-delete" data-id="${escapeHtml(id)}"><span data-icon="trash" data-icon-size="14"></span></button>
+</div>` }
+        );
+
+        table = T.create(el, { data, columns: cols, emptyMessage: `No ${config.label.toLowerCase()}s yet.` });
+
+        el.addEventListener('click', async (e) => {
+            const editEl = e.target.closest('.party-edit');
+            const delEl  = e.target.closest('.party-delete');
+            if (editEl) {
+                e.preventDefault();
+                const party = parties.find((p) => p.id === editEl.dataset.id);
+                openEditor(party);
+            }
+            if (delEl) {
+                const party = parties.find((p) => p.id === delEl.dataset.id);
+                const ok = await E.confirm(`Delete ${config.label.toLowerCase()} "${party?.name ?? ''}"?`);
+                if (!ok) return;
+                try {
+                    await H.delete(`${config.endpoint}/${party.id}`);
+                    E.toast('Deleted.', { type: 'success' });
+                    await reload();
+                } catch {
+                    E.toast('Delete failed.', { type: 'error' });
+                }
+            }
+        });
+
+        Domma.icons.scan(el);
+    }
+
+    async function reload() {
+        try {
+            const res = await H.get(config.endpoint);
+            parties = res.data ?? res ?? [];
+        } catch {
+            parties = [];
+            E.toast(`Could not load ${config.label.toLowerCase()}s.`, { type: 'error' });
+        }
+        buildTable(parties);
+    }
+
+    function openEditor(existing) {
+        const isEdit = Boolean(existing);
+        const form = document.createElement('div');
+        form.style.cssText = 'display:flex;flex-direction:column;gap:.75rem;padding:.5rem;';
+
+        const inputs = {};
+        for (const field of config.fields) {
+            const wrap = document.createElement('div');
+            const label = document.createElement('label');
+            label.className = 'form-label';
+            label.textContent = field.label + (field.required ? ' *' : '');
+            wrap.appendChild(label);
+
+            let input;
+            if (field.type === 'textarea') {
+                input = document.createElement('textarea');
+                input.rows = 3;
+            } else {
+                input = document.createElement('input');
+                input.type = 'text';
+            }
+            input.className = 'form-control';
+            input.value = existing?.[field.key] ?? '';
+            wrap.appendChild(input);
+            form.appendChild(wrap);
+            inputs[field.key] = input;
+        }
+
+        const saveBtn = document.createElement('button');
+        saveBtn.type = 'button';
+        saveBtn.className = 'btn btn-primary mt-2';
+        saveBtn.textContent = isEdit ? 'Save changes' : 'Create';
+        form.appendChild(saveBtn);
+
+        const slideover = E.slideover({
+            title: isEdit ? `Edit ${config.label}` : `New ${config.label}`,
+            size: 'md',
+            position: 'right',
+            content: form
+        });
+
+        saveBtn.addEventListener('click', async () => {
+            const body = {};
+            for (const field of config.fields) {
+                body[field.key] = inputs[field.key].value;
+            }
+            if (!body.name?.trim()) {
+                E.toast('Name is required.', { type: 'error' });
+                return;
+            }
+            try {
+                const res = isEdit
+                    ? await H.put(`${config.endpoint}/${existing.id}`, body)
+                    : await H.post(config.endpoint, body);
+                if (res.error) throw new Error(res.error);
+                slideover.close();
+                E.toast(isEdit ? 'Saved.' : 'Created.', { type: 'success' });
+                await reload();
+            } catch (err) {
+                E.toast(err?.message ?? 'Save failed.', { type: 'error' });
+            }
+        });
+
+        slideover.open();
+    }
+
+    $container.find('#btn-new').on('click', () => openEditor(null));
+
+    await reload();
+    Domma.icons.scan();
+}

package/plugins/invoice/admin/views/receivers.js

@@ -0,0 +1,22 @@
+/**
+ * Invoice plugin — receivers CRUD view.
+ */
+import {mountPartyView} from './party-view.js?v=1';
+
+export const receiversView = {
+    templateUrl: '/plugins/invoice/admin/templates/receivers.html',
+    onMount: ($container) => mountPartyView($container, {
+        kind: 'receiver',
+        endpoint: '/api/plugins/invoice/receivers',
+        label: 'Receiver',
+        fields: [
+            { key: 'name',      label: 'Contact Name',  required: true,  type: 'text' },
+            { key: 'company',   label: 'Company',       type: 'text' },
+            { key: 'email',     label: 'Email',         type: 'text' },
+            { key: 'phone',     label: 'Phone',         type: 'text' },
+            { key: 'vatNumber', label: 'VAT Number',    type: 'text' },
+            { key: 'reference', label: 'Reference',     type: 'text' },
+            { key: 'address',   label: 'Address',       type: 'textarea' }
+        ]
+    })
+};

package/plugins/invoice/collections/invoice-issuers/schema.json

@@ -0,0 +1,16 @@
+{
+  "name": "invoice-issuers",
+  "label": "Invoice Issuers",
+  "slug": "invoice-issuers",
+  "storage": { "adapter": "file" },
+  "fields": [
+    { "key": "name",         "label": "Trading Name",   "type": "text",     "required": true },
+    { "key": "email",        "label": "Email",          "type": "text" },
+    { "key": "phone",        "label": "Phone",          "type": "text" },
+    { "key": "website",      "label": "Website",        "type": "text" },
+    { "key": "address",      "label": "Address",        "type": "textarea" },
+    { "key": "vatNumber",    "label": "VAT Number",     "type": "text" },
+    { "key": "bankDetails",  "label": "Bank Details",   "type": "textarea" },
+    { "key": "logoUrl",      "label": "Logo URL",       "type": "text" }
+  ]
+}

package/plugins/invoice/collections/invoice-receivers/schema.json

@@ -0,0 +1,15 @@
+{
+  "name": "invoice-receivers",
+  "label": "Invoice Receivers",
+  "slug": "invoice-receivers",
+  "storage": { "adapter": "file" },
+  "fields": [
+    { "key": "name",      "label": "Name",       "type": "text",     "required": true },
+    { "key": "company",   "label": "Company",    "type": "text" },
+    { "key": "email",     "label": "Email",      "type": "text" },
+    { "key": "phone",     "label": "Phone",      "type": "text" },
+    { "key": "address",   "label": "Address",    "type": "textarea" },
+    { "key": "vatNumber", "label": "VAT Number", "type": "text" },
+    { "key": "reference", "label": "Reference",  "type": "text" }
+  ]
+}

package/plugins/invoice/collections/invoices/schema.json

@@ -0,0 +1,27 @@
+{
+  "name": "invoices",
+  "label": "Invoices",
+  "slug": "invoices",
+  "storage": { "adapter": "file" },
+  "fields": [
+    { "key": "number",      "label": "Number",       "type": "text", "required": true },
+    { "key": "issuerId",    "label": "Issuer",       "type": "text", "required": true },
+    { "key": "receiverId",  "label": "Receiver",     "type": "text", "required": true },
+    { "key": "issueDate",   "label": "Issue Date",   "type": "date", "required": true },
+    { "key": "dueDate",     "label": "Due Date",     "type": "date" },
+    { "key": "status",      "label": "Status",       "type": "select", "required": true,
+      "options": [
+        { "value": "draft",     "label": "Draft" },
+        { "value": "sent",      "label": "Sent" },
+        { "value": "paid",      "label": "Paid" },
+        { "value": "overdue",   "label": "Overdue" },
+        { "value": "cancelled", "label": "Cancelled" }
+      ]
+    },
+    { "key": "currency",    "label": "Currency",     "type": "text" },
+    { "key": "vatEnabled",  "label": "VAT Enabled",  "type": "boolean" },
+    { "key": "vatRate",     "label": "VAT Rate %",   "type": "number" },
+    { "key": "lineItems",   "label": "Line Items",   "type": "json" },
+    { "key": "notes",       "label": "Notes",        "type": "textarea" }
+  ]
+}

package/plugins/invoice/config.js

@@ -0,0 +1,16 @@
+/**
+ * Invoice Plugin — Default Configuration
+ *
+ * numberPrefix    used in generated invoice numbers (e.g. INV-2026-0001)
+ * numberPadding   minimum digits for the sequential portion
+ * defaultVatRate  applied when VAT is enabled and no rate is set on the invoice
+ * defaultCurrency ISO 4217 code; controls formatting + symbol
+ * footerNote      optional small print appended to every printed invoice
+ */
+export default {
+    numberPrefix: 'INV',
+    numberPadding: 4,
+    defaultVatRate: 20,
+    defaultCurrency: 'GBP',
+    footerNote: 'Thank you for your business.'
+};