@devlider001/washlab-backend 1.1.0 → 1.1.1

package/convex/admin.d.ts

@@ -7,6 +7,8 @@ import { Id } from "./_generated/dataModel";
  */
 /**
  * Get current admin profile (from authenticated Clerk session)
+ * Returns null if user is authenticated but not an admin (for redirect to unauthorized page)
+ * Returns null if user is not authenticated (frontend handles redirect to sign-in)
  */
 export declare const getCurrentUser: import("convex/server").RegisteredQuery<"public", {}, Promise<{
     _id: import("convex/values").GenericId<"admins">;
@@ -18,7 +20,7 @@ export declare const getCurrentUser: import("convex/server").RegisteredQuery<"pu
     createdAt: number;
     isDeleted: boolean;
     role: "super_admin" | "admin";
-}>>;
+} | null>>;
 /**
  * Get all branches - Paginated
  * Supports usePaginatedQuery for infinite scroll
@@ -38,6 +40,7 @@ export declare const getBranches: import("convex/server").RegisteredQuery<"publi
         _id: import("convex/values").GenericId<"branches">;
         _creationTime: number;
         email?: string | undefined;
+        terminalId?: string | undefined;
         stationPinHash?: string | undefined;
         requireStationLogin?: boolean | undefined;
         phoneNumber: string;
@@ -56,6 +59,14 @@ export declare const getBranches: import("convex/server").RegisteredQuery<"publi
     isDone: boolean;
     continueCursor: string;
 }>>;
+/**
+ * Get all active branches with codes (public - no auth required)
+ * Used for displaying available branch codes on login page
+ */
+export declare const getActiveBranchesList: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+    code: string;
+    name: string;
+}[]>>;
 /**
  * Get branch by code
  */
@@ -63,22 +74,15 @@ export declare const getBranchByCode: import("convex/server").RegisteredQuery<"p
     code: string;
 }, Promise<{
     _id: import("convex/values").GenericId<"branches">;
-    _creationTime: number;
-    email?: string | undefined;
-    stationPinHash?: string | undefined;
-    requireStationLogin?: boolean | undefined;
-    phoneNumber: string;
     name: string;
-    createdAt: number;
-    isDeleted: boolean;
-    isActive: boolean;
-    createdBy: import("convex/values").GenericId<"admins">;
     code: string;
     address: string;
     city: string;
     country: string;
-    pricingPerKg: number;
-    deliveryFee: number;
+    phoneNumber: string;
+    email: string | undefined;
+    requireStationLogin: boolean;
+    hasStationPin: boolean;
 } | null>>;
 /**
  * Get single branch by ID
@@ -89,6 +93,7 @@ export declare const getBranch: import("convex/server").RegisteredQuery<"public"
     _id: import("convex/values").GenericId<"branches">;
     _creationTime: number;
     email?: string | undefined;
+    terminalId?: string | undefined;
     stationPinHash?: string | undefined;
     requireStationLogin?: boolean | undefined;
     phoneNumber: string;
@@ -317,16 +322,16 @@ export declare const deleteCustomer: import("convex/server").RegisteredMutation<
  */
 export declare const createBranch: import("convex/server").RegisteredMutation<"public", {
     email?: string | undefined;
-    requireStationLogin?: boolean | undefined;
-    stationPin?: string | undefined;
     phoneNumber: string;
     name: string;
     code: string;
+    terminalId: string;
     address: string;
     city: string;
     country: string;
     pricingPerKg: number;
     deliveryFee: number;
+    stationPin: string;
 }, Promise<import("convex/values").GenericId<"branches">>>;
 /**
  * Update branch details
@@ -337,12 +342,12 @@ export declare const updateBranch: import("convex/server").RegisteredMutation<"p
     name?: string | undefined;
     isActive?: boolean | undefined;
     code?: string | undefined;
+    terminalId?: string | undefined;
     address?: string | undefined;
     city?: string | undefined;
     country?: string | undefined;
     pricingPerKg?: number | undefined;
     deliveryFee?: number | undefined;
-    requireStationLogin?: boolean | undefined;
     stationPin?: string | undefined;
     branchId: import("convex/values").GenericId<"branches">;
 }, Promise<import("convex/values").GenericId<"branches">>>;

package/convex/attendants.d.ts

@@ -307,6 +307,7 @@ export declare const findByEmail: import("convex/server").RegisteredQuery<"publi
     authenticationMethods: ("biometric_face" | "biometric_hand" | "pin" | "password")[];
     hasBiometric: boolean;
     hasPin: boolean;
+    hasPassword: boolean;
 } | null>>;
 /**
  * Start verification (for login or action)

package/convex/customers.d.ts

@@ -29,9 +29,15 @@ export declare const getByPhone: import("convex/server").RegisteredQuery<"public
     createdAt: number;
     isDeleted: boolean;
 } | null>>;
+/**
+ * Check if authenticated user is an admin or attendant
+ * Returns true if user is admin/attendant (should be blocked from customer app)
+ */
+export declare const checkIsAdminOrAttendant: import("convex/server").RegisteredQuery<"public", {}, Promise<boolean>>;
 /**
  * Get current customer profile (from authenticated Clerk session)
  * Returns null if customer hasn't completed registration yet
+ * Returns null if user is admin/attendant (will be handled by unauthorized page)
  */
 export declare const getProfile: import("convex/server").RegisteredQuery<"public", {}, Promise<{
     orderCount: number;

package/convex/orders.d.ts

@@ -38,6 +38,7 @@ export declare const getBranches: import("convex/server").RegisteredQuery<"publi
         _id: import("convex/values").GenericId<"branches">;
         _creationTime: number;
         email?: string | undefined;
+        terminalId?: string | undefined;
         stationPinHash?: string | undefined;
         requireStationLogin?: boolean | undefined;
         phoneNumber: string;
@@ -65,6 +66,7 @@ export declare const getBranchByCode: import("convex/server").RegisteredQuery<"p
     _id: import("convex/values").GenericId<"branches">;
     _creationTime: number;
     email?: string | undefined;
+    terminalId?: string | undefined;
     stationPinHash?: string | undefined;
     requireStationLogin?: boolean | undefined;
     phoneNumber: string;
@@ -89,6 +91,7 @@ export declare const getBranch: import("convex/server").RegisteredQuery<"public"
     _id: import("convex/values").GenericId<"branches">;
     _creationTime: number;
     email?: string | undefined;
+    terminalId?: string | undefined;
     stationPinHash?: string | undefined;
     requireStationLogin?: boolean | undefined;
     phoneNumber: string;
@@ -320,6 +323,7 @@ export declare const createBranch: import("convex/server").RegisteredMutation<"p
     phoneNumber: string;
     name: string;
     code: string;
+    terminalId: string;
     address: string;
     city: string;
     country: string;

package/convex/payments.d.ts

@@ -226,6 +226,7 @@ export declare const getTransactionHistory: import("convex/server").RegisteredQu
             _id: import("convex/values").GenericId<"branches">;
             _creationTime: number;
             email?: string | undefined;
+            terminalId?: string | undefined;
             stationPinHash?: string | undefined;
             requireStationLogin?: boolean | undefined;
             phoneNumber: string;

package/convex/schema.d.ts

@@ -142,6 +142,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
     }, {}, {}>;
     branches: import("convex/server").TableDefinition<import("convex/values").VObject<{
         email?: string | undefined;
+        terminalId?: string | undefined;
         stationPinHash?: string | undefined;
         requireStationLogin?: boolean | undefined;
         phoneNumber: string;
@@ -159,6 +160,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
     }, {
         name: import("convex/values").VString<string, "required">;
         code: import("convex/values").VString<string, "required">;
+        terminalId: import("convex/values").VString<string | undefined, "optional">;
         address: import("convex/values").VString<string, "required">;
         city: import("convex/values").VString<string, "required">;
         country: import("convex/values").VString<string, "required">;
@@ -172,10 +174,11 @@ 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" | "createdBy" | "code" | "address" | "city" | "country" | "pricingPerKg" | "deliveryFee" | "stationPinHash" | "requireStationLogin">, {
+    }, "required", "phoneNumber" | "email" | "name" | "createdAt" | "isDeleted" | "isActive" | "createdBy" | "code" | "terminalId" | "address" | "city" | "country" | "pricingPerKg" | "deliveryFee" | "stationPinHash" | "requireStationLogin">, {
         by_city: ["city", "_creationTime"];
         by_active: ["isActive", "_creationTime"];
         by_code: ["code", "_creationTime"];
+        by_terminal_id: ["terminalId", "_creationTime"];
     }, {}, {}>;
     orders: import("convex/server").TableDefinition<import("convex/values").VObject<{
         createdBy?: import("convex/values").GenericId<"attendants"> | undefined;

package/convex/stations.d.ts

@@ -4,6 +4,14 @@
  * Handles station (branch) login and session management.
  * Station login is separate from attendant authentication.
  */
+/**
+ * Get all active branches with codes (public - no auth required)
+ * Used for displaying available branch codes on login page
+ */
+export declare const getActiveBranches: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+    code: string;
+    name: string;
+}[]>>;
 /**
  * Verify branch code (public - no auth required)
  * Returns branch info without sensitive data
@@ -28,30 +36,52 @@ export declare const verifyBranchCode: import("convex/server").RegisteredQuery<"
  */
 export declare const loginStation: import("convex/server").RegisteredMutation<"public", {
     deviceInfo?: string | undefined;
-    stationPin?: string | undefined;
     branchId: import("convex/values").GenericId<"branches">;
     deviceId: string;
+    stationPin: string;
 }, Promise<{
-    success: boolean;
+    stationToken: string;
+    sessionId: import("convex/values").GenericId<"stationSessions">;
     branchId: import("convex/values").GenericId<"branches">;
     branchName: string;
-    stationToken: string;
     expiresAt: number;
-    sessionId: import("convex/values").GenericId<"stationSessions">;
 }>>;
 /**
- * Verify station session token
+ * Verify station session
  */
 export declare const verifyStationSession: import("convex/server").RegisteredQuery<"public", {
     stationToken: string;
 }, Promise<{
+    valid: boolean;
+    reason: string;
+    branchActive: boolean;
+    branchId?: undefined;
+    branchName?: undefined;
+    branchCode?: undefined;
+    terminalId?: undefined;
+    deviceId?: undefined;
+    sessionId?: undefined;
+} | {
     valid: boolean;
     branchId: import("convex/values").GenericId<"branches">;
-    branchName: string | undefined;
+    branchName: string;
+    branchCode: string;
+    branchActive: boolean;
+    reason: string;
+    terminalId: string | undefined;
     deviceId: string;
-    expiresAt: number;
-    loggedInAt: number;
-} | null>>;
+    sessionId: string;
+} | {
+    valid: boolean;
+    branchId: import("convex/values").GenericId<"branches">;
+    branchName: string;
+    branchCode: string;
+    branchActive: boolean;
+    terminalId: string | undefined;
+    deviceId: string;
+    sessionId: string;
+    reason?: undefined;
+}>>;
 /**
  * Logout from station
  */
@@ -61,17 +91,355 @@ export declare const logoutStation: import("convex/server").RegisteredMutation<"
     success: boolean;
 }>>;
 /**
- * Get active station session for device
+ * Get active station session info
  */
 export declare const getActiveStationSession: import("convex/server").RegisteredQuery<"public", {
-    branchId: import("convex/values").GenericId<"branches">;
-    deviceId: string;
+    stationToken: string;
 }, Promise<{
-    _id: import("convex/values").GenericId<"stationSessions">;
+    sessionId: import("convex/values").GenericId<"stationSessions">;
     branchId: import("convex/values").GenericId<"branches">;
-    branchName: string | undefined;
+    branchName: string;
     deviceId: string;
     loggedInAt: number;
     expiresAt: number;
 } | null>>;
+/**
+ * Get station orders with pagination and filtering
+ */
+export declare const getStationOrders: import("convex/server").RegisteredQuery<"public", {
+    status?: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled" | undefined;
+    paginationOpts: {
+        id?: number;
+        endCursor?: string | null;
+        maximumRowsRead?: number;
+        maximumBytesRead?: number;
+        numItems: number;
+        cursor: string | null;
+    };
+    stationToken: string;
+}, Promise<{
+    page: {
+        customer: {
+            _id: import("convex/values").GenericId<"users">;
+            name: string;
+            phoneNumber: string;
+            email: string | undefined;
+        } | null;
+        _id: import("convex/values").GenericId<"orders">;
+        _creationTime: number;
+        createdBy?: import("convex/values").GenericId<"attendants"> | undefined;
+        customerEmail?: string | 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;
+            changedBy?: import("convex/values").GenericId<"attendants"> | undefined;
+            changedByAdmin?: import("convex/values").GenericId<"admins"> | undefined;
+            status: string;
+            changedAt: number;
+        }[];
+    }[];
+    isDone: boolean;
+    continueCursor: string;
+}>>;
+/**
+ * Get order details for station
+ */
+export declare const getStationOrderDetails: import("convex/server").RegisteredQuery<"public", {
+    orderId: import("convex/values").GenericId<"orders">;
+    stationToken: string;
+}, Promise<{
+    customer: {
+        _id: import("convex/values").GenericId<"users">;
+        name: string;
+        phoneNumber: string;
+        email: string | undefined;
+    } | null;
+    branch: {
+        _id: import("convex/values").GenericId<"branches">;
+        name: string;
+        code: string;
+        address: string;
+    };
+    _id: import("convex/values").GenericId<"orders">;
+    _creationTime: number;
+    createdBy?: import("convex/values").GenericId<"attendants"> | undefined;
+    customerEmail?: string | 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;
+        changedBy?: import("convex/values").GenericId<"attendants"> | undefined;
+        changedByAdmin?: import("convex/values").GenericId<"admins"> | undefined;
+        status: string;
+        changedAt: number;
+    }[];
+} | null>>;
+/**
+ * Update order status (for station)
+ * Allows station to update order status
+ */
+export declare const updateStationOrderStatus: import("convex/server").RegisteredMutation<"public", {
+    notes?: string | undefined;
+    orderId: import("convex/values").GenericId<"orders">;
+    newStatus: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
+    stationToken: string;
+}, Promise<{
+    success: boolean;
+    orderId: import("convex/values").GenericId<"orders">;
+}>>;
+/**
+ * Get station analytics/dashboard stats
+ */
+export declare const getStationStats: import("convex/server").RegisteredQuery<"public", {
+    startDate?: number | undefined;
+    endDate?: number | undefined;
+    stationToken: string;
+}, Promise<{
+    totalOrders: number;
+    totalRevenue: number;
+    pendingOrders: number;
+    ordersByStatus: {
+        pending: number;
+        in_progress: number;
+        ready_for_pickup: number;
+        delivered: number;
+        completed: number;
+        cancelled: number;
+    };
+    averageOrderValue: number;
+}>>;
+/**
+ * Search customers for station
+ */
+export declare const searchStationCustomers: import("convex/server").RegisteredQuery<"public", {
+    limit?: number | undefined;
+    query: string;
+    stationToken: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"users">;
+    name: string;
+    phoneNumber: string;
+    email: string | undefined;
+    status: "active" | "blocked" | "suspended" | "restricted" | undefined;
+    orderCount: number;
+    completedOrderCount: number;
+    totalSpent: number;
+}[]>>;
+/**
+ * Get active attendance for station
+ * Returns active attendance logs for the station's branch
+ * Multiple attendants can be clocked in simultaneously
+ */
+export declare const getActiveStationAttendances: import("convex/server").RegisteredQuery<"public", {
+    stationToken: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"attendanceLogs">;
+    clockInAt: number;
+    deviceId: string | undefined;
+    attendant: {
+        _id: import("convex/values").GenericId<"attendants">;
+        name: string;
+        email: string;
+    } | null;
+}[]>>;
+/**
+ * Get attendants for branch (for clock-in selection)
+ * Returns list of attendants assigned to the branch
+ */
+export declare const getBranchAttendants: import("convex/server").RegisteredQuery<"public", {
+    stationToken: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"attendants">;
+    name: string;
+    email: string;
+    hasBiometric: boolean;
+    hasPin: boolean;
+    authenticationMethods: ("biometric_face" | "biometric_hand" | "pin" | "password")[];
+}[]>>;
+/**
+ * Start biometric verification for clock-in
+ * Creates a challenge for the attendant to verify their identity
+ */
+export declare const startClockInVerification: import("convex/server").RegisteredMutation<"public", {
+    attendantId: import("convex/values").GenericId<"attendants">;
+    stationToken: string;
+}, Promise<{
+    challenge: string;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    verificationType: "login";
+    requiresLiveness: boolean;
+}>>;
+/**
+ * Complete clock-in with biometric verification
+ * Verifies biometric and creates attendance record
+ */
+export declare const completeClockIn: import("convex/server").RegisteredMutation<"public", {
+    attendantId: import("convex/values").GenericId<"attendants">;
+    challenge: string;
+    biometricData: {
+        deviceInfo?: string | undefined;
+        captureType: "face" | "hand";
+        captureQuality: number;
+        angles: string[];
+        features: string;
+        measurements: string;
+        livenessData: string;
+    };
+    stationToken: string;
+}, Promise<{
+    attendanceId: import("convex/values").GenericId<"attendanceLogs">;
+    clockInAt: number;
+    attendant: {
+        _id: import("convex/values").GenericId<"attendants">;
+        name: string;
+        email: string;
+    };
+}>>;
+/**
+ * Start clock-out verification
+ */
+export declare const startClockOutVerification: import("convex/server").RegisteredMutation<"public", {
+    attendanceId: import("convex/values").GenericId<"attendanceLogs">;
+    stationToken: string;
+}, Promise<{
+    challenge: string;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    verificationType: "action";
+    requiresLiveness: boolean;
+}>>;
+/**
+ * Complete clock-out with biometric verification
+ */
+export declare const completeClockOut: import("convex/server").RegisteredMutation<"public", {
+    notes?: string | undefined;
+    attendanceId: import("convex/values").GenericId<"attendanceLogs">;
+    challenge: string;
+    biometricData: {
+        deviceInfo?: string | undefined;
+        captureType: "face" | "hand";
+        captureQuality: number;
+        angles: string[];
+        features: string;
+        measurements: string;
+        livenessData: string;
+    };
+    stationToken: string;
+}, Promise<{
+    attendanceId: import("convex/values").GenericId<"attendanceLogs">;
+    durationMinutes: number;
+    clockOutAt: number;
+    sessionsRevoked: number;
+}>>;
+/**
+ * Get attendance history for the station's branch
+ * Returns attendance logs with optional date filtering
+ */
+export declare const getStationAttendanceHistory: import("convex/server").RegisteredQuery<"public", {
+    startDate?: number | undefined;
+    endDate?: number | undefined;
+    limit?: number | undefined;
+    stationToken: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"attendanceLogs">;
+    clockInAt: number;
+    clockOutAt: number | undefined;
+    deviceId: string | undefined;
+    isActive: boolean;
+    durationMinutes: number | null;
+    attendant: {
+        _id: import("convex/values").GenericId<"attendants">;
+        name: string;
+        email: string;
+    } | null;
+}[]>>;
+/**
+ * Get activity logs (audit logs) for the station's branch
+ * Returns audit logs for actions taken at this station
+ */
+export declare const getStationActivityLogs: import("convex/server").RegisteredQuery<"public", {
+    limit?: number | undefined;
+    stationToken: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"auditLogs">;
+    action: string;
+    entityType: string;
+    entityId: string | undefined;
+    actor: {
+        type: "attendant";
+        name: string;
+        email: string;
+    } | {
+        type: "admin";
+        name: string;
+        email: string;
+    } | {
+        type: "customer";
+        name: string;
+        email: string | undefined;
+    } | null;
+    actorRole: string;
+    attendanceId: import("convex/values").GenericId<"attendanceLogs"> | undefined;
+    deviceId: string | undefined;
+    details: string | undefined;
+    oldValue: string | undefined;
+    newValue: string | undefined;
+    timestamp: number;
+}[]>>;
 //# sourceMappingURL=stations.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devlider001/washlab-backend",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Washlab backend - Convex API package for Lider Technology Ltd",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",