ucpify 1.2.0 → 1.2.1

package/dist/ucp-server.d.ts

@@ -1,83 +0,0 @@
-import { MerchantConfig, CheckoutSession, Order, Buyer, Fulfillment } from './schema';
-export declare class UCPServer {
-    private config;
-    private itemsMap;
-    private checkoutSessions;
-    private orders;
-    constructor(config: MerchantConfig);
-    getProfile(): {
-        ucp: {
-            version: string;
-            services: {
-                'dev.ucp.shopping': {
-                    version: string;
-                    spec: string;
-                    transport: string;
-                    endpoint: string;
-                    schema: string;
-                }[];
-            };
-            capabilities: {
-                'dev.ucp.identity_linking'?: {
-                    version: string;
-                    spec: string;
-                }[] | undefined;
-                'dev.ucp.shopping.checkout': {
-                    version: string;
-                    spec: string;
-                    schema: string;
-                }[];
-                'dev.ucp.shopping.fulfillment': {
-                    version: string;
-                    spec: string;
-                    schema: string;
-                    extends: string;
-                }[];
-                'dev.ucp.shopping.order': {
-                    version: string;
-                    spec: string;
-                    schema: string;
-                }[];
-            };
-            payment_handlers: Record<string, {
-                id: string;
-                version: string;
-                config?: Record<string, unknown>;
-            }[]>;
-        };
-    };
-    private calculateLineItemTotals;
-    private validateCheckout;
-    createCheckout(data: {
-        line_items: {
-            id?: string;
-            item: {
-                id: string;
-                title?: string;
-                price?: number;
-            };
-            quantity: number;
-        }[];
-    }): CheckoutSession;
-    getCheckout(id: string): CheckoutSession | undefined;
-    updateCheckout(id: string, data: {
-        buyer?: Buyer;
-        line_items?: {
-            id?: string;
-            item: {
-                id: string;
-                title?: string;
-                price?: number;
-            };
-            quantity: number;
-        }[];
-        fulfillment?: Fulfillment;
-    }): CheckoutSession | undefined;
-    completeCheckout(id: string): Promise<CheckoutSession | {
-        error: string;
-    }>;
-    cancelCheckout(id: string): CheckoutSession | undefined;
-    getOrder(id: string): Order | undefined;
-    listOrders(): Order[];
-    getConfig(): MerchantConfig;
-}

package/dist/ucp-server.js

@@ -1,381 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UCPServer = void 0;
-const uuid_1 = require("uuid");
-const schema_1 = require("./schema");
-const stripe_1 = require("./stripe");
-const paypal_1 = require("./paypal");
-const logger_1 = require("./logger");
-class UCPServer {
-    config;
-    itemsMap;
-    checkoutSessions = new Map();
-    orders = new Map();
-    constructor(config) {
-        this.config = config;
-        this.itemsMap = new Map(config.items.map((item) => [item.id, item]));
-    }
-    // Generate UCP profile for /.well-known/ucp
-    getProfile() {
-        const paymentHandlers = {};
-        for (const handler of this.config.payment_handlers) {
-            paymentHandlers[handler.namespace] = [
-                {
-                    id: handler.id,
-                    version: schema_1.UCP_VERSION,
-                    config: handler.config,
-                },
-            ];
-        }
-        return {
-            ucp: {
-                version: schema_1.UCP_VERSION,
-                services: {
-                    'dev.ucp.shopping': [
-                        {
-                            version: schema_1.UCP_VERSION,
-                            spec: 'https://ucp.dev/specification/overview',
-                            transport: 'rest',
-                            endpoint: `${this.config.domain}/ucp/v1`,
-                            schema: 'https://ucp.dev/services/shopping/rest.openapi.json',
-                        },
-                    ],
-                },
-                capabilities: {
-                    'dev.ucp.shopping.checkout': [
-                        {
-                            version: schema_1.UCP_VERSION,
-                            spec: 'https://ucp.dev/specification/checkout',
-                            schema: 'https://ucp.dev/schemas/shopping/checkout.json',
-                        },
-                    ],
-                    'dev.ucp.shopping.fulfillment': [
-                        {
-                            version: schema_1.UCP_VERSION,
-                            spec: 'https://ucp.dev/specification/fulfillment',
-                            schema: 'https://ucp.dev/schemas/shopping/fulfillment.json',
-                            extends: 'dev.ucp.shopping.checkout',
-                        },
-                    ],
-                    'dev.ucp.shopping.order': [
-                        {
-                            version: schema_1.UCP_VERSION,
-                            spec: 'https://ucp.dev/specification/order',
-                            schema: 'https://ucp.dev/schemas/shopping/order.json',
-                        },
-                    ],
-                    ...(this.config.oauth ? {
-                        'dev.ucp.identity_linking': [
-                            {
-                                version: schema_1.UCP_VERSION,
-                                spec: 'https://ucp.dev/specification/identity-linking',
-                            },
-                        ],
-                    } : {}),
-                },
-                payment_handlers: paymentHandlers,
-            },
-        };
-    }
-    // Calculate totals for line items
-    calculateLineItemTotals(lineItems) {
-        const subtotal = lineItems.reduce((sum, li) => sum + li.item.price * li.quantity, 0);
-        const tax = Math.round(subtotal * this.config.tax_rate);
-        return [
-            { type: 'subtotal', amount: subtotal },
-            { type: 'tax', amount: tax },
-            { type: 'total', amount: subtotal + tax },
-        ];
-    }
-    // Validate checkout and generate messages
-    validateCheckout(session) {
-        const messages = [];
-        if (!session.buyer?.email) {
-            messages.push({
-                type: 'error',
-                code: 'missing',
-                path: '$.buyer.email',
-                content: 'Buyer email is required',
-                severity: 'recoverable',
-            });
-        }
-        if (!session.fulfillment?.methods?.[0]?.selected_destination_id) {
-            messages.push({
-                type: 'error',
-                code: 'missing',
-                path: '$.fulfillment.methods[0].selected_destination_id',
-                content: 'Shipping address is required',
-                severity: 'recoverable',
-            });
-        }
-        return messages;
-    }
-    // Create checkout session
-    createCheckout(data) {
-        const id = `chk_${(0, uuid_1.v4)().replace(/-/g, '').slice(0, 12)}`;
-        // Resolve items from catalog or use provided
-        const lineItems = data.line_items.map((li, idx) => {
-            const catalogItem = this.itemsMap.get(li.item.id);
-            const item = catalogItem || {
-                id: li.item.id,
-                title: li.item.title || 'Unknown Item',
-                price: li.item.price || 0,
-            };
-            const subtotal = item.price * li.quantity;
-            return {
-                id: li.id || `li_${idx + 1}`,
-                item,
-                quantity: li.quantity,
-                totals: [
-                    { type: 'subtotal', amount: subtotal },
-                    { type: 'total', amount: subtotal },
-                ],
-            };
-        });
-        const totals = this.calculateLineItemTotals(lineItems);
-        const messages = this.validateCheckout({ line_items: lineItems });
-        const paymentHandlers = {};
-        for (const handler of this.config.payment_handlers) {
-            paymentHandlers[handler.namespace] = [{ id: handler.id, version: schema_1.UCP_VERSION, config: handler.config }];
-        }
-        // Build links
-        const links = [];
-        if (this.config.terms_url) {
-            links.push({ type: 'terms_of_service', url: this.config.terms_url });
-        }
-        if (this.config.privacy_url) {
-            links.push({ type: 'privacy_policy', url: this.config.privacy_url });
-        }
-        // Set expiry (1 hour from now)
-        const expiresAt = new Date(Date.now() + 60 * 60 * 1000).toISOString();
-        const session = {
-            ucp: {
-                version: schema_1.UCP_VERSION,
-                capabilities: {
-                    'dev.ucp.shopping.checkout': [{ version: schema_1.UCP_VERSION }],
-                },
-                payment_handlers: paymentHandlers,
-            },
-            id,
-            status: messages.length > 0 ? 'incomplete' : 'ready_for_complete',
-            messages: messages.length > 0 ? messages : undefined,
-            currency: this.config.currency,
-            line_items: lineItems,
-            totals,
-            links,
-            continue_url: `${this.config.domain}/checkout/${id}`,
-            expires_at: expiresAt,
-        };
-        this.checkoutSessions.set(id, session);
-        return session;
-    }
-    // Get checkout session
-    getCheckout(id) {
-        return this.checkoutSessions.get(id);
-    }
-    // Update checkout session
-    updateCheckout(id, data) {
-        const session = this.checkoutSessions.get(id);
-        if (!session)
-            return undefined;
-        // Update buyer
-        if (data.buyer) {
-            session.buyer = { ...session.buyer, ...data.buyer };
-        }
-        // Update line items
-        if (data.line_items) {
-            session.line_items = data.line_items.map((li, idx) => {
-                const catalogItem = this.itemsMap.get(li.item.id);
-                const item = catalogItem || {
-                    id: li.item.id,
-                    title: li.item.title || 'Unknown Item',
-                    price: li.item.price || 0,
-                };
-                const subtotal = item.price * li.quantity;
-                return {
-                    id: li.id || `li_${idx + 1}`,
-                    item,
-                    quantity: li.quantity,
-                    totals: [
-                        { type: 'subtotal', amount: subtotal },
-                        { type: 'total', amount: subtotal },
-                    ],
-                };
-            });
-        }
-        // Update fulfillment with shipping options
-        if (data.fulfillment) {
-            const methods = data.fulfillment.methods.map((method, mIdx) => {
-                const destinations = method.destinations.map((dest, dIdx) => ({
-                    ...dest,
-                    id: dest.id || `dest_${dIdx + 1}`,
-                }));
-                const groups = method.groups?.length
-                    ? method.groups
-                    : [
-                        {
-                            id: `group_${mIdx + 1}`,
-                            line_item_ids: session.line_items.map((li) => li.id),
-                            selected_option_id: this.config.shipping_options[0]?.id,
-                            options: this.config.shipping_options.map((opt) => ({
-                                id: opt.id,
-                                title: opt.title,
-                                description: opt.description || opt.estimated_days,
-                                totals: [{ type: 'total', amount: opt.price }],
-                            })),
-                        },
-                    ];
-                return {
-                    id: method.id || `method_${mIdx + 1}`,
-                    type: method.type,
-                    line_item_ids: method.line_item_ids || session.line_items.map((li) => li.id),
-                    selected_destination_id: method.selected_destination_id || destinations[0]?.id,
-                    destinations,
-                    groups,
-                };
-            });
-            session.fulfillment = { methods };
-        }
-        // Recalculate totals including shipping
-        let shippingTotal = 0;
-        if (session.fulfillment) {
-            for (const method of session.fulfillment.methods) {
-                for (const group of method.groups) {
-                    const selectedOption = group.options.find((o) => o.id === group.selected_option_id);
-                    if (selectedOption) {
-                        const total = selectedOption.totals.find((t) => t.type === 'total');
-                        shippingTotal += total?.amount || 0;
-                    }
-                }
-            }
-        }
-        const subtotal = session.line_items.reduce((sum, li) => sum + li.item.price * li.quantity, 0);
-        const tax = Math.round(subtotal * this.config.tax_rate);
-        session.totals = [
-            { type: 'subtotal', amount: subtotal },
-            { type: 'shipping', amount: shippingTotal },
-            { type: 'tax', amount: tax },
-            { type: 'total', amount: subtotal + shippingTotal + tax },
-        ];
-        // Revalidate
-        const newMessages = this.validateCheckout(session);
-        session.messages = newMessages.length > 0 ? newMessages : undefined;
-        session.status = newMessages.length > 0 ? 'incomplete' : 'ready_for_complete';
-        this.checkoutSessions.set(id, session);
-        return session;
-    }
-    // Complete checkout (create order)
-    async completeCheckout(id) {
-        const session = this.checkoutSessions.get(id);
-        if (!session)
-            return { error: 'Checkout session not found' };
-        if (session.status !== 'ready_for_complete') {
-            return { error: 'Checkout is not ready for completion', messages: session.messages };
-        }
-        const orderId = `order_${(0, uuid_1.v4)().replace(/-/g, '').slice(0, 12)}`;
-        // Get total amount for payment
-        const totalAmount = session.totals.find(t => t.type === 'total')?.amount || 0;
-        // Payment processing - try Stripe first, then PayPal
-        if (totalAmount > 0) {
-            if ((0, stripe_1.isStripeConfigured)()) {
-                try {
-                    const paymentIntent = await (0, stripe_1.createPaymentIntent)({
-                        amount: totalAmount,
-                        currency: session.currency,
-                        checkoutId: id,
-                        customerEmail: session.buyer?.email,
-                        metadata: { order_id: orderId },
-                    });
-                    if (paymentIntent) {
-                        logger_1.logger.info({ checkoutId: id, paymentIntentId: paymentIntent.id, amount: totalAmount }, 'Stripe payment intent created');
-                    }
-                }
-                catch (error) {
-                    logger_1.logger.error({ error, checkoutId: id }, 'Failed to create Stripe payment intent');
-                    return { error: 'Payment processing failed' };
-                }
-            }
-            else if ((0, paypal_1.isPayPalConfigured)()) {
-                try {
-                    const ppOrder = await (0, paypal_1.createPayPalOrder)({
-                        amount: totalAmount,
-                        currency: session.currency,
-                        checkoutId: id,
-                        description: `Order ${orderId}`,
-                    });
-                    if (ppOrder) {
-                        logger_1.logger.info({ checkoutId: id, paypalOrderId: ppOrder.id, amount: totalAmount }, 'PayPal order created');
-                    }
-                }
-                catch (error) {
-                    logger_1.logger.error({ error, checkoutId: id }, 'Failed to create PayPal order');
-                    return { error: 'Payment processing failed' };
-                }
-            }
-        }
-        const order = {
-            ucp: {
-                version: schema_1.UCP_VERSION,
-                capabilities: {
-                    'dev.ucp.shopping.order': [{ version: schema_1.UCP_VERSION }],
-                },
-            },
-            id: orderId,
-            checkout_id: id,
-            permalink_url: `${this.config.domain}/orders/${orderId}`,
-            line_items: session.line_items,
-            buyer: session.buyer,
-            totals: session.totals,
-            fulfillment: session.fulfillment
-                ? {
-                    expectations: session.fulfillment.methods.map((m, idx) => ({
-                        id: `exp_${idx + 1}`,
-                        line_items: m.line_item_ids.map((liId) => {
-                            const li = session.line_items.find((l) => l.id === liId);
-                            return { id: liId, quantity: li?.quantity || 1 };
-                        }),
-                        method_type: m.type,
-                        destination: m.destinations.find((d) => d.id === m.selected_destination_id),
-                        description: 'Arrives in 5-7 business days',
-                        fulfillable_on: 'now',
-                    })),
-                    events: [],
-                }
-                : undefined,
-            created_at: new Date().toISOString(),
-        };
-        this.orders.set(orderId, order);
-        // Update session to completed state with order confirmation
-        session.status = 'completed';
-        session.order = {
-            id: orderId,
-            permalink_url: order.permalink_url,
-        };
-        delete session.continue_url;
-        delete session.messages;
-        this.checkoutSessions.set(id, session);
-        return session;
-    }
-    // Cancel checkout
-    cancelCheckout(id) {
-        const session = this.checkoutSessions.get(id);
-        if (!session)
-            return undefined;
-        session.status = 'canceled';
-        delete session.continue_url;
-        this.checkoutSessions.set(id, session);
-        return session;
-    }
-    // Get order
-    getOrder(id) {
-        return this.orders.get(id);
-    }
-    // List orders
-    listOrders() {
-        return Array.from(this.orders.values());
-    }
-    getConfig() {
-        return this.config;
-    }
-}
-exports.UCPServer = UCPServer;