@devlider001/washlab-backend 1.0.8 → 1.1.0

package/convex/_generated/api.d.ts

@@ -8,6 +8,7 @@
  * @module
  */
 
+import type * as actions from "../actions.js";
 import type * as admin from "../admin.js";
 import type * as analytics from "../analytics.js";
 import type * as attendants from "../attendants.js";
@@ -16,14 +17,20 @@ import type * as branches from "../branches.js";
 import type * as clerk from "../clerk.js";
 import type * as customers from "../customers.js";
 import type * as http from "../http.js";
+import type * as lib_attendance from "../lib/attendance.js";
 import type * as lib_audit from "../lib/audit.js";
 import type * as lib_auth from "../lib/auth.js";
+import type * as lib_biometricComparison from "../lib/biometricComparison.js";
+import type * as lib_biometricEncryption from "../lib/biometricEncryption.js";
+import type * as lib_passwordHashing from "../lib/passwordHashing.js";
+import type * as lib_tokenHashing from "../lib/tokenHashing.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 stations from "../stations.js";
 import type * as vouchers from "../vouchers.js";
 
 import type {
@@ -33,6 +40,7 @@ import type {
 } from "convex/server";
 
 declare const fullApi: ApiFromModules<{
+  actions: typeof actions;
   admin: typeof admin;
   analytics: typeof analytics;
   attendants: typeof attendants;
@@ -41,14 +49,20 @@ declare const fullApi: ApiFromModules<{
   clerk: typeof clerk;
   customers: typeof customers;
   http: typeof http;
+  "lib/attendance": typeof lib_attendance;
   "lib/audit": typeof lib_audit;
   "lib/auth": typeof lib_auth;
+  "lib/biometricComparison": typeof lib_biometricComparison;
+  "lib/biometricEncryption": typeof lib_biometricEncryption;
+  "lib/passwordHashing": typeof lib_passwordHashing;
+  "lib/tokenHashing": typeof lib_tokenHashing;
   "lib/utils": typeof lib_utils;
   loyalty: typeof loyalty;
   notifications: typeof notifications;
   orders: typeof orders;
   payments: typeof payments;
   resources: typeof resources;
+  stations: typeof stations;
   vouchers: typeof vouchers;
 }>;
 

package/convex/actions.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Action Execution Functions
+ *
+ * Handles attendance-linked action execution with verification.
+ * All critical actions must be linked to an active attendance session.
+ */
+import { MutationCtx } from "./_generated/server";
+import { Id } from "./_generated/dataModel";
+/**
+ * Create action log entry (attendance-linked)
+ * This is called after verifying attendance and executing the action
+ * Note: This function requires MutationCtx for insert operations
+ */
+export declare function createActionLog(ctx: MutationCtx, attendanceId: Id<"attendanceLogs">, attendantId: Id<"attendants">, branchId: Id<"branches">, actionType: string, entityType: string, entityId: string | Id<"orders">, deviceId?: string, metadata?: Record<string, any>, actionStatus?: "pending" | "completed" | "failed" | "cancelled"): Promise<Id<"actionLogs">>;
+/**
+ * Execute action with attendance verification
+ * This is the main entry point for critical actions
+ */
+export declare const executeAction: import("convex/server").RegisteredMutation<"public", {
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+    deviceId?: string | undefined;
+    metadata?: string | undefined;
+    entityType: string;
+    entityId: string;
+    actionType: string;
+}, Promise<{
+    success: boolean;
+    actionLogId: Id<"actionLogs">;
+    attendanceId: import("convex/values").GenericId<"attendanceLogs">;
+    timestamp: number;
+}>>;
+/**
+ * Get actions by attendance session
+ */
+export declare const getActionsByAttendance: import("convex/server").RegisteredQuery<"public", {
+    attendanceId: import("convex/values").GenericId<"attendanceLogs">;
+}, Promise<{
+    _id: import("convex/values").GenericId<"actionLogs">;
+    _creationTime: number;
+    amount?: number | undefined;
+    completedAt?: number | undefined;
+    entityType?: string | undefined;
+    entityId?: import("convex/values").GenericId<"orders"> | undefined;
+    errorMessage?: string | undefined;
+    actionData?: string | undefined;
+    verificationMethod?: "biometric_face" | "biometric_hand" | "pin" | "password" | undefined;
+    verificationId?: import("convex/values").GenericId<"biometricVerifications"> | undefined;
+    createdAt: number;
+    branchId: import("convex/values").GenericId<"branches">;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    attendanceId: import("convex/values").GenericId<"attendanceLogs">;
+    actionType: string;
+    actionStatus: "pending" | "completed" | "cancelled" | "failed";
+}[]>>;
+/**
+ * Get actions by attendant (with pagination)
+ */
+export declare const getActionsByAttendant: import("convex/server").RegisteredQuery<"public", {
+    attendantId: import("convex/values").GenericId<"attendants">;
+    paginationOpts: {
+        id?: number;
+        endCursor?: string | null;
+        maximumRowsRead?: number;
+        maximumBytesRead?: number;
+        numItems: number;
+        cursor: string | null;
+    };
+}, Promise<import("convex/server").PaginationResult<{
+    _id: import("convex/values").GenericId<"actionLogs">;
+    _creationTime: number;
+    amount?: number | undefined;
+    completedAt?: number | undefined;
+    entityType?: string | undefined;
+    entityId?: import("convex/values").GenericId<"orders"> | undefined;
+    errorMessage?: string | undefined;
+    actionData?: string | undefined;
+    verificationMethod?: "biometric_face" | "biometric_hand" | "pin" | "password" | undefined;
+    verificationId?: import("convex/values").GenericId<"biometricVerifications"> | undefined;
+    createdAt: number;
+    branchId: import("convex/values").GenericId<"branches">;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    attendanceId: import("convex/values").GenericId<"attendanceLogs">;
+    actionType: string;
+    actionStatus: "pending" | "completed" | "cancelled" | "failed";
+}>>>;
+/**
+ * Get actions by branch (with pagination)
+ */
+export declare const getActionsByBranch: import("convex/server").RegisteredQuery<"public", {
+    actionType?: string | undefined;
+    startDate?: number | undefined;
+    endDate?: number | undefined;
+    branchId: import("convex/values").GenericId<"branches">;
+    paginationOpts: {
+        id?: number;
+        endCursor?: string | null;
+        maximumRowsRead?: number;
+        maximumBytesRead?: number;
+        numItems: number;
+        cursor: string | null;
+    };
+}, Promise<import("convex/server").PaginationResult<{
+    _id: import("convex/values").GenericId<"actionLogs">;
+    _creationTime: number;
+    amount?: number | undefined;
+    completedAt?: number | undefined;
+    entityType?: string | undefined;
+    entityId?: import("convex/values").GenericId<"orders"> | undefined;
+    errorMessage?: string | undefined;
+    actionData?: string | undefined;
+    verificationMethod?: "biometric_face" | "biometric_hand" | "pin" | "password" | undefined;
+    verificationId?: import("convex/values").GenericId<"biometricVerifications"> | undefined;
+    createdAt: number;
+    branchId: import("convex/values").GenericId<"branches">;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    attendanceId: import("convex/values").GenericId<"attendanceLogs">;
+    actionType: string;
+    actionStatus: "pending" | "completed" | "cancelled" | "failed";
+}>>>;
+/**
+ * Get actions by entity (e.g., all actions on a specific order)
+ * Note: Currently only supports orders as entityType due to schema limitation
+ * This query is not optimized for large datasets - consider using pagination or adding an index
+ */
+export declare const getActionsByEntity: import("convex/server").RegisteredQuery<"public", {
+    entityType: string;
+    entityId: import("convex/values").GenericId<"orders">;
+}, Promise<{
+    _id: import("convex/values").GenericId<"actionLogs">;
+    _creationTime: number;
+    amount?: number | undefined;
+    completedAt?: number | undefined;
+    entityType?: string | undefined;
+    entityId?: import("convex/values").GenericId<"orders"> | undefined;
+    errorMessage?: string | undefined;
+    actionData?: string | undefined;
+    verificationMethod?: "biometric_face" | "biometric_hand" | "pin" | "password" | undefined;
+    verificationId?: import("convex/values").GenericId<"biometricVerifications"> | undefined;
+    createdAt: number;
+    branchId: import("convex/values").GenericId<"branches">;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    attendanceId: import("convex/values").GenericId<"attendanceLogs">;
+    actionType: string;
+    actionStatus: "pending" | "completed" | "cancelled" | "failed";
+}[]>>;
+/**
+ * Get action statistics for an attendance session
+ */
+export declare const getAttendanceActionStats: import("convex/server").RegisteredQuery<"public", {
+    attendanceId: import("convex/values").GenericId<"attendanceLogs">;
+}, Promise<{
+    totalActions: number;
+    actionsByType: Record<string, number>;
+    firstAction: number | null;
+    lastAction: number | null;
+    durationMinutes: number | null;
+}>>;
+//# sourceMappingURL=actions.d.ts.map

package/convex/admin.d.ts

@@ -38,18 +38,20 @@ export declare const getBranches: import("convex/server").RegisteredQuery<"publi
         _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;
-        createdBy: import("convex/values").GenericId<"admins">;
     }[];
     isDone: boolean;
     continueCursor: string;
@@ -63,18 +65,20 @@ export declare const getBranchByCode: import("convex/server").RegisteredQuery<"p
     _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;
-    createdBy: import("convex/values").GenericId<"admins">;
 } | null>>;
 /**
  * Get single branch by ID
@@ -85,18 +89,20 @@ export declare const getBranch: import("convex/server").RegisteredQuery<"public"
     _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;
-    createdBy: import("convex/values").GenericId<"admins">;
 } | null>>;
 /**
  * Get all attendants - Paginated
@@ -104,23 +110,44 @@ export declare const getBranch: import("convex/server").RegisteredQuery<"public"
  */
 export declare const getAttendants: import("convex/server").RegisteredQuery<"public", {
     branchId?: import("convex/values").GenericId<"branches"> | undefined;
-    includeInactive?: boolean | undefined;
     numItems?: number | undefined;
     cursor?: string | undefined;
+    includeInactive?: boolean | undefined;
 }, Promise<{
     page: {
         _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">;
     }[];
     isDone: boolean;
     continueCursor: string;
@@ -290,6 +317,8 @@ 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;
@@ -313,6 +342,8 @@ export declare const updateBranch: import("convex/server").RegisteredMutation<"p
     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">>>;
 /**
@@ -349,9 +380,9 @@ export declare const updateAttendant: import("convex/server").RegisteredMutation
     phoneNumber?: string | undefined;
     email?: string | undefined;
     name?: string | undefined;
-    passcode?: string | undefined;
     branchId?: import("convex/values").GenericId<"branches"> | undefined;
     isActive?: boolean | undefined;
+    passcode?: string | undefined;
     attendantId: import("convex/values").GenericId<"attendants">;
 }, Promise<import("convex/values").GenericId<"attendants">>>;
 /**
@@ -361,6 +392,70 @@ 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">>>;
+/**
+ * Change attendant enrollment status (suspend, activate, lock, unlock)
+ */
+export declare const changeAttendantStatus: import("convex/server").RegisteredMutation<"public", {
+    reason?: string | undefined;
+    status: "active" | "suspended" | "invited" | "enrolling" | "locked";
+    attendantId: import("convex/values").GenericId<"attendants">;
+}, Promise<{
+    attendantId: import("convex/values").GenericId<"attendants">;
+    oldStatus: "active" | "suspended" | "invited" | "enrolling" | "locked";
+    newStatus: "active" | "suspended" | "invited" | "enrolling" | "locked";
+}>>;
+/**
+ * Suspend attendant (convenience function)
+ */
+export declare const suspendAttendant: import("convex/server").RegisteredMutation<"public", {
+    reason?: string | undefined;
+    attendantId: import("convex/values").GenericId<"attendants">;
+}, Promise<{
+    attendantId: import("convex/values").GenericId<"attendants">;
+    oldStatus: "active" | "invited" | "enrolling" | "locked";
+    newStatus: string;
+}>>;
+/**
+ * Activate attendant (convenience function - unsuspend/unlock)
+ */
+export declare const activateAttendant: import("convex/server").RegisteredMutation<"public", {
+    reason?: string | undefined;
+    attendantId: import("convex/values").GenericId<"attendants">;
+}, Promise<{
+    attendantId: import("convex/values").GenericId<"attendants">;
+    oldStatus: "suspended" | "invited" | "enrolling" | "locked";
+    newStatus: string;
+}>>;
+/**
+ * Lock attendant (convenience function)
+ */
+export declare const lockAttendant: import("convex/server").RegisteredMutation<"public", {
+    reason?: string | undefined;
+    attendantId: import("convex/values").GenericId<"attendants">;
+}, Promise<{
+    attendantId: import("convex/values").GenericId<"attendants">;
+    oldStatus: "active" | "suspended" | "invited" | "enrolling";
+    newStatus: string;
+}>>;
+/**
+ * Reset attendant verification failures
+ */
+export declare const resetAttendantFailures: import("convex/server").RegisteredMutation<"public", {
+    reason?: string | undefined;
+    attendantId: import("convex/values").GenericId<"attendants">;
+}, Promise<{
+    attendantId: import("convex/values").GenericId<"attendants">;
+}>>;
+/**
+ * Revoke all active sessions for an attendant
+ */
+export declare const revokeAttendantSessions: import("convex/server").RegisteredMutation<"public", {
+    reason?: string | undefined;
+    attendantId: import("convex/values").GenericId<"attendants">;
+}, Promise<{
+    attendantId: import("convex/values").GenericId<"attendants">;
+    sessionsRevoked: number;
+}>>;
 /**
  * Delete attendant (soft delete)
  */
@@ -463,4 +558,50 @@ export declare const getOrderDetails: import("convex/server").RegisteredQuery<"p
         changedAt: number;
     }[];
 } | null>>;
+/**
+ * Create attendant enrollment (Admin)
+ * Generates enrollment link for attendant to complete biometric setup
+ */
+export declare const createAttendantEnrollment: import("convex/server").RegisteredMutation<"public", {
+    expiresInHours?: number | undefined;
+    phoneNumber: string;
+    email: string;
+    name: string;
+    branchId: import("convex/values").GenericId<"branches">;
+}, Promise<{
+    attendantId: Id<"attendants">;
+    enrollmentToken: string;
+    enrollmentLink: string;
+    expiresAt: number;
+}>>;
+/**
+ * List attendant enrollments (Admin)
+ */
+export declare const listAttendantEnrollments: import("convex/server").RegisteredQuery<"public", {
+    status?: "active" | "suspended" | "invited" | "enrolling" | "locked" | undefined;
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+}, Promise<{
+    id: import("convex/values").GenericId<"attendants">;
+    name: string;
+    email: string;
+    phoneNumber: string;
+    branchId: import("convex/values").GenericId<"branches">;
+    enrollmentStatus: "active" | "suspended" | "invited" | "enrolling" | "locked";
+    enrolledAt: number | undefined;
+    enrollmentTokenExpiresAt: number | undefined;
+    lastVerificationAt: number | undefined;
+    consecutiveFailures: number;
+    createdAt: number;
+}[]>>;
+/**
+ * Resend enrollment link (Admin)
+ */
+export declare const resendEnrollmentLink: import("convex/server").RegisteredMutation<"public", {
+    expiresInHours?: number | undefined;
+    attendantId: import("convex/values").GenericId<"attendants">;
+}, Promise<{
+    enrollmentToken: string;
+    enrollmentLink: string;
+    expiresAt: number;
+}>>;
 //# sourceMappingURL=admin.d.ts.map