@portel/photon-core 1.5.0 → 2.1.0

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

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

package/dist/ucp/capabilities/checkout.js

@@ -0,0 +1,344 @@
+/**
+ * UCP Checkout Capability Implementation
+ *
+ * Provides cart management, pricing, and checkout session handling.
+ */
+import * as crypto from 'crypto';
+import { createCartMandate } from '../ap2/mandates.js';
+/**
+ * In-memory session storage (for development/testing)
+ */
+export class MemorySessionStorage {
+    sessions = new Map();
+    async get(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return null;
+        // Check expiration
+        if (new Date(session.expiresAt) < new Date()) {
+            this.sessions.delete(sessionId);
+            return null;
+        }
+        return session;
+    }
+    async set(session) {
+        this.sessions.set(session.id, session);
+    }
+    async delete(sessionId) {
+        this.sessions.delete(sessionId);
+    }
+    async cleanup() {
+        const now = new Date();
+        for (const [id, session] of this.sessions) {
+            if (new Date(session.expiresAt) < now) {
+                this.sessions.delete(id);
+            }
+        }
+    }
+}
+export class CheckoutService {
+    storage;
+    config;
+    constructor(config, storage) {
+        this.config = config;
+        this.storage = storage || new MemorySessionStorage();
+    }
+    // --------------------------------------------------------------------------
+    // Session Management
+    // --------------------------------------------------------------------------
+    /**
+     * Create a new checkout session
+     */
+    async createSession(params) {
+        const now = new Date();
+        const expiresAt = new Date(now.getTime() + this.config.sessionTTLMinutes * 60 * 1000);
+        const session = {
+            id: `cs_${crypto.randomUUID()}`,
+            merchantId: this.config.merchantId,
+            status: 'open',
+            createdAt: now.toISOString(),
+            updatedAt: now.toISOString(),
+            expiresAt: expiresAt.toISOString(),
+            lineItems: [],
+            discounts: [],
+            fulfillmentOptions: [],
+            availablePaymentMethods: this.config.paymentMethods,
+            totals: this.calculateTotals([]),
+            metadata: params?.metadata
+        };
+        await this.storage.set(session);
+        return session;
+    }
+    /**
+     * Get checkout session by ID
+     */
+    async getSession(sessionId) {
+        const session = await this.storage.get(sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${sessionId}`);
+        }
+        return session;
+    }
+    // --------------------------------------------------------------------------
+    // Cart Management
+    // --------------------------------------------------------------------------
+    /**
+     * Update cart items
+     */
+    async updateCart(sessionId, updates) {
+        const session = await this.getSession(sessionId);
+        this.assertSessionOpen(session);
+        let items = [...session.lineItems];
+        // Remove items
+        if (updates.remove) {
+            items = items.filter(item => !updates.remove.includes(item.id));
+        }
+        // Update quantities
+        if (updates.update) {
+            for (const update of updates.update) {
+                const item = items.find(i => i.id === update.id);
+                if (item) {
+                    if (update.quantity <= 0) {
+                        items = items.filter(i => i.id !== update.id);
+                    }
+                    else {
+                        item.quantity = update.quantity;
+                        item.totalPrice = {
+                            amount: item.unitPrice.amount * update.quantity,
+                            currency: item.unitPrice.currency
+                        };
+                    }
+                }
+            }
+        }
+        // Add new items
+        if (updates.add) {
+            for (const newItem of updates.add) {
+                items.push({
+                    ...newItem,
+                    id: `li_${crypto.randomUUID()}`,
+                    totalPrice: {
+                        amount: newItem.unitPrice.amount * newItem.quantity,
+                        currency: newItem.unitPrice.currency
+                    }
+                });
+            }
+        }
+        session.lineItems = items;
+        session.totals = this.calculateTotals(items, session.discounts, session.selectedFulfillment);
+        session.updatedAt = new Date().toISOString();
+        // Update fulfillment options if provider available
+        if (this.config.fulfillmentProvider) {
+            session.fulfillmentOptions = await this.config.fulfillmentProvider.getOptions(items, session.selectedFulfillment?.destination);
+        }
+        await this.storage.set(session);
+        return session;
+    }
+    /**
+     * Set buyer information
+     */
+    async setBuyer(sessionId, buyer) {
+        const session = await this.getSession(sessionId);
+        this.assertSessionOpen(session);
+        session.buyer = buyer;
+        session.updatedAt = new Date().toISOString();
+        await this.storage.set(session);
+        return session;
+    }
+    /**
+     * Set fulfillment option
+     */
+    async setFulfillment(sessionId, params) {
+        const session = await this.getSession(sessionId);
+        this.assertSessionOpen(session);
+        const option = session.fulfillmentOptions.find(o => o.id === params.optionId);
+        if (!option) {
+            throw new Error(`Fulfillment option not found: ${params.optionId}`);
+        }
+        session.selectedFulfillment = {
+            optionId: params.optionId,
+            destination: params.destination
+        };
+        // Recalculate totals with shipping
+        session.totals = this.calculateTotals(session.lineItems, session.discounts, session.selectedFulfillment, option.price);
+        // Recalculate tax if calculator available
+        if (this.config.taxCalculator) {
+            const taxResult = await this.config.taxCalculator.calculate(session.lineItems, params.destination);
+            session.totals.tax = taxResult.taxAmount;
+            session.totals.taxLines = taxResult.taxLines;
+            session.totals.total = {
+                amount: session.totals.subtotal.amount - session.totals.discounts.amount +
+                    session.totals.shipping.amount + session.totals.tax.amount,
+                currency: session.totals.subtotal.currency
+            };
+        }
+        session.updatedAt = new Date().toISOString();
+        await this.storage.set(session);
+        return session;
+    }
+    // --------------------------------------------------------------------------
+    // Discounts
+    // --------------------------------------------------------------------------
+    /**
+     * Apply discount code
+     */
+    async applyDiscount(sessionId, code) {
+        const session = await this.getSession(sessionId);
+        this.assertSessionOpen(session);
+        // Check if already applied
+        if (session.discounts.some(d => d.code === code)) {
+            return { success: false, session, error: 'Discount already applied' };
+        }
+        // Validate discount
+        if (this.config.discountValidator) {
+            const result = await this.config.discountValidator.validate(code, session);
+            if (!result.valid) {
+                return { success: false, session, error: result.error };
+            }
+            if (result.discount) {
+                session.discounts.push(result.discount);
+            }
+        }
+        else {
+            // Simple default discount handling
+            const discount = {
+                code,
+                label: `Discount: ${code}`,
+                type: 'percentage',
+                value: 10,
+                appliedAmount: {
+                    amount: session.totals.subtotal.amount * 0.1,
+                    currency: session.totals.subtotal.currency
+                }
+            };
+            session.discounts.push(discount);
+        }
+        session.totals = this.calculateTotals(session.lineItems, session.discounts, session.selectedFulfillment);
+        session.updatedAt = new Date().toISOString();
+        await this.storage.set(session);
+        return { success: true, session };
+    }
+    /**
+     * Remove discount code
+     */
+    async removeDiscount(sessionId, code) {
+        const session = await this.getSession(sessionId);
+        this.assertSessionOpen(session);
+        session.discounts = session.discounts.filter(d => d.code !== code);
+        session.totals = this.calculateTotals(session.lineItems, session.discounts, session.selectedFulfillment);
+        session.updatedAt = new Date().toISOString();
+        await this.storage.set(session);
+        return session;
+    }
+    // --------------------------------------------------------------------------
+    // Checkout Completion
+    // --------------------------------------------------------------------------
+    /**
+     * Complete checkout with payment
+     */
+    async complete(sessionId, payment) {
+        const session = await this.getSession(sessionId);
+        this.assertSessionOpen(session);
+        // Validate session is ready
+        if (session.lineItems.length === 0) {
+            throw new Error('Cart is empty');
+        }
+        if (!session.buyer?.email) {
+            throw new Error('Buyer email is required');
+        }
+        // Mark as processing
+        session.status = 'processing';
+        session.updatedAt = new Date().toISOString();
+        await this.storage.set(session);
+        try {
+            // Create order from session
+            const order = {
+                id: `order_${crypto.randomUUID()}`,
+                checkoutSessionId: session.id,
+                merchantId: session.merchantId,
+                status: 'confirmed',
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+                buyer: session.buyer,
+                lineItems: session.lineItems,
+                fulfillmentExpectations: session.selectedFulfillment ? [{
+                        id: `fe_${crypto.randomUUID()}`,
+                        type: session.selectedFulfillment.destination.type,
+                        description: `Shipping to ${session.selectedFulfillment.destination.address?.city || 'destination'}`,
+                        lineItemIds: session.lineItems.map(i => i.id)
+                    }] : [],
+                shipments: [],
+                paymentMethod: session.selectedPaymentMethod || session.availablePaymentMethods[0],
+                paymentStatus: 'captured',
+                totals: session.totals,
+                adjustments: [],
+                returns: []
+            };
+            // Mark session as completed
+            session.status = 'completed';
+            session.updatedAt = new Date().toISOString();
+            await this.storage.set(session);
+            return order;
+        }
+        catch (error) {
+            // Revert to open status on failure
+            session.status = 'open';
+            session.updatedAt = new Date().toISOString();
+            await this.storage.set(session);
+            throw error;
+        }
+    }
+    // --------------------------------------------------------------------------
+    // AP2 Integration
+    // --------------------------------------------------------------------------
+    /**
+     * Generate Cart Mandate for the session
+     */
+    generateCartMandate(session) {
+        return createCartMandate({
+            items: session.lineItems,
+            total: session.totals.total,
+            merchant: {
+                id: this.config.merchantId,
+                name: this.config.merchantName
+            },
+            paymentMethods: session.availablePaymentMethods.map(m => {
+                switch (m.type) {
+                    case 'card': return 'CARD';
+                    case 'bank_transfer': return 'BANK_TRANSFER';
+                    case 'wallet': return 'WALLET';
+                    case 'crypto': return 'CRYPTO';
+                    default: return 'CARD';
+                }
+            }),
+            fulfillment: session.selectedFulfillment?.destination.address ? {
+                method: session.fulfillmentOptions.find(o => o.id === session.selectedFulfillment?.optionId)?.label || 'Standard',
+                destination: session.selectedFulfillment.destination.address
+            } : undefined,
+            refundPeriodDays: 30
+        });
+    }
+    // --------------------------------------------------------------------------
+    // Helpers
+    // --------------------------------------------------------------------------
+    assertSessionOpen(session) {
+        if (session.status !== 'open') {
+            throw new Error(`Session is ${session.status}, cannot modify`);
+        }
+    }
+    calculateTotals(items, discounts = [], fulfillment, shippingCost) {
+        const currency = items[0]?.unitPrice.currency || this.config.defaultCurrency;
+        const subtotal = items.reduce((sum, item) => sum + item.totalPrice.amount, 0);
+        const discountTotal = discounts.reduce((sum, d) => sum + d.appliedAmount.amount, 0);
+        const shipping = shippingCost?.amount || 0;
+        const tax = 0; // Calculated separately if tax calculator provided
+        return {
+            subtotal: { amount: subtotal, currency },
+            discounts: { amount: discountTotal, currency },
+            shipping: { amount: shipping, currency },
+            tax: { amount: tax, currency },
+            total: { amount: subtotal - discountTotal + shipping + tax, currency }
+        };
+    }
+}
+//# sourceMappingURL=checkout.js.map

package/dist/ucp/capabilities/checkout.js.map

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

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

@@ -0,0 +1,130 @@
+/**
+ * UCP Identity Linking Capability Implementation
+ *
+ * Provides OAuth 2.0 based identity linking for agent authorization.
+ */
+import { OAuthConfig, TokenResponse, IdentityLink } from '../types.js';
+export interface TokenStorage {
+    storeAuthCode(code: string, data: AuthCodeData): Promise<void>;
+    getAuthCode(code: string): Promise<AuthCodeData | null>;
+    deleteAuthCode(code: string): Promise<void>;
+    storeToken(token: string, data: TokenData): Promise<void>;
+    getToken(token: string): Promise<TokenData | null>;
+    deleteToken(token: string): Promise<void>;
+    storeRefreshToken(token: string, data: RefreshTokenData): Promise<void>;
+    getRefreshToken(token: string): Promise<RefreshTokenData | null>;
+    deleteRefreshToken(token: string): Promise<void>;
+    storeIdentityLink(link: IdentityLink): Promise<void>;
+    getIdentityLink(agentId: string): Promise<IdentityLink | null>;
+    deleteIdentityLink(agentId: string): Promise<void>;
+}
+interface AuthCodeData {
+    agentId: string;
+    scopes: string[];
+    redirectUri: string;
+    expiresAt: string;
+    state?: string;
+}
+interface TokenData {
+    agentId: string;
+    scopes: string[];
+    expiresAt: string;
+}
+interface RefreshTokenData {
+    agentId: string;
+    scopes: string[];
+    accessToken: string;
+}
+/**
+ * In-memory token storage (for development/testing)
+ */
+export declare class MemoryTokenStorage implements TokenStorage {
+    private authCodes;
+    private tokens;
+    private refreshTokens;
+    private identityLinks;
+    storeAuthCode(code: string, data: AuthCodeData): Promise<void>;
+    getAuthCode(code: string): Promise<AuthCodeData | null>;
+    deleteAuthCode(code: string): Promise<void>;
+    storeToken(token: string, data: TokenData): Promise<void>;
+    getToken(token: string): Promise<TokenData | null>;
+    deleteToken(token: string): Promise<void>;
+    storeRefreshToken(token: string, data: RefreshTokenData): Promise<void>;
+    getRefreshToken(token: string): Promise<RefreshTokenData | null>;
+    deleteRefreshToken(token: string): Promise<void>;
+    storeIdentityLink(link: IdentityLink): Promise<void>;
+    getIdentityLink(agentId: string): Promise<IdentityLink | null>;
+    deleteIdentityLink(agentId: string): Promise<void>;
+}
+export interface IdentityServiceConfig {
+    baseUrl: string;
+    allowedScopes: string[];
+    authCodeTTLSeconds: number;
+    accessTokenTTLSeconds: number;
+    refreshTokenTTLDays: number;
+}
+export declare class IdentityService {
+    private storage;
+    private config;
+    constructor(config?: Partial<IdentityServiceConfig>, storage?: TokenStorage);
+    /**
+     * Get OAuth configuration for discovery
+     */
+    getOAuthConfig(): Promise<OAuthConfig>;
+    /**
+     * Generate authorization URL for agent
+     */
+    requestAuthorization(params: {
+        agentId: string;
+        scopes: string[];
+        redirectUri: string;
+        state?: string;
+    }): Promise<{
+        authorizationUrl: string;
+    }>;
+    /**
+     * Handle user approval (called after user consents)
+     */
+    approveAuthorization(code: string, userId: string): Promise<{
+        redirectUrl: string;
+    }>;
+    /**
+     * Exchange authorization code for tokens
+     */
+    exchangeCode(params: {
+        code: string;
+        redirectUri: string;
+    }): Promise<TokenResponse>;
+    /**
+     * Refresh access token
+     */
+    refreshToken(refreshToken: string): Promise<TokenResponse>;
+    /**
+     * Validate access token
+     */
+    validateToken(token: string): Promise<{
+        valid: boolean;
+        agentId?: string;
+        scopes?: string[];
+    }>;
+    /**
+     * Check if token has required scope
+     */
+    hasScope(token: string, requiredScope: string): Promise<boolean>;
+    /**
+     * Revoke token
+     */
+    revokeToken(token: string): Promise<void>;
+    /**
+     * Revoke all tokens for an agent
+     */
+    revokeAgent(agentId: string): Promise<void>;
+    /**
+     * Get identity link for agent
+     */
+    getIdentityLink(agentId: string): Promise<IdentityLink | null>;
+    private generateCode;
+    private generateToken;
+}
+export {};
+//# sourceMappingURL=identity.d.ts.map

package/dist/ucp/capabilities/identity.d.ts.map

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