A self-hosted UPI & COD payment gateway with zero per-transaction platform fees, universal JavaScript checkout integration, dynamic QR payments, WhatsApp OTP authentication, and automated payment verification.
JavaScript
fix(android,security): enforce package allowlist, fix Java method signature, rebuild APK and publish SHA-256 (#61)
ArunGupta1526cfec0e4f04bf
diff --git a/README.md b/README.mdindex 9d73b48..6f0a115 100644--- a/README.md+++ b/README.md@@ -517,7 +517,7 @@ YOUPI PG confirms payments without expensive commercial banking APIs using a triSUCCESS CONFIRMED```-1. **Android Observer App:** Install [`apps/android-observer-app/youpi-sms-gateway.apk`](apps/android-observer-app/youpi-sms-gateway.apk) on any secondary Android smartphone with the receiving bank SIM. Scan the pairing QR code in Merchant Admin to establish an encrypted HMAC link.+1. **Android Observer App:** Install [`apps/android-observer-app/youpi-sms-gateway.apk`](apps/android-observer-app/youpi-sms-gateway.apk) (Certified SHA-256: `959218223e75da4784744c16afaf7bc121cff377dff04f041875237042f51601`) on any secondary Android smartphone with the receiving bank SIM. Scan the pairing QR code in Merchant Admin to establish an encrypted HMAC link.2. **Gmail Observer:** Connect your bank-registered Google account using standard OAuth2 credentials.<details><summary><b>🔍 View Verified Indian Bank Domains & RBI <code>.bank.in</code> Registry</b></summary>diff --git a/apps/android-observer-app/__tests__/android-observer.test.js b/apps/android-observer-app/__tests__/android-observer.test.jsindex 73cb8d9..f59161e 100644--- a/apps/android-observer-app/__tests__/android-observer.test.js+++ b/apps/android-observer-app/__tests__/android-observer.test.js@@ -94,4 +94,30 @@ describe('Android Payment Observer Integration Tests', () => {const updated = apiInstance.app.context.sessionRepo.findById(session.id);assert.equal(updated.status, PaymentStatus.SUCCESS);});++ test('Issue #61: rejects notification observation when rawNotification has missing or empty package', async () => {+ const resWithoutPkg = await driver.submitObservation({+ amount: '100.00',+ receivingAccountId: '00000000-0000-0000-0000-000000000002',+ utr: 'UTR-MISSING-PKG',+ notificationText: 'Payment of ₹100 received from user@bank on UPI',+ package: ''+ });++ assert.equal(resWithoutPkg.status, 400);+ assert.match(resWithoutPkg.body.error, /must specify a valid package name/);+ });++ test('Issue #61: rejects notification observation from untrusted/unallowed package name', async () => {+ const resUntrusted = await driver.submitObservation({+ amount: '100.00',+ receivingAccountId: '00000000-0000-0000-0000-000000000002',+ utr: 'UTR-UNTRUSTED-PKG',+ notificationText: 'Payment of ₹100 received from fake@bank on FakeApp',+ package: 'com.attacker.fake.banking'+ });++ assert.equal(resUntrusted.status, 400);+ assert.match(resUntrusted.body.error, /Untrusted Android notification package/);+ });});diff --git a/apps/android-observer-app/app/src/main/java/com/youpi/observer/ApiClient.java b/apps/android-observer-app/app/src/main/java/com/youpi/observer/ApiClient.javaindex 7d7c292..deea0a4 100644--- a/apps/android-observer-app/app/src/main/java/com/youpi/observer/ApiClient.java+++ b/apps/android-observer-app/app/src/main/java/com/youpi/observer/ApiClient.java@@ -132,7 +132,7 @@ public class ApiClient {return false;}- public boolean sendObservation(long amountPaise, double amount, String bankRef, String senderVpa, String title, String text) {+ public boolean sendObservation(long amountPaise, double amount, String bankRef, String senderVpa, String title, String text, String packageName) {if (!isPaired()) return false;String deviceId = prefs.getString("device_id", null);@@ -145,6 +145,9 @@ public class ApiClient {JSONObject raw = new JSONObject();raw.put("title", title != null ? title : "");raw.put("text", text != null ? text : "");+ if (packageName != null && !packageName.isEmpty()) {+ raw.put("package", packageName);+ }JSONObject json = new JSONObject();json.put("deviceId", deviceId);@@ -167,6 +170,10 @@ public class ApiClient {return false;}+ public boolean sendObservation(long amountPaise, double amount, String bankRef, String senderVpa, String title, String text) {+ return sendObservation(amountPaise, amount, bankRef, senderVpa, title, text, null);+ }+public void unpair() {prefs.edit().remove("device_id").remove("signing_key").apply();}diff --git a/apps/android-observer-app/app/src/main/java/com/youpi/observer/PaymentNotificationListenerService.java b/apps/android-observer-app/app/src/main/java/com/youpi/observer/PaymentNotificationListenerService.javaindex e662eaf..cd763f0 100644--- a/apps/android-observer-app/app/src/main/java/com/youpi/observer/PaymentNotificationListenerService.java+++ b/apps/android-observer-app/app/src/main/java/com/youpi/observer/PaymentNotificationListenerService.java@@ -16,31 +16,46 @@ public class PaymentNotificationListenerService extends NotificationListenerServprivate static final String TAG = "YoupiNotifListener";private ApiClient apiClient;+ // Generated from packages/common/src/upi-providers.js - Single Source of Truthprivate static final Set<String> ALLOWED_BANKING_PACKAGES = new HashSet<>(Arrays.asList(- "com.google.android.apps.nbu.paisa.user",- "com.phonepe.app",- "net.one97.paytm",- "in.org.npci.upiapp",- "in.amazon.mShop.android.shopping",- "com.dreamplug.androidapp",- "com.freecharge.android",- "com.mobikwik_new",- "com.fampay.in",- "com.sbi.upi",- "com.sbi.lotusintouch",- "com.hdfcbank.payzapp",- "com.snapwork.hdfc",- "com.csam.icici.bank.imobile","com.axis.mobile",- "com.msf.kbank.mobile","com.bankofbaroda.mconnect",- "com.idfcfirstbank.optimus",- "com.infrasofttech.indianbank",+ "com.bankofbaroda.upi","com.canarabank.mobility",- "com.infrasoft.uboi",+ "com.csam.icici.bank.imobile",+ "com.dreamplug.androidapp",+ "com.epifi.paisa",+ "com.fampay.in","com.fedmobile",+ "com.fisglobal.bandhanupi.app",+ "com.freecharge.android","com.google.android.apps.messaging",- "com.samsung.android.messaging"+ "com.google.android.apps.nbu.paisa.user",+ "com.hdfcbank.payzapp",+ "com.icicibank.pockets",+ "com.idfcfirstbank.optimus",+ "com.infrasoft.uboi",+ "com.infrasofttech.indianbank",+ "com.mgs.induspsp",+ "com.mobikwik_new",+ "com.msf.kbank.mobile",+ "com.myairtelapp",+ "com.nextbillion.groww",+ "com.phonepe.app",+ "com.samsung.android.messaging",+ "com.samsung.android.spay",+ "com.sbi.lotusintouch",+ "com.sbi.upi",+ "com.snapwork.hdfc",+ "com.tatadigital.tcp",+ "com.truecaller",+ "com.upi.axispay",+ "in.amazon.mshop.android.shopping",+ "in.gokiwi.kiwitpap",+ "in.org.npci.upiapp",+ "indwin.c3.shareapp",+ "money.jupiter",+ "net.one97.paytm"));private static final Pattern AMOUNT_PATTERN = Pattern.compile("(?:Rs\\.?|INR|₹)\\s*([0-9,]+(?:\\.[0-9]{1,2})?)", Pattern.CASE_INSENSITIVE);diff --git a/apps/android-observer-app/driver.js b/apps/android-observer-app/driver.jsindex e106875..f6964e1 100644--- a/apps/android-observer-app/driver.js+++ b/apps/android-observer-app/driver.js@@ -84,10 +84,10 @@ export class AndroidObserverDriver {observedAt: (obs.observedAt instanceof Date ? obs.observedAt : new Date(obs.observedAt || Date.now())).toISOString(),bankReferenceNumber: obs.utr,senderVpa: obs.senderVpa,- rawNotification: {- title: 'Payment Received',+ rawNotification: obs.rawNotification !== undefined ? obs.rawNotification : {+ title: obs.notificationTitle || 'Payment Received',text: obs.notificationText || `Received Rs ${obs.amount} via UPI`,- package: 'com.phonepe.app'+ package: obs.package !== undefined ? obs.package : 'com.phonepe.app'}};diff --git a/apps/android-observer-app/youpi-sms-gateway.apk b/apps/android-observer-app/youpi-sms-gateway.apkindex 3b0e824..5a2c4a3 100644Binary files a/apps/android-observer-app/youpi-sms-gateway.apk and b/apps/android-observer-app/youpi-sms-gateway.apk differdiff --git a/apps/android-observer-app/youpi-sms-gateway.apk.sha256 b/apps/android-observer-app/youpi-sms-gateway.apk.sha256new file mode 100644index 0000000..fb40cd2--- /dev/null+++ b/apps/android-observer-app/youpi-sms-gateway.apk.sha256@@ -0,0 +1 @@+959218223e75da4784744c16afaf7bc121cff377dff04f041875237042f51601 youpi-sms-gateway.apkdiff --git a/apps/merchant-admin/public/youpi-sms-gateway.apk b/apps/merchant-admin/public/youpi-sms-gateway.apkindex 3b0e824..5a2c4a3 100644Binary files a/apps/merchant-admin/public/youpi-sms-gateway.apk and b/apps/merchant-admin/public/youpi-sms-gateway.apk differdiff --git a/apps/merchant-admin/public/youpi-sms-gateway.apk.sha256 b/apps/merchant-admin/public/youpi-sms-gateway.apk.sha256new file mode 100644index 0000000..fb40cd2--- /dev/null+++ b/apps/merchant-admin/public/youpi-sms-gateway.apk.sha256@@ -0,0 +1 @@+959218223e75da4784744c16afaf7bc121cff377dff04f041875237042f51601 youpi-sms-gateway.apkdiff --git a/apps/payment-api/public/youpi-sms-gateway.apk b/apps/payment-api/public/youpi-sms-gateway.apkindex 3b0e824..5a2c4a3 100644Binary files a/apps/payment-api/public/youpi-sms-gateway.apk and b/apps/payment-api/public/youpi-sms-gateway.apk differdiff --git a/apps/payment-api/public/youpi-sms-gateway.apk.sha256 b/apps/payment-api/public/youpi-sms-gateway.apk.sha256new file mode 100644index 0000000..fb40cd2--- /dev/null+++ b/apps/payment-api/public/youpi-sms-gateway.apk.sha256@@ -0,0 +1 @@+959218223e75da4784744c16afaf7bc121cff377dff04f041875237042f51601 youpi-sms-gateway.apkdiff --git a/apps/payment-api/src/__tests__/gateway-hardening-invariants.test.js b/apps/payment-api/src/__tests__/gateway-hardening-invariants.test.jsindex 0893072..f40b3fa 100644--- a/apps/payment-api/src/__tests__/gateway-hardening-invariants.test.js+++ b/apps/payment-api/src/__tests__/gateway-hardening-invariants.test.js@@ -410,6 +410,37 @@ describe('Gateway Hardening & Invariant Protection Test Suite (#23, #25, #26, #2assert.match(res.body.error, /Untrusted Android notification package/);});+ test('Issue #61: Android observer rejects observations when rawNotification is missing package parameter', async () => {+ const deviceId = 'test-android-device-pkg-1';+ const signingKey = '0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef';+ const timestamp = Date.now().toString();+ const payloadObj = {+ deviceId,+ amount: '500.00',+ amountPaise: '50000',+ observedAt: new Date().toISOString(),+ rawNotification: {+ title: 'Payment Received',+ text: 'Received Rs 500 via UPI'+ }+ };+ const bodyStr = JSON.stringify(payloadObj);+ const { generateHmac } = await import('@youpi/common');+ const signature = generateHmac(`${bodyStr}:${timestamp}`, signingKey);++ const res = await request('/api/v1/pollers/android/events', {+ method: 'POST',+ headers: {+ 'X-Timestamp': timestamp,+ 'X-Signature': signature+ },+ body: bodyStr+ });++ assert.equal(res.status, 400);+ assert.match(res.body.error, /must specify a valid package name in rawNotification\.package/);+ });+test('Issue #9: findByMobile strictly matches exact numbers without unanchored LIKE injection', async () => {const customerRepo = apiInstance.app.context.customerRepo;const targetMobile = '9876500001';diff --git a/apps/payment-api/src/routes/pollers.routes.js b/apps/payment-api/src/routes/pollers.routes.jsindex 4df12f0..799f4e4 100644--- a/apps/payment-api/src/routes/pollers.routes.js+++ b/apps/payment-api/src/routes/pollers.routes.js@@ -4,7 +4,7 @@ import path from 'node:path';import { fileURLToPath } from 'node:url';import { HttpServer } from '../server.js';import { ObservationNormalizer, BankSmsParser, BankEmailParser, generateQrSvg } from '@youpi/core';-import { toRupeesString, toPaise, verifyHmac, resolveRuntimeUrls, resolveSecret, safeEqual, hasBearer, getObserverToken, findUpiProviderByPackage } from '@youpi/common';+import { toRupeesString, toPaise, verifyHmac, resolveRuntimeUrls, resolveSecret, safeEqual, hasBearer, getObserverToken, isAllowedNotificationPackage } from '@youpi/common';import { isAdminRequest } from '../auth-guard.js';const __filename = fileURLToPath(import.meta.url);@@ -304,27 +304,19 @@ export function registerPollerRoutes(server, ctx) {let senderVpa = body.senderVpa;let observedAt = body.observedAt ? new Date(body.observedAt) : new Date();- // Security Invariant (Issue #24): Validate Android notification package name if notification origin- const notificationPackage = body.rawNotification?.package ? String(body.rawNotification.package).trim().toLowerCase() : null;- if (notificationPackage) {- const isKnownUpi = Boolean(findUpiProviderByPackage(notificationPackage));- const KNOWN_NOTIFICATION_PACKAGES = new Set([- 'com.google.android.apps.messaging',- 'com.samsung.android.messaging',- 'com.fampay.in',- 'com.sbi.lotusintouch',- 'com.snapwork.hdfc',- 'com.csam.icici.bank.imobile',- 'com.axis.mobile',- 'com.msf.kbank.mobile',- 'com.bankofbaroda.mconnect',- 'com.idfcfirstbank.optimus',- 'com.infrasofttech.indianbank',- 'com.canarabank.mobility',- 'com.infrasoft.uboi',- 'com.fedmobile'- ]);- if (!isKnownUpi && !KNOWN_NOTIFICATION_PACKAGES.has(notificationPackage)) {+ // Security Invariant (Issues #24, #61): Validate Android notification package name if notification origin+ if (body.rawNotification) {+ const rawPkg = body.rawNotification.package;+ if (!rawPkg || typeof rawPkg !== 'string' || !rawPkg.trim()) {+ HttpServer.json(res, 400, {+ accepted: false,+ error: 'Android notification observation must specify a valid package name in rawNotification.package'+ });+ return;+ }++ const notificationPackage = rawPkg.trim().toLowerCase();+ if (!isAllowedNotificationPackage(notificationPackage)) {HttpServer.json(res, 400, {accepted: false,error: `Untrusted Android notification package: ${notificationPackage}`diff --git a/docs/OBSERVERS_SETUP.md b/docs/OBSERVERS_SETUP.mdindex b5bd30e..a12f8b3 100644--- a/docs/OBSERVERS_SETUP.md+++ b/docs/OBSERVERS_SETUP.md@@ -98,6 +98,18 @@ The engine supports root domains and alert subdomains (e.g. `alerts.hdfcbank.net5. Tap **Pair with Merchant Gateway**. The device will receive its permanent `deviceId` and `signingKey` stored in `EncryptedSharedPreferences`.6. Grant Notification Listener Access in Android System Settings.+### Binary Verification & Checksum+Operators can verify the cryptographic integrity and authenticity of `youpi-sms-gateway.apk` before sideloading onto merchant Android devices:++- **Target Binary**: `apps/android-observer-app/youpi-sms-gateway.apk` (also mirrored at `/youpi-sms-gateway.apk` on Admin and Payment API)+- **SHA-256 Checksum**: `959218223e75da4784744c16afaf7bc121cff377dff04f041875237042f51601`+- **Verification Command**:+ ```bash+ shasum -a 256 apps/android-observer-app/youpi-sms-gateway.apk+ # Or check against the companion checksum file:+ shasum -a 256 -c apps/android-observer-app/youpi-sms-gateway.apk.sha256+ ```+---## Method 3: Google Messages / SMS Observerdiff --git a/package.json b/package.jsonindex c0756de..32a8eb4 100644--- a/package.json+++ b/package.json@@ -20,6 +20,8 @@"test": "node scripts/test-all.js","test:all": "node scripts/test-all.js","test:acceptance": "node --test scripts/production-infrastructure.test.js",+ "build:android:apk": "node scripts/build-android-apk.js",+ "sync:android-allowlist": "node scripts/sync-android-allowlist.js","typecheck": "tsc -b --noEmit"},"devDependencies": {diff --git a/packages/common/src/__tests__/common.test.js b/packages/common/src/__tests__/common.test.jsindex 117b8dc..b457e7a 100644--- a/packages/common/src/__tests__/common.test.js+++ b/packages/common/src/__tests__/common.test.js@@ -19,6 +19,8 @@ import {getUpiProviders,findUpiProviderByPackage,findUpiProviderById,+ ALLOWED_NOTIFICATION_PACKAGES,+ isAllowedNotificationPackage,calculateObservationFingerprint} from '../index.js';@@ -194,6 +196,27 @@ describe('@youpi/common Unit Tests', () => {packages.add(p.packageName);}});++ test('validates unified ALLOWED_NOTIFICATION_PACKAGES and isAllowedNotificationPackage', () => {+ assert.ok(Array.isArray(ALLOWED_NOTIFICATION_PACKAGES));+ assert.ok(ALLOWED_NOTIFICATION_PACKAGES.length >= 38);++ // Verify essential UPI and banking packages are included+ assert.equal(isAllowedNotificationPackage('com.phonepe.app'), true);+ assert.equal(isAllowedNotificationPackage('com.google.android.apps.nbu.paisa.user'), true);+ assert.equal(isAllowedNotificationPackage('net.one97.paytm'), true);+ assert.equal(isAllowedNotificationPackage('com.google.android.apps.messaging'), true);+ assert.equal(isAllowedNotificationPackage('com.sbi.lotusintouch'), true);++ // Case-insensitivity and trim handling+ assert.equal(isAllowedNotificationPackage(' COM.PHONEPE.APP '), true);++ // Rejects spoofed or unlisted apps+ assert.equal(isAllowedNotificationPackage('com.attacker.fake.app'), false);+ assert.equal(isAllowedNotificationPackage(''), false);+ assert.equal(isAllowedNotificationPackage(null), false);+ assert.equal(isAllowedNotificationPackage(undefined), false);+ });});describe('Observation Fingerprinting', () => {diff --git a/packages/common/src/upi-providers.js b/packages/common/src/upi-providers.jsindex 177fcdc..d468816 100644--- a/packages/common/src/upi-providers.js+++ b/packages/common/src/upi-providers.js@@ -350,3 +350,40 @@ export function findUpiProviderById(id) {const clean = id.trim().toLowerCase();return UPI_PROVIDERS.find(p => p.id.toLowerCase() === clean);}++/**+ * Official companion SMS and banking notification application packages+ * permitted to deliver real-time credit payment observations to YOUPI Gateway.+ */+export const BANKING_AND_MESSAGING_PACKAGES = Object.freeze([+ 'com.google.android.apps.messaging',+ 'com.samsung.android.messaging',+ 'com.fampay.in',+ 'com.sbi.lotusintouch',+ 'com.hdfcbank.payzapp',+ 'com.bankofbaroda.mconnect',+ 'com.infrasofttech.indianbank',+ 'com.fedmobile'+]);++/**+ * Canonical unified allowlist of all verified UPI payment and banking observation packages.+ */+export const ALLOWED_NOTIFICATION_PACKAGES = Object.freeze(+ Array.from(new Set([+ ...UPI_PROVIDERS.map(p => p.packageName.toLowerCase()),+ ...BANKING_AND_MESSAGING_PACKAGES.map(p => p.toLowerCase())+ ])).sort()+);++/**+ * Verifies whether a given Android package identifier is an authorized banking/UPI provider.+ * @param {string} packageName+ * @returns {boolean}+ */+export function isAllowedNotificationPackage(packageName) {+ if (!packageName || typeof packageName !== 'string') return false;+ const clean = packageName.trim().toLowerCase();+ return ALLOWED_NOTIFICATION_PACKAGES.includes(clean);+}+diff --git a/packages/common/src/upi-providers.ts b/packages/common/src/upi-providers.tsindex a3b98af..ed81915 100644--- a/packages/common/src/upi-providers.ts+++ b/packages/common/src/upi-providers.ts@@ -363,3 +363,38 @@ export function findUpiProviderById(id?: string): UpiProvider | undefined {const clean = id.trim().toLowerCase();return UPI_PROVIDERS.find(p => p.id.toLowerCase() === clean);}++/**+ * Official companion SMS and banking notification application packages+ * permitted to deliver real-time credit payment observations to YOUPI Gateway.+ */+export const BANKING_AND_MESSAGING_PACKAGES: readonly string[] = Object.freeze([+ 'com.google.android.apps.messaging',+ 'com.samsung.android.messaging',+ 'com.fampay.in',+ 'com.sbi.lotusintouch',+ 'com.hdfcbank.payzapp',+ 'com.bankofbaroda.mconnect',+ 'com.infrasofttech.indianbank',+ 'com.fedmobile'+]);++/**+ * Canonical unified allowlist of all verified UPI payment and banking observation packages.+ */+export const ALLOWED_NOTIFICATION_PACKAGES: readonly string[] = Object.freeze(+ Array.from(new Set([+ ...UPI_PROVIDERS.map(p => p.packageName.toLowerCase()),+ ...BANKING_AND_MESSAGING_PACKAGES.map(p => p.toLowerCase())+ ])).sort()+);++/**+ * Verifies whether a given Android package identifier is an authorized banking/UPI provider.+ */+export function isAllowedNotificationPackage(packageName?: string): boolean {+ if (!packageName || typeof packageName !== 'string') return false;+ const clean = packageName.trim().toLowerCase();+ return ALLOWED_NOTIFICATION_PACKAGES.includes(clean);+}+diff --git a/scripts/build-android-apk.js b/scripts/build-android-apk.jsindex 011d9b4..57ea0ec 100644--- a/scripts/build-android-apk.js+++ b/scripts/build-android-apk.js@@ -1,7 +1,9 @@import fs from 'node:fs';import path from 'node:path';+import crypto from 'node:crypto';import { execSync } from 'node:child_process';import { fileURLToPath } from 'node:url';+import { syncAndroidAllowlist } from './sync-android-allowlist.js';const __filename = fileURLToPath(import.meta.url);const __dirname = path.dirname(__filename);@@ -96,6 +98,10 @@ const BIN_DIR = path.join(WORK_DIR, 'bin');fs.mkdirSync(BIN_DIR, { recursive: true });try {+ // 0. Synchronize banking package allowlist from packages/common/src/upi-providers.js into Java service+ console.log('🔄 [0/6] Synchronizing Android banking package allowlist from @youpi/common...');+ syncAndroidAllowlist();+// 1. Compile Java Source Code into Bytecode (.class)console.log('📦 [1/6] Compiling Java source files with javac...');const LIBS_DIR = path.resolve(APP_DIR, 'libs');@@ -192,9 +198,10 @@ try {});console.log(' ✅ Verification Report:\n' + verifyOutput.trim().split('\n').map(l => ' ' + l).join('\n'));- // 6. Copy final APK to all distribution endpoints- console.log('🚚 [6/6] Distributing final APK to app portals...');+ // 6. Copy final APK to all distribution endpoints & compute cryptographic checksum+ console.log('🚚 [6/6] Distributing final APK to app portals and calculating SHA-256...');const apkBuffer = fs.readFileSync(signedApk);+ const sha256 = crypto.createHash('sha256').update(apkBuffer).digest('hex');const targets = [path.resolve(REPO_ROOT, 'apps/android-observer-app/youpi-sms-gateway.apk'),path.resolve(REPO_ROOT, 'apps/payment-api/public/youpi-sms-gateway.apk'),@@ -205,10 +212,15 @@ try {const dir = path.dirname(t);if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });fs.writeFileSync(t, apkBuffer);+ fs.writeFileSync(`${t}.sha256`, `${sha256} youpi-sms-gateway.apk\n`, 'utf8');console.log(` 🎉 Saved signed installable APK: ${t} (${apkBuffer.length.toLocaleString()} bytes)`);+ console.log(` Checksum saved: ${t}.sha256`);}- console.log('\n✨ Android APK compilation and signing completed successfully!');+ console.log(`\n========================================================`);+ console.log(`🔑 Certified APK SHA-256: ${sha256}`);+ console.log(`========================================================`);+ console.log('\n✨ Android APK compilation, signing, and verification completed successfully!');} finally {try {process.chdir(REPO_ROOT);diff --git a/scripts/sync-android-allowlist.js b/scripts/sync-android-allowlist.jsnew file mode 100644index 0000000..c89d9e2--- /dev/null+++ b/scripts/sync-android-allowlist.js@@ -0,0 +1,48 @@+import fs from 'node:fs';+import path from 'node:path';+import { fileURLToPath } from 'node:url';+import { ALLOWED_NOTIFICATION_PACKAGES } from '../packages/common/src/upi-providers.js';++const __filename = fileURLToPath(import.meta.url);+const __dirname = path.dirname(__filename);+const REPO_ROOT = path.resolve(__dirname, '..');++/**+ * Synchronizes the Android NotificationListener allowlist in Java with the+ * canonical list defined in packages/common/src/upi-providers.js.+ */+export function syncAndroidAllowlist() {+ const serviceFile = path.resolve(+ REPO_ROOT,+ 'apps/android-observer-app/app/src/main/java/com/youpi/observer/PaymentNotificationListenerService.java'+ );++ if (!fs.existsSync(serviceFile)) {+ throw new Error(`Target service file not found: ${serviceFile}`);+ }++ let content = fs.readFileSync(serviceFile, 'utf8');++ const javaArrayLines = ALLOWED_NOTIFICATION_PACKAGES+ .map((pkg, i) => ` "${pkg}"${i < ALLOWED_NOTIFICATION_PACKAGES.length - 1 ? ',' : ''}`)+ .join('\n');++ const replacement = ` // Generated from packages/common/src/upi-providers.js - Single Source of Truth+ private static final Set<String> ALLOWED_BANKING_PACKAGES = new HashSet<>(Arrays.asList(+${javaArrayLines}+ ));`;++ const regex = /(?:\/\/[^\n]*\n\s*)?private static final Set<String> ALLOWED_BANKING_PACKAGES = new HashSet<\>\(Arrays\.asList\([\s\S]*?\)\);/;+ if (!regex.test(content)) {+ throw new Error('Could not match ALLOWED_BANKING_PACKAGES block in PaymentNotificationListenerService.java');+ }++ content = content.replace(regex, replacement);+ fs.writeFileSync(serviceFile, content, 'utf8');+ console.log(`✅ Synchronized ${ALLOWED_NOTIFICATION_PACKAGES.length} banking & UPI packages into PaymentNotificationListenerService.java`);+ return ALLOWED_NOTIFICATION_PACKAGES.length;+}++if (process.argv[1] === fileURLToPath(import.meta.url)) {+ syncAndroidAllowlist();+}