@queelabs/connectors-mpp 0.0.1

package/dist/http.d.ts

@@ -0,0 +1,13 @@
+import type { MppPaymentAdapter } from "@queelabs/core";
+export type HttpMppConnectorOptions = {
+    /** Base URL of your MPP gateway (no trailing slash). */
+    baseUrl: string;
+    apiKey?: string;
+    fetchImpl?: typeof fetch;
+};
+/**
+ * Forwards challenge creation and verification to an external HTTP service.
+ * Contract: see `docs/connectors-http.md`.
+ */
+export declare function createHttpMppConnector(opts: HttpMppConnectorOptions): MppPaymentAdapter;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,iBAAiB,EAGlB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,uBAAuB,GAAG;IACpC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,CAAC;AAQF;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,uBAAuB,GAC5B,iBAAiB,CA4EnB"}

package/dist/http.js

@@ -0,0 +1,67 @@
+function headers(apiKey) {
+    const h = { "Content-Type": "application/json" };
+    if (apiKey)
+        h.Authorization = `Bearer ${apiKey}`;
+    return h;
+}
+/**
+ * Forwards challenge creation and verification to an external HTTP service.
+ * Contract: see `docs/connectors-http.md`.
+ */
+export function createHttpMppConnector(opts) {
+    const base = opts.baseUrl.replace(/\/$/, "");
+    const f = opts.fetchImpl ?? fetch;
+    return {
+        async createPurchaseChallenge(input) {
+            const res = await f(`${base}/v1/challenges`, {
+                method: "POST",
+                headers: headers(opts.apiKey),
+                body: JSON.stringify(input),
+            });
+            const text = await res.text();
+            if (!res.ok) {
+                throw new Error(`MPP HTTP challenge failed (${res.status}): ${text.slice(0, 500)}`);
+            }
+            const json = JSON.parse(text);
+            if (typeof json.challengeId !== "string" ||
+                typeof json.rail !== "string" ||
+                typeof json.payload !== "object" ||
+                json.payload === null) {
+                throw new Error("MPP HTTP: invalid challenge response shape");
+            }
+            const expiresAt = json.expiresAt instanceof Date
+                ? json.expiresAt
+                : typeof json.expiresAt === "string"
+                    ? new Date(json.expiresAt)
+                    : undefined;
+            return {
+                challengeId: json.challengeId,
+                rail: json.rail,
+                payload: json.payload,
+                expiresAt,
+            };
+        },
+        async verifyPurchase(input) {
+            const res = await f(`${base}/v1/verify`, {
+                method: "POST",
+                headers: headers(opts.apiKey),
+                body: JSON.stringify(input),
+            });
+            const text = await res.text();
+            if (!res.ok) {
+                throw new Error(`MPP HTTP verify failed (${res.status}): ${text.slice(0, 500)}`);
+            }
+            const json = JSON.parse(text);
+            if (!json?.receiptPayload || typeof json.receiptPayload !== "object") {
+                throw new Error("MPP HTTP: invalid verify response (need receiptPayload)");
+            }
+            return {
+                receiptPayload: json.receiptPayload,
+                verifiedAt: json.verifiedAt
+                    ? new Date(json.verifiedAt)
+                    : new Date(),
+            };
+        },
+    };
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { MppPaymentAdapter } from "@queelabs/core";
+export { createHttpMppConnector, type HttpMppConnectorOptions, } from "./http.js";
+/**
+ * Dev-friendly MPP-shaped connector: returns a structured challenge payload.
+ * Agents complete payment by POSTing proof; verification accepts mock proof for local demos.
+ */
+export declare function createMockMppConnector(): MppPaymentAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,iBAAiB,EAGlB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,WAAW,CAAC;AAEnB;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,iBAAiB,CA+C1D"}

package/dist/index.js

@@ -0,0 +1,52 @@
+import { nanoid } from "nanoid";
+export { createHttpMppConnector, } from "./http.js";
+/**
+ * Dev-friendly MPP-shaped connector: returns a structured challenge payload.
+ * Agents complete payment by POSTing proof; verification accepts mock proof for local demos.
+ */
+export function createMockMppConnector() {
+    return {
+        async createPurchaseChallenge(input) {
+            const challengeId = `ch_${nanoid(12)}`;
+            const expiresAt = new Date(Date.now() + 15 * 60 * 1000);
+            return {
+                challengeId,
+                rail: "mpp",
+                payload: {
+                    type: "payment_challenge",
+                    version: "0.1",
+                    orderId: input.orderId,
+                    marketplaceId: input.marketplaceId,
+                    amountMinor: input.amountMinor,
+                    currency: input.currency,
+                    /** Example: HTTP 402 body would echo this for machine clients */
+                    mpp: {
+                        accepts: ["mock", "tempo"],
+                        resource: `quee://orders/${input.orderId}/pay`,
+                    },
+                    expiresAt: expiresAt.toISOString(),
+                },
+                expiresAt,
+            };
+        },
+        async verifyPurchase(input) {
+            const paid = input.proof.mockPaid === true ||
+                input.proof.receipt === "ok" ||
+                input.proof.signature === "demo";
+            if (!paid) {
+                throw new Error("payment verification failed: missing proof");
+            }
+            return {
+                receiptPayload: {
+                    verified: true,
+                    challengeId: input.challengeId,
+                    orderId: input.orderId,
+                    settledVia: input.rail,
+                    proof: input.proof,
+                },
+                verifiedAt: new Date(),
+            };
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EACL,sBAAsB,GAEvB,MAAM,WAAW,CAAC;AAEnB;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,KAAK,CAAC,uBAAuB,CAC3B,KAA2B;YAE3B,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YACxD,OAAO;gBACL,WAAW;gBACX,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE;oBACP,IAAI,EAAE,mBAAmB;oBACzB,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,aAAa,EAAE,KAAK,CAAC,aAAa;oBAClC,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,iEAAiE;oBACjE,GAAG,EAAE;wBACH,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;wBAC1B,QAAQ,EAAE,iBAAiB,KAAK,CAAC,OAAO,MAAM;qBAC/C;oBACD,SAAS,EAAE,SAAS,CAAC,WAAW,EAAE;iBACnC;gBACD,SAAS;aACV,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,cAAc,CAAC,KAAyB;YAC5C,MAAM,IAAI,GACR,KAAK,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI;gBAC7B,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI;gBAC5B,KAAK,CAAC,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC;YACnC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAChE,CAAC;YACD,OAAO;gBACL,cAAc,EAAE;oBACd,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,UAAU,EAAE,KAAK,CAAC,IAAI;oBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;iBACnB;gBACD,UAAU,EAAE,IAAI,IAAI,EAAE;aACvB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@queelabs/connectors-mpp",
+  "version": "0.0.1",
+  "license": "UNLICENSED",
+  "description": "MPP challenge and verify connector for Quee",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/quee-protocol/quee.git",
+    "directory": "connectors/mpp"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "nanoid": "^5.0.9",
+    "@queelabs/core": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsc",
+    "lint": "echo ok",
+    "test": "vitest run --passWithNoTests"
+  }
+}