@school24/paymentjs-rn 1.6.0 → 1.7.0

package/dist/PaymentJS.js

@@ -37,7 +37,7 @@ exports.default = PaymentJS;
 const react_1 = __importStar(require("react"));
 const react_native_1 = require("react-native");
 const react_native_webview_1 = require("react-native-webview");
-// INTERNAL DEFAULTS (So Cherian doesn't have to pass them)
+// INTERNAL DEFAULTS
 const DEFAULT_PAGE_URL = "https://client.brandsyncstudio.com/paymentjs/payment-rn.html";
 const DEFAULT_LAMBDA_URL = "https://qb3epa62mry53z3woeiecuhpve0scpjb.lambda-url.ap-southeast-2.on.aws";
 const STORE_IDS = {
@@ -52,31 +52,42 @@ function normalizeBase(url) {
 }
 function PaymentJS(props) {
     const { 
-    // These now default to internal constants if not provided
+    // These default to internal constants if not provided by Cherian
     pageUrl = DEFAULT_PAGE_URL, lambdaUrl = DEFAULT_LAMBDA_URL, environment = "test", 
     // Auto-select store based on environment if store prop is missing
-    store = STORE_IDS[environment], mode = "pay", shopperReference = "", amount = 0, currency = "AUD", storePaymentMethod = false, ts, style, debug = false, onPaymentSuccess, onPaymentFailure, onEncryptSuccess, onEncryptFailure, onDebug, } = props;
+    store = STORE_IDS[environment], 
+    // Metadata for Logging & Dashboard
+    schoolId = "", orderId = "", mode = "pay", shopperReference = "", amount = 0, currency = "AUD", storePaymentMethod = false, ts, style, debug = false, onPaymentSuccess, onPaymentFailure, onEncryptSuccess, onEncryptFailure, onDebug, } = props;
     const finalUri = (0, react_1.useMemo)(() => {
         const params = new URLSearchParams();
+        // Core Config
         params.set("mode", mode);
         params.set("env", environment);
         params.set("baseUrl", normalizeBase(lambdaUrl));
         params.set("currency", currency);
-        // Use the auto-selected or provided store ID
+        // Merchant & Logging Context
         if (store)
             params.set("store", store);
+        if (schoolId)
+            params.set("schoolId", schoolId);
+        if (orderId)
+            params.set("orderId", orderId);
+        // Shopper & Payment Options
         if (shopperReference)
             params.set("shopperReference", shopperReference);
         params.set("storePaymentMethod", safeBoolString(storePaymentMethod));
         if (mode === "pay") {
             params.set("amount", String(amount !== null && amount !== void 0 ? amount : 0));
         }
+        // Cache buster for WebView refresh
         params.set("ts", String(ts !== null && ts !== void 0 ? ts : Date.now()));
         return `${pageUrl}?${params.toString()}`;
     }, [
         pageUrl,
         lambdaUrl,
         store,
+        schoolId,
+        orderId,
         mode,
         environment,
         shopperReference,
@@ -94,12 +105,19 @@ function PaymentJS(props) {
             const message = JSON.parse(raw);
             if (message.source !== "PaymentJS" || !message.event)
                 return;
+            if (message.event === "DEBUG") {
+                if (debug)
+                    console.log("💳 PaymentJS DEBUG:", message.payload);
+                onDebug === null || onDebug === void 0 ? void 0 : onDebug(message.payload);
+                return;
+            }
             switch (message.event) {
                 case "PAYMENT_SUCCESS":
                     onPaymentSuccess === null || onPaymentSuccess === void 0 ? void 0 : onPaymentSuccess(message.payload);
                     break;
                 case "PAYMENT_ERROR":
                 case "CONFIG_ERROR":
+                    // Receives the granular messages (Insufficient Funds, etc.) from Lambda
                     onPaymentFailure === null || onPaymentFailure === void 0 ? void 0 : onPaymentFailure(message.payload);
                     break;
                 case "ENCRYPT_SUCCESS":
@@ -108,17 +126,22 @@ function PaymentJS(props) {
                 case "ENCRYPT_ERROR":
                     onEncryptFailure === null || onEncryptFailure === void 0 ? void 0 : onEncryptFailure(message.payload);
                     break;
-                case "DEBUG":
+                default:
                     if (debug)
-                        console.log("DEBUG:", message.payload);
-                    onDebug === null || onDebug === void 0 ? void 0 : onDebug(message.payload);
+                        console.warn("Unknown PaymentJS event:", message.event);
                     break;
             }
         }
         catch (err) {
-            onPaymentFailure === null || onPaymentFailure === void 0 ? void 0 : onPaymentFailure({ message: "WebView Bridge Error", error: String(err) });
+            if (debug)
+                console.error("Failed to parse WebView message:", err);
+            onPaymentFailure === null || onPaymentFailure === void 0 ? void 0 : onPaymentFailure({
+                message: "WebView Bridge Error",
+                error: String(err),
+            });
         }
     }, [debug, onDebug, onPaymentSuccess, onPaymentFailure, onEncryptSuccess, onEncryptFailure]);
+    // Pre-flight validation
     const configError = (0, react_1.useMemo)(() => {
         if (mode === "pay") {
             if (!shopperReference)
@@ -130,8 +153,8 @@ function PaymentJS(props) {
     }, [mode, shopperReference, amount]);
     if (configError) {
         return (react_1.default.createElement(react_native_1.View, { style: [{ flex: 1, justifyContent: "center", padding: 16 }, style] },
-            react_1.default.createElement(react_native_1.Text, { style: { color: "red", textAlign: "center" } }, configError)));
+            react_1.default.createElement(react_native_1.Text, { style: { color: "red", textAlign: "center", fontWeight: "600" } }, configError)));
     }
     return (react_1.default.createElement(react_native_1.View, { style: [{ flex: 1, backgroundColor: "#fff" }, style] },
-        react_1.default.createElement(react_native_webview_1.WebView, { source: { uri: finalUri }, javaScriptEnabled: true, domStorageEnabled: true, originWhitelist: ["*"], onMessage: handleMessage })));
+        react_1.default.createElement(react_native_webview_1.WebView, { source: { uri: finalUri }, javaScriptEnabled: true, domStorageEnabled: true, originWhitelist: ["*"], onMessage: handleMessage, allowsBackForwardNavigationGestures: true, setSupportMultipleWindows: false })));
 }

package/dist/types.d.ts

@@ -23,16 +23,28 @@ export type PaymentJSProps = {
      */
     lambdaUrl?: string;
     /**
-     * Optional: The specific store ID for the merchant account.
+     * The specific store ID for the merchant account.
+     * If omitted, the library auto-selects based on environment.
      */
     store?: string;
+    /**
+     * NEW: The unique identifier for the specific school/location.
+     * Used for transaction logging and dashboard filtering.
+     */
+    schoolId?: string;
+    /**
+     * NEW: The unique identifier for the specific order.
+     * Used to track the payment against a specific basket/purchase.
+     */
+    orderId?: string;
     mode?: PaymentJSMode;
     environment?: PaymentJSEnvironment;
+    /** The unique identifier for the parent/customer */
     shopperReference?: string;
-    /** Required for pay mode (minor units) */
+    /** Required for pay mode (minor units, e.g., 1000 for $10.00) */
     amount?: number;
     currency?: string;
-    /** If true, ask Adyen to store the card */
+    /** If true, ask Adyen to store the card for future MIT payments */
     storePaymentMethod?: boolean;
     /** Extra cache buster */
     ts?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@school24/paymentjs-rn",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "React Native WebView wrapper for PaymentJS (Adyen)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",