@provethebuy/verify 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +43 -2
  3. package/dist/bodyObjects.d.ts +28 -0
  4. package/dist/bodyObjects.js +47 -0
  5. package/dist/bodyObjects.js.map +1 -0
  6. package/dist/cloud.d.ts +42 -0
  7. package/dist/cloud.js +102 -0
  8. package/dist/cloud.js.map +1 -0
  9. package/dist/confirmation.d.ts +17 -0
  10. package/dist/confirmation.js +31 -0
  11. package/dist/confirmation.js.map +1 -0
  12. package/dist/evidence.d.ts +39 -0
  13. package/dist/evidence.js +96 -0
  14. package/dist/evidence.js.map +1 -0
  15. package/dist/express.d.ts +43 -0
  16. package/dist/express.js +72 -0
  17. package/dist/express.js.map +1 -0
  18. package/dist/httpsig.d.ts +58 -0
  19. package/dist/httpsig.js +203 -0
  20. package/dist/httpsig.js.map +1 -0
  21. package/dist/index.d.ts +29 -0
  22. package/dist/index.js +16 -0
  23. package/dist/index.js.map +1 -0
  24. package/dist/jws.d.ts +28 -0
  25. package/dist/jws.js +93 -0
  26. package/dist/jws.js.map +1 -0
  27. package/dist/keys.d.ts +61 -0
  28. package/dist/keys.js +76 -0
  29. package/dist/keys.js.map +1 -0
  30. package/dist/ledger.d.ts +102 -0
  31. package/dist/ledger.js +131 -0
  32. package/dist/ledger.js.map +1 -0
  33. package/dist/mandates/ap2.d.ts +31 -0
  34. package/dist/mandates/ap2.js +91 -0
  35. package/dist/mandates/ap2.js.map +1 -0
  36. package/dist/mandates/index.d.ts +25 -0
  37. package/dist/mandates/index.js +26 -0
  38. package/dist/mandates/index.js.map +1 -0
  39. package/dist/mandates/verifiableIntent.d.ts +20 -0
  40. package/dist/mandates/verifiableIntent.js +128 -0
  41. package/dist/mandates/verifiableIntent.js.map +1 -0
  42. package/dist/order.d.ts +9 -0
  43. package/dist/order.js +32 -0
  44. package/dist/order.js.map +1 -0
  45. package/dist/payment.d.ts +22 -0
  46. package/dist/payment.js +19 -0
  47. package/dist/payment.js.map +1 -0
  48. package/dist/policy.d.ts +39 -0
  49. package/dist/policy.js +29 -0
  50. package/dist/policy.js.map +1 -0
  51. package/dist/replay.d.ts +46 -0
  52. package/dist/replay.js +61 -0
  53. package/dist/replay.js.map +1 -0
  54. package/dist/reputation.d.ts +16 -0
  55. package/dist/reputation.js +46 -0
  56. package/dist/reputation.js.map +1 -0
  57. package/dist/testing.d.ts +53 -0
  58. package/dist/testing.js +100 -0
  59. package/dist/testing.js.map +1 -0
  60. package/dist/types.d.ts +72 -0
  61. package/dist/types.js +2 -0
  62. package/dist/types.js.map +1 -0
  63. package/dist/util.d.ts +15 -0
  64. package/dist/util.js +59 -0
  65. package/dist/util.js.map +1 -0
  66. package/dist/verify.d.ts +50 -0
  67. package/dist/verify.js +309 -0
  68. package/dist/verify.js.map +1 -0
  69. package/package.json +63 -4
@@ -0,0 +1,96 @@
1
+ /** Re-verify a stored record and build a dispute evidence pack from it. */
2
+ import { KeyDirectory } from "./keys.js";
3
+ import { MemoryReplayStore } from "./replay.js";
4
+ import { ProveTheBuy } from "./verify.js";
5
+ import { formatMoney } from "./order.js";
6
+ /**
7
+ * Re-run the signature and mandate checks with the stored raw request and the key snapshot taken at
8
+ * the time, as of the original signing time. Works after the agent's key has rotated.
9
+ */
10
+ export async function reverifyRecord(rec, opts) {
11
+ const a = rec.artifacts;
12
+ if (!a?.request || !a.key_jwk || !rec.agent)
13
+ return { ok: false, detail: "Record has no stored request or key snapshot to re-verify.", checks: [] };
14
+ const keys = new KeyDirectory({ sources: [{ name: rec.agent.directory ?? "snapshot", jwks: { keys: [{ ...a.key_jwk, kid: rec.agent.keyid }] } }] });
15
+ const at = (rec.agent.created ?? Math.floor(Date.parse(rec.received_at) / 1000)) + 1;
16
+ // Use the issuer key snapshot from the record when the caller has no issuer directory of its own.
17
+ const issuers = opts.issuers ?? (a.issuer_jwk ? new KeyDirectory({ sources: [{ name: "issuer-snapshot", jwks: { keys: [a.issuer_jwk] } }] }) : undefined);
18
+ const v = new ProveTheBuy({ ...opts, issuers, keys, replay: new MemoryReplayStore(), now: () => at });
19
+ const res = await v.verify(a.request, a.context);
20
+ const sigOk = res.checks.some((c) => c.name === "signature_valid" && c.status === "pass");
21
+ const same = res.decision === rec.decision;
22
+ return {
23
+ ok: sigOk && same,
24
+ detail: sigOk
25
+ ? same
26
+ ? "Re-verified: the stored request still verifies with the key snapshot, and the decision is unchanged."
27
+ : `Signature still verifies, but the decision now differs (${res.decision} vs ${rec.decision}).`
28
+ : "The stored request no longer verifies. Do not submit this record as evidence.",
29
+ checks: res.checks.map(({ name, status, detail }) => ({ name, status, detail })),
30
+ };
31
+ }
32
+ const REASONS = {
33
+ "10.4": { label: "Visa 10.4 Other Fraud, card-absent", focus: "authorisation" },
34
+ "13.1": { label: "Visa 13.1 Merchandise not received", focus: "fulfilment" },
35
+ "13.3": { label: "Visa 13.3 Not as described", focus: "order-match" },
36
+ "4837": { label: "Mastercard 4837 No cardholder authorisation", focus: "authorisation" },
37
+ "4853": { label: "Mastercard 4853 Not as described", focus: "order-match" },
38
+ };
39
+ export async function buildEvidencePack(rec, dispute, ledger, opts) {
40
+ const reason = REASONS[dispute.reason_code] ?? { label: `Reason code ${dispute.reason_code}`, focus: "authorisation" };
41
+ const reverification = await reverifyRecord(rec, opts);
42
+ const chain = ledger.verifyChain();
43
+ const pass = (n) => rec.checks.find((c) => c.name === n)?.status === "pass";
44
+ const amount = rec.order?.amount !== undefined ? formatMoney(rec.order.amount, rec.order.currency ?? dispute.currency) : "n/a";
45
+ const sections = [
46
+ {
47
+ title: "Summary",
48
+ body: `This purchase of ${amount} was placed by an AI agent acting for the cardholder. ` +
49
+ `The agent's identity was verified with a cryptographic signature from the ${rec.agent?.directory ?? "agent"} key directory, ` +
50
+ (rec.mandate?.valid
51
+ ? `and the cardholder's signed mandate (${rec.mandate.type}${rec.mandate.mode ? ", " + rec.mandate.mode : ""}) authorised it: ${rec.mandate.summary ?? "see below"}.`
52
+ : "but no valid cardholder mandate was presented."),
53
+ },
54
+ {
55
+ title: "Agent identity",
56
+ body: [
57
+ `Protocol: ${rec.agent?.protocol}`,
58
+ `Key id: ${rec.agent?.keyid}`,
59
+ `Purpose tag: ${rec.agent?.tag}`,
60
+ `Signed at: ${rec.agent?.created ? new Date(rec.agent.created * 1000).toISOString() : "n/a"}`,
61
+ `Signature verified: ${pass("signature_valid") ? "yes" : "no"}; replay check: ${pass("nonce_unused") ? "passed" : "failed"}`,
62
+ `Key snapshot (SHA-256): ${rec.agent?.keySnapshotSha256}`,
63
+ ].join("\n"),
64
+ },
65
+ {
66
+ title: "Cardholder authorisation",
67
+ body: rec.mandate
68
+ ? [
69
+ `Mandate type: ${rec.mandate.type}`,
70
+ `Mode: ${rec.mandate.mode ?? "n/a"}`,
71
+ `Credential chain valid: ${rec.mandate.valid ? "yes" : "no"}`,
72
+ `Order inside the mandate: ${rec.mandate.constraintsOk ? "yes" : "no"}`,
73
+ `Mandate valid until: ${rec.mandate.expiresAt ?? "n/a"}`,
74
+ ].join("\n")
75
+ : "No mandate was presented with this order.",
76
+ },
77
+ {
78
+ title: "Order match",
79
+ body: [`Order hash (RFC 8785 + SHA-256): ${rec.order?.order_hash}`, `Order id: ${rec.order?.order_id ?? "n/a"}`, `Amount: ${amount}`, `Payment: ${rec.order?.payment_intent ?? "n/a"}`].join("\n"),
80
+ },
81
+ {
82
+ title: "Integrity",
83
+ body: [
84
+ `Record ${rec.record_id}, hash ${rec.hash}`,
85
+ `Ledger chain intact: ${chain.ok ? "yes" : "no, broken at " + chain.brokenAt} (${chain.checked} records checked)`,
86
+ `Re-verification today: ${reverification.detail}`,
87
+ ].join("\n"),
88
+ },
89
+ ];
90
+ if (reason.focus === "fulfilment")
91
+ sections.push({ title: "Fulfilment", body: "Attach the carrier tracking number and delivery confirmation. The agent and mandate evidence above shows who ordered; delivery proof shows it arrived." });
92
+ const submittable = reverification.ok && chain.ok && !!rec.mandate?.valid;
93
+ const text = [`Dispute ${dispute.dispute_id}: ${reason.label}`, ...sections.map((s) => `${s.title.toUpperCase()}\n${s.body}`)].join("\n\n");
94
+ return { dispute_id: dispute.dispute_id, reason: reason.label, record_id: rec.record_id, record_hash: rec.hash, reverification, submittable, sections, text };
95
+ }
96
+ //# sourceMappingURL=evidence.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"evidence.js","sourceRoot":"","sources":["../src/evidence.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Express (and Connect-style) middleware.
3
+ *
4
+ * app.post("/checkout", ptb.capture(), ptb.verify(), handler)
5
+ *
6
+ * capture() must run before any body parser so the raw bytes are kept exactly as signed.
7
+ * In shadow mode nothing is ever blocked; the decision is attached to req.provethebuy.
8
+ */
9
+ import type { IncomingMessage, ServerResponse } from "node:http";
10
+ import { type CheckoutContext, type ProveTheBuy } from "./verify.js";
11
+ import type { EvidenceLedger, VerificationRecord } from "./ledger.js";
12
+ import type { HttpRequestLike } from "./httpsig.js";
13
+ import type { VerificationResult } from "./types.js";
14
+ type Next = (err?: unknown) => void;
15
+ export interface PtbRequest extends IncomingMessage {
16
+ rawBody?: string;
17
+ body?: unknown;
18
+ originalUrl?: string;
19
+ protocol?: string;
20
+ provethebuy?: VerificationResult & {
21
+ request: HttpRequestLike;
22
+ context: CheckoutContext;
23
+ };
24
+ }
25
+ type Res = ServerResponse & {
26
+ status?: (c: number) => Res;
27
+ json?: (b: unknown) => void;
28
+ };
29
+ export interface MiddlewareOptions {
30
+ /** Public base URL if you sit behind a proxy, e.g. https://shop.example */
31
+ publicOrigin?: string;
32
+ /** Maximum body size in bytes. Default 1 MB. */
33
+ limit?: number;
34
+ }
35
+ export declare function createMiddleware(verifier: ProveTheBuy, ledger?: EvidenceLedger, opts?: MiddlewareOptions): {
36
+ capture: () => (req: PtbRequest, res: Res, next: Next) => void;
37
+ verify: () => (req: PtbRequest, res: Res, next: Next) => Promise<void>;
38
+ record: (req: PtbRequest, extra?: {
39
+ orderId?: string;
40
+ paymentIntent?: string;
41
+ }) => VerificationRecord | undefined;
42
+ };
43
+ export {};
@@ -0,0 +1,72 @@
1
+ import { lowerKeys } from "./util.js";
2
+ import { contextFromBody } from "./verify.js";
3
+ function send(res, code, body) {
4
+ res.statusCode = code;
5
+ res.setHeader("content-type", "application/json");
6
+ res.end(JSON.stringify(body));
7
+ }
8
+ export function createMiddleware(verifier, ledger, opts = {}) {
9
+ const limit = opts.limit ?? 1_000_000;
10
+ /** Read the raw body once and keep it. Also sets req.body for JSON requests. */
11
+ const capture = () => (req, res, next) => {
12
+ if (req.rawBody !== undefined)
13
+ return next();
14
+ const chunks = [];
15
+ let size = 0;
16
+ req.on("data", (c) => {
17
+ size += c.length;
18
+ if (size > limit) {
19
+ send(res, 413, { error: "Request body too large" });
20
+ req.destroy();
21
+ return;
22
+ }
23
+ chunks.push(c);
24
+ });
25
+ req.on("end", () => {
26
+ req.rawBody = Buffer.concat(chunks).toString("utf8");
27
+ if (String(req.headers["content-type"] ?? "").includes("json") && req.rawBody) {
28
+ try {
29
+ req.body = JSON.parse(req.rawBody);
30
+ }
31
+ catch {
32
+ return send(res, 400, { error: "Body is not valid JSON" });
33
+ }
34
+ }
35
+ next();
36
+ });
37
+ req.on("error", next);
38
+ };
39
+ const toRequest = (req) => {
40
+ const headers = lowerKeys(req.headers);
41
+ const origin = opts.publicOrigin ?? `${req.protocol ?? "http"}://${headers["host"] ?? "localhost"}`;
42
+ return { method: req.method ?? "GET", url: origin + (req.originalUrl ?? req.url ?? "/"), headers, body: req.rawBody };
43
+ };
44
+ /** Verify the request and apply the decision (enforce mode only). */
45
+ const verify = () => async (req, res, next) => {
46
+ try {
47
+ const request = toRequest(req);
48
+ const context = contextFromBody(request.body);
49
+ const result = await verifier.verify(request, context);
50
+ req.provethebuy = { ...result, request, context };
51
+ if (result.enforced && result.decision === "block")
52
+ return send(res, 403, { error: "agent_request_blocked", reasons: result.reasons });
53
+ if (result.enforced && result.decision === "step_up")
54
+ return send(res, 409, { error: "confirmation_required", step_up: result.stepUp, reasons: result.reasons });
55
+ next();
56
+ }
57
+ catch (e) {
58
+ next(e);
59
+ }
60
+ };
61
+ /** Write the evidence record. Call after you have charged, so the payment id is included. */
62
+ const record = (req, extra = {}) => {
63
+ if (!ledger || !req.provethebuy)
64
+ return undefined;
65
+ const r = req.provethebuy;
66
+ if (r.decision === "not_agent")
67
+ return undefined;
68
+ return ledger.record(r, { request: r.request, context: r.context, ...extra });
69
+ };
70
+ return { capture, verify, record };
71
+ }
72
+ //# sourceMappingURL=express.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"express.js","sourceRoot":"","sources":["../src/express.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,eAAe,EAA0C,MAAM,aAAa,CAAC;AAwBtF,SAAS,IAAI,CAAC,GAAQ,EAAE,IAAY,EAAE,IAAa;IACjD,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAClD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAqB,EAAE,MAAuB,EAAE,OAA0B,EAAE;IAC3G,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC;IAEtC,gFAAgF;IAChF,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC,GAAe,EAAE,GAAQ,EAAE,IAAU,EAAE,EAAE;QAC9D,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO,IAAI,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YAC3B,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC;YACjB,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;gBACjB,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC,CAAC;gBACpD,GAAG,CAAC,OAAO,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACjB,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACrD,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC9E,IAAI,CAAC;oBACH,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACrC,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;YACD,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,GAAe,EAAmB,EAAE;QACrD,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,OAAwD,CAAC,CAAC;QACxF,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,IAAI,GAAG,GAAG,CAAC,QAAQ,IAAI,MAAM,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QACpG,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IACxH,CAAC,CAAC;IAEF,qEAAqE;IACrE,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,EAAE,GAAe,EAAE,GAAQ,EAAE,IAAU,EAAE,EAAE;QACnE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACvD,GAAG,CAAC,WAAW,GAAG,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;YAClD,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO;gBAAE,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YACvI,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YACjK,IAAI,EAAE,CAAC;QACT,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,CAAC,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC;IAEF,6FAA6F;IAC7F,MAAM,MAAM,GAAG,CAAC,GAAe,EAAE,QAAsD,EAAE,EAAkC,EAAE;QAC3H,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,WAAW;YAAE,OAAO,SAAS,CAAC;QAClD,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC;QAC1B,IAAI,CAAC,CAAC,QAAQ,KAAK,WAAW;YAAE,OAAO,SAAS,CAAC;QACjD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAChF,CAAC,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACrC,CAAC"}
@@ -0,0 +1,58 @@
1
+ /**
2
+ * HTTP Message Signatures (RFC 9421) as used by Web Bot Auth, Visa Trusted Agent Protocol
3
+ * and Mastercard Agent Pay.
4
+ */
5
+ import { KeyObject } from "node:crypto";
6
+ import type { Jwk } from "./keys.js";
7
+ export interface HttpRequestLike {
8
+ method: string;
9
+ /** Absolute URL, e.g. https://shop.example/checkout?x=1 */
10
+ url: string;
11
+ headers: Record<string, string>;
12
+ /** Raw body exactly as received. */
13
+ body?: string;
14
+ }
15
+ export interface SignatureParams {
16
+ created?: number;
17
+ expires?: number;
18
+ keyid?: string;
19
+ alg?: string;
20
+ nonce?: string;
21
+ tag?: string;
22
+ [k: string]: string | number | boolean | undefined;
23
+ }
24
+ export interface ParsedSignature {
25
+ label: string;
26
+ components: string[];
27
+ params: SignatureParams;
28
+ /** Serialised inner list + parameters, used verbatim as @signature-params. */
29
+ paramsRaw: string;
30
+ signature?: Buffer;
31
+ }
32
+ export declare const AGENT_TAGS: readonly ["agent-browser-auth", "agent-payer-auth"];
33
+ export type AgentTag = (typeof AGENT_TAGS)[number];
34
+ /** Parse Signature-Input into labelled members. */
35
+ export declare function parseSignatureInput(header: string): ParsedSignature[];
36
+ /** Parse Signature header: label=:base64: */
37
+ export declare function parseSignatureHeader(header: string): Record<string, Buffer>;
38
+ /** Resolve the value of one covered component. */
39
+ export declare function componentValue(req: HttpRequestLike, component: string): string;
40
+ /** Build the exact signature base string (RFC 9421 section 2.5). */
41
+ export declare function signatureBase(req: HttpRequestLike, sig: Pick<ParsedSignature, "components" | "paramsRaw">): string;
42
+ export type SigAlg = "ed25519" | "rsa-pss-sha512" | "rsa-pss-sha256" | "ps256" | "ecdsa-p256-sha256";
43
+ export declare function inferAlg(jwk: Jwk, declared?: string): SigAlg | null;
44
+ export declare function verifyBytes(alg: SigAlg, key: KeyObject, data: Buffer, signature: Buffer): boolean;
45
+ export declare function signBytes(alg: SigAlg, privateKey: KeyObject, data: Buffer): Buffer;
46
+ export interface SignRequestOptions {
47
+ privateJwk: Jwk;
48
+ keyid: string;
49
+ alg?: SigAlg;
50
+ tag: AgentTag;
51
+ components?: string[];
52
+ created?: number;
53
+ expires?: number;
54
+ nonce: string;
55
+ label?: string;
56
+ }
57
+ /** Sign a request the way an agent would. Used by tests, the playground and conformance vectors. */
58
+ export declare function signRequest(req: HttpRequestLike, o: SignRequestOptions): HttpRequestLike;
@@ -0,0 +1,203 @@
1
+ /**
2
+ * HTTP Message Signatures (RFC 9421) as used by Web Bot Auth, Visa Trusted Agent Protocol
3
+ * and Mastercard Agent Pay.
4
+ */
5
+ import { createPrivateKey, sign as nodeSign, verify as nodeVerify, constants } from "node:crypto";
6
+ export const AGENT_TAGS = ["agent-browser-auth", "agent-payer-auth"];
7
+ /** Split a structured-field dictionary on top-level commas (respecting quotes, parens, colons). */
8
+ function splitTopLevel(input, sep) {
9
+ const out = [];
10
+ let depth = 0;
11
+ let inQuote = false;
12
+ let inBytes = false;
13
+ let cur = "";
14
+ for (let i = 0; i < input.length; i++) {
15
+ const ch = input[i];
16
+ if (inQuote) {
17
+ cur += ch;
18
+ if (ch === "\\" && i + 1 < input.length) {
19
+ cur += input[++i];
20
+ continue;
21
+ }
22
+ if (ch === '"')
23
+ inQuote = false;
24
+ continue;
25
+ }
26
+ if (ch === '"')
27
+ inQuote = true;
28
+ else if (ch === ":" && depth === 0)
29
+ inBytes = !inBytes;
30
+ else if (ch === "(")
31
+ depth++;
32
+ else if (ch === ")")
33
+ depth--;
34
+ if (ch === sep && depth === 0 && !inBytes) {
35
+ out.push(cur.trim());
36
+ cur = "";
37
+ continue;
38
+ }
39
+ cur += ch;
40
+ }
41
+ if (cur.trim())
42
+ out.push(cur.trim());
43
+ return out;
44
+ }
45
+ function parseParamValue(raw) {
46
+ const v = raw.trim();
47
+ if (v.startsWith('"') && v.endsWith('"'))
48
+ return v.slice(1, -1).replace(/\\(["\\])/g, "$1");
49
+ if (/^-?\d+$/.test(v))
50
+ return Number(v);
51
+ if (v === "?1")
52
+ return true;
53
+ if (v === "?0")
54
+ return false;
55
+ return v;
56
+ }
57
+ /** Parse Signature-Input into labelled members. */
58
+ export function parseSignatureInput(header) {
59
+ const members = splitTopLevel(header, ",");
60
+ const out = [];
61
+ for (const m of members) {
62
+ const eq = m.indexOf("=");
63
+ if (eq < 1)
64
+ throw new Error("Malformed Signature-Input member");
65
+ const label = m.slice(0, eq).trim();
66
+ const value = m.slice(eq + 1).trim();
67
+ if (!value.startsWith("("))
68
+ throw new Error("Signature-Input must start with an inner list");
69
+ const close = value.indexOf(")");
70
+ if (close < 0)
71
+ throw new Error("Unterminated inner list in Signature-Input");
72
+ const inner = value.slice(1, close).trim();
73
+ const components = inner ? (inner.match(/"[^"]*"/g) ?? []).map((c) => c.slice(1, -1)) : [];
74
+ const params = {};
75
+ const rest = value.slice(close + 1);
76
+ for (const p of splitTopLevel(rest, ";")) {
77
+ if (!p)
78
+ continue;
79
+ const i = p.indexOf("=");
80
+ if (i < 0)
81
+ params[p.trim()] = true;
82
+ else
83
+ params[p.slice(0, i).trim()] = parseParamValue(p.slice(i + 1));
84
+ }
85
+ out.push({ label, components, params, paramsRaw: value });
86
+ }
87
+ return out;
88
+ }
89
+ /** Parse Signature header: label=:base64: */
90
+ export function parseSignatureHeader(header) {
91
+ const out = {};
92
+ for (const m of splitTopLevel(header, ",")) {
93
+ const eq = m.indexOf("=");
94
+ if (eq < 1)
95
+ continue;
96
+ const label = m.slice(0, eq).trim();
97
+ const v = m.slice(eq + 1).trim();
98
+ if (!v.startsWith(":") || !v.endsWith(":"))
99
+ throw new Error("Signature value must be a byte sequence");
100
+ out[label] = Buffer.from(v.slice(1, -1), "base64");
101
+ }
102
+ return out;
103
+ }
104
+ /** Resolve the value of one covered component. */
105
+ export function componentValue(req, component) {
106
+ const url = new URL(req.url);
107
+ switch (component) {
108
+ case "@method":
109
+ return req.method.toUpperCase();
110
+ case "@authority":
111
+ return (req.headers["host"] ?? url.host).toLowerCase();
112
+ case "@path":
113
+ return url.pathname || "/";
114
+ case "@query":
115
+ return url.search || "?";
116
+ case "@target-uri":
117
+ return url.toString();
118
+ case "@scheme":
119
+ return url.protocol.replace(":", "");
120
+ case "@request-target":
121
+ return (url.pathname || "/") + url.search;
122
+ default: {
123
+ if (component.startsWith("@"))
124
+ throw new Error(`Unsupported derived component ${component}`);
125
+ const v = req.headers[component.toLowerCase()];
126
+ if (v === undefined)
127
+ throw new Error(`Covered header "${component}" is missing from the request`);
128
+ return v.trim().replace(/\s*\r?\n\s*/g, " ");
129
+ }
130
+ }
131
+ }
132
+ /** Build the exact signature base string (RFC 9421 section 2.5). */
133
+ export function signatureBase(req, sig) {
134
+ const lines = sig.components.map((c) => `"${c}": ${componentValue(req, c)}`);
135
+ lines.push(`"@signature-params": ${sig.paramsRaw}`);
136
+ return lines.join("\n");
137
+ }
138
+ export function inferAlg(jwk, declared) {
139
+ const d = (declared ?? jwk.alg ?? "").toString().toLowerCase();
140
+ if (d === "ed25519" || d === "eddsa")
141
+ return "ed25519";
142
+ if (d === "rsa-pss-sha512" || d === "ps512")
143
+ return "rsa-pss-sha512";
144
+ if (d === "rsa-pss-sha256" || d === "ps256")
145
+ return "ps256";
146
+ if (d === "ecdsa-p256-sha256" || d === "es256")
147
+ return "ecdsa-p256-sha256";
148
+ if (jwk.kty === "OKP" && jwk.crv === "Ed25519")
149
+ return "ed25519";
150
+ if (jwk.kty === "EC" && jwk.crv === "P-256")
151
+ return "ecdsa-p256-sha256";
152
+ if (jwk.kty === "RSA")
153
+ return "ps256";
154
+ return null;
155
+ }
156
+ export function verifyBytes(alg, key, data, signature) {
157
+ switch (alg) {
158
+ case "ed25519":
159
+ return nodeVerify(null, data, key, signature);
160
+ case "rsa-pss-sha512":
161
+ return nodeVerify("sha512", data, { key, padding: constants.RSA_PKCS1_PSS_PADDING, saltLength: 64 }, signature);
162
+ case "rsa-pss-sha256":
163
+ case "ps256":
164
+ return nodeVerify("sha256", data, { key, padding: constants.RSA_PKCS1_PSS_PADDING, saltLength: 32 }, signature);
165
+ case "ecdsa-p256-sha256":
166
+ return nodeVerify("sha256", data, { key, dsaEncoding: "ieee-p1363" }, signature);
167
+ }
168
+ }
169
+ export function signBytes(alg, privateKey, data) {
170
+ switch (alg) {
171
+ case "ed25519":
172
+ return nodeSign(null, data, privateKey);
173
+ case "rsa-pss-sha512":
174
+ return nodeSign("sha512", data, { key: privateKey, padding: constants.RSA_PKCS1_PSS_PADDING, saltLength: 64 });
175
+ case "rsa-pss-sha256":
176
+ case "ps256":
177
+ return nodeSign("sha256", data, { key: privateKey, padding: constants.RSA_PKCS1_PSS_PADDING, saltLength: 32 });
178
+ case "ecdsa-p256-sha256":
179
+ return nodeSign("sha256", data, { key: privateKey, dsaEncoding: "ieee-p1363" });
180
+ }
181
+ }
182
+ /** Sign a request the way an agent would. Used by tests, the playground and conformance vectors. */
183
+ export function signRequest(req, o) {
184
+ const alg = o.alg ?? "ed25519";
185
+ const components = o.components ?? ["@authority", "@path"];
186
+ const created = o.created ?? Math.floor(Date.now() / 1000);
187
+ const expires = o.expires ?? created + 480;
188
+ const label = o.label ?? "sig1";
189
+ const inner = "(" + components.map((c) => `"${c}"`).join(" ") + ")";
190
+ const paramsRaw = `${inner};created=${created};expires=${expires};keyid="${o.keyid}";alg="${alg}";nonce="${o.nonce}";tag="${o.tag}"`;
191
+ const base = signatureBase(req, { components, paramsRaw });
192
+ const pk = createPrivateKey({ key: o.privateJwk, format: "jwk" });
193
+ const sig = signBytes(alg, pk, Buffer.from(base, "utf8"));
194
+ return {
195
+ ...req,
196
+ headers: {
197
+ ...req.headers,
198
+ "signature-input": `${label}=${paramsRaw}`,
199
+ signature: `${label}=:${sig.toString("base64")}:`,
200
+ },
201
+ };
202
+ }
203
+ //# sourceMappingURL=httpsig.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"httpsig.js","sourceRoot":"","sources":["../src/httpsig.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ export { ProveTheBuy, contextFromBody } from "./verify.js";
2
+ export type { ProveTheBuyOptions, CheckoutContext, AgentStats, ReputationProvider } from "./verify.js";
3
+ export { KeyDirectory, KNOWN_DIRECTORIES, importJwk, jwkSnapshot, publicJwk } from "./keys.js";
4
+ export type { Jwk, Jwks, DirectorySource, ResolvedKey } from "./keys.js";
5
+ export { MemoryReplayStore, RedisReplayStore, UpstashReplayStore } from "./replay.js";
6
+ export type { ReplayStore, RedisLike, UpstashReplayStoreOptions } from "./replay.js";
7
+ export { connectCloud } from "./cloud.js";
8
+ export { verifyConfirmation } from "./confirmation.js";
9
+ export type { ConfirmationClaims } from "./confirmation.js";
10
+ export type { CloudOptions, CloudConnection, CloudStats } from "./cloud.js";
11
+ export { parseSignatureInput, parseSignatureHeader, signatureBase, signRequest, AGENT_TAGS } from "./httpsig.js";
12
+ export type { HttpRequestLike, ParsedSignature, AgentTag, SigAlg } from "./httpsig.js";
13
+ export { DEFAULT_POLICY, resolvePolicy } from "./policy.js";
14
+ export type { Policy, PolicyInput } from "./policy.js";
15
+ export { orderHash, itemsTotal, formatMoney } from "./order.js";
16
+ export { checkPaymentLimits } from "./payment.js";
17
+ export type { PaymentCredential, PaymentAllowance } from "./payment.js";
18
+ export { verifyBodyObject, signBodyObject } from "./bodyObjects.js";
19
+ export type { SignedBodyObject } from "./bodyObjects.js";
20
+ export { verifyMandate } from "./mandates/index.js";
21
+ export type { Mandate, VerifiableIntentMandate, Ap2CartMandate, Ap2IntentMandate } from "./mandates/index.js";
22
+ export { EvidenceLedger, FileLedger, recordHash } from "./ledger.js";
23
+ export type { LedgerRecord, VerificationRecord, DisputeRecord } from "./ledger.js";
24
+ export { buildEvidencePack, reverifyRecord } from "./evidence.js";
25
+ export type { EvidencePack, DisputeInput, ReverifyResult } from "./evidence.js";
26
+ export { agentSummaries, ledgerReputation } from "./reputation.js";
27
+ export type { AgentSummary } from "./reputation.js";
28
+ export { canonicalize } from "./util.js";
29
+ export type { Check, CheckStatus, Decision, Order, OrderItem, VerificationResult, AgentInfo, MandateInfo, Money } from "./types.js";
package/dist/index.js ADDED
@@ -0,0 +1,16 @@
1
+ export { ProveTheBuy, contextFromBody } from "./verify.js";
2
+ export { KeyDirectory, KNOWN_DIRECTORIES, importJwk, jwkSnapshot, publicJwk } from "./keys.js";
3
+ export { MemoryReplayStore, RedisReplayStore, UpstashReplayStore } from "./replay.js";
4
+ export { connectCloud } from "./cloud.js";
5
+ export { verifyConfirmation } from "./confirmation.js";
6
+ export { parseSignatureInput, parseSignatureHeader, signatureBase, signRequest, AGENT_TAGS } from "./httpsig.js";
7
+ export { DEFAULT_POLICY, resolvePolicy } from "./policy.js";
8
+ export { orderHash, itemsTotal, formatMoney } from "./order.js";
9
+ export { checkPaymentLimits } from "./payment.js";
10
+ export { verifyBodyObject, signBodyObject } from "./bodyObjects.js";
11
+ export { verifyMandate } from "./mandates/index.js";
12
+ export { EvidenceLedger, FileLedger, recordHash } from "./ledger.js";
13
+ export { buildEvidencePack, reverifyRecord } from "./evidence.js";
14
+ export { agentSummaries, ledgerReputation } from "./reputation.js";
15
+ export { canonicalize } from "./util.js";
16
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE/F,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEjH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}
package/dist/jws.d.ts ADDED
@@ -0,0 +1,28 @@
1
+ /** Compact JWS and SD-JWT helpers (EdDSA, ES256, PS256). */
2
+ import { KeyObject } from "node:crypto";
3
+ import { type Jwk } from "./keys.js";
4
+ export interface JwsResult<T = Record<string, unknown>> {
5
+ header: Record<string, unknown>;
6
+ payload: T;
7
+ }
8
+ export declare function joseAlgFor(jwk: Jwk): string;
9
+ export declare function signJws(payload: unknown, privateJwk: Jwk, extraHeader?: Record<string, unknown>): string;
10
+ export declare function decodeJws<T = Record<string, unknown>>(jws: string): JwsResult<T>;
11
+ export declare function verifyJws<T = Record<string, unknown>>(jws: string, key: Jwk | KeyObject): JwsResult<T>;
12
+ export interface SdJwtParts {
13
+ jwt: string;
14
+ disclosures: string[];
15
+ }
16
+ export declare function splitSdJwt(sdjwt: string): SdJwtParts;
17
+ /** Create a disclosure for one claim: base64url(JSON [salt, name, value]). */
18
+ export declare function makeDisclosure(name: string, value: unknown, salt: string): string;
19
+ export declare function disclosureDigest(disclosure: string): string;
20
+ /**
21
+ * Issue an SD-JWT: the listed claims are moved behind disclosures and replaced by their digests in _sd.
22
+ */
23
+ export declare function issueSdJwt(claims: Record<string, unknown>, selective: string[], privateJwk: Jwk, saltFn: (n: string) => string): string;
24
+ /** Verify issuer signature and reveal disclosed claims. Rejects disclosures not committed in _sd. */
25
+ export declare function verifySdJwt(sdjwt: string, key: Jwk | KeyObject): {
26
+ header: Record<string, unknown>;
27
+ claims: Record<string, unknown>;
28
+ };