@peac/schema 0.9.18

package/dist/evidence.d.ts

@@ -0,0 +1,267 @@
+/**
+ * PEAC Evidence Types
+ *
+ * Payment and attestation evidence for receipts.
+ */
+/**
+ * Payment rail identifier (vendor-neutral string)
+ *
+ * Common rails (see docs/specs/registries.json):
+ * - "x402" - HTTP 402 paid calls
+ * - "l402" - Lightning HTTP 402 (LSAT)
+ * - "card-network" - Generic card networks
+ * - "upi" - Unified Payments Interface
+ *
+ * Rail identifiers are opaque strings. Vendor-specific details
+ * belong in payment.evidence or adapter packages (@peac/rails-*).
+ */
+export type PaymentRailId = string;
+/**
+ * @deprecated Use PaymentRailId. Type renamed in v0.9.15. Will be removed in v0.9.17.
+ */
+export type PaymentScheme = PaymentRailId;
+/**
+ * Payment split - allocation of payment to a party
+ *
+ * Used for marketplace/aggregator scenarios where a single payment
+ * is split among multiple parties (platform, merchant, affiliates, etc.)
+ *
+ * Invariants:
+ * - `party` is REQUIRED (identifies the recipient)
+ * - `amount` if present MUST be >= 0
+ * - `share` if present MUST be in [0,1]
+ * - At least one of `amount` or `share` MUST be specified
+ *
+ * Note: The sum of splits is NOT enforced to equal the total payment amount.
+ * This is by design - partial splits, fees, and platform-specific allocation
+ * logic are all valid use cases.
+ */
+export interface PaymentSplit {
+    /**
+     * Party identifier (REQUIRED)
+     *
+     * Identifies the recipient of this split. Examples:
+     * - "merchant" - Primary merchant
+     * - "platform" - Platform fee
+     * - "affiliate:partner_123" - Affiliate/referral
+     * - "tax" - Tax authority
+     */
+    party: string;
+    /**
+     * Absolute amount in smallest currency unit (OPTIONAL)
+     *
+     * Must be >= 0 if specified.
+     * Examples: 1000 (for $10.00 in USD), 50000 (for 500.00 INR)
+     */
+    amount?: number;
+    /**
+     * ISO 4217 currency code (OPTIONAL)
+     *
+     * Uppercase 3-letter code. Defaults to parent payment's currency if omitted.
+     */
+    currency?: string;
+    /**
+     * Fractional share of the total (OPTIONAL)
+     *
+     * Must be in [0,1] if specified.
+     * Examples: 0.8 (80%), 0.15 (15%), 0.05 (5%)
+     */
+    share?: number;
+    /**
+     * Payment rail for this split (OPTIONAL)
+     *
+     * If different from parent payment's rail.
+     */
+    rail?: PaymentRailId;
+    /**
+     * Account reference for the recipient (OPTIONAL)
+     *
+     * Examples:
+     * - "acct_merchant_abc" - Merchant account
+     * - "upi:merchant@bank" - UPI VPA
+     * - "wallet_xyz" - Wallet ID
+     */
+    account_ref?: string;
+    /**
+     * Additional metadata (OPTIONAL)
+     *
+     * Rail-specific or application-specific data.
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Payment evidence - rail-agnostic normalized payment
+ *
+ * All payment rails MUST produce this normalized structure.
+ * Rail-specific details go in the `evidence` field.
+ *
+ * Invariants:
+ * - `asset` and `env` are REQUIRED
+ * - `network` is OPTIONAL but SHOULD be provided for crypto rails
+ * - `facilitator_ref` is OPTIONAL
+ * - `evidence` is opaque in v0.9; may become discriminated union in v1.0
+ */
+export interface PaymentEvidence {
+    /** Payment rail identifier */
+    rail: PaymentRailId;
+    /** Rail-specific payment reference/ID */
+    reference: string;
+    /** Amount in smallest currency unit (cents, sats, paise, etc.) */
+    amount: number;
+    /** ISO 4217 currency code (uppercase) */
+    currency: string;
+    /**
+     * Asset transferred (REQUIRED)
+     *
+     * Examples: "USD", "USDC", "BTC", "INR", "EUR"
+     *
+     * For crypto: use ticker symbol
+     * For fiat: use ISO 4217 code
+     */
+    asset: string;
+    /**
+     * Environment (REQUIRED)
+     *
+     * - "live": Production/real money
+     * - "test": Sandbox/test mode
+     */
+    env: 'live' | 'test';
+    /**
+     * Network/rail identifier (OPTIONAL, SHOULD for crypto)
+     *
+     * Examples:
+     * - "lightning" - Bitcoin Lightning Network
+     * - "base-mainnet" - Base (Coinbase L2)
+     * - "solana" - Solana mainnet
+     * - "upi" - Unified Payments Interface (India)
+     * - "ach" - ACH network (US)
+     *
+     * Not applicable for traditional payment processors.
+     */
+    network?: string;
+    /**
+     * Facilitator reference (OPTIONAL)
+     *
+     * Stable identifier for the PSP/facilitator processing this payment.
+     *
+     * Examples:
+     * - "acct_1234567890"
+     * - "facilitator_account_xyz"
+     * - "acc_ABC123"
+     */
+    facilitator_ref?: string;
+    /**
+     * Rail-specific evidence (opaque in v0.9)
+     *
+     * Structure varies by rail. Examples:
+     *
+     * x402/Lightning:
+     * {
+     *   "preimage": "...",
+     *   "invoice": "lnbc...",
+     *   "settled_at": 1234567890,
+     *   "node_id": "03..."
+     * }
+     *
+     * Traditional payment processor:
+     * {
+     *   "payment_intent": "pi_...",
+     *   "session_id": "cs_...",
+     *   "payment_method": "pm_...",
+     *   "customer_id": "cus_..."
+     * }
+     *
+     * UPI:
+     * {
+     *   "vpa": "user@bank",
+     *   "txn_id": "...",
+     *   "approver": "..."
+     * }
+     *
+     * Future: May become discriminated union in v1.0.
+     */
+    evidence: unknown;
+    /**
+     * Aggregator/marketplace identifier (OPTIONAL)
+     *
+     * Identifies the platform or aggregator processing this payment
+     * on behalf of sub-merchants. Examples:
+     * - "marketplace_abc" - Marketplace ID
+     * - "platform:uber" - Platform identifier
+     * - "aggregator_xyz" - Payment aggregator
+     */
+    aggregator?: string;
+    /**
+     * Payment splits (OPTIONAL)
+     *
+     * Allocation of payment among multiple parties.
+     * Used for marketplace scenarios, affiliate payouts,
+     * platform fees, tax withholding, etc.
+     *
+     * Note: Sum of splits is NOT required to equal total amount.
+     */
+    splits?: PaymentSplit[];
+    /**
+     * Payment routing mode (OPTIONAL, rail-agnostic)
+     *
+     * Describes how the payment is routed between payer, aggregator, and merchant.
+     * This is a generic hint - specific rails populate it from their native formats.
+     *
+     * Values:
+     * - "direct": Direct payment to merchant (no intermediary)
+     * - "callback": Routed via callback URL / payment service
+     * - "role": Role-based routing (e.g., "publisher", "platform")
+     *
+     * Examples of producers:
+     * - x402 v2 `payTo.mode` -> routing
+     * - Stripe Connect `destination` -> routing = 'direct' or 'callback'
+     * - UPI `pa` (payee address) -> routing = 'direct'
+     */
+    routing?: 'direct' | 'callback' | 'role';
+}
+/**
+ * Attestation evidence - TEE/platform attestation
+ *
+ * Used for proving the execution environment or platform
+ * properties of the issuer/verifier.
+ *
+ * Examples:
+ * - TPM attestation
+ * - SGX attestation
+ * - AWS Nitro Enclaves
+ * - SEV-SNP attestation
+ */
+export interface AttestationEvidence {
+    /**
+     * Attestation format
+     *
+     * Well-known formats:
+     * - "tpm2.0" - TPM 2.0 attestation
+     * - "sgx" - Intel SGX attestation
+     * - "sev-snp" - AMD SEV-SNP attestation
+     * - "nitro" - AWS Nitro Enclaves
+     * - "custom" - Custom attestation format
+     */
+    format: string;
+    /**
+     * Attestation-specific evidence
+     *
+     * Structure varies by format. Examples:
+     *
+     * TPM 2.0:
+     * {
+     *   "pcr_values": {...},
+     *   "quote": "...",
+     *   "signature": "..."
+     * }
+     *
+     * SGX:
+     * {
+     *   "quote": "...",
+     *   "mrenclave": "...",
+     *   "mrsigner": "..."
+     * }
+     */
+    evidence: unknown;
+}
+//# sourceMappingURL=evidence.d.ts.map

package/dist/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../src/evidence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;OAQG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;IAErB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,IAAI,EAAE,aAAa,CAAC;IAEpB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAElB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IAEf,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;;;OAOG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAErB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IAExB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;CAC1C;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;OASG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/evidence.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * PEAC Evidence Types
+ *
+ * Payment and attestation evidence for receipts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=evidence.js.map

package/dist/evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../src/evidence.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * PEAC Protocol Schema Package
+ * Wire format frozen at peac.receipt/0.9 with v1.0-equivalent semantics
+ */
+export * from './envelope';
+export * from './control';
+export * from './evidence';
+export * from './subject';
+export * from './errors';
+export * from './normalize';
+export * from './constants';
+export * from './types';
+export { NormalizedPayment, Extensions, JWSHeader, ReceiptClaims, Subject as SubjectSchema, AIPREFSnapshot as AIPREFSnapshotSchema, VerifyRequest as VerifyRequestSchema, ControlPurposeSchema, ControlLicensingModeSchema, ControlDecisionSchema, ControlStepSchema, ControlBlockSchema, PaymentSplitSchema, PaymentEvidenceSchema, PaymentRoutingSchema, SubjectTypeSchema, SubjectProfileSchema, SubjectProfileSnapshotSchema, validateSubjectSnapshot, } from './validators';
+export type { PEACEnvelope, AuthContext, EvidenceBlock, MetadataBlock, EnforcementContext, TransportBinding, ContextMetadata, } from './envelope';
+//# 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;AAGH,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,aAAa,EACb,OAAO,IAAI,aAAa,EACxB,cAAc,IAAI,oBAAoB,EACtC,aAAa,IAAI,mBAAmB,EAEpC,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAElB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EAEpB,iBAAiB,EACjB,oBAAoB,EACpB,4BAA4B,EAE5B,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * PEAC Protocol Schema Package
+ * Wire format frozen at peac.receipt/0.9 with v1.0-equivalent semantics
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateSubjectSnapshot = exports.SubjectProfileSnapshotSchema = exports.SubjectProfileSchema = exports.SubjectTypeSchema = exports.PaymentRoutingSchema = exports.PaymentEvidenceSchema = exports.PaymentSplitSchema = exports.ControlBlockSchema = exports.ControlStepSchema = exports.ControlDecisionSchema = exports.ControlLicensingModeSchema = exports.ControlPurposeSchema = exports.VerifyRequestSchema = exports.AIPREFSnapshotSchema = exports.SubjectSchema = exports.ReceiptClaims = exports.JWSHeader = exports.Extensions = exports.NormalizedPayment = void 0;
+// Core envelope and types
+__exportStar(require("./envelope"), exports);
+__exportStar(require("./control"), exports);
+__exportStar(require("./evidence"), exports);
+__exportStar(require("./subject"), exports);
+__exportStar(require("./errors"), exports);
+__exportStar(require("./normalize"), exports);
+// Legacy types (for backward compatibility in tests)
+__exportStar(require("./constants"), exports);
+__exportStar(require("./types"), exports);
+// Validators (explicit exports to avoid name conflicts with types)
+var validators_1 = require("./validators");
+Object.defineProperty(exports, "NormalizedPayment", { enumerable: true, get: function () { return validators_1.NormalizedPayment; } });
+Object.defineProperty(exports, "Extensions", { enumerable: true, get: function () { return validators_1.Extensions; } });
+Object.defineProperty(exports, "JWSHeader", { enumerable: true, get: function () { return validators_1.JWSHeader; } });
+Object.defineProperty(exports, "ReceiptClaims", { enumerable: true, get: function () { return validators_1.ReceiptClaims; } });
+Object.defineProperty(exports, "SubjectSchema", { enumerable: true, get: function () { return validators_1.Subject; } });
+Object.defineProperty(exports, "AIPREFSnapshotSchema", { enumerable: true, get: function () { return validators_1.AIPREFSnapshot; } });
+Object.defineProperty(exports, "VerifyRequestSchema", { enumerable: true, get: function () { return validators_1.VerifyRequest; } });
+// CAL validators (v0.9.16+)
+Object.defineProperty(exports, "ControlPurposeSchema", { enumerable: true, get: function () { return validators_1.ControlPurposeSchema; } });
+Object.defineProperty(exports, "ControlLicensingModeSchema", { enumerable: true, get: function () { return validators_1.ControlLicensingModeSchema; } });
+Object.defineProperty(exports, "ControlDecisionSchema", { enumerable: true, get: function () { return validators_1.ControlDecisionSchema; } });
+Object.defineProperty(exports, "ControlStepSchema", { enumerable: true, get: function () { return validators_1.ControlStepSchema; } });
+Object.defineProperty(exports, "ControlBlockSchema", { enumerable: true, get: function () { return validators_1.ControlBlockSchema; } });
+// Payment evidence validators (v0.9.16+)
+Object.defineProperty(exports, "PaymentSplitSchema", { enumerable: true, get: function () { return validators_1.PaymentSplitSchema; } });
+Object.defineProperty(exports, "PaymentEvidenceSchema", { enumerable: true, get: function () { return validators_1.PaymentEvidenceSchema; } });
+Object.defineProperty(exports, "PaymentRoutingSchema", { enumerable: true, get: function () { return validators_1.PaymentRoutingSchema; } });
+// Subject profile validators (v0.9.16+)
+Object.defineProperty(exports, "SubjectTypeSchema", { enumerable: true, get: function () { return validators_1.SubjectTypeSchema; } });
+Object.defineProperty(exports, "SubjectProfileSchema", { enumerable: true, get: function () { return validators_1.SubjectProfileSchema; } });
+Object.defineProperty(exports, "SubjectProfileSnapshotSchema", { enumerable: true, get: function () { return validators_1.SubjectProfileSnapshotSchema; } });
+// Subject snapshot validation helper (v0.9.17+)
+Object.defineProperty(exports, "validateSubjectSnapshot", { enumerable: true, get: function () { return validators_1.validateSubjectSnapshot; } });
+//# 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;;;;;;;;;;;;;;;;;AAEH,0BAA0B;AAC1B,6CAA2B;AAC3B,4CAA0B;AAC1B,6CAA2B;AAC3B,4CAA0B;AAC1B,2CAAyB;AACzB,8CAA4B;AAE5B,qDAAqD;AACrD,8CAA4B;AAC5B,0CAAwB;AAExB,mEAAmE;AACnE,2CAwBsB;AAvBpB,+GAAA,iBAAiB,OAAA;AACjB,wGAAA,UAAU,OAAA;AACV,uGAAA,SAAS,OAAA;AACT,2GAAA,aAAa,OAAA;AACb,2GAAA,OAAO,OAAiB;AACxB,kHAAA,cAAc,OAAwB;AACtC,iHAAA,aAAa,OAAuB;AACpC,4BAA4B;AAC5B,kHAAA,oBAAoB,OAAA;AACpB,wHAAA,0BAA0B,OAAA;AAC1B,mHAAA,qBAAqB,OAAA;AACrB,+GAAA,iBAAiB,OAAA;AACjB,gHAAA,kBAAkB,OAAA;AAClB,yCAAyC;AACzC,gHAAA,kBAAkB,OAAA;AAClB,mHAAA,qBAAqB,OAAA;AACrB,kHAAA,oBAAoB,OAAA;AACpB,wCAAwC;AACxC,+GAAA,iBAAiB,OAAA;AACjB,kHAAA,oBAAoB,OAAA;AACpB,0HAAA,4BAA4B,OAAA;AAC5B,gDAAgD;AAChD,qHAAA,uBAAuB,OAAA"}

package/dist/normalize.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Schema Normalization
+ *
+ * Functions to normalize receipt claims to a canonical form for comparison.
+ * Produces byte-identical JCS output regardless of how the receipt was created.
+ */
+import type { PEACReceiptClaims, Subject } from './types.js';
+/**
+ * Normalized core claims for comparison.
+ *
+ * This is the minimal set of fields that represent the semantic meaning
+ * of a receipt. All optional fields that are undefined are omitted.
+ */
+export interface CoreClaims {
+    /** Issuer URL */
+    iss: string;
+    /** Audience / resource URL */
+    aud: string;
+    /** Receipt ID */
+    rid: string;
+    /** Issued at timestamp */
+    iat: number;
+    /** Expiry timestamp (omitted if not present) */
+    exp?: number;
+    /** Amount in smallest currency unit */
+    amt: number;
+    /** Currency code (ISO 4217) */
+    cur: string;
+    /** Normalized payment evidence */
+    payment: NormalizedPayment;
+    /** Subject (omitted if not present) */
+    subject?: Subject;
+    /** Control block (omitted if not present) */
+    control?: NormalizedControl;
+}
+/**
+ * Normalized payment evidence for comparison.
+ *
+ * Only includes the semantic fields, not rail-specific evidence.
+ */
+export interface NormalizedPayment {
+    rail: string;
+    reference: string;
+    amount: number;
+    currency: string;
+    asset: string;
+    env: 'live' | 'test';
+    network?: string;
+    aggregator?: string;
+    routing?: 'direct' | 'callback' | 'role';
+}
+/**
+ * Normalized control block for comparison.
+ */
+export interface NormalizedControl {
+    chain: NormalizedControlStep[];
+}
+/**
+ * Normalized control step for comparison.
+ */
+export interface NormalizedControlStep {
+    engine: string;
+    result: string;
+}
+/**
+ * Extract core claims from a receipt for comparison.
+ *
+ * This function produces a normalized object that can be JCS-canonicalized
+ * to produce byte-identical output regardless of how the receipt was created
+ * (via x402, TAP, RSL, ACP, or direct issuance).
+ *
+ * The output:
+ * - Contains only semantically meaningful fields
+ * - Omits undefined optional fields (not null, not empty string)
+ * - Uses consistent field ordering (JCS handles this)
+ * - Strips rail-specific evidence details
+ *
+ * @param claims - Receipt claims to normalize
+ * @returns Normalized core claims
+ *
+ * @example
+ * ```ts
+ * import { toCoreClaims } from '@peac/schema';
+ * import { canonicalize } from '@peac/crypto';
+ *
+ * const core = toCoreClaims(receiptClaims);
+ * const canonical = canonicalize(core);
+ * // canonical is byte-identical regardless of source
+ * ```
+ */
+export declare function toCoreClaims(claims: PEACReceiptClaims): CoreClaims;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI7D;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,uCAAuC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,qBAAqB,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAmDD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,UAAU,CAyBlE"}

package/dist/normalize.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * Schema Normalization
+ *
+ * Functions to normalize receipt claims to a canonical form for comparison.
+ * Produces byte-identical JCS output regardless of how the receipt was created.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toCoreClaims = toCoreClaims;
+/**
+ * Normalize a payment evidence object.
+ *
+ * Extracts only the semantic fields, omitting rail-specific evidence
+ * and optional fields that are undefined.
+ */
+function normalizePayment(payment) {
+    const result = {
+        rail: payment.rail,
+        reference: payment.reference,
+        amount: payment.amount,
+        currency: payment.currency,
+        asset: payment.asset,
+        env: payment.env,
+    };
+    // Only include optional fields if defined
+    if (payment.network !== undefined) {
+        result.network = payment.network;
+    }
+    if (payment.aggregator !== undefined) {
+        result.aggregator = payment.aggregator;
+    }
+    if (payment.routing !== undefined) {
+        result.routing = payment.routing;
+    }
+    return result;
+}
+/**
+ * Normalize a control step.
+ */
+function normalizeControlStep(step) {
+    return {
+        engine: step.engine,
+        result: step.result,
+    };
+}
+/**
+ * Normalize a control block.
+ */
+function normalizeControl(control) {
+    return {
+        chain: control.chain.map(normalizeControlStep),
+    };
+}
+/**
+ * Extract core claims from a receipt for comparison.
+ *
+ * This function produces a normalized object that can be JCS-canonicalized
+ * to produce byte-identical output regardless of how the receipt was created
+ * (via x402, TAP, RSL, ACP, or direct issuance).
+ *
+ * The output:
+ * - Contains only semantically meaningful fields
+ * - Omits undefined optional fields (not null, not empty string)
+ * - Uses consistent field ordering (JCS handles this)
+ * - Strips rail-specific evidence details
+ *
+ * @param claims - Receipt claims to normalize
+ * @returns Normalized core claims
+ *
+ * @example
+ * ```ts
+ * import { toCoreClaims } from '@peac/schema';
+ * import { canonicalize } from '@peac/crypto';
+ *
+ * const core = toCoreClaims(receiptClaims);
+ * const canonical = canonicalize(core);
+ * // canonical is byte-identical regardless of source
+ * ```
+ */
+function toCoreClaims(claims) {
+    const result = {
+        iss: claims.iss,
+        aud: claims.aud,
+        rid: claims.rid,
+        iat: claims.iat,
+        amt: claims.amt,
+        cur: claims.cur,
+        payment: normalizePayment(claims.payment),
+    };
+    // Only include optional fields if defined
+    if (claims.exp !== undefined) {
+        result.exp = claims.exp;
+    }
+    if (claims.subject !== undefined) {
+        result.subject = { uri: claims.subject.uri };
+    }
+    if (claims.ext?.control !== undefined) {
+        result.control = normalizeControl(claims.ext.control);
+    }
+    return result;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA8IH,oCAyBC;AApGD;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,OAAwB;IAChD,MAAM,MAAM,GAAsB;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC;IAEF,0CAA0C;IAC1C,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACnC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,IAAiB;IAC7C,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,OAAqB;IAC7C,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAgB,YAAY,CAAC,MAAyB;IACpD,MAAM,MAAM,GAAe;QACzB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC;KAC1C,CAAC;IAEF,0CAA0C;IAC1C,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,CAAC,OAAO,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,MAAM,CAAC,GAAG,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,CAAC,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,3 @@
+export declare const PEAC_VERSION = "0.9.11";
+export declare const SCHEMA_VERSION = "0.9.11";
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,WAAe,CAAC;AACzC,eAAO,MAAM,cAAc,WAAe,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEMA_VERSION = exports.PEAC_VERSION = void 0;
+const version_1 = require("./version");
+exports.PEAC_VERSION = version_1.WIRE_VERSION;
+exports.SCHEMA_VERSION = version_1.WIRE_VERSION;
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":";;;AAAA,uCAAyC;AAE5B,QAAA,YAAY,GAAG,sBAAY,CAAC;AAC5B,QAAA,cAAc,GAAG,sBAAY,CAAC"}