domma-cms 0.84.1 → 0.85.0

package/plugins/shopping-cart/plugin.public.js

@@ -0,0 +1,144 @@
+/**
+ * Shopping Cart - the storefront's pages, at the shop's address (Settings >
+ * Storefront, "/shop" by default):
+ *
+ *   /shop                  every product on sale (?category=, ?q=)
+ *   /shop/<slug>           one product
+ *   /shop/cart             the basket and checkout, one page
+ *   /shop/order/<id>?t=    a shopper's receipt
+ *
+ * Like the Blog, the pages are answered from ONE onRequest hook matching the
+ * address as it is saved NOW, so moving the shop needs no restart. Every page
+ * is complete HTML without script; public/cart.js makes it live.
+ */
+import path from 'path';
+import {fileURLToPath} from 'url';
+import {renderBlogPage} from '../../server/services/renderer.js';
+import {parseMarkdown} from '../../server/services/markdown.js';
+import {byShelf, safeImage} from './public/lib/products.js';
+import {cartHtml, esc, productHtml, receiptHtml, scriptJson, storefrontHtml} from './lib/render.js';
+import {allProducts, getOrder, liveSettings, publicOrder, tokenOk} from './lib/shop.js';
+import {cartRegistry} from './lib/extensions.js';
+
+const TEMPLATE = path.join(fileURLToPath(new URL('.', import.meta.url)), 'templates', 'shop.html');
+export const ASSET_V = '1.0.0';
+
+/** Which page a path is, under the shop's base. */
+export function matchShopPath(pathname, base) {
+    if (pathname === base) return {name: 'index', params: {}};
+    if (!pathname.startsWith(`${base}/`)) return null;
+    let parts;
+    try { parts = pathname.slice(base.length + 1).split('/').map(decodeURIComponent); } catch { return null; }
+    if (parts.length === 1 && parts[0] === '') return {name: 'slash', params: {}};
+    if (parts.length === 1 && (parts[0] === 'cart' || parts[0] === 'checkout' || parts[0] === 'basket')) return {name: 'cart', params: {}};
+    if (parts.length === 2 && parts[0] === 'order' && /^[\w-]{8,64}$/.test(parts[1])) return {name: 'order', params: {id: parts[1]}};
+    if (parts.length === 1 && /^[a-z0-9-]{1,80}$/.test(parts[0])) return {name: 'product', params: {slug: parts[0]}};
+    return null;
+}
+
+/** What the browser script needs, carried in the page. */
+function pageConfig(s, extra = {}) {
+    return {
+        shopPath: s.shopPath, currency: s.currency, floatingCart: Boolean(s.floatingCart), cartPosition: s.cartPosition,
+        freeShippingOver: Number(s.freeShippingOver) || 0, title: s.shopTitle, ...extra
+    };
+}
+
+export default async function shopPublic(fastify) {
+    async function send(reply, request, s, {body, title, description = '', image = '', urlPath, noindex = false, page, extra = {}}) {
+        const html = await renderBlogPage(TEMPLATE, {
+            body,
+            page,
+            assetV: ASSET_V,
+            config: scriptJson(pageConfig(s, extra))
+        }, {
+            title, description, ogImage: image, urlPath, noindex,
+            baseUrl: `${request.protocol}://${request.host || request.headers.host || request.hostname}`
+        });
+        return reply.type('text/html').header('Cache-Control', 'no-store').send(html);
+    }
+
+    const pages = {
+        async index(request, reply, s) {
+            const entries = (await allProducts()).filter(e => e.data?.status === 'active').sort(byShelf);
+            const category = String(request.query?.category || '').slice(0, 60);
+            const query = String(request.query?.q || '').slice(0, 80);
+            return send(reply, request, s, {
+                page: 'index',
+                body: storefrontHtml({entries, settings: s, base: s.shopPath, category, query}),
+                title: s.shopTitle || 'Shop',
+                description: s.shopIntro || '',
+                image: safeImage(entries[0]?.data?.images?.[0]),
+                urlPath: s.shopPath,
+                extra: {category, query}
+            });
+        },
+
+        async slash(request, reply, s) {
+            return reply.redirect(s.shopPath, 301);
+        },
+
+        async product(request, reply, s, {slug}) {
+            const all = (await allProducts()).filter(e => e.data?.status === 'active');
+            const entry = all.find(e => e.data.slug === slug);
+            if (!entry) return null;   // fall through to the CMS's own 404 (or a page at that address)
+            let descriptionHtml = '';
+            if (entry.data.description) {
+                try { descriptionHtml = (await parseMarkdown(entry.data.description, {urlPath: `${s.shopPath}/${slug}`})).html; }
+                catch { descriptionHtml = `<p>${esc(entry.data.description)}</p>`; }
+            }
+            const related = all.filter(e => e.id !== entry.id)
+                .sort((a, b) => (Number(b.data.category === entry.data.category) - Number(a.data.category === entry.data.category)) || byShelf(a, b))
+                .slice(0, 4);
+            return send(reply, request, s, {
+                page: 'product',
+                body: productHtml({entry, settings: s, base: s.shopPath, descriptionHtml, related}),
+                title: entry.data.name,
+                description: entry.data.summary || '',
+                image: safeImage(entry.data.images?.[0]),
+                urlPath: `${s.shopPath}/${slug}`,
+                extra: {product: {id: entry.id, variants: (entry.data.variants || []).length}}
+            });
+        },
+
+        async cart(request, reply, s) {
+            return send(reply, request, s, {
+                page: 'cart',
+                body: cartHtml({settings: s, base: s.shopPath}),
+                title: `Basket - ${s.shopTitle || 'Shop'}`,
+                urlPath: `${s.shopPath}/cart`,
+                noindex: true,
+                extra: {features: cartRegistry().checkoutFeatures(), cancelled: String(request.query?.cancelled || '').slice(0, 64)}
+            });
+        },
+
+        async order(request, reply, s, {id}) {
+            let entry = await getOrder(id);
+            if (!entry || !tokenOk(entry, request.query?.t)) return null;
+            const confirm = cartRegistry().services?.confirmStripe;
+            if (confirm) entry = await confirm(entry, request.query?.session_id, request.log);
+            const order = publicOrder(entry);
+            return send(reply, request, s, {
+                page: 'order',
+                body: receiptHtml({order, settings: s, base: s.shopPath, problem: String(request.query?.problem || '')}),
+                title: `Order #${order.number}`,
+                urlPath: `${s.shopPath}/order/${id}`,
+                noindex: true,
+                extra: {order: {id: order.id, status: order.status, token: String(request.query?.t || '')}}
+            });
+        }
+    };
+
+    fastify.addHook('onRequest', async (request, reply) => {
+        if (request.method !== 'GET' && request.method !== 'HEAD') return;
+        const s = await liveSettings();
+        const hit = matchShopPath(request.url.split('?')[0], s.shopPath);
+        if (!hit) return;
+        const sent = await pages[hit.name](request, reply, s, hit.params);
+        if (sent === null) return;   // not ours after all
+        return sent;
+    });
+}
+
+// The onRequest hook must see every request, not only routes registered here (it registers none).
+shopPublic[Symbol.for('skip-override')] = true;