@deenruv/dashboard-widgets-plugin 1.0.0

package/LICENSE

@@ -0,0 +1,23 @@
+# License 1
+
+The MIT License
+
+Copyright (c) 2025-present Aexol
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+# License 2
+
+The MIT License
+
+Copyright (c) 2018-2025 Michael Bromley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# @deenruv/dashboard-widgets-plugin
+
+Admin dashboard plugin that provides rich order and product analytics widgets. It adds chart-based metrics, order summary tiles, category breakdowns, product charts, and a latest orders table to the admin dashboard.
+
+## Installation
+
+```bash
+pnpm add @deenruv/dashboard-widgets-plugin
+```
+
+## Configuration
+
+```typescript
+import { DashboardWidgetsPlugin } from '@deenruv/dashboard-widgets-plugin';
+
+// In your Deenruv server config:
+plugins: [
+  DashboardWidgetsPlugin.init({
+    // Optional: cache time for metrics queries in milliseconds
+    cacheTime: 60000,
+    // Optional: enable discount custom field support
+    discountByCustomField: false,
+    // Optional: additional order states to include in filters
+    additionalOrderStates: [
+      { state: 'InRealization', selectedByDefault: true },
+    ],
+  }),
+]
+```
+
+## Features
+
+- Order summary metrics (total revenue, order count, average order value, product count)
+- Interactive time-series charts for order count, order total, average order value, and product count
+- Configurable time ranges (today, this week, this month, this year, custom, etc.)
+- Hourly and daily chart intervals
+- Order state filtering for all metrics
+- Product-specific metric filtering
+- Categories and products breakdown chart widgets
+- Latest orders table widget
+- Materialized database views for fast metric aggregation
+
+## Admin UI
+
+This plugin extends the admin UI with a comprehensive dashboard featuring:
+- **Orders Widget** — Time-series charts with configurable metrics, date ranges, and order state filters
+- **Order Summary Tiles** — Quick overview cards showing total revenue, order count, average value, and product count
+- **Categories Chart Widget** — Breakdown of orders by product categories
+- **Products Chart Widget** — Top products bar chart with custom tooltips
+- **Latest Orders Widget** — Recent orders table with payment method info
+
+## API Extensions
+
+### Admin API
+
+- **Query** `additionalOrderStates: [AdditionalOrderState!]!` — Returns configured additional order states
+- **Query** `chartMetric(input: ChartMetricInput!): ChartMetrics!` — Returns time-series chart data for selected metric types, date ranges, and intervals
+- **Query** `orderSummaryMetric(input: OrderSummaryMetricInput!): OrderSummaryMetrics!` — Returns aggregated order summary data (totals, counts, averages)

package/dist/plugin-server/constants.d.ts

@@ -0,0 +1,4 @@
+import { OrderLineEvent, OrderStateTransitionEvent, LoginEvent, LogoutEvent } from "@deenruv/core";
+export declare const PLUGIN_INIT_OPTIONS: unique symbol;
+export declare const DEFAULT_CACHE_TIME = 3600;
+export declare const events: (typeof OrderLineEvent | typeof OrderStateTransitionEvent | typeof LoginEvent | typeof LogoutEvent)[];

package/dist/plugin-server/constants.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.events = exports.DEFAULT_CACHE_TIME = exports.PLUGIN_INIT_OPTIONS = void 0;
+const core_1 = require("@deenruv/core");
+exports.PLUGIN_INIT_OPTIONS = Symbol("ANALYTICS_PLUGIN_OPTIONS");
+exports.DEFAULT_CACHE_TIME = 3600;
+exports.events = [
+    core_1.OrderLineEvent,
+    core_1.OrderStateTransitionEvent,
+    core_1.LoginEvent,
+    core_1.LogoutEvent,
+];

package/dist/plugin-server/controllers/admin-ui-controller.d.ts

@@ -0,0 +1,4 @@
+export declare class AdminUIController {
+    constructor();
+    page(res: any): Promise<void>;
+}

package/dist/plugin-server/controllers/admin-ui-controller.js

@@ -0,0 +1,46 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminUIController = void 0;
+const common_1 = require("@nestjs/common");
+let AdminUIController = class AdminUIController {
+    constructor() { }
+    async page(res) {
+        res.send(`
+            <html>
+              <head>
+                <title>Deenruv - Admin UI</title>
+                <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+                <script type="module" crossorigin src="http://localhost:9000/assets/assets/index.js"></script>
+                <link rel="stylesheet" crossorigin href="http://localhost:9000/assets/assets/index.css">
+              </head>
+                <body>
+                    <div id="root"></div>
+                </body>
+            </html>
+          `);
+    }
+};
+exports.AdminUIController = AdminUIController;
+__decorate([
+    (0, common_1.Get)(),
+    __param(0, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], AdminUIController.prototype, "page", null);
+exports.AdminUIController = AdminUIController = __decorate([
+    (0, common_1.Controller)("admin-ui"),
+    __metadata("design:paramtypes", [])
+], AdminUIController);

package/dist/plugin-server/controllers/refresh-view-controller.d.ts

@@ -0,0 +1,8 @@
+import { RequestContext } from "@deenruv/core";
+import { BetterMetricsService } from "../services/metrics.service";
+import { type Response } from "express";
+export declare class RefreshViewController {
+    private metricsService;
+    constructor(metricsService: BetterMetricsService);
+    refreshView(ctx: RequestContext, res: Response): Promise<void>;
+}

package/dist/plugin-server/controllers/refresh-view-controller.js

@@ -0,0 +1,41 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RefreshViewController = void 0;
+const core_1 = require("@deenruv/core");
+const common_1 = require("@nestjs/common");
+const metrics_service_1 = require("../services/metrics.service");
+let RefreshViewController = class RefreshViewController {
+    constructor(metricsService) {
+        this.metricsService = metricsService;
+    }
+    async refreshView(ctx, res) {
+        await this.metricsService.refreshViews(ctx);
+        res.status(200).send("OK");
+    }
+};
+exports.RefreshViewController = RefreshViewController;
+__decorate([
+    (0, core_1.Allow)(core_1.Permission.ReadOrder),
+    (0, common_1.Get)("/refresh-view"),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, Object]),
+    __metadata("design:returntype", Promise)
+], RefreshViewController.prototype, "refreshView", null);
+exports.RefreshViewController = RefreshViewController = __decorate([
+    (0, common_1.Controller)("metrics"),
+    __metadata("design:paramtypes", [metrics_service_1.BetterMetricsService])
+], RefreshViewController);

package/dist/plugin-server/index.d.ts

@@ -0,0 +1 @@
+export * from "./plugin.js";

package/dist/plugin-server/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./plugin.js"), exports);

package/dist/plugin-server/materialisedViewEntities/order_summary.d.ts

@@ -0,0 +1,9 @@
+export declare class OrderSummaryViewEntity {
+    hour: Date;
+    orderCount: number;
+    totalWithTax: number;
+    total: number;
+    productPlacedCount: number;
+    productCount: number;
+    channelId: number;
+}

package/dist/plugin-server/materialisedViewEntities/order_summary.js

@@ -0,0 +1,79 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderSummaryViewEntity = void 0;
+const typeorm_1 = require("typeorm");
+let OrderSummaryViewEntity = class OrderSummaryViewEntity {
+};
+exports.OrderSummaryViewEntity = OrderSummaryViewEntity;
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Date)
+], OrderSummaryViewEntity.prototype, "hour", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], OrderSummaryViewEntity.prototype, "orderCount", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], OrderSummaryViewEntity.prototype, "totalWithTax", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], OrderSummaryViewEntity.prototype, "total", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], OrderSummaryViewEntity.prototype, "productPlacedCount", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], OrderSummaryViewEntity.prototype, "productCount", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], OrderSummaryViewEntity.prototype, "channelId", void 0);
+exports.OrderSummaryViewEntity = OrderSummaryViewEntity = __decorate([
+    (0, typeorm_1.ViewEntity)({
+        materialized: true,
+        expression: `
+      WITH order_line_summary AS  (
+		  SELECT
+		    "orderId",
+	      SUM("orderPlacedQuantity") as "orderPlacedQuantity",
+	      SUM(quantity) as "quantity"
+	      FROM public.order_line
+	      GROUP BY "orderId"		   
+	   ) 
+	   SELECT
+	      date_trunc('hour', o."orderPlacedAt") AS hour,
+		    occ."channelId" AS "channelId",
+        COUNT(*) AS "orderCount",
+        SUM(o."subTotalWithTax" + o."shippingWithTax") AS "totalWithTax",
+        SUM(o."subTotal" + o."shipping") AS "total",
+        SUM(ols."orderPlacedQuantity") as "productPlacedCount",
+        SUM(ols."quantity") as "productCount"
+	   FROM "order" o
+        LEFT JOIN "order_channels_channel" occ ON occ."orderId" = o."id"
+        LEFT JOIN "order_line_summary" ols ON ols."orderId" = o.id
+        WHERE o."orderPlacedAt" >= '2020-01-01T00:00:00.000Z'
+	    AND o.state IN ('PaymentSettled',
+						'PartiallyShipped',
+						'Shipped',
+						'PartiallyDelivered',
+						'Delivered') 
+      GROUP BY hour,occ."channelId"
+      ORDER BY hour ASC
+  `,
+    }),
+    (0, typeorm_1.Index)(["hour", "channelId"], { unique: true })
+], OrderSummaryViewEntity);

package/dist/plugin-server/materialisedViewEntities/orders_summary_with_state.d.ts

@@ -0,0 +1,10 @@
+export declare class OrderSummaryWithStateViewEntity {
+    hour: Date;
+    orderCount: number;
+    totalWithTax: number;
+    total: number;
+    productPlacedCount: number;
+    productCount: number;
+    channelId: number;
+    state: string;
+}

package/dist/plugin-server/materialisedViewEntities/orders_summary_with_state.js

@@ -0,0 +1,79 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderSummaryWithStateViewEntity = void 0;
+const typeorm_1 = require("typeorm");
+let OrderSummaryWithStateViewEntity = class OrderSummaryWithStateViewEntity {
+};
+exports.OrderSummaryWithStateViewEntity = OrderSummaryWithStateViewEntity;
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Date)
+], OrderSummaryWithStateViewEntity.prototype, "hour", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], OrderSummaryWithStateViewEntity.prototype, "orderCount", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], OrderSummaryWithStateViewEntity.prototype, "totalWithTax", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], OrderSummaryWithStateViewEntity.prototype, "total", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], OrderSummaryWithStateViewEntity.prototype, "productPlacedCount", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], OrderSummaryWithStateViewEntity.prototype, "productCount", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], OrderSummaryWithStateViewEntity.prototype, "channelId", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", String)
+], OrderSummaryWithStateViewEntity.prototype, "state", void 0);
+exports.OrderSummaryWithStateViewEntity = OrderSummaryWithStateViewEntity = __decorate([
+    (0, typeorm_1.ViewEntity)({
+        materialized: true,
+        expression: `
+    WITH order_line_summary AS  (
+		  SELECT
+		    "orderId",
+	      SUM("orderPlacedQuantity") as "orderPlacedQuantity",
+	      SUM(quantity) as "quantity"
+	      FROM public.order_line
+	      GROUP BY "orderId"		   
+	   )
+        SELECT
+            date_trunc('hour', o."orderPlacedAt") AS hour,
+		        occ."channelId" AS "channelId",
+            o.state,
+            COUNT(*) AS "orderCount",
+            SUM(o."subTotalWithTax" + o."shippingWithTax") AS "totalWithTax",
+            SUM(o."subTotal" + o."shipping") AS "total",
+            SUM(ols."orderPlacedQuantity") as "productPlacedCount",
+            SUM(ols."quantity") as "productCount"
+        FROM "order" o
+        INNER JOIN "order_channels_channel" occ ON occ."orderId" = o."id"
+        INNER JOIN "order_line_summary" ols ON ols."orderId" = o.id
+        WHERE o."orderPlacedAt" >= '2020-01-01T00:00:00.000Z'
+        GROUP BY hour, occ."channelId",o.state
+        ORDER BY hour ASC
+  `,
+    }),
+    (0, typeorm_1.Index)(["hour", "channelId", "state"], { unique: true })
+], OrderSummaryWithStateViewEntity);

package/dist/plugin-server/materialisedViewEntities/total_products.d.ts

@@ -0,0 +1,7 @@
+export declare class TotalProductsViewEntity {
+    hour: Date;
+    productVariantId: string;
+    quantitySum: number;
+    orderPlacedQuantitySum: number;
+    channelId: string;
+}

package/dist/plugin-server/materialisedViewEntities/total_products.js

@@ -0,0 +1,62 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TotalProductsViewEntity = void 0;
+const typeorm_1 = require("typeorm");
+let TotalProductsViewEntity = class TotalProductsViewEntity {
+};
+exports.TotalProductsViewEntity = TotalProductsViewEntity;
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Date)
+], TotalProductsViewEntity.prototype, "hour", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", String)
+], TotalProductsViewEntity.prototype, "productVariantId", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], TotalProductsViewEntity.prototype, "quantitySum", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], TotalProductsViewEntity.prototype, "orderPlacedQuantitySum", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", String)
+], TotalProductsViewEntity.prototype, "channelId", void 0);
+exports.TotalProductsViewEntity = TotalProductsViewEntity = __decorate([
+    (0, typeorm_1.ViewEntity)({
+        materialized: true,
+        expression: `
+    SELECT
+        date_trunc('hour', o."orderPlacedAt") AS hour,
+        ol."productVariantId" AS "productVariantId",
+        occ."channelId" AS "channelId",
+        SUM(ol."orderPlacedQuantity") as "orderPlacedQuantitySum",
+	      SUM(ol."quantity") as "quantitySum"
+    FROM "public"."order" o
+    INNER JOIN "public"."order_channels_channel" occ ON occ."orderId" = o."id"
+    INNER JOIN "public"."order_line" ol ON ol."orderId" = o."id"
+    INNER JOIN "public"."product_variant" pv ON pv.id = ol."productVariantId"
+    WHERE o."orderPlacedAt"::timestamptz >= '2020-01-01T00:00:00.000Z' 
+	  AND o.state IN ('PaymentSettled',
+					'PartiallyShipped',
+					'Shipped',
+					'PartiallyDelivered',
+					'Delivered') 
+    GROUP BY hour, ol."productVariantId",occ."channelId"
+    ORDER BY hour DESC;
+  `,
+    }),
+    (0, typeorm_1.Index)(["hour", "productVariantId", "channelId"], { unique: true })
+], TotalProductsViewEntity);

package/dist/plugin-server/materialisedViewEntities/total_products_with_state.d.ts

@@ -0,0 +1,9 @@
+import { OrderState } from "@deenruv/core";
+export declare class TotalProductsWithStateViewEntity {
+    hour: Date;
+    productVariantId: string;
+    quantitySum: number;
+    orderPlacedQuantitySum: number;
+    channelId: string;
+    state: OrderState;
+}

package/dist/plugin-server/materialisedViewEntities/total_products_with_state.js

@@ -0,0 +1,62 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TotalProductsWithStateViewEntity = void 0;
+const typeorm_1 = require("typeorm");
+let TotalProductsWithStateViewEntity = class TotalProductsWithStateViewEntity {
+};
+exports.TotalProductsWithStateViewEntity = TotalProductsWithStateViewEntity;
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Date)
+], TotalProductsWithStateViewEntity.prototype, "hour", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", String)
+], TotalProductsWithStateViewEntity.prototype, "productVariantId", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], TotalProductsWithStateViewEntity.prototype, "quantitySum", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", Number)
+], TotalProductsWithStateViewEntity.prototype, "orderPlacedQuantitySum", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", String)
+], TotalProductsWithStateViewEntity.prototype, "channelId", void 0);
+__decorate([
+    (0, typeorm_1.ViewColumn)(),
+    __metadata("design:type", String)
+], TotalProductsWithStateViewEntity.prototype, "state", void 0);
+exports.TotalProductsWithStateViewEntity = TotalProductsWithStateViewEntity = __decorate([
+    (0, typeorm_1.ViewEntity)({
+        materialized: true,
+        expression: `
+    SELECT
+        date_trunc('hour', o."orderPlacedAt") AS hour,
+	  	  o.state,
+        ol."productVariantId" AS "productVariantId",
+        occ."channelId" AS "channelId",
+        SUM(ol."orderPlacedQuantity") as "orderPlacedQuantitySum",
+	      SUM(ol."quantity") as "quantitySum"
+    FROM "public"."order" o
+    INNER JOIN "public"."order_channels_channel" occ ON occ."orderId" = o."id"
+    INNER JOIN "public"."order_line" ol ON ol."orderId" = o."id"
+    INNER JOIN "public"."product_variant" pv ON pv.id = ol."productVariantId"
+    WHERE o."orderPlacedAt"::timestamptz >= '2020-01-01T00:00:00.000Z'
+    GROUP BY "hour", ol."productVariantId",occ."channelId",o.state
+	  ORDER BY "hour" DESC
+  `,
+    }),
+    (0, typeorm_1.Index)(["hour", "productVariantId", "channelId", "state"], { unique: true })
+], TotalProductsWithStateViewEntity);

package/dist/plugin-server/plugin.d.ts

@@ -0,0 +1,6 @@
+import { Type } from "@deenruv/core";
+import { DashboardWidgetsPluginOptions } from "./types";
+export declare class DashboardWidgetsPlugin {
+    private static options?;
+    static init(options: DashboardWidgetsPluginOptions): Type<DashboardWidgetsPlugin>;
+}