@rkfl/transact-server 1.0.1

package/README.md

@@ -0,0 +1,174 @@
+# Rocketfuel SDK (Node.js)
+
+A secure and minimal Node.js SDK to interact with Rocketfuel payment APIs. (This SDK is for Node.js server-side usage.)
+
+## Installation
+
+```bash
+npm i @rkfl/transact-server
+```
+## Documentation
+Click here for more detailed [Documentation](https://rocketfuel-gitbook.gitbook.io/rocketfuel-sdks/)
+## Usage
+
+### Create order
+
+```ts
+import { Rocketfuel } from '@rocketfuel/plugin';
+
+const client = new Rocketfuel({
+  clientId: 'YOUR_ID',
+  clientSecret: 'YOUR_SECRET',
+  merchantId: 'YOUR_MERCHANT_ID',
+  domain: 'production' // or 'sandbox'
+});
+
+const orderData = {
+  amount: "10",
+  currency: "USD",
+  cart: [
+    {
+      id: "iphone_14_pro_max",
+      name: "iPhone 14 Pro Max",
+      price: "10",
+      quantity: 1
+    }
+  ],
+  customerInfo: {
+    name: "John Doe",
+    email: "john.doe@example.com"
+  },
+  customParameter: {
+    returnMethod: "GET",
+    params: [
+      {
+        name: "submerchant",
+        value: "mobilesale"
+      }
+    ]
+  },
+  merchant_id: '14ec584d-53af-476d-aacd-2b7f025cf21b'
+};
+
+const result = await client.createOrder(orderData);
+
+```
+
+### Transaction Lookup
+To check or confirm the transaction status using order id or Rocketfuel provided transaction id
+
+```
+
+async function checkTransaction(txId) {
+  try {
+    const result = await client.transactionLookup(txId, 'ORDERID');
+    console.log('Transaction Details:', result);
+    // Process the transaction details as needed
+  } catch (error) {
+    console.error('Error fetching transaction details:', error.message);
+  }
+}
+​
+// Example call:
+checkTransaction('12345ABC');
+```
+
+### Webook Verification
+Use this function to verify that a webhook is valid and trusted before processing its contents. It prevents spoofed requests, data tampering, and unauthorized events.
+This function returns true if the signature is valid, otherwise false.
+
+```
+
+function handleWebhook(req, res) {
+  const isValid = client.verifyWebhookSignature(req.body);
+​
+  if (!isValid) {
+    console.warn('Webhook signature verification failed');
+    return res.status(403).send('Invalid signature');
+  }
+​
+  const payload = JSON.parse(req.body.data.data);
+  console.log('Verified Webhook Payload:', payload);
+​
+  // Process your payload
+  res.status(200).send('Webhook received');
+}
+```
+
+## 📦 NPM Commands Documentation
+### 1. npm:login
+
+Logs you into your npm account from the terminal.
+You’ll be prompted for your npm username, password, and email.
+```
+npm run npm:login
+```
+Use this before your first publish or if you’re logged out.
+
+### 2. npm:publish
+Publishes the current package to npm with public access.
+The package name and version must be unique on npm.
+```
+npm run npm:publish
+```
+
+### 3. npm:patch
+Increments the patch version (last digit) in package.json by +1.
+Used for bug fixes or small improvements.
+```
+npm run npm:patch
+```
+Example Version Change:
+```
+1.0.9   → 1.0.10
+1.0.10  → 1.0.11
+```
+### 4. npm:minor
+Increments the minor version (middle digit) by +1 and resets patch to 0.
+Used for adding new features without breaking compatibility.
+```
+npm run npm:minor
+```
+Example Version Change:
+```
+1.0.5   → 1.1.0
+1.2.7   → 1.3.0
+```
+### 5. npm:major
+Increments the major version (first digit) by +1 and resets minor and patch to 0.
+Used for breaking changes or major redesigns.
+```
+npm run npm:major
+```
+Example Version Change:
+```
+1.4.8   → 2.0.0
+2.1.3   → 3.0.0
+```
+## 🚀 Recommended Workflow
+### Login once:
+```
+npm run npm:login
+```
+Make changes to your code.
+
+### Bump version:
+```
+npm run npm:patch
+```
+Minor:
+
+```
+npm run npm:minor
+```
+Major:
+```
+npm run npm:major
+```
+
+### Publish:
+```
+npm run npm:publish
+```
+## 📄 License
+MIT License © RocketFuel Blockchain, Inc.

package/dist/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const apiDomains: {
+    readonly production: "https://app.rocketfuel.inc/api";
+    readonly qa: "https://qa-app.rfdemo.co/api";
+    readonly preprod: "https://preprod-app.rocketdemo.net/api";
+    readonly sandbox: "https://app-sandbox.rocketfuel.inc/api";
+};
+export type Environment = keyof typeof apiDomains;

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import type { Environment } from './constants';
+export declare class Rocketfuel {
+    #private;
+    constructor({ clientId, clientSecret, merchantId, environment, }: {
+        clientId: string;
+        clientSecret: string;
+        merchantId: string;
+        environment: Environment;
+    });
+    createOrder(payload: Record<string, any>): Promise<any>;
+    transactionLookup(txId: string, type?: 'ORDERID' | 'TXID'): Promise<any>;
+    verifyWebhookSignature(body: any): boolean;
+}

package/dist/index.js

@@ -0,0 +1,2 @@
+import t from"crypto-js";import*as e from"crypto";const s={production:"https://app.rocketfuel.inc/api",qa:"https://qa-app.rfdemo.co/api",preprod:"https://preprod-app.rocketdemo.net/api",sandbox:"https://app-sandbox.rocketfuel.inc/api"};class r{#t;#e;#s;#r;#n=null;#a=null;constructor({clientId:t,clientSecret:e,merchantId:r,environment:n}){this.#t=t,this.#e=e,this.#s=r,this.#r=s[n||"production"]}#o(){const e=JSON.stringify({merchantId:this.#s,totop:""});return t.AES.encrypt(e,this.#e).toString()}#i(){const t={"Content-Type":"application/json"};return this.#n&&(t.Authorization=`Bearer ${this.#n}`),t}async#c(){const t={clientId:this.#t,encryptedPayload:this.#o()},e=await fetch(`${this.#r}/auth/generate-auth-token`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)});if(!e.ok)throw new Error(`Auth failed: ${e.status}`);const s=await e.json(),r=s?.result;if(!r?.access)throw new Error("Token missing in response");this.#n=r.access,this.#a=r.refresh}async#h(t,e,s=!0){const r=await fetch(t,e);if(403===r.status&&s){console.warn(`Received 403, refreshing token and retrying: ${t}`),await this.#c();const s={...e,headers:this.#i()};return this.#h(t,s,!1)}if(!r.ok)throw new Error(`Request failed: ${r.status}`);return r.json()}async createOrder(t){this.#n||await this.#c();const e=await this.#h(`${this.#r}/hosted-page`,{method:"POST",headers:this.#i(),body:JSON.stringify(t)});return{uuid:e?.result?.uuid}}async transactionLookup(t,e="ORDERID"){this.#n||await this.#c();const s=await this.#h(`${this.#r}/purchase/transactionLookup`,{method:"POST",headers:this.#i(),body:JSON.stringify({txId:t,type:e})});return s?.result}verifyWebhookSignature(t){try{const{data:{data:s},signature:r}=t,n=e.createVerify("RSA-SHA256");return n.update(s),n.verify("-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2e4stIYooUrKHVQmwztC\n/l0YktX6uz4bE1iDtA2qu4OaXx+IKkwBWa0hO2mzv6dAoawyzxa2jmN01vrpMkMj\nrB+Dxmoq7tRvRTx1hXzZWaKuv37BAYosOIKjom8S8axM1j6zPkX1zpMLE8ys3dUX\nFN5Dl/kBfeCTwGRV4PZjP4a+QwgFRzZVVfnpcRI/O6zhfkdlRah8MrAPWYSoGBpG\nCPiAjUeHO/4JA5zZ6IdfZuy/DKxbcOlt9H+z14iJwB7eVUByoeCE+Bkw+QE4msKs\naIn4xl9GBoyfDZKajTzL50W/oeoE1UcuvVfaULZ9DWnHOy6idCFH1WbYDxYYIWLi\nAQIDAQAB\n-----END PUBLIC KEY-----",r,"base64")}catch(t){return console.error("Signature verification failed:",t),!1}}}export{r as Rocketfuel};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@rkfl/transact-server",
+  "main": "./dist/index.js",
+  "type": "module",
+  "version": "1.0.1",
+  "scripts": {
+    "build": "rollup -c",
+    "npm:login": "npm login",
+    "npm:publish": "npm run build && npm publish --access public",
+    "npm:patch": "npm version patch",
+    "npm:minor": "npm version minor",
+    "npm:major": "npm version major",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "author": "Rocketfuel",
+  "license": "ISC",
+  "description": "Package for the node js server side. to create orders and do more",
+  "keywords": [
+    "rocketfuel",
+    "server",
+    "crypto",
+    "payments"
+  ],
+  "devDependencies": {
+    "@types/crypto-js": "^4.2.2",
+    "rollup": "^2.79.2",
+    "rollup-plugin-terser": "^7.0.2",
+    "rollup-plugin-typescript2": "^0.36.0",
+    "typescript": "^5.8.3"
+  },
+  "dependencies": {
+    "axios": "^1.11.0",
+    "crypto": "^1.0.1",
+    "crypto-js": "^4.2.0"
+  }
+}