@dev_innovations_labs/phonepe-pg-sdk 1.0.0 → 1.0.1

package/README.md

@@ -0,0 +1,230 @@
+::: {align="center"}
+```{=html}
+<h1>
+```
+📱 PhonePe PG SDK
+```{=html}
+</h1>
+```
+```{=html}
+<h3>
+```
+@dev_innovations_labs/phonepe-pg-sdk
+```{=html}
+</h3>
+```
+```{=html}
+<p>
+```
+A unified PhonePe Payment Gateway SDK for
+`<b>`{=html}Node.js`</b>`{=html}, `<b>`{=html}React Web`</b>`{=html},
+and `<b>`{=html}React Native`</b>`{=html} using the latest Checkout v2
+APIs.
+```{=html}
+</p>
+```
+`<img src="https://img.shields.io/npm/v/@dev_innovations_labs/phonepe-pg-sdk?color=blue&style=for-the-badge" />`{=html}
+`<img src="https://img.shields.io/npm/dm/@dev_innovations_labs/phonepe-pg-sdk?style=for-the-badge" />`{=html}
+`<img src="https://img.shields.io/badge/PhonePe-PG%20SDK-purple?style=for-the-badge" />`{=html}
+:::
+
+------------------------------------------------------------------------
+
+# 🖼️ Screenshots
+
+### 🌐 Web Checkout
+
+![Web
+Checkout](https://dummyimage.com/800x400/000/fff&text=Web+Checkout+Preview)
+
+### 📱 React Native Checkout
+
+![React Native
+Checkout](https://dummyimage.com/800x400/333/fff&text=React+Native+WebView+Checkout)
+
+------------------------------------------------------------------------
+
+# 🚀 Features
+
+-   🔐 OAuth Token Generation (Checkout v2)
+-   💳 Initiate Payments (Web, Mobile, UPI, Cards)
+-   🔄 WebView Support for React Native
+-   🧪 Status Check API
+-   🌍 Sandbox & Production Environments
+-   🎯 TypeScript Fully Supported
+-   🧩 Multi-platform Unified SDK
+-   🧵 Auto-environment normalization
+
+------------------------------------------------------------------------
+
+# 📦 Installation
+
+``` bash
+npm install @dev_innovations_labs/phonepe-pg-sdk
+```
+
+------------------------------------------------------------------------
+
+# ⚙️ Environments
+
+  Input                          Interpreted As
+  ------------------------------ ----------------
+  production, Production, prod   production
+  sandbox, Sandbox, SANDBOX      sandbox
+
+------------------------------------------------------------------------
+
+# 📚 Usage
+
+------------------------------------------------------------------------
+
+## 🟦 1. Node.js Example
+
+``` ts
+import { PhonePeNode } from "@dev_innovations_labs/phonepe-pg-sdk";
+
+const phonepe = new PhonePeNode({
+  clientId: "YOUR_CLIENT_ID",
+  clientSecret: "YOUR_SECRET",
+  environment: "production"
+});
+
+const res = await phonepe.createPayment({
+  merchantId: "M123",
+  merchantOrderId: "uuid-123",
+  amount: 10000,
+  redirectUrl: "https://yourapp.com/redirect",
+  callbackUrl: "https://yourapp.com/callback"
+});
+
+console.log(res.redirectUrl);
+```
+
+------------------------------------------------------------------------
+
+## 🌐 2. React Web Example
+
+``` jsx
+import { PhonePeCheckoutWeb } from "@dev_innovations_labs/phonepe-pg-sdk";
+
+export default function Checkout() {
+  return (
+    <PhonePeCheckoutWeb
+      environment="sandbox"
+      clientId="YOUR_CLIENT_ID"
+      clientSecret="YOUR_SECRET"
+      request={{
+        merchantId: "M123",
+        merchantOrderId: "uuid-321",
+        amount: 10000,
+        redirectUrl: "https://yourapp.com/redirect",
+        callbackUrl: "https://yourapp.com/callback"
+      }}
+      onSuccess={(r) => console.log("Success", r)}
+      onError={(e) => console.log("Error", e)}
+    />
+  );
+}
+```
+
+------------------------------------------------------------------------
+
+## 📱 3. React Native Example
+
+``` jsx
+import { PhonePeCheckoutNative } from "@dev_innovations_labs/phonepe-pg-sdk/native";
+
+export default function App() {
+  return (
+    <PhonePeCheckoutNative
+      environment="production"
+      clientId="YOUR_CLIENT_ID"
+      clientSecret="YOUR_SECRET"
+      request={{
+        merchantId: "M123",
+        merchantOrderId: "uuid-xyz",
+        amount: 10000,
+        redirectUrl: "https://yourapp.com/redirect",
+        callbackUrl: "https://yourapp.com/callback"
+      }}
+      onSuccess={(data) => console.log("Success", data)}
+      onError={(e) => console.log("Error", e)}
+    />
+  );
+}
+```
+
+------------------------------------------------------------------------
+
+# 📡 Status API
+
+``` ts
+const status = await phonepe.checkStatus("uuid-1234");
+console.log(status);
+```
+
+------------------------------------------------------------------------
+
+# 📘 API Table
+
+  API                        Platform       Description
+  -------------------------- -------------- -------------------------------
+  `createPayment()`          Node/Web/RN    Initiates PhonePe Checkout v2
+  `checkStatus()`            Node           Checks transaction status
+  `PhonePeCheckoutWeb`       React Web      In-App iFrame Checkout
+  `PhonePeCheckoutNative`    React Native   Mobile WebView Checkout
+  `normalizeEnvironment()`   Internal       Normalizes env strings
+
+------------------------------------------------------------------------
+
+# 🧩 Folder Structure
+
+    src/
+      index.ts
+      native.ts
+      PhonePeNode.ts
+      PhonePeReact.tsx
+      PhonePeReactNative.tsx
+      utils.ts
+      types.ts
+    dist/
+
+------------------------------------------------------------------------
+
+# 🏗 Roadmap
+
+-   [ ] Add PhonePe payouts API
+-   [ ] Add checksum support for PG v1
+-   [ ] Add UI components for receipts
+-   [ ] Add webhooks helpers
+
+------------------------------------------------------------------------
+
+# 👨‍💻 Contributors
+
+  Name                    Role
+  ----------------------- ----------------
+  Dev Innovations Labs    Lead Developer
+  Open Source Community   Coming Soon
+
+------------------------------------------------------------------------
+
+# 📝 Changelog
+
+### v1.0.0
+
+-   Initial release\
+-   Multi-platform SDK\
+-   React Web + RN support\
+-   Token + Payment + Status APIs\
+-   Normalized environment handling
+
+------------------------------------------------------------------------
+
+# 📄 License
+
+MIT © Dev Innovations Labs
+
+```{=html}
+</div>
+```

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@dev_innovations_labs/phonepe-pg-sdk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
-
   "keywords": [
     "phonepe",
     "phonepe-pg",
@@ -17,15 +16,12 @@
     "typescript",
     "web-payments"
   ],
-
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
   "types": "dist/index.d.ts",
-
   "author": {
     "name": "Dev Innovations Labs"
   },
-
   "exports": {
     ".": {
       "import": "./dist/index.esm.js",
@@ -38,34 +34,28 @@
       "types": "./dist/native.d.ts"
     }
   },
-
   "scripts": {
     "build": "rollup -c"
   },
-
   "dependencies": {
     "axios": "^1.6.0",
     "uuid": "^9.0.0"
   },
-
   "peerDependencies": {
     "react": "*",
     "react-native": "*",
     "react-native-webview": "*"
   },
-
   "peerDependenciesMeta": {
     "react-native-webview": {
       "optional": true
     }
   },
-
   "devDependencies": {
     "typescript": "^5.3.3",
     "rollup": "^4.9.0",
     "rollup-plugin-typescript2": "^0.34.1"
   },
-
   "publishConfig": {
     "access": "public"
   }