npm - @spixter/ez-upi-flow - Versions diffs - 0.0.0-stage → 1.0.0 - Mend

@spixter/ez-upi-flow 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/dist/server.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import { UPIPaymentConfig, IntentUrls } from './types.js';
+export declare class UPIServerEngine {
+    private defaultUpi?;
+    private defaultName?;
+    constructor(defaults?: {
+        merchantUpi?: string;
+        merchantName?: string;
+    });
+    createSession(config: UPIPaymentConfig, ttlSeconds?: number): Promise<IntentUrls>;
+    isSessionActive(expiresAt: number): boolean;
+    validateUTRFormat(utr: string): boolean;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1D,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAS;gBAEjB,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;IAKzD,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,UAAU,GAAE,MAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAmD5F,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI3C,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG/C"}

package/dist/server.js ADDED Viewed

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UPIServerEngine = void 0;
+const qrcode_1 = __importDefault(require("qrcode"));
+const node_crypto_1 = require("node:crypto");
+class UPIServerEngine {
+    defaultUpi;
+    defaultName;
+    constructor(defaults) {
+        this.defaultUpi = defaults?.merchantUpi;
+        this.defaultName = defaults?.merchantName;
+    }
+    async createSession(config, ttlSeconds = 180) {
+        const upiId = config.merchantUpi || this.defaultUpi;
+        const name = config.merchantName || this.defaultName;
+        if (!upiId || !name) {
+            throw new Error('[upi-intent-flow] Merchant UPI ID aur Name mandatory hain.');
+        }
+        if (config.amount <= 0) {
+            throw new Error('[upi-intent-flow] Amount 0 se zyada hona chahiye.');
+        }
+        const formattedAmount = config.amount.toFixed(2);
+        const encodedName = encodeURIComponent(name);
+        const transactionNote = encodeURIComponent(config.note || `Order #${config.orderId}`);
+        const baseParams = `pa=${upiId}&pn=${encodedName}&am=${formattedAmount}&cu=INR&tr=${config.orderId}&tn=${transactionNote}`;
+        const rawIntent = `upi://pay?${baseParams}`;
+        const gpayIntent = `gpay://upi/pay?${baseParams}`;
+        const phonepeIntent = `phonepe://pay?${baseParams}`;
+        const paytmIntent = `paytmmp://pay?${baseParams}`;
+        const qrBase64 = await qrcode_1.default.toDataURL(rawIntent, {
+            errorCorrectionLevel: 'M',
+            margin: 1,
+            width: 260,
+        });
+        const now = Date.now();
+        const expiresAt = now + ttlSeconds * 1000;
+        const ip = config.clientIp || '0.0.0.0';
+        const ua = config.userAgent || 'unknown';
+        const sessionToken = (0, node_crypto_1.createHash)('sha256')
+            .update(`${config.orderId}|${ip}|${ua}|${(0, node_crypto_1.randomBytes)(8).toString('hex')}`)
+            .digest('hex');
+        return {
+            rawIntent,
+            gpayIntent,
+            phonepeIntent,
+            paytmIntent,
+            qrBase64,
+            orderId: config.orderId,
+            amount: config.amount,
+            sessionToken,
+            expiresAt,
+        };
+    }
+    isSessionActive(expiresAt) {
+        return Date.now() <= expiresAt;
+    }
+    validateUTRFormat(utr) {
+        return /^\d{12}$/.test(utr.trim());
+    }
+}
+exports.UPIServerEngine = UPIServerEngine;
+//# sourceMappingURL=server.js.map

package/dist/server.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAC5B,6CAAsD;AAGtD,MAAa,eAAe;IAClB,UAAU,CAAU;IACpB,WAAW,CAAU;IAE7B,YAAY,QAA0D;QACpE,IAAI,CAAC,UAAU,GAAG,QAAQ,EAAE,WAAW,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,QAAQ,EAAE,YAAY,CAAC;IAC5C,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,MAAwB,EAAE,aAAqB,GAAG;QAC3E,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,WAAW,CAAC;QAErD,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,IAAI,UAAU,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAEtF,MAAM,UAAU,GAAG,MAAM,KAAK,OAAO,WAAW,OAAO,eAAe,cAAc,MAAM,CAAC,OAAO,OAAO,eAAe,EAAE,CAAC;QAE3H,MAAM,SAAS,GAAG,aAAa,UAAU,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,kBAAkB,UAAU,EAAE,CAAC;QAClD,MAAM,aAAa,GAAG,iBAAiB,UAAU,EAAE,CAAC;QACpD,MAAM,WAAW,GAAG,iBAAiB,UAAU,EAAE,CAAC;QAElD,MAAM,QAAQ,GAAG,MAAM,gBAAM,CAAC,SAAS,CAAC,SAAS,EAAE;YACjD,oBAAoB,EAAE,GAAG;YACzB,MAAM,EAAE,CAAC;YACT,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,GAAG,GAAG,UAAU,GAAG,IAAI,CAAC;QAE1C,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC;QACxC,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,IAAI,SAAS,CAAC;QACzC,MAAM,YAAY,GAAG,IAAA,wBAAU,EAAC,QAAQ,CAAC;aACtC,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,IAAI,EAAE,IAAI,IAAA,yBAAW,EAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;aACzE,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjB,OAAO;YACL,SAAS;YACT,UAAU;YACV,aAAa;YACb,WAAW;YACX,QAAQ;YACR,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,YAAY;YACZ,SAAS;SACV,CAAC;IACJ,CAAC;IAEM,eAAe,CAAC,SAAiB;QACtC,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,SAAS,CAAC;IACjC,CAAC;IAEM,iBAAiB,CAAC,GAAW;QAClC,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;CACF;AAnED,0CAmEC"}

package/dist/types.d.ts ADDED Viewed

@@ -0,0 +1,34 @@
+export interface UPIPaymentConfig {
+    merchantUpi: string;
+    merchantName: string;
+    amount: number;
+    orderId: string;
+    note?: string;
+    clientIp?: string;
+    userAgent?: string;
+}
+export interface IntentUrls {
+    rawIntent: string;
+    gpayIntent: string;
+    phonepeIntent: string;
+    paytmIntent: string;
+    qrBase64: string;
+    orderId: string;
+    amount: number;
+    sessionToken: string;
+    expiresAt: number;
+}
+export interface ClientModalOptions {
+    packet: IntentUrls;
+    merchantName: string;
+    onSuccessClaim: (data: {
+        orderId: string;
+        utr: string;
+        sessionToken: string;
+    }) => void;
+    onCancel: (data: {
+        orderId: string;
+        reason: string;
+    }) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACvF,QAAQ,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC/D"}

package/dist/types.js ADDED Viewed

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json CHANGED Viewed

@@ -1,6 +1,51 @@
-{
-  "name": "@spixter/ez-upi-flow",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+    "name": "@spixter/ez-upi-flow",
+    "version": "1.0.0",
+    "description": "Zero-KYC direct UPI intent & dynamic QR payment flow with 3-minute strict TTL and back-trap protection.",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./server": {
+            "types": "./dist/server.d.ts",
+            "import": "./dist/server.js"
+        },
+        "./client": {
+            "types": "./dist/client.d.ts",
+            "import": "./dist/client.js"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "scripts": {
+        "build": "rimraf dist && tsc",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "upi",
+        "payments",
+        "gpay",
+        "phonepe",
+        "paytm",
+        "zero-kyc",
+        "qr-code",
+        "intent-flow"
+    ],
+    "author": "Shubh Gupta",
+    "license": "MIT",
+    "dependencies": {
+        "qrcode": "^1.5.4"
+    },
+    "devDependencies": {
+        "@types/node": "^22.0.0",
+        "@types/qrcode": "^1.5.5",
+        "rimraf": "^6.0.0",
+        "typescript": "^5.6.0"
+    }
+}

package/readme.md ADDED Viewed

@@ -0,0 +1,27 @@
+# ⚡ ez-upi-flow
+[![npm version](https://img.shields.io/npm/v/ez-upi-flow.svg?style=flat-square&color=059669)](https://www.npmjs.com/package/ez-upi-flow)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![Zero KYC](https://img.shields.io/badge/KYC-Zero%20Required-success?style=flat-square)](#)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-3178C6?style=flat-square)](#)
+> **Zero-KYC direct UPI intent & dynamic QR payment flow for indie builders and small businesses.**
+Accept UPI payments straight into your personal or merchant VPA (`GPay`, `PhonePe`, `Paytm`, `FamPay`) without paying a **2% gateway fee** or waiting days for merchant paperwork approval.
+---
+### ✨ Features
+- 🚀 **Zero KYC Onboarding:** No merchant portal registration. Plug in your UPI ID and start taking payments.
+- 📱 **Native Mobile Intent:** Automatically summons GPay, PhonePe, and Paytm app sheets directly on mobile browsers.
+- 🖥️ **Dynamic Desktop QR:** Renders high-contrast, locked-amount Base64 QR code for desktop browsers.
+- ⏱️ **Strict 3-Minute TTL:** Hard countdown timer releases stuck inventory if payment isn't completed.
+- 🛡️ **Anti-Back Navigation Trap:** Intercepts browser back clicks and tab closes to auto-cancel abandoned checkouts.
+---
+### 📦 Installation
+```bash
+npm install ez-upi-flow

package/README.md DELETED Viewed

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.