vr-commons 1.0.109 → 1.0.110

package/dist/middlewares/idempotency.middlewares.d.ts

@@ -0,0 +1,3 @@
+import { Request, Response, NextFunction } from "express";
+export declare const idempotencyMiddleware: (req: Request, res: Response, next: NextFunction) => Promise<void | Response<any, Record<string, any>>>;
+export declare const storeIdempotencyResponse: (req: Request, res: Response, next: NextFunction) => Promise<void>;

package/dist/middlewares/idempotency.middlewares.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storeIdempotencyResponse = exports.idempotencyMiddleware = void 0;
+const vr_models_1 = require("vr-models");
+const response_utils_1 = require("../utils/response.utils");
+const idempotencyMiddleware = async (req, res, next) => {
+    // Skip for GET requests
+    if (req.method === "GET") {
+        return next();
+    }
+    const idempotencyKey = req.headers["idempotency-key"];
+    if (!idempotencyKey) {
+        return (0, response_utils_1.sendErrorResponse)(res, "Idempotency-Key header is required", 400);
+    }
+    // Validate UUID format
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    if (!uuidRegex.test(idempotencyKey)) {
+        return (0, response_utils_1.sendErrorResponse)(res, "Idempotency-Key must be a valid UUID", 400);
+    }
+    try {
+        const existing = await vr_models_1.IdempotencyRecord.findOne({
+            where: { key: idempotencyKey },
+        });
+        if (existing && existing.isValid()) {
+            const response = existing.getResponse();
+            return res.status(response?.statusCode || 200).json(response?.body);
+        }
+        if (existing && existing.isExpired()) {
+            await vr_models_1.IdempotencyRecord.invalidate(idempotencyKey);
+        }
+        // Store original response methods
+        const originalJson = res.json.bind(res);
+        const originalStatus = res.status.bind(res);
+        res.json = function (body) {
+            res.locals.responseBody = body;
+            return originalJson(body);
+        };
+        res.status = function (code) {
+            res.locals.statusCode = code;
+            return originalStatus(code);
+        };
+        req.idempotencyKey = idempotencyKey;
+        next();
+    }
+    catch (error) {
+        console.error("Idempotency middleware error:", error);
+        next(error);
+    }
+};
+exports.idempotencyMiddleware = idempotencyMiddleware;
+// Store response after completion
+const storeIdempotencyResponse = async (req, res, next) => {
+    if (req.method === "GET" || !req.idempotencyKey) {
+        return next();
+    }
+    try {
+        const expiresAt = new Date();
+        expiresAt.setHours(expiresAt.getHours() + 24);
+        await vr_models_1.IdempotencyRecord.create({
+            key: req.idempotencyKey,
+            requestMethod: req.method,
+            requestPath: req.path,
+            requestParams: req.body,
+            responseStatusCode: res.locals.statusCode || 200,
+            responseBody: res.locals.responseBody || {},
+            expiresAt, // Add this
+        });
+    }
+    catch (error) {
+        console.error("Failed to store idempotency record:", error);
+    }
+    next();
+};
+exports.storeIdempotencyResponse = storeIdempotencyResponse;

package/dist/validations/admin.devicePayment.validations.d.ts

@@ -43,47 +43,47 @@ export declare const listPlansSchema: z.ZodObject<{
         sortBy: z.ZodOptional<z.ZodEnum<["createdAt", "updatedAt", "nextInstallmentDueAt", "paidAmount", "outstandingAmount"]>>;
         sortOrder: z.ZodOptional<z.ZodEnum<["ASC", "DESC"]>>;
     }, "strip", z.ZodTypeAny, {
-        page: number;
         limit: number;
-        status?: "ACTIVE" | "DEFAULTED" | "COMPLETED" | "CANCELLED" | undefined;
-        userId?: string | undefined;
+        page: number;
         search?: string | undefined;
+        userId?: string | undefined;
+        status?: "ACTIVE" | "DEFAULTED" | "COMPLETED" | "CANCELLED" | undefined;
         sortBy?: "createdAt" | "updatedAt" | "paidAmount" | "outstandingAmount" | "nextInstallmentDueAt" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
         deviceId?: string | undefined;
         isOverdue?: "true" | "false" | undefined;
     }, {
-        status?: "ACTIVE" | "DEFAULTED" | "COMPLETED" | "CANCELLED" | undefined;
+        search?: string | undefined;
+        limit?: string | undefined;
         userId?: string | undefined;
+        status?: "ACTIVE" | "DEFAULTED" | "COMPLETED" | "CANCELLED" | undefined;
         page?: string | undefined;
-        limit?: string | undefined;
-        search?: string | undefined;
         sortBy?: "createdAt" | "updatedAt" | "paidAmount" | "outstandingAmount" | "nextInstallmentDueAt" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
         deviceId?: string | undefined;
         isOverdue?: "true" | "false" | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     query: {
-        page: number;
         limit: number;
-        status?: "ACTIVE" | "DEFAULTED" | "COMPLETED" | "CANCELLED" | undefined;
-        userId?: string | undefined;
+        page: number;
         search?: string | undefined;
+        userId?: string | undefined;
+        status?: "ACTIVE" | "DEFAULTED" | "COMPLETED" | "CANCELLED" | undefined;
         sortBy?: "createdAt" | "updatedAt" | "paidAmount" | "outstandingAmount" | "nextInstallmentDueAt" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
         deviceId?: string | undefined;
         isOverdue?: "true" | "false" | undefined;
     };
 }, {
     query: {
-        status?: "ACTIVE" | "DEFAULTED" | "COMPLETED" | "CANCELLED" | undefined;
+        search?: string | undefined;
+        limit?: string | undefined;
         userId?: string | undefined;
+        status?: "ACTIVE" | "DEFAULTED" | "COMPLETED" | "CANCELLED" | undefined;
         page?: string | undefined;
-        limit?: string | undefined;
-        search?: string | undefined;
         sortBy?: "createdAt" | "updatedAt" | "paidAmount" | "outstandingAmount" | "nextInstallmentDueAt" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
         deviceId?: string | undefined;
         isOverdue?: "true" | "false" | undefined;
     };
@@ -192,25 +192,25 @@ export declare const limitedUpdateSchema: z.ZodObject<{
         pricingId: string;
     }>;
 }, "strip", z.ZodTypeAny, {
-    params: {
-        id: string;
-    };
     body: {
         userId: string;
         productId: string;
         deviceIds: string[];
         pricingId: string;
     };
-}, {
     params: {
         id: string;
     };
+}, {
     body: {
         userId: string;
         productId: string;
         deviceIds: string[];
         pricingId: string;
     };
+    params: {
+        id: string;
+    };
 }>;
 export declare const recordPaymentSchema: z.ZodObject<{
     params: z.ZodObject<{
@@ -237,25 +237,25 @@ export declare const recordPaymentSchema: z.ZodObject<{
         providerReference?: string | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    params: {
-        id: string;
-    };
     body: {
         amount: number;
         provider: "mtn_momo" | "airtel_money";
         metadata?: Record<string, any> | undefined;
         providerReference?: string | undefined;
     };
-}, {
     params: {
         id: string;
     };
+}, {
     body: {
         amount: number;
         provider: "mtn_momo" | "airtel_money";
         metadata?: Record<string, any> | undefined;
         providerReference?: string | undefined;
     };
+    params: {
+        id: string;
+    };
 }>;
 export declare const deletePlanSchema: z.ZodObject<{
     params: z.ZodObject<{

package/dist/validations/admin.devices.validations.d.ts

@@ -65,23 +65,23 @@ export declare const updateDeviceSchema: z.ZodObject<{
         dedicatedUser?: "RIDER" | "PASSENGER" | "N/A" | null | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    params: {
-        id: string;
-    };
     body: {
         status?: "locked" | "unlocked" | "disabled" | undefined;
         serialNumber?: string | undefined;
         dedicatedUser?: "RIDER" | "PASSENGER" | "N/A" | null | undefined;
     };
-}, {
     params: {
         id: string;
     };
+}, {
     body: {
         status?: "locked" | "unlocked" | "disabled" | undefined;
         serialNumber?: string | undefined;
         dedicatedUser?: "RIDER" | "PASSENGER" | "N/A" | null | undefined;
     };
+    params: {
+        id: string;
+    };
 }>;
 export declare const getDeviceSchema: z.ZodObject<{
     params: z.ZodObject<{
@@ -113,23 +113,23 @@ export declare const getDevicesSchema: z.ZodObject<{
         sortBy: z.ZodOptional<z.ZodEnum<["serialNumber", "status", "createdAt", "updatedAt"]>>;
         sortOrder: z.ZodOptional<z.ZodEnum<["ASC", "DESC"]>>;
     }, "strip", z.ZodTypeAny, {
+        search?: string | undefined;
+        limit?: number | undefined;
         status?: "locked" | "unlocked" | "disabled" | undefined;
         page?: number | undefined;
-        limit?: number | undefined;
-        search?: string | undefined;
-        sortBy?: "status" | "createdAt" | "updatedAt" | "serialNumber" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortBy?: "createdAt" | "updatedAt" | "status" | "serialNumber" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
         productId?: string | undefined;
         dedicatedUser?: "RIDER" | "PASSENGER" | "N/A" | undefined;
         isPermanentlyUnlocked?: "true" | "false" | undefined;
         isAssigned?: "true" | "false" | undefined;
     }, {
+        search?: string | undefined;
+        limit?: string | undefined;
         status?: "locked" | "unlocked" | "disabled" | undefined;
         page?: string | undefined;
-        limit?: string | undefined;
-        search?: string | undefined;
-        sortBy?: "status" | "createdAt" | "updatedAt" | "serialNumber" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortBy?: "createdAt" | "updatedAt" | "status" | "serialNumber" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
         productId?: string | undefined;
         dedicatedUser?: "RIDER" | "PASSENGER" | "N/A" | undefined;
         isPermanentlyUnlocked?: "true" | "false" | undefined;
@@ -137,12 +137,12 @@ export declare const getDevicesSchema: z.ZodObject<{
     }>;
 }, "strip", z.ZodTypeAny, {
     query: {
+        search?: string | undefined;
+        limit?: number | undefined;
         status?: "locked" | "unlocked" | "disabled" | undefined;
         page?: number | undefined;
-        limit?: number | undefined;
-        search?: string | undefined;
-        sortBy?: "status" | "createdAt" | "updatedAt" | "serialNumber" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortBy?: "createdAt" | "updatedAt" | "status" | "serialNumber" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
         productId?: string | undefined;
         dedicatedUser?: "RIDER" | "PASSENGER" | "N/A" | undefined;
         isPermanentlyUnlocked?: "true" | "false" | undefined;
@@ -150,12 +150,12 @@ export declare const getDevicesSchema: z.ZodObject<{
     };
 }, {
     query: {
+        search?: string | undefined;
+        limit?: string | undefined;
         status?: "locked" | "unlocked" | "disabled" | undefined;
         page?: string | undefined;
-        limit?: string | undefined;
-        search?: string | undefined;
-        sortBy?: "status" | "createdAt" | "updatedAt" | "serialNumber" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortBy?: "createdAt" | "updatedAt" | "status" | "serialNumber" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
         productId?: string | undefined;
         dedicatedUser?: "RIDER" | "PASSENGER" | "N/A" | undefined;
         isPermanentlyUnlocked?: "true" | "false" | undefined;
@@ -242,19 +242,19 @@ export declare const disableDeviceSchema: z.ZodObject<{
         reason: string;
     }>;
 }, "strip", z.ZodTypeAny, {
-    params: {
-        id: string;
-    };
     body: {
         reason: string;
     };
-}, {
     params: {
         id: string;
     };
+}, {
     body: {
         reason: string;
     };
+    params: {
+        id: string;
+    };
 }>;
 export declare const makePermanentSchema: z.ZodObject<{
     params: z.ZodObject<{

package/dist/validations/appSpecs.validations.d.ts

@@ -616,9 +616,6 @@ export declare const updateAppSpecsSchema: z.ZodObject<{
         sentryDsn?: string | null | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    params: {
-        id: string;
-    };
     body: {
         appName?: string | undefined;
         appShortName?: string | null | undefined;
@@ -695,10 +692,10 @@ export declare const updateAppSpecsSchema: z.ZodObject<{
         facebookPixelId?: string | null | undefined;
         sentryDsn?: string | null | undefined;
     };
-}, {
     params: {
         id: string;
     };
+}, {
     body: {
         appName?: string | undefined;
         appShortName?: string | null | undefined;
@@ -775,6 +772,9 @@ export declare const updateAppSpecsSchema: z.ZodObject<{
         facebookPixelId?: string | null | undefined;
         sentryDsn?: string | null | undefined;
     };
+    params: {
+        id: string;
+    };
 }>;
 export declare const listAppSpecsSchema: z.ZodObject<{
     query: z.ZodObject<{
@@ -785,37 +785,37 @@ export declare const listAppSpecsSchema: z.ZodObject<{
         sortBy: z.ZodOptional<z.ZodEnum<["version", "createdAt", "updatedAt"]>>;
         sortOrder: z.ZodOptional<z.ZodEnum<["ASC", "DESC"]>>;
     }, "strip", z.ZodTypeAny, {
-        page: number;
         limit: number;
-        isActive?: "true" | "false" | undefined;
+        page: number;
         search?: string | undefined;
+        isActive?: "true" | "false" | undefined;
         sortBy?: "createdAt" | "updatedAt" | "version" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
     }, {
+        search?: string | undefined;
+        limit?: string | undefined;
         isActive?: "true" | "false" | undefined;
         page?: string | undefined;
-        limit?: string | undefined;
-        search?: string | undefined;
         sortBy?: "createdAt" | "updatedAt" | "version" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     query: {
-        page: number;
         limit: number;
-        isActive?: "true" | "false" | undefined;
+        page: number;
         search?: string | undefined;
+        isActive?: "true" | "false" | undefined;
         sortBy?: "createdAt" | "updatedAt" | "version" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
     };
 }, {
     query: {
+        search?: string | undefined;
+        limit?: string | undefined;
         isActive?: "true" | "false" | undefined;
         page?: string | undefined;
-        limit?: string | undefined;
-        search?: string | undefined;
         sortBy?: "createdAt" | "updatedAt" | "version" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
     };
 }>;
 export declare const getAppSpecsSchema: z.ZodObject<{

package/dist/validations/appeals.validations.d.ts

@@ -15,19 +15,19 @@ export declare const submitBanAppealSchema: z.ZodObject<{
         appealReason: string;
     }>;
 }, "strip", z.ZodTypeAny, {
-    params: {
-        banId: string;
-    };
     body: {
         appealReason: string;
     };
-}, {
     params: {
         banId: string;
     };
+}, {
     body: {
         appealReason: string;
     };
+    params: {
+        banId: string;
+    };
 }>;
 export declare const submitSuspensionAppealSchema: z.ZodObject<{
     params: z.ZodObject<{
@@ -45,17 +45,17 @@ export declare const submitSuspensionAppealSchema: z.ZodObject<{
         appealReason: string;
     }>;
 }, "strip", z.ZodTypeAny, {
-    params: {
-        suspensionId: string;
-    };
     body: {
         appealReason: string;
     };
-}, {
     params: {
         suspensionId: string;
     };
+}, {
     body: {
         appealReason: string;
     };
+    params: {
+        suspensionId: string;
+    };
 }>;

package/dist/validations/auth.validations.d.ts

@@ -89,30 +89,30 @@ export declare const registerSchema: z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         firstName: string;
         lastName: string;
-        phoneNumber: string;
         password: string;
+        phoneNumber: string;
         email?: string | undefined;
     }, {
         firstName: string;
         lastName: string;
-        phoneNumber: string;
         password: string;
+        phoneNumber: string;
         email?: string | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     body: {
         firstName: string;
         lastName: string;
-        phoneNumber: string;
         password: string;
+        phoneNumber: string;
         email?: string | undefined;
     };
 }, {
     body: {
         firstName: string;
         lastName: string;
-        phoneNumber: string;
         password: string;
+        phoneNumber: string;
         email?: string | undefined;
     };
 }>;
@@ -135,17 +135,17 @@ export declare const riderLoginSchema: z.ZodObject<{
         phoneNumber: string;
         nationalId: string;
     };
+    query?: {} | undefined;
     params?: {} | undefined;
     headers?: {} | undefined;
-    query?: {} | undefined;
 }, {
     body: {
         phoneNumber: string;
         nationalId: string;
     };
+    query?: {} | undefined;
     params?: {} | undefined;
     headers?: {} | undefined;
-    query?: {} | undefined;
 }>;
 export declare const requestOtpSchema: z.ZodObject<{
     body: z.ZodObject<{

package/dist/validations/bans.validations.d.ts

@@ -32,19 +32,19 @@ export declare const getUserRestrictionsSchema: z.ZodObject<{
         includeResolved?: "true" | "false" | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    params: {
-        userId: string;
-    };
     query: {
         includeResolved?: "true" | "false" | undefined;
     };
-}, {
     params: {
         userId: string;
     };
+}, {
     query: {
         includeResolved?: "true" | "false" | undefined;
     };
+    params: {
+        userId: string;
+    };
 }>;
 export declare const createBanSchema: z.ZodObject<{
     params: z.ZodObject<{
@@ -65,19 +65,19 @@ export declare const createBanSchema: z.ZodObject<{
         isPermanent?: boolean | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    params: {
-        userId: string;
-    };
     body: {
         reason: string;
         isPermanent: boolean;
     };
-}, {
     params: {
         userId: string;
     };
+}, {
     body: {
         reason: string;
         isPermanent?: boolean | undefined;
     };
+    params: {
+        userId: string;
+    };
 }>;

package/dist/validations/devicePaymentPlan.validations.d.ts

@@ -7,33 +7,33 @@ export declare const listUserPaymentPlansSchema: z.ZodObject<{
         sortBy: z.ZodOptional<z.ZodEnum<["createdAt", "updatedAt", "nextInstallmentDueAt", "status"]>>;
         sortOrder: z.ZodOptional<z.ZodEnum<["ASC", "DESC"]>>;
     }, "strip", z.ZodTypeAny, {
-        page: number;
         limit: number;
+        page: number;
         status?: "ACTIVE" | "DEFAULTED" | "COMPLETED" | "CANCELLED" | undefined;
-        sortBy?: "status" | "createdAt" | "updatedAt" | "nextInstallmentDueAt" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortBy?: "createdAt" | "updatedAt" | "status" | "nextInstallmentDueAt" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
     }, {
+        limit?: string | undefined;
         status?: "ACTIVE" | "DEFAULTED" | "COMPLETED" | "CANCELLED" | undefined;
         page?: string | undefined;
-        limit?: string | undefined;
-        sortBy?: "status" | "createdAt" | "updatedAt" | "nextInstallmentDueAt" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortBy?: "createdAt" | "updatedAt" | "status" | "nextInstallmentDueAt" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     query: {
-        page: number;
         limit: number;
+        page: number;
         status?: "ACTIVE" | "DEFAULTED" | "COMPLETED" | "CANCELLED" | undefined;
-        sortBy?: "status" | "createdAt" | "updatedAt" | "nextInstallmentDueAt" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortBy?: "createdAt" | "updatedAt" | "status" | "nextInstallmentDueAt" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
     };
 }, {
     query: {
+        limit?: string | undefined;
         status?: "ACTIVE" | "DEFAULTED" | "COMPLETED" | "CANCELLED" | undefined;
         page?: string | undefined;
-        limit?: string | undefined;
-        sortBy?: "status" | "createdAt" | "updatedAt" | "nextInstallmentDueAt" | undefined;
-        sortOrder?: "ASC" | "DESC" | undefined;
+        sortBy?: "createdAt" | "updatedAt" | "status" | "nextInstallmentDueAt" | undefined;
+        sortOrder?: "DESC" | "ASC" | undefined;
     };
 }>;
 export declare const getUserPaymentPlanSchema: z.ZodObject<{