@devlider001/washlab-backend 1.0.3 → 1.0.4

package/convex/_generated/api.d.ts

@@ -9,6 +9,7 @@
  */
 
 import type * as admin from "../admin.js";
+import type * as analytics from "../analytics.js";
 import type * as attendants from "../attendants.js";
 import type * as audit from "../audit.js";
 import type * as clerk from "../clerk.js";
@@ -21,6 +22,7 @@ import type * as loyalty from "../loyalty.js";
 import type * as orders from "../orders.js";
 import type * as payments from "../payments.js";
 import type * as resources from "../resources.js";
+import type * as vouchers from "../vouchers.js";
 
 import type {
   ApiFromModules,
@@ -30,6 +32,7 @@ import type {
 
 declare const fullApi: ApiFromModules<{
   admin: typeof admin;
+  analytics: typeof analytics;
   attendants: typeof attendants;
   audit: typeof audit;
   clerk: typeof clerk;
@@ -42,6 +45,7 @@ declare const fullApi: ApiFromModules<{
   orders: typeof orders;
   payments: typeof payments;
   resources: typeof resources;
+  vouchers: typeof vouchers;
 }>;
 
 /**

package/convex/admin.d.ts

@@ -37,6 +37,7 @@ export declare const getBranches: import("convex/server").RegisteredQuery<"publi
         createdAt: number;
         isDeleted: boolean;
         isActive: boolean;
+        code: string;
         address: string;
         city: string;
         country: string;
@@ -47,6 +48,50 @@ export declare const getBranches: import("convex/server").RegisteredQuery<"publi
     isDone: boolean;
     continueCursor: string;
 }>>;
+/**
+ * Get branch by code
+ */
+export declare const getBranchByCode: import("convex/server").RegisteredQuery<"public", {
+    code: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"branches">;
+    _creationTime: number;
+    email?: string | undefined;
+    phoneNumber: string;
+    name: string;
+    createdAt: number;
+    isDeleted: boolean;
+    isActive: boolean;
+    code: string;
+    address: string;
+    city: string;
+    country: string;
+    pricingPerKg: number;
+    deliveryFee: number;
+    createdBy: import("convex/values").GenericId<"admins">;
+} | null>>;
+/**
+ * Get single branch by ID
+ */
+export declare const getBranch: import("convex/server").RegisteredQuery<"public", {
+    branchId: import("convex/values").GenericId<"branches">;
+}, Promise<{
+    _id: import("convex/values").GenericId<"branches">;
+    _creationTime: number;
+    email?: string | undefined;
+    phoneNumber: string;
+    name: string;
+    createdAt: number;
+    isDeleted: boolean;
+    isActive: boolean;
+    code: string;
+    address: string;
+    city: string;
+    country: string;
+    pricingPerKg: number;
+    deliveryFee: number;
+    createdBy: import("convex/values").GenericId<"admins">;
+} | null>>;
 /**
  * Get all attendants - Paginated
  * Supports usePaginatedQuery for infinite scroll
@@ -79,8 +124,8 @@ export declare const getAttendants: import("convex/server").RegisteredQuery<"pub
  * Supports usePaginatedQuery for infinite scroll
  */
 export declare const getOrders: import("convex/server").RegisteredQuery<"public", {
-    branchId?: import("convex/values").GenericId<"branches"> | undefined;
     status?: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled" | undefined;
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
     cursor?: string | undefined;
     numItems?: number | undefined;
     startDate?: number | undefined;
@@ -95,6 +140,7 @@ export declare const getOrders: import("convex/server").RegisteredQuery<"public"
         itemCount?: number | undefined;
         estimatedLoads?: number | undefined;
         whitesSeparate?: boolean | undefined;
+        bagCardNumber?: string | undefined;
         notes?: string | undefined;
         deliveryAddress?: string | undefined;
         deliveryPhoneNumber?: string | undefined;
@@ -103,6 +149,7 @@ export declare const getOrders: import("convex/server").RegisteredQuery<"public"
         paymentMethod?: "mobile_money" | "card" | "cash" | undefined;
         paymentId?: import("convex/values").GenericId<"payments"> | undefined;
         fulfilledBy?: import("convex/values").GenericId<"attendants"> | undefined;
+        status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
         createdAt: number;
         isDeleted: boolean;
         branchId: import("convex/values").GenericId<"branches">;
@@ -116,7 +163,6 @@ export declare const getOrders: import("convex/server").RegisteredQuery<"public"
         basePrice: number;
         totalPrice: number;
         finalPrice: number;
-        status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
         paymentStatus: "pending" | "paid" | "failed" | "refunded";
         updatedAt: number;
         statusHistory: {
@@ -158,27 +204,73 @@ export declare const getAnalytics: import("convex/server").RegisteredQuery<"publ
  * Supports usePaginatedQuery for infinite scroll
  */
 export declare const getCustomers: import("convex/server").RegisteredQuery<"public", {
+    isRegistered?: boolean | undefined;
+    status?: "active" | "blocked" | "suspended" | "restricted" | undefined;
     search?: string | undefined;
-    cursor?: string | undefined;
-    numItems?: number | undefined;
+    paginationOpts: {
+        id?: number;
+        endCursor?: string | null;
+        maximumRowsRead?: number;
+        maximumBytesRead?: number;
+        numItems: number;
+        cursor: string | null;
+    };
 }, Promise<{
     page: {
+        orderCount: number;
+        completedOrderCount: number;
+        totalSpent: number;
+        lastOrderDate: number;
+        lastOrderNumber: string;
         _id: import("convex/values").GenericId<"users">;
         _creationTime: number;
         email?: string | undefined;
         clerkUserId?: string | undefined;
+        statusNote?: string | undefined;
+        statusChangedBy?: import("convex/values").GenericId<"admins"> | undefined;
+        statusChangedAt?: number | undefined;
         lastLoginAt?: number | undefined;
         preferredBranchId?: import("convex/values").GenericId<"branches"> | undefined;
         phoneNumber: string;
         name: string;
         isRegistered: boolean;
         isVerified: boolean;
+        status: "active" | "blocked" | "suspended" | "restricted";
         createdAt: number;
         isDeleted: boolean;
     }[];
     isDone: boolean;
     continueCursor: string;
 }>>;
+/**
+ * Get customer statistics/aggregations
+ */
+export declare const getCustomerStats: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+    totalCustomers: number;
+    registeredCustomers: number;
+    walkInCustomers: number;
+    activeCustomers: number;
+    blockedCustomers: number;
+    suspendedCustomers: number;
+    restrictedCustomers: number;
+    verifiedCustomers: number;
+    customersWithActiveOrders: number;
+    totalRevenue: number;
+}>>;
+/**
+ * Change customer status (with required note)
+ */
+export declare const changeCustomerStatus: import("convex/server").RegisteredMutation<"public", {
+    status: "active" | "blocked" | "suspended" | "restricted";
+    customerId: import("convex/values").GenericId<"users">;
+    note: string;
+}, Promise<import("convex/values").GenericId<"users">>>;
+/**
+ * Delete a customer (soft delete)
+ */
+export declare const deleteCustomer: import("convex/server").RegisteredMutation<"public", {
+    customerId: import("convex/values").GenericId<"users">;
+}, Promise<import("convex/values").GenericId<"users">>>;
 /**
  * Create new branch
  */
@@ -186,6 +278,7 @@ export declare const createBranch: import("convex/server").RegisteredMutation<"p
     email?: string | undefined;
     phoneNumber: string;
     name: string;
+    code: string;
     address: string;
     city: string;
     country: string;
@@ -200,6 +293,7 @@ export declare const updateBranch: import("convex/server").RegisteredMutation<"p
     email?: string | undefined;
     name?: string | undefined;
     isActive?: boolean | undefined;
+    code?: string | undefined;
     address?: string | undefined;
     city?: string | undefined;
     country?: string | undefined;
@@ -207,6 +301,21 @@ export declare const updateBranch: import("convex/server").RegisteredMutation<"p
     deliveryFee?: number | undefined;
     branchId: import("convex/values").GenericId<"branches">;
 }, Promise<import("convex/values").GenericId<"branches">>>;
+/**
+ * Toggle branch active status (enable/disable)
+ */
+export declare const toggleBranchStatus: import("convex/server").RegisteredMutation<"public", {
+    branchId: import("convex/values").GenericId<"branches">;
+}, Promise<{
+    branchId: import("convex/values").GenericId<"branches">;
+    isActive: boolean;
+}>>;
+/**
+ * Delete branch (soft delete)
+ */
+export declare const deleteBranch: import("convex/server").RegisteredMutation<"public", {
+    branchId: import("convex/values").GenericId<"branches">;
+}, Promise<import("convex/values").GenericId<"branches">>>;
 /**
  * Create attendant account
  * Note: Clerk user must be created separately, then link clerkUserId
@@ -238,6 +347,12 @@ export declare const assignAttendantToBranch: import("convex/server").Registered
     branchId: import("convex/values").GenericId<"branches">;
     attendantId: import("convex/values").GenericId<"attendants">;
 }, Promise<import("convex/values").GenericId<"attendants">>>;
+/**
+ * Delete attendant (soft delete)
+ */
+export declare const deleteAttendant: import("convex/server").RegisteredMutation<"public", {
+    attendantId: import("convex/values").GenericId<"attendants">;
+}, Promise<import("convex/values").GenericId<"attendants">>>;
 /**
  * Create admin account
  * Only super admins can create other admins
@@ -249,4 +364,14 @@ export declare const createAdmin: import("convex/server").RegisteredMutation<"pu
     clerkUserId: string;
     role: "super_admin" | "admin";
 }, Promise<import("convex/values").GenericId<"admins">>>;
+/**
+ * Create the first super admin (one-time setup)
+ * This function can only be used when no super admins exist in the database
+ * After the first super admin is created, use createAdmin instead
+ */
+export declare const createFirstSuperAdmin: import("convex/server").RegisteredMutation<"public", {
+    email: string;
+    name: string;
+    clerkUserId: string;
+}, Promise<import("convex/values").GenericId<"admins">>>;
 //# sourceMappingURL=admin.d.ts.map

package/convex/analytics.d.ts

@@ -0,0 +1,87 @@
+import { Id } from "./_generated/dataModel";
+/**
+ * Analytics Functions
+ *
+ * Comprehensive analytics and aggregations for dashboard, reports, and insights.
+ */
+/**
+ * Get dashboard overview statistics
+ */
+export declare const getDashboardStats: import("convex/server").RegisteredQuery<"public", {
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+    startDate?: number | undefined;
+    endDate?: number | undefined;
+}, Promise<{
+    totalOrders: number;
+    totalRevenue: number;
+    completedOrders: number;
+    pendingOrders: number;
+    walkInOrders: number;
+    onlineOrders: number;
+    averageOrderValue: number;
+    ordersByStatus: Record<string, number>;
+    ordersByDay: Record<string, number>;
+    revenueByDay: Record<string, number>;
+    ordersByServiceType: Record<string, number>;
+    ordersByPaymentMethod: Record<string, number>;
+    dateRange: {
+        start: number;
+        end: number;
+    };
+}>>;
+/**
+ * Get today's statistics
+ */
+export declare const getTodayStats: import("convex/server").RegisteredQuery<"public", {
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+}, Promise<{
+    totalOrders: number;
+    totalRevenue: number;
+    completedOrders: number;
+    pendingOrders: number;
+    walkInOrders: number;
+    onlineOrders: number;
+}>>;
+/**
+ * Get top customers by order count
+ */
+export declare const getTopCustomers: import("convex/server").RegisteredQuery<"public", {
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+    startDate?: number | undefined;
+    endDate?: number | undefined;
+    limit?: number | undefined;
+}, Promise<{
+    customerId: Id<"users">;
+    name: string;
+    phoneNumber: string;
+    orderCount: number;
+    totalRevenue: number;
+    averageOrderValue: number;
+}[]>>;
+/**
+ * Get revenue trends (daily/weekly/monthly)
+ */
+export declare const getRevenueTrends: import("convex/server").RegisteredQuery<"public", {
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+    days?: number | undefined;
+    period: "daily" | "weekly" | "monthly";
+}, Promise<{
+    period: string;
+    revenue: number;
+    orders: number;
+}[]>>;
+/**
+ * Get branch performance comparison
+ */
+export declare const getBranchPerformance: import("convex/server").RegisteredQuery<"public", {
+    startDate?: number | undefined;
+    endDate?: number | undefined;
+}, Promise<{
+    branchId: import("convex/values").GenericId<"branches">;
+    branchName: string;
+    totalOrders: number;
+    totalRevenue: number;
+    completedOrders: number;
+    averageOrderValue: number;
+}[]>>;
+//# sourceMappingURL=analytics.d.ts.map

package/convex/attendants.d.ts

@@ -97,4 +97,44 @@ export declare const clockIn: import("convex/server").RegisteredMutation<"public
 export declare const clockOut: import("convex/server").RegisteredMutation<"public", {
     attendanceLogId?: import("convex/values").GenericId<"attendanceLogs"> | undefined;
 }, Promise<import("convex/values").GenericId<"attendanceLogs">>>;
+/**
+ * Get attendance statistics for a branch
+ */
+export declare const getBranchAttendanceStats: import("convex/server").RegisteredQuery<"public", {
+    date?: string | undefined;
+    branchId: import("convex/values").GenericId<"branches">;
+}, Promise<{
+    date: string;
+    branchId: import("convex/values").GenericId<"branches">;
+    clockIns: number;
+    clockOuts: number;
+    activeSessions: number;
+    uniqueAttendants: number;
+    totalHoursWorked: number;
+    averageHoursPerAttendant: number;
+}>>;
+/**
+ * Get attendance summary for date range
+ */
+export declare const getAttendanceSummary: import("convex/server").RegisteredQuery<"public", {
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+    startDate?: number | undefined;
+    endDate?: number | undefined;
+}, Promise<{
+    totalSessions: number;
+    completedSessions: number;
+    activeSessions: number;
+    uniqueAttendants: number;
+    totalHoursWorked: number;
+    averageHoursPerSession: number;
+    attendanceByDay: Record<string, {
+        clockIns: number;
+        clockOuts: number;
+        hours: number;
+    }>;
+    dateRange: {
+        start: number;
+        end: number;
+    };
+}>>;
 //# sourceMappingURL=attendants.d.ts.map

package/convex/customers.d.ts

@@ -16,12 +16,16 @@ export declare const getByPhone: import("convex/server").RegisteredQuery<"public
     _creationTime: number;
     email?: string | undefined;
     clerkUserId?: string | undefined;
+    statusNote?: string | undefined;
+    statusChangedBy?: import("convex/values").GenericId<"admins"> | undefined;
+    statusChangedAt?: number | undefined;
     lastLoginAt?: number | undefined;
     preferredBranchId?: import("convex/values").GenericId<"branches"> | undefined;
     phoneNumber: string;
     name: string;
     isRegistered: boolean;
     isVerified: boolean;
+    status: "active" | "blocked" | "suspended" | "restricted";
     createdAt: number;
     isDeleted: boolean;
 } | null>>;
@@ -35,12 +39,16 @@ export declare const getProfile: import("convex/server").RegisteredQuery<"public
     _creationTime: number;
     email?: string | undefined;
     clerkUserId?: string | undefined;
+    statusNote?: string | undefined;
+    statusChangedBy?: import("convex/values").GenericId<"admins"> | undefined;
+    statusChangedAt?: number | undefined;
     lastLoginAt?: number | undefined;
     preferredBranchId?: import("convex/values").GenericId<"branches"> | undefined;
     phoneNumber: string;
     name: string;
     isRegistered: boolean;
     isVerified: boolean;
+    status: "active" | "blocked" | "suspended" | "restricted";
     createdAt: number;
     isDeleted: boolean;
 }>>;
@@ -61,6 +69,7 @@ export declare const getOrders: import("convex/server").RegisteredQuery<"public"
         itemCount?: number | undefined;
         estimatedLoads?: number | undefined;
         whitesSeparate?: boolean | undefined;
+        bagCardNumber?: string | undefined;
         notes?: string | undefined;
         deliveryAddress?: string | undefined;
         deliveryPhoneNumber?: string | undefined;
@@ -69,6 +78,7 @@ export declare const getOrders: import("convex/server").RegisteredQuery<"public"
         paymentMethod?: "mobile_money" | "card" | "cash" | undefined;
         paymentId?: import("convex/values").GenericId<"payments"> | undefined;
         fulfilledBy?: import("convex/values").GenericId<"attendants"> | undefined;
+        status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
         createdAt: number;
         isDeleted: boolean;
         branchId: import("convex/values").GenericId<"branches">;
@@ -82,7 +92,6 @@ export declare const getOrders: import("convex/server").RegisteredQuery<"public"
         basePrice: number;
         totalPrice: number;
         finalPrice: number;
-        status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
         paymentStatus: "pending" | "paid" | "failed" | "refunded";
         updatedAt: number;
         statusHistory: {
@@ -153,4 +162,63 @@ export declare const createTestUser: import("convex/server").RegisteredMutation<
     phoneNumber: string;
     name: string;
 }, Promise<import("convex/values").GenericId<"users">>>;
+/**
+ * Search customers by name or phone number
+ * Used by POS for customer lookup
+ */
+export declare const search: import("convex/server").RegisteredQuery<"public", {
+    limit?: number | undefined;
+    query: string;
+}, Promise<{
+    orderCount: number;
+    completedOrderCount: number;
+    totalSpent: number;
+    lastOrderDate: number;
+    _id: import("convex/values").GenericId<"users">;
+    _creationTime: number;
+    email?: string | undefined;
+    clerkUserId?: string | undefined;
+    statusNote?: string | undefined;
+    statusChangedBy?: import("convex/values").GenericId<"admins"> | undefined;
+    statusChangedAt?: number | undefined;
+    lastLoginAt?: number | undefined;
+    preferredBranchId?: import("convex/values").GenericId<"branches"> | undefined;
+    phoneNumber: string;
+    name: string;
+    isRegistered: boolean;
+    isVerified: boolean;
+    status: "active" | "blocked" | "suspended" | "restricted";
+    createdAt: number;
+    isDeleted: boolean;
+}[]>>;
+/**
+ * Get customer details with full order history
+ */
+export declare const getDetails: import("convex/server").RegisteredQuery<"public", {
+    customerId: import("convex/values").GenericId<"users">;
+}, Promise<{
+    orderCount: number;
+    completedOrderCount: number;
+    totalSpent: number;
+    averageOrderValue: number;
+    loyaltyPoints: number;
+    lastOrderDate: number;
+    lastOrderNumber: string;
+    _id: import("convex/values").GenericId<"users">;
+    _creationTime: number;
+    email?: string | undefined;
+    clerkUserId?: string | undefined;
+    statusNote?: string | undefined;
+    statusChangedBy?: import("convex/values").GenericId<"admins"> | undefined;
+    statusChangedAt?: number | undefined;
+    lastLoginAt?: number | undefined;
+    preferredBranchId?: import("convex/values").GenericId<"branches"> | undefined;
+    phoneNumber: string;
+    name: string;
+    isRegistered: boolean;
+    isVerified: boolean;
+    status: "active" | "blocked" | "suspended" | "restricted";
+    createdAt: number;
+    isDeleted: boolean;
+}>>;
 //# sourceMappingURL=customers.d.ts.map

package/convex/lib/auth.d.ts

@@ -14,12 +14,16 @@ export declare function getCurrentCustomer(ctx: QueryCtx | MutationCtx): Promise
     _creationTime: number;
     email?: string | undefined;
     clerkUserId?: string | undefined;
+    statusNote?: string | undefined;
+    statusChangedBy?: import("convex/values").GenericId<"admins"> | undefined;
+    statusChangedAt?: number | undefined;
     lastLoginAt?: number | undefined;
     preferredBranchId?: import("convex/values").GenericId<"branches"> | undefined;
     phoneNumber: string;
     name: string;
     isRegistered: boolean;
     isVerified: boolean;
+    status: "active" | "blocked" | "suspended" | "restricted";
     createdAt: number;
     isDeleted: boolean;
 }>;

package/convex/loyalty.d.ts

@@ -31,9 +31,9 @@ export declare const getTransactions: import("convex/server").RegisteredQuery<"p
         createdBy?: import("convex/values").GenericId<"admins"> | undefined;
         orderId?: import("convex/values").GenericId<"orders"> | undefined;
         description?: string | undefined;
+        type: "earned" | "redeemed" | "expired" | "adjusted";
         createdAt: number;
         isDeleted: boolean;
-        type: "earned" | "redeemed" | "expired" | "adjusted";
         customerId: import("convex/values").GenericId<"users">;
         points: number;
         balanceAfter: number;

package/convex/orders.d.ts

@@ -17,6 +17,7 @@ export declare const getByOrderNumber: import("convex/server").RegisteredQuery<"
     itemCount?: number | undefined;
     estimatedLoads?: number | undefined;
     whitesSeparate?: boolean | undefined;
+    bagCardNumber?: string | undefined;
     notes?: string | undefined;
     deliveryAddress?: string | undefined;
     deliveryPhoneNumber?: string | undefined;
@@ -25,6 +26,7 @@ export declare const getByOrderNumber: import("convex/server").RegisteredQuery<"
     paymentMethod?: "mobile_money" | "card" | "cash" | undefined;
     paymentId?: import("convex/values").GenericId<"payments"> | undefined;
     fulfilledBy?: import("convex/values").GenericId<"attendants"> | undefined;
+    status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
     createdAt: number;
     isDeleted: boolean;
     branchId: import("convex/values").GenericId<"branches">;
@@ -38,7 +40,6 @@ export declare const getByOrderNumber: import("convex/server").RegisteredQuery<"
     basePrice: number;
     totalPrice: number;
     finalPrice: number;
-    status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
     paymentStatus: "pending" | "paid" | "failed" | "refunded";
     updatedAt: number;
     statusHistory: {
@@ -63,6 +64,7 @@ export declare const getByCustomer: import("convex/server").RegisteredQuery<"pub
     itemCount?: number | undefined;
     estimatedLoads?: number | undefined;
     whitesSeparate?: boolean | undefined;
+    bagCardNumber?: string | undefined;
     notes?: string | undefined;
     deliveryAddress?: string | undefined;
     deliveryPhoneNumber?: string | undefined;
@@ -71,6 +73,7 @@ export declare const getByCustomer: import("convex/server").RegisteredQuery<"pub
     paymentMethod?: "mobile_money" | "card" | "cash" | undefined;
     paymentId?: import("convex/values").GenericId<"payments"> | undefined;
     fulfilledBy?: import("convex/values").GenericId<"attendants"> | undefined;
+    status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
     createdAt: number;
     isDeleted: boolean;
     branchId: import("convex/values").GenericId<"branches">;
@@ -84,7 +87,6 @@ export declare const getByCustomer: import("convex/server").RegisteredQuery<"pub
     basePrice: number;
     totalPrice: number;
     finalPrice: number;
-    status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
     paymentStatus: "pending" | "paid" | "failed" | "refunded";
     updatedAt: number;
     statusHistory: {
@@ -110,6 +112,7 @@ export declare const getByBranch: import("convex/server").RegisteredQuery<"publi
     itemCount?: number | undefined;
     estimatedLoads?: number | undefined;
     whitesSeparate?: boolean | undefined;
+    bagCardNumber?: string | undefined;
     notes?: string | undefined;
     deliveryAddress?: string | undefined;
     deliveryPhoneNumber?: string | undefined;
@@ -118,6 +121,7 @@ export declare const getByBranch: import("convex/server").RegisteredQuery<"publi
     paymentMethod?: "mobile_money" | "card" | "cash" | undefined;
     paymentId?: import("convex/values").GenericId<"payments"> | undefined;
     fulfilledBy?: import("convex/values").GenericId<"attendants"> | undefined;
+    status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
     createdAt: number;
     isDeleted: boolean;
     branchId: import("convex/values").GenericId<"branches">;
@@ -131,7 +135,6 @@ export declare const getByBranch: import("convex/server").RegisteredQuery<"publi
     basePrice: number;
     totalPrice: number;
     finalPrice: number;
-    status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
     paymentStatus: "pending" | "paid" | "failed" | "refunded";
     updatedAt: number;
     statusHistory: {
@@ -155,6 +158,7 @@ export declare const getPending: import("convex/server").RegisteredQuery<"public
     itemCount?: number | undefined;
     estimatedLoads?: number | undefined;
     whitesSeparate?: boolean | undefined;
+    bagCardNumber?: string | undefined;
     notes?: string | undefined;
     deliveryAddress?: string | undefined;
     deliveryPhoneNumber?: string | undefined;
@@ -163,6 +167,7 @@ export declare const getPending: import("convex/server").RegisteredQuery<"public
     paymentMethod?: "mobile_money" | "card" | "cash" | undefined;
     paymentId?: import("convex/values").GenericId<"payments"> | undefined;
     fulfilledBy?: import("convex/values").GenericId<"attendants"> | undefined;
+    status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
     createdAt: number;
     isDeleted: boolean;
     branchId: import("convex/values").GenericId<"branches">;
@@ -176,7 +181,6 @@ export declare const getPending: import("convex/server").RegisteredQuery<"public
     basePrice: number;
     totalPrice: number;
     finalPrice: number;
-    status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
     paymentStatus: "pending" | "paid" | "failed" | "refunded";
     updatedAt: number;
     statusHistory: {
@@ -190,6 +194,7 @@ export declare const getPending: import("convex/server").RegisteredQuery<"public
  * Create walk-in order (attendant creates at POS)
  */
 export declare const createWalkIn: import("convex/server").RegisteredMutation<"public", {
+    bagCardNumber?: string | undefined;
     notes?: string | undefined;
     deliveryAddress?: string | undefined;
     branchId: import("convex/values").GenericId<"branches">;
@@ -207,6 +212,7 @@ export declare const createWalkIn: import("convex/server").RegisteredMutation<"p
 export declare const createOnline: import("convex/server").RegisteredMutation<"public", {
     estimatedLoads?: number | undefined;
     whitesSeparate?: boolean | undefined;
+    bagCardNumber?: string | undefined;
     notes?: string | undefined;
     deliveryAddress?: string | undefined;
     deliveryPhoneNumber?: string | undefined;
@@ -228,6 +234,7 @@ export declare const createOnline: import("convex/server").RegisteredMutation<"p
  * Update order weight (when customer drops off online order)
  */
 export declare const updateWeight: import("convex/server").RegisteredMutation<"public", {
+    bagCardNumber?: string | undefined;
     actualWeight: number;
     itemCount: number;
     orderId: import("convex/values").GenericId<"orders">;
@@ -247,4 +254,73 @@ export declare const cancel: import("convex/server").RegisteredMutation<"public"
     reason?: string | undefined;
     orderId: import("convex/values").GenericId<"orders">;
 }, Promise<import("convex/values").GenericId<"orders">>>;
+/**
+ * Get order statistics summary
+ */
+export declare const getStats: import("convex/server").RegisteredQuery<"public", {
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+    startDate?: number | undefined;
+    endDate?: number | undefined;
+}, Promise<{
+    total: number;
+    byStatus: Record<string, number>;
+    byType: Record<string, number>;
+    byServiceType: Record<string, number>;
+    totalRevenue: number;
+    averageOrderValue: number;
+    totalWeight: number;
+    averageWeight: number;
+}>>;
+/**
+ * Get orders by date range with detailed filtering
+ */
+export declare const getByDateRange: import("convex/server").RegisteredQuery<"public", {
+    status?: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled" | undefined;
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+    orderType?: "walk_in" | "online" | undefined;
+    serviceType?: "wash_only" | "wash_and_dry" | "dry_only" | undefined;
+    limit?: number | undefined;
+    startDate: number;
+    endDate: number;
+}, Promise<{
+    _id: import("convex/values").GenericId<"orders">;
+    _creationTime: number;
+    createdBy?: import("convex/values").GenericId<"attendants"> | undefined;
+    estimatedWeight?: number | undefined;
+    actualWeight?: number | undefined;
+    itemCount?: number | undefined;
+    estimatedLoads?: number | undefined;
+    whitesSeparate?: boolean | undefined;
+    bagCardNumber?: string | undefined;
+    notes?: string | undefined;
+    deliveryAddress?: string | undefined;
+    deliveryPhoneNumber?: string | undefined;
+    deliveryHall?: string | undefined;
+    deliveryRoom?: string | undefined;
+    paymentMethod?: "mobile_money" | "card" | "cash" | undefined;
+    paymentId?: import("convex/values").GenericId<"payments"> | undefined;
+    fulfilledBy?: import("convex/values").GenericId<"attendants"> | undefined;
+    status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
+    createdAt: number;
+    isDeleted: boolean;
+    branchId: import("convex/values").GenericId<"branches">;
+    deliveryFee: number;
+    customerId: import("convex/values").GenericId<"users">;
+    customerPhoneNumber: string;
+    orderNumber: string;
+    orderType: "walk_in" | "online";
+    serviceType: "wash_only" | "wash_and_dry" | "dry_only";
+    isDelivery: boolean;
+    basePrice: number;
+    totalPrice: number;
+    finalPrice: number;
+    paymentStatus: "pending" | "paid" | "failed" | "refunded";
+    updatedAt: number;
+    statusHistory: {
+        notes?: string | undefined;
+        status: string;
+        changedAt: number;
+        changedBy: import("convex/values").GenericId<"attendants">;
+    }[];
+}[]>>;
 //# sourceMappingURL=orders.d.ts.map

package/convex/payments.d.ts

@@ -15,10 +15,10 @@ export declare const getByOrder: import("convex/server").RegisteredQuery<"public
     gatewayResponse?: string | undefined;
     completedAt?: number | undefined;
     processedBy?: import("convex/values").GenericId<"attendants"> | undefined;
+    status: "pending" | "completed" | "failed" | "refunded" | "processing";
     createdAt: number;
     isDeleted: boolean;
     customerId: import("convex/values").GenericId<"users">;
-    status: "pending" | "completed" | "failed" | "refunded" | "processing";
     paymentMethod: "mobile_money" | "card" | "cash";
     orderId: import("convex/values").GenericId<"orders">;
     amount: number;
@@ -36,10 +36,10 @@ export declare const getByCustomer: import("convex/server").RegisteredQuery<"pub
     gatewayResponse?: string | undefined;
     completedAt?: number | undefined;
     processedBy?: import("convex/values").GenericId<"attendants"> | undefined;
+    status: "pending" | "completed" | "failed" | "refunded" | "processing";
     createdAt: number;
     isDeleted: boolean;
     customerId: import("convex/values").GenericId<"users">;
-    status: "pending" | "completed" | "failed" | "refunded" | "processing";
     paymentMethod: "mobile_money" | "card" | "cash";
     orderId: import("convex/values").GenericId<"orders">;
     amount: number;
@@ -86,4 +86,49 @@ export declare const refund: import("convex/server").RegisteredMutation<"public"
     reason?: string | undefined;
     paymentId: import("convex/values").GenericId<"payments">;
 }, Promise<import("convex/values").GenericId<"payments">>>;
+/**
+ * Get transaction history - Paginated
+ * Supports usePaginatedQuery for infinite scroll
+ */
+export declare const getTransactionHistory: import("convex/server").RegisteredQuery<"public", {
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+    paymentMethod?: "mobile_money" | "card" | "cash" | undefined;
+    cursor?: string | undefined;
+    numItems?: number | undefined;
+    startDate?: number | undefined;
+    endDate?: number | undefined;
+}, Promise<{
+    page: {
+        _id: import("convex/values").GenericId<"payments">;
+        _creationTime: number;
+        gatewayTransactionId?: string | undefined;
+        gatewayResponse?: string | undefined;
+        completedAt?: number | undefined;
+        processedBy?: import("convex/values").GenericId<"attendants"> | undefined;
+        status: "pending" | "completed" | "failed" | "refunded" | "processing";
+        createdAt: number;
+        isDeleted: boolean;
+        customerId: import("convex/values").GenericId<"users">;
+        paymentMethod: "mobile_money" | "card" | "cash";
+        orderId: import("convex/values").GenericId<"orders">;
+        amount: number;
+        currency: string;
+    }[];
+    isDone: boolean;
+    continueCursor: string;
+}>>;
+/**
+ * Get transaction summary statistics
+ */
+export declare const getTransactionSummary: import("convex/server").RegisteredQuery<"public", {
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+    startDate?: number | undefined;
+    endDate?: number | undefined;
+}, Promise<{
+    totalTransactions: number;
+    totalAmount: number;
+    averageTransaction: number;
+    byMethod: Record<string, number>;
+    byStatus: Record<string, number>;
+}>>;
 //# sourceMappingURL=payments.d.ts.map

package/convex/resources.d.ts

@@ -85,4 +85,35 @@ export declare const logUsage: import("convex/server").RegisteredMutation<"publi
     detergentUnits: number;
     tokensUsed: number;
 }, Promise<Id<"resourceUsageLogs">>>;
+/**
+ * Get resource usage summary for date range
+ */
+export declare const getUsageSummary: import("convex/server").RegisteredQuery<"public", {
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+}, Promise<{
+    totals: {
+        detergentUnits: number;
+        tokensUsed: number;
+        waterCycles: number;
+    };
+    averagePerDay: {
+        detergentUnits: number;
+        tokensUsed: number;
+        waterCycles: number;
+    };
+    usageByDay: Record<string, {
+        detergentUnits: number;
+        tokensUsed: number;
+        waterCycles: number;
+        logCount: number;
+    }>;
+    totalLogs: number;
+    uniqueDays: number;
+    dateRange: {
+        start: string | undefined;
+        end: string | undefined;
+    };
+}>>;
 //# sourceMappingURL=resources.d.ts.map

package/convex/schema.d.ts

@@ -8,12 +8,16 @@ declare const _default: import("convex/server").SchemaDefinition<{
     users: import("convex/server").TableDefinition<import("convex/values").VObject<{
         email?: string | undefined;
         clerkUserId?: string | undefined;
+        statusNote?: string | undefined;
+        statusChangedBy?: import("convex/values").GenericId<"admins"> | undefined;
+        statusChangedAt?: number | undefined;
         lastLoginAt?: number | undefined;
         preferredBranchId?: import("convex/values").GenericId<"branches"> | undefined;
         phoneNumber: string;
         name: string;
         isRegistered: boolean;
         isVerified: boolean;
+        status: "active" | "blocked" | "suspended" | "restricted";
         createdAt: number;
         isDeleted: boolean;
     }, {
@@ -23,14 +27,19 @@ declare const _default: import("convex/server").SchemaDefinition<{
         clerkUserId: import("convex/values").VString<string | undefined, "optional">;
         isRegistered: import("convex/values").VBoolean<boolean, "required">;
         isVerified: import("convex/values").VBoolean<boolean, "required">;
+        status: import("convex/values").VUnion<"active" | "blocked" | "suspended" | "restricted", [import("convex/values").VLiteral<"active", "required">, import("convex/values").VLiteral<"blocked", "required">, import("convex/values").VLiteral<"suspended", "required">, import("convex/values").VLiteral<"restricted", "required">], "required", never>;
+        statusNote: import("convex/values").VString<string | undefined, "optional">;
+        statusChangedBy: import("convex/values").VId<import("convex/values").GenericId<"admins"> | undefined, "optional">;
+        statusChangedAt: import("convex/values").VFloat64<number | undefined, "optional">;
         createdAt: import("convex/values").VFloat64<number, "required">;
         lastLoginAt: import("convex/values").VFloat64<number | undefined, "optional">;
         preferredBranchId: import("convex/values").VId<import("convex/values").GenericId<"branches"> | undefined, "optional">;
         isDeleted: import("convex/values").VBoolean<boolean, "required">;
-    }, "required", "phoneNumber" | "email" | "name" | "clerkUserId" | "isRegistered" | "isVerified" | "createdAt" | "lastLoginAt" | "preferredBranchId" | "isDeleted">, {
+    }, "required", "phoneNumber" | "email" | "name" | "clerkUserId" | "isRegistered" | "isVerified" | "status" | "statusNote" | "statusChangedBy" | "statusChangedAt" | "createdAt" | "lastLoginAt" | "preferredBranchId" | "isDeleted">, {
         by_phone: ["phoneNumber", "_creationTime"];
         by_email: ["email", "_creationTime"];
         by_clerk_user: ["clerkUserId", "_creationTime"];
+        by_status: ["status", "_creationTime"];
     }, {}, {}>;
     attendants: import("convex/server").TableDefinition<import("convex/values").VObject<{
         lastLoginAt?: number | undefined;
@@ -87,6 +96,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         createdAt: number;
         isDeleted: boolean;
         isActive: boolean;
+        code: string;
         address: string;
         city: string;
         country: string;
@@ -95,6 +105,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         createdBy: import("convex/values").GenericId<"admins">;
     }, {
         name: import("convex/values").VString<string, "required">;
+        code: import("convex/values").VString<string, "required">;
         address: import("convex/values").VString<string, "required">;
         city: import("convex/values").VString<string, "required">;
         country: import("convex/values").VString<string, "required">;
@@ -106,9 +117,10 @@ declare const _default: import("convex/server").SchemaDefinition<{
         createdAt: import("convex/values").VFloat64<number, "required">;
         createdBy: import("convex/values").VId<import("convex/values").GenericId<"admins">, "required">;
         isDeleted: import("convex/values").VBoolean<boolean, "required">;
-    }, "required", "phoneNumber" | "email" | "name" | "createdAt" | "isDeleted" | "isActive" | "address" | "city" | "country" | "pricingPerKg" | "deliveryFee" | "createdBy">, {
+    }, "required", "phoneNumber" | "email" | "name" | "createdAt" | "isDeleted" | "isActive" | "code" | "address" | "city" | "country" | "pricingPerKg" | "deliveryFee" | "createdBy">, {
         by_city: ["city", "_creationTime"];
         by_active: ["isActive", "_creationTime"];
+        by_code: ["code", "_creationTime"];
     }, {}, {}>;
     orders: import("convex/server").TableDefinition<import("convex/values").VObject<{
         createdBy?: import("convex/values").GenericId<"attendants"> | undefined;
@@ -117,6 +129,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         itemCount?: number | undefined;
         estimatedLoads?: number | undefined;
         whitesSeparate?: boolean | undefined;
+        bagCardNumber?: string | undefined;
         notes?: string | undefined;
         deliveryAddress?: string | undefined;
         deliveryPhoneNumber?: string | undefined;
@@ -125,6 +138,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         paymentMethod?: "mobile_money" | "card" | "cash" | undefined;
         paymentId?: import("convex/values").GenericId<"payments"> | undefined;
         fulfilledBy?: import("convex/values").GenericId<"attendants"> | undefined;
+        status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
         createdAt: number;
         isDeleted: boolean;
         branchId: import("convex/values").GenericId<"branches">;
@@ -138,7 +152,6 @@ declare const _default: import("convex/server").SchemaDefinition<{
         basePrice: number;
         totalPrice: number;
         finalPrice: number;
-        status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
         paymentStatus: "pending" | "paid" | "failed" | "refunded";
         updatedAt: number;
         statusHistory: {
@@ -159,6 +172,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         itemCount: import("convex/values").VFloat64<number | undefined, "optional">;
         estimatedLoads: import("convex/values").VFloat64<number | undefined, "optional">;
         whitesSeparate: import("convex/values").VBoolean<boolean | undefined, "optional">;
+        bagCardNumber: import("convex/values").VString<string | undefined, "optional">;
         notes: import("convex/values").VString<string | undefined, "optional">;
         isDelivery: import("convex/values").VBoolean<boolean, "required">;
         deliveryAddress: import("convex/values").VString<string | undefined, "optional">;
@@ -192,9 +206,9 @@ declare const _default: import("convex/server").SchemaDefinition<{
             changedAt: import("convex/values").VFloat64<number, "required">;
             changedBy: import("convex/values").VId<import("convex/values").GenericId<"attendants">, "required">;
             notes: import("convex/values").VString<string | undefined, "optional">;
-        }, "required", "notes" | "status" | "changedAt" | "changedBy">, "required">;
+        }, "required", "status" | "notes" | "changedAt" | "changedBy">, "required">;
         isDeleted: import("convex/values").VBoolean<boolean, "required">;
-    }, "required", "createdAt" | "isDeleted" | "branchId" | "deliveryFee" | "createdBy" | "customerId" | "customerPhoneNumber" | "orderNumber" | "orderType" | "serviceType" | "estimatedWeight" | "actualWeight" | "itemCount" | "estimatedLoads" | "whitesSeparate" | "notes" | "isDelivery" | "deliveryAddress" | "deliveryPhoneNumber" | "deliveryHall" | "deliveryRoom" | "basePrice" | "totalPrice" | "finalPrice" | "status" | "paymentStatus" | "paymentMethod" | "paymentId" | "updatedAt" | "fulfilledBy" | "statusHistory">, {
+    }, "required", "status" | "createdAt" | "isDeleted" | "branchId" | "deliveryFee" | "createdBy" | "customerId" | "customerPhoneNumber" | "orderNumber" | "orderType" | "serviceType" | "estimatedWeight" | "actualWeight" | "itemCount" | "estimatedLoads" | "whitesSeparate" | "bagCardNumber" | "notes" | "isDelivery" | "deliveryAddress" | "deliveryPhoneNumber" | "deliveryHall" | "deliveryRoom" | "basePrice" | "totalPrice" | "finalPrice" | "paymentStatus" | "paymentMethod" | "paymentId" | "updatedAt" | "fulfilledBy" | "statusHistory">, {
         by_customer: ["customerId", "_creationTime"];
         by_branch: ["branchId", "_creationTime"];
         by_status: ["status", "_creationTime"];
@@ -208,10 +222,10 @@ declare const _default: import("convex/server").SchemaDefinition<{
         gatewayResponse?: string | undefined;
         completedAt?: number | undefined;
         processedBy?: import("convex/values").GenericId<"attendants"> | undefined;
+        status: "pending" | "completed" | "failed" | "refunded" | "processing";
         createdAt: number;
         isDeleted: boolean;
         customerId: import("convex/values").GenericId<"users">;
-        status: "pending" | "completed" | "failed" | "refunded" | "processing";
         paymentMethod: "mobile_money" | "card" | "cash";
         orderId: import("convex/values").GenericId<"orders">;
         amount: number;
@@ -229,7 +243,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         completedAt: import("convex/values").VFloat64<number | undefined, "optional">;
         processedBy: import("convex/values").VId<import("convex/values").GenericId<"attendants"> | undefined, "optional">;
         isDeleted: import("convex/values").VBoolean<boolean, "required">;
-    }, "required", "createdAt" | "isDeleted" | "customerId" | "status" | "paymentMethod" | "orderId" | "amount" | "currency" | "gatewayTransactionId" | "gatewayResponse" | "completedAt" | "processedBy">, {
+    }, "required", "status" | "createdAt" | "isDeleted" | "customerId" | "paymentMethod" | "orderId" | "amount" | "currency" | "gatewayTransactionId" | "gatewayResponse" | "completedAt" | "processedBy">, {
         by_order: ["orderId", "_creationTime"];
         by_customer: ["customerId", "_creationTime"];
         by_status: ["status", "_creationTime"];
@@ -258,9 +272,9 @@ declare const _default: import("convex/server").SchemaDefinition<{
         createdBy?: import("convex/values").GenericId<"admins"> | undefined;
         orderId?: import("convex/values").GenericId<"orders"> | undefined;
         description?: string | undefined;
+        type: "earned" | "redeemed" | "expired" | "adjusted";
         createdAt: number;
         isDeleted: boolean;
-        type: "earned" | "redeemed" | "expired" | "adjusted";
         customerId: import("convex/values").GenericId<"users">;
         points: number;
         balanceAfter: number;
@@ -274,7 +288,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         createdAt: import("convex/values").VFloat64<number, "required">;
         createdBy: import("convex/values").VId<import("convex/values").GenericId<"admins"> | undefined, "optional">;
         isDeleted: import("convex/values").VBoolean<boolean, "required">;
-    }, "required", "createdAt" | "isDeleted" | "type" | "createdBy" | "customerId" | "orderId" | "points" | "balanceAfter" | "description">, {
+    }, "required", "type" | "createdAt" | "isDeleted" | "createdBy" | "customerId" | "orderId" | "points" | "balanceAfter" | "description">, {
         by_customer: ["customerId", "_creationTime"];
         by_order: ["orderId", "_creationTime"];
         by_created: ["createdAt", "_creationTime"];
@@ -364,6 +378,73 @@ declare const _default: import("convex/server").SchemaDefinition<{
         by_timestamp: ["timestamp", "_creationTime"];
         by_branch: ["branchId", "_creationTime"];
     }, {}, {}>;
+    vouchers: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        name?: string | undefined;
+        description?: string | undefined;
+        maxUsesPerCustomer?: number | undefined;
+        validFrom?: number | undefined;
+        validUntil?: number | undefined;
+        minOrderValue?: number | undefined;
+        applicableBranches?: import("convex/values").GenericId<"branches">[] | undefined;
+        applicableServiceTypes?: ("wash_only" | "wash_and_dry" | "dry_only")[] | undefined;
+        createdAt: number;
+        isDeleted: boolean;
+        isActive: boolean;
+        code: string;
+        createdBy: import("convex/values").GenericId<"admins">;
+        discountType: "percentage" | "fixed" | "free_wash";
+        discountValue: number;
+        usageLimit: number;
+        usedCount: number;
+    }, {
+        code: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VString<string | undefined, "optional">;
+        discountType: import("convex/values").VUnion<"percentage" | "fixed" | "free_wash", [import("convex/values").VLiteral<"percentage", "required">, import("convex/values").VLiteral<"fixed", "required">, import("convex/values").VLiteral<"free_wash", "required">], "required", never>;
+        discountValue: import("convex/values").VFloat64<number, "required">;
+        usageLimit: import("convex/values").VFloat64<number, "required">;
+        usedCount: import("convex/values").VFloat64<number, "required">;
+        maxUsesPerCustomer: import("convex/values").VFloat64<number | undefined, "optional">;
+        isActive: import("convex/values").VBoolean<boolean, "required">;
+        validFrom: import("convex/values").VFloat64<number | undefined, "optional">;
+        validUntil: import("convex/values").VFloat64<number | undefined, "optional">;
+        minOrderValue: import("convex/values").VFloat64<number | undefined, "optional">;
+        applicableBranches: import("convex/values").VArray<import("convex/values").GenericId<"branches">[] | undefined, import("convex/values").VId<import("convex/values").GenericId<"branches">, "required">, "optional">;
+        applicableServiceTypes: import("convex/values").VArray<("wash_only" | "wash_and_dry" | "dry_only")[] | undefined, import("convex/values").VUnion<"wash_only" | "wash_and_dry" | "dry_only", [import("convex/values").VLiteral<"wash_only", "required">, import("convex/values").VLiteral<"wash_and_dry", "required">, import("convex/values").VLiteral<"dry_only", "required">], "required", never>, "optional">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+        createdBy: import("convex/values").VId<import("convex/values").GenericId<"admins">, "required">;
+        description: import("convex/values").VString<string | undefined, "optional">;
+        isDeleted: import("convex/values").VBoolean<boolean, "required">;
+    }, "required", "name" | "createdAt" | "isDeleted" | "isActive" | "code" | "createdBy" | "description" | "discountType" | "discountValue" | "usageLimit" | "usedCount" | "maxUsesPerCustomer" | "validFrom" | "validUntil" | "minOrderValue" | "applicableBranches" | "applicableServiceTypes">, {
+        by_code: ["code", "_creationTime"];
+        by_active: ["isActive", "_creationTime"];
+        by_created: ["createdAt", "_creationTime"];
+    }, {}, {}>;
+    voucherUsages: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        usedBy?: import("convex/values").GenericId<"attendants"> | undefined;
+        isDeleted: boolean;
+        customerId: import("convex/values").GenericId<"users">;
+        orderId: import("convex/values").GenericId<"orders">;
+        voucherId: import("convex/values").GenericId<"vouchers">;
+        discountAmount: number;
+        orderTotalBefore: number;
+        orderTotalAfter: number;
+        usedAt: number;
+    }, {
+        voucherId: import("convex/values").VId<import("convex/values").GenericId<"vouchers">, "required">;
+        orderId: import("convex/values").VId<import("convex/values").GenericId<"orders">, "required">;
+        customerId: import("convex/values").VId<import("convex/values").GenericId<"users">, "required">;
+        discountAmount: import("convex/values").VFloat64<number, "required">;
+        orderTotalBefore: import("convex/values").VFloat64<number, "required">;
+        orderTotalAfter: import("convex/values").VFloat64<number, "required">;
+        usedAt: import("convex/values").VFloat64<number, "required">;
+        usedBy: import("convex/values").VId<import("convex/values").GenericId<"attendants"> | undefined, "optional">;
+        isDeleted: import("convex/values").VBoolean<boolean, "required">;
+    }, "required", "isDeleted" | "customerId" | "orderId" | "voucherId" | "discountAmount" | "orderTotalBefore" | "orderTotalAfter" | "usedAt" | "usedBy">, {
+        by_voucher: ["voucherId", "_creationTime"];
+        by_order: ["orderId", "_creationTime"];
+        by_customer: ["customerId", "_creationTime"];
+        by_used_at: ["usedAt", "_creationTime"];
+    }, {}, {}>;
 }, true>;
 export default _default;
 //# sourceMappingURL=schema.d.ts.map

package/convex/vouchers.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Voucher Functions
+ *
+ * Handles discount vouchers and promo codes creation, validation, and application.
+ */
+/**
+ * Get all vouchers (admin only)
+ */
+export declare const getAll: import("convex/server").RegisteredQuery<"public", {
+    includeInactive?: boolean | undefined;
+    cursor?: string | undefined;
+    numItems?: number | undefined;
+}, Promise<{
+    page: {
+        _id: import("convex/values").GenericId<"vouchers">;
+        _creationTime: number;
+        name?: string | undefined;
+        description?: string | undefined;
+        maxUsesPerCustomer?: number | undefined;
+        validFrom?: number | undefined;
+        validUntil?: number | undefined;
+        minOrderValue?: number | undefined;
+        applicableBranches?: import("convex/values").GenericId<"branches">[] | undefined;
+        applicableServiceTypes?: ("wash_only" | "wash_and_dry" | "dry_only")[] | undefined;
+        createdAt: number;
+        isDeleted: boolean;
+        isActive: boolean;
+        code: string;
+        createdBy: import("convex/values").GenericId<"admins">;
+        discountType: "percentage" | "fixed" | "free_wash";
+        discountValue: number;
+        usageLimit: number;
+        usedCount: number;
+    }[];
+    isDone: boolean;
+    continueCursor: string;
+}>>;
+/**
+ * Get active vouchers (public - for customers/attendants)
+ */
+export declare const getActive: import("convex/server").RegisteredQuery<"public", {
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+}, Promise<{
+    _id: import("convex/values").GenericId<"vouchers">;
+    _creationTime: number;
+    name?: string | undefined;
+    description?: string | undefined;
+    maxUsesPerCustomer?: number | undefined;
+    validFrom?: number | undefined;
+    validUntil?: number | undefined;
+    minOrderValue?: number | undefined;
+    applicableBranches?: import("convex/values").GenericId<"branches">[] | undefined;
+    applicableServiceTypes?: ("wash_only" | "wash_and_dry" | "dry_only")[] | undefined;
+    createdAt: number;
+    isDeleted: boolean;
+    isActive: boolean;
+    code: string;
+    createdBy: import("convex/values").GenericId<"admins">;
+    discountType: "percentage" | "fixed" | "free_wash";
+    discountValue: number;
+    usageLimit: number;
+    usedCount: number;
+}[]>>;
+/**
+ * Get voucher by code
+ */
+export declare const getByCode: import("convex/server").RegisteredQuery<"public", {
+    code: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"vouchers">;
+    _creationTime: number;
+    name?: string | undefined;
+    description?: string | undefined;
+    maxUsesPerCustomer?: number | undefined;
+    validFrom?: number | undefined;
+    validUntil?: number | undefined;
+    minOrderValue?: number | undefined;
+    applicableBranches?: import("convex/values").GenericId<"branches">[] | undefined;
+    applicableServiceTypes?: ("wash_only" | "wash_and_dry" | "dry_only")[] | undefined;
+    createdAt: number;
+    isDeleted: boolean;
+    isActive: boolean;
+    code: string;
+    createdBy: import("convex/values").GenericId<"admins">;
+    discountType: "percentage" | "fixed" | "free_wash";
+    discountValue: number;
+    usageLimit: number;
+    usedCount: number;
+} | null>>;
+/**
+ * Validate voucher for order
+ */
+export declare const validate: import("convex/server").RegisteredQuery<"public", {
+    serviceType?: "wash_only" | "wash_and_dry" | "dry_only" | undefined;
+    branchId: import("convex/values").GenericId<"branches">;
+    code: string;
+    orderTotal: number;
+}, Promise<{
+    valid: boolean;
+    error: string;
+    voucher?: undefined;
+    discountAmount?: undefined;
+    finalPrice?: undefined;
+} | {
+    valid: boolean;
+    voucher: {
+        _id: import("convex/values").GenericId<"vouchers">;
+        code: string;
+        name: string | undefined;
+        discountType: "percentage" | "fixed" | "free_wash";
+        discountValue: number;
+    };
+    discountAmount: number;
+    finalPrice: number;
+    error?: undefined;
+}>>;
+/**
+ * Create voucher (admin only)
+ */
+export declare const create: import("convex/server").RegisteredMutation<"public", {
+    name?: string | undefined;
+    description?: string | undefined;
+    maxUsesPerCustomer?: number | undefined;
+    validFrom?: number | undefined;
+    validUntil?: number | undefined;
+    minOrderValue?: number | undefined;
+    applicableBranches?: import("convex/values").GenericId<"branches">[] | undefined;
+    applicableServiceTypes?: ("wash_only" | "wash_and_dry" | "dry_only")[] | undefined;
+    code: string;
+    discountType: "percentage" | "fixed" | "free_wash";
+    discountValue: number;
+    usageLimit: number;
+}, Promise<import("convex/values").GenericId<"vouchers">>>;
+/**
+ * Update voucher (admin only)
+ */
+export declare const update: import("convex/server").RegisteredMutation<"public", {
+    name?: string | undefined;
+    isActive?: boolean | undefined;
+    description?: string | undefined;
+    discountType?: "percentage" | "fixed" | "free_wash" | undefined;
+    discountValue?: number | undefined;
+    usageLimit?: number | undefined;
+    maxUsesPerCustomer?: number | undefined;
+    validFrom?: number | undefined;
+    validUntil?: number | undefined;
+    minOrderValue?: number | undefined;
+    applicableBranches?: import("convex/values").GenericId<"branches">[] | undefined;
+    applicableServiceTypes?: ("wash_only" | "wash_and_dry" | "dry_only")[] | undefined;
+    voucherId: import("convex/values").GenericId<"vouchers">;
+}, Promise<import("convex/values").GenericId<"vouchers">>>;
+/**
+ * Apply voucher to order
+ */
+export declare const applyToOrder: import("convex/server").RegisteredMutation<"public", {
+    orderId: import("convex/values").GenericId<"orders">;
+    voucherCode: string;
+}, Promise<{
+    voucherId: import("convex/values").GenericId<"vouchers">;
+    discountAmount: number;
+    finalPrice: number;
+}>>;
+/**
+ * Get voucher usage history (admin only)
+ */
+export declare const getUsageHistory: import("convex/server").RegisteredQuery<"public", {
+    voucherId?: import("convex/values").GenericId<"vouchers"> | undefined;
+    cursor?: string | undefined;
+    numItems?: number | undefined;
+}, Promise<{
+    page: {
+        _id: import("convex/values").GenericId<"voucherUsages">;
+        _creationTime: number;
+        usedBy?: import("convex/values").GenericId<"attendants"> | undefined;
+        isDeleted: boolean;
+        customerId: import("convex/values").GenericId<"users">;
+        orderId: import("convex/values").GenericId<"orders">;
+        voucherId: import("convex/values").GenericId<"vouchers">;
+        discountAmount: number;
+        orderTotalBefore: number;
+        orderTotalAfter: number;
+        usedAt: number;
+    }[];
+    isDone: boolean;
+    continueCursor: string;
+}>>;
+//# sourceMappingURL=vouchers.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devlider001/washlab-backend",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Washlab backend - Convex API package for Lider Technology Ltd",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -49,6 +49,7 @@
   "license": "ISC",
   "type": "module",
   "dependencies": {
+    "@clerk/clerk-sdk-node": "^4.13.23",
     "convex": "^1.31.2"
   },
   "devDependencies": {