meridianjs 0.2.5 → 0.2.8

package/dist/upi/index.js

@@ -0,0 +1,57 @@
+/**
+ * High-level helpers for UPI (Unified Payments Interface) — a uniquely Indian
+ * payment primitive layered on top of raw provider adapters (Setu, Decentro,
+ * BillDesk, CCAvenue, ...). These helpers operate purely on the UPI URI/VPA
+ * formats defined by NPCI; they don't call any provider API.
+ *
+ * Reference: NPCI UPI Linking Specification (`upi://pay?...` deep links) and
+ * the VPA format `<handle>@<psp-handle>`.
+ */
+// `<handle>@<psp-handle>`: handle allows letters, digits, and . _ - ;
+// the PSP handle must start with a letter and may contain letters, digits, . -
+const VPA_REGEX = /^[a-zA-Z0-9.\-_]{2,256}@[a-zA-Z][a-zA-Z0-9.\-]{1,64}$/;
+/**
+ * Validates a UPI Virtual Payment Address against NPCI's `handle@pspHandle`
+ * format. This is a syntactic check — it does not confirm the VPA is
+ * registered or resolvable; that requires a live lookup through a provider
+ * such as Setu or Decentro.
+ */
+export function validateVpa(vpa) {
+    if (typeof vpa !== "string")
+        return false;
+    return VPA_REGEX.test(vpa.trim());
+}
+/**
+ * Builds a `upi://pay` deep link per NPCI's UPI Linking Specification, suitable
+ * for opening a UPI app's payment screen pre-filled with the given details.
+ *
+ * Throws if `vpa` fails {@link validateVpa} or `amount` is not a positive,
+ * finite number — both would produce a deep link that UPI apps reject.
+ */
+export function createUpiDeepLink(options) {
+    if (!validateVpa(options.vpa)) {
+        throw new Error(`createUpiDeepLink: "${options.vpa}" is not a valid UPI VPA (expected handle@bank format)`);
+    }
+    if (options.amount !== undefined && (!Number.isFinite(options.amount) || options.amount <= 0)) {
+        throw new Error(`createUpiDeepLink: amount must be a positive finite number, received ${options.amount}`);
+    }
+    const params = [
+        ["pa", options.vpa.trim()],
+        ["cu", options.currency ?? "INR"],
+    ];
+    if (options.payeeName)
+        params.push(["pn", options.payeeName]);
+    if (options.amount !== undefined)
+        params.push(["am", options.amount.toFixed(2)]);
+    if (options.note)
+        params.push(["tn", options.note]);
+    if (options.transactionRef)
+        params.push(["tr", options.transactionRef]);
+    if (options.transactionId)
+        params.push(["tid", options.transactionId]);
+    if (options.merchantCode)
+        params.push(["mc", options.merchantCode]);
+    const query = params.map(([key, value]) => `${key}=${encodeURIComponent(value)}`).join("&");
+    return `upi://pay?${query}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/upi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/upi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,sEAAsE;AACtE,+EAA+E;AAC/E,MAAM,SAAS,GAAG,uDAAuD,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC;AAqBD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,uBAAuB,OAAO,CAAC,GAAG,wDAAwD,CAC3F,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC;QAC9F,MAAM,IAAI,KAAK,CACb,wEAAwE,OAAO,CAAC,MAAM,EAAE,CACzF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAA4B;QACtC,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;KAClC,CAAC;IACF,IAAI,OAAO,CAAC,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjF,IAAI,OAAO,CAAC,IAAI;QAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,IAAI,OAAO,CAAC,cAAc;QAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IACxE,IAAI,OAAO,CAAC,aAAa;QAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;IACvE,IAAI,OAAO,CAAC,YAAY;QAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAEpE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5F,OAAO,aAAa,KAAK,EAAE,CAAC;AAC9B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meridianjs",
-  "version": "0.2.5",
+  "version": "0.2.8",
   "description": "Meridian - A TypeScript-first SDK that enforces a single stable contract across all third-party API providers",
   "main": "dist/public.js",
   "types": "dist/public.d.ts",
@@ -13,35 +13,57 @@
     "./contract": {
       "types": "./dist/testing/contract.d.ts",
       "import": "./dist/testing/contract.js"
+    },
+    "./upi": {
+      "types": "./dist/upi/index.d.ts",
+      "import": "./dist/upi/index.js"
     }
   },
-  "files": ["dist", "README.md", "CHANGELOG.md", "LICENSE.md"],
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE.md"
+  ],
   "sideEffects": false,
   "scripts": {
     "build": "tsc",
     "typecheck": "tsc --noEmit",
     "test": "vitest",
     "test:watch": "vitest --watch",
+    "test:coverage": "vitest run --coverage",
     "lint": "biome check .",
+    "lint:ci": "biome ci .",
     "format": "biome format --write .",
+    "providers:list": "node scripts/list-providers.mjs --pretty",
     "prepublishOnly": "npm run build",
     "proxy": "node dist/proxy/cli.js",
     "proxy:build": "npm run build && npm run proxy",
     "example:swap": "vite-node examples/provider-swap/index.ts",
+    "example:reliability-lab": "npx vite-node examples/reliability-lab/index.ts",
     "test:contracts": "node scripts/test-contracts.mjs",
     "test:contracts:all": "node scripts/test-contracts.mjs",
-    "benchmark": "npx tsx benchmarks/pipeline-overhead.ts",
-    "pkg:check": "npx publint && npx are-the-types-wrong . --pack"
+    "benchmark": "MERIDIAN_BENCH_SUITE=1 npx vite-node benchmarks/index.ts",
+    "benchmark:reliability": "npx vite-node benchmarks/reliability.ts",
+    "benchmark:overhead": "npx vite-node benchmarks/pipeline-overhead.ts",
+    "pkg:check": "npx publint && npx @arethetypeswrong/cli . --pack"
   },
   "bin": {
     "boundary-proxy": "dist/proxy/cli.js",
     "meridian": "dist/generator/cli.js"
   },
-  "keywords": ["api", "sdk", "normalization", "circuit-breaker", "rate-limiting", "retry"],
+  "keywords": [
+    "api",
+    "sdk",
+    "normalization",
+    "circuit-breaker",
+    "rate-limiting",
+    "retry"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Raghaverma/meridianjs"
+    "url": "git+https://github.com/Raghaverma/meridianjs.git"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -49,6 +71,7 @@
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@types/node": "^20.14.0",
+    "@vitest/coverage-v8": "^1.6.1",
     "typescript": "^5.5.0",
     "vitest": "^1.6.0"
   }