@classytic/commerce-sdk 0.1.0

package/dist/payment-BRboLqvU.d.ts

@@ -0,0 +1,127 @@
+import { A as ApiResponse } from './api-factory-B_h4RKBm.js';
+
+type PaymentStatus = "pending" | "verified" | "failed" | "refunded" | "partially_refunded" | "cancelled";
+/**
+ * Transaction reference info
+ */
+interface TransactionEntity {
+    referenceModel: "Order";
+    referenceId: string;
+}
+/**
+ * Verification result returned from backend
+ */
+interface VerificationResult {
+    transactionId: string;
+    status: PaymentStatus;
+    amount: number;
+    category: string;
+    verifiedAt: string;
+    verifiedBy: string;
+    entity: TransactionEntity | null;
+}
+/**
+ * Reject result returned from backend
+ */
+interface RejectResult {
+    transactionId: string;
+    status: "failed";
+    failedAt: string;
+    failureReason: string;
+}
+/**
+ * Verify payment request payload
+ */
+interface VerifyPaymentPayload {
+    /** Transaction ID (MongoDB ObjectId) */
+    transactionId: string;
+    /** Optional verification notes */
+    notes?: string;
+}
+/**
+ * Reject payment request payload
+ */
+interface RejectPaymentPayload {
+    /** Transaction ID (MongoDB ObjectId) */
+    transactionId: string;
+    /** Reason for rejection */
+    reason: string;
+}
+
+interface FetchOptions {
+    cache?: RequestCache;
+    revalidate?: number;
+    tags?: string[];
+}
+/**
+ * Payment API for admin payment management
+ *
+ * Manual Payment Verification Flow:
+ * 1. Customer places order → Transaction created with status 'pending'
+ * 2. Customer pays via bKash/Nagad/bank transfer/cash
+ * 3. Admin verifies payment via verifyPayment() endpoint
+ * 4. Backend updates transaction to 'verified'
+ * 5. Order status auto-updates to 'confirmed', payment status to 'verified'
+ *
+ * Endpoints:
+ * - POST /webhooks/payments/manual/verify - Verify pending payment (superadmin)
+ * - POST /webhooks/payments/manual/reject - Reject pending payment (superadmin)
+ */
+declare class PaymentApi {
+    private baseUrl;
+    /**
+     * Verify a manual payment (Admin/Superadmin only)
+     * POST /webhooks/payments/manual/verify
+     *
+     * Use this when admin confirms a customer's manual payment
+     * (bKash, Nagad, bank transfer, cash, etc.)
+     *
+     * After verification:
+     * - Transaction status → 'verified'
+     * - Order payment status → 'verified'
+     * - Order status → 'confirmed' (if was 'pending')
+     *
+     * @example
+     * const result = await paymentApi.verifyPayment({
+     *   token: adminToken,
+     *   data: {
+     *     transactionId: '507f1f77bcf86cd799439011',
+     *     notes: 'Verified bKash payment TrxID: ABC123'
+     *   }
+     * });
+     */
+    verifyPayment({ token, data, options, }: {
+        token: string;
+        data: VerifyPaymentPayload;
+        options?: FetchOptions;
+    }): Promise<ApiResponse<VerificationResult>>;
+    /**
+     * Reject a manual payment (Admin/Superadmin only)
+     * POST /webhooks/payments/manual/reject
+     *
+     * Use this when admin rejects a customer's payment claim
+     * (invalid reference, insufficient amount, fraud, etc.)
+     *
+     * After rejection:
+     * - Transaction status → 'failed'
+     * - Order payment status → 'failed'
+     * - Reason recorded in transaction
+     *
+     * @example
+     * const result = await paymentApi.rejectPayment({
+     *   token: adminToken,
+     *   data: {
+     *     transactionId: '507f1f77bcf86cd799439011',
+     *     reason: 'Invalid bKash TrxID - payment not found'
+     *   }
+     * });
+     */
+    rejectPayment({ token, data, options, }: {
+        token: string;
+        data: RejectPaymentPayload;
+        options?: FetchOptions;
+    }): Promise<ApiResponse<RejectResult>>;
+}
+declare const paymentApi: PaymentApi;
+
+export { PaymentApi as P, type RejectResult as R, type TransactionEntity as T, type VerificationResult as V, type VerifyPaymentPayload as a, type RejectPaymentPayload as b, paymentApi as p };

package/dist/payments/index.d.ts

@@ -0,0 +1,55 @@
+import { a as VerifyPaymentPayload, V as VerificationResult, b as RejectPaymentPayload, R as RejectResult } from '../payment-BRboLqvU.js';
+export { P as PaymentApi, T as TransactionEntity, p as paymentApi } from '../payment-BRboLqvU.js';
+import '../api-factory-B_h4RKBm.js';
+
+interface UsePaymentActionsReturn {
+    verifyPayment: (data: VerifyPaymentPayload) => Promise<VerificationResult>;
+    isVerifying: boolean;
+    rejectPayment: (data: RejectPaymentPayload) => Promise<RejectResult>;
+    isRejecting: boolean;
+    isLoading: boolean;
+}
+
+/**
+ * Payment verification actions for admin
+ *
+ * Manual Payment Verification Flow:
+ * 1. Customer places order → Transaction created with status 'pending'
+ * 2. Customer pays via bKash/Nagad/bank transfer/cash
+ * 3. Admin verifies payment via verifyPayment()
+ * 4. Backend updates transaction to 'verified'
+ * 5. Order status auto-updates to 'confirmed', payment status to 'verified'
+ *
+ * @param token - Auth token (admin/superadmin)
+ *
+ * @example
+ * ```tsx
+ * function PaymentVerifier({ transaction }) {
+ *   const { verifyPayment, rejectPayment, isLoading } = usePaymentActions(token);
+ *
+ *   const handleVerify = async () => {
+ *     await verifyPayment({
+ *       transactionId: transaction._id,
+ *       notes: 'Verified bKash payment TrxID: ABC123',
+ *     });
+ *   };
+ *
+ *   const handleReject = async () => {
+ *     await rejectPayment({
+ *       transactionId: transaction._id,
+ *       reason: 'Invalid bKash TrxID - payment not found',
+ *     });
+ *   };
+ *
+ *   return (
+ *     <>
+ *       <Button onClick={handleVerify} disabled={isLoading}>Verify</Button>
+ *       <Button onClick={handleReject} disabled={isLoading}>Reject</Button>
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+declare function usePaymentActions(token: string): UsePaymentActionsReturn;
+
+export { RejectPaymentPayload, RejectResult, type UsePaymentActionsReturn, VerificationResult, VerifyPaymentPayload, usePaymentActions };

package/dist/payments/index.js

@@ -0,0 +1,6 @@
+"use client";
+export { PaymentApi, paymentApi, usePaymentActions } from '../chunk-ILQUH444.js';
+import '../chunk-U3XT35GZ.js';
+import '../chunk-VR36QVX2.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/payments/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}