@devlider001/washlab-backend 1.0.0 → 1.0.2

package/convex/admin.d.ts

@@ -0,0 +1,241 @@
+import { Id } from "./_generated/dataModel";
+/**
+ * Admin Functions
+ *
+ * Handles admin operations: branch management, attendant management,
+ * system-wide order viewing, analytics, and customer management.
+ */
+/**
+ * Get current admin profile (from authenticated Clerk session)
+ */
+export declare const getCurrentUser: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+    _id: import("convex/values").GenericId<"admins">;
+    _creationTime: number;
+    lastLoginAt?: number | undefined;
+    email: string;
+    name: string;
+    clerkUserId: string;
+    createdAt: number;
+    isDeleted: boolean;
+    role: "super_admin" | "admin";
+}>>;
+/**
+ * Get all branches - Paginated
+ * Supports usePaginatedQuery for infinite scroll
+ */
+export declare const getBranches: import("convex/server").RegisteredQuery<"public", {
+    includeInactive?: boolean | undefined;
+    cursor?: string | undefined;
+    numItems?: number | undefined;
+}, Promise<{
+    page: {
+        _id: import("convex/values").GenericId<"branches">;
+        _creationTime: number;
+        email?: string | undefined;
+        phoneNumber: string;
+        name: string;
+        createdAt: number;
+        isDeleted: boolean;
+        isActive: boolean;
+        address: string;
+        city: string;
+        country: string;
+        pricingPerKg: number;
+        deliveryFee: number;
+        createdBy: import("convex/values").GenericId<"admins">;
+    }[];
+    isDone: boolean;
+    continueCursor: string;
+}>>;
+/**
+ * Get all attendants - Paginated
+ * Supports usePaginatedQuery for infinite scroll
+ */
+export declare const getAttendants: import("convex/server").RegisteredQuery<"public", {
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+    includeInactive?: boolean | undefined;
+    cursor?: string | undefined;
+    numItems?: number | undefined;
+}, Promise<{
+    page: {
+        _id: import("convex/values").GenericId<"attendants">;
+        _creationTime: number;
+        lastLoginAt?: number | undefined;
+        passcode?: string | undefined;
+        phoneNumber: string;
+        email: string;
+        name: string;
+        clerkUserId: string;
+        createdAt: number;
+        isDeleted: boolean;
+        branchId: import("convex/values").GenericId<"branches">;
+        isActive: boolean;
+    }[];
+    isDone: boolean;
+    continueCursor: string;
+}>>;
+/**
+ * Get all orders (with filters) - Paginated
+ * 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;
+    cursor?: string | undefined;
+    numItems?: number | undefined;
+    startDate?: number | undefined;
+    endDate?: number | undefined;
+}, Promise<{
+    page: {
+        _id: import("convex/values").GenericId<"orders">;
+        _creationTime: number;
+        createdBy?: import("convex/values").GenericId<"attendants"> | undefined;
+        estimatedWeight?: number | undefined;
+        actualWeight?: number | undefined;
+        itemCount?: number | undefined;
+        estimatedLoads?: number | undefined;
+        whitesSeparate?: boolean | undefined;
+        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;
+        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;
+        status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
+        paymentStatus: "pending" | "paid" | "failed" | "refunded";
+        updatedAt: number;
+        statusHistory: {
+            notes?: string | undefined;
+            status: string;
+            changedAt: number;
+            changedBy: import("convex/values").GenericId<"attendants">;
+        }[];
+    }[];
+    isDone: boolean;
+    continueCursor: string;
+}>>;
+/**
+ * Get analytics dashboard data
+ */
+export declare const getAnalytics: import("convex/server").RegisteredQuery<"public", {
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+    startDate?: number | undefined;
+    endDate?: number | undefined;
+}, Promise<{
+    totalOrders: number;
+    totalRevenue: number;
+    averageOrderValue: number;
+    ordersByStatus: Record<string, number>;
+    ordersByDay: Record<string, number>;
+    topCustomers: {
+        customerId: Id<"users">;
+        name: string;
+        phoneNumber: string;
+        orderCount: number;
+    }[];
+    dateRange: {
+        start: number | undefined;
+        end: number | undefined;
+    };
+}>>;
+/**
+ * Get all customers (with filters) - Paginated
+ * Supports usePaginatedQuery for infinite scroll
+ */
+export declare const getCustomers: import("convex/server").RegisteredQuery<"public", {
+    search?: string | undefined;
+    cursor?: string | undefined;
+    numItems?: number | undefined;
+}, Promise<{
+    page: {
+        _id: import("convex/values").GenericId<"users">;
+        _creationTime: number;
+        email?: string | undefined;
+        clerkUserId?: string | undefined;
+        lastLoginAt?: number | undefined;
+        preferredBranchId?: import("convex/values").GenericId<"branches"> | undefined;
+        phoneNumber: string;
+        name: string;
+        isRegistered: boolean;
+        isVerified: boolean;
+        createdAt: number;
+        isDeleted: boolean;
+    }[];
+    isDone: boolean;
+    continueCursor: string;
+}>>;
+/**
+ * Create new branch
+ */
+export declare const createBranch: import("convex/server").RegisteredMutation<"public", {
+    email?: string | undefined;
+    phoneNumber: string;
+    name: string;
+    address: string;
+    city: string;
+    country: string;
+    pricingPerKg: number;
+    deliveryFee: number;
+}, Promise<import("convex/values").GenericId<"branches">>>;
+/**
+ * Update branch details
+ */
+export declare const updateBranch: import("convex/server").RegisteredMutation<"public", {
+    phoneNumber?: string | undefined;
+    email?: string | undefined;
+    name?: string | undefined;
+    isActive?: boolean | undefined;
+    address?: string | undefined;
+    city?: string | undefined;
+    country?: string | undefined;
+    pricingPerKg?: number | undefined;
+    deliveryFee?: number | undefined;
+    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
+ */
+export declare const createAttendant: import("convex/server").RegisteredMutation<"public", {
+    passcode?: string | undefined;
+    phoneNumber: string;
+    email: string;
+    name: string;
+    clerkUserId: string;
+    branchId: import("convex/values").GenericId<"branches">;
+}, Promise<import("convex/values").GenericId<"attendants">>>;
+/**
+ * Update attendant details
+ */
+export declare const updateAttendant: import("convex/server").RegisteredMutation<"public", {
+    phoneNumber?: string | undefined;
+    email?: string | undefined;
+    name?: string | undefined;
+    passcode?: string | undefined;
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+    isActive?: boolean | undefined;
+    attendantId: import("convex/values").GenericId<"attendants">;
+}, Promise<import("convex/values").GenericId<"attendants">>>;
+/**
+ * Assign attendant to branch
+ */
+export declare const assignAttendantToBranch: import("convex/server").RegisteredMutation<"public", {
+    branchId: import("convex/values").GenericId<"branches">;
+    attendantId: import("convex/values").GenericId<"attendants">;
+}, Promise<import("convex/values").GenericId<"attendants">>>;
+//# sourceMappingURL=admin.d.ts.map

package/convex/attendants.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Attendant Functions
+ *
+ * Handles attendant authentication, attendance clock-in/out, and profile queries.
+ */
+/**
+ * Get attendants by branch (admin/attendant view)
+ */
+export declare const getByBranch: import("convex/server").RegisteredQuery<"public", {
+    branchId: import("convex/values").GenericId<"branches">;
+}, Promise<{
+    _id: import("convex/values").GenericId<"attendants">;
+    _creationTime: number;
+    lastLoginAt?: number | undefined;
+    passcode?: string | undefined;
+    phoneNumber: string;
+    email: string;
+    name: string;
+    clerkUserId: string;
+    createdAt: number;
+    isDeleted: boolean;
+    branchId: import("convex/values").GenericId<"branches">;
+    isActive: boolean;
+}[]>>;
+/**
+ * Get current attendant profile (from authenticated Clerk session)
+ */
+export declare const getCurrentUser: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+    branch: {
+        _id: import("convex/values").GenericId<"branches">;
+        name: string;
+        address: string;
+    } | null;
+    _id: import("convex/values").GenericId<"attendants">;
+    _creationTime: number;
+    lastLoginAt?: number | undefined;
+    passcode?: string | undefined;
+    phoneNumber: string;
+    email: string;
+    name: string;
+    clerkUserId: string;
+    createdAt: number;
+    isDeleted: boolean;
+    branchId: import("convex/values").GenericId<"branches">;
+    isActive: boolean;
+}>>;
+/**
+ * Get current active attendance session
+ */
+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;
+    branchId: import("convex/values").GenericId<"branches">;
+    isActive: boolean;
+    attendantId: import("convex/values").GenericId<"attendants">;
+    clockInAt: number;
+} | null>>;
+/**
+ * Get attendance history - Paginated
+ * Supports usePaginatedQuery for infinite scroll
+ */
+export declare const getAttendanceHistory: import("convex/server").RegisteredQuery<"public", {
+    branchId?: import("convex/values").GenericId<"branches"> | undefined;
+    cursor?: string | undefined;
+    numItems?: number | undefined;
+}, Promise<{
+    page: {
+        _id: import("convex/values").GenericId<"attendanceLogs">;
+        _creationTime: number;
+        clockOutAt?: number | undefined;
+        deviceId?: string | undefined;
+        deviceInfo?: string | undefined;
+        isDeleted: boolean;
+        branchId: import("convex/values").GenericId<"branches">;
+        isActive: boolean;
+        attendantId: import("convex/values").GenericId<"attendants">;
+        clockInAt: number;
+    }[];
+    isDone: boolean;
+    continueCursor: string;
+}>>;
+/**
+ * Clock in attendant (start attendance session)
+ */
+export declare const clockIn: import("convex/server").RegisteredMutation<"public", {
+    deviceId?: string | undefined;
+    deviceInfo?: string | undefined;
+    branchId: import("convex/values").GenericId<"branches">;
+}, Promise<import("convex/values").GenericId<"attendanceLogs">>>;
+/**
+ * Clock out attendant (end attendance session)
+ */
+export declare const clockOut: import("convex/server").RegisteredMutation<"public", {
+    attendanceLogId?: import("convex/values").GenericId<"attendanceLogs"> | undefined;
+}, Promise<import("convex/values").GenericId<"attendanceLogs">>>;
+//# sourceMappingURL=attendants.d.ts.map

package/convex/audit.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Audit Functions
+ *
+ * Handles querying audit logs for compliance and accountability.
+ * Only admins can access audit logs.
+ */
+/**
+ * Get audit logs by entity
+ */
+export declare const getByEntity: import("convex/server").RegisteredQuery<"public", {
+    entityId?: string | undefined;
+    limit?: number | undefined;
+    entityType: string;
+}, Promise<{
+    _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;
+}[]>>;
+/**
+ * Get audit logs by actor
+ */
+export declare const getByActor: import("convex/server").RegisteredQuery<"public", {
+    actorType?: "admin" | "customer" | "attendant" | undefined;
+    limit?: number | undefined;
+    actorId: string;
+}, Promise<{
+    _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;
+}[]>>;
+/**
+ * Get audit logs by branch
+ */
+export declare const getByBranch: import("convex/server").RegisteredQuery<"public", {
+    limit?: number | undefined;
+    branchId: import("convex/values").GenericId<"branches">;
+}, Promise<{
+    _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;
+}[]>>;
+/**
+ * Get audit logs by action
+ */
+export declare const getByAction: import("convex/server").RegisteredQuery<"public", {
+    limit?: number | undefined;
+    action: string;
+}, Promise<{
+    _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;
+}[]>>;
+/**
+ * Get audit logs by time range
+ */
+export declare const getByTimeRange: import("convex/server").RegisteredQuery<"public", {
+    limit?: number | undefined;
+    startTimestamp: number;
+    endTimestamp: number;
+}, Promise<{
+    _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;
+}[]>>;
+//# sourceMappingURL=audit.d.ts.map

package/convex/clerk.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Internal Clerk Webhook Mutations
+ *
+ * These mutations are called from the webhook handler to sync Clerk user data
+ * with our database. They are internal (not exposed to clients) for security.
+ */
+/**
+ * Sync user created event from Clerk
+ */
+export declare const syncUserCreated: import("convex/server").RegisteredMutation<"internal", {
+    phoneNumber?: string | undefined;
+    email?: string | undefined;
+    userType?: "admin" | "customer" | "attendant" | undefined;
+    name: string;
+    clerkUserId: string;
+    emailVerified: boolean;
+}, Promise<import("convex/values").GenericId<"admins"> | import("convex/values").GenericId<"users"> | import("convex/values").GenericId<"attendants"> | null>>;
+/**
+ * Sync user updated event from Clerk
+ */
+export declare const syncUserUpdated: import("convex/server").RegisteredMutation<"internal", {
+    phoneNumber?: string | undefined;
+    email?: string | undefined;
+    name: string;
+    clerkUserId: string;
+    emailVerified: boolean;
+}, Promise<{
+    type: string;
+    id: import("convex/values").GenericId<"users">;
+} | {
+    type: string;
+    id: import("convex/values").GenericId<"attendants">;
+} | {
+    type: string;
+    id: import("convex/values").GenericId<"admins">;
+} | null>>;
+/**
+ * Sync user deleted event from Clerk
+ */
+export declare const syncUserDeleted: import("convex/server").RegisteredMutation<"internal", {
+    clerkUserId: string;
+}, Promise<{
+    type: string;
+    id: import("convex/values").GenericId<"users">;
+} | {
+    type: string;
+    id: import("convex/values").GenericId<"attendants">;
+} | {
+    type: string;
+    id: import("convex/values").GenericId<"admins">;
+} | null>>;
+//# sourceMappingURL=clerk.d.ts.map

package/convex/customers.d.ts

@@ -0,0 +1,156 @@
+import { Id } from "./_generated/dataModel";
+/**
+ * Customer Functions
+ *
+ * Handles customer profile management, registration, and lookups.
+ * Customers can be guests (walk-in, no account) or registered (with Clerk account).
+ */
+/**
+ * Get customer by phone number
+ * Used by POS for walk-in customer lookup
+ */
+export declare const getByPhone: import("convex/server").RegisteredQuery<"public", {
+    phoneNumber: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"users">;
+    _creationTime: number;
+    email?: string | undefined;
+    clerkUserId?: string | undefined;
+    lastLoginAt?: number | undefined;
+    preferredBranchId?: import("convex/values").GenericId<"branches"> | undefined;
+    phoneNumber: string;
+    name: string;
+    isRegistered: boolean;
+    isVerified: boolean;
+    createdAt: number;
+    isDeleted: boolean;
+} | null>>;
+/**
+ * Get current customer profile (from authenticated Clerk session)
+ */
+export declare const getProfile: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+    orderCount: number;
+    completedOrderCount: number;
+    _id: import("convex/values").GenericId<"users">;
+    _creationTime: number;
+    email?: string | undefined;
+    clerkUserId?: string | undefined;
+    lastLoginAt?: number | undefined;
+    preferredBranchId?: import("convex/values").GenericId<"branches"> | undefined;
+    phoneNumber: string;
+    name: string;
+    isRegistered: boolean;
+    isVerified: boolean;
+    createdAt: number;
+    isDeleted: boolean;
+}>>;
+/**
+ * Get customer order history - Paginated
+ * Supports usePaginatedQuery for infinite scroll
+ */
+export declare const getOrders: import("convex/server").RegisteredQuery<"public", {
+    cursor?: string | undefined;
+    numItems?: number | undefined;
+}, Promise<{
+    page: {
+        _id: import("convex/values").GenericId<"orders">;
+        _creationTime: number;
+        createdBy?: import("convex/values").GenericId<"attendants"> | undefined;
+        estimatedWeight?: number | undefined;
+        actualWeight?: number | undefined;
+        itemCount?: number | undefined;
+        estimatedLoads?: number | undefined;
+        whitesSeparate?: boolean | undefined;
+        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;
+        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;
+        status: "pending" | "in_progress" | "ready_for_pickup" | "delivered" | "completed" | "cancelled";
+        paymentStatus: "pending" | "paid" | "failed" | "refunded";
+        updatedAt: number;
+        statusHistory: {
+            notes?: string | undefined;
+            status: string;
+            changedAt: number;
+            changedBy: import("convex/values").GenericId<"attendants">;
+        }[];
+    }[];
+    isDone: boolean;
+    continueCursor: string;
+}>>;
+/**
+ * Get customer loyalty points balance
+ */
+export declare const getLoyaltyPoints: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+    points: number;
+    totalEarned: number;
+    totalRedeemed: number;
+    lastEarnedAt?: undefined;
+    lastRedeemedAt?: undefined;
+} | {
+    points: number;
+    totalEarned: number;
+    totalRedeemed: number;
+    lastEarnedAt: number | undefined;
+    lastRedeemedAt: number | undefined;
+}>>;
+/**
+ * Create guest customer (walk-in, no Clerk account)
+ * Used when creating walk-in orders at POS
+ */
+export declare const createGuest: import("convex/server").RegisteredMutation<"public", {
+    phoneNumber: string;
+    name: string;
+}, Promise<import("convex/values").GenericId<"users">>>;
+/**
+ * Register customer (link Clerk account to customer profile)
+ * Called after customer signs up via Clerk
+ */
+export declare const register: import("convex/server").RegisteredMutation<"public", {
+    email?: string | undefined;
+    phoneNumber: string;
+    name: string;
+}, Promise<Id<"users">>>;
+/**
+ * Update customer profile
+ */
+export declare const updateProfile: import("convex/server").RegisteredMutation<"public", {
+    email?: string | undefined;
+    name?: string | undefined;
+    preferredBranchId?: import("convex/values").GenericId<"branches"> | undefined;
+}, Promise<import("convex/values").GenericId<"users">>>;
+/**
+ * Create test user (DEV ONLY)
+ *
+ * This mutation allows creating test users in development without requiring
+ * Clerk authentication. Useful for testing and development.
+ *
+ * WARNING: This should only be used in development environments.
+ * In production, users should be created via Clerk webhooks or the register mutation.
+ */
+export declare const createTestUser: import("convex/server").RegisteredMutation<"public", {
+    email?: string | undefined;
+    clerkUserId?: string | undefined;
+    isRegistered?: boolean | undefined;
+    isVerified?: boolean | undefined;
+    phoneNumber: string;
+    name: string;
+}, Promise<import("convex/values").GenericId<"users">>>;
+//# sourceMappingURL=customers.d.ts.map

package/convex/http.d.ts

@@ -0,0 +1,3 @@
+declare const http: import("convex/server").HttpRouter;
+export default http;
+//# sourceMappingURL=http.d.ts.map