@mohasinac/appkit 4.41.17 → 4.42.1

package/dist/contracts/payment.d.ts

@@ -1,5 +1,6 @@
 import type { JsonValue } from "../schemas/types";
 export interface PaymentOrder {
+    /** Our own order id — a merchant-order id for gateways that are order-keyed rather than payment-keyed (e.g. PhonePe). */
     id: string;
     amount: number;
     currency: string;
@@ -7,6 +8,14 @@ export interface PaymentOrder {
     receipt?: string;
     metadata?: Record<string, JsonValue>;
     createdAt: string;
+    /** The gateway's OWN order id, when distinct from `id` (PhonePe returns both its own `orderId` and echoes back our `merchantOrderId`). Optional — Razorpay's own id WAS `id`, so this stays unset for gateways where the two coincide. */
+    gatewayOrderId?: string;
+    /** URL the buyer's browser opens/embeds to complete payment (PhonePe's `redirectUrl`). Optional — gateways using a client-side modal with no hosted page (Razorpay) never set this. */
+    checkoutUrl?: string;
+    /** The gateway's own transaction id for the underlying payment attempt, when it has one distinct from `id`/`gatewayOrderId` (PhonePe's `paymentDetails[].transactionId`). */
+    transactionId?: string;
+    /** When this order/attempt expires, if the gateway reports one (PhonePe's `expireAt`). ISO-8601. */
+    expiresAt?: string;
 }
 export interface PaymentCapture {
     id: string;
@@ -15,6 +24,8 @@ export interface PaymentCapture {
     currency: string;
     status: "captured" | "failed";
     capturedAt: string;
+    /** The gateway's own transaction id for this capture attempt, when it has one distinct from `id`/`orderId` (PhonePe's `paymentDetails[].transactionId`). */
+    transactionId?: string;
 }
 export interface Refund {
     id: string;
@@ -27,11 +38,11 @@ export interface Refund {
 }
 /**
  * Payment gateway adapter contract. An abstract base class rather than a
- * plain interface so every provider (manual, Razorpay, and any future
+ * plain interface so every provider (manual, PhonePe, and any future
  * gateway) extends one shared type — adding a new provider is a subclass,
  * not a fresh reimplementation of the shape.
  *
- * Implemented by the manual provider (default), Razorpay, and their mocks.
+ * Implemented by the manual provider (default) and PhonePe.
  */
 export declare abstract class IPaymentProvider {
     /** Short discriminator used by admin dev tooling to confirm which provider is registered. */

package/dist/contracts/payment.js

@@ -2,11 +2,11 @@
 // --- Payment Contract -----------------------------------------------------
 /**
  * Payment gateway adapter contract. An abstract base class rather than a
- * plain interface so every provider (manual, Razorpay, and any future
+ * plain interface so every provider (manual, PhonePe, and any future
  * gateway) extends one shared type — adding a new provider is a subclass,
  * not a fresh reimplementation of the shape.
  *
- * Implemented by the manual provider (default), Razorpay, and their mocks.
+ * Implemented by the manual provider (default) and PhonePe.
  */
 export class IPaymentProvider {
 }

package/dist/core/integration-keys.d.ts

@@ -1,7 +1,11 @@
 export interface ResolvedKeys {
-    razorpayKeyId: string;
-    razorpayKeySecret: string;
-    razorpayWebhookSecret: string;
+    phonepeClientId: string;
+    phonepeClientSecret: string;
+    phonepeClientVersion: string;
+    /** "sandbox" | "production" */
+    phonepeEnvironment: string;
+    phonepeWebhookUsername: string;
+    phonepeWebhookPassword: string;
     resendApiKey: string;
     whatsappApiKey: string;
     whatsappPhoneNumberId: string;

package/dist/core/integration-keys.js

@@ -11,14 +11,17 @@
  *
  * Usage:
  *   const keys = await resolveKeys();
- *   const razorpay = new Razorpay({ key_id: keys.razorpayKeyId, key_secret: keys.razorpayKeySecret });
+ *   const client = StandardCheckoutClient.getInstance(keys.phonepeClientId, keys.phonepeClientSecret, Number(keys.phonepeClientVersion), env);
  */
 import { siteSettingsRepository } from "../repositories";
 import { normalizeError } from "../errors/normalize";
 const EMPTY_KEYS = {
-    razorpayKeyId: "",
-    razorpayKeySecret: "",
-    razorpayWebhookSecret: "",
+    phonepeClientId: "",
+    phonepeClientSecret: "",
+    phonepeClientVersion: "",
+    phonepeEnvironment: "",
+    phonepeWebhookUsername: "",
+    phonepeWebhookPassword: "",
     resendApiKey: "",
     whatsappApiKey: "",
     whatsappPhoneNumberId: "",
@@ -46,9 +49,12 @@ export async function resolveKeys() {
         void normalizeError(_err); // Firestore unavailable — fall through to env-based defaults for backward compatibility
     }
     const value = {
-        razorpayKeyId: db.razorpayKeyId || process.env.RAZORPAY_KEY_ID || "",
-        razorpayKeySecret: db.razorpayKeySecret || process.env.RAZORPAY_KEY_SECRET || "",
-        razorpayWebhookSecret: db.razorpayWebhookSecret || process.env.RAZORPAY_WEBHOOK_SECRET || "",
+        phonepeClientId: db.phonepeClientId || process.env.PHONEPE_CLIENT_ID || "",
+        phonepeClientSecret: db.phonepeClientSecret || process.env.PHONEPE_CLIENT_SECRET || "",
+        phonepeClientVersion: db.phonepeClientVersion || process.env.PHONEPE_CLIENT_VERSION || "1",
+        phonepeEnvironment: db.phonepeEnvironment || process.env.PHONEPE_ENVIRONMENT || "sandbox",
+        phonepeWebhookUsername: db.phonepeWebhookUsername || process.env.PHONEPE_WEBHOOK_USERNAME || "",
+        phonepeWebhookPassword: db.phonepeWebhookPassword || process.env.PHONEPE_WEBHOOK_PASSWORD || "",
         resendApiKey: db.resendApiKey || process.env.RESEND_API_KEY || "",
         whatsappApiKey: db.whatsappApiKey || process.env.WHATSAPP_API_KEY || "",
         whatsappPhoneNumberId: db.whatsappPhoneNumberId || process.env.WHATSAPP_PHONE_NUMBER_ID || "",

package/dist/core/money.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Rupee/paise conversion helpers — gateway-agnostic.
+ *
+ * Every online payment gateway this project has integrated (Razorpay,
+ * PhonePe) bills in paise (India's smallest currency unit), so these live
+ * outside any specific provider directory.
+ */
+/** Convert rupees (float) → paise (integer) for a gateway's amount field. */
+export declare function rupeesToPaise(rupees: number): number;
+/** Convert paise (integer) → rupees (float). */
+export declare function paiseToRupees(paise: number): number;

package/dist/core/money.js

@@ -0,0 +1,15 @@
+/**
+ * Rupee/paise conversion helpers — gateway-agnostic.
+ *
+ * Every online payment gateway this project has integrated (Razorpay,
+ * PhonePe) bills in paise (India's smallest currency unit), so these live
+ * outside any specific provider directory.
+ */
+/** Convert rupees (float) → paise (integer) for a gateway's amount field. */
+export function rupeesToPaise(rupees) {
+    return Math.round(rupees * 100);
+}
+/** Convert paise (integer) → rupees (float). */
+export function paiseToRupees(paise) {
+    return paise / 100;
+}

package/dist/errors/index.d.ts

@@ -9,7 +9,7 @@ export { AuthorizationError } from "./authorization-error";
 export { NotFoundError } from "./not-found-error";
 export { ConflictError } from "./conflict-error";
 export { DatabaseError } from "./database-error";
-export { RazorpayUnreachableError } from "./razorpay-unreachable";
+export { PaymentProviderUnreachableError } from "./payment-provider-unreachable";
 export { handleApiError, logError, isAppError } from "./error-handler";
 export { mapToHttpError, HTTP_ERROR_CODES, type MappedError, type HttpErrorCode, } from "./error-mapping";
 export { ERROR_DISPLAY_MAP, getErrorDisplay, toUserMessage, GENERIC_USER_MESSAGE, type ErrorDisplayEntry, } from "./error-display-map";

package/dist/errors/index.js

@@ -12,7 +12,7 @@ export { AuthorizationError } from "./authorization-error";
 export { NotFoundError } from "./not-found-error";
 export { ConflictError } from "./conflict-error";
 export { DatabaseError } from "./database-error";
-export { RazorpayUnreachableError } from "./razorpay-unreachable";
+export { PaymentProviderUnreachableError } from "./payment-provider-unreachable";
 // error-handler uses `next/server` — only import in server/API-route contexts
 export { handleApiError, logError, isAppError } from "./error-handler";
 // Code→HTTP mapper (server) — and the i18n / inline-field map (client-safe)

package/dist/errors/messages.d.ts

@@ -282,6 +282,7 @@ export declare const ERROR_MESSAGES: {
         readonly INSUFFICIENT_STOCK: "Insufficient stock for one or more items";
         readonly PAYMENT_FAILED: "Payment processing failed";
         readonly PAYMENT_DECLINED: "Payment was declined.";
+        readonly ORDER_PLACEMENT_IN_PROGRESS: "Your payment is still being confirmed — please wait a moment and refresh.";
         readonly PAYMENT_TRACKING_INIT_FAILED: "Failed to initialise payment tracking. Please check your order status.";
         readonly PAYMENT_TRACKING_CONNECTION_LOST: "Payment tracking connection lost. Please check your order status.";
         readonly PAYMENT_TRACKING_TIMED_OUT: "Payment confirmation timed out. Please check your order status.";

package/dist/errors/messages.js

@@ -306,6 +306,7 @@ export const ERROR_MESSAGES = {
         INSUFFICIENT_STOCK: "Insufficient stock for one or more items",
         PAYMENT_FAILED: "Payment processing failed",
         PAYMENT_DECLINED: "Payment was declined.",
+        ORDER_PLACEMENT_IN_PROGRESS: "Your payment is still being confirmed — please wait a moment and refresh.",
         PAYMENT_TRACKING_INIT_FAILED: "Failed to initialise payment tracking. Please check your order status.",
         PAYMENT_TRACKING_CONNECTION_LOST: "Payment tracking connection lost. Please check your order status.",
         PAYMENT_TRACKING_TIMED_OUT: "Payment confirmation timed out. Please check your order status.",

package/dist/errors/{razorpay-unreachable.d.ts → payment-provider-unreachable.d.ts}

@@ -1,4 +1,4 @@
 import { AppError } from "./base-error";
-export declare class RazorpayUnreachableError extends AppError {
+export declare class PaymentProviderUnreachableError extends AppError {
     constructor(message?: string, data?: unknown);
 }

package/dist/errors/{razorpay-unreachable.js → payment-provider-unreachable.js}

@@ -1,5 +1,5 @@
 import { AppError } from "./base-error";
-export class RazorpayUnreachableError extends AppError {
+export class PaymentProviderUnreachableError extends AppError {
     constructor(message = "Payment provider unreachable", data) {
         super(503, message, "UPSTREAM_UNAVAILABLE", data);
     }

package/dist/features/addresses/schemas/address-form.d.ts

@@ -34,13 +34,13 @@ export declare const addressFormSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     country: string;
     label: string;
-    isDefault: boolean;
     fullName: string;
     phone: string;
     addressLine1: string;
     city: string;
     state: string;
     postalCode: string;
+    isDefault: boolean;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }, {
@@ -58,13 +58,13 @@ export declare const addressFormSchema: z.ZodEffects<z.ZodObject<{
 }>, {
     country: string;
     label: string;
-    isDefault: boolean;
     fullName: string;
     phone: string;
     addressLine1: string;
     city: string;
     state: string;
     postalCode: string;
+    isDefault: boolean;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }, {
@@ -103,49 +103,49 @@ export declare const addressUpdateSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     country?: string | undefined;
     label?: string | undefined;
-    isDefault?: boolean | undefined;
     fullName?: string | undefined;
     phone?: string | undefined;
     addressLine1?: string | undefined;
     city?: string | undefined;
     state?: string | undefined;
     postalCode?: string | undefined;
+    isDefault?: boolean | undefined;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }, {
     country?: string | undefined;
     label?: string | undefined;
-    isDefault?: boolean | undefined;
     fullName?: string | undefined;
     phone?: string | undefined;
     addressLine1?: string | undefined;
     city?: string | undefined;
     state?: string | undefined;
     postalCode?: string | undefined;
+    isDefault?: boolean | undefined;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }>, {
     country?: string | undefined;
     label?: string | undefined;
-    isDefault?: boolean | undefined;
     fullName?: string | undefined;
     phone?: string | undefined;
     addressLine1?: string | undefined;
     city?: string | undefined;
     state?: string | undefined;
     postalCode?: string | undefined;
+    isDefault?: boolean | undefined;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }, {
     country?: string | undefined;
     label?: string | undefined;
-    isDefault?: boolean | undefined;
     fullName?: string | undefined;
     phone?: string | undefined;
     addressLine1?: string | undefined;
     city?: string | undefined;
     state?: string | undefined;
     postalCode?: string | undefined;
+    isDefault?: boolean | undefined;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }>;
@@ -177,7 +177,6 @@ export declare const adminAddressCreateSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     country: string;
     label: string;
-    isDefault: boolean;
     ownerId: string;
     ownerType: "user" | "store";
     fullName: string;
@@ -186,6 +185,7 @@ export declare const adminAddressCreateSchema: z.ZodEffects<z.ZodObject<{
     city: string;
     state: string;
     postalCode: string;
+    isDefault: boolean;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }, {
@@ -205,7 +205,6 @@ export declare const adminAddressCreateSchema: z.ZodEffects<z.ZodObject<{
 }>, {
     country: string;
     label: string;
-    isDefault: boolean;
     ownerId: string;
     ownerType: "user" | "store";
     fullName: string;
@@ -214,6 +213,7 @@ export declare const adminAddressCreateSchema: z.ZodEffects<z.ZodObject<{
     city: string;
     state: string;
     postalCode: string;
+    isDefault: boolean;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }, {
@@ -248,7 +248,6 @@ export declare const adminAddressUpdateSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     country?: string | undefined;
     label?: string | undefined;
-    isDefault?: boolean | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
     fullName?: string | undefined;
@@ -257,12 +256,12 @@ export declare const adminAddressUpdateSchema: z.ZodEffects<z.ZodObject<{
     city?: string | undefined;
     state?: string | undefined;
     postalCode?: string | undefined;
+    isDefault?: boolean | undefined;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }, {
     country?: string | undefined;
     label?: string | undefined;
-    isDefault?: boolean | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
     fullName?: string | undefined;
@@ -271,12 +270,12 @@ export declare const adminAddressUpdateSchema: z.ZodEffects<z.ZodObject<{
     city?: string | undefined;
     state?: string | undefined;
     postalCode?: string | undefined;
+    isDefault?: boolean | undefined;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }>, {
     country?: string | undefined;
     label?: string | undefined;
-    isDefault?: boolean | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
     fullName?: string | undefined;
@@ -285,12 +284,12 @@ export declare const adminAddressUpdateSchema: z.ZodEffects<z.ZodObject<{
     city?: string | undefined;
     state?: string | undefined;
     postalCode?: string | undefined;
+    isDefault?: boolean | undefined;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }, {
     country?: string | undefined;
     label?: string | undefined;
-    isDefault?: boolean | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
     fullName?: string | undefined;
@@ -299,6 +298,7 @@ export declare const adminAddressUpdateSchema: z.ZodEffects<z.ZodObject<{
     city?: string | undefined;
     state?: string | undefined;
     postalCode?: string | undefined;
+    isDefault?: boolean | undefined;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }>;
@@ -337,8 +337,6 @@ export declare const adminAddressPatchSchema: z.ZodEffects<z.ZodObject<{
     country?: string | undefined;
     label?: string | undefined;
     action?: "ban" | "approve_unban" | "reject_unban" | undefined;
-    isDefault?: boolean | undefined;
-    banReason?: string | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
     fullName?: string | undefined;
@@ -347,14 +345,14 @@ export declare const adminAddressPatchSchema: z.ZodEffects<z.ZodObject<{
     city?: string | undefined;
     state?: string | undefined;
     postalCode?: string | undefined;
+    isDefault?: boolean | undefined;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
+    banReason?: string | undefined;
 }, {
     country?: string | undefined;
     label?: string | undefined;
     action?: "ban" | "approve_unban" | "reject_unban" | undefined;
-    isDefault?: boolean | undefined;
-    banReason?: string | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
     fullName?: string | undefined;
@@ -363,14 +361,14 @@ export declare const adminAddressPatchSchema: z.ZodEffects<z.ZodObject<{
     city?: string | undefined;
     state?: string | undefined;
     postalCode?: string | undefined;
+    isDefault?: boolean | undefined;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
+    banReason?: string | undefined;
 }>, {
     country?: string | undefined;
     label?: string | undefined;
     action?: "ban" | "approve_unban" | "reject_unban" | undefined;
-    isDefault?: boolean | undefined;
-    banReason?: string | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
     fullName?: string | undefined;
@@ -379,14 +377,14 @@ export declare const adminAddressPatchSchema: z.ZodEffects<z.ZodObject<{
     city?: string | undefined;
     state?: string | undefined;
     postalCode?: string | undefined;
+    isDefault?: boolean | undefined;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
+    banReason?: string | undefined;
 }, {
     country?: string | undefined;
     label?: string | undefined;
     action?: "ban" | "approve_unban" | "reject_unban" | undefined;
-    isDefault?: boolean | undefined;
-    banReason?: string | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
     fullName?: string | undefined;
@@ -395,8 +393,10 @@ export declare const adminAddressPatchSchema: z.ZodEffects<z.ZodObject<{
     city?: string | undefined;
     state?: string | undefined;
     postalCode?: string | undefined;
+    isDefault?: boolean | undefined;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
+    banReason?: string | undefined;
 }>;
 export type AdminAddressPatchValues = z.infer<typeof adminAddressPatchSchema>;
 /**

package/dist/features/addresses/schemas/index.d.ts

@@ -41,7 +41,6 @@ export declare const addressFirestoreSchema: z.ZodObject<{
     updatedAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    isDefault: boolean;
     ownerId: string;
     ownerType: "user" | "store";
     fullName: string;
@@ -50,6 +49,7 @@ export declare const addressFirestoreSchema: z.ZodObject<{
     city: string;
     state: string;
     postalCode: string;
+    isDefault: boolean;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }, {
@@ -62,7 +62,6 @@ export declare const addressFirestoreSchema: z.ZodObject<{
     updatedAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    isDefault: boolean;
     ownerId: string;
     ownerType: "user" | "store";
     fullName: string;
@@ -71,6 +70,7 @@ export declare const addressFirestoreSchema: z.ZodObject<{
     city: string;
     state: string;
     postalCode: string;
+    isDefault: boolean;
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }>;