@devlider001/washlab-backend 1.0.8 → 1.1.0

package/convex/attendants.d.ts

@@ -11,16 +11,37 @@ export declare const getByBranch: import("convex/server").RegisteredQuery<"publi
 }, Promise<{
     _id: import("convex/values").GenericId<"attendants">;
     _creationTime: number;
+    clerkUserId?: string | undefined;
     lastLoginAt?: number | undefined;
-    passcode?: string | undefined;
+    passcodeHash?: string | undefined;
+    authenticationMethods?: ("biometric_face" | "biometric_hand" | "pin" | "password")[] | undefined;
+    enrollmentTokenHash?: string | undefined;
+    enrollmentTokenExpiresAt?: number | undefined;
+    enrolledAt?: number | undefined;
+    enrolledBy?: import("convex/values").GenericId<"admins"> | undefined;
+    biometricTemplateHash?: string | undefined;
+    biometricDataEncrypted?: string | undefined;
+    biometricCaptureMetadata?: {
+        deviceInfo?: string | undefined;
+        captureType: "face" | "hand";
+        anglesCaptured: string[];
+        captureQuality: number;
+        livenessPassed: boolean;
+        captureTimestamp: number;
+    } | undefined;
+    lastVerificationAt?: number | undefined;
+    lastVerificationSuccess?: boolean | undefined;
+    verificationTimeoutAt?: number | undefined;
     phoneNumber: string;
     email: string;
     name: string;
-    clerkUserId: string;
     createdAt: number;
     isDeleted: boolean;
     branchId: import("convex/values").GenericId<"branches">;
     isActive: boolean;
+    enrollmentStatus: "active" | "suspended" | "invited" | "enrolling" | "locked";
+    consecutiveFailures: number;
+    createdBy: import("convex/values").GenericId<"admins">;
 }[]>>;
 /**
  * Get current attendant profile (from authenticated Clerk session)
@@ -33,32 +54,85 @@ export declare const getCurrentUser: import("convex/server").RegisteredQuery<"pu
     } | null;
     _id: import("convex/values").GenericId<"attendants">;
     _creationTime: number;
+    clerkUserId?: string | undefined;
     lastLoginAt?: number | undefined;
-    passcode?: string | undefined;
+    passcodeHash?: string | undefined;
+    authenticationMethods?: ("biometric_face" | "biometric_hand" | "pin" | "password")[] | undefined;
+    enrollmentTokenHash?: string | undefined;
+    enrollmentTokenExpiresAt?: number | undefined;
+    enrolledAt?: number | undefined;
+    enrolledBy?: import("convex/values").GenericId<"admins"> | undefined;
+    biometricTemplateHash?: string | undefined;
+    biometricDataEncrypted?: string | undefined;
+    biometricCaptureMetadata?: {
+        deviceInfo?: string | undefined;
+        captureType: "face" | "hand";
+        anglesCaptured: string[];
+        captureQuality: number;
+        livenessPassed: boolean;
+        captureTimestamp: number;
+    } | undefined;
+    lastVerificationAt?: number | undefined;
+    lastVerificationSuccess?: boolean | undefined;
+    verificationTimeoutAt?: number | undefined;
     phoneNumber: string;
     email: string;
     name: string;
-    clerkUserId: string;
     createdAt: number;
     isDeleted: boolean;
     branchId: import("convex/values").GenericId<"branches">;
     isActive: boolean;
+    enrollmentStatus: "active" | "suspended" | "invited" | "enrolling" | "locked";
+    consecutiveFailures: number;
+    createdBy: import("convex/values").GenericId<"admins">;
 }>>;
 /**
- * Get current active attendance session
+ * Get current active attendance session for authenticated attendant
+ * Returns attendance details with branch and attendant info
  */
-export declare const getActiveSession: import("convex/server").RegisteredQuery<"public", {}, Promise<{
-    _id: import("convex/values").GenericId<"attendanceLogs">;
-    _creationTime: number;
-    clockOutAt?: number | undefined;
-    deviceId?: string | undefined;
-    deviceInfo?: string | undefined;
-    isDeleted: boolean;
+export declare const getActiveAttendanceSession: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+    attendance: {
+        _id: import("convex/values").GenericId<"attendanceLogs">;
+        attendantId: import("convex/values").GenericId<"attendants">;
+        branchId: import("convex/values").GenericId<"branches">;
+        clockInAt: number;
+        deviceId: string | undefined;
+        deviceInfo: string | undefined;
+    };
+    branch: {
+        _id: import("convex/values").GenericId<"branches">;
+        name: string;
+        address: string;
+    } | null;
+    attendant: {
+        _id: import("convex/values").GenericId<"attendants">;
+        name: string;
+        email: string;
+    };
+} | null>>;
+/**
+ * Get all active attendances for a branch
+ * Useful for station dashboard to show who's currently clocked in
+ */
+export declare const getActiveAttendancesByBranch: import("convex/server").RegisteredQuery<"public", {
     branchId: import("convex/values").GenericId<"branches">;
-    isActive: boolean;
-    attendantId: import("convex/values").GenericId<"attendants">;
+}, Promise<({
+    _id: import("convex/values").GenericId<"attendanceLogs">;
     clockInAt: number;
-} | null>>;
+    deviceId: string | undefined;
+    deviceInfo: string | undefined;
+    attendant: null;
+} | {
+    _id: import("convex/values").GenericId<"attendanceLogs">;
+    clockInAt: number;
+    deviceId: string | undefined;
+    deviceInfo: string | undefined;
+    attendant: {
+        _id: import("convex/values").GenericId<"attendants">;
+        name: string;
+        email: string;
+    };
+})[]>>;
 /**
  * Get attendance history - Paginated
  * Supports usePaginatedQuery for infinite scroll
@@ -71,9 +145,9 @@ export declare const getAttendanceHistory: import("convex/server").RegisteredQue
     page: {
         _id: import("convex/values").GenericId<"attendanceLogs">;
         _creationTime: number;
+        deviceInfo?: string | undefined;
         clockOutAt?: number | undefined;
         deviceId?: string | undefined;
-        deviceInfo?: string | undefined;
         isDeleted: boolean;
         branchId: import("convex/values").GenericId<"branches">;
         isActive: boolean;
@@ -87,8 +161,8 @@ export declare const getAttendanceHistory: import("convex/server").RegisteredQue
  * Clock in attendant (start attendance session)
  */
 export declare const clockIn: import("convex/server").RegisteredMutation<"public", {
-    deviceId?: string | undefined;
     deviceInfo?: string | undefined;
+    deviceId?: string | undefined;
     branchId: import("convex/values").GenericId<"branches">;
 }, Promise<import("convex/values").GenericId<"attendanceLogs">>>;
 /**
@@ -96,7 +170,37 @@ 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">>>;
+}, Promise<{
+    attendanceLogId: import("convex/values").GenericId<"attendanceLogs">;
+    sessionsRevoked: number;
+    durationMinutes: number;
+}>>;
+/**
+ * Get attendance details by ID
+ */
+export declare const getAttendanceById: import("convex/server").RegisteredQuery<"public", {
+    attendanceId: import("convex/values").GenericId<"attendanceLogs">;
+}, Promise<{
+    _id: import("convex/values").GenericId<"attendanceLogs">;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    branchId: import("convex/values").GenericId<"branches">;
+    clockInAt: number;
+    clockOutAt: number | undefined;
+    deviceId: string | undefined;
+    deviceInfo: string | undefined;
+    isActive: boolean;
+    durationMinutes: number;
+    attendant: {
+        _id: import("convex/values").GenericId<"attendants">;
+        name: string;
+        email: string;
+    } | null;
+    branch: {
+        _id: import("convex/values").GenericId<"branches">;
+        name: string;
+        address: string;
+    } | null;
+}>>;
 /**
  * Get attendance statistics for a branch
  */
@@ -137,4 +241,214 @@ export declare const getAttendanceSummary: import("convex/server").RegisteredQue
         end: number;
     };
 }>>;
+/**
+ * Verify enrollment token (public query - no auth required)
+ */
+export declare const verifyEnrollmentToken: import("convex/server").RegisteredQuery<"public", {
+    token: string;
+}, Promise<{
+    valid: boolean;
+    error: string;
+    attendant?: undefined;
+    expiresAt?: undefined;
+} | {
+    valid: boolean;
+    attendant: {
+        id: import("convex/values").GenericId<"attendants">;
+        name: string;
+        email: string;
+        branchId: import("convex/values").GenericId<"branches">;
+        branchName: string;
+    };
+    expiresAt: number;
+    error?: undefined;
+}>>;
+/**
+ * Start biometric enrollment
+ */
+export declare const startBiometricEnrollment: import("convex/server").RegisteredMutation<"public", {
+    method: "face" | "hand";
+    enrollmentToken: string;
+}, Promise<{
+    sessionId: import("convex/values").GenericId<"biometricVerificationSessions">;
+    challenge: string;
+    expiresAt: number;
+}>>;
+/**
+ * Complete biometric enrollment
+ */
+export declare const completeBiometricEnrollment: import("convex/server").RegisteredMutation<"public", {
+    challenge: string;
+    enrollmentToken: string;
+    biometricData: {
+        deviceInfo?: string | undefined;
+        captureType: "face" | "hand";
+        captureQuality: number;
+        angles: string[];
+        features: string;
+        measurements: string;
+        livenessData: string;
+    };
+}, Promise<{
+    success: boolean;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    enrolledAt: number;
+}>>;
+/**
+ * Find attendant by email (for login)
+ */
+export declare const findByEmail: import("convex/server").RegisteredQuery<"public", {
+    email: string;
+}, Promise<{
+    id: import("convex/values").GenericId<"attendants">;
+    email: string;
+    name: string;
+    branchId: import("convex/values").GenericId<"branches">;
+    authenticationMethods: ("biometric_face" | "biometric_hand" | "pin" | "password")[];
+    hasBiometric: boolean;
+    hasPin: boolean;
+} | null>>;
+/**
+ * Start verification (for login or action)
+ * Changed to mutation to allow storing challenges
+ */
+export declare const startVerification: import("convex/server").RegisteredMutation<"public", {
+    actionContext?: {
+        orderId?: import("convex/values").GenericId<"orders"> | undefined;
+        amount?: number | undefined;
+        actionType?: string | undefined;
+    } | undefined;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    verificationType: "action" | "login" | "session_renewal";
+}, Promise<{
+    challenge: string;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    verificationType: "action" | "login" | "session_renewal";
+    requiresLiveness: boolean;
+}>>;
+/**
+ * Verify biometric (complete verification)
+ */
+export declare const verifyBiometric: import("convex/server").RegisteredMutation<"public", {
+    actionContext?: {
+        orderId?: import("convex/values").GenericId<"orders"> | undefined;
+        amount?: number | undefined;
+        actionType?: string | undefined;
+    } | undefined;
+    useFallback?: boolean | undefined;
+    fallbackType?: "otp" | "admin_verification" | undefined;
+    fallbackCode?: string | undefined;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    challenge: string;
+    verificationType: "action" | "login" | "session_renewal";
+    biometricData: {
+        deviceInfo?: string | undefined;
+        captureType: "face" | "hand";
+        captureQuality: number;
+        angles: string[];
+        features: string;
+        measurements: string;
+        livenessData: string;
+    };
+}, Promise<{
+    success: boolean;
+    verificationId: import("convex/values").GenericId<"biometricVerifications">;
+    expiresAt: number;
+    fallbackUsed: "otp" | "admin_verification";
+    confidence?: undefined;
+} | {
+    success: boolean;
+    verificationId: import("convex/values").GenericId<"biometricVerifications">;
+    confidence: number;
+    expiresAt: number;
+    fallbackUsed?: undefined;
+}>>;
+/**
+ * Check verification status
+ */
+export declare const checkVerificationStatus: import("convex/server").RegisteredQuery<"public", {
+    attendantId: import("convex/values").GenericId<"attendants">;
+}, Promise<{
+    isVerified: boolean;
+    expiresAt: number | undefined;
+    lastVerificationAt: number | undefined;
+    consecutiveFailures: number;
+    enrollmentStatus: "active" | "suspended" | "invited" | "enrolling" | "locked";
+}>>;
+/**
+ * Create session after successful biometric verification
+ */
+export declare const createSession: import("convex/server").RegisteredMutation<"public", {
+    deviceInfo?: string | undefined;
+    attendantId: import("convex/values").GenericId<"attendants">;
+}, Promise<{
+    success: boolean;
+    sessionToken: string;
+    refreshToken: string;
+    expiresAt: number;
+    refreshExpiresAt: number;
+    sessionId: import("convex/values").GenericId<"attendantSessions">;
+}>>;
+/**
+ * Refresh session access token
+ */
+export declare const refreshSession: import("convex/server").RegisteredMutation<"public", {
+    refreshToken: string;
+}, Promise<{
+    success: boolean;
+    sessionToken: string;
+    expiresAt: number;
+}>>;
+/**
+ * Logout - invalidate session
+ */
+export declare const logout: import("convex/server").RegisteredMutation<"public", {
+    sessionToken?: string | undefined;
+}, Promise<{
+    success: boolean;
+    sessionsRevoked?: undefined;
+} | {
+    success: boolean;
+    sessionsRevoked: number;
+}>>;
+/**
+ * Authenticate attendant with PIN or Password
+ */
+export declare const authenticateWithPinOrPassword: import("convex/server").RegisteredMutation<"public", {
+    deviceInfo?: string | undefined;
+    branchId: import("convex/values").GenericId<"branches">;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    pinOrPassword: string;
+    isPin: boolean;
+}, Promise<{
+    success: boolean;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    name: string;
+    email: string;
+    branchId: import("convex/values").GenericId<"branches">;
+}>>;
+/**
+ * Get current session (validate and return session info)
+ */
+export declare const getCurrentSession: import("convex/server").RegisteredQuery<"public", {
+    sessionToken: string;
+}, Promise<{
+    success: boolean;
+    attendant: {
+        _id: import("convex/values").GenericId<"attendants">;
+        name: string;
+        email: string;
+        branchId: import("convex/values").GenericId<"branches">;
+    };
+    branch: {
+        _id: import("convex/values").GenericId<"branches">;
+        name: string;
+        address: string;
+    } | null;
+    session: {
+        expiresAt: number;
+        lastActivityAt: number;
+        createdAt: number;
+    };
+}>>;
 //# sourceMappingURL=attendants.d.ts.map

package/convex/audit.d.ts

@@ -17,6 +17,7 @@ export declare const getByEntity: import("convex/server").RegisteredQuery<"publi
     branchId?: import("convex/values").GenericId<"branches"> | undefined;
     deviceId?: string | undefined;
     entityId?: string | undefined;
+    attendanceId?: import("convex/values").GenericId<"attendanceLogs"> | undefined;
     ipAddress?: string | undefined;
     details?: string | undefined;
     oldValue?: string | undefined;
@@ -41,6 +42,7 @@ export declare const getByActor: import("convex/server").RegisteredQuery<"public
     branchId?: import("convex/values").GenericId<"branches"> | undefined;
     deviceId?: string | undefined;
     entityId?: string | undefined;
+    attendanceId?: import("convex/values").GenericId<"attendanceLogs"> | undefined;
     ipAddress?: string | undefined;
     details?: string | undefined;
     oldValue?: string | undefined;
@@ -64,6 +66,7 @@ export declare const getByBranch: import("convex/server").RegisteredQuery<"publi
     branchId?: import("convex/values").GenericId<"branches"> | undefined;
     deviceId?: string | undefined;
     entityId?: string | undefined;
+    attendanceId?: import("convex/values").GenericId<"attendanceLogs"> | undefined;
     ipAddress?: string | undefined;
     details?: string | undefined;
     oldValue?: string | undefined;
@@ -87,6 +90,7 @@ export declare const getByAction: import("convex/server").RegisteredQuery<"publi
     branchId?: import("convex/values").GenericId<"branches"> | undefined;
     deviceId?: string | undefined;
     entityId?: string | undefined;
+    attendanceId?: import("convex/values").GenericId<"attendanceLogs"> | undefined;
     ipAddress?: string | undefined;
     details?: string | undefined;
     oldValue?: string | undefined;
@@ -111,6 +115,7 @@ export declare const getByTimeRange: import("convex/server").RegisteredQuery<"pu
     branchId?: import("convex/values").GenericId<"branches"> | undefined;
     deviceId?: string | undefined;
     entityId?: string | undefined;
+    attendanceId?: import("convex/values").GenericId<"attendanceLogs"> | undefined;
     ipAddress?: string | undefined;
     details?: string | undefined;
     oldValue?: string | undefined;
@@ -147,6 +152,7 @@ export declare const getAll: import("convex/server").RegisteredQuery<"public", {
         branchId?: import("convex/values").GenericId<"branches"> | undefined;
         deviceId?: string | undefined;
         entityId?: string | undefined;
+        attendanceId?: import("convex/values").GenericId<"attendanceLogs"> | undefined;
         ipAddress?: string | undefined;
         details?: string | undefined;
         oldValue?: string | undefined;

package/convex/customers.d.ts

@@ -118,6 +118,53 @@ export declare const getOrders: import("convex/server").RegisteredQuery<"public"
     isDone: boolean;
     continueCursor: string;
 }>>;
+/**
+ * Get active orders for customer (not cancelled or completed)
+ * Returns orders that are still in progress
+ */
+export declare const getActiveOrders: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+    _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;
+    }[];
+}[]>>;
 /**
  * Get customer loyalty points balance
  * Returns zero points if customer not found

package/convex/lib/attendance.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Attendance Utility Functions
+ *
+ * Provides helper functions for attendance-related operations,
+ * including verification and validation for attendance-linked actions.
+ */
+import { QueryCtx, MutationCtx } from "../_generated/server";
+import { Id } from "../_generated/dataModel";
+/**
+ * Get active attendance record for an attendant
+ * @throws Error if no active attendance found
+ */
+export declare function getActiveAttendance(ctx: QueryCtx | MutationCtx, attendantId: Id<"attendants">): Promise<{
+    _id: import("convex/values").GenericId<"attendanceLogs">;
+    _creationTime: number;
+    deviceInfo?: string | undefined;
+    clockOutAt?: number | undefined;
+    deviceId?: string | undefined;
+    isDeleted: boolean;
+    branchId: import("convex/values").GenericId<"branches">;
+    isActive: boolean;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    clockInAt: number;
+}>;
+/**
+ * Verify that an attendant has an active attendance session
+ * Returns the attendance record if valid, throws error otherwise
+ */
+export declare function verifyActiveAttendance(ctx: QueryCtx | MutationCtx, attendantId: Id<"attendants">, branchId?: Id<"branches">): Promise<{
+    _id: import("convex/values").GenericId<"attendanceLogs">;
+    _creationTime: number;
+    deviceInfo?: string | undefined;
+    clockOutAt?: number | undefined;
+    deviceId?: string | undefined;
+    isDeleted: boolean;
+    branchId: import("convex/values").GenericId<"branches">;
+    isActive: boolean;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    clockInAt: number;
+}>;
+/**
+ * Check if attendant has active attendance (does not throw, returns boolean)
+ */
+export declare function hasActiveAttendance(ctx: QueryCtx | MutationCtx, attendantId: Id<"attendants">): Promise<boolean>;
+/**
+ * Get all active attendances for a branch
+ */
+export declare function getActiveAttendancesByBranch(ctx: QueryCtx | MutationCtx, branchId: Id<"branches">): Promise<{
+    _id: import("convex/values").GenericId<"attendanceLogs">;
+    _creationTime: number;
+    deviceInfo?: string | undefined;
+    clockOutAt?: number | undefined;
+    deviceId?: string | undefined;
+    isDeleted: boolean;
+    branchId: import("convex/values").GenericId<"branches">;
+    isActive: boolean;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    clockInAt: number;
+}[]>;
+/**
+ * Get attendance history for an attendant
+ */
+export declare function getAttendantAttendanceHistory(ctx: QueryCtx | MutationCtx, attendantId: Id<"attendants">, limit?: number): Promise<{
+    _id: import("convex/values").GenericId<"attendanceLogs">;
+    _creationTime: number;
+    deviceInfo?: string | undefined;
+    clockOutAt?: number | undefined;
+    deviceId?: string | undefined;
+    isDeleted: boolean;
+    branchId: import("convex/values").GenericId<"branches">;
+    isActive: boolean;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    clockInAt: number;
+}[]>;
+/**
+ * Calculate duration of an attendance session in minutes
+ */
+export declare function calculateAttendanceDuration(clockInAt: number, clockOutAt?: number): number;
+//# sourceMappingURL=attendance.d.ts.map

package/convex/lib/audit.d.ts

@@ -14,6 +14,7 @@ interface AuditLogParams {
     action: string;
     entityType: string;
     entityId?: string;
+    attendanceId?: Id<"attendanceLogs">;
     branchId?: Id<"branches">;
     deviceId?: string;
     details?: string;
@@ -23,7 +24,7 @@ interface AuditLogParams {
 /**
  * Create an audit log entry
  */
-export declare function createAuditLog({ ctx, actorId, actorType, actorRole, action, entityType, entityId, branchId, deviceId, details, oldValue, newValue, }: AuditLogParams): Promise<Id<"auditLogs">>;
+export declare function createAuditLog({ ctx, actorId, actorType, actorRole, action, entityType, entityId, attendanceId, branchId, deviceId, details, oldValue, newValue, }: AuditLogParams): Promise<Id<"auditLogs">>;
 /**
  * Create audit log for order status change
  */