@mydoormot/app-types 1.7.20 → 1.7.21

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @mydoormot/app-types@1.7.19 build /Users/chuksben/Desktop/projects/microservices/mydoormot/packages/app-types
+> @mydoormot/app-types@1.7.20 build /Users/chuksben/Desktop/projects/microservices/mydoormot/packages/app-types
 > tsup src/index.ts --format esm,cjs --dts
 
 CLI Building entry: src/index.ts
@@ -8,11 +8,11 @@
 CLI Target: es2021
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 8.20 KB
-CJS ⚡️ Build success in 134ms
-ESM dist/index.js 6.47 KB
-ESM ⚡️ Build success in 135ms
 DTS Build start
-DTS ⚡️ Build success in 1184ms
-DTS dist/index.d.ts  19.33 KB
-DTS dist/index.d.cts 19.33 KB
+CJS dist/index.cjs 9.29 KB
+CJS ⚡️ Build success in 837ms
+ESM dist/index.js 7.44 KB
+ESM ⚡️ Build success in 837ms
+DTS ⚡️ Build success in 792ms
+DTS dist/index.d.ts  22.98 KB
+DTS dist/index.d.cts 22.98 KB

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @mydoormot/app-types
 
+## 1.7.21
+
+### Patch Changes
+
+- Added commerce
+
 ## 1.7.20
 
 ### Patch Changes

package/dist/index.cjs

@@ -34,7 +34,10 @@ __export(src_exports, {
   MembershipStatus: () => MembershipStatus,
   NotificationType: () => NotificationType,
   ParcelSize: () => ParcelSize,
+  PaymentMethod: () => PaymentMethod,
   PaymentOptions: () => PaymentOptions,
+  RemittanceMethod: () => RemittanceMethod,
+  RemittanceStatus: () => RemittanceStatus,
   RoleType: () => RoleType,
   TraccarDeviceStatus: () => TraccarDeviceStatus,
   VehicleLogType: () => VehicleLogType,
@@ -175,6 +178,27 @@ var VehicleLogType = /* @__PURE__ */ ((VehicleLogType2) => {
   VehicleLogType2["MAINTENANCE"] = "MAINTENANCE";
   return VehicleLogType2;
 })(VehicleLogType || {});
+var RemittanceStatus = /* @__PURE__ */ ((RemittanceStatus2) => {
+  RemittanceStatus2["Pending"] = "pending";
+  RemittanceStatus2["Remitted"] = "remitted";
+  RemittanceStatus2["Waived"] = "waived";
+  RemittanceStatus2["Cancelled"] = "cancelled";
+  return RemittanceStatus2;
+})(RemittanceStatus || {});
+var RemittanceMethod = /* @__PURE__ */ ((RemittanceMethod2) => {
+  RemittanceMethod2["Cash"] = "cash";
+  RemittanceMethod2["Transfer"] = "transfer";
+  RemittanceMethod2["Deduction"] = "deduction";
+  RemittanceMethod2["Other"] = "other";
+  return RemittanceMethod2;
+})(RemittanceMethod || {});
+var PaymentMethod = /* @__PURE__ */ ((PaymentMethod2) => {
+  PaymentMethod2["CashOnDelivery"] = "cash_on_delivery";
+  PaymentMethod2["PrepaidOnline"] = "prepaid_online";
+  PaymentMethod2["PrepaidTransfer"] = "prepaid_transfer";
+  PaymentMethod2["BusinessInvoice"] = "business_invoice";
+  return PaymentMethod2;
+})(PaymentMethod || {});
 
 // src/enterprise.ts
 var EnterpriseType = /* @__PURE__ */ ((EnterpriseType2) => {
@@ -231,7 +255,10 @@ var LinkDestination = /* @__PURE__ */ ((LinkDestination2) => {
   MembershipStatus,
   NotificationType,
   ParcelSize,
+  PaymentMethod,
   PaymentOptions,
+  RemittanceMethod,
+  RemittanceStatus,
   RoleType,
   TraccarDeviceStatus,
   VehicleLogType,

package/dist/index.d.cts

@@ -243,6 +243,74 @@ type VehicleLogWithErrands = VehicleLog & {
     errandsCount?: number;
     totalErrandsRevenue?: number;
 };
+declare enum RemittanceStatus {
+    Pending = "pending",
+    Remitted = "remitted",
+    Waived = "waived",
+    Cancelled = "cancelled"
+}
+declare enum RemittanceMethod {
+    Cash = "cash",
+    Transfer = "transfer",
+    Deduction = "deduction",
+    Other = "other"
+}
+declare enum PaymentMethod {
+    CashOnDelivery = "cash_on_delivery",
+    PrepaidOnline = "prepaid_online",
+    PrepaidTransfer = "prepaid_transfer",
+    BusinessInvoice = "business_invoice"
+}
+interface AdditionalFee {
+    description: string;
+    amount: number;
+    createdAt?: Date;
+    createdBy?: string;
+}
+interface RiderSettlement {
+    id: string;
+    errandId: string;
+    riderId: string;
+    businessId: string;
+    deliveryFeeAmount: number;
+    payOnDeliveryAmount: number;
+    additionalFees: AdditionalFee[];
+    totalCollectionAmount: number;
+    collectionRequired: boolean;
+    remittanceStatus: RemittanceStatus;
+    remittedAmount: number;
+    remittedAt?: Date;
+    remittedBy?: string;
+    remittanceMethod?: RemittanceMethod;
+    remittanceReference?: string;
+    paymentMethod?: PaymentMethod;
+    isPrePaid: boolean;
+    notes?: string;
+    createdAt: Date;
+    updatedAt: Date;
+    version: number;
+}
+interface RiderPerformanceSummary {
+    totalErrands: number;
+    totalRevenue: number;
+    riderCount: number;
+}
+interface RiderPerformanceItem {
+    riderId: string;
+    riderName: string;
+    errandCount: number;
+    revenue: number;
+}
+interface RiderPerformanceTimeSeries {
+    period: string;
+    errandCount: number;
+    revenue: number;
+}
+interface RiderPerformanceStats {
+    summary: RiderPerformanceSummary;
+    riders: RiderPerformanceItem[];
+    timeSeries?: RiderPerformanceTimeSeries[];
+}
 
 declare enum ErrandStatus {
     Pending = "pending",
@@ -743,6 +811,83 @@ interface TrackerDevice {
     lastPosition?: TraccarPosition | NullOrUndefined;
 }
 
+/**
+ * Maintenance Item - catalog of parts/services used in maintenance
+ */
+interface MaintenanceItem {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    businessId?: string | null;
+    unit?: string;
+    defaultUnitPrice?: number;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Part usage within a maintenance record.
+ * itemName is denormalized to preserve historical accuracy.
+ */
+interface MaintenancePartUsage {
+    itemId: string;
+    itemName: string;
+    quantity: number;
+    unitPrice: number;
+    totalCost: number;
+    unit?: string;
+    note?: string;
+}
+/**
+ * Maintenance Record - tracks maintenance performed on a vehicle
+ */
+interface MaintenanceRecord {
+    id: string;
+    businessId: string;
+    vehicleId: string;
+    maintenanceDate: string;
+    parts: MaintenancePartUsage[];
+    laborCost?: number;
+    totalCost: number;
+    performedBy?: string;
+    notes?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Summary statistics for maintenance records
+ */
+interface MaintenanceStatsSummary {
+    totalCost: number;
+    totalLaborCost: number;
+    totalPartsCost: number;
+    recordCount: number;
+}
+/**
+ * Top item usage statistics
+ */
+interface MaintenanceTopItem {
+    itemId: string;
+    itemName: string;
+    totalQuantity: number;
+    totalCost: number;
+    usageCount: number;
+}
+/**
+ * Maintenance statistics response
+ */
+interface MaintenanceStats {
+    summary: MaintenanceStatsSummary;
+    topItems: MaintenanceTopItem[];
+    filters: {
+        businessId: string;
+        vehicleId: string | null;
+        startDate: string | null;
+        endDate: string | null;
+    };
+}
+
 interface PaginateResult<T> {
     docs: T[];
     totalDocs: number;
@@ -765,4 +910,4 @@ declare enum LinkDestination {
 }
 type NullOrUndefined = null | undefined;
 
-export { type AddressDetails, AddressTypes, type AggregatedErrand, AuthType, type Business, type BusinessCategory, type BusinessMember, type BusinessPg, BusinessRole, type City, type Coupon, type Customer, type CustomerTransactionStats, DeliveryStatus, type Enterprise, type EnterpriseCategoryDoc, type EnterpriseSubCategoryDoc, EnterpriseType, type Errand, type ErrandDeliveryTiming, type ErrandPackagingQuality, type ErrandRating, type ErrandReview, type ErrandReviewLink, type ErrandRiderBehavior, ErrandStatus, type ErrandTimeline, GlobalRoles, type Invoice, InvoiceGenerationType, type InvoiceItem, InvoiceItemType, InvoiceStatus, type LatLng, LinkDestination, MembershipStatus, type Notification, type NotificationData, NotificationType, type NullOrUndefined, type PaginateResult, ParcelSize, PaymentOptions, type PendingErrand, type Rider, RoleType, type State, type TraccarDevice, TraccarDeviceStatus, type TraccarPosition, type TrackerDevice, type Transaction, type TransactionCategory, type TransactionItem, type TransactionType, type TransactionWithCategory, type TransactionWithJoin, type User, type UserAddress, type Vehicle, type VehicleLog, type VehicleLogStatsSummary, VehicleLogType, type VehicleLogWithErrands, VehicleType, type VehicleWithRider, type Vendor, errandTimeline };
+export { type AdditionalFee, type AddressDetails, AddressTypes, type AggregatedErrand, AuthType, type Business, type BusinessCategory, type BusinessMember, type BusinessPg, BusinessRole, type City, type Coupon, type Customer, type CustomerTransactionStats, DeliveryStatus, type Enterprise, type EnterpriseCategoryDoc, type EnterpriseSubCategoryDoc, EnterpriseType, type Errand, type ErrandDeliveryTiming, type ErrandPackagingQuality, type ErrandRating, type ErrandReview, type ErrandReviewLink, type ErrandRiderBehavior, ErrandStatus, type ErrandTimeline, GlobalRoles, type Invoice, InvoiceGenerationType, type InvoiceItem, InvoiceItemType, InvoiceStatus, type LatLng, LinkDestination, type MaintenanceItem, type MaintenancePartUsage, type MaintenanceRecord, type MaintenanceStats, type MaintenanceStatsSummary, type MaintenanceTopItem, MembershipStatus, type Notification, type NotificationData, NotificationType, type NullOrUndefined, type PaginateResult, ParcelSize, PaymentMethod, PaymentOptions, type PendingErrand, RemittanceMethod, RemittanceStatus, type Rider, type RiderPerformanceItem, type RiderPerformanceStats, type RiderPerformanceSummary, type RiderPerformanceTimeSeries, type RiderSettlement, RoleType, type State, type TraccarDevice, TraccarDeviceStatus, type TraccarPosition, type TrackerDevice, type Transaction, type TransactionCategory, type TransactionItem, type TransactionType, type TransactionWithCategory, type TransactionWithJoin, type User, type UserAddress, type Vehicle, type VehicleLog, type VehicleLogStatsSummary, VehicleLogType, type VehicleLogWithErrands, VehicleType, type VehicleWithRider, type Vendor, errandTimeline };

package/dist/index.d.ts

@@ -243,6 +243,74 @@ type VehicleLogWithErrands = VehicleLog & {
     errandsCount?: number;
     totalErrandsRevenue?: number;
 };
+declare enum RemittanceStatus {
+    Pending = "pending",
+    Remitted = "remitted",
+    Waived = "waived",
+    Cancelled = "cancelled"
+}
+declare enum RemittanceMethod {
+    Cash = "cash",
+    Transfer = "transfer",
+    Deduction = "deduction",
+    Other = "other"
+}
+declare enum PaymentMethod {
+    CashOnDelivery = "cash_on_delivery",
+    PrepaidOnline = "prepaid_online",
+    PrepaidTransfer = "prepaid_transfer",
+    BusinessInvoice = "business_invoice"
+}
+interface AdditionalFee {
+    description: string;
+    amount: number;
+    createdAt?: Date;
+    createdBy?: string;
+}
+interface RiderSettlement {
+    id: string;
+    errandId: string;
+    riderId: string;
+    businessId: string;
+    deliveryFeeAmount: number;
+    payOnDeliveryAmount: number;
+    additionalFees: AdditionalFee[];
+    totalCollectionAmount: number;
+    collectionRequired: boolean;
+    remittanceStatus: RemittanceStatus;
+    remittedAmount: number;
+    remittedAt?: Date;
+    remittedBy?: string;
+    remittanceMethod?: RemittanceMethod;
+    remittanceReference?: string;
+    paymentMethod?: PaymentMethod;
+    isPrePaid: boolean;
+    notes?: string;
+    createdAt: Date;
+    updatedAt: Date;
+    version: number;
+}
+interface RiderPerformanceSummary {
+    totalErrands: number;
+    totalRevenue: number;
+    riderCount: number;
+}
+interface RiderPerformanceItem {
+    riderId: string;
+    riderName: string;
+    errandCount: number;
+    revenue: number;
+}
+interface RiderPerformanceTimeSeries {
+    period: string;
+    errandCount: number;
+    revenue: number;
+}
+interface RiderPerformanceStats {
+    summary: RiderPerformanceSummary;
+    riders: RiderPerformanceItem[];
+    timeSeries?: RiderPerformanceTimeSeries[];
+}
 
 declare enum ErrandStatus {
     Pending = "pending",
@@ -743,6 +811,83 @@ interface TrackerDevice {
     lastPosition?: TraccarPosition | NullOrUndefined;
 }
 
+/**
+ * Maintenance Item - catalog of parts/services used in maintenance
+ */
+interface MaintenanceItem {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    businessId?: string | null;
+    unit?: string;
+    defaultUnitPrice?: number;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Part usage within a maintenance record.
+ * itemName is denormalized to preserve historical accuracy.
+ */
+interface MaintenancePartUsage {
+    itemId: string;
+    itemName: string;
+    quantity: number;
+    unitPrice: number;
+    totalCost: number;
+    unit?: string;
+    note?: string;
+}
+/**
+ * Maintenance Record - tracks maintenance performed on a vehicle
+ */
+interface MaintenanceRecord {
+    id: string;
+    businessId: string;
+    vehicleId: string;
+    maintenanceDate: string;
+    parts: MaintenancePartUsage[];
+    laborCost?: number;
+    totalCost: number;
+    performedBy?: string;
+    notes?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Summary statistics for maintenance records
+ */
+interface MaintenanceStatsSummary {
+    totalCost: number;
+    totalLaborCost: number;
+    totalPartsCost: number;
+    recordCount: number;
+}
+/**
+ * Top item usage statistics
+ */
+interface MaintenanceTopItem {
+    itemId: string;
+    itemName: string;
+    totalQuantity: number;
+    totalCost: number;
+    usageCount: number;
+}
+/**
+ * Maintenance statistics response
+ */
+interface MaintenanceStats {
+    summary: MaintenanceStatsSummary;
+    topItems: MaintenanceTopItem[];
+    filters: {
+        businessId: string;
+        vehicleId: string | null;
+        startDate: string | null;
+        endDate: string | null;
+    };
+}
+
 interface PaginateResult<T> {
     docs: T[];
     totalDocs: number;
@@ -765,4 +910,4 @@ declare enum LinkDestination {
 }
 type NullOrUndefined = null | undefined;
 
-export { type AddressDetails, AddressTypes, type AggregatedErrand, AuthType, type Business, type BusinessCategory, type BusinessMember, type BusinessPg, BusinessRole, type City, type Coupon, type Customer, type CustomerTransactionStats, DeliveryStatus, type Enterprise, type EnterpriseCategoryDoc, type EnterpriseSubCategoryDoc, EnterpriseType, type Errand, type ErrandDeliveryTiming, type ErrandPackagingQuality, type ErrandRating, type ErrandReview, type ErrandReviewLink, type ErrandRiderBehavior, ErrandStatus, type ErrandTimeline, GlobalRoles, type Invoice, InvoiceGenerationType, type InvoiceItem, InvoiceItemType, InvoiceStatus, type LatLng, LinkDestination, MembershipStatus, type Notification, type NotificationData, NotificationType, type NullOrUndefined, type PaginateResult, ParcelSize, PaymentOptions, type PendingErrand, type Rider, RoleType, type State, type TraccarDevice, TraccarDeviceStatus, type TraccarPosition, type TrackerDevice, type Transaction, type TransactionCategory, type TransactionItem, type TransactionType, type TransactionWithCategory, type TransactionWithJoin, type User, type UserAddress, type Vehicle, type VehicleLog, type VehicleLogStatsSummary, VehicleLogType, type VehicleLogWithErrands, VehicleType, type VehicleWithRider, type Vendor, errandTimeline };
+export { type AdditionalFee, type AddressDetails, AddressTypes, type AggregatedErrand, AuthType, type Business, type BusinessCategory, type BusinessMember, type BusinessPg, BusinessRole, type City, type Coupon, type Customer, type CustomerTransactionStats, DeliveryStatus, type Enterprise, type EnterpriseCategoryDoc, type EnterpriseSubCategoryDoc, EnterpriseType, type Errand, type ErrandDeliveryTiming, type ErrandPackagingQuality, type ErrandRating, type ErrandReview, type ErrandReviewLink, type ErrandRiderBehavior, ErrandStatus, type ErrandTimeline, GlobalRoles, type Invoice, InvoiceGenerationType, type InvoiceItem, InvoiceItemType, InvoiceStatus, type LatLng, LinkDestination, type MaintenanceItem, type MaintenancePartUsage, type MaintenanceRecord, type MaintenanceStats, type MaintenanceStatsSummary, type MaintenanceTopItem, MembershipStatus, type Notification, type NotificationData, NotificationType, type NullOrUndefined, type PaginateResult, ParcelSize, PaymentMethod, PaymentOptions, type PendingErrand, RemittanceMethod, RemittanceStatus, type Rider, type RiderPerformanceItem, type RiderPerformanceStats, type RiderPerformanceSummary, type RiderPerformanceTimeSeries, type RiderSettlement, RoleType, type State, type TraccarDevice, TraccarDeviceStatus, type TraccarPosition, type TrackerDevice, type Transaction, type TransactionCategory, type TransactionItem, type TransactionType, type TransactionWithCategory, type TransactionWithJoin, type User, type UserAddress, type Vehicle, type VehicleLog, type VehicleLogStatsSummary, VehicleLogType, type VehicleLogWithErrands, VehicleType, type VehicleWithRider, type Vendor, errandTimeline };

package/dist/index.js

@@ -130,6 +130,27 @@ var VehicleLogType = /* @__PURE__ */ ((VehicleLogType2) => {
   VehicleLogType2["MAINTENANCE"] = "MAINTENANCE";
   return VehicleLogType2;
 })(VehicleLogType || {});
+var RemittanceStatus = /* @__PURE__ */ ((RemittanceStatus2) => {
+  RemittanceStatus2["Pending"] = "pending";
+  RemittanceStatus2["Remitted"] = "remitted";
+  RemittanceStatus2["Waived"] = "waived";
+  RemittanceStatus2["Cancelled"] = "cancelled";
+  return RemittanceStatus2;
+})(RemittanceStatus || {});
+var RemittanceMethod = /* @__PURE__ */ ((RemittanceMethod2) => {
+  RemittanceMethod2["Cash"] = "cash";
+  RemittanceMethod2["Transfer"] = "transfer";
+  RemittanceMethod2["Deduction"] = "deduction";
+  RemittanceMethod2["Other"] = "other";
+  return RemittanceMethod2;
+})(RemittanceMethod || {});
+var PaymentMethod = /* @__PURE__ */ ((PaymentMethod2) => {
+  PaymentMethod2["CashOnDelivery"] = "cash_on_delivery";
+  PaymentMethod2["PrepaidOnline"] = "prepaid_online";
+  PaymentMethod2["PrepaidTransfer"] = "prepaid_transfer";
+  PaymentMethod2["BusinessInvoice"] = "business_invoice";
+  return PaymentMethod2;
+})(PaymentMethod || {});
 
 // src/enterprise.ts
 var EnterpriseType = /* @__PURE__ */ ((EnterpriseType2) => {
@@ -185,7 +206,10 @@ export {
   MembershipStatus,
   NotificationType,
   ParcelSize,
+  PaymentMethod,
   PaymentOptions,
+  RemittanceMethod,
+  RemittanceStatus,
   RoleType,
   TraccarDeviceStatus,
   VehicleLogType,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mydoormot/app-types",
-  "version": "1.7.20",
+  "version": "1.7.21",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

package/src/index.ts

@@ -35,3 +35,4 @@ export * from './customer';
 export * from './transaction';
 export * from './stat';
 export * from './tracker';
+export * from './maintenance';

package/src/maintenance.ts

@@ -0,0 +1,81 @@
+/**
+ * Maintenance Item - catalog of parts/services used in maintenance
+ */
+export interface MaintenanceItem {
+  id: string;
+  name: string;
+  slug: string;
+  description?: string;
+  businessId?: string | null; // null = global item available to all businesses
+  unit?: string; // "piece", "liter", etc.
+  defaultUnitPrice?: number;
+  isActive: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+
+/**
+ * Part usage within a maintenance record.
+ * itemName is denormalized to preserve historical accuracy.
+ */
+export interface MaintenancePartUsage {
+  itemId: string;
+  itemName: string; // Snapshot of item name at time of record creation
+  quantity: number;
+  unitPrice: number;
+  totalCost: number; // quantity * unitPrice
+  unit?: string;
+  note?: string;
+}
+
+/**
+ * Maintenance Record - tracks maintenance performed on a vehicle
+ */
+export interface MaintenanceRecord {
+  id: string;
+  businessId: string;
+  vehicleId: string;
+  maintenanceDate: string;
+  parts: MaintenancePartUsage[];
+  laborCost?: number;
+  totalCost: number; // sum(parts.totalCost) + laborCost
+  performedBy?: string; // User ID who performed the maintenance
+  notes?: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+/**
+ * Summary statistics for maintenance records
+ */
+export interface MaintenanceStatsSummary {
+  totalCost: number;
+  totalLaborCost: number;
+  totalPartsCost: number;
+  recordCount: number;
+}
+
+/**
+ * Top item usage statistics
+ */
+export interface MaintenanceTopItem {
+  itemId: string;
+  itemName: string;
+  totalQuantity: number;
+  totalCost: number;
+  usageCount: number;
+}
+
+/**
+ * Maintenance statistics response
+ */
+export interface MaintenanceStats {
+  summary: MaintenanceStatsSummary;
+  topItems: MaintenanceTopItem[];
+  filters: {
+    businessId: string;
+    vehicleId: string | null;
+    startDate: string | null;
+    endDate: string | null;
+  };
+}

package/src/rider.ts

@@ -84,3 +84,82 @@ export type VehicleLogWithErrands = VehicleLog & {
 //   riderDetails: Rider | null;
 //   riderUserDetails: User | null;
 // };
+
+// Rider Settlement Types
+export enum RemittanceStatus {
+  Pending = 'pending',
+  Remitted = 'remitted',
+  Waived = 'waived',
+  Cancelled = 'cancelled',
+}
+
+export enum RemittanceMethod {
+  Cash = 'cash',
+  Transfer = 'transfer',
+  Deduction = 'deduction',
+  Other = 'other',
+}
+
+export enum PaymentMethod {
+  CashOnDelivery = 'cash_on_delivery',
+  PrepaidOnline = 'prepaid_online',
+  PrepaidTransfer = 'prepaid_transfer',
+  BusinessInvoice = 'business_invoice',
+}
+
+export interface AdditionalFee {
+  description: string;
+  amount: number;
+  createdAt?: Date;
+  createdBy?: string;
+}
+
+export interface RiderSettlement {
+  id: string;
+  errandId: string;
+  riderId: string;
+  businessId: string;
+  deliveryFeeAmount: number;
+  payOnDeliveryAmount: number;
+  additionalFees: AdditionalFee[];
+  totalCollectionAmount: number;
+  collectionRequired: boolean;
+  remittanceStatus: RemittanceStatus;
+  remittedAmount: number;
+  remittedAt?: Date;
+  remittedBy?: string;
+  remittanceMethod?: RemittanceMethod;
+  remittanceReference?: string;
+  paymentMethod?: PaymentMethod;
+  isPrePaid: boolean;
+  notes?: string;
+  createdAt: Date;
+  updatedAt: Date;
+  version: number;
+}
+
+// Rider Performance Stats Types
+export interface RiderPerformanceSummary {
+  totalErrands: number;
+  totalRevenue: number;
+  riderCount: number;
+}
+
+export interface RiderPerformanceItem {
+  riderId: string;
+  riderName: string;
+  errandCount: number;
+  revenue: number;
+}
+
+export interface RiderPerformanceTimeSeries {
+  period: string;
+  errandCount: number;
+  revenue: number;
+}
+
+export interface RiderPerformanceStats {
+  summary: RiderPerformanceSummary;
+  riders: RiderPerformanceItem[];
+  timeSeries?: RiderPerformanceTimeSeries[];
+}