medusa-analytics 0.0.13 → 0.0.15

package/.medusa/server/src/api/admin/analytics/products-filters/route.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET = GET;
+const shared_1 = require("../products/shared");
+async function GET(req, res) {
+    try {
+        const salesChannels = await (0, shared_1.listSalesChannels)(req);
+        const body = {
+            salesChannels,
+        };
+        res.json(body);
+    }
+    catch (err) {
+        console.error("Products filters analytics error:", err);
+        res.status(500).json({
+            error: "Failed to fetch product analytics filters",
+            message: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicm91dGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvYXBpL2FkbWluL2FuYWx5dGljcy9wcm9kdWN0cy1maWx0ZXJzL3JvdXRlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBSUEsa0JBa0JDO0FBcEJELCtDQUFzRDtBQUUvQyxLQUFLLFVBQVUsR0FBRyxDQUN2QixHQUFrQixFQUNsQixHQUFtQjtJQUVuQixJQUFJLENBQUM7UUFDSCxNQUFNLGFBQWEsR0FBRyxNQUFNLElBQUEsMEJBQWlCLEVBQUMsR0FBRyxDQUFDLENBQUE7UUFDbEQsTUFBTSxJQUFJLEdBQXVCO1lBQy9CLGFBQWE7U0FDZCxDQUFBO1FBRUQsR0FBRyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQTtJQUNoQixDQUFDO0lBQUMsT0FBTyxHQUFHLEVBQUUsQ0FBQztRQUNiLE9BQU8sQ0FBQyxLQUFLLENBQUMsbUNBQW1DLEVBQUUsR0FBRyxDQUFDLENBQUE7UUFDdkQsR0FBRyxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQyxJQUFJLENBQUM7WUFDbkIsS0FBSyxFQUFFLDJDQUEyQztZQUNsRCxPQUFPLEVBQUUsR0FBRyxZQUFZLEtBQUssQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQztTQUMxRCxDQUFDLENBQUE7SUFDSixDQUFDO0FBQ0gsQ0FBQyJ9

package/.medusa/server/src/api/admin/analytics/products-filters/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvYXBpL2FkbWluL2FuYWx5dGljcy9wcm9kdWN0cy1maWx0ZXJzL3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/.medusa/server/src/api/admin/analytics/products-over-time/route.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET = GET;
+const shared_1 = require("../products/shared");
+async function GET(req, res) {
+    const period = (0, shared_1.parseOverTimePeriod)(req.query?.period);
+    const salesChannelId = (0, shared_1.parseSalesChannelId)(req.query?.sales_channel_id);
+    try {
+        const result = await (0, shared_1.getProductsOverTime)(req, period, salesChannelId);
+        const body = {
+            series: result.series,
+            productViewsConnected: result.productViewsConnected,
+        };
+        res.json(body);
+    }
+    catch (err) {
+        console.error("Products over time analytics error:", err);
+        res.status(500).json({
+            error: "Failed to fetch products over time",
+            message: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicm91dGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvYXBpL2FkbWluL2FuYWx5dGljcy9wcm9kdWN0cy1vdmVyLXRpbWUvcm91dGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFRQSxrQkF1QkM7QUE3QkQsK0NBSTJCO0FBRXBCLEtBQUssVUFBVSxHQUFHLENBQ3ZCLEdBQWtCLEVBQ2xCLEdBQW1CO0lBRW5CLE1BQU0sTUFBTSxHQUFHLElBQUEsNEJBQW1CLEVBQUMsR0FBRyxDQUFDLEtBQUssRUFBRSxNQUFNLENBQUMsQ0FBQTtJQUNyRCxNQUFNLGNBQWMsR0FBRyxJQUFBLDRCQUFtQixFQUFDLEdBQUcsQ0FBQyxLQUFLLEVBQUUsZ0JBQWdCLENBQUMsQ0FBQTtJQUV2RSxJQUFJLENBQUM7UUFDSCxNQUFNLE1BQU0sR0FBRyxNQUFNLElBQUEsNEJBQW1CLEVBQUMsR0FBRyxFQUFFLE1BQU0sRUFBRSxjQUFjLENBQUMsQ0FBQTtRQUVyRSxNQUFNLElBQUksR0FBd0I7WUFDaEMsTUFBTSxFQUFFLE1BQU0sQ0FBQyxNQUFNO1lBQ3JCLHFCQUFxQixFQUFFLE1BQU0sQ0FBQyxxQkFBcUI7U0FDcEQsQ0FBQTtRQUVELEdBQUcsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUE7SUFDaEIsQ0FBQztJQUFDLE9BQU8sR0FBRyxFQUFFLENBQUM7UUFDYixPQUFPLENBQUMsS0FBSyxDQUFDLHFDQUFxQyxFQUFFLEdBQUcsQ0FBQyxDQUFBO1FBQ3pELEdBQUcsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUMsSUFBSSxDQUFDO1lBQ25CLEtBQUssRUFBRSxvQ0FBb0M7WUFDM0MsT0FBTyxFQUFFLEdBQUcsWUFBWSxLQUFLLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUM7U0FDMUQsQ0FBQyxDQUFBO0lBQ0osQ0FBQztBQUNILENBQUMifQ==

package/.medusa/server/src/api/admin/analytics/products-over-time/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvYXBpL2FkbWluL2FuYWx5dGljcy9wcm9kdWN0cy1vdmVyLXRpbWUvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/.medusa/server/src/api/admin/analytics/products-performance/route.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET = GET;
+const shared_1 = require("../products/shared");
+async function GET(req, res) {
+    const days = (0, shared_1.parseDaysParam)(req.query?.days);
+    const salesChannelId = (0, shared_1.parseSalesChannelId)(req.query?.sales_channel_id);
+    const range = (0, shared_1.getRangeFromDays)(days);
+    try {
+        const [sales, views] = await Promise.all([
+            (0, shared_1.aggregateProductSales)(req, range, salesChannelId),
+            (0, shared_1.aggregateProductViews)(req, range, salesChannelId),
+        ]);
+        const combined = (0, shared_1.combineSalesAndViews)(sales.products, views.products);
+        const topViewedProducts = combined
+            .filter((row) => row.total_views > 0)
+            .sort((left, right) => {
+            if (right.total_views !== left.total_views) {
+                return right.total_views - left.total_views;
+            }
+            return right.units_sold - left.units_sold;
+        })
+            .slice(0, 10);
+        const viewOpportunities = combined
+            .filter((row) => row.total_views > 0)
+            .sort((left, right) => {
+            const leftScore = left.views_per_unit ?? 0;
+            const rightScore = right.views_per_unit ?? 0;
+            if (rightScore !== leftScore) {
+                return rightScore - leftScore;
+            }
+            return right.total_views - left.total_views;
+        })
+            .slice(0, 10);
+        const body = {
+            topViewedProducts,
+            viewOpportunities,
+            totalViews: views.totalViews,
+            productViewsConnected: views.connected,
+        };
+        res.json(body);
+    }
+    catch (err) {
+        console.error("Products performance analytics error:", err);
+        res.status(500).json({
+            error: "Failed to fetch products performance analytics",
+            message: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicm91dGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvYXBpL2FkbWluL2FuYWx5dGljcy9wcm9kdWN0cy1wZXJmb3JtYW5jZS9yb3V0ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQWNBLGtCQW9EQztBQTdERCwrQ0FPMkI7QUFFcEIsS0FBSyxVQUFVLEdBQUcsQ0FDdkIsR0FBa0IsRUFDbEIsR0FBbUI7SUFFbkIsTUFBTSxJQUFJLEdBQUcsSUFBQSx1QkFBYyxFQUFDLEdBQUcsQ0FBQyxLQUFLLEVBQUUsSUFBSSxDQUFDLENBQUE7SUFDNUMsTUFBTSxjQUFjLEdBQUcsSUFBQSw0QkFBbUIsRUFBQyxHQUFHLENBQUMsS0FBSyxFQUFFLGdCQUFnQixDQUFDLENBQUE7SUFDdkUsTUFBTSxLQUFLLEdBQUcsSUFBQSx5QkFBZ0IsRUFBQyxJQUFJLENBQUMsQ0FBQTtJQUVwQyxJQUFJLENBQUM7UUFDSCxNQUFNLENBQUMsS0FBSyxFQUFFLEtBQUssQ0FBQyxHQUFHLE1BQU0sT0FBTyxDQUFDLEdBQUcsQ0FBQztZQUN2QyxJQUFBLDhCQUFxQixFQUFDLEdBQUcsRUFBRSxLQUFLLEVBQUUsY0FBYyxDQUFDO1lBQ2pELElBQUEsOEJBQXFCLEVBQUMsR0FBRyxFQUFFLEtBQUssRUFBRSxjQUFjLENBQUM7U0FDbEQsQ0FBQyxDQUFBO1FBRUYsTUFBTSxRQUFRLEdBQUcsSUFBQSw2QkFBb0IsRUFBQyxLQUFLLENBQUMsUUFBUSxFQUFFLEtBQUssQ0FBQyxRQUFRLENBQUMsQ0FBQTtRQUNyRSxNQUFNLGlCQUFpQixHQUE0QixRQUFRO2FBQ3hELE1BQU0sQ0FBQyxDQUFDLEdBQUcsRUFBRSxFQUFFLENBQUMsR0FBRyxDQUFDLFdBQVcsR0FBRyxDQUFDLENBQUM7YUFDcEMsSUFBSSxDQUFDLENBQUMsSUFBSSxFQUFFLEtBQUssRUFBRSxFQUFFO1lBQ3BCLElBQUksS0FBSyxDQUFDLFdBQVcsS0FBSyxJQUFJLENBQUMsV0FBVyxFQUFFLENBQUM7Z0JBQzNDLE9BQU8sS0FBSyxDQUFDLFdBQVcsR0FBRyxJQUFJLENBQUMsV0FBVyxDQUFBO1lBQzdDLENBQUM7WUFDRCxPQUFPLEtBQUssQ0FBQyxVQUFVLEdBQUcsSUFBSSxDQUFDLFVBQVUsQ0FBQTtRQUMzQyxDQUFDLENBQUM7YUFDRCxLQUFLLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFBO1FBRWYsTUFBTSxpQkFBaUIsR0FBNEIsUUFBUTthQUN4RCxNQUFNLENBQUMsQ0FBQyxHQUFHLEVBQUUsRUFBRSxDQUFDLEdBQUcsQ0FBQyxXQUFXLEdBQUcsQ0FBQyxDQUFDO2FBQ3BDLElBQUksQ0FBQyxDQUFDLElBQUksRUFBRSxLQUFLLEVBQUUsRUFBRTtZQUNwQixNQUFNLFNBQVMsR0FBRyxJQUFJLENBQUMsY0FBYyxJQUFJLENBQUMsQ0FBQTtZQUMxQyxNQUFNLFVBQVUsR0FBRyxLQUFLLENBQUMsY0FBYyxJQUFJLENBQUMsQ0FBQTtZQUM1QyxJQUFJLFVBQVUsS0FBSyxTQUFTLEVBQUUsQ0FBQztnQkFDN0IsT0FBTyxVQUFVLEdBQUcsU0FBUyxDQUFBO1lBQy9CLENBQUM7WUFDRCxPQUFPLEtBQUssQ0FBQyxXQUFXLEdBQUcsSUFBSSxDQUFDLFdBQVcsQ0FBQTtRQUM3QyxDQUFDLENBQUM7YUFDRCxLQUFLLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFBO1FBRWYsTUFBTSxJQUFJLEdBQW1DO1lBQzNDLGlCQUFpQjtZQUNqQixpQkFBaUI7WUFDakIsVUFBVSxFQUFFLEtBQUssQ0FBQyxVQUFVO1lBQzVCLHFCQUFxQixFQUFFLEtBQUssQ0FBQyxTQUFTO1NBQ3ZDLENBQUE7UUFFRCxHQUFHLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFBO0lBQ2hCLENBQUM7SUFBQyxPQUFPLEdBQUcsRUFBRSxDQUFDO1FBQ2IsT0FBTyxDQUFDLEtBQUssQ0FBQyx1Q0FBdUMsRUFBRSxHQUFHLENBQUMsQ0FBQTtRQUMzRCxHQUFHLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxDQUFDLElBQUksQ0FBQztZQUNuQixLQUFLLEVBQUUsZ0RBQWdEO1lBQ3ZELE9BQU8sRUFBRSxHQUFHLFlBQVksS0FBSyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDO1NBQzFELENBQUMsQ0FBQTtJQUNKLENBQUM7QUFDSCxDQUFDIn0=

package/.medusa/server/src/api/admin/analytics/products-performance/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvYXBpL2FkbWluL2FuYWx5dGljcy9wcm9kdWN0cy1wZXJmb3JtYW5jZS90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/.medusa/server/src/api/admin/analytics/products-summary/route.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET = GET;
+const shared_1 = require("../products/shared");
+async function GET(req, res) {
+    const days = (0, shared_1.parseDaysParam)(req.query?.days);
+    const salesChannelId = (0, shared_1.parseSalesChannelId)(req.query?.sales_channel_id);
+    const range = (0, shared_1.getRangeFromDays)(days);
+    try {
+        const [sales, views] = await Promise.all([
+            (0, shared_1.aggregateProductSales)(req, range, salesChannelId),
+            (0, shared_1.aggregateProductViews)(req, range, salesChannelId),
+        ]);
+        const viewToOrderRatio = sales.totals.ordersWithProducts > 0
+            ? Math.round((views.totalViews / sales.totals.ordersWithProducts) * 100) / 100
+            : null;
+        const body = {
+            unitsSold: sales.totals.unitsSold,
+            productRevenue: sales.totals.productRevenue,
+            ordersWithProducts: sales.totals.ordersWithProducts,
+            activeProductsSold: sales.totals.activeProductsSold,
+            totalProductViews: views.totalViews,
+            viewToOrderRatio,
+            productViewsConnected: views.connected,
+        };
+        res.json(body);
+    }
+    catch (err) {
+        console.error("Products summary analytics error:", err);
+        res.status(500).json({
+            error: "Failed to fetch products summary",
+            message: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicm91dGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvYXBpL2FkbWluL2FuYWx5dGljcy9wcm9kdWN0cy1zdW1tYXJ5L3JvdXRlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBVUEsa0JBdUNDO0FBL0NELCtDQU0yQjtBQUVwQixLQUFLLFVBQVUsR0FBRyxDQUN2QixHQUFrQixFQUNsQixHQUFtQjtJQUVuQixNQUFNLElBQUksR0FBRyxJQUFBLHVCQUFjLEVBQUMsR0FBRyxDQUFDLEtBQUssRUFBRSxJQUFJLENBQUMsQ0FBQTtJQUM1QyxNQUFNLGNBQWMsR0FBRyxJQUFBLDRCQUFtQixFQUFDLEdBQUcsQ0FBQyxLQUFLLEVBQUUsZ0JBQWdCLENBQUMsQ0FBQTtJQUN2RSxNQUFNLEtBQUssR0FBRyxJQUFBLHlCQUFnQixFQUFDLElBQUksQ0FBQyxDQUFBO0lBRXBDLElBQUksQ0FBQztRQUNILE1BQU0sQ0FBQyxLQUFLLEVBQUUsS0FBSyxDQUFDLEdBQUcsTUFBTSxPQUFPLENBQUMsR0FBRyxDQUFDO1lBQ3ZDLElBQUEsOEJBQXFCLEVBQUMsR0FBRyxFQUFFLEtBQUssRUFBRSxjQUFjLENBQUM7WUFDakQsSUFBQSw4QkFBcUIsRUFBQyxHQUFHLEVBQUUsS0FBSyxFQUFFLGNBQWMsQ0FBQztTQUNsRCxDQUFDLENBQUE7UUFFRixNQUFNLGdCQUFnQixHQUNwQixLQUFLLENBQUMsTUFBTSxDQUFDLGtCQUFrQixHQUFHLENBQUM7WUFDakMsQ0FBQyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQ1IsQ0FBQyxLQUFLLENBQUMsVUFBVSxHQUFHLEtBQUssQ0FBQyxNQUFNLENBQUMsa0JBQWtCLENBQUMsR0FBRyxHQUFHLENBQzNELEdBQUcsR0FBRztZQUNULENBQUMsQ0FBQyxJQUFJLENBQUE7UUFFVixNQUFNLElBQUksR0FBdUI7WUFDL0IsU0FBUyxFQUFFLEtBQUssQ0FBQyxNQUFNLENBQUMsU0FBUztZQUNqQyxjQUFjLEVBQUUsS0FBSyxDQUFDLE1BQU0sQ0FBQyxjQUFjO1lBQzNDLGtCQUFrQixFQUFFLEtBQUssQ0FBQyxNQUFNLENBQUMsa0JBQWtCO1lBQ25ELGtCQUFrQixFQUFFLEtBQUssQ0FBQyxNQUFNLENBQUMsa0JBQWtCO1lBQ25ELGlCQUFpQixFQUFFLEtBQUssQ0FBQyxVQUFVO1lBQ25DLGdCQUFnQjtZQUNoQixxQkFBcUIsRUFBRSxLQUFLLENBQUMsU0FBUztTQUN2QyxDQUFBO1FBRUQsR0FBRyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQTtJQUNoQixDQUFDO0lBQUMsT0FBTyxHQUFHLEVBQUUsQ0FBQztRQUNiLE9BQU8sQ0FBQyxLQUFLLENBQUMsbUNBQW1DLEVBQUUsR0FBRyxDQUFDLENBQUE7UUFDdkQsR0FBRyxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQyxJQUFJLENBQUM7WUFDbkIsS0FBSyxFQUFFLGtDQUFrQztZQUN6QyxPQUFPLEVBQUUsR0FBRyxZQUFZLEtBQUssQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQztTQUMxRCxDQUFDLENBQUE7SUFDSixDQUFDO0FBQ0gsQ0FBQyJ9

package/.medusa/server/src/api/admin/analytics/products-summary/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvYXBpL2FkbWluL2FuYWx5dGljcy9wcm9kdWN0cy1zdW1tYXJ5L3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/.medusa/server/src/api/admin/analytics/products-top-sellers/route.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET = GET;
+const shared_1 = require("../products/shared");
+async function GET(req, res) {
+    const period = (0, shared_1.parseTopSellerPeriod)(req.query?.period);
+    const salesChannelId = (0, shared_1.parseSalesChannelId)(req.query?.sales_channel_id);
+    const range = (0, shared_1.getRangeFromTopSellerPeriod)(period);
+    try {
+        const [sales, views] = await Promise.all([
+            (0, shared_1.aggregateProductSales)(req, range, salesChannelId),
+            (0, shared_1.aggregateProductViews)(req, range, salesChannelId),
+        ]);
+        const products = (0, shared_1.combineSalesAndViews)(sales.products, views.products)
+            .sort((left, right) => {
+            if (right.units_sold !== left.units_sold) {
+                return right.units_sold - left.units_sold;
+            }
+            if (right.revenue !== left.revenue) {
+                return right.revenue - left.revenue;
+            }
+            return right.order_count - left.order_count;
+        })
+            .slice(0, 10)
+            .map((row) => ({
+            product_id: row.product_id,
+            product_title: row.product_title,
+            units_sold: row.units_sold,
+            revenue: row.revenue,
+            order_count: row.order_count,
+            total_views: row.total_views,
+        }));
+        const body = {
+            period,
+            products,
+            productViewsConnected: views.connected,
+        };
+        res.json(body);
+    }
+    catch (err) {
+        console.error("Products top sellers analytics error:", err);
+        res.status(500).json({
+            error: "Failed to fetch product top sellers",
+            message: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicm91dGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvYXBpL2FkbWluL2FuYWx5dGljcy9wcm9kdWN0cy10b3Atc2VsbGVycy9yb3V0ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQVdBLGtCQW1EQztBQTVERCwrQ0FPMkI7QUFFcEIsS0FBSyxVQUFVLEdBQUcsQ0FDdkIsR0FBa0IsRUFDbEIsR0FBbUI7SUFFbkIsTUFBTSxNQUFNLEdBQUcsSUFBQSw2QkFBb0IsRUFBQyxHQUFHLENBQUMsS0FBSyxFQUFFLE1BQU0sQ0FBQyxDQUFBO0lBQ3RELE1BQU0sY0FBYyxHQUFHLElBQUEsNEJBQW1CLEVBQUMsR0FBRyxDQUFDLEtBQUssRUFBRSxnQkFBZ0IsQ0FBQyxDQUFBO0lBQ3ZFLE1BQU0sS0FBSyxHQUFHLElBQUEsb0NBQTJCLEVBQUMsTUFBTSxDQUFDLENBQUE7SUFFakQsSUFBSSxDQUFDO1FBQ0gsTUFBTSxDQUFDLEtBQUssRUFBRSxLQUFLLENBQUMsR0FBRyxNQUFNLE9BQU8sQ0FBQyxHQUFHLENBQUM7WUFDdkMsSUFBQSw4QkFBcUIsRUFBQyxHQUFHLEVBQUUsS0FBSyxFQUFFLGNBQWMsQ0FBQztZQUNqRCxJQUFBLDhCQUFxQixFQUFDLEdBQUcsRUFBRSxLQUFLLEVBQUUsY0FBYyxDQUFDO1NBQ2xELENBQUMsQ0FBQTtRQUVGLE1BQU0sUUFBUSxHQUEwQixJQUFBLDZCQUFvQixFQUMxRCxLQUFLLENBQUMsUUFBUSxFQUNkLEtBQUssQ0FBQyxRQUFRLENBQ2Y7YUFDRSxJQUFJLENBQUMsQ0FBQyxJQUFJLEVBQUUsS0FBSyxFQUFFLEVBQUU7WUFDcEIsSUFBSSxLQUFLLENBQUMsVUFBVSxLQUFLLElBQUksQ0FBQyxVQUFVLEVBQUUsQ0FBQztnQkFDekMsT0FBTyxLQUFLLENBQUMsVUFBVSxHQUFHLElBQUksQ0FBQyxVQUFVLENBQUE7WUFDM0MsQ0FBQztZQUNELElBQUksS0FBSyxDQUFDLE9BQU8sS0FBSyxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUM7Z0JBQ25DLE9BQU8sS0FBSyxDQUFDLE9BQU8sR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFBO1lBQ3JDLENBQUM7WUFDRCxPQUFPLEtBQUssQ0FBQyxXQUFXLEdBQUcsSUFBSSxDQUFDLFdBQVcsQ0FBQTtRQUM3QyxDQUFDLENBQUM7YUFDRCxLQUFLLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQzthQUNaLEdBQUcsQ0FBQyxDQUFDLEdBQUcsRUFBRSxFQUFFLENBQUMsQ0FBQztZQUNiLFVBQVUsRUFBRSxHQUFHLENBQUMsVUFBVTtZQUMxQixhQUFhLEVBQUUsR0FBRyxDQUFDLGFBQWE7WUFDaEMsVUFBVSxFQUFFLEdBQUcsQ0FBQyxVQUFVO1lBQzFCLE9BQU8sRUFBRSxHQUFHLENBQUMsT0FBTztZQUNwQixXQUFXLEVBQUUsR0FBRyxDQUFDLFdBQVc7WUFDNUIsV0FBVyxFQUFFLEdBQUcsQ0FBQyxXQUFXO1NBQzdCLENBQUMsQ0FBQyxDQUFBO1FBRUwsTUFBTSxJQUFJLEdBQTBCO1lBQ2xDLE1BQU07WUFDTixRQUFRO1lBQ1IscUJBQXFCLEVBQUUsS0FBSyxDQUFDLFNBQVM7U0FDdkMsQ0FBQTtRQUVELEdBQUcsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUE7SUFDaEIsQ0FBQztJQUFDLE9BQU8sR0FBRyxFQUFFLENBQUM7UUFDYixPQUFPLENBQUMsS0FBSyxDQUFDLHVDQUF1QyxFQUFFLEdBQUcsQ0FBQyxDQUFBO1FBQzNELEdBQUcsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUMsSUFBSSxDQUFDO1lBQ25CLEtBQUssRUFBRSxxQ0FBcUM7WUFDNUMsT0FBTyxFQUFFLEdBQUcsWUFBWSxLQUFLLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUM7U0FDMUQsQ0FBQyxDQUFBO0lBQ0osQ0FBQztBQUNILENBQUMifQ==

package/.medusa/server/src/api/admin/analytics/products-top-sellers/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvYXBpL2FkbWluL2FuYWx5dGljcy9wcm9kdWN0cy10b3Atc2VsbGVycy90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/README.md

@@ -131,6 +131,51 @@ The dashboard loads extensions by **package name** from `node_modules`. Using a
    On the server: startup logs for any error when loading `medusa-analytics` or `medusa-analytics/admin`.  
    If the admin module fails to load (e.g. missing dependency or wrong path), that plugin’s menu items will not appear.
 
+## Features
+
+- Orders dashboard with KPI cards, status breakdowns, and order trends.
+- Customers dashboard with registration mix and customer growth trends.
+- Products dashboard with units sold, product revenue, top sellers, product views, and view-to-sales opportunity tables.
+
+## Product Analytics Notes
+
+The `Products` tab is built into the Analytics admin page and combines two data sources:
+
+- Sales metrics come from Medusa orders and order line items.
+- Product view metrics come from the `product_view` module provided by `medusa-product-helper`.
+
+If `medusa-product-helper` is not installed or storefront product views are not being tracked yet, the Products dashboard still shows sales analytics, but view-based cards and charts will appear empty or unavailable.
+
+### Recommended plugin setup for full Products analytics
+
+Register both plugins in your Medusa app:
+
+```ts
+plugins: [
+  {
+    resolve: "medusa-analytics",
+    options: {},
+  },
+  {
+    resolve: "medusa-product-helper",
+    options: {},
+  },
+]
+```
+
+With both plugins enabled, the Products dashboard can show:
+
+- Best sellers by `units sold` for week, month, year, and all time.
+- Product sales and revenue trends over time.
+- Most-viewed products based on tracked product view events.
+- View-to-sales opportunity rows to identify high-interest products with weak sell-through.
+- Sales channel filtering for product analytics in the admin dashboard.
+
+When a sales channel is selected in the Products dashboard:
+
+- Sales metrics are filtered by `order.sales_channel_id`.
+- Product view metrics are scoped to products assigned to that sales channel.
+
 ## What is Medusa
 
 Medusa is a set of commerce modules and tools that allow you to build rich, reliable, and performant commerce applications without reinventing core commerce logic. The modules can be customized and used to build advanced ecommerce stores, marketplaces, or any product that needs foundational commerce primitives. All modules are open-source and freely available on npm.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "medusa-analytics",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "A starter for Medusa plugins.",
   "author": "Medusa (https://medusajs.com)",
   "license": "MIT",