@portel/photon-core 1.4.0 → 2.1.0

package/dist/ucp/ap2/mandates.js

@@ -0,0 +1,234 @@
+/**
+ * AP2 Mandate Creation and Validation Helpers
+ */
+import * as crypto from 'crypto';
+/**
+ * Create a new Cart Mandate for human-present transactions
+ */
+export function createCartMandate(params, merchantPrivateKey) {
+    const contents = {
+        id: `cart_${crypto.randomUUID()}`,
+        userSignatureRequired: true,
+        paymentRequest: {
+            methodData: params.paymentMethods.map(method => ({
+                supportedMethods: method,
+                data: {}
+            })),
+            details: {
+                id: `order_${crypto.randomUUID()}`,
+                displayItems: params.items.map(item => ({
+                    label: item.label,
+                    amount: item.totalPrice
+                })),
+                total: {
+                    label: 'Total',
+                    amount: params.total
+                }
+            }
+        },
+        merchant: params.merchant,
+        fulfillment: params.fulfillment,
+        refundConditions: params.refundPeriodDays ? {
+            period: params.refundPeriodDays,
+            policy: `Full refund within ${params.refundPeriodDays} days of delivery`
+        } : undefined
+    };
+    const timestamp = new Date().toISOString();
+    const merchantSignature = merchantPrivateKey
+        ? signMandate(contents, merchantPrivateKey)
+        : `sig_merchant_${crypto.randomBytes(16).toString('hex')}`;
+    return {
+        contents,
+        merchantSignature,
+        timestamp
+    };
+}
+/**
+ * Add user signature to Cart Mandate
+ */
+export function signCartMandate(mandate, userPrivateKey) {
+    const userSignature = userPrivateKey
+        ? signMandate(mandate.contents, userPrivateKey)
+        : `sig_user_${crypto.randomBytes(16).toString('hex')}`;
+    return {
+        ...mandate,
+        userSignature,
+        userSignatureTimestamp: new Date().toISOString()
+    };
+}
+/**
+ * Create a new Intent Mandate for autonomous agent purchases
+ */
+export function createIntentMandate(params, userPrivateKey) {
+    const now = new Date();
+    const validUntil = new Date(now.getTime() + (params.validForHours || 24) * 60 * 60 * 1000);
+    const contents = {
+        id: `intent_${crypto.randomUUID()}`,
+        intent: {
+            description: params.description,
+            productCategories: params.productCategories,
+            specificSkus: params.specificSkus,
+            keywords: params.keywords
+        },
+        constraints: {
+            maxPrice: params.maxPrice,
+            minPrice: params.minPrice,
+            quantity: params.quantity,
+            merchants: params.allowedMerchants
+        },
+        timing: {
+            validFrom: now.toISOString(),
+            validUntil: validUntil.toISOString(),
+            executeWhen: params.executeWhen || 'immediately'
+        },
+        paymentAuthorization: {
+            methodCategories: params.paymentMethods,
+            preAuthorizedAmount: params.maxPrice
+        },
+        promptPlayback: params.promptPlayback
+    };
+    const userSignature = userPrivateKey
+        ? signMandate(contents, userPrivateKey)
+        : `sig_user_${crypto.randomBytes(16).toString('hex')}`;
+    return {
+        contents,
+        userSignature,
+        userSignatureTimestamp: now.toISOString()
+    };
+}
+/**
+ * Check if Intent Mandate is still valid
+ */
+export function isIntentMandateValid(mandate) {
+    const now = new Date();
+    const validFrom = new Date(mandate.contents.timing.validFrom);
+    const validUntil = new Date(mandate.contents.timing.validUntil);
+    return now >= validFrom && now <= validUntil;
+}
+/**
+ * Check if a price satisfies Intent Mandate constraints
+ */
+export function checkPriceConstraints(mandate, price) {
+    const { constraints } = mandate.contents;
+    if (price.currency !== constraints.maxPrice.currency) {
+        return { valid: false, reason: 'Currency mismatch' };
+    }
+    if (price.amount > constraints.maxPrice.amount) {
+        return { valid: false, reason: `Price ${price.amount} exceeds max ${constraints.maxPrice.amount}` };
+    }
+    if (constraints.minPrice && price.amount < constraints.minPrice.amount) {
+        return { valid: false, reason: `Price ${price.amount} below min ${constraints.minPrice.amount}` };
+    }
+    return { valid: true };
+}
+/**
+ * Create a Payment Mandate from Cart or Intent Mandate
+ */
+export function createPaymentMandate(params, userPrivateKey) {
+    const { sourceMandate, paymentResponse, agentName } = params;
+    const isCartMandate = 'merchantSignature' in sourceMandate;
+    const sourceMandateType = isCartMandate ? 'cart' : 'intent';
+    const sourceMandateId = sourceMandate.contents.id;
+    // Get total from source mandate
+    let total;
+    if (isCartMandate) {
+        total = sourceMandate.contents.paymentRequest.details.total.amount;
+    }
+    else {
+        total = sourceMandate.contents.constraints.maxPrice;
+    }
+    const contents = {
+        paymentMandateId: `pm_${crypto.randomUUID()}`,
+        paymentDetailsId: paymentResponse.requestId,
+        paymentDetailsTotal: {
+            label: 'Total',
+            amount: total,
+            refundPeriod: isCartMandate
+                ? sourceMandate.contents.refundConditions?.period
+                : 30
+        },
+        paymentResponse,
+        merchantAgent: agentName || 'MerchantAgent',
+        sourceMandateType,
+        sourceMandateId,
+        timestamp: new Date().toISOString()
+    };
+    const userAuthorization = userPrivateKey
+        ? signMandate(contents, userPrivateKey)
+        : `auth_${crypto.randomBytes(32).toString('base64url')}`;
+    return {
+        paymentMandateContents: contents,
+        userAuthorization
+    };
+}
+// ============================================================================
+// Signature Helpers
+// ============================================================================
+/**
+ * Sign mandate contents (simplified - production should use proper PKI)
+ */
+function signMandate(contents, privateKey) {
+    const payload = JSON.stringify(contents);
+    const hmac = crypto.createHmac('sha256', privateKey);
+    hmac.update(payload);
+    return `sig_${hmac.digest('base64url')}`;
+}
+/**
+ * Verify mandate signature
+ */
+export function verifyMandateSignature(contents, signature, publicKey) {
+    // Simplified verification - production should use proper PKI
+    const expectedSig = signMandate(contents, publicKey);
+    return signature === expectedSig;
+}
+// ============================================================================
+// Transaction Context
+// ============================================================================
+/**
+ * Create transaction context for audit trail
+ */
+export function createTransactionContext(params) {
+    return {
+        modality: params.modality,
+        agentPresent: true,
+        initiatedBy: params.initiatedBy,
+        sessionId: `session_${crypto.randomUUID()}`,
+        startTime: new Date().toISOString(),
+        mandateChain: params.mandates.map(mandate => {
+            if ('merchantSignature' in mandate) {
+                return {
+                    type: 'cart',
+                    id: mandate.contents.id,
+                    timestamp: mandate.timestamp
+                };
+            }
+            else if ('paymentMandateContents' in mandate) {
+                return {
+                    type: 'payment',
+                    id: mandate.paymentMandateContents.paymentMandateId,
+                    timestamp: mandate.paymentMandateContents.timestamp
+                };
+            }
+            else {
+                return {
+                    type: 'intent',
+                    id: mandate.contents.id,
+                    timestamp: mandate.userSignatureTimestamp
+                };
+            }
+        })
+    };
+}
+// ============================================================================
+// Risk Assessment
+// ============================================================================
+/**
+ * Create risk payload for payment authorization
+ */
+export function createRiskPayload(params) {
+    return {
+        ...params,
+        authTimestamp: new Date().toISOString()
+    };
+}
+//# sourceMappingURL=mandates.js.map

package/dist/ucp/ap2/mandates.js.map

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

package/dist/ucp/ap2/types.d.ts

@@ -0,0 +1,305 @@
+/**
+ * Agent Payments Protocol (AP2) Type Definitions
+ *
+ * Based on AP2 specification from https://github.com/google-agentic-commerce/AP2
+ * Provides secure payment mandate handling for agentic commerce.
+ */
+import { Money, Address } from '../types.js';
+export interface DeviceInfo {
+    model: string;
+    vendor: string;
+    platform?: string;
+    appPackage?: string;
+    appVersion?: string;
+}
+export interface AgentInfo {
+    id: string;
+    name: string;
+    version: string;
+    capabilities?: string[];
+}
+export type PaymentMethodType = 'CARD' | 'BANK_TRANSFER' | 'WALLET' | 'CRYPTO' | 'STABLECOIN';
+export interface PaymentMethodData {
+    supportedMethods: PaymentMethodType;
+    data?: {
+        paymentProcessorUrl?: string;
+        supportedNetworks?: string[];
+        supportedTypes?: string[];
+    };
+}
+export interface PaymentDetails {
+    id: string;
+    displayItems: {
+        label: string;
+        amount: Money;
+        pending?: boolean;
+    }[];
+    total: {
+        label: string;
+        amount: Money;
+    };
+    shippingOptions?: {
+        id: string;
+        label: string;
+        amount: Money;
+        selected?: boolean;
+    }[];
+}
+export interface PaymentResponse {
+    requestId: string;
+    methodName: PaymentMethodType;
+    details: {
+        token?: string;
+        cardNetwork?: string;
+        cardLastFour?: string;
+        billingAddress?: Address;
+    };
+}
+/**
+ * Cart Mandate - Used when human is present for explicit approval
+ *
+ * Captures:
+ * - Exact items being purchased
+ * - Final pricing
+ * - Selected payment method
+ * - Merchant commitment via signature
+ */
+export interface CartMandateContents {
+    id: string;
+    userSignatureRequired: boolean;
+    paymentRequest: {
+        methodData: PaymentMethodData[];
+        details: PaymentDetails;
+        options?: {
+            requestPayerName?: boolean;
+            requestPayerEmail?: boolean;
+            requestPayerPhone?: boolean;
+            requestShipping?: boolean;
+        };
+    };
+    merchant: {
+        id: string;
+        name: string;
+        url?: string;
+    };
+    fulfillment?: {
+        method: string;
+        destination: Address;
+        estimatedDelivery?: string;
+    };
+    refundConditions?: {
+        period: number;
+        policy: string;
+    };
+}
+export interface CartMandate {
+    contents: CartMandateContents;
+    merchantSignature: string;
+    timestamp: string;
+    userSignature?: string;
+    userSignatureTimestamp?: string;
+}
+/**
+ * Intent Mandate - Used for delegated autonomous purchases
+ *
+ * Captures:
+ * - Shopping intent (what to buy)
+ * - Constraints (price limits, timing)
+ * - Pre-authorization for agent to act
+ */
+export interface IntentMandateContents {
+    id: string;
+    intent: {
+        description: string;
+        productCategories?: string[];
+        specificSkus?: string[];
+        keywords?: string[];
+    };
+    constraints: {
+        maxPrice: Money;
+        minPrice?: Money;
+        quantity?: {
+            min?: number;
+            max?: number;
+        };
+        merchants?: string[];
+        excludeMerchants?: string[];
+    };
+    timing: {
+        validFrom: string;
+        validUntil: string;
+        executeWhen?: 'immediately' | 'price_drop' | 'in_stock' | 'scheduled';
+        scheduledTime?: string;
+    };
+    paymentAuthorization: {
+        methodCategories: PaymentMethodType[];
+        preAuthorizedAmount?: Money;
+    };
+    promptPlayback?: string;
+}
+export interface IntentMandate {
+    contents: IntentMandateContents;
+    userSignature: string;
+    userSignatureTimestamp: string;
+    deviceAttestation?: string;
+}
+/**
+ * Payment Mandate - Links transaction to payment
+ *
+ * Provides:
+ * - Visibility into agentic transaction
+ * - Bound reference to Cart/Intent Mandate
+ * - Dispute evidence container
+ */
+export interface PaymentMandateContents {
+    paymentMandateId: string;
+    paymentDetailsId: string;
+    paymentDetailsTotal: {
+        label: string;
+        amount: Money;
+        refundPeriod?: number;
+    };
+    paymentResponse: PaymentResponse;
+    agentInfo?: AgentInfo;
+    merchantAgent: string;
+    sourceMandateType: 'cart' | 'intent';
+    sourceMandateId: string;
+    timestamp: string;
+}
+export interface PaymentMandate {
+    paymentMandateContents: PaymentMandateContents;
+    userAuthorization: string;
+}
+export interface VerifiableCredential {
+    '@context': string[];
+    type: string[];
+    issuer: string;
+    issuanceDate: string;
+    expirationDate?: string;
+    credentialSubject: {
+        id: string;
+        [key: string]: any;
+    };
+    proof: {
+        type: string;
+        created: string;
+        verificationMethod: string;
+        proofPurpose: string;
+        proofValue: string;
+    };
+}
+export interface RiskPayload {
+    deviceFingerprint?: string;
+    ipAddress?: string;
+    userAgent?: string;
+    sessionDuration?: number;
+    interactionCount?: number;
+    previousPurchases?: number;
+    authLevel: 'none' | 'basic' | 'mfa' | 'biometric';
+    authTimestamp?: string;
+    agentTrustScore?: number;
+    agentVerified?: boolean;
+    custom?: Record<string, any>;
+}
+export type DisputeReason = 'unauthorized' | 'not_received' | 'not_as_described' | 'duplicate' | 'cancelled' | 'credit_not_processed' | 'other';
+export interface DisputeEvidence {
+    transactionId: string;
+    reason: DisputeReason;
+    cartMandate?: CartMandate;
+    intentMandate?: IntentMandate;
+    paymentMandate?: PaymentMandate;
+    fulfillmentProof?: {
+        carrier: string;
+        trackingNumber: string;
+        deliveryConfirmation?: string;
+        signatureImage?: string;
+    };
+    communications?: {
+        timestamp: string;
+        channel: string;
+        content: string;
+    }[];
+    additionalDocs?: {
+        type: string;
+        url: string;
+        description: string;
+    }[];
+}
+export interface AgentCapabilityExtension {
+    description: string;
+    required: boolean;
+    uri: string;
+}
+export interface AgentSkill {
+    id: string;
+    name: string;
+    description: string;
+    tags?: string[];
+}
+export interface AgentCard {
+    name: string;
+    description: string;
+    version: string;
+    url: string;
+    capabilities?: {
+        extensions?: AgentCapabilityExtension[];
+    };
+    skills?: AgentSkill[];
+    security?: {
+        oauth2?: string[];
+    }[];
+}
+export type TransactionModality = 'human_present' | 'human_not_present';
+export interface TransactionContext {
+    modality: TransactionModality;
+    agentPresent: boolean;
+    initiatedBy: 'user' | 'agent';
+    sessionId: string;
+    startTime: string;
+    mandateChain: {
+        type: 'cart' | 'intent' | 'payment';
+        id: string;
+        timestamp: string;
+    }[];
+}
+export interface PaymentHandler {
+    name: string;
+    supportedMethods: PaymentMethodType[];
+    supportedCurrencies: string[];
+    tokenize(params: {
+        mandate: PaymentMandate;
+        paymentMethod: PaymentMethodData;
+    }): Promise<{
+        token: string;
+        expiresAt: string;
+    }>;
+    authorize(params: {
+        token: string;
+        amount: Money;
+        mandate: PaymentMandate;
+        riskPayload?: RiskPayload;
+    }): Promise<{
+        authorizationId: string;
+        status: 'authorized' | 'declined' | 'pending';
+        declineReason?: string;
+    }>;
+    capture(params: {
+        authorizationId: string;
+        amount?: Money;
+    }): Promise<{
+        captureId: string;
+        status: 'captured' | 'failed';
+    }>;
+    refund(params: {
+        captureId: string;
+        amount?: Money;
+        reason?: string;
+    }): Promise<{
+        refundId: string;
+        status: 'refunded' | 'pending' | 'failed';
+    }>;
+    void(authorizationId: string): Promise<{
+        status: 'voided' | 'failed';
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ucp/ap2/types.d.ts.map

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

package/dist/ucp/ap2/types.js

@@ -0,0 +1,8 @@
+/**
+ * Agent Payments Protocol (AP2) Type Definitions
+ *
+ * Based on AP2 specification from https://github.com/google-agentic-commerce/AP2
+ * Provides secure payment mandate handling for agentic commerce.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ucp/ap2/types.js.map

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

package/dist/ucp/capabilities/checkout.d.ts

@@ -0,0 +1,118 @@
+/**
+ * UCP Checkout Capability Implementation
+ *
+ * Provides cart management, pricing, and checkout session handling.
+ */
+import { CheckoutSession, LineItem, DiscountAllocation, FulfillmentOption, FulfillmentDestination, BuyerInfo, PaymentMethodInfo, Order, Money } from '../types.js';
+import { PaymentMandate, CartMandate } from '../ap2/types.js';
+export interface SessionStorage {
+    get(sessionId: string): Promise<CheckoutSession | null>;
+    set(session: CheckoutSession): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+    cleanup(): Promise<void>;
+}
+/**
+ * In-memory session storage (for development/testing)
+ */
+export declare class MemorySessionStorage implements SessionStorage {
+    private sessions;
+    get(sessionId: string): Promise<CheckoutSession | null>;
+    set(session: CheckoutSession): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+    cleanup(): Promise<void>;
+}
+export interface CheckoutConfig {
+    merchantId: string;
+    merchantName: string;
+    defaultCurrency: string;
+    sessionTTLMinutes: number;
+    taxCalculator?: TaxCalculator;
+    discountValidator?: DiscountValidator;
+    fulfillmentProvider?: FulfillmentProvider;
+    paymentMethods: PaymentMethodInfo[];
+}
+export interface TaxCalculator {
+    calculate(items: LineItem[], destination?: FulfillmentDestination): Promise<{
+        taxAmount: Money;
+        taxLines: {
+            label: string;
+            rate: number;
+            amount: Money;
+        }[];
+    }>;
+}
+export interface DiscountValidator {
+    validate(code: string, session: CheckoutSession): Promise<{
+        valid: boolean;
+        discount?: DiscountAllocation;
+        error?: string;
+    }>;
+}
+export interface FulfillmentProvider {
+    getOptions(items: LineItem[], destination?: FulfillmentDestination): Promise<FulfillmentOption[]>;
+}
+export declare class CheckoutService {
+    private storage;
+    private config;
+    constructor(config: CheckoutConfig, storage?: SessionStorage);
+    /**
+     * Create a new checkout session
+     */
+    createSession(params?: {
+        currency?: string;
+        locale?: string;
+        metadata?: Record<string, any>;
+    }): Promise<CheckoutSession>;
+    /**
+     * Get checkout session by ID
+     */
+    getSession(sessionId: string): Promise<CheckoutSession>;
+    /**
+     * Update cart items
+     */
+    updateCart(sessionId: string, updates: {
+        add?: Omit<LineItem, 'id' | 'totalPrice'>[];
+        remove?: string[];
+        update?: {
+            id: string;
+            quantity: number;
+        }[];
+    }): Promise<CheckoutSession>;
+    /**
+     * Set buyer information
+     */
+    setBuyer(sessionId: string, buyer: BuyerInfo): Promise<CheckoutSession>;
+    /**
+     * Set fulfillment option
+     */
+    setFulfillment(sessionId: string, params: {
+        optionId: string;
+        destination: FulfillmentDestination;
+    }): Promise<CheckoutSession>;
+    /**
+     * Apply discount code
+     */
+    applyDiscount(sessionId: string, code: string): Promise<{
+        success: boolean;
+        session: CheckoutSession;
+        error?: string;
+    }>;
+    /**
+     * Remove discount code
+     */
+    removeDiscount(sessionId: string, code: string): Promise<CheckoutSession>;
+    /**
+     * Complete checkout with payment
+     */
+    complete(sessionId: string, payment: {
+        methodId?: string;
+        mandate?: PaymentMandate;
+    }): Promise<Order>;
+    /**
+     * Generate Cart Mandate for the session
+     */
+    generateCartMandate(session: CheckoutSession): CartMandate;
+    private assertSessionOpen;
+    private calculateTotals;
+}
+//# sourceMappingURL=checkout.d.ts.map