@devlider001/washlab-backend 1.0.3 → 1.0.5

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";
@@ -18,9 +19,11 @@ import type * as lib_audit from "../lib/audit.js";
 import type * as lib_auth from "../lib/auth.js";
 import type * as lib_utils from "../lib/utils.js";
 import type * as loyalty from "../loyalty.js";
+import type * as notifications from "../notifications.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 +33,7 @@ import type {
 
 declare const fullApi: ApiFromModules<{
   admin: typeof admin;
+  analytics: typeof analytics;
   attendants: typeof attendants;
   audit: typeof audit;
   clerk: typeof clerk;
@@ -39,9 +43,11 @@ declare const fullApi: ApiFromModules<{
   "lib/auth": typeof lib_auth;
   "lib/utils": typeof lib_utils;
   loyalty: typeof loyalty;
+  notifications: typeof notifications;
   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/audit.d.ts

@@ -122,4 +122,43 @@ export declare const getByTimeRange: import("convex/server").RegisteredQuery<"pu
     entityType: string;
     timestamp: number;
 }[]>>;
+/**
+ * Get all audit logs with filters - Paginated
+ * Supports usePaginatedQuery for infinite scroll
+ */
+export declare const getAll: import("convex/server").RegisteredQuery<"public", {
+    actorType?: "admin" | "customer" | "attendant" | undefined;
+    action?: string | undefined;
+    entityType?: string | undefined;
+    startTimestamp?: number | undefined;
+    endTimestamp?: number | undefined;
+    paginationOpts: {
+        id?: number;
+        endCursor?: string | null;
+        maximumRowsRead?: number;
+        maximumBytesRead?: number;
+        numItems: number;
+        cursor: string | null;
+    };
+}, Promise<{
+    page: {
+        _id: import("convex/values").GenericId<"auditLogs">;
+        _creationTime: number;
+        branchId?: import("convex/values").GenericId<"branches"> | undefined;
+        deviceId?: string | undefined;
+        entityId?: string | undefined;
+        ipAddress?: string | undefined;
+        details?: string | undefined;
+        oldValue?: string | undefined;
+        newValue?: string | undefined;
+        actorId: string;
+        actorType: "admin" | "customer" | "attendant";
+        actorRole: string;
+        action: string;
+        entityType: string;
+        timestamp: number;
+    }[];
+    isDone: boolean;
+    continueCursor: string;
+}>>;
 //# sourceMappingURL=audit.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;