feat: Bump version to 1.2.12 in package.json, update TypeScript version, and add DashboardEndpoints with related DTOs for dashboard statistics

Author: gustaavik

package.json

@@ -1,14 +1,17 @@
 {
   "name": "commercify-api-client",
-  "version": "1.2.11",
+  "version": "1.2.12",
   "description": "API client for the Commercify backend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
-    "build": "tsc"
+    "build": "rm -rf dist && tsc",
+    "pack": "pnpm run build && npm pack",
+    "publish": "pnpm run build && pnpm publish --access public",
+    "prepublishOnly": "pnpm run build"
   },
   "devDependencies": {
-    "typescript": "^5.0.0"
+    "typescript": "^5.9.2"
   },
   "packageManager": "pnpm@10.12.4+sha512.5ea8b0deed94ed68691c9bad4c955492705c5eeb8a87ef86bc62c74a26b037b08ff9570f108b2e4dbd1dd1a9186fea925e527f141c648e85af45631074680184"
 }

pnpm-lock.yaml

@@ -11,6 +11,7 @@ import { UserEndpoints } from "../endpoints/users";
 import { PaymentProviderEndpoints } from "../endpoints/payment-providers";
 import { AdminEndpoints } from "../endpoints/admin";
 import { HealthEndpoints } from "../endpoints/health";
+import { DashboardEndpoints } from "../endpoints/dashboard";
 
 export class CommercifyApiClient extends BaseApiClient {
   public checkout: CheckoutEndpoints;
@@ -25,6 +26,7 @@ export class CommercifyApiClient extends BaseApiClient {
   public paymentProviders: PaymentProviderEndpoints;
   public admin: AdminEndpoints;
   public health: HealthEndpoints;
+  public dashboard: DashboardEndpoints;
 
   constructor(baseURL: string) {
     super(baseURL);
@@ -40,5 +42,6 @@ export class CommercifyApiClient extends BaseApiClient {
     this.paymentProviders = new PaymentProviderEndpoints(this);
     this.admin = new AdminEndpoints(this);
     this.health = new HealthEndpoints(this);
+    this.dashboard = new DashboardEndpoints(this);
   }
 }

src/client/index.ts

@@ -0,0 +1,19 @@
+import { IApiClient, Mapper } from "../client/base";
+import { ResponseDTO } from "../types/contracts";
+import { DashboardStats, DashboardStatsRequest } from "../types/dtos";
+
+export class DashboardEndpoints {
+  constructor(private client: IApiClient) {}
+
+  // Payment Management
+  async getStats<R = ResponseDTO<DashboardStats>>(
+    input: DashboardStatsRequest,
+    mapper?: Mapper<ResponseDTO<DashboardStats>, R>
+  ): Promise<R> {
+    return this.client.post<
+      DashboardStatsRequest,
+      ResponseDTO<DashboardStats>,
+      R
+    >(`/api/admin/dashboard/stats`, input, mapper);
+  }
+}

src/endpoints/dashboard.ts

@@ -122,6 +122,65 @@ export interface CurrencyDTO {
   updated_at: string;
 }
 
+//////////
+// source: dashboard.go
+
+/**
+ * DashboardStatsRequest represents a request for dashboard statistics
+ */
+export interface DashboardStatsRequest {
+  start_date?: string;
+  end_date?: string;
+  days?: number /* int */; // Alternative to date range, defaults to 30
+}
+/**
+ * PercentageChange represents a percentage change with value and direction
+ */
+export interface PercentageChange {
+  value: number /* float64 */; // percentage change (e.g., 15.5 for +15.5%)
+  direction: string; // "up", "down", or "stable"
+}
+/**
+ * DashboardStats represents aggregated dashboard statistics
+ */
+export interface DashboardStats {
+  total_revenue: number /* int64 */; // in cents
+  total_orders: number /* int64 */;
+  total_customers: number /* int64 */;
+  new_customers: number /* int64 */;
+  total_products: number /* int64 */;
+  low_stock_products: number /* int64 */;
+  revenue_change?: PercentageChange; // vs previous period
+  orders_change?: PercentageChange; // vs previous period
+  recent_orders: RecentOrderSummary[];
+  top_products: TopProductSummary[];
+  period_start: string;
+  period_end: string;
+}
+/**
+ * RecentOrderSummary represents a summary of recent orders for dashboard
+ */
+export interface RecentOrderSummary {
+  id: number /* uint */;
+  order_number: string;
+  customer_name: string;
+  customer_email: string;
+  total_amount: number /* int64 */; // in cents
+  status: string;
+  created_at: string;
+}
+/**
+ * TopProductSummary represents top selling products for dashboard
+ */
+export interface TopProductSummary {
+  product_id: number /* uint */;
+  product_name: string;
+  variant_id?: number /* uint */;
+  variant_name?: string;
+  quantity_sold: number /* int64 */;
+  revenue: number /* int64 */; // in cents
+}
+
 //////////
 // source: discount.go