@peac/mappings-acp 0.9.18

package/README.md

@@ -0,0 +1,23 @@
+# @peac/mappings-acp
+
+Agentic Commerce Protocol (ACP) integration for PEAC
+
+## Installation
+
+```bash
+pnpm add @peac/mappings-acp
+```
+
+## Documentation
+
+See [peacprotocol.org](https://peacprotocol.org) for full documentation.
+
+## License
+
+Apache-2.0
+
+---
+
+PEAC Protocol is an open source project stewarded by Originary and community contributors.
+
+[Originary](https://www.originary.xyz) | [Docs](https://peacprotocol.org) | [GitHub](https://github.com/peacprotocol/peac)

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Agentic Commerce Protocol (ACP) integration
+ * Maps ACP checkout events to PEAC receipts
+ */
+import type { PaymentEvidence } from '@peac/schema';
+/**
+ * ACP Checkout Success Event
+ */
+export interface ACPCheckoutSuccess {
+    checkout_id: string;
+    resource_uri: string;
+    total_amount: number;
+    currency: string;
+    payment_rail: string;
+    payment_reference: string;
+    customer_id?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * PEAC Receipt Input (for issue())
+ */
+export interface PEACReceiptInput {
+    subject_uri: string;
+    amt: number;
+    cur: string;
+    payment: PaymentEvidence;
+}
+/**
+ * Convert ACP checkout success event to PEAC receipt input
+ *
+ * @param event - ACP checkout success event
+ * @returns PEAC receipt input ready for issue()
+ */
+export declare function fromACPCheckoutSuccess(event: ACPCheckoutSuccess): PEACReceiptInput;
+/**
+ * Attach PEAC receipt to ACP response
+ *
+ * @param response - ACP response object
+ * @param receiptJWS - PEAC receipt JWS
+ * @returns ACP response with PEAC receipt attached
+ */
+export declare function attachReceiptToACPResponse<T extends Record<string, unknown>>(response: T, receiptJWS: string): T & {
+    peac_receipt: string;
+};
+/**
+ * Extract PEAC receipt from ACP response
+ *
+ * @param response - ACP response object
+ * @returns PEAC receipt JWS or null if not present
+ */
+export declare function extractReceiptFromACPResponse(response: Record<string, unknown>): string | null;
+//# 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;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,gBAAgB,CAmDlF;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1E,QAAQ,EAAE,CAAC,EACX,UAAU,EAAE,MAAM,GACjB,CAAC,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAK9B;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAK9F"}

package/dist/index.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Agentic Commerce Protocol (ACP) integration
+ * Maps ACP checkout events to PEAC receipts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromACPCheckoutSuccess = fromACPCheckoutSuccess;
+exports.attachReceiptToACPResponse = attachReceiptToACPResponse;
+exports.extractReceiptFromACPResponse = extractReceiptFromACPResponse;
+/**
+ * Convert ACP checkout success event to PEAC receipt input
+ *
+ * @param event - ACP checkout success event
+ * @returns PEAC receipt input ready for issue()
+ */
+function fromACPCheckoutSuccess(event) {
+    // Validate ACP event
+    if (!event.checkout_id) {
+        throw new Error('ACP checkout event missing checkout_id');
+    }
+    if (!event.resource_uri || !event.resource_uri.startsWith('https://')) {
+        throw new Error('ACP checkout event missing or invalid resource_uri (must be https://)');
+    }
+    if (typeof event.total_amount !== 'number' || event.total_amount < 0) {
+        throw new Error('ACP checkout event invalid total_amount');
+    }
+    if (!event.currency || !/^[A-Z]{3}$/.test(event.currency)) {
+        throw new Error('ACP checkout event invalid currency (must be uppercase ISO 4217)');
+    }
+    if (!event.payment_rail) {
+        throw new Error('ACP checkout event missing payment_rail');
+    }
+    if (!event.payment_reference) {
+        throw new Error('ACP checkout event missing payment_reference');
+    }
+    // Build payment evidence from ACP event
+    const evidence = {};
+    // Include ACP metadata in evidence
+    if (event.metadata) {
+        evidence.acp_metadata = event.metadata;
+    }
+    if (event.customer_id) {
+        evidence.customer_id = event.customer_id;
+    }
+    if (event.checkout_id) {
+        evidence.checkout_id = event.checkout_id;
+    }
+    const payment = {
+        rail: event.payment_rail,
+        reference: event.payment_reference,
+        amount: event.total_amount,
+        currency: event.currency,
+        asset: event.currency, // For ACP, asset is typically same as currency
+        env: 'live', // Default to live; ACP events should indicate if test
+        evidence,
+    };
+    return {
+        subject_uri: event.resource_uri,
+        amt: event.total_amount,
+        cur: event.currency,
+        payment,
+    };
+}
+/**
+ * Attach PEAC receipt to ACP response
+ *
+ * @param response - ACP response object
+ * @param receiptJWS - PEAC receipt JWS
+ * @returns ACP response with PEAC receipt attached
+ */
+function attachReceiptToACPResponse(response, receiptJWS) {
+    return {
+        ...response,
+        peac_receipt: receiptJWS,
+    };
+}
+/**
+ * Extract PEAC receipt from ACP response
+ *
+ * @param response - ACP response object
+ * @returns PEAC receipt JWS or null if not present
+ */
+function extractReceiptFromACPResponse(response) {
+    if (typeof response.peac_receipt === 'string') {
+        return response.peac_receipt;
+    }
+    return null;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAkCH,wDAmDC;AASD,gEAQC;AAQD,sEAKC;AAvFD;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,KAAyB;IAC9D,qBAAqB;IACrB,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,wCAAwC;IACxC,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAE7C,mCAAmC;IACnC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,QAAQ,CAAC,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC;IACzC,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,QAAQ,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAC3C,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,QAAQ,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAC3C,CAAC;IAED,MAAM,OAAO,GAAoB;QAC/B,IAAI,EAAE,KAAK,CAAC,YAAY;QACxB,SAAS,EAAE,KAAK,CAAC,iBAAiB;QAClC,MAAM,EAAE,KAAK,CAAC,YAAY;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,+CAA+C;QACtE,GAAG,EAAE,MAAM,EAAE,sDAAsD;QACnE,QAAQ;KACT,CAAC;IAEF,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,YAAY;QAC/B,GAAG,EAAE,KAAK,CAAC,YAAY;QACvB,GAAG,EAAE,KAAK,CAAC,QAAQ;QACnB,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,0BAA0B,CACxC,QAAW,EACX,UAAkB;IAElB,OAAO;QACL,GAAG,QAAQ;QACX,YAAY,EAAE,UAAU;KACzB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,6BAA6B,CAAC,QAAiC;IAC7E,IAAI,OAAO,QAAQ,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,QAAQ,CAAC,YAAY,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@peac/mappings-acp",
+  "version": "0.9.18",
+  "description": "Agentic Commerce Protocol (ACP) integration for PEAC",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/peacprotocol/peac.git",
+    "directory": "packages/mappings/acp"
+  },
+  "author": "jithinraj <7850727+jithinraj@users.noreply.github.com>",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/peacprotocol/peac/issues"
+  },
+  "homepage": "https://github.com/peacprotocol/peac#readme",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@peac/schema": "workspace:*",
+    "@peac/protocol": "workspace:*"
+  },
+  "devDependencies": {
+    "@peac/crypto": "workspace:*",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.1.0"
+  }
+}