@hackthedev/dsync-shop 1.0.1

package/index.mjs

@@ -0,0 +1,530 @@
+import path from "path";
+import { fileURLToPath } from "url";
+
+export default class dSyncShop {
+    constructor({
+                    app = null,
+                    express = null,
+                    payments = null,
+                    db = null,
+                    basePath = '/shop',
+                    isAdmin = null,
+                    enrichMetadata = null,
+                    productActions = {},
+                } = {}) {
+
+        if(!app) throw new Error("missing express app instance");
+        if(!express) throw new Error("missing express");
+        if(!payments) throw new Error("missing payments");
+        if(!db) throw new Error("missing db");
+
+        this.app = app;
+        this.express = express;
+        this.payments = payments;
+        this.basePath = basePath;
+        this.db = db;
+        this.isAdmin = isAdmin;
+        this.enrichMetadata = enrichMetadata;
+        this.productActions = productActions;
+
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = path.dirname(__filename);
+
+        const staticDir = path.join(__dirname, "web");
+
+        if (this.payments) {
+            const originalCompleted  = this.payments.callbacks.onPaymentCompleted;
+            const originalFailed     = this.payments.callbacks.onPaymentFailed;
+            const originalCancelled  = this.payments.callbacks.onPaymentCancelled;
+
+            this.payments.callbacks.onPaymentCompleted = async (data) => {
+                console.log('[dSyncShop] payment completed:', data);
+                if (originalCompleted) await originalCompleted(data);
+                await this.createOrder({ ...data, status: 'COMPLETED' });
+            };
+
+            this.payments.callbacks.onPaymentFailed = async (data) => {
+                console.log('[dSyncShop] payment failed:', data);
+                if (originalFailed) await originalFailed(data);
+                await this.createOrder({ ...data, status: 'FAILED' });
+            };
+
+            this.payments.callbacks.onPaymentCancelled = async (data) => {
+                console.log('[dSyncShop] payment cancelled:', data);
+                if (originalCancelled) await originalCancelled(data);
+                await this.createOrder({ ...data, status: 'CANCELLED' });
+            };
+        }
+
+        app.use(basePath, express.static(staticDir));
+
+        this.registerRoutes();
+        this.initDB();
+    }
+
+    adminMiddleware() {
+        return async (req, res, next) => {
+            if (!this.isAdmin) return next();
+            const result = await this.isAdmin(req);
+            if (!result) return res.status(403).json({ error: 'forbidden' });
+            next();
+        };
+    }
+
+    // normalize action - supports both shorthand function and full object definition
+    resolveAction(key) {
+        const action = this.productActions[key];
+        if (!action) return null;
+        if (typeof action === 'function') {
+            return { label: key, params: [], handler: action };
+        }
+        return action;
+    }
+
+    async createOrder(paymentData) {
+        const { metadata, pricing, amount, paymentId, status, provider, chargeId, orderId } = paymentData;
+
+        const finalAmount = amount || (pricing?.local?.amount ? parseFloat(pricing.local.amount) : 0);
+
+        let orderStatus = 'pending';
+        if (status === 'COMPLETED' || status === 'confirmed') {
+            orderStatus = 'completed';
+        } else if (status === 'failed' || status === 'FAILED') {
+            orderStatus = 'failed';
+        } else if (status === 'cancelled' || status === 'CANCELLED') {
+            orderStatus = 'cancelled';
+        }
+
+        if (!metadata || !metadata.product_id) {
+            console.error('[dSyncShop] no product_id in metadata:', paymentData);
+            return;
+        }
+
+        const finalPaymentId = paymentId || orderId || chargeId || null;
+
+        const result = await this.db.queryDatabase(
+            "insert into orders (total_amount, status, payment_method, payment_id, customId) values (?, ?, ?, ?, ?)",
+            [finalAmount, orderStatus, provider || null, finalPaymentId, metadata?.userId || null]
+        );
+
+        await this.db.queryDatabase(
+            "insert into order_items (order_id, product_id, quantity, price) values (?, ?, ?, ?)",
+            [result.insertId, metadata.product_id, 1, finalAmount]
+        );
+
+        if (orderStatus === 'completed') {
+            try {
+                const products = await this.db.queryDatabase(
+                    "select * from products where id = ?",
+                    [metadata.product_id]
+                );
+
+                const product = products[0];
+
+                if (product?.action) {
+                    const action = this.resolveAction(product.action);
+                    if (action) {
+                        const params = product.action_params ? JSON.parse(product.action_params) : {};
+                        await action.handler(metadata, product, params);
+                    } else {
+                        console.warn(`[dSyncShop] action '${product.action}' not found in productActions`);
+                    }
+                }
+            } catch (err) {
+                console.error('[dSyncShop] error executing product action:', err);
+            }
+        }
+
+        return result;
+    }
+
+    async initDB() {
+        const shopTables = [
+            {
+                name: "categories",
+                columns: [
+                    {name: "id", type: "int(12) NOT NULL AUTO_INCREMENT PRIMARY KEY"},
+                    {name: "name", type: "varchar(255) NOT NULL"},
+                    {name: "description", type: "text"},
+                    {name: "parent_id", type: "int(12)"},
+                    {name: "created_at", type: "bigint NOT NULL DEFAULT (UNIX_TIMESTAMP() * 1000)"}
+                ],
+                keys: [
+                    {name: "UNIQUE KEY", type: "name (name)"},
+                    {name: "FOREIGN KEY", type: "(parent_id) REFERENCES categories(id) ON DELETE SET NULL"}
+                ]
+            },
+            {
+                name: "products",
+                columns: [
+                    {name: "id", type: "int(12) NOT NULL AUTO_INCREMENT PRIMARY KEY"},
+                    {name: "name", type: "varchar(255) NOT NULL"},
+                    {name: "description", type: "text"},
+                    {name: "price", type: "decimal(10,2) NOT NULL"},
+                    {name: "category_id", type: "int(12)"},
+                    {name: "image_url", type: "varchar(512)"},
+                    {name: "stock", type: "int(12) NOT NULL DEFAULT 0"},
+                    {name: "active", type: "tinyint(1) NOT NULL DEFAULT 1"},
+                    {name: "action", type: "varchar(100) DEFAULT NULL"},
+                    {name: "action_params", type: "text DEFAULT NULL"},
+                    {name: "created_at", type: "bigint NOT NULL DEFAULT (UNIX_TIMESTAMP() * 1000)"}
+                ],
+                keys: [
+                    {name: "INDEX", type: "category_id (category_id)"},
+                    {name: "INDEX", type: "active (active)"},
+                    {name: "FOREIGN KEY", type: "(category_id) REFERENCES categories(id) ON DELETE SET NULL"}
+                ]
+            },
+            {
+                name: "orders",
+                columns: [
+                    {name: "id", type: "int(12) NOT NULL AUTO_INCREMENT PRIMARY KEY"},
+                    {name: "customer_email", type: "varchar(255) DEFAULT NULL"},
+                    {name: "customer_name", type: "varchar(255) DEFAULT NULL"},
+                    {name: "customId", type: "varchar(255) DEFAULT NULL"},
+                    {name: "total_amount", type: "decimal(10,2) NOT NULL"},
+                    {name: "status", type: "varchar(50) NOT NULL DEFAULT 'pending'"},
+                    {name: "payment_method", type: "varchar(50)"},
+                    {name: "payment_id", type: "varchar(255)"},
+                    {name: "created_at", type: "bigint NOT NULL DEFAULT (UNIX_TIMESTAMP() * 1000)"}
+                ],
+                keys: [
+                    {name: "INDEX", type: "customer_email (customer_email)"},
+                    {name: "INDEX", type: "status (status)"},
+                    {name: "INDEX", type: "payment_id (payment_id)"}
+                ]
+            },
+            {
+                name: "order_items",
+                columns: [
+                    {name: "id", type: "int(12) NOT NULL AUTO_INCREMENT PRIMARY KEY"},
+                    {name: "order_id", type: "int(12) NOT NULL"},
+                    {name: "product_id", type: "int(12) NOT NULL"},
+                    {name: "quantity", type: "int(12) NOT NULL"},
+                    {name: "price", type: "decimal(10,2) NOT NULL"},
+                    {name: "created_at", type: "bigint NOT NULL DEFAULT (UNIX_TIMESTAMP() * 1000)"}
+                ],
+                keys: [
+                    {name: "INDEX", type: "order_id (order_id)"},
+                    {name: "INDEX", type: "product_id (product_id)"},
+                    {name: "FOREIGN KEY", type: "(order_id) REFERENCES orders(id) ON DELETE CASCADE"},
+                    {name: "FOREIGN KEY", type: "(product_id) REFERENCES products(id) ON DELETE CASCADE"}
+                ]
+            }
+        ];
+
+        for (const table of shopTables) {
+            await this.db.checkAndCreateTable(table);
+        }
+    }
+
+    registerRoutes() {
+        this.createProductRoutes();
+        this.createCategoryRoutes();
+        this.createPaymentRoute();
+        this.createActionRoutes();
+
+        this.app.get(`${this.basePath}/admin/check`, async (req, res) => {
+            if (!this.isAdmin) return res.status(200).json({ isAdmin: false });
+            const result = await this.isAdmin(req);
+            return res.status(200).json({ isAdmin: !!result });
+        });
+    }
+
+    createActionRoutes() {
+        this.app.get(`${this.basePath}/actions/list`, this.adminMiddleware(), (req, res) => {
+            const actions = Object.keys(this.productActions).map(key => {
+                const action = this.resolveAction(key);
+                return {
+                    key,
+                    label: action.label || key,
+                    params: action.params || []
+                };
+            });
+            return res.status(200).json({ error: null, actions });
+        });
+    }
+
+    createPaymentRoute() {
+        this.app.post(`${this.basePath}/payment/create`, this.express.json(), async (req, res) => {
+            try {
+                const { product_id, payment_method } = req.body;
+                const extra = this.enrichMetadata ? await this.enrichMetadata(req) : {};
+                if (extra === null) return res.status(401).json({ error: 'unauthorized' });
+
+                const products = await this.db.queryDatabase(
+                    "select * from products where id = ?",
+                    [product_id]
+                );
+
+                if (products.length === 0) {
+                    return res.status(404).json({ error: "product not found" });
+                }
+
+                const product = products[0];
+
+                if (payment_method === 'paypal') {
+                    const order = await this.payments.paypal.createOrder({
+                        title: product.name,
+                        price: parseFloat(product.price),
+                        metadata: { product_id: product.id, ...extra }
+                    });
+
+                    return res.status(200).json({
+                        error: null,
+                        approvalUrl: order.approvalUrl,
+                        orderId: order.orderId
+                    });
+                } else if (payment_method === 'crypto') {
+                    const charge = await this.payments.coinbase.createCharge({
+                        title: product.name,
+                        price: parseFloat(product.price),
+                        metadata: { product_id: product.id, ...extra }
+                    });
+
+                    return res.status(200).json({
+                        error: null,
+                        hostedUrl: charge.hostedUrl,
+                        chargeCode: charge.chargeCode
+                    });
+                }
+            } catch (error) {
+                return res.status(500).json({ error: error.message });
+            }
+        });
+    }
+
+    createProductRoutes() {
+        this.app.get(`${this.basePath}/products/list`, async (req, res) => {
+            try {
+                const products = await this.db.queryDatabase(
+                    "select p.*, c.name as category_name from products p left join categories c on p.category_id = c.id where p.active = ? order by p.created_at desc",
+                    [1]
+                );
+                return res.status(200).json({ error: null, products });
+            } catch (error) {
+                return res.status(500).json({ error: error.message, products: [] });
+            }
+        });
+
+        this.app.get(`${this.basePath}/products/list/:category`, async (req, res) => {
+            try {
+                const { category } = req.params;
+                const products = await this.db.queryDatabase(
+                    "select p.*, c.name as category_name from products p left join categories c on p.category_id = c.id where p.active = ? and c.name = ? order by p.created_at desc",
+                    [1, category]
+                );
+                return res.status(200).json({ error: null, products });
+            } catch (error) {
+                return res.status(500).json({ error: error.message, products: [] });
+            }
+        });
+
+        this.app.get(`${this.basePath}/product/:id`, async (req, res) => {
+            try {
+                const { id } = req.params;
+                const products = await this.db.queryDatabase(
+                    "select p.*, c.name as category_name from products p left join categories c on p.category_id = c.id where p.id = ?",
+                    [id]
+                );
+
+                if (products.length === 0) {
+                    return res.status(404).json({ error: "product not found", product: null });
+                }
+
+                return res.status(200).json({ error: null, product: products[0] });
+            } catch (error) {
+                return res.status(500).json({ error: error.message, product: null });
+            }
+        });
+
+        this.app.post(`${this.basePath}/product/create`, this.express.json(), this.adminMiddleware(), async (req, res) => {
+            try {
+                const { name, description, price, category_id, image_url, stock, active, action, action_params } = req.body;
+
+                if (!name || !price) {
+                    return res.status(400).json({ error: "name and price are required", product: null });
+                }
+
+                if (action && !this.resolveAction(action)) {
+                    return res.status(400).json({ error: `unknown action '${action}'`, product: null });
+                }
+
+                const result = await this.db.queryDatabase(
+                    "insert into products (name, description, price, category_id, image_url, stock, active, action, action_params) values (?, ?, ?, ?, ?, ?, ?, ?, ?)",
+                    [
+                        name,
+                        description || null,
+                        price,
+                        category_id || null,
+                        image_url || null,
+                        stock || 0,
+                        active !== undefined ? active : 1,
+                        action || null,
+                        action_params ? JSON.stringify(action_params) : null
+                    ]
+                );
+
+                const products = await this.db.queryDatabase(
+                    "select * from products where id = ?",
+                    [result.insertId]
+                );
+
+                return res.status(201).json({ error: null, product: products[0] });
+            } catch (error) {
+                return res.status(500).json({ error: error.message, product: null });
+            }
+        });
+
+        this.app.post(`${this.basePath}/product/update/:id`, this.express.json(), this.adminMiddleware(), async (req, res) => {
+            try {
+                const { id } = req.params;
+                const { name, description, price, category_id, image_url, stock, active, action, action_params } = req.body;
+
+                if (action && !this.resolveAction(action)) {
+                    return res.status(400).json({ error: `unknown action '${action}'`, product: null });
+                }
+
+                await this.db.queryDatabase(
+                    "update products set name = ?, description = ?, price = ?, category_id = ?, image_url = ?, stock = ?, active = ?, action = ?, action_params = ? where id = ?",
+                    [
+                        name,
+                        description,
+                        price,
+                        category_id,
+                        image_url,
+                        stock,
+                        active,
+                        action || null,
+                        action_params ? JSON.stringify(action_params) : null,
+                        id
+                    ]
+                );
+
+                const products = await this.db.queryDatabase(
+                    "select * from products where id = ?",
+                    [id]
+                );
+
+                if (products.length === 0) {
+                    return res.status(404).json({ error: "product not found", product: null });
+                }
+
+                return res.status(200).json({ error: null, product: products[0] });
+            } catch (error) {
+                return res.status(500).json({ error: error.message, product: null });
+            }
+        });
+
+        this.app.delete(`${this.basePath}/product/delete/:id`, this.adminMiddleware(), async (req, res) => {
+            try {
+                const { id } = req.params;
+
+                const products = await this.db.queryDatabase(
+                    "select * from products where id = ?",
+                    [id]
+                );
+
+                if (products.length === 0) {
+                    return res.status(404).json({ error: "product not found", success: false });
+                }
+
+                await this.db.queryDatabase(
+                    "delete from products where id = ?",
+                    [id]
+                );
+
+                return res.status(200).json({ error: null, success: true });
+            } catch (error) {
+                return res.status(500).json({ error: error.message, success: false });
+            }
+        });
+    }
+
+    createCategoryRoutes() {
+        this.app.get(`${this.basePath}/categories/list`, async (req, res) => {
+            try {
+                const categories = await this.db.queryDatabase(
+                    "select * from categories order by name",
+                    []
+                );
+                return res.status(200).json({ error: null, categories });
+            } catch (error) {
+                return res.status(500).json({ error: error.message, categories: [] });
+            }
+        });
+
+        this.app.post(`${this.basePath}/category/create`, this.express.json(), this.adminMiddleware(), async (req, res) => {
+            try {
+                const { name, description, parent_id } = req.body;
+
+                if (!name) {
+                    return res.status(400).json({ error: "name is required", category: null });
+                }
+
+                const result = await this.db.queryDatabase(
+                    "insert into categories (name, description, parent_id) values (?, ?, ?)",
+                    [name, description || null, parent_id || null]
+                );
+
+                const categories = await this.db.queryDatabase(
+                    "select * from categories where id = ?",
+                    [result.insertId]
+                );
+
+                return res.status(201).json({ error: null, category: categories[0] });
+            } catch (error) {
+                return res.status(500).json({ error: error.message, category: null });
+            }
+        });
+
+        this.app.post(`${this.basePath}/category/update/:id`, this.express.json(), this.adminMiddleware(), async (req, res) => {
+            try {
+                const { id } = req.params;
+                const { name, description, parent_id } = req.body;
+
+                await this.db.queryDatabase(
+                    "update categories set name = ?, description = ?, parent_id = ? where id = ?",
+                    [name, description, parent_id, id]
+                );
+
+                const categories = await this.db.queryDatabase(
+                    "select * from categories where id = ?",
+                    [id]
+                );
+
+                if (categories.length === 0) {
+                    return res.status(404).json({ error: "category not found", category: null });
+                }
+
+                return res.status(200).json({ error: null, category: categories[0] });
+            } catch (error) {
+                return res.status(500).json({ error: error.message, category: null });
+            }
+        });
+
+        this.app.delete(`${this.basePath}/category/delete/:id`, this.adminMiddleware(), async (req, res) => {
+            try {
+                const { id } = req.params;
+
+                const categories = await this.db.queryDatabase(
+                    "select * from categories where id = ?",
+                    [id]
+                );
+
+                if (categories.length === 0) {
+                    return res.status(404).json({ error: "category not found", success: false });
+                }
+
+                await this.db.queryDatabase(
+                    "delete from categories where id = ?",
+                    [id]
+                );
+
+                return res.status(200).json({ error: null, success: true });
+            } catch (error) {
+                return res.status(500).json({ error: error.message, success: false });
+            }
+        });
+    }
+}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@hackthedev/dsync-shop",
+  "version": "1.0.1",
+  "description": "Part of the dSync library family. dSyncShop provides a complete shop system on top of dSyncPay, handling products, categories, orders and automatic post-purchase actions. It creates and manages its own database tables and registers all routes automatically.",
+  "homepage": "https://github.com/NETWORK-Z-Dev/dSyncShop#readme",
+  "bugs": {
+    "url": "https://github.com/NETWORK-Z-Dev/dSyncShop/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NETWORK-Z-Dev/dSyncShop.git"
+  },
+  "license": "ISC",
+  "author": "",
+  "main": "index.mjs",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}

package/web/index.html

@@ -0,0 +1,133 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+    <link rel="stylesheet" href="style.css">
+    <script defer src="script.js"></script>
+
+    <title>Shop</title>
+</head>
+
+<body>
+<div class="admin-overlay" id="adminOverlay" onclick="closeAdminPanel()"></div>
+
+<div class="sidebar" id="mainSidebar">
+    <div class="sidebar-top">
+        <button class="sidebar-back-btn" onclick="window.location.href = window.location.origin">
+            <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5">
+                <polyline points="15 18 9 12 15 6"/>
+            </svg>
+            Back
+        </button>
+    </div>
+
+    <div class="sidebar-section-label">categories</div>
+    <div class="category-nav" id="categoryNav">
+        <button class="category-btn active" data-category="all">all products</button>
+    </div>
+
+    <div class="sidebar-bottom">
+        <button class="sidebar-admin-btn" id="adminBtn" onclick="openAdminPanel()" style="display:none">
+            Admin Panel
+        </button>
+    </div>
+</div>
+
+<div class="main-content" id="mainContent">
+    <header>
+        <div class="header-inner">
+            <h1>Shop</h1>
+            <p class="header-sub">Browse different products</p>
+        </div>
+    </header>
+    <div class="container">
+        <div class="products" id="productsContainer">
+            <div class="loading">loading products...</div>
+        </div>
+    </div>
+</div>
+
+<div class="modal" id="paymentModal">
+    <div class="modal-content">
+        <div class="modal-header">confirm purchase</div>
+        <div class="modal-body">
+            <p><strong>product:</strong> <span id="modalProduct"></span></p>
+            <p><strong>price:</strong> <span id="modalPrice"></span></p>
+            <p><strong>payment method:</strong> <span id="modalPayment"></span></p>
+        </div>
+        <div class="modal-footer">
+            <button class="btn-modal btn-cancel" onclick="closeModal()">cancel</button>
+            <button class="btn-modal btn-confirm" onclick="processPurchase()">confirm</button>
+        </div>
+    </div>
+</div>
+
+<div class="modal" id="formModal">
+    <div class="modal-content">
+        <div class="modal-header" id="formModalTitle">add product</div>
+        <div class="modal-body" id="formModalBody"></div>
+        <div class="modal-footer">
+            <button class="btn-modal btn-cancel" onclick="closeFormModal()">cancel</button>
+            <button class="btn-modal btn-confirm" onclick="submitForm()">save</button>
+        </div>
+    </div>
+</div>
+
+<div class="admin-panel" id="adminPanel">
+
+    <div class="admin-topbar">
+        <div class="admin-topbar-left">
+            <h1>Admin Panel</h1>
+        </div>
+        <div class="admin-topbar-right">
+            <button class="admin-close-btn" onclick="closeAdminPanel()">&#x2715;</button>
+        </div>
+    </div>
+
+    <div class="admin-tabs">
+        <button class="tab-btn active" onclick="switchTab('products', event)">products</button>
+        <button class="tab-btn" onclick="switchTab('categories', event)">categories</button>
+    </div>
+
+    <div class="tab-content active" id="productsTab">
+        <div class="tab-toolbar">
+            <div class="search-input-wrap">
+                <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                    <circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/>
+                </svg>
+                <input type="text" id="adminProductSearch" placeholder="search products...">
+            </div>
+            <div class="tab-toolbar-right">
+                <button class="btn-add" onclick="openProductForm()">
+                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5">
+                        <line x1="12" y1="5" x2="12" y2="19"/><line x1="5" y1="12" x2="19" y2="12"/>
+                    </svg>
+                    add product
+                </button>
+            </div>
+        </div>
+        <div class="admin-list" id="productsList"></div>
+    </div>
+
+    <div class="tab-content" id="categoriesTab">
+        <div class="tab-toolbar">
+            <div class="tab-toolbar-right">
+                <button class="btn-add" onclick="openCategoryForm()">
+                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5">
+                        <line x1="12" y1="5" x2="12" y2="19"/><line x1="5" y1="12" x2="19" y2="12"/>
+                    </svg>
+                    add category
+                </button>
+            </div>
+        </div>
+        <div class="admin-list" id="categoriesList"></div>
+    </div>
+
+</div>
+
+</body>
+
+</html>